summaryrefslogtreecommitdiff
path: root/manual/advanced_topics/main.tex
diff options
context:
space:
mode:
authorNils Wallménius <nils@rockbox.org>2009-02-04 14:22:35 +0000
committerNils Wallménius <nils@rockbox.org>2009-02-04 14:22:35 +0000
commit01bd736e000856ded49023ccdd4ed62b96f300ff (patch)
treeaaabadc803a69be6b6578f87f6a4136f03a6e245 /manual/advanced_topics/main.tex
parent3f879eb6aeaed5dfec24f2b0cc022518be7f7739 (diff)
Fixes and tweaks for the 'Advanced topics' chapter of the manual, closes FS#9806
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@19919 a1c6a512-1295-4272-9138-f99709370657
Diffstat (limited to 'manual/advanced_topics/main.tex')
-rw-r--r--manual/advanced_topics/main.tex89
1 files changed, 46 insertions, 43 deletions
diff --git a/manual/advanced_topics/main.tex b/manual/advanced_topics/main.tex
index a567e82926..4cea04eb46 100644
--- a/manual/advanced_topics/main.tex
+++ b/manual/advanced_topics/main.tex
@@ -15,9 +15,9 @@ in the font package at \url{http://www.rockbox.org/daily.shtml}.}
be loaded automatically every time you start up, it must be located in the
\fname{/.rockbox/fonts} directory and the filename must be at most 24 characters
long. You can browse the fonts in \fname{/.rockbox/fonts} under
- \setting{Settings $\rightarrow$ General Settings $\rightarrow$ Display
- $\rightarrow$ Browse Fonts} in the \setting{Main Menu}.
- \warn{Advanced Users Only: Any BDF font file up to 16 pixels high should
+ \setting{Settings $\rightarrow$ Theme Settings $\rightarrow$ Browse Fonts}
+ in the \setting{Main Menu}.
+ \note{Advanced Users Only: Any BDF font file up to 16 pixels high should
be usable with Rockbox. To convert from \fname{.bdf} to \fname{.fnt}, use
the \fname{convbdf} tool. This tool can be found in the \fname{tools}
directory of the Rockbox source code.}
@@ -28,7 +28,7 @@ in the font package at \url{http://www.rockbox.org/daily.shtml}.}
Rockbox can load language files at runtime. Simply copy the \fname{.lng} file
\emph{(do not use the .lang file)} to the \dap\ and ``play'' it in the
Rockbox directory browser or select \setting{Settings $\rightarrow$
-General Settings $\rightarrow$ Languages }from the \setting{Main Menu}.
+General Settings $\rightarrow$ Language }from the \setting{Main Menu}.
\note{If you want a language to be loaded automatically every time you start
up, it must be located in the \fname{/.rockbox/langs} directory and the filename
@@ -41,15 +41,15 @@ file find the instructions on the Rockbox website:
\opt{lcd_color}{
\subsection{Changing Colours}
The colours used in the Rockbox interface can be changed to any combination
- of background and foreground colour you like. To do this go to the
- \setting{Settings $\rightarrow$ General Settings $\rightarrow$ Display}
- and select \setting{Background Colour} or \setting{Foreground Colour}.
+ you like. To do this, go to
+ \setting{Settings $\rightarrow$ Theme Settings $\rightarrow$ Colours}.
The colours set here are used in all menus, browsers and in the
\setting{While Playing Screen}.
\subsection{Changing Filetype Colours}
- Rockbox has the capability to modify the File Browser to show different
- filetypes in different colours depending upon the file extension.
- See the \wikilink{CustomFiletypeColours} Wiki page for details.
+ Rockbox has the capability to modify the \setting{File Browser}
+ to show different filetypes in different colours depending upon
+ the file extension. See the \wikilink{CustomFiletypeColours} Wiki
+ page for details.
}
\opt{lcd_non-mono}{%
@@ -70,19 +70,18 @@ file find the instructions on the Rockbox website:
\subsection{WPS -- General Info}
\begin{description}
-\item[Description: ] The WPS or While Playing Screen is the name used to
- describe the information displayed on the \daps\ screen whilst an audio track
- is being played. The default WPS is a relatively simple screen displaying
- Track name, Artist, Album etc. in the default font as a purely text based
- layout. There are a number of WPS files included in Rockbox, and you can
- load one of these at anytime by selecting it in
- \setting{General Settings $\rightarrow$ Display $\rightarrow$ Browse .wps files}.
+\item[Description: ] The WPS or \setting{While Playing Screen} is the name used
+ to describe the information displayed on the \daps{} screen whilst an audio
+ track is being played. The default WPS is a relatively simple screen
+ displaying Track name, Artist, Album etc. in the default font as a purely
+ text based layout. There are a number of WPS files included in Rockbox, and
+ you can load one of these at any time by selecting it in
+ \setting{Settings $\rightarrow$ Theme Settings $\rightarrow$ Browse .wps files}.
\opt{HAVE_REMOTE_LCD}{There is a related option to browse \fname{.rwps}
files for \daps{} with LCD remote controls installed. This will load a
- similar WPS screen for the remote but with usually a simpler and more
- concise layout.}
+ similar WPS screen for the remote.}
-\note{``Playing'' a \fname{.wps} from the file browser has the same effect.}
+\note{``Playing'' a \fname{.wps} from the \setting{File Browser} has the same effect.}
\item [File Location: ]Custom WPS files may be located anywhere on the drive.
The only restriction is that they must end in \fname{.wps}. When you ``play''
@@ -116,7 +115,7 @@ all the tags that are available.
the last number giving the colour depth in bits) when
designing your own WPS, or if you use a WPS designed for another target.
\opt{HAVE_REMOTE_LCD}{The resolution of the remote is
- \opt{h100,h300}{128x64x1}\opt{x5}{128x96x2} pixels.}}
+ \opt{h100,h300}{128x64x1}\opt{x5,m5}{128x96x2} pixels.}}
\subsubsection{Conditional Tags}
@@ -284,7 +283,7 @@ A configuration file may reside anywhere on the disk. Multiple
configuration files are permitted. So, for example, you could have
a \fname{car.cfg} file for the settings that you use while playing your
jukebox in your car, and a \fname{headphones.cfg} file to store the
-settings that you use while listening to your \dap\ through headphones.
+settings that you use while listening to your \dap{} through headphones.
See \reference{ref:cfg_specs} below for an explanation of the format
for configuration files. See \reference{ref:manage_settings_menu} for an
@@ -333,64 +332,68 @@ Example of a configuration file:
each file a different name (such as \fname{car.cfg},
\fname{headphones.cfg}, etc.), and you can then use the \setting{Browse .cfg
files} option to quickly change settings.}
-
- A special case configuration file can be used to force a particular setting or settings every time Rockbox starts up (e.g. to set the volume to a safe level).
-Format a new configuration file as above with the required setting(s) and save it into the \fname{/.rockbox} directory with the filename \fname{fixed.cfg}.
+
+ A special case configuration file can be used to force a particular setting
+ or settings every time Rockbox starts up (e.g. to set the volume to a safe
+ level). Format a new configuration file as above with the required setting(s)
+ and save it into the \fname{/.rockbox} directory with the filename
+ \fname{fixed.cfg}.
\subsection{\label{ref:manage_settings_menu}The \setting{Manage Settings}
menu} The \setting{Manage Settings} menu can be found in the \setting{Main
Menu}. The \setting{Manage Settings} menu allows you to save and load
-\fname{.cfg} files. \opt{MASCODEC}{The \setting{Manage Settings} menu also
- allows you to load or save different firmware versions.}
+ \fname{.cfg} files.
+ \opt{MASCODEC}{The \setting{Manage Settings} menu also
+ allows you to load or save different firmware versions.}
\begin{description}
-\item [Browse .cfg Files]Opens the file browser in the \fname{/.rockbox}
- directory and displays all \fname{.cfg} (configuration) files. Selecting a
- \fname{.cfg} file will cause Rockbox to load the settings contained in that
- file. Pressing \ButtonLeft\ will exit back to the \setting{Manage Settings}
- menu. See the \setting{Write .cfg files} option on the
- \setting{Manage Settings} menu for details of how to save and edit a
+\item [Browse .cfg Files]Opens the \setting{File Browser} in the
+ \fname{/.rockbox} directory and displays all \fname{.cfg} (configuration)
+ files. Selecting a \fname{.cfg} file will cause Rockbox to load the settings
+ contained in that file. Pressing \ButtonLeft{} will exit back to the
+ \setting{Manage Settings} menu. See the \setting{Write .cfg files} option on
+ the \setting{Manage Settings} menu for details of how to save and edit a
configuration file.
\item [Reset Settings]This wipes the saved settings
- in the \dap\ and resets all settings to their default values.
+ in the \dap{} and resets all settings to their default values.
\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{
\note{You can also reset all settings to their default
values by turning off the \dap, turning it back on, and holding the
- \ButtonRec\ button immediately after the \dap\ turns on.}
+ \ButtonRec{} button immediately after the \dap{} turns on.}
}
\opt{IRIVER_H10_PAD}{\note{You can also reset all settings to
their default values by turning off the \dap, and turning it back on
- with the \ButtonHold\ button on.}
+ with the \ButtonHold{} button on.}
}
\opt{IPOD_4G_PAD}{\note{You can also reset all settings to their default
values by turning off the \dap, turning it back on, and activating the
- \ButtonHold\ button immediately after the backlight comes on.}
+ \ButtonHold{} button immediately after the backlight comes on.}
}
\opt{GIGABEAT_PAD}{\note{You can also reset all settings to their default
values by turning off the \dap, turning it back on and pressing the
- \ButtonA\ button immediately after the \dap\ turns on.}
+ \ButtonA{} button immediately after the \dap{} turns on.}
}
\item [Save .cfg File]This option writes a \fname{.cfg} file to
- your \daps{} disk. The configuration file has the \fname{.cfg}
+ your \daps{} disk. The configuration file has the \fname{.cfg}
extension and is used to store all of the user settings that are described
throughout this manual.
-
+
Hint: Use the \setting{Save .cfg File} feature (\setting{Main Menu
- $\rightarrow$ General Settings}) to save the current settings, then
+ $\rightarrow$ Manage Settings}) to save the current settings, then
use a text editor to customize the settings file. See Appendix
\reference{ref:config_file_options} for the full reference of available
options.
\item [Save Sound Settings]This option writes a \fname{.cfg} file to
- your \daps\ disk. The configuration file has the \fname{.cfg}
+ your \daps{} disk. The configuration file has the \fname{.cfg}
extension and is used to store all of the sound related settings.
\item [Save Theme Settings]This option writes a \fname{.cfg} file to
- your \daps\ disk. The configuration file has the \fname{.cfg}
+ your \daps{} disk. The configuration file has the \fname{.cfg}
extension and is used to store all of the theme related settings.
\end{description}