GNOME.org
 

[banshee] Update help: Modified ui, radio, play-queue pages

commit fb0963abbcc6baf7577a5ecfd711bc8619c33a58
Author: Aruna Sankaranarayanan <arunasank src gnome org>
Date:   Tue May 14 09:59:20 2013 +0530

    Update help: Modified ui, radio, play-queue pages
    
    Changed ui.page: Added <app> tags,<gui> tags, changed style.
    
    Updated radio.page:Added <steps> tag and reflowed text.
    
    Changed play-queue.page:Added <gui> tags to "Play Queue".
    Changed style in remove-media section to a list.
    Reflowed text.
    
    Changed capitalisation to British capitalisation.

 help/C/play-queue.page |   77 ++++++++++++++++++++++++++++---------------
 help/C/radio.page      |   85 ++++++++++++++++++++++++++---------------------
 help/C/ui.page         |   85 +++++++++++++++++++++++++++++------------------
 3 files changed, 149 insertions(+), 98 deletions(-)
---
diff --git a/help/C/play-queue.page b/help/C/play-queue.page
index 3ded05b..a8476ee 100644
--- a/help/C/play-queue.page
+++ b/help/C/play-queue.page
@@ -6,8 +6,13 @@
   <info>
     <link type="guide" xref="index#media"/>
     <link type="seealso" xref="play"/>
-    <desc>Add media to your play queue.</desc>
+    <desc>Add media to your <gui>Play Queue</gui>.</desc>
     <revision pkgversion="1.6" version="0.1" date="2010-05-26" status="draft"/>
+    <credit type="editor copyright">
+      <name>Aruna Sankaranarayanan</name>
+      <email>aruna evam gmail com</email>
+      <years>2013</years>
+    </credit>
     <credit type="author">
       <name>Paul Cutler</name>
       <email>pcutler gnome org</email>
@@ -15,33 +20,34 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Play Queue</title>
+  <title><gui>Play Queue</gui></title>
 
   <p>The <gui>Play Queue</gui> allows you to add music to play in a sequential
   order. You can add many tracks to let you listen to hours of music non-stop.
-  You can add individual tracks or entire albums, and sort or re-order them.</p>
+  You can add individual tracks or entire albums, and sort or re-order
+  them.</p>
 
   <section id="add-queue">
-    <title>Add Music to the Play Queue</title>
+    <title>Add Music to the <gui>Play Queue</gui></title>
 
   <p>From your music library, you will need to select the music tracks or
-  albums you want to add to the play queue.</p>
+  albums you want to add to the <gui>Play Queue</gui>.</p>
 
-  <p>To add an entire album to the Play Queue, using your mouse press and hold
-  the album and drag the album over <gui>Play Queue</gui> in the far left
-  window pane.</p>
+  <p>To add an entire album to the <gui>Play Queue</gui>, using your mouse
+  press and hold the album and drag the album over <gui>Play Queue</gui> in the
+  far left window pane.</p>
 
-  <p>You can add music tracks to the Play Queue individually or as a group.
-  To add an individual file, drag and drop it over the <gui>Play Queue</gui>
-  in the far left window pane, or right click the track and choose
-  <gui style="menuitem">Add to Play Queue</gui>.</p>
+  <p>You can add music tracks to the <gui>Play Queue</gui> individually or as
+  a group. To add an individual file, drag and drop it over the
+  <gui>Play Queue</gui> in the far left window pane, or right click the track
+  and choose <gui style="menuitem">Add to Play Queue</gui>.</p>
 
   <p>You can select multiple files by using your mouse and pressing
-  <key>Control</key> and choosing each file with your mouse or select a range
-  of files by pressing <key>Shift</key> and clicking twice to select that
-  range of files. You can then drag and drop it over the <gui>Play Queue</gui>
-  in the far left window pane or right click the tracks and choose
-  <gui style="menuitem">Add to Play Queue</gui>.</p>
+  <key>Ctrl</key> and choosing each file with your mouse or select a range of
+  files by pressing <key>Shift</key> and clicking twice to select that range of
+  files. You can then drag and drop it over the <gui>Play Queue</gui> in the
+  far left window pane or right click the tracks and choose <gui
+  style="menuitem">Add to Play Queue</gui>.</p>
 
   </section>
 
@@ -57,18 +63,35 @@
 
   </section>
 
-  <section id="removequeue">
-    <title>Removing Tracks from the Play Queue</title>
+  <section id="remove-queue">
+    <title>Removing Tracks from the <gui>Play Queue</gui></title>
 
   <p>You can remove an individual track, a group of tracks, or clear your
-  entire play queue.</p>
-
-  <p>To remove an individual track or group of tracks, select the track with
-  your mouse and then press <key>Delete</key>.</p>
+  entire <gui>Play Queue</gui>.</p>
+
+  <list>
+    <item>
+      <p>To remove an individual track, select the track with your mouse and
+      then press <key>Delete</key>.</p>
+    </item>
+    <item>
+      <p>To remove multiple tracks, select each of the different tracks with
+      your mouse while holding down <key>Ctrl</key>. Once all the desired
+      tracks have been selected, press <key>Delete</key>.</p>
+      <note style="tip">
+        <p>If you accidentally select a track you do not want to remove, hold
+       down <key>Ctrl</key> and select the track again to unselect it.</p>
+      </note>
+    </item>
+    <item>
+      <p> To clear your entire <gui>Play Queue</gui>, press the
+      <gui style="button">Clear</gui> button in the upper right hand corner of
+      the <gui>Play Queue</gui> or press
+      <keyseq><key>Ctrl</key><key>A</key></keyseq> and press
+      <key>Delete</key>.</p>
+    </item>
+  </list>
 
-  <p>To clear your entire Play Queue, press the <gui style="button">Clear</gui>
-  button in the upper right hand corner of the Play Queue.</p>
-
-</section>
+  </section>
 
 </page>
diff --git a/help/C/radio.page b/help/C/radio.page
index ff48ad5..732d881 100644
--- a/help/C/radio.page
+++ b/help/C/radio.page
@@ -15,7 +15,7 @@
       <email>pcutler gnome org</email>
     </credit>
     <credit type="editor">
-      <name>Aruna S</name>
+      <name>Aruna Sankaranarayanan</name>
       <email>aruna evam gmail com</email>
     </credit>
 <!--
@@ -46,43 +46,52 @@
   <p>Search for internet radio stations using your favourite search engine.
   You can specify genres, channel frequencies, names of stations and other
   details to narrow down your search. Many radio stations display either a
-  button or a link to listen to their stream. In most browsers, you can right
-  click on the link and choose <gui style="menuitem">Copy Link</gui>.</p>
+  button or a link to listen to their stream. In most web-browsers, you can
+  right click on the link and choose <gui style="menuitem">Copy Link</gui>.
+  </p>
 
-  <p>To add an internet radio station to <app>Banshee</app>, select
-  <gui>Radio</gui> in the menu on the left hand side of your window, then click
-  on <gui style="menuitem">Add Station</gui> on the upper right hand corner of
-  <app>Banshee</app>. Or, you can select <guiseq><gui style="menu">Media</gui>
-  <gui style="menuitem">Add Station</gui></guiseq> from
-  the menu.</p>
-
-  <p>You will need to enter some details about the radio station that you wish
-  to add. The first three fields are mandatory:</p>
-
-  <list>
+  <steps>
+  <title>To add an internet radio station to <app>Banshee</app>:</title>
     <item>
-      <p>In the <gui style="menuitem">Station Genre</gui> field, describe the
-      type of music the internet radio station plays by creating an appropriate
-      label, or choose a label from the available drop down selections.</p>
+      <p>Select <gui>Radio</gui> in the menu on the left hand side of your
+      window, then click on <gui style="menuitem">Add Station</gui> on the
+      upper right hand corner of <app>Banshee</app>. Or, you can select
+      <guiseq><gui style="menu">Media</gui> <gui style="menuitem">Add
+      Station</gui></guiseq> from the menu.</p>
     </item>
     <item>
-      <p>In the <gui style="input">Station Name</gui> field, enter a name for
-      the radio station.</p>
+      <p>You will need to enter some details about the radio station that you
+      wish to add. The first three fields are mandatory:</p>
+        <list>
+          <item>
+            <p>In the <gui style="menuitem">Station Genre</gui> field,
+           describe the type of music the internet radio station plays by
+           creating an appropriate label, or choose a label from the available
+           drop down selections.</p>
+          </item>
+          <item>
+            <p>In the <gui style="input">Station Name</gui> field, enter a
+           name for the radio station.</p>
+          </item>
+          <item>
+            <p>In the <gui style="input">Stream URL</gui> field, enter or
+           paste the URL of the stream by right clicking and selecting
+           <gui style="menuitem">Paste</gui> or pressing
+           <keyseq><key>Control</key><key>V</key></keyseq>.</p>
+          </item>
+        </list>
     </item>
     <item>
-      <p>In the <gui style="input">Stream URL</gui> field, enter or paste the
-      URL of the stream by right clicking and selecting
-      <gui style="menuitem">Paste</gui> or pressing
-      <keyseq><key>Control</key><key>V</key></keyseq>.</p>
+      <p>You can also fill out the fields for
+      <gui style="input">Station Creator</gui>,
+      <gui style="input">Description</gui>, and
+      <gui style="input">Rating</gui>.</p>
     </item>
-  </list>
-
-  <p>You can also fill out the fields for <gui style="input">Station
-  Creator</gui>, <gui style="input">Description</gui>, and <gui
-  style="input">Rating</gui>.</p>
-
-  <p>Finally, click <gui style="button">Save</gui> to save the internet radio
-  station in <app>Banshee</app>.</p>
+    <item>
+      <p>Finally, click <gui style="button">Save</gui> to save the internet
+      radio station in <app>Banshee</app>.</p>
+    </item>
+  </steps>
 
   </section>
 
@@ -90,10 +99,10 @@
     <title>Play a radio station</title>
 
   <p>To <link xref="play">play</link> a radio station, double click on the
-  radio station. Alternatively, right click on the station and select <gui
-  style="menuitem">Play</gui> or select the radio station and choose
-  <guiseq><gui style="menu">Playback</gui><gui
-  style="menuitem">Play</gui></guiseq>.</p>
+  radio station. Alternatively, right click on the station and select
+  <gui style="menuitem">Play</gui> or select the radio station and choose
+  <guiseq><gui style="menu">Playback</gui>
+  <gui style="menuitem">Play</gui></guiseq>.</p>
 
   <!--Not sure about play queue and play after current track-->
 
@@ -103,9 +112,9 @@
   will play the radio station when the queue has finished playing all media
   which is ahead of the station in the <gui>Play Queue</gui>.</p>
 
-  <p>You can also right click the station and select <gui
-  style="menuitem">Play after Current Track</gui> to add the radio station to
-  the queue after the track that is currently playing.</p>
+  <p>You can also right click the station and select
+  <gui style="menuitem">Play after Current Track</gui> to add the radio
+  station to the queue after the track that is currently playing.</p>
 
   <note style="bug">
     <p><gui style="menuitem">Play after Current Track</gui> may not work on
diff --git a/help/C/ui.page b/help/C/ui.page
index bc2ef5d..2ab0bf9 100644
--- a/help/C/ui.page
+++ b/help/C/ui.page
@@ -25,7 +25,7 @@
     <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
   </info>
 
-  <title>Introduction to the Banshee User Interface</title>
+  <title>Introduction to the <app>Banshee</app> user interface</title>
 
   <figure>
     <title><gui>Banshee Media Player</gui> window</title>
@@ -39,57 +39,76 @@
   <section id="context">
     <title>Sources</title>
 
-  <p>Your music and video sources are shown on the left in Banshee. The
-  sources give you quick access to your Play Queue, Music, Videos, Amazon,
-  Last.fm, Podcasts and more.</p>
+  <p>Your music and video sources are shown on the left in <app>Banshee</app>.
+  The sources give you quick access to your <gui>Play Queue</gui>,
+  <gui>Music</gui>, <gui>Videos</gui>, <gui>Amazon MP3 Store</gui>,
+  <gui>Last.fm</gui>, <gui>Podcasts</gui> and more.</p>
 
   <note style="tip">
     <p>The menu choices will change depending on the source you have chosen.
     For example, to use the menu to import a Podcast, you will need to choose
-    the Podcast source. The menu option for importing a Podcast is not
-    available when viewing the video or music library.</p>
+    the <gui>Podcasts</gui> source. The menu option for importing a Podcast is
+    not available when viewing the video or music library.</p>
   </note>
 
   </section>
 
   <section id="browser">
-    <title>Library Browser</title>
+    <title>Library browser</title>
 
-  <p>When you select a music or video source from Sources, Banshee will
-  display your content in the Library browser. Depending on the source
-  you choose, Banshee can display your music or video library, Podcast
+  <p>When you select a music or video source from Sources, <app>Banshee</app>
+  will display your content in the library browser. Depending on the source you
+  choose, <app>Banshee</app> can display your music or video library, Podcast
   subscriptions or even the Amazon Music Store to allow you to buy music.</p>
 
   </section>
 
   <section id="now-playing">
-    <title>Now Playing View</title>
-
-  <p>Helpful when using Banshee in full screen mode, the Now Playing mode
-  hides the library to give you a larger view of the music or video you're
-  watching. When listening to music, the Now Playing view will show you
-  the artist name, album and cover art if available. If you are watching
-  a video, Banshee will display the video.</p>
-
-  <p>To change Now Playing to hide the <app>Banshee</app> user interface and
-  use the full screen mode, you can press <key>F</key>, <key>F11</key>, press
-  the <gui style="button">Fullscreen</gui> button in the upper right hand
-  corner of <app>Banshee</app>, or choose
-  <guiseq><gui style="menu">View</gui>
-  <gui style="menuitem">Fullscreen</gui></guiseq> to
-  start Fullscreen mode.</p>
+    <title><gui>Now Playing</gui> view</title>
+
+  <p>Helpful when using <app>Banshee</app> in full screen mode, the
+  <gui>Now Playing</gui> mode hides the library to give you a larger view of
+  the music or video you are watching. When listening to music, the
+  <gui>Now Playing</gui> view will show you the artist name, album and cover
+  art if available. If you are watching a video, <app>Banshee</app> will
+  display the video.</p>
+
+  <p>To change the <gui>Now Playing</gui> mode to hide the <app>Banshee</app>
+  user interface and view your media in full screen mode instead, you can do
+  any of the following:</p>
+
+  <list>
+    <item>
+      <p>Double-click the view with your mouse.</p>
+    </item>
+    <item>
+      <p>Press <key>F</key>.</p>
+    </item>
+    <item>
+      <p>Press <key>F11</key>.</p>
+    </item>
+    <item>
+      <p>Press the <gui style="button">Fullscreen</gui> button in the upper
+      right hand corner of <app>Banshee</app>.</p>
+    </item>
+    <item>
+      <p>Select <guiseq><gui style="menu">View</gui>
+      <gui style="menuitem">Fullscreen</gui></guiseq>.</p>
+    </item>
+  </list>
 
   </section>
 
-  <section id="library">
-    <title>Library</title>
+  <section id="libraries">
+    <title>Libraries</title>
 
-  <p>The Library view in Banshee will change depending on the Source you have
-  chosen. The Music Library will display cover art, artists in your library,
-  and list of songs. The Podcast Library will display your Podcast
-  subscriptions, podcasts that are downloaded or not downloaded, and all, new
-  or old podcasts. Please see each Source's help page for detailed information
-  on managing a source.</p>
+  <p>The <gui>Libraries</gui> view in <app>Banshee</app> will change depending
+  on the Source you have chosen. For example, the <gui>Music</gui> library will
+  display cover art, artists in your library, and list of songs and the
+  <gui>Podcasts</gui> library will display your Podcast subscriptions, Podcasts
+  that are downloaded or not downloaded, and all, new or old Podcasts. Please
+  see the help page of each source for detailed information on managing a
+  source.</p>
 
   </section>
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]