[rhythmbox/mallard-help: 21/55] Worked on the podcast topics: * Added new topics * Fixed the old one

[David King <davidk src gnome org>]

commit 6c93d890891a538e6976711b1c14cd9606ac19de
Author: Milo Casagrande <milo ubuntu com>
Date:   Sun Jul 18 21:36:46 2010 +0200

    Worked on the podcast topics:
     * Added new topics
     * Fixed the old one

 help/C/podcast-add.page             |   54 +++++++++++++++++++++++++++++++++++
 help/C/podcast-change-check.page    |   40 ++++++++++++++++++++++++++
 help/C/podcast-change-download.page |   39 +++++++++++++++++++++++++
 help/C/podcast-listen.page          |   52 +++++++++++++++++++++++++++++++++
 help/C/podcast.page                 |   19 +++++++++++-
 5 files changed, 202 insertions(+), 2 deletions(-)
---
diff --git a/help/C/podcast-add.page b/help/C/podcast-add.page
new file mode 100644
index 0000000..27e3d9d
--- /dev/null
+++ b/help/C/podcast-add.page
@@ -0,0 +1,54 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="topic"
+  id="podcast-add">
+      
+  <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"/>
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu 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>
+
+  <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>
+  </steps>
+  
+  <p>
+    Once you add a new podcast feed, <app>Rhythmbox</app> will check by default
+    for new episodes every hour.
+  </p>
+
+</page>
diff --git a/help/C/podcast-change-check.page b/help/C/podcast-change-check.page
new file mode 100644
index 0000000..c983700
--- /dev/null
+++ b/help/C/podcast-change-check.page
@@ -0,0 +1,40 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="topic"
+  id="podcast-change-check">
+      
+  <info>
+    <link type="guide" xref="podcast" group="four"/>
+    <link type="seealso" xref="podcast-listen"/>
+    <desc>Change how often to check for new episodes.</desc>
+    <revision pkgversion="3.0" version="0.1" date="2010-07-18" status="draft"/>
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Change episodes check frequency</title>
+  
+  <steps>
+    <item>
+      <p>
+        Select <guiseq><gui style="menu">Edit</gui><gui style="menuitem">Preferences</gui></guiseq>.
+      </p>
+    </item>
+    <item>
+      <p>
+        Select the <gui style="tab">Podcasts</gui> tab.
+      </p>
+    </item>
+    <item>
+      <p>
+        From the <gui>Check for new episodes</gui> drop-down list, select the desired
+        check frequency.
+      </p>
+    </item>
+  </steps>
+  
+</page>
diff --git a/help/C/podcast-change-download.page b/help/C/podcast-change-download.page
new file mode 100644
index 0000000..e7747e0
--- /dev/null
+++ b/help/C/podcast-change-download.page
@@ -0,0 +1,39 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="topic"
+  id="podcast-change-download">
+      
+  <info>
+    <link type="guide" xref="podcast" group="three"/>
+    <link type="seealso" xref="podcast-listen"/>
+    <desc>Change where the podcast episodes are saved.</desc>
+    <revision pkgversion="3.0" version="0.1" date="2010-07-18" status="draft"/>
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu com</email>
+    </credit>
+    <license>
+      <p>Creative Commons Share Alike 3.0</p>
+    </license>
+  </info>
+
+  <title>Change episodes download location</title>
+  
+  <steps>
+    <item>
+      <p>
+        Select <guiseq><gui style="menu">Edit</gui><gui style="menuitem">Preferences</gui></guiseq>.
+      </p>
+    </item>
+    <item>
+      <p>
+        Select the <gui style="tab">Podcasts</gui> tab.
+      </p>
+    </item>
+    <item>
+      <p>
+        From the <gui>Download location</gui> drop-down list, select a new location
+        where the podcast episodes will be saved.
+      </p>
+    </item>
+  </steps>
+</page>
diff --git a/help/C/podcast-listen.page b/help/C/podcast-listen.page
new file mode 100644
index 0000000..b8ca9c7
--- /dev/null
+++ b/help/C/podcast-listen.page
@@ -0,0 +1,52 @@
+<page xmlns="http://projectmallard.org/1.0/";
+  type="topic"
+  id="podcast-listen">
+      
+  <info>
+    <link type="guide" xref="podcast" group="two"/>
+    <link type="seealso" xref="podcast-add"/>
+    <desc>Listen to a podcast episode.</desc>
+    <revision pkgversion="3.0" version="0.1" date="2010-07-15" status="draft"/>
+    <credit type="author">
+      <name>Milo Casagrande</name>
+      <email>milo ubuntu com</email>
+    </credit>
+    <license>
+      <p>
+        Creative Commons Share Alike 3.0
+      </p>
+    </license>
+  </info>
+
+  <title>Listen to a podcast</title>
+  
+  <steps>
+    <item>
+      <p>
+        Select the <gui>Podcasts</gui> library.
+      </p>
+    </item>
+    <item>
+      <p>
+        In the <gui>Feed</gui> pane, select the name of the podcast source.
+      </p>
+    </item>
+    <item>
+      <p>
+        In the lower pane, double-click on the episode you want to listen to.
+      </p>
+      <p>
+        If the <gui>Status</gui> column for the episode is empty, it means that
+        the episode has not been downloaded yet. Before you can start listening to
+        it, <app>Rhythmbox</app> needs to download it from the Internet. The time
+        taken to download the episode depends on your Internet connection.
+      </p>
+    </item>
+  </steps>
+
+  <p>
+    Once an episode has been downloaded, it is saved in your personal 
+    <file style="directory">Music</file> folder.
+  </p>
+  
+</page>
diff --git a/help/C/podcast.page b/help/C/podcast.page
index 8e99753..e4fb180 100644
--- a/help/C/podcast.page
+++ b/help/C/podcast.page
@@ -1,12 +1,14 @@
 <page xmlns="http://projectmallard.org/1.0/";
   type="guide"
   id="podcast"
-  style="2column">
+  style="2column"
+  groups="one two three four">
 
   <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"/>
     <credit type="author">
       <name>Milo Casagrande</name>
       <email>milo ubuntu com</email>
@@ -20,6 +22,19 @@
 
   <title>Podcasts</title>
   
-  <!-- Structure page as the playlist one? Need to describe what a podcast is.-->
+  <p>
+    A podcast is a digital audio or video file, that is realeased
+    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.
+  </p>
+  
+  <note>
+    <p>
+      <app>Rhythmbox Music Player</app> supports only audio podcasts.
+    </p>
+  </note>
+  
 
 </page>