Move thread-sdl.[ch] into the target tree.
[kugel-rb.git] / manual / configure_rockbox / file_view.tex
blobb4f8da7b79981afad1bf144be9990765e1c74cdd
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{rbtabular}{.8\textwidth}{XX}%
33 {\textbf{As whole numbers} & \textbf{As digits}}{}{}
34 03 Jackson.mp3 & 03 Jackson.mp3\\
35 1 Ring Of Fire.mp3 & 1 Ring Of Fire.mp3\\
36 2 I Walk The Line.mp3 & 10 A Thing Called Love.mp3\\
37 10 A Thing Called Love.mp3 & 2 I Walk The Line.mp3\\
38 Episode 1.ogg & Episode 1.ogg\\
39 Episode 57.ogg & Episode 233.ogg\\
40 Episode 233.ogg & Episode 57.ogg\\
41 \end{rbtabular}
42 \end{table}
45 \item[\label{ref:ShowFiles}Show Files.]
46 This option controls which files are displayed in the File Browser.
48 \begin{description}
49 \item[All.] The \setting{File Browser} displays all files and directories.
50 Extensions are shown. No files or directories are hidden.
51 \item[Supported.] The \setting{File Browser} displays all directories and
52 files supported by Rockbox (see \reference{ref:Supportedfileformats}).
53 Files and directories starting with \fname{.} (\emph{dot}) or with the
54 \emph{hidden} flag set are hidden.
55 \item[Music.] The \setting{File Browser} displays only directories, playlists and
56 the supported \emph{audio} file formats. Extensions are stripped. Files and
57 directories starting with \fname{.} or with the ``hidden'' flag set are
58 hidden.
59 \item[Playlists.] The \setting{File Browser} displays only directories and playlists,
60 for simplified navigation.
61 \end{description}
63 \item[\label{ref:ShowExtensions}Show Filename Extensions.]
64 This option controls how file extensions are shown in the File Browser.
66 \begin{description}
67 \item[Off.] The file extensions are never shown.
68 \item[On.] The file extensions are always shown.
69 \item[Only unknown types.] Only the extensions of unknown filetypes are shown.
70 \item[Only when viewing all types.] Only show file extensions when
71 \setting{Show Files} is set to \setting{All}.
72 \end{description}
74 \item[Follow Playlist.]
75 This option determines what directory the \setting{File Browser} displays
76 first. If \setting{Follow Playlist} is set to \setting{Yes}, when you enter
77 the \setting{File Browser} from the WPS, you will find yourself in the same
78 directory as the currently playing file. If \setting{Follow Playlist} is set
79 to \setting{No}, when you enter the \setting{File Browser} from the WPS, you
80 will find yourself in the directory you were in when you last left the
81 \setting{File Browser}.
83 \item[Show Path.]
84 If this setting is set to \setting{Full Path} the full path to the current
85 directory will be displayed on the first line in the \setting{File Browser}.
86 If set to \setting{Current Directory Only} only the name of the current
87 directory will be displayed.
89 This has a similar effect on the Database browser. If set to
90 \setting{Current Directory Only} or \setting{Full Path}, then the title of
91 each menu will be displayed on the first line in the \setting{Database Browser}.
93 \end{description}