[rhythmbox/mallard-help: 33/55] fixed validation errors. added some temp pages ported from banshee help.



commit f83dd426d920aebe898d54ca3cbf403a45ad59d8
Author: Jim Campbell <jwcampbell gmail com>
Date:   Sun Feb 19 19:58:27 2012 +0100

    fixed validation errors. added some temp pages ported from banshee help.

 help/C/_amazon.page            |   83 ++++++++++++++++++++++
 help/C/_emusic.page            |   14 ++++
 help/C/_itunes-import.page     |   14 ++++
 help/C/_keyboardshortcuts.page |  145 ++++++++++++++++++++++++++++++++++++++
 help/C/_manage-coverart.page   |   31 ++++++++
 help/C/_manage-tags.page       |   81 +++++++++++++++++++++
 help/C/_plugins.page           |   40 +++++++++++
 help/C/_radio.page             |   71 +++++++++++++++++++
 help/C/_search.page            |  119 +++++++++++++++++++++++++++++++
 help/C/_sort.page              |   55 +++++++++++++++
 help/C/_sync.page              |  150 ++++++++++++++++++++++++++++++++++++++++
 help/C/index.page              |   22 +++---
 help/C/lastfm.page             |   15 ++--
 help/C/legal.xml               |   87 +++---------------------
 help/C/podcast.page            |    9 ++-
 help/C/radio-stations.page     |    8 +--
 16 files changed, 840 insertions(+), 104 deletions(-)
---
diff --git a/help/C/_amazon.page b/help/C/_amazon.page
new file mode 100644
index 0000000..008cb8e
--- /dev/null
+++ b/help/C/_amazon.page
@@ -0,0 +1,83 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic" style="task"
+      id="amazon">
+
+  <info>
+    <link type="guide" xref="index#extensions"/>
+    <link type="seealso" xref=""/>
+    <desc>Sync and purchase music from the Amazon MP3 Store.</desc>
+    <revision pkgversion="1.6" version="0.1" date="2010-07-11" status="draft"/>
+    <credit type="author">
+      <name>Paul Cutler</name>
+      <email>pcutler gnome org</email>
+    </credit>    
+<!--
+    <copyright>
+      <year>2010</year>
+      <name>GNOME Documentation Project</name>
+    </copyright>
+-->
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Amazon MP3 Store</title>    
+  
+  <p>Banshee supports downloading and importing music from the Amazon MP3 store.
+   You can manually import Amazon music files, purchase music in your web 
+   browser or buy music inside of Banshee.  Amazon only offers music for sale
+   as an MP3 in certain countries and depending on your location, you may
+   not be able to buy Amazon MP3s.  
+   </p>
+   
+   <note style="important">
+     <p>Banshee uses an Amazon affiliate code for all music purchases.  All
+     money made via this affiliate code is donated to the GNOME Foundation.
+     </p>
+   </note>
+   
+  <section id="amazon-browser">
+  <title>Purchase Amazon MP3s in your web browser</title> 
+  
+  <p>Music purchased from Amazon's MP3 store can be automatically
+  downloaded and imported into Banshee.  Banshee associates itself with
+  the .amz file Amazon provides for MP3 purchases.  When you buy music on 
+  Amazon, your web browser will download the .amz file and Banshee will
+  automatically open it and begin the download and import the music.
+  </p>
+  </section>
+  
+  <section id="amazon-banshee">
+  <title>Buy Amazon MP3s in Banshee</title> 
+  
+  <p>You can also search for songs on Amazon within Banshee.  Choose the 
+  Amazon MP3 Store from the Banshee menu on the left.  This will load the
+  Amazon MP3 Store just as if you were in a web browser.  You can search
+  Amazon for the music you wish to buy and after logging in to Amazon, buy
+  music with one click.  Banshee will automatically download and import 
+  your purchase into the library.
+  </p>
+  </section>
+  
+  <section id="amazon-manual">
+  <title>Import Amazon MP3s manually</title> 
+  
+  <p>When music is purchased from Amazon in a web browser, a file with the
+  extension .amz is downloaded and saved to your hard drive.   To import
+  music purchased manually from Amazon, in Banshee choose 
+  <guiseq><gui>Media</gui> <gui>Import Media</gui></guiseq> from the menu and
+  select the *.amz file to be imported.  Banshee will then open this file and
+  connect to the Amazon MP3 store to begin the download.
+  </p>
+  
+  <note style="warning">
+    <p>Amazon .amz files are only active for a short time.  If you do not
+    download your music quickly, the file will expire and you cannot download
+    your music from Amazon.  Amazon does not publish how long files are active.
+     It is recommended you download and import any purchases from Amazon within
+     an hour of purchase.
+    </p>
+  </note>
+  </section> 
+       
+</page>
diff --git a/help/C/_emusic.page b/help/C/_emusic.page
new file mode 100644
index 0000000..4f8e068
--- /dev/null
+++ b/help/C/_emusic.page
@@ -0,0 +1,14 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="emusic-import">
+
+  <info>
+    <link type="guide" xref="import#plugins"/>
+    <revision pkgversion="1.6" version="1.6" date="2010-05-31" status="stub"/>
+    <desc>Import music purchased from eMusic.</desc>
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Import your eMusic tracks</title>
+
+</page>
diff --git a/help/C/_itunes-import.page b/help/C/_itunes-import.page
new file mode 100644
index 0000000..9475b6b
--- /dev/null
+++ b/help/C/_itunes-import.page
@@ -0,0 +1,14 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="itunes-import">
+
+  <info>
+    <link type="guide" xref="import#plugins"/>
+    <revision pkgversion="1.6" version="1.6" date="2010-05-31" status="stub"/>
+    <desc>Import music and categorizations from the <app>iTunes</app> media player.</desc>
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Import your <app>iTunes</app> library</title>
+
+</page>
diff --git a/help/C/_keyboardshortcuts.page b/help/C/_keyboardshortcuts.page
new file mode 100644
index 0000000..cafa4cb
--- /dev/null
+++ b/help/C/_keyboardshortcuts.page
@@ -0,0 +1,145 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic" style="task"
+      id="keyboardshortcuts">
+
+<info>
+    <link type="guide" xref="advanced#keyboard"/>
+  <desc>Keyboard Shortcuts</desc>
+  <revision pkgversion="2.0" version="0.1" date="2010-05-29" status="draft"/>
+  <credit type="author">
+    <name>Paul Cutler</name>
+    <email>pcutler gnome org</email>
+  </credit>
+
+<!--
+    <copyright>
+      <year>2010</year>
+      <name>GNOME Documentation Project</name>
+    </copyright>
+-->
+
+  <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+  
+  <title>Control Banshee using Keyboard Shortcuts</title>
+  
+  <section id="playbackcontrol">
+  
+  <title>Playback Control</title>
+
+<table frame="all" rules="rows" shade="rows">
+  <tr>
+    <td><p><gui>Key</gui></p></td>  <td><p><gui>Action</gui></p></td>
+  </tr>
+  <tr>
+    <td><p>Space Bar</p></td> <td><p>Play or Pause the current song</p></td>
+  </tr>
+  <tr>
+    <td><p>N</p></td>     <td><p>Play the next song</p></td>
+  </tr>
+  <tr>
+    <td><p>B</p></td> <td><p>Play the previous song</p></td>
+  </tr>
+</table>
+
+  </section>
+  
+  <section id="library">
+  
+  <title>Library Interaction</title>
+
+<table frame="all" rules="rows" shade="rows">
+  <tr>
+    <td><p><gui>Key</gui></p></td>  <td><p><gui>Action</gui></p></td>
+  </tr>
+  <tr>
+    <td><p><key>/</key>, <keyseq><key>Control</key><key>F</key></keyseq></p></td> <td><p>
+    Move the focus to the search box</p></td>
+  </tr>
+  <tr>
+    <td><p><keyseq><key>Control</key><key>I</key></keyseq></p></td>
+         <td><p>Open import media dialog</p></td>
+   </tr>      
+</table>
+
+  </section>  
+
+  <section id="playlists">
+  
+  <title>Playlists</title>
+
+<table frame="all" rules="rows" shade="rows">
+  <tr>
+    <td><p><gui>Key</gui></p></td>  <td><p><gui>Action</gui></p></td>
+  </tr>
+  <tr>
+    <td><p><keyseq><key>Control</key><key>N</key></keyseq></p></td> <td><p>
+    Create New Playlist</p></td>
+  </tr>
+         
+</table>
+
+  </section> 
+  
+    <section id="podcasts">
+  
+  <title>Podcasts</title>
+
+<table frame="all" rules="rows" shade="rows">
+  <tr>
+    <td><p><gui>Key</gui></p></td>  <td><p><gui>Action</gui></p></td>
+  </tr>
+  <tr>
+    <td><p><key>Y</key></p></td> <td><p>
+    Mark the selected episodes as old</p></td>
+  </tr>
+         
+</table>
+
+  </section> 
+  
+  <section id="interface">
+  
+  <title>Interface</title>
+
+<table frame="all" rules="rows" shade="rows">
+  <tr>
+    <td><p><gui>Key</gui></p></td>  <td><p><gui>Action</gui></p></td>
+  </tr>
+  <tr>
+    <td><p><key>F</key></p></td> <td><p>
+    Toggle full-screen mode</p></td>
+  </tr>  
+  <tr>
+    <td><p><keyseq><key>Control</key><key>A</key></keyseq></p></td> <td><p>
+   Select all songs in playlist view</p></td>
+  </tr>
+  <tr>
+    <td><p><keyseq><key>Control</key><key>Shift</key><key>A</key></keyseq></p>
+    </td> <td><p>
+   Unselect all songs in playlist view</p></td>
+  </tr>
+  <tr>
+    <td><p><keyseq><key>Control</key><key>W</key></keyseq></p></td> <td><p>
+   Hide Banshee Window (Requires Notification Area Plug-in Enabled</p></td>
+  </tr>    
+  <tr>
+    <td><p><keyseq><key>Control</key><key>Left Mouse Button</key></keyseq>
+    </p></td> <td><p>
+   Play Previous Song (Requires Notification Area Plug-in Enabled</p></td>
+  </tr> 
+  <tr> 
+    <td><p><keyseq><key>Control</key><key>Right Mouse Button</key></keyseq>
+    </p></td> <td><p>
+   Play Next Song (Requires Notification Area Plug-in Enabled</p></td>
+  </tr> 
+  <tr> 
+    <td><p><keyseq><key>Control</key><key>Middle Mouse Button</key></keyseq>
+    </p></td> <td><p>
+   Toggle Play / Pause (Requires Notification Area Plug-in Enabled</p></td>
+  </tr>    
+         
+</table>
+
+  </section>   
+</page>
diff --git a/help/C/_manage-coverart.page b/help/C/_manage-coverart.page
new file mode 100644
index 0000000..bbfd36d
--- /dev/null
+++ b/help/C/_manage-coverart.page
@@ -0,0 +1,31 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic" style="task"
+      id="coverart">
+
+  <info>
+    <link type="guide" xref="index#manage"/>
+    <link type="seealso" xref="tags"/>
+    <desc>Manage or change your albums cover art.</desc>
+    <revision pkgversion="1.6" version="0.1" date="2009-01-22" status="draft"/>
+    <credit type="author">
+      <name>Paul Cutler</name>
+      <email>pcutler gnome org</email>
+    </credit>    
+<!--
+    <copyright>
+      <year>2010</year>
+      <name>GNOME Documentation Project</name>
+    </copyright>
+-->
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Cover art</title>    
+  
+  <p></p>
+  
+  <p>
+  </p>
+       
+</page>
diff --git a/help/C/_manage-tags.page b/help/C/_manage-tags.page
new file mode 100644
index 0000000..f69f414
--- /dev/null
+++ b/help/C/_manage-tags.page
@@ -0,0 +1,81 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic" style="task"
+      id="tags">
+
+  <info>
+    <link type="guide" xref="index#manage"/>
+    <link type="seealso" xref="coverart"/>
+    <link type="seealso" xref="playlists"/>
+    <desc>Edit and change music tags and metadata.</desc>
+    <revision pkgversion="2.0" version="0.1" date="2010-05-09"                         status="draft"/>
+    <credit type="author">
+      <name>Paul Cutler</name>
+      <email>pcutler gnome org</email>
+    </credit>    
+<!--
+    <copyright>
+      <year>2010</year>
+      <name>GNOME Documentation Project</name>
+    </copyright>
+-->
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+  
+  <title>Music Metadata</title>
+
+  <section id="metadata">
+
+  <title>Music metadata</title>    
+  
+       <p>Digital music contains metadata that stores information in the 
+       music file including the artist, album, year recorded, genre, and more.
+       Almost all music purchased over the internet will have the metadata
+       already embedded and if you import music from CDs, Banshee will include
+       the metadata when ripping the CD if available.  For more information
+       on ripping CDs and including the metadata see the 
+       <link xref="import"/>.</p>
+       
+       <p>Popular metadata formats are ID3v1 and ID3v2 for MP3 files and
+       Vorbis comments for OGG Vorbis files.</p>       
+  
+       <p>If you have imported songs that do not contain metadata, 
+       <app>Banshee</app> will display <gui>Unknown</gui> for most fields
+       in the library. </p>
+       
+  </section>
+
+  <section id="editmetadata">  
+    
+    <title>Edit Your Metadata</title>
+    
+    <p>You can change and edit the metadata of your songs.  Select the song or
+    songs you want to update and hit the <key>E</key>, choose
+    <guiseq><gui>Edit</gui><gui>Edit Track Information</gui></guiseq> from the menu, or use
+    your mouse and right click on the files and select
+    <gui>Edit Track Information</gui>.
+    </p>
+    
+    <p>A dialog box will appear that shows the song's metadata and allow you to 
+    change or update it.  The default fields displayed include:</p>
+    
+    <list>
+      <item><p><gui>Track Title</gui></p></item>
+      <item><p><gui>Track Artist</gui></p></item>
+      <item><p><gui>Album Title</gui></p></item>
+      <item><p><gui>Genre</gui></p></item>
+      <item><p><gui>Track Number</gui></p></item>
+      <item><p><gui>Disc Number</gui></p></item>
+      <item><p><gui>Year</gui></p></item>
+    </list>
+    
+    <p>Update the song's information.  If you have selected multiple songs to
+    edit press the right arrow icon to the right of the <gui>Track Title</gui>
+    field or press the <gui>Forward</gui> button at the bottom of the dialog
+    when finished with each song.   When you have completed editing all metadata,
+    press <gui>Save</gui>.
+    </p>
+   
+  </section>
+
+</page>
diff --git a/help/C/_plugins.page b/help/C/_plugins.page
new file mode 100644
index 0000000..7749cf4
--- /dev/null
+++ b/help/C/_plugins.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="guide" style="2column"
+      id="plugins">
+
+  <info>
+    <link type="guide" xref="index#plugins"/>
+    <desc>Add additional functionality to Banshee.</desc>
+    <revision pkgversion="2.0" version="0.1" date="2010-05-19" status="draft"/>
+    <credit type="author">
+      <name>Paul Cutler</name>
+      <email>pcutler gnome org</email>
+    </credit>
+<!--    
+    <copyright>
+      <year>2010</year>
+      <name>GNOME Documentation Project</name>
+    </copyright>
+-->    
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"; />
+  </info>
+
+  <title>Banshee Extensions</title>
+
+  <section id="official" style="2column">
+    <info>
+      <title type="link">Official Banshee Extensions</title>
+    </info>
+    <title>Manage extensions for Banshee</title>
+  </section>
+
+  <section id="community" style="2column">
+    <info>
+      <title type="link">Community Banshee Extensions</title>
+    </info>
+    <title>Add community built extensions for Banshee</title>
+  </section>
+
+
+</page>
diff --git a/help/C/_radio.page b/help/C/_radio.page
new file mode 100644
index 0000000..f2612cf
--- /dev/null
+++ b/help/C/_radio.page
@@ -0,0 +1,71 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic" style="task"
+      id="add-radio">
+
+  <info>
+    <link type="guide" xref="index#media"/>
+    <link type="seealso" xref="remove-media"/>
+    <link type="seealso" xref="add-podcasts"/>
+    <link type="seealso" xref="import"/>
+    <desc>Add, remove and play internet radio stations in Banshee.</desc>
+    <revision pkgversion="2.0" version="0.1" date="2010-05-20" status="draft"/>
+    <credit type="author">
+      <name>Paul Cutler</name>
+      <email>pcutler gnome org</email>
+    </credit>    
+<!--
+    <copyright>
+      <year>2010</year>
+      <name>GNOME Documentation Project</name>
+    </copyright>
+-->
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Internet Radio</title> 
+  
+  <section id="radiodescription">
+     <title>What is Internet Radio?</title>
+     
+  <p>Internet radio stations are similar to regular radio stations, allowing
+  an individual or organization to stream music live over the internet.
+  Internet radio stations can be a simultaneous stream of a regular radio station,
+  an amateur broadcasting their own station, or commercial
+  internet radio stations that include live DJs and even commercials.</p>
+  
+  </section>
+  
+  <section id="addradio">
+  
+  <title>Add Radio Station</title>
+  
+  <p>To add an internet radio station to Banshee, press <gui>Add Station</gui>
+  in the upper right hand corner of Banshee or, from the menu, choose <guiseq>
+  <gui>Media</gui><gui>Add Station</gui></guiseq>.
+  </p>
+  
+  <p>From the internet radio station's webpage, copy the link to their stream
+  URL in your web browser.  In most browsers, you can right click on the link
+  and press <gui>Copy Link</gui>.  
+  </p>
+   
+
+  <p>Banshee will prompt you to enter the <gui>Station Genre</gui>.
+  Choose the kind of music the internet radio station plays from the available 
+  drop down selections. You will then need to enter the <gui>Station Name</gui>.  
+  Enter a name for the radio station.  Then press tab or use your mouse to select
+  the <gui>Stream URL</gui> field to paste the URL of the radio station.
+  Using your mouse right click and choose <gui>Paste</gui> or press <keyseq>
+  <key>Control</key><key>V</key></keyseq>.</p>
+  
+  <p>You can optionally also fill out the fields for
+  <gui>Station Creator</gui>, <gui>Description</gui>, and <gui>Rating</gui>.
+  </p>
+  
+  <p>Then press <gui>Save</gui> to save the internet radio station in Banshee.
+  </p>
+  
+  </section>
+                 
+</page>
diff --git a/help/C/_search.page b/help/C/_search.page
new file mode 100644
index 0000000..c8cb808
--- /dev/null
+++ b/help/C/_search.page
@@ -0,0 +1,119 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic" style="task"
+      id="search">
+
+  <info>
+    <link type="guide" xref="index#manage"/>
+    <link type="seealso" xref="sort"/>
+    <desc>Search your media and perfom basic queries.</desc>
+    <revision pkgversion="1.6" version="0.1" date="2009-01-22" status="draft"/>
+    <credit type="author">
+      <name>Paul Cutler</name>
+      <email>pcutler gnome org</email>
+    </credit>    
+<!--
+    <copyright>
+      <year>2010</year>
+      <name>GNOME Documentation Project</name>
+    </copyright>
+-->
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Searching your Banshee Library</title>    
+  
+  <p>Banshee features a powerful search language.  You can search your 
+  library quickly and easily with basic search terms or perform detailed
+  searches with Banshee's advanced search terminology.</p>
+  
+  <p>To perform a search of your media in Banshee, press the <key>S</key> or
+  click the <gui>Search</gui> box in the upper right hand corner of the Library
+  view in Banshee.
+  </p>
+  
+  <p>A search query consists of some basic terms, for example, 
+  <em>dave matthews</em>.  By entering <em>dave matthews</em> in the search box,
+   Banshee will search all metadata fields including Track Title, Album Title,
+   Album Artist, Year, etc.  Any track whose metadata includes <em>dave</em> 
+   and <em>matthews</em> will be returned.  Search terms are case insensitive, meaning you don't have to 
capitalize.  <em>dave</em>, <em>Dave</em>, and <em>DAVE</em>
+   all mean the same thing when searching.</p>
+
+<section id="operators">
+  <title>Basic Operators</title>
+  <p>Operators can be placed between any two search words or placed before a 
+  search word.  The default operation is <gui>AND</gui> and is used when
+  no other operators are used between two search terms.  Because it is the
+  default, there is no explicit AND operator.</p>
+  
+  <p>Other basic operators include <gui>OR</gui> and <gui>NOT</gui>.  Together,
+  these three operations can yield very powerful queries to help you search
+  your media.</p>
+  
+</section>
+
+<section id="logical">
+  <title>Logical Operators and Examples</title>
+  <p>The following is a list of logical operators and examples of the search
+  results when searching using them.</p>
+  
+  <table frame="all" rules="rows" shade="rows">
+  <tr>
+    <td><p><gui>Operator</gui></p></td>  <td><p><gui>Description</gui></p></td>
+  </tr>
+  <tr>
+    <td><p><em>default</em>, <em>white space</em></p></td> <td><p>
+    Search for two terms with a space between the two words or terms.</p></td>
+  </tr>
+  <tr>
+    <td><p>OR, or, <key>|</key>, <key>,</key></p></td> <td><p>
+    Search results will be two songs with either result in any field.</p></td>
+  </tr>
+  <tr>
+    <td><p>NOT, not,<key>-</key></p></td> <td><p>
+    Do not display search results with any search term that follows the 
+    operator of NOT, not,<key>-</key>.</p></td>
+  </tr>  
+         
+</table>
+
+  <p>Examples of logical operations include:</p>
+  
+  <table frame="all" rules="rows" shade="rows">
+  <tr>
+    <td><p><gui>Query</gui></p></td>  <td><p><gui>Description</gui></p></td>
+  </tr>
+  <tr>
+    <td><p>dave matthews</p></td> <td><p>
+    Matches any fields in a track containing both <em>dave</em> and 
+    <em>matthews</em>.</p></td>
+  </tr>
+  <tr>
+    <td><p>dave, matthews</p></td> <td><p>
+    Matches any fields in a track containing either <em>dave</em> or
+    <em>matthews</em>.</p></td>
+  </tr>
+  <tr>
+    <td><p>dave or matthews</p></td> <td><p>
+    Matches any fields in a track containing either <em>dave</em> or
+    <em>matthews</em>.</p></td>
+  </tr> 
+  <tr>
+    <td><p>dave | matthews</p></td> <td><p>
+    Matches any fields in a track containing either <em>dave</em> or
+    <em>matthews</em>.</p></td>
+  </tr>       
+  <tr>
+    <td><p>-"dave matthews"</p></td> <td><p>
+    Displays all tracks whose fields do not contain <em>dave
+    matthews</em>.</p></td>
+  </tr> 
+  
+  </table> 
+  
+  <p>For more information on performing more complex search queries,
+  see the <link xref="adv-search"/> page.</p>
+  
+</section>
+       
+</page>
diff --git a/help/C/_sort.page b/help/C/_sort.page
new file mode 100644
index 0000000..8860be3
--- /dev/null
+++ b/help/C/_sort.page
@@ -0,0 +1,55 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic" style="task"
+      id="sort">
+
+  <info>
+    <link type="guide" xref="index#manage"/>
+    <link type="seealso" xref="search"/>
+    <desc>Sort your media and add additional columns.</desc>
+    <revision pkgversion="1.6" version="0.1" date="2009-01-22" status="draft"/>
+    <credit type="author">
+      <name>Paul Cutler</name>
+      <email>pcutler gnome org</email>
+    </credit>    
+<!--
+    <copyright>
+      <year>2010</year>
+      <name>GNOME Documentation Project</name>
+    </copyright>
+-->
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Sort your media</title>
+
+  <section id="addcolumn">
+
+  <title>Adding Columns</title>    
+  
+  <p>As your library grows, you may want to change your library view to add
+  additional information about the songs in your library or change the way
+  you can view and sort your songs, artists or albums.</p>
+  
+  <p>You can add additional columns to the library view in <app>Banshee</app>
+  to give you more information about the songs and also allow you to sort
+  by.  By default, Banshee displays columns for songs including 
+  <gui>Name</gui>, <gui>Artist</gui>, <gui>Album</gui> and <gui>Time</gui>.
+  To add additional columns, using your mouse right click on any of the columns
+  and Banshee will display all available column to choose from.  Click the
+  checkbox next to the name of the column you wish to add to the library view.
+  </p>
+  
+  </section>
+  
+  <section id="sorting">
+    <title>Sorting Columns</title>
+    <p>You can sort your library by using your mouse to click on any of the
+    columns displayed in library view.  If you wish to sort your music library
+    by Artist, click the <gui>Artist</gui> column header and Banshee will 
+    automatically sort that column alphabetically.  Clicking the 
+    <gui>Artist</gui> column again will sort the column in reverse alphabetical
+    order.</p>
+  </section>
+       
+</page>
diff --git a/help/C/_sync.page b/help/C/_sync.page
new file mode 100644
index 0000000..f25019d
--- /dev/null
+++ b/help/C/_sync.page
@@ -0,0 +1,150 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      xmlns:e="http://projectmallard.org/experimental/";
+      type="topic" style="task"
+      id="sync">
+
+  <info>
+    <link type="guide" xref="index#sync"/>
+    <link type="seealso" xref="playlists"/>
+    <desc>Sync your media to a portable media player or smartphone.</desc>
+    <revision pkgversion="1.8" version="0.1" date="2010-08-29" status="draft"/>
+    <credit type="author">
+      <name>Paul Cutler</name>
+      <email>pcutler gnome org</email>
+    </credit>    
+<!--
+    <copyright>
+      <year>2010</year>
+      <name>GNOME Documentation Project</name>
+    </copyright>
+-->
+    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
+  </info>
+
+  <title>Sync</title>    
+  
+  <p>Banshee supports syncing your music to portable media players and 
+  smartphones.  You can add specific music tracks, albums or playlist 
+  or allow Banshee to keep your music player in sync with your entire
+  library.  After your player is connected to your computer you can also
+  play back the songs on your portable player in Banshee.  When syncing
+  music in a lossless format, such as FLAC, Banshee will automatically
+  transcode your music for you to a lossy format such as Ogg Vorbis or MP3,
+  if you have the correct codecs installed.
+  </p>
+  
+  <section id="devices">
+    <title>Device Support</title>
+    <p>Banshee supports almost all modern portable music players and
+    smartphones with the notable exception of the Apple iPhone, iPad and
+    iPod Touch.</p>
+  
+  <p>When you plug your device in, Banshee will display it in the left menu.
+  Pressing the device icon will take you to your device home page in Banshee
+  displaying your sync preferences.
+  </p>
+  
+  </section>
+  
+    <section id="sync-settings">
+    <title>Sync Your Music</title>
+    <p>You can choose to manage the media on your portable music
+    by having Banshee automatically sync it or manage your music and media
+    manually.
+    </p>
+    
+    <p>Choose your device from the Banshee menu and then choose how you want
+    to sync your media, including:
+    </p>
+    <list>
+      <item><p>Music</p></item>
+      <item><p>Audiobooks</p></item>  
+      <item><p>Videos</p></item>
+      <item><p>Podcast</p></item>  
+    </list>
+    
+    <p>From the dropdown menu next to each of the media, choose from:
+    </p>
+    <list>
+      <item><p>Manage manually</p></item>
+      <item><p>Sync entire library</p></item>  
+    </list>    
+    
+    <note style="warning">
+      <p>If you choose to sync your entire library automatically with your
+      portable media player make sure your portable media player has enough
+      storage space.  If your library is larger than the space on your
+      portable media player, Banshee will sync media until your player is
+      full and then stop.        
+      </p>
+    </note>
+    
+    <p>If you have created playlists or smart playlists in your music library,
+    they will also be displayed as a sync option for Music.  This can be 
+    helpful when creating smart playlists, as smart playlists will automatically
+    update as new content is added based on the playlist rules, and Banshee
+    will sync the new playlist to your device every time you plug it in.
+    </p>
+    
+    <p>Banshee will display the total hard drive space of your portable music
+    player in a graph in the bottom center of Banshee.  The graph will show you
+    how much space is taken by audio files, video, other and free space.  
+    Directly below that Banshee will show you how many total items are stored
+    on your portable music player, how many hours or days of listening that is
+    equal to, and total space used.
+    </p>
+    
+  </section>
+
+  <section id="sync-manually">
+    <title>Sync Your Entire Library</title>
+    <p>You can drag and drop media to your portable music player from Banshee.
+    Select the file or files you want to copy to your portable media player
+    and then press and hold your right mouse button and drag the file(s) to
+    your portable media player icon in Banshee.  This will copy the files to 
+    your device.
+    </p>
+    
+    <p>If your music library is encoded in a format that your portable media
+    player does not support, such as OGG or FLAC, and you have the necessary
+    codecs installed, Banshee can automatically transcode these files to MP3
+    when transferring to your portable media player.  Check with your Linux
+    distribution for the necessary codecs as it is outside the scope of this
+    help and varies by distribution.
+    </p>
+    
+    <note style="tip">
+      <p>You may need to eject your device to load the files correctly
+      on your portable music player.  To eject your device in Banshee,
+      using your mouse right click the device in the Banshee menu and
+      press <gui>Disconnect</gui>.
+      </p>
+    </note>
+
+  </section>
+  
+  <section id="pmp-play">
+    <title>Play Music From Your Portable Music Player</title>
+    <p>You can play music stored on your portable music player directly in
+    Banshee.  Choose your player in the Banshee menu on the left and your 
+    portable music player's library will be displayed.  You can then play
+    music in Banshee just as you would music in your own library.</p>
+  </section>
+  
+  <section id="pmp-delete">
+    <title>Remove Music From your Portable Music Player</title>
+    <p>To remove songs stored on your portable music player, choose your
+    player in Banshee to view its library.  Then choose the tracks you would
+    like to remove and right click the tracks and choose <gui>Delete</gui> or from the 
+    menu choose <guiseq><gui>Edit</gui><gui>Delete</gui></guiseq>.</p>
+    
+     <note style="warning">
+      <p>Deleting files from your portable music player will permanently remove
+      the files and you will not be able to recover them.      
+      </p>
+    </note>
+    
+  </section>
+
+       
+</page>
diff --git a/help/C/index.page b/help/C/index.page
index ed291e5..2b477d7 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -1,19 +1,21 @@
 <page xmlns="http://projectmallard.org/1.0/";
-  type="guide"
-  id="index"
-  style="2column"
-  groups="one two">
+  type="guide" id="index"
+  style="2column">
 
   <info>
     <title type="link">Rhythmbox Music Player</title>
     <title type="text">Rhythmbox Music Player</title>
     <desc><app>Rhythmbox Music Player</app> help.</desc>
-    <revision pkgversion="3.0" version="0.1" date="2010-04-28" status="draft"/>
-    <revision pkgversion="3.0" version="0.2" date="2010-07-27" status="review"/>
+    <revision pkgversion="3.4.0" version="0.3" date="2012-02-20" 
+    status="draft"/>
     <credit type="author">
       <name>Milo Casagrande</name>
       <email>milo ubuntu com</email>
     </credit>
+    <credit type="author">
+      <name>Jim Campbell</name>
+      <email>jwcampbell gmail com</email>
+    </credit>
     <license>
       <p>
         Creative Commons Share Alike 3.0
@@ -28,21 +30,19 @@
     Rhythmbox Music Player
    </title>
 
-  <section id="rb-music" style="2column" groups="one two three four five">
+  <section id="rb-music" style="2column">
     <title>Library</title>
   </section>
   
-  <section id="rb-music-shops" style="2column" groups="one two">
+  <section id="rb-music-shops" style="2column">
     <title>Stores</title>
   </section>
 
-  <!-- Not the real name of the section you see in Rhythmbox, but Devices only
-       is not great... -->
   <section id="rb-portable-player" style="2column">
     <title>Portable Devices</title>
   </section>
   
-  <section id="rb-playlists" style="2column" groups="one two three four">
+  <section id="rb-playlists" style="2column">
     <title>Playlists</title>
   </section>
   
diff --git a/help/C/lastfm.page b/help/C/lastfm.page
index e3ef849..d052ab4 100644
--- a/help/C/lastfm.page
+++ b/help/C/lastfm.page
@@ -1,18 +1,19 @@
 <page xmlns="http://projectmallard.org/1.0/";
-  type="guide"
-  id="lastfm"
-  style="2column"
-  groups="one two">
+  type="guide" id="lastfm"
+  style="2column">
       
   <info>
-    <link type="guide" xref="index#rb-music" group="four"/>
+    <link type="guide" xref="index#rb-music"/>
     <desc>Discover new music based on what you listen.</desc>
-    <revision pkgversion="3.0" version="0.1" date="2010-07-19" status="draft"/>
-    <revision pkgversion="3.0" version="0.2" date="2010-07-27" status="review"/>
+    <revision pkgversion="3.4.0" version="0.1" date="2012-02-20" status="draft"/>
     <credit type="author">
       <name>Milo Casagrande</name>
       <email>milo ubuntu com</email>
     </credit>
+    <credit type="author">
+      <name>Jim Campbell</name>
+      <email>jwcampbell gmail com</email>
+    </credit>
     <license>
       <p>
         Creative Commons Share Alike 3.0
diff --git a/help/C/legal.xml b/help/C/legal.xml
index d8b5de6..86d6173 100644
--- a/help/C/legal.xml
+++ b/help/C/legal.xml
@@ -1,78 +1,9 @@
-<?xml version="1.0" encoding="UTF-8"?>
-
-  <legalnotice id="legalnotice">
-       <para>
-         Permission is granted to copy, distribute and/or modify this
-         document under the terms of the GNU Free Documentation
-         License (GFDL), Version 1.1 or any later version published
-         by the Free Software Foundation with no Invariant Sections,
-         no Front-Cover Texts, and no Back-Cover Texts.  You can find
-         a copy of the GFDL at this <ulink type="help"
-         url="help:fdl">link</ulink> or in the file COPYING-DOCS
-         distributed with this manual.
-         </para>
-         <para> This manual is part of a collection of GNOME manuals
-          distributed under the GFDL.  If you want to distribute this
-          manual separately from the collection, you can do so by
-          adding a copy of the license to the manual, as described in
-          section 6 of the license.
-       </para>
-
-       <para>
-         Many of the names used by companies to distinguish their
-         products and services are claimed as trademarks. Where those
-         names appear in any GNOME documentation, and the members of
-         the GNOME Documentation Project are made aware of those
-         trademarks, then the names are in capital letters or initial
-         capital letters.
-       </para>
-
-       <para>
-         DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT ARE PROVIDED
-         UNDER  THE TERMS OF THE GNU FREE DOCUMENTATION LICENSE
-         WITH THE FURTHER UNDERSTANDING THAT:
-
-         <orderedlist>
-               <listitem>
-                 <para>DOCUMENT IS PROVIDED ON AN "AS IS" BASIS,
-                    WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
-                    IMPLIED, INCLUDING, WITHOUT LIMITATION, WARRANTIES
-                    THAT THE DOCUMENT OR MODIFIED VERSION OF THE
-                    DOCUMENT IS FREE OF DEFECTS MERCHANTABLE, FIT FOR
-                    A PARTICULAR PURPOSE OR NON-INFRINGING. THE ENTIRE
-                    RISK AS TO THE QUALITY, ACCURACY, AND PERFORMANCE
-                    OF THE DOCUMENT OR MODIFIED VERSION OF THE
-                    DOCUMENT IS WITH YOU. SHOULD ANY DOCUMENT OR
-                    MODIFIED VERSION PROVE DEFECTIVE IN ANY RESPECT,
-                    YOU (NOT THE INITIAL WRITER, AUTHOR OR ANY
-                    CONTRIBUTOR) ASSUME THE COST OF ANY NECESSARY
-                    SERVICING, REPAIR OR CORRECTION. THIS DISCLAIMER
-                    OF WARRANTY CONSTITUTES AN ESSENTIAL PART OF THIS
-                    LICENSE. NO USE OF ANY DOCUMENT OR MODIFIED
-                    VERSION OF THE DOCUMENT IS AUTHORIZED HEREUNDER
-                    EXCEPT UNDER THIS DISCLAIMER; AND
-                 </para>
-               </listitem>
-               <listitem>
-                 <para>UNDER NO CIRCUMSTANCES AND UNDER NO LEGAL
-                       THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE),
-                       CONTRACT, OR OTHERWISE, SHALL THE AUTHOR,
-                       INITIAL WRITER, ANY CONTRIBUTOR, OR ANY
-                       DISTRIBUTOR OF THE DOCUMENT OR MODIFIED VERSION
-                       OF THE DOCUMENT, OR ANY SUPPLIER OF ANY OF SUCH
-                       PARTIES, BE LIABLE TO ANY PERSON FOR ANY
-                       DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR
-                       CONSEQUENTIAL DAMAGES OF ANY CHARACTER
-                       INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS
-                       OF GOODWILL, WORK STOPPAGE, COMPUTER FAILURE OR
-                       MALFUNCTION, OR ANY AND ALL OTHER DAMAGES OR
-                       LOSSES ARISING OUT OF OR RELATING TO USE OF THE
-                       DOCUMENT AND MODIFIED VERSIONS OF THE DOCUMENT,
-                       EVEN IF SUCH PARTY SHALL HAVE BEEN INFORMED OF
-                       THE POSSIBILITY OF SUCH DAMAGES.
-                 </para>
-               </listitem>
-         </orderedlist>
-       </para>
-  </legalnotice>
-
+<license xmlns="http://projectmallard.org/1.0/";
+         href="http://creativecommons.org/licenses/by-sa/3.0/";>
+<p>This work is licensed under a
+<link href="http://creativecommons.org/licenses/by-sa/3.0/";>Creative Commons
+Attribution-Share Alike 3.0 Unported License</link>.</p>
+<p>As a special exception, the copyright holders give you permission to copy,
+modify, and distribute the example code contained in this document under the
+terms of your choosing, without restriction.</p>
+</license>
diff --git a/help/C/podcast.page b/help/C/podcast.page
index c3c10e7..bbdbb40 100644
--- a/help/C/podcast.page
+++ b/help/C/podcast.page
@@ -1,11 +1,10 @@
 <page xmlns="http://projectmallard.org/1.0/";
   type="guide"
   id="podcast"
-  style="2column"
-  groups="one two three four">
+  style="2column">
 
   <info>
-    <link type="guide" xref="index#rb-music" group="three"/>
+    <link type="guide" xref="index#rb-music"/>
     <desc>Listen and manage podcasts.</desc>
     <revision pkgversion="3.0" version="0.1" date="2010-06-29" status="draft"/>
     <revision pkgversion="3.0" version="0.2" date="2010-07-15" status="draft"/>
@@ -15,6 +14,10 @@
       <name>Milo Casagrande</name>
       <email>milo ubuntu com</email>
     </credit>
+    <credit type="author">
+      <name>Jim Campbell</name>
+      <email>jwcampbell gmail com</email>
+    </credit>
     <license>
       <p>
         Creative Commons Share Alike 3.0
diff --git a/help/C/radio-stations.page b/help/C/radio-stations.page
index 2775e72..68c480b 100644
--- a/help/C/radio-stations.page
+++ b/help/C/radio-stations.page
@@ -1,11 +1,9 @@
 <page xmlns="http://projectmallard.org/1.0/";
-  type="guide"
-  id="radio-stations"
-  style="2column"
-  groups="one two">
+  type="guide" id="radio-stations"
+  style="2column">
 
   <info>
-    <link type="guide" xref="index#rb-music" group="five"/>
+    <link type="guide" xref="index#rb-music"/>
     <desc>Listen and manage Internet radio stations.</desc>
     <revision pkgversion="3.0" version="0.1" date="2010-06-29" status="draft"/>
     <revision pkgversion="3.0" version="0.2" date="2010-07-15" status="draft"/>


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]