[rhythmbox/mallard-help: 34/55] docs: still a work-in-progress, but committing now so I don't loose changes.

[David King <davidk src gnome org>]

commit ad17a7e9a0e7345fc77b78c5b846d55fface8720
Author: Jim Campbell <jwcampbell gmail com>
Date:   Wed Feb 29 01:14:24 2012 -0600

    docs: still a work-in-progress, but committing now so I don't loose changes.

 help/C/index.page                   |   14 ++++----
 help/C/overview.page                |    2 +-
 help/C/podcast-add.page             |   54 ++++++++++++++--------------------
 help/C/podcast-change-check.page    |    3 +-
 help/C/podcast-change-download.page |    3 +-
 help/C/podcast-listen.page          |    5 ++-
 help/C/podcast.page                 |   24 +++++++--------
 help/C/rhythmbox-docs-notes         |   29 ++++++++++++++++++
 8 files changed, 77 insertions(+), 57 deletions(-)
---
diff --git a/help/C/index.page b/help/C/index.page
index 2b477d7..0451e7c 100644
--- a/help/C/index.page
+++ b/help/C/index.page
@@ -1,6 +1,6 @@
 <page xmlns="http://projectmallard.org/1.0/";
   type="guide" id="index"
-  style="2column">
+  style="2column task">
 
   <info>
     <title type="link">Rhythmbox Music Player</title>
@@ -31,20 +31,20 @@
    </title>
 
   <section id="rb-music" style="2column">
-    <title>Library</title>
+    <title>Play Music</title>
   </section>
   
   <section id="rb-music-shops" style="2column">
-    <title>Stores</title>
-  </section>
-
-  <section id="rb-portable-player" style="2column">
-    <title>Portable Devices</title>
+    <title>Find and Buy New Music</title>
   </section>
   
   <section id="rb-playlists" style="2column">
     <title>Playlists</title>
   </section>
+
+  <section id="rb-portable-player" style="2column">
+    <title>Portable Devices</title>
+  </section>
   
   <section id="rb-advanced-actions" style="2column">
     <title>Advanced Actions</title>
diff --git a/help/C/overview.page b/help/C/overview.page
index 620b4b5..ac319af 100644
--- a/help/C/overview.page
+++ b/help/C/overview.page
@@ -1,5 +1,5 @@
 <page xmlns="http://projectmallard.org/1.0/";
-  type="topic"
+  type="topic" style="ui"
   id="overview">
       
   <info>
diff --git a/help/C/podcast-add.page b/help/C/podcast-add.page
index f85e3b5..48887d0 100644
--- a/help/C/podcast-add.page
+++ b/help/C/podcast-add.page
@@ -1,55 +1,45 @@
 <page xmlns="http://projectmallard.org/1.0/";
   type="topic"
-  id="podcast-add">
+  id="podcast-add"
+  style="task">
       
   <info>
     <link type="guide" xref="podcast" group="one"/>
     <desc>Subscribe to a new podcast feed.</desc>
-    <revision pkgversion="3.0" version="0.1" date="2010-07-16" status="draft"/>
-    <revision pkgversion="3.0" version="0.1" date="2010-07-27" status="review"/>
+    <revision pkgversion="3.4" version="0.8" date="2012-02-26" 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</p>
     </license>
   </info>
 
   <title>Add a podcast feed</title>
-  <p>
-    Before you subscribe to a new podcast feed, it is necessary to have the
-    address of the feed you want to add.
-  </p>
-  <p>
-    The feed address should be available on the podcast website.
-  </p>
   
-  <note>
-    <p>
-      Usually the podcast feed address is not the podcast website address. That 
-      address should be advertised on the podcast website.
-    </p>
-  </note>
+  <p>Before you subscribe to a new podcast feed, you will need to know the 
+  Feed URL of the podcast. The feed address should be available on the podcast's 
+  website.</p>
+  
+  <note><p>Usually the podcast Feed URL is <em>not</em> the same as the podcast 
+  website address. The Feed URL for the podcast is normally featured somewhere 
+  on the podcast website, though.</p></note>
 
   <steps>
-    <item>
-      <p>
-        Select <guiseq><gui style="menu">Music</gui>
-        <gui style="menuitem">New Podcast Feed</gui></guiseq>.
-      </p>
-    </item>
-    <item>
-      <p>
-        Type or paste the address in the text-box, and 
-        click <gui style="button">Add</gui>.        
-      </p>
-    </item>
+    <title>To subscribe to a podcast:</title>
+    <item><p>From within <app>Rhythmbox</app>, select <guiseq><gui>Music</gui>
+    <gui style="menuitem">New Podcast Feed...</gui></guiseq></p></item>
+    <item><p>Enter the Podcast's Feed URL into the Feed URL window.</p></item>
+    <item><p>Click <gui style="button">OK</gui>.</p></item>
   </steps>
   
-  <p>
-    Once you add a new podcast feed, <app>Rhythmbox</app> will check by default
-    for new episodes every hour.
-  </p>
+  <p>After you add a new podcast feed, <app>Rhythmbox</app> will check for new 
+  podcast episodes every hour. If you want <app>Rhythmbox</app> to check 
+  for podcasts less frequently, see ____________________.</p>
 
 </page>
diff --git a/help/C/podcast-change-check.page b/help/C/podcast-change-check.page
index 7e8604c..df179f9 100644
--- a/help/C/podcast-change-check.page
+++ b/help/C/podcast-change-check.page
@@ -1,6 +1,7 @@
 <page xmlns="http://projectmallard.org/1.0/";
   type="topic"
-  id="podcast-change-check">
+  id="podcast-change-check"
+  style="task">
       
   <info>
     <link type="guide" xref="podcast" group="four"/>
diff --git a/help/C/podcast-change-download.page b/help/C/podcast-change-download.page
index e9374db..3e60a51 100644
--- a/help/C/podcast-change-download.page
+++ b/help/C/podcast-change-download.page
@@ -1,6 +1,7 @@
 <page xmlns="http://projectmallard.org/1.0/";
   type="topic"
-  id="podcast-change-download">
+  id="podcast-change-download"
+  style="task">
       
   <info>
     <link type="guide" xref="podcast" group="three"/>
diff --git a/help/C/podcast-listen.page b/help/C/podcast-listen.page
index dfd04a0..f6a66de 100644
--- a/help/C/podcast-listen.page
+++ b/help/C/podcast-listen.page
@@ -1,6 +1,7 @@
 <page xmlns="http://projectmallard.org/1.0/";
-  type="topic"
-  id="podcast-listen">
+  type="topic" 
+  id="podcast-listen"
+  style="task">
       
   <info>
     <link type="guide" xref="podcast" group="two"/>
diff --git a/help/C/podcast.page b/help/C/podcast.page
index bbdbb40..ad4387c 100644
--- a/help/C/podcast.page
+++ b/help/C/podcast.page
@@ -1,15 +1,12 @@
 <page xmlns="http://projectmallard.org/1.0/";
   type="guide"
   id="podcast"
-  style="2column">
+  style="2column task">
 
   <info>
     <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"/>
-    <revision pkgversion="3.0" version="0.3" date="2010-07-19" status="draft"/>
-    <revision pkgversion="3.0" version="0.3" date="2010-07-27" status="review"/>
+    <desc>Manage and listen to podcasts.</desc>
+    <revision pkgversion="3.4" version="0.3" date="2012-02-25" status="review"/>
     <credit type="author">
       <name>Milo Casagrande</name>
       <email>milo ubuntu com</email>
@@ -28,17 +25,18 @@
   <title>Podcasts</title>
   
   <p>
-    A podcast is a digital audio or video file, that is released
-    episodically and is downloaded from the Internet.    
-  </p>
-  <p>
-    It is like an episode of a radio or television show: it has a main host and a theme.
+    A podcast is a digital audio or video show that is published on the 
+    Internet. It is like an episode of a radio or television show: it has a 
+    main host and a theme.
   </p>
   
+  <p>You can use <app>Rhythmbox</app> to subscribe to your favorite podcasts, 
+  and it will download new podcast episodes when they are published.</p>
+
   <note>
     <p>
-      <app>Rhythmbox Music Player</app> supports only audio podcasts.
+      <app>Rhythmbox</app> does not support Apple iTunes podcast URLs.
     </p>
   </note>
-
+  
 </page>
diff --git a/help/C/rhythmbox-docs-notes b/help/C/rhythmbox-docs-notes
new file mode 100644
index 0000000..e28c2be
--- /dev/null
+++ b/help/C/rhythmbox-docs-notes
@@ -0,0 +1,29 @@
+What is libre.fm
+What is last.fm
+how can i resolve import errors when rhythmbox scans my music database?
+how can i add a podcast?
+how can i create a playlist
+export a playlist
+import a playlist
+set music to random mode
+repeat songs
+only play songs by a certain artist
+display visualizations
+show album art
+import a cd (convert to mp3)
+rate a cd
+view recently added tracks
+change the information that is displayed for each song
+search for a song or artist
+fix tagging errors
+add a podcast
+remove a podcast
+change where rhythmbox searches for music
+normalize my audio
+connect to a DAAP share
+what is DAAP?
+crossfade between tracks
+what is crossfade?
+turn full-screen mode on or off
+start / stop / pause music
+turn volume on / off