From 85eec85a172b4580b653446b221a1704fc9212a1 Mon Sep 17 00:00:00 2001 From: Marc Guay Date: Tue, 24 Jun 2008 05:16:23 +0000 Subject: Commit part of Eddy's changes to the Advanced Topics section of the manual. git-svn-id: svn://svn.rockbox.org/rockbox/trunk@17775 a1c6a512-1295-4272-9138-f99709370657 --- manual/advanced_topics/main.tex | 33 ++++++++++++++++++++------------- 1 file changed, 20 insertions(+), 13 deletions(-) (limited to 'manual') diff --git a/manual/advanced_topics/main.tex b/manual/advanced_topics/main.tex index d66bdf5a0a..57dc6d6762 100644 --- a/manual/advanced_topics/main.tex +++ b/manual/advanced_topics/main.tex @@ -1,7 +1,7 @@ % $Id$ % \chapter{Advanced Topics} -\section{\label{ref:CustomisingUI}Customising the userinterface} +\section{\label{ref:CustomisingUI}Customising the User Interface} \subsection{\label{ref:GettingExtras}Getting Extras} \opt{lcd_bitmap}{ Rockbox supports custom fonts. A collection of fonts is available for download @@ -45,6 +45,10 @@ file find the instructions on the Rockbox website: and select \setting{Background Colour} or \setting{Foreground Colour}. 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. } \nopt{archos,mrobe100}{% @@ -142,7 +146,7 @@ The WPS parser will always display the last part if the tag has no value, or if the list of alternatives is too short. \end{description} -\subsubsection{Next Song info} +\subsubsection{Next Song Info} You can display information about the next song -- the song that is about to play after the one currently playing (unless you change the plan). @@ -157,7 +161,7 @@ name used in the next song and \config{\%Ff} is the mp3 frequency. suggest you use the conditional display tag a lot when displaying information about the next song!} -\subsubsection{Alternating sublines} +\subsubsection{Alternating Sublines} It is possible to group items on each line into 2 or more groups or ``sublines''. Each subline will be displayed in succession on the line for a @@ -268,9 +272,9 @@ title [artist]''. % % \end{verbatim} %} -\section{\label{ref:manage_settings}Managing Rockbox settings} +\section{\label{ref:manage_settings}Managing Rockbox Settings} -\subsection{Introduction to \fname{.cfg} files.} +\subsection{Introduction to \fname{.cfg} Files.} Rockbox allows users to store and load multiple settings through the use of configuration files. A configuration file is simply a text file with the extension \fname{.cfg}. @@ -286,7 +290,7 @@ for configuration files. See \reference{ref:manage_settings_menu} for an explanation of how to create, edit and load configuration files. \subsection{\label{ref:cfg_specs}Specifications for \fname{.cfg} - files.} + Files.} The Rockbox configuration file is a plain text file, so once you use the \setting{Save .cfg file} option to create the file, you can edit the file on @@ -328,6 +332,9 @@ 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}. \subsection{\label{ref:manage_settings_menu}The \setting{Manage Settings} menu} The \setting{Manage Settings} menu can be found in the \setting{Main @@ -337,7 +344,7 @@ Example of a configuration file: \begin{description} -\item [Browse .cfg Files.]Opens the file browser in the \fname{/.rockbox} +\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} @@ -345,7 +352,7 @@ Example of a configuration file: \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 +\item [Reset Settings]This wipes the saved settings 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}{ @@ -362,22 +369,22 @@ Example of a configuration file: \ButtonA\ button immediately after the \dap\ turns on.} } -\item [Save .cfg file.]This option writes a \fname{.cfg} file to +\item [Save .cfg File]This option writes a \fname{.cfg} file to 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 + Hint: Use the \setting{Save .cfg File} feature (\setting{Main Menu $\rightarrow$ General 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 +\item [Save Sound Settings]This option writes a \fname{.cfg} file to 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 +\item [Save Theme Settings]This option writes a \fname{.cfg} file to your \daps\ disk. The configuration file has the \fname{.cfg} extension and is used to store all of the theme related settings. @@ -394,7 +401,7 @@ Example of a configuration file: you intended. } -\subsection{\label{ref:using_rolo}Using ROLO (Rockbox loader)} +\subsection{\label{ref:using_rolo}Using ROLO (Rockbox Loader)} Rockbox is able to load and start another firmware file without rebooting. You just ``play'' a file with the extension % \opt{recorder,recorderv2fm,ondio}{\fname{.ajz}.} % -- cgit v1.2.3