Update the manual for the new file extension setting
[Rockbox.git] / manual / configure_rockbox / file_view.tex
blob3d5b0221810c4dbead8de2cd0522b8e08f93c1e9
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 folders. The default is to sort
14 them alphabetically. \setting{By date} sorts them with the oldest folder first.
15 \setting{By newest date} sorts them with the newest folder 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[\label{ref:ShowFiles}Show Files:]
24 This option controls which files are displayed in the File Browser.
26 \begin{description}
27 \item[All:] The \setting{File Browser} displays all files and directories.
28 Extensions are shown. No files or directories are hidden.
29 \item[Supported:] The \setting{File Browser} displays all directories and
30 files supported by Rockbox (see \reference{ref:Supportedfileformats}).
31 Files and directories starting with \fname{.} (\emph{dot}) or with the
32 \emph{hidden} flag set are hidden.
33 \item[Music:] The \setting{File Browser} displays only folders, playlists and
34 the supported \emph{audio} file formats. Extensions are stripped. Files and
35 directories starting with \fname{.} or with the ``hidden'' flag set are
36 hidden.
37 \item[Playlists:] The \setting{File Browser} displays only directories and playlists,
38 for simplified navigation.
39 \end{description}
41 \item[\label{ref:ShowExtensions}Show Filename Extensions:]
42 This option controls how file extensions are shown in the File Browser.
44 \begin{description}
45 \item[Off:] The file extensions are never shown.
46 \item[On:] The file extensions are always shown.
47 \item[Only Unknown:] Only the extensions of unknown filetypes are shown.
48 \end{description}
50 \item[Follow Playlist:]
51 This option determines what directory the \setting{File Browser} displays
52 first. If \setting{Follow Playlist} is set to \setting{Yes}, when you enter
53 the \setting{File Browser} from the WPS, you will find yourself in the same
54 directory as the currently playing file. If \setting{Follow Playlist} is set
55 to \setting{No}, when you enter the \setting{File Browser} from the WPS, you
56 will find yourself in the directory you were in when you last left the
57 \setting{File Browser}.
59 \item[Show Icons:]
60 Rockbox has the ability to display an icon to the left of the file
61 in the \setting{File Browser}. For details of these icons, please see
62 \reference{ref:Supportedfileformats}.
64 \item[Show Path:]
65 If this setting is set to \setting{Full Path} the full path to the current
66 directory will be displayed on the first line in the \setting{File Browser}.
67 If set to \setting{Current Directory Only} only the name of the current
68 directory will be displayed.
70 \end{description}