[gnome-user-docs] New music player topics

[Phil Bull <philbull src gnome org>]

commit a7ff2260e18b0751cfe0a3331d64ee0796f55994
Author: Phil Bull <philbull gmail com>
Date:   Tue Mar 22 13:13:14 2011 -0400

    New music player topics

 gnome-help/C/music-cantplay-drm.page         |   27 ++++++++++++++++++++
 gnome-help/C/music-player-ipodtransfer.page  |   19 ++++++++++++++
 gnome-help/C/music-player-newipod.page       |   25 +++++++++++++++++++
 gnome-help/C/music-player-notrecognized.page |   34 ++++++++++++++++++++++++++
 4 files changed, 105 insertions(+), 0 deletions(-)
---
diff --git a/gnome-help/C/music-cantplay-drm.page b/gnome-help/C/music-cantplay-drm.page
new file mode 100644
index 0000000..cabcbc8
--- /dev/null
+++ b/gnome-help/C/music-cantplay-drm.page
@@ -0,0 +1,27 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="music-cantplay-drm">
+  <info>
+    <link type="guide" xref="media#sound" />
+    
+    <revision pkgversion="3.0" date="2011-03-22" status="review"/>
+ 
+    <credit type="author">
+      <name>GNOME Documentation Team</name>
+      <email>gnome-doc-list gnome org</email>
+    </credit>
+
+    <desc>Support for that file format might not be installed or the songs could be "copy protected".</desc>
+  </info>
+
+<title>I can't play the songs I bought from an online music store</title>
+
+<p>If you downloaded some music from an online store you may find that it won't play on your computer, especially if you bought it on a Windows or Mac OS computer and then copied it over.</p>
+
+<p>This could be because the music is in a format that is not recognized by your computer. To be able to play a song you need to have support for the right audio formats installed - for example, if you want to play MP3 files, you need MP3 support installed. If you don't have support for a given audio format, you should see a message telling you so when you try to play a song. The message should also provide instructions for how to install support for that format so that you can play it.</p>
+
+<p>If you do have support installed for the song's audio format but still can't play it, the song might be <em>copy protected</em> (also known as being <em>DRM restricted</em>). DRM is a way of restricting who can play a song and on what devices they can play it. The company that sold the song to you is in control of this, not you. If a music file has DRM restrictions, you will probably not be able to play it - you generally need special software from the vendor to play DRM restricted files, but few of these are supported on Linux.</p>
+
+<p>You can learn more about DRM from the <link href="http://www.eff.org/issues/drm";>Electronic Frontier Foundation</link>.</p>
+
+</page>
diff --git a/gnome-help/C/music-player-ipodtransfer.page b/gnome-help/C/music-player-ipodtransfer.page
new file mode 100644
index 0000000..b7d135e
--- /dev/null
+++ b/gnome-help/C/music-player-ipodtransfer.page
@@ -0,0 +1,19 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="music-player-ipodtransfer">
+  <info>
+    <link type="guide" xref="media#sound" />
+    
+    <revision pkgversion="3.0" date="2011-03-22" status="stub"/>
+ 
+    <credit type="author">
+      <name>GNOME Documentation Team</name>
+      <email>gnome-doc-list gnome org</email>
+    </credit>
+
+    <desc></desc>
+  </info>
+
+<title>Songs don't appear on my iPod when I copy them onto it!</title>
+
+</page>
diff --git a/gnome-help/C/music-player-newipod.page b/gnome-help/C/music-player-newipod.page
new file mode 100644
index 0000000..64b5f1a
--- /dev/null
+++ b/gnome-help/C/music-player-newipod.page
@@ -0,0 +1,25 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="music-player-newipod">
+  <info>
+    <link type="guide" xref="media#sound" />
+    
+    <revision pkgversion="3.0" date="2011-03-22" status="review"/>
+ 
+    <credit type="author">
+      <name>GNOME Documentation Team</name>
+      <email>gnome-doc-list gnome org</email>
+    </credit>
+
+    <desc>Brand-new iPods need to be set-up using the iTunes software before you can use them.</desc>
+  </info>
+
+<title>My new iPod won't work</title>
+
+<p>If you have a new iPod that has never been connected to a computer before, it won't be recognized properly when you connect it to a Linux computer. This is because iPods need to be set-up and updated using the <app>iTunes</app> software, which only runs on Windows and Mac OS.</p>
+
+<p>To set-up your iPod, install iTunes on a Windows or Mac computer and plug it in. You will be led through a few steps to set it up. When asked for the <gui>Volume Format</gui>, choose <gui>MS-DOS (FAT)</gui>, <gui>Windows</gui> or similar. The other format does not work as well with Linux.</p>
+
+<p>Once you have finished set-up, the iPod should work normally when you plug it into a Linux computer.</p>
+
+</page>
diff --git a/gnome-help/C/music-player-notrecognized.page b/gnome-help/C/music-player-notrecognized.page
new file mode 100644
index 0000000..a489eb5
--- /dev/null
+++ b/gnome-help/C/music-player-notrecognized.page
@@ -0,0 +1,34 @@
+<page xmlns="http://projectmallard.org/1.0/";
+      type="topic"
+      id="music-player-notrecognized">
+  <info>
+    <link type="guide" xref="media#sound" />
+    <link type="seealso" xref="music-player-newipod" />
+    
+    <revision pkgversion="3.0" date="2011-03-22" status="review"/>
+ 
+    <credit type="author">
+      <name>GNOME Documentation Team</name>
+      <email>gnome-doc-list gnome org</email>
+    </credit>
+
+    <desc>Add a <input>.is_audio_player</input> file to tell your computer that it's an audio player.</desc>
+  </info>
+
+<title>Why isn't my audio player recognized when I plug it in?</title>
+
+<p>If your audio player (MP3 player etc.) is plugged in to the computer but you can't see it in your music organizer application, it may not have been properly recognized as an audio player.</p>
+
+<p>Try unplugging the player and then plugging it in again. If that doesn't help, open the File Manager. You should see the player listed under <gui>Devices</gui> in the sidebar - click it to open the folder for the audio player. Now, click <guiseq><gui>File</gui><gui>New Document</gui><gui>Empty Document</gui></guiseq>, type <input>.is_audio_player</input> and press <key>Enter</key> (the period and underscores are important, and it should be all lower-case). This file tells your computer to recognize the device as an audio player.</p>
+
+<p>Now, find the audio player in the File Manager sidebar and eject it (right-click and click <gui>Eject</gui>). Unplug it, then plug it back in. This time it should have been recognized as an audio player by your music organizer. If not, try closing the music organizer and then re-opening it.</p>
+
+<note>
+ <p>These instructions won't work for iPods and some other audio players. They should work if your player is a <em>USB Mass Storage</em> device, though; it should say in its manual if it is.</p>
+</note>
+
+<note>
+ <p>When you look in the audio player folder again, you won't see the <input>.is_audio_player</input> file. This is because the period in the file's name tells the File Manager to hide the file. You can check that it is still there by clicking <guiseq><gui>View</gui><gui>Show Hidden Files</gui>.</p>
+</note>
+
+</page>