[banshee] [help] Add sync docs

[Paul Cutler <pcutler src gnome org>]

commit 1da8cba539980ee76df8ba051d5cdaad6b7d0e2e
Author: Paul Cutler <pcutler gnome org>
Date:   Tue Aug 31 19:21:46 2010 -0500

    [help] Add sync docs

 help/C/sync.page |  116 ++++++++++++++++++++++++++++++++++++++++++++++--------
 1 files changed, 99 insertions(+), 17 deletions(-)
---
diff --git a/help/C/sync.page b/help/C/sync.page
index 9a31d3a..180eb50 100644
--- a/help/C/sync.page
+++ b/help/C/sync.page
@@ -7,7 +7,7 @@
     <link type="guide" xref="index#sync"/>
     <link type="seealso" xref="sync"/>
     <desc>Sync your media to a portable media player.</desc>
-    <revision pkgversion="1.6" version="0.1" date="2010-07-15" status="draft"/>
+    <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>
@@ -38,31 +38,113 @@
     <p>Banshee supports almost all modern portable music players and
     smartphones with the notable exception of the Apple iPhone, iPad and
     iPod Touch.</p>
-  </section>
   
-  <section id="pmp-play">
-    <title>Play Music From Your Portable Music Player</title>
-    <p></p>
-  </section>
+  <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 id="pmp-delete">
-    <title>Remove Music From your Portable Music Player</title>
-    <p></p>
   </section>
   
-  <section id="sync-music">
+    <section id="sync-settings">
     <title>Sync Your Music</title>
-    <p></p>
+    <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-library">
+
+  <section id="sync-manually">
     <title>Sync Your Entire Library</title>
-    <p></p>
+    <p>You can drag and drop media to your portable music player form 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="sync-playlist">
-    <title>Sync Playlists</title>
-    <p></p>
+  <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 "Delete" or from the 
+    menu choose <guiseq><gui>Edit</gui><gui>Delete</gui></guiseq></p>.
+    
+        <note style="warning">
+      <p>Deleting files from your portable music will permanently remove
+      the files and you will not be able to recover them.      
+      </p>
+    </note>
+    
   </section>
+
 	
 </page>