summaryrefslogtreecommitdiffstats
path: root/manual
diff options
context:
space:
mode:
authorMarianne Arnold <pixelma@rockbox.org>2008-12-19 00:08:42 +0000
committerMarianne Arnold <pixelma@rockbox.org>2008-12-19 00:08:42 +0000
commit7b00970c031a23621a7f57a6d38eb15f98c15a3c (patch)
tree0589436d9fa0c441ae35dd7f93e813024bb06f29 /manual
parent3e1168fa8aeb83790df7bf7fee0f05926e33a9d5 (diff)
downloadrockbox-7b00970c031a23621a7f57a6d38eb15f98c15a3c.tar.gz
rockbox-7b00970c031a23621a7f57a6d38eb15f98c15a3c.zip
Manual: give more info about file structure in the 'Putting music on your player' paragraph and only mention album art for targets with it (fixes FS#9134, phrasing by Paul Louden). While at it, opt the reference to the 'supported audio formats' table for swcodec since the table itself exists only in swcodec player manuals.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@19476 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'manual')
-rw-r--r--manual/rockbox_interface/main.tex24
1 files changed, 22 insertions, 2 deletions
diff --git a/manual/rockbox_interface/main.tex b/manual/rockbox_interface/main.tex
index a0ad76cf54..e12bdb6871 100644
--- a/manual/rockbox_interface/main.tex
+++ b/manual/rockbox_interface/main.tex
@@ -502,8 +502,28 @@ With the \dap{} connected to the computer as an MSC/UMS device (like a
USB Drive), music files can be put on the player via any standard file
transfer method that you would use to copy files between drives (e.g. Drag 'n' Drop).
The default directory structure that is assumed by some parts of Rockbox
-(album art searching, WPS missing-tag fallback) is: /ArtistName/AlbumName/*.ext.
-See \reference{ref:Supportedaudioformats} for a list of supported audio formats.
+\opt{albumart}{%
+ (album art searching, and missing-tag fallback in some WPSes) uses the
+ parent directory of a song as the Album name, and the parent directory of
+ that folder as the Artist name. While files may be organized however you
+ like, the \wikilink{AlbumArt} wiki page explains the requirement for Album
+ Art to work properly, and WPSes may display information incorrectly if your
+ files are not properly tagged, and you have your music organized in a way
+ different than they assume when attempting to guess the Artist and Album
+ names from your filetree.
+}%
+\nopt{albumart}{%
+ (missing-tag fallback in some WPSes) uses the parent directory of a song
+ as the Album name, and the parent directory of that folder as the Artist
+ name. While files may be organized however you like, WPSes may display
+ information incorrectly if your files are not properly tagged, and you have
+ your music organized in a way different than they assume when attempting to
+ guess the Artist and Album names from your filetree.
+}
+\opt{swcodec}{
+ See \reference{ref:Supportedaudioformats} for a list of supported audio
+ formats.
+}
\subsection{The first contact}