Add coloured rows to the other tables in the manual (button maps already done).
[kugel-rb.git] / manual / configure_rockbox / file_view.tex
blobe1349343e322187e5564a1ad54de00ef636d8335
1 % $Id$ %
2 \section{File View}
3 The File View menu deals with options relating to how the File Browser
4 displays files.
6 \begin{description}
7 \item[Sort Case Sensitive:]
8 If this option is set to \setting{Yes}, all files that start with upper case
9 letters will be listed first, followed by all files that begin with lower
10 case letters. If this option is set to NO, then case will be ignored when
11 sorting files.
12 \item[Sort Directories:]
13 This option controls how Rockbox sorts directories. The default is to sort
14 them alphabetically. \setting{By date} sorts them with the oldest directory first.
15 \setting{By newest date} sorts them with the newest directory first.
17 \item[Sort Files:]
18 This option controls how Rockbox sorts files. All of the options for
19 \setting{Sort Directories} are available in this option. In addition, there
20 is a \setting{By type} option which sorts files alphabetically by their type
21 (such as \fname{.mp3}) then alphabetically within each type.
23 \item[Interpret numbers when sorting:]
24 \setting{As whole numbers} enables a sorting algorithm which is similar to
25 the default sorting of, for example, Windows Explorer, Mac OS X's Finder
26 or Nautilus, with regards to numbers at the beginning or within filenames.
27 It combines consecutive digits to a number used for sorting, taking leading
28 zeros into account.
29 \newline\setting{As digits} disables this algorithm, and causes every digit to
30 be compared separately. The following table demonstrates the two sortings.
31 \begin{table}
32 \begin{center}
33 \rowcolors{1}{}{gray!30}
34 \begin{tabularx}{.8\textwidth}{XX}
35 \toprule
36 \textbf{As whole numbers} & \textbf{As digits}\\
37 \midrule
38 03 Jackson.mp3 & 03 Jackson.mp3\\
39 1 Ring Of Fire.mp3 & 1 Ring Of Fire.mp3\\
40 2 I Walk The Line.mp3 & 10 A Thing Called Love.mp3\\
41 10 A Thing Called Love.mp3 & 2 I Walk The Line.mp3\\
42 Episode 1.ogg & Episode 1.ogg\\
43 Episode 57.ogg & Episode 233.ogg\\
44 Episode 233.ogg & Episode 57.ogg\\
45 \bottomrule
46 \end{tabularx}
47 \end{center}
48 \end{table}
51 \item[\label{ref:ShowFiles}Show Files:]
52 This option controls which files are displayed in the File Browser.
54 \begin{description}
55 \item[All:] The \setting{File Browser} displays all files and directories.
56 Extensions are shown. No files or directories are hidden.
57 \item[Supported:] The \setting{File Browser} displays all directories and
58 files supported by Rockbox (see \reference{ref:Supportedfileformats}).
59 Files and directories starting with \fname{.} (\emph{dot}) or with the
60 \emph{hidden} flag set are hidden.
61 \item[Music:] The \setting{File Browser} displays only directories, playlists and
62 the supported \emph{audio} file formats. Extensions are stripped. Files and
63 directories starting with \fname{.} or with the ``hidden'' flag set are
64 hidden.
65 \item[Playlists:] The \setting{File Browser} displays only directories and playlists,
66 for simplified navigation.
67 \end{description}
69 \item[\label{ref:ShowExtensions}Show Filename Extensions:]
70 This option controls how file extensions are shown in the File Browser.
72 \begin{description}
73 \item[Off:] The file extensions are never shown.
74 \item[On:] The file extensions are always shown.
75 \item[Only unknown types:] Only the extensions of unknown filetypes are shown.
76 \item[Only when viewing all types:] Only show file extensions when
77 \setting{Show Files} is set to \setting{All}.
78 \end{description}
80 \item[Follow Playlist:]
81 This option determines what directory the \setting{File Browser} displays
82 first. If \setting{Follow Playlist} is set to \setting{Yes}, when you enter
83 the \setting{File Browser} from the WPS, you will find yourself in the same
84 directory as the currently playing file. If \setting{Follow Playlist} is set
85 to \setting{No}, when you enter the \setting{File Browser} from the WPS, you
86 will find yourself in the directory you were in when you last left the
87 \setting{File Browser}.
89 \item[Show Path:]
90 If this setting is set to \setting{Full Path} the full path to the current
91 directory will be displayed on the first line in the \setting{File Browser}.
92 If set to \setting{Current Directory Only} only the name of the current
93 directory will be displayed.
95 This has a similar effect on the Database browser. If set to
96 \setting{Current Directory Only} or \setting{Full Path}, then the title of
97 each menu will be displayed on the first line in the \setting{Database Browser}.
99 \end{description}