devs/foxbox
1
0
Fork 0
forked from len0rd/rockbox
Code Pull requests Activity

Fix for more consistent and proper British English. (-ize/-ise etc)

Browse source 
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@11246 a1c6a512-1295-4272-9138-f99709370657
This commit is contained in:
Martin Arver 2006-10-17 12:18:51 +00:00
parent b530de0fd9
commit f8e2f3e08d
18 changed files with 114 additions and 114 deletions
Download patch file Download diff file Expand all files Collapse all files

30
manual/advanced_topics/archos-flashing.tex
View file

@ -20,13 +20,13 @@ Now, you can add Rockbox to the built-in software.
By reprogramming the firmware, we can boot much faster. \playerman\ has an By reprogramming the firmware, we can boot much faster. \playerman\ has an
unnecessary slow boot loader, versus the boot time for Rockbox is much faster unnecessary slow boot loader, versus the boot time for Rockbox is much faster
than the disk spinup, in fact it has to wait for the disk. Your boot time will than the disk spin-up, in fact it has to wait for the disk. Your boot time will
be as quick as a disk spinup (e.g. 4 seconds from powerup until resuming be as quick as a disk spin-up (e.g. 4 seconds from power-up until resuming
playback). playback).
\subsection{Method} \subsection{Method}
The replaced firmware will host a bootloader and 2 images. This is possible by The replaced firmware will host a boot loader and 2 images. This is possible by
compression. The first is the \emph{permanent} backup, not to be changed any compression. The first is the \emph{permanent} backup, not to be changed any
more.The second is the default one to be started, the first is only used when more.The second is the default one to be started, the first is only used when
you hold the \opt{recorder,recorderv2fm}{\ButtonFOne}\opt{ondio}{\ButtonLeft}\opt{player}{\ButtonLeft} -key during start. Like supplied here, the first image you hold the \opt{recorder,recorderv2fm}{\ButtonFOne}\opt{ondio}{\ButtonLeft}\opt{player}{\ButtonLeft} -key during start. Like supplied here, the first image
@ -35,7 +35,7 @@ and update. It can contain anything you like. If you prefer, you can program
the Archos firmware to there, too. the Archos firmware to there, too.
\note{For now, the binary contained in the brand new player flash package does \note{For now, the binary contained in the brand new player flash package does
contain rockbox built from current cvs in the second image slot. This is to contain Rockbox built from current CVS in the second image slot. This is to
lower the risk of flashing (at least one of the images will hopefully work) in lower the risk of flashing (at least one of the images will hopefully work) in
case you don't program a second image yourself in the first step. Of course the case you don't program a second image yourself in the first step. Of course the
second image can be replaced like with the other models.} second image can be replaced like with the other models.}
@ -50,14 +50,14 @@ There are two programming tools supplied:
with the desired image structure. with the desired image structure.
\item The second one is called \fname{rockbox\_flash.rock} and is used to \item The second one is called \fname{rockbox\_flash.rock} and is used to
reprogram only the second image. It won't touch any other byte, should be reprogram only the second image. It won't touch any other byte, should be
safe to fool around with. If the programmed firmware is inoperational, you safe to fool around with. If the programmed firmware is in-operational, you
can still use the \opt{recorder,recorderv2fm}{\ButtonFOne}\opt{ondio}{\ButtonLeft}\opt{player}{\ButtonLeft} start with the Archos firmware and Rockbox booted can still use the \opt{recorder,recorderv2fm}{\ButtonFOne}\opt{ondio}{\ButtonLeft}\opt{player}{\ButtonLeft} start with the Archos firmware and Rockbox booted
from disk to try better. from disk to try better.
\end{itemize} \end{itemize}
The non-user tools are in the \fname{flash} subdirectory of the cvs source The non-user tools are in the \fname{flash} subdirectory of the CVS source
files. There's an authoring tool which composed the firmware file with the files. There's an authoring tool which composed the firmware file with the
bootloader and the 2 images. The bootloader project, a firmware extraction boot loader and the 2 images. The boot loader project, a firmware extraction
tool, the plugin sources, and the tools for the UART boot feature: a monitor tool, the plugin sources, and the tools for the UART boot feature: a monitor
program for the box and a PC tool to drive it. Feel free to review the sources program for the box and a PC tool to drive it. Feel free to review the sources
for all of it, but be careful when fooling around with powerful toys! for all of it, but be careful when fooling around with powerful toys!
@ -89,12 +89,12 @@ your box.
There's one ultimate safety net to bring back boxes with even completely There's one ultimate safety net to bring back boxes with even completely
garbled flash content: the \emph{UART} boot mod, which in turn requires the garbled flash content: the \emph{UART} boot mod, which in turn requires the
serial mod. It can bring the dead back to life, with that it's possible to serial mod. It can bring the dead back to life, with that it's possible to
reflash independently from the outside, even if the flash is completely erased. re-flash independently from the outside, even if the flash is completely erased.
It has been used that during development, else Rockbox in flash wouldn't have It has been used that during development, else Rockbox in flash wouldn't have
been possible. Extensive development effort went into the exploitation of the been possible. Extensive development effort went into the exploitation of the
UART boot mod. Mechanically adept users with good soldering skills can easily UART boot mod. Mechanically adept users with good soldering skills can easily
perform these mods. Others may feel uncomfortable using the first tool perform these mods. Others may feel uncomfortable using the first tool
(\fname{firmware\_flash.rock}) for reflashing the firmware. (\fname{firmware\_flash.rock}) for re-flashing the firmware.
To comfort you a bit again: If you are starting with a known-good image, you To comfort you a bit again: If you are starting with a known-good image, you
@ -105,7 +105,7 @@ Although it worked, it's not the recommended method.
About the safety of operation: Since we have dual boot, you're not giving up About the safety of operation: Since we have dual boot, you're not giving up
the Archos firmware. It's still there when you hold the Archos firmware. It's still there when you hold
\opt{recorder,recorderv2fm}{\ButtonFOne}\opt{ondio}{\ButtonLeft}\opt{player}{\ButtonLeft} during startup. So even if Rockbox from flash is not 100\% stable for \opt{recorder,recorderv2fm}{\ButtonFOne}\opt{ondio}{\ButtonLeft}\opt{player}{\ButtonLeft} during startup. So even if Rockbox from flash is not 100\% stable for
everyone, you can still use the box, reflash the second image with an updated everyone, you can still use the box, re-flash the second image with an updated
Rockbox copy, etc. Rockbox copy, etc.
The flash chip being used by Archos is specified for 100,000 cycles, so you don't need to worry about that wearing out. The flash chip being used by Archos is specified for 100,000 cycles, so you don't need to worry about that wearing out.
@ -138,7 +138,7 @@ Long version, step by step procedure:
you want to restore the flash contents. you want to restore the flash contents.
\item Download the correct package for you model. Copy one or two files of it to \item Download the correct package for you model. Copy one or two files of it to
your box: \fname{firmware\_*.bin} (name depends on your model) into the root your box: \fname{firmware\_*.bin} (name depends on your model) into the root
directory (the initial firmware for your model, with the bootloader and the directory (the initial firmware for your model, with the boot loader and the
Archos image). There now is also a \_norom variant, copy both, the plugin will Archos image). There now is also a \_norom variant, copy both, the plugin will
decide which one is required for your box. decide which one is required for your box.
\item Enter the debug menu and select the hardware info screen. Check your flash \item Enter the debug menu and select the hardware info screen. Check your flash
@ -187,7 +187,7 @@ Short version: very easy, just play an \fname{.ucl} file like
Long version: Long version:
The second image is the working copy, the \fname{rockbox\_flash.rock} plugin from The second image is the working copy, the \fname{rockbox\_flash.rock} plugin from
this package reprograms it. The plugins needs to be consistant with the Rockbox this package re-programs it. The plugins needs to be consistent with the Rockbox
plugin API version, otherwise it will detect mismatch and won't run. plugin API version, otherwise it will detect mismatch and won't run.
It requires an exotic input, a UCL-compressed image, because that's the internal It requires an exotic input, a UCL-compressed image, because that's the internal
@ -202,7 +202,7 @@ program from that download is called \fname{uclpack}. We'll use that to compress
\fname{rockbox.bin} which is the result of the compilation. This is a part of the \fname{rockbox.bin} which is the result of the compilation. This is a part of the
build process meanwhile. If you compile Rockbox yourself, you should copy build process meanwhile. If you compile Rockbox yourself, you should copy
\fname{uclpack} to a directory which is in the path, we recommend placing it in \fname{uclpack} to a directory which is in the path, we recommend placing it in
the same dir as SH compiler. the same directory as SH compiler.
Here are the steps: Here are the steps:
@ -230,7 +230,7 @@ and now preferred one. Use this if available.
If you like or have to, you can also flash the Archos image as the second one. If you like or have to, you can also flash the Archos image as the second one.
E.g. in case Rockbox from flash doesn't work for you. This way you keep the dual E.g. in case Rockbox from flash doesn't work for you. This way you keep the dual
bootloader and you can easily try different later. The \fname{.ucl} of the Archos boot loader and you can easily try different later. The \fname{.ucl} of the Archos
firmware is included in the package. firmware is included in the package.
\subsection{Restoring the original firmware} \subsection{Restoring the original firmware}
@ -253,7 +253,7 @@ There are two variants of how the boxes starts, therefore the normal and the
\_norom firmware files. The vast majority of the \daps\ all have the same boot \_norom firmware files. The vast majority of the \daps\ all have the same boot
ROM content, differentiation comes later by flash content. Rockbox identifies ROM content, differentiation comes later by flash content. Rockbox identifies
this boot ROM with a CRC value of 0x222F in the hardware info screen. \opt{recorder,recorderv2fm}{Some recorders have the boot ROM disabled (it might be unprogrammed) and start directly from a flash mirror at address zero. They need the new this boot ROM with a CRC value of 0x222F in the hardware info screen. \opt{recorder,recorderv2fm}{Some recorders have the boot ROM disabled (it might be unprogrammed) and start directly from a flash mirror at address zero. They need the new
\_norom firmware that has a slightly different bootloader.} \_norom firmware that has a slightly different boot loader.}
Without a boot ROM there is no UART boot safety net. To compensate for that as Without a boot ROM there is no UART boot safety net. To compensate for that as
much as possible the MiniMon monitor is included, it starts with \opt{recorder,recorderv2fm}{\ButtonFThree+\ButtonOn}\opt{ondio}{\ButtonRight+\ButtonOff}\opt{player}{\ButtonRight+\ButtonOn}. much as possible the MiniMon monitor is included, it starts with \opt{recorder,recorderv2fm}{\ButtonFThree+\ButtonOn}\opt{ondio}{\ButtonRight+\ButtonOff}\opt{player}{\ButtonRight+\ButtonOn}.
Using that the box can be reprogrammed via serial if the first 2000 bytes of the Using that the box can be reprogrammed via serial if the first 2000 bytes of the

2
manual/appendix/appendix.tex
View file

@ -97,7 +97,7 @@ The recording hardware (the MAS) does not allow us to do this
in the \dap{} is strictly made for disk{}-access and does not allow us in the \dap{} is strictly made for disk{}-access and does not allow us
to play with it the way we'd need for any good communication to work. to play with it the way we'd need for any good communication to work.
} }
\item Support other filesystems than FAT32 (like NTFS or ext2 or whatever)!\\ \item Support other file systems than FAT32 (like NTFS or ext2 or whatever)!\\
No. No.
\opt{archos}{Rockbox needs to support FAT32 since it can only start off a FAT32 \opt{archos}{Rockbox needs to support FAT32 since it can only start off a FAT32
partition (since that is the only way the ROM can load it), and adding}% partition (since that is the only way the ROM can load it), and adding}%

2
manual/configure_rockbox/bookmarking.tex
View file

@ -52,7 +52,7 @@
\item [Maintain a list of Recently Used Bookmarks. ] \item [Maintain a list of Recently Used Bookmarks. ]
This list of Most Recent Bookmarks (MRB's) may be accessed through the This list of Most Recent Bookmarks (MRB's) may be accessed through the
\setting{Recent Bookmarks} option of the \setting{Bookmarks} submenu of the \setting{Recent Bookmarks} option of the \setting{Bookmarks} sub menu of the
Main Menu. When set to \setting{Yes} each new bookmark will be added to the Main Menu. When set to \setting{Yes} each new bookmark will be added to the
MRB list. Setting this to \setting{No} disables the addition of bookmarks to MRB list. Setting this to \setting{No} disables the addition of bookmarks to
the MRB list. \setting{Unique Only} will remove an old bookmark for the current the MRB list. \setting{Unique Only} will remove an old bookmark for the current

4
manual/configure_rockbox/display_options.tex
View file

@ -28,7 +28,7 @@
} }
\item[LCD Settings:] \item[LCD Settings:]
This submenu contains settings that relate to the display of the \dap. This sub menu contains settings that relate to the display of the \dap.
\begin{description} \begin{description}
\nopt{ondiofm,ondiosp}{ \nopt{ondiofm,ondiosp}{
\item[Backlight:] \item[Backlight:]
@ -111,7 +111,7 @@
% %
\opt{h1xx,h300,x5}{ \opt{h1xx,h300,x5}{
\item[Remote-LCD Settings:] \item[Remote-LCD Settings:]
This submenu contains settings that relate to the display of the remote. This sub menu contains settings that relate to the display of the remote.
\begin{description} \begin{description}
\item[Backlight:] \item[Backlight:]
Similar to the main unit backlight this option controls the backlight Similar to the main unit backlight this option controls the backlight

2
manual/configure_rockbox/playback_options.tex
View file

@ -1,6 +1,6 @@
% $Id$ % % $Id$ %
\section{\label{ref:PlaybackOptions}Playback Options} \section{\label{ref:PlaybackOptions}Playback Options}
The \setting{Playback Options} submenu allows you to configure settings The \setting{Playback Options} sub menu allows you to configure settings
related to audio playback. related to audio playback.
\begin{description} \begin{description}
\item[Shuffle. ]Alters how Rockbox will select which song to play next.\\ \item[Shuffle. ]Alters how Rockbox will select which song to play next.\\

10
manual/configure_rockbox/sound_settings.tex
View file

@ -2,7 +2,7 @@
\screenshot{configure_rockbox/images/ss-sound-settings}{The sound settings screen}{} \screenshot{configure_rockbox/images/ss-sound-settings}{The sound settings screen}{}
The Sound Settings menu offers a selection of sound properties you may The Sound Settings menu offers a selection of sound properties you may
change to customize your listening experience. change to customise your listening experience.
\section{Volume} \section{Volume}
This setting adjusts the volume of your music. Like most professional This setting adjusts the volume of your music. Like most professional
@ -31,7 +31,7 @@ change to customize your listening experience.
frequencies below 300Hz. Bass boost can be set from 0 to 24 dB in frequencies below 300Hz. Bass boost can be set from 0 to 24 dB in
increments of 2 dB. A setting of 0 means that low frequencies are unaltered increments of 2 dB. A setting of 0 means that low frequencies are unaltered
(flat response).} (flat response).}
\opt{ipodnano,ipodcolor,ipodvideo}{This emphasizes or suppresses the \opt{ipodnano,ipodcolor,ipodvideo}{This emphasises or suppresses the
lower (bass) sounds in the track. 0dB means that bass in unaltered lower (bass) sounds in the track. 0dB means that bass in unaltered
(flat response). The minimum setting is -6dB and the maximum is 9dB.} (flat response). The minimum setting is -6dB and the maximum is 9dB.}
\opt{x5}{\fixme{add platform specific information here}} \opt{x5}{\fixme{add platform specific information here}}
@ -44,7 +44,7 @@ change to customize your listening experience.
frequencies above 1.5kHz. Treble boost can be set from 0 to 6 dB in frequencies above 1.5kHz. Treble boost can be set from 0 to 6 dB in
increments of 2 dB. A setting of 0 means that high frequencies are unaltered increments of 2 dB. A setting of 0 means that high frequencies are unaltered
(flat response).} (flat response).}
\opt{ipodnano,ipodcolor,ipodvideo}{This setting emphasizes or suppresses \opt{ipodnano,ipodcolor,ipodvideo}{This setting emphasises or suppresses
the higher (treble) sounds in the track. 0dB means that treble is unaltered the higher (treble) sounds in the track. 0dB means that treble is unaltered
(flat response). The minimum setting -6dB and the maximum is 9dB.} (flat response). The minimum setting -6dB and the maximum is 9dB.}
\opt{x5}{\fixme{add platform specific information here}} \opt{x5}{\fixme{add platform specific information here}}
@ -353,7 +353,7 @@ the parameters that can be adjusted using the graphical EQ. With the
\setting{Simple EQ}, the only parameter that can be adjusted is the gain. \setting{Simple EQ}, the only parameter that can be adjusted is the gain.
\item[Advanced EQ:] \item[Advanced EQ:]
This submenu provides options for adjusting the same parameters as the This sub menu provides options for adjusting the same parameters as the
\setting{Graphical EQ}. The only difference is that the parameters are \setting{Graphical EQ}. The only difference is that the parameters are
adjusted through textual menus rather than through a graphic interface. adjusted through textual menus rather than through a graphic interface.
@ -375,7 +375,7 @@ settings.
This function controls the EQ that is built into the hardware of your This function controls the EQ that is built into the hardware of your
\playerman{}. The hardware EQ functions similarly to the Graphical EQ in that \playerman{}. The hardware EQ functions similarly to the Graphical EQ in that
it allows adjustmnet of several parameters. However, unlike the Graphical EQ, it allows adjustment of several parameters. However, unlike the Graphical EQ,
the Hardware EQ allows the user to choose from a limited number of settings the Hardware EQ allows the user to choose from a limited number of settings
for ``Center Frequency'' and ``Bandwidth'' (``Bandwidth'' in the Hardware EQ for ``Center Frequency'' and ``Bandwidth'' (``Bandwidth'' in the Hardware EQ
is similar to ``Q'' in the Graphical EQ). is similar to ``Q'' in the Graphical EQ).

8
manual/configure_rockbox/system_options.tex
View file

@ -20,12 +20,12 @@
actual battery life. This setting only affects the accuracy of the actual battery life. This setting only affects the accuracy of the
battery life estimation as shown on screen. battery life estimation as shown on screen.
\opt{ipod}{This value is fairly meaningless in the iPod family at \opt{ipod}{This value is fairly meaningless in the \playerman{} family at
present, and work is on-going into finding a better way to determine present, and work is on-going into finding a better way to determine
battery life.} battery life.}
\opt{ondiosp,ondiofm}{ \opt{ondiosp,ondiofm}{
\item [Battery Type: ]This setting tells Rockbox wich type of battery \item [Battery Type: ]This setting tells Rockbox which type of battery
that is currently used in the \dap{}. Select \setting{Alkaline} or that is currently used in the \dap{}. Select \setting{Alkaline} or
\setting{NiMH} with \ButtonUp/\ButtonDown. \setting{NiMH} with \ButtonUp/\ButtonDown.
} }
@ -98,12 +98,12 @@ be set from \setting{Off} to 5 hours in 5 minute steps.
and \ButtonDown{} to adjust the HOURS. and \ButtonDown{} to adjust the HOURS.
\ButtonPlay{} confirms the alarm and shuts your \dap{} down, and \ButtonOff \ButtonPlay{} confirms the alarm and shuts your \dap{} down, and \ButtonOff
cancels setting an alarm. If the \dap{} is turned on again before the alarm cancels setting an alarm. If the \dap{} is turned on again before the alarm
occurs, the alarm will be canceled. Using this option disables the occurs, the alarm will be cancelled. Using this option disables the
\setting{Sleep Timer}(see above). \setting{Sleep Timer}(see above).
} }
\subsection{Limits} \subsection{Limits}
This submenu relates to limits in the Rockbox operating system. This sub menu relates to limits in the Rockbox operating system.
\begin{description} \begin{description}
\item [Max files in dir browser: ]This setting controls the limit on \item [Max files in dir browser: ]This setting controls the limit on
the number of files that you can put in any particular directory in the the number of files that you can put in any particular directory in the

6
manual/getting_started/h10_install.tex
View file

@ -4,7 +4,7 @@ The \playertype{} can be connected to a computer in two different modes:
\item Universal Mass Storage (UMS): In this mode, it will appear on your computer as a regular disk. This mode works with all major operating systems, including Windows, Linux and Mac OS X. \item Universal Mass Storage (UMS): In this mode, it will appear on your computer as a regular disk. This mode works with all major operating systems, including Windows, Linux and Mac OS X.
\item Media Transfer Protocol (MTP): In this mode, it will appear on your computer as a Media Device. MTP was created by Microsoft for use with DAPs and only works with Windows XP and Media Player 10. \item Media Transfer Protocol (MTP): In this mode, it will appear on your computer as a Media Device. MTP was created by Microsoft for use with DAPs and only works with Windows XP and Media Player 10.
\end{itemize} \end{itemize}
The \playerlongtype{} is \opt{h10}{only available as a MTP device, but}\opt{h10_5gb}{available as both a MTP and as a UMS device, depending on where and when you bought it. You can tell which you have by how it appears when you conect it to a computer. If it appears as a regular disk then it is UMS. If it appears as a Media Device on Windows XP, or if it doesn't appear at all on other operating systems, then it is MTP. Even if you have a MTP \dap{}, it} can be forced into UMS mode using the UMS trick. The \playerlongtype{} is \opt{h10}{only available as a MTP device, but}\opt{h10_5gb}{available as both a MTP and as a UMS device, depending on where and when you bought it. You can tell which you have by how it appears when you connect it to a computer. If it appears as a regular disk then it is UMS. If it appears as a Media Device on Windows XP, or if it doesn't appear at all on other operating systems, then it is MTP. Even if you have a MTP \dap{}, it} can be forced into UMS mode using the UMS trick.
\subsubsection{UMS mode and the UMS trick} \subsubsection{UMS mode and the UMS trick}
It is possible to force a MTP \playertype{} to start up in UMS mode using the following procedure: It is possible to force a MTP \playertype{} to start up in UMS mode using the following procedure:
@ -28,9 +28,9 @@ It is possible to force a MTP \playertype{} to start up in UMS mode using the fo
\end{itemize}} \end{itemize}}
\item Connect your \playertype{} to the computer using UMS mode and the UMS trick\opt{h10_5gb}{ if necessary}. \item Connect your \playertype{} to the computer using UMS mode and the UMS trick\opt{h10_5gb}{ if necessary}.
\item Make a backup of the \opt{h10}{\fname{H10\_20GC.mi4}}\opt{h10_5gb}{\fname{H10.mi4}} file in the \fname{System} directory on your \playertype{}. \item Make a backup of the \opt{h10}{\fname{H10\_20GC.mi4}}\opt{h10_5gb}{\fname{H10.mi4}} file in the \fname{System} directory on your \playertype{}.
\opt{h10_5gb}{\note{If you have a Pure model \playertype{} (which doesn't have a FM radio) it is possible that this file will be called \fname{H10EMP.mi4} instead. If so, rename the \fname{H10.mi4} you downloade in step 1 to \fname{H10EMP.mi4}.}} \opt{h10_5gb}{\note{If you have a Pure model \playertype{} (which doesn't have a FM radio) it is possible that this file will be called \fname{H10EMP.mi4} instead. If so, rename the \fname{H10.mi4} you downloaded in step 1 to \fname{H10EMP.mi4}.}}
\note{You should keep a safe backup of this file for use if you ever wish to switch back to the \playerman{} firmware.} \note{You should keep a safe backup of this file for use if you ever wish to switch back to the \playerman{} firmware.}
\note{If you can't see the \fname{System} directory, you will need to make sure your operating system is configured to show hidden files and folers.} \note{If you can't see the \fname{System} directory, you will need to make sure your operating system is configured to show hidden files and folders.}
\item Copy the \opt{h10}{\fname{H10\_20GC.mi4}}\opt{h10_5gb}{\fname{H10.mi4} (or \fname{H10EMP.mi4} if you have a \playertype{} Pure)} file you downloaded to the System directory on your \dap{}. \item Copy the \opt{h10}{\fname{H10\_20GC.mi4}}\opt{h10_5gb}{\fname{H10.mi4} (or \fname{H10EMP.mi4} if you have a \playertype{} Pure)} file you downloaded to the System directory on your \dap{}.
\end{enumerate} \end{enumerate}

44
manual/getting_started/installation.tex
View file

@ -14,11 +14,11 @@ software.
Rockbox is distributed as an archive using the Rockbox is distributed as an archive using the
\fname{.zip} format. Thus you need a tool to handle that compressed \fname{.zip} format. Thus you need a tool to handle that compressed
format. Usually your computer should have a tool installed that can format. Usually your computer should have a tool installed that can
handle the \fname{.zip} file format. Windows XP has builtin support for handle the \fname{.zip} file format. Windows XP has built-in support for
\fname{.zip} files and presents them to you as folders unless you have \fname{.zip} files and presents them to you as folders unless you have
installed a third party program that handles compressed files. For installed a third party program that handles compressed files. For
other operating systems this may vary. If the \fname{.zip} file format other operating systems this may vary. If the \fname{.zip} file format
is not recognized on your computer you can find a program to handle them is not recognised on your computer you can find a program to handle them
at \url{http://www.info-zip.org/} or \url{http://sevenzip.sf.net/} which at \url{http://www.info-zip.org/} or \url{http://sevenzip.sf.net/} which
can be downloaded and used free of charge. can be downloaded and used free of charge.
@ -30,7 +30,7 @@ software.
\opt{ipod}{ \opt{ipod}{
\note{Your \dap{} should enter disk mode automatically when connected to a \note{Your \dap{} should enter disk mode automatically when connected to a
computer via USB. If your computer does not recognize your \dap{}, you computer via USB. If your computer does not recognise your \dap{}, you
may need to enter the disk mode manually. Disconnect your \dap{} from the may need to enter the disk mode manually. Disconnect your \dap{} from the
computer. Reset the \dap{} by pressing and holding the \ButtonMenu{} and computer. Reset the \dap{} by pressing and holding the \ButtonMenu{} and
\ButtonSelect{} buttons simultaneously. As soon as the \dap{} resets, \ButtonSelect{} buttons simultaneously. As soon as the \dap{} resets,
@ -42,7 +42,7 @@ software.
\item[Text editor.] As you will see in the following chapters, Rockbox is \item[Text editor.] As you will see in the following chapters, Rockbox is
highly configurable. In addition to saving configurations within Rockbox, highly configurable. In addition to saving configurations within Rockbox,
Rockbox also allows you to create customized configuration files. If you Rockbox also allows you to create customised configuration files. If you
would like to edit custom configuration files on your computer, you will would like to edit custom configuration files on your computer, you will
need a text editor like Windows' ``Wordpad''. need a text editor like Windows' ``Wordpad''.
@ -75,22 +75,22 @@ software.
\begin{description} \begin{description}
\opt{HAVE_RB_BL_ON_DISK}{ \opt{HAVE_RB_BL_ON_DISK}{
\item[The \playerman{} bootloader.] \item[The \playerman{} boot loader.]
The \playerman{} bootloader is the program that tells your \dap{} how to boot The \playerman{} boot loader is the program that tells your \dap{} how to boot
and load the remaining firmware from disk. It is also responsible for the and load the remaining firmware from disk. It is also responsible for the
disk mode on your \dap{}. disk mode on your \dap{}.
This bootloader is stored in special flash memory in your \playerman. It is This boot loader is stored in special flash memory in your \playerman. It is
already installed on your \dap{}, so it is never necessary to modify this already installed on your \dap{}, so it is never necessary to modify this
in order to install Rockbox.} in order to install Rockbox.}
\item[The Rockbox bootloader.] \index{Bootloader} \item[The Rockbox boot loader.] \index{Boot loader}
\opt{HAVE_RB_BL_ON_DISK}{The Rockbox bootloader is loaded from disk by \opt{HAVE_RB_BL_ON_DISK}{The Rockbox boot loader is loaded from disk by
the \playerman{} bootloader. It is responsible for loading the Rockbox the \playerman{} boot loader. It is responsible for loading the Rockbox
firmware and for providing the dual boot function. It directly replaces the firmware and for providing the dual boot function. It directly replaces the
\playerman{} firmware on the \daps{} disk.} \playerman{} firmware on the \daps{} disk.}
\opt{HAVE_RB_BL_IN_FLASH}{ \opt{HAVE_RB_BL_IN_FLASH}{
The bootloader is the program that tells your The boot loader is the program that tells your
\dap{} how to boot and load other components of Rockbox. This is the \dap{} how to boot and load other components of Rockbox. This is the
component of Rockbox that is installed to the flash memory of your component of Rockbox that is installed to the flash memory of your
\playerman.} \playerman.}
@ -107,14 +107,14 @@ software.
\end{description} \end{description}
\subsection{Installing the bootloader} \subsection{Installing the boot loader}
\opt{h1xx,h300}{\input{getting_started/iriver_install.tex}} \opt{h1xx,h300}{\input{getting_started/iriver_install.tex}}
\opt{ipod}{\input{getting_started/ipod_install.tex}} \opt{ipod}{\input{getting_started/ipod_install.tex}}
\opt{x5}{\input{getting_started/iaudio_install.tex}} \opt{x5}{\input{getting_started/iaudio_install.tex}}
\opt{h10,h10_5gb}{\input{getting_started/h10_install.tex}} \opt{h10,h10_5gb}{\input{getting_started/h10_install.tex}}
\subsection{Installing the firmware} \subsection{Installing the firmware}
After installing the bootloader, the installation becomes fairly easy. After installing the boot loader, the installation becomes fairly easy.
} }
There are three different types of firmware binaries from Rockbox website: There are three different types of firmware binaries from Rockbox website:
@ -217,7 +217,7 @@ use.
your player using Itunes, you will not be able to see your music because your player using Itunes, you will not be able to see your music because
Itunes changes your files' names and hides them in directories in the Itunes changes your files' names and hides them in directories in the
\fname{Ipod\_Control} folder. You can view files placed on your \dap{} by \fname{Ipod\_Control} folder. You can view files placed on your \dap{} by
Itunes by initializing and using Rockbox's Tag Cache. See Itunes by initialising and using Rockbox's Tag Cache. See
\reference{ref:tagcache} for more information. \reference{ref:tagcache} for more information.
} }
} }
@ -252,7 +252,7 @@ connect the \playerman{} to your computer, and delete the
\optv{ipod}{ \optv{ipod}{
Next, open a command window (Windows) or a terminal window (Mac or Linux). Next, open a command window (Windows) or a terminal window (Mac or Linux).
Navigate to the folder you created when you downloaded the Navigate to the folder you created when you downloaded the
\fname{ipodpatcher} program you used to install the Rockbox bootloader. \fname{ipodpatcher} program you used to install the Rockbox boot loader.
Type the following command: Type the following command:
\begin{code} \begin{code}
@ -272,24 +272,24 @@ Turn the \dap{} back on and the original \playerman{} software will load.
\opt{h1xx}{ \opt{h1xx}{
\note{ \note{
There's no need to remove the installed bootloader. If you want to remove There's no need to remove the installed boot loader. If you want to remove
it, simply flash an unpatched \playerman{} firmware. Be aware that doing so it, simply flash an unpatched \playerman{} firmware. Be aware that doing so
will also remove the bootloader USB mode. As that mode can come in quite will also remove the boot loader USB mode. As that mode can come in quite
handy (especially when having disk errors) it is recommended to keep the handy (especially when having disk errors) it is recommended to keep the
bootloader. It also gives you the possibility of trying Rockbox anytime boot loader. It also gives you the possibility of trying Rockbox anytime
later by simply installing the distribution files. later by simply installing the distribution files.
} }
} }
\opt{h300}{ \opt{h300}{
\note{ \note{
There's no need to remove the installed bootloader, although you if you There's no need to remove the installed boot loader, although you if you
retain the Rockbox bootloader, you will need to hold the \ButtonRec{} retain the Rockbox boot loader, you will need to hold the \ButtonRec{}
button each time you want to start the original firmware. If you want to button each time you want to start the original firmware. If you want to
remove it simply flash an unpatched \playerman{} firmware. Be aware that remove it simply flash an unpatched \playerman{} firmware. Be aware that
doing so will also remove the bootloader USB mode. As that mode can come in doing so will also remove the boot loader USB mode. As that mode can come in
quite handy (especially when having disk errors), you may wish to keep the quite handy (especially when having disk errors), you may wish to keep the
bootloader. It also gives you the possibility of trying Rockbox anytime boot loader. It also gives you the possibility of trying Rockbox anytime
later by simply installing a new build. later by simply installing a new build.
} }
} }

8
manual/getting_started/ipod_install.tex
View file

@ -5,7 +5,7 @@ Please check the wiki for up-to-date and improved installation instructions!
If you find errors you're of course welcomed to report them so we can fix it If you find errors you're of course welcomed to report them so we can fix it
for the next daily builds.} for the next daily builds.}
Installing the bootloader is the trickiest part of the installation. Installing the boot loader is the trickiest part of the installation.
\opt{ipodnano}{First, you need to find out which version of the Apple \opt{ipodnano}{First, you need to find out which version of the Apple
firmware you're running. To do this, start the Apple firmware and go to firmware you're running. To do this, start the Apple firmware and go to
Settings screen. In the ``About'' screen you'll find the version number Settings screen. In the ``About'' screen you'll find the version number
@ -87,7 +87,7 @@ for the next daily builds.}
ipodpatcher -r \emph{N} bootpartition.bin ipodpatcher -r \emph{N} bootpartition.bin
\end{code} \end{code}
\note{You should keep a safe backup of this \fname{bootpartition.bin} file \note{You should keep a safe backup of this \fname{bootpartition.bin} file
for use if you ever wish to either upgrade the Rockbox bootloader or for use if you ever wish to either upgrade the Rockbox boot loader or
uninstall Rockbox from your Ipod} uninstall Rockbox from your Ipod}
\item Extract the Apple firmware from the partition image image just created: \item Extract the Apple firmware from the partition image image just created:
\begin{code} \begin{code}
@ -102,7 +102,7 @@ for the next daily builds.}
ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin ipod_fw -o apple_sw_5g_rcsc.bin -e 1 bootpartition.bin
\end{code} \end{code}
} }
\item Merge the Rockbox bootloader you downloaded previously with the Apple \item Merge the Rockbox boot loader you downloaded previously with the Apple
firm\-ware.% firm\-ware.%
\optv{ipodnano}{ \optv{ipodnano}{
If your firmware version is lower than 1.2 this works you need If your firmware version is lower than 1.2 this works you need
@ -265,7 +265,7 @@ Now, proceed with installing the firmware itself.
\item \url{http://www.rockbox.org/viewcvs.cgi/*checkout*/tools/ipod_fw.c} \item \url{http://www.rockbox.org/viewcvs.cgi/*checkout*/tools/ipod_fw.c}
\end{itemize} \end{itemize}
Now compile it to an executable by opening a command prompt and changing Now compile it to an executable by opening a command prompt and changing
to the folder created previously. Thn run the following command: to the folder created previously. Then run the following command:
\begin{code} \begin{code}
gcc -o ipod_fw ipod_fw.c gcc -o ipod_fw ipod_fw.c
\end{code} \end{code}

40
manual/getting_started/iriver_install.tex
View file

@ -1,11 +1,11 @@
% $Id$ % % $Id$ %
Installing the bootloader is the trickiest part of the installation. Installing the boot loader is the trickiest part of the installation.
The Rockbox bootloader allows users to boot into either the Rockbox The Rockbox boot loader allows users to boot into either the Rockbox
firmware or the iriver firmware. For legal reasons, we cannot distribute firmware or the \playerman{} firmware. For legal reasons, we cannot distribute
the bootloader. Instead, we have developed a program that will patch the the boot loader. Instead, we have developed a program that will patch the
Iriver firmware with the Rockbox bootloader. These instructions will explain Iriver firmware with the Rockbox boot loader. These instructions will explain
how to download and patch the Iriver firmware with the Rockbox bootloader how to download and patch the Iriver firmware with the Rockbox boot loader
and install it on your jukebox. and install it on your jukebox.
@ -22,7 +22,7 @@
your player.} your player.}
\opt{IRIVER_H300_PAD}{1.28K, 1.28EU, 1.28J, 1.29K, 1.29J and 1.30EU. \opt{IRIVER_H300_PAD}{1.28K, 1.28EU, 1.28J, 1.29K, 1.29J and 1.30EU.
\note{The US H3xx firmware is not currently supported and cannot be \note{The US H3xx firmware is not currently supported and cannot be
patched to be used with the bootloader. If you wish to install Rockbox patched to be used with the boot loader. If you wish to install Rockbox
on a US \playername, you must use an international firmware, which will on a US \playername, you must use an international firmware, which will
permanently remove DRM support from the player.} permanently remove DRM support from the player.}
}% }%
@ -32,7 +32,7 @@
to your desktop. Likewise, if the file that you downloaded is an to your desktop. Likewise, if the file that you downloaded is an
\fname{.exe} file, double-click on the \fname{.exe} file to extract \fname{.exe} file, double-click on the \fname{.exe} file to extract
the \fname{.hex} file to your desktop. the \fname{.hex} file to your desktop.
When running linux you should be able extracting \fname{.exe} When running Linux you should be able extracting \fname{.exe}
files using \fname{unzip}. files using \fname{unzip}.
% %
\item Download the firmware patcher \fname{fwpatcher.exe} from \item Download the firmware patcher \fname{fwpatcher.exe} from
@ -50,7 +50,7 @@
to the \fname{.hex} file that you previously downloaded to your desktop. to the \fname{.hex} file that you previously downloaded to your desktop.
% %
\item Click \setting{Patch}. The firmware patcher will patch the \item Click \setting{Patch}. The firmware patcher will patch the
original firmware to include the Rockbox bootloader. The \fname{.hex} original firmware to include the Rockbox boot loader. The \fname{.hex}
file on your desktop is now a modified version of the original file on your desktop is now a modified version of the original
\fname{.hex} file. \fname{.hex} file.
% %
@ -65,7 +65,7 @@
or that it is connected to the power adaptor. Interrupting the next step or that it is connected to the power adaptor. Interrupting the next step
due to a power failure most likely will brick your \dap{}.} due to a power failure most likely will brick your \dap{}.}
% %
\item Update your \daps{} firmware with the patched bootloader. To do this, turn \item Update your \daps{} firmware with the patched boot loader. To do this, turn
the jukebox on. Press and hold the the jukebox on. Press and hold the
\opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonSelect{} button }% \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonSelect{} button }%
to enter the main menu, and navigate to \setting{General $\rightarrow$ Firmware to enter the main menu, and navigate to \setting{General $\rightarrow$ Firmware
@ -76,24 +76,24 @@
firmware update is complete the player will turn itself off. (The update firmware update is complete the player will turn itself off. (The update
firmware process usually takes a minute or so.) firmware process usually takes a minute or so.)
You have now installed the Rockbox bootloader. You have now installed the Rockbox boot loader.
\end{enumerate} \end{enumerate}
\note{If you install the Rockbox bootloader but do not install the \note{If you install the Rockbox boot loader but do not install the
Rockbox firmware the Rockbox bootloader will load the iriver firmware when the Rockbox firmware the Rockbox boot loader will load the Iriver firmware when the
jukebox is turned on. jukebox is turned on.
To load the \playerman{} firmware press and hold \ButtonRec{} before To load the \playerman{} firmware press and hold \ButtonRec{} before
powering up the \dap{} until the \playerman{} logo appears. powering up the \dap{} until the \playerman{} logo appears.
} }
\note{The bootloader has a builtin ``bootloader USB mode''. This function \note{The boot loader has a built-in ``boot loader USB mode''. This function
switches to USB mode when the \dap{} is connected to a computer upon switches to USB mode when the \dap{} is connected to a computer upon
power-up. This way you can access the \daps{} harddisk without the need power-up. This way you can access the \daps{} hard disk without the need
to boot any firmware (which is also useful when your harddisk is to boot any firmware (which is also useful when your hard disk is
damaged). The screen will simply display the text ``bootloader USB mode''. damaged). The screen will simply display the text ``boot loader USB mode''.
After you disconnect the \dap{} from USB the bootloader will After you disconnect the \dap{} from USB the boot loader will
continue booting Rockbox. As in bootloader USB mode the firmware continue booting Rockbox. As in boot loader USB mode the firmware
itself hasn't been loaded this is also a simple way of updating Rockbox. itself hasn't been loaded this is also a simple way of updating Rockbox.
After the disconnect the bootloader will load the updated version of After the disconnect the boot loader will load the updated version of
Rockbox. Rockbox.
} }

12
manual/getting_started/main.tex
View file

@ -4,14 +4,14 @@
This is the manual for Rockbox. Rockbox is an open source firmware replacement This is the manual for Rockbox. Rockbox is an open source firmware replacement
for a growing number of MP3 players. Rockbox aims to be considerably more for a growing number of MP3 players. Rockbox aims to be considerably more
functional and efficient than your device's stock firmware while remaining easy functional and efficient than your device's stock firmware while remaining easy
to use and customizable. Rockbox is written by users, for users. Not only is it to use and customisable. Rockbox is written by users, for users. Not only is it
free to use, it's also released under the GNU public license, which means that free to use, it's also released under the GNU public license, which means that
it will always remain free both to use and to change. it will always remain free both to use and to change.
Rockbox has been in development since 2001, and recieves new features, tweaks Rockbox has been in development since 2001, and receives new features, tweaks
and fixes each day to provide you with the best possible experience on your MP3 and fixes each day to provide you with the best possible experience on your MP3
player. A major goal of Rockbox is to be simple and easy to use, yet remain very player. A major goal of Rockbox is to be simple and easy to use, yet remain very
customizable and configurable. We believe that you should never need to go customisable and configurable. We believe that you should never need to go
through a series of menus for an action you perform frequently. We also believe through a series of menus for an action you perform frequently. We also believe
that you should be able to configure almost anything about Rockbox you could that you should be able to configure almost anything about Rockbox you could
want, pertaining to functionality. Another top priority of Rockbox is audio want, pertaining to functionality. Another top priority of Rockbox is audio
@ -32,14 +32,14 @@ firmware. There is, however, more help available. The Rockbox website at
written by members of the Rockbox community and this should be your first port written by members of the Rockbox community and this should be your first port
of call when looking for further help. of call when looking for further help.
If you can't find the informations you're searching for on the Rockbox If you can't find the information you're searching for on the Rockbox
website there are a number of support channels you should have a look at. website there are a number of support channels you should have a look at.
You can try the Rockbox forums located at \url{http://forums.rockbox.org/}. You can try the Rockbox forums located at \url{http://forums.rockbox.org/}.
Another option are the mailing lists which can be found at Another option are the mailing lists which can be found at
\url{http://www.rockbox.org/mail/}. From that page you can subscribe to the \url{http://www.rockbox.org/mail/}. From that page you can subscribe to the
lists and browse the archives. For searching the list archives simply use lists and browse the archives. For searching the list archives simply use
the search field that is located on the left side of the web site. the search field that is located on the left side of the web site.
Also you can ask on IRC. The main channel for rockbox is \texttt{\#rockbox} Also you can ask on IRC. The main channel for Rockbox is \texttt{\#rockbox}
on \url{irc://irc.freenode.net}. A bunch of helpful developers and users on \url{irc://irc.freenode.net}. A bunch of helpful developers and users
are usually around. Just join and ask -- if someone knows the answer you'll are usually around. Just join and ask -- if someone knows the answer you'll
usually get an answer pretty quickly. More information including IRC logs usually get an answer pretty quickly. More information including IRC logs
@ -70,7 +70,7 @@ you finding important parts or parts you could skip. The following icons
are used: are used:
\note{This indicates a note. A note starts always with the text ``Note''. \note{This indicates a note. A note starts always with the text ``Note''.
For easier finding of notes we have put this an icon in the margin like For easier finding of notes we have put this an icon in the margin like
here. Notes are used to mark informations that could help you here. Notes are used to mark information that could help you
or indicate a possible ``weirdness'' in rockbox that would be explained. or indicate a possible ``weirdness'' in rockbox that would be explained.
} }
\warn{This is a warning. In contrast to notes mentioned above, a warning \warn{This is a warning. In contrast to notes mentioned above, a warning

12
manual/main_menu/main.tex
View file

@ -76,11 +76,11 @@ for more details on configuring bookmarking in Rockbox.
\section{Sound Settings} \section{Sound Settings}
The \setting{Sound Settings} menu offers a selection of sound properties you may The \setting{Sound Settings} menu offers a selection of sound properties you may
change to customize your listening experience. The details of this menu are change to customise your listening experience. The details of this menu are
covered in detail in \reference{ref:configure_rockbox_sound}. covered in detail in \reference{ref:configure_rockbox_sound}.
\section{General Settings} \section{General Settings}
The \setting{General Settings} menu allows you to customize the way Rockbox looks The \setting{General Settings} menu allows you to customise the way Rockbox looks
and the way it plays music. The details of this menu are covered in detail in and the way it plays music. The details of this menu are covered in detail in
\reference{ref:configure_rockbox_general}. \reference{ref:configure_rockbox_general}.
@ -138,7 +138,7 @@ headphones and when connected to an external amplifier. See
\begin{description} \begin{description}
\item[Create Playlist:] \item[Create Playlist:]
Rockbox will create a playlist with all tracks in the current directory Rockbox will create a playlist with all tracks in the current directory
and all subdirectories. The playlist will be created one folder level ``up'' and all sub-directories. The playlist will be created one folder level ``up''
from where you currently are. from where you currently are.
\item[View Current Playlist:] \item[View Current Playlist:]
@ -151,8 +151,8 @@ directory (see \reference{ref:Playlistsubmenu}).
\item[Recursively Insert Directories: ] \item[Recursively Insert Directories: ]
If set to \setting{On}, then when a directory is inserted or queued into a If set to \setting{On}, then when a directory is inserted or queued into a
dynamic playlist, all subdirectories will also be inserted. If set to \setting{Ask}, dynamic playlist, all sub-directories will also be inserted. If set to \setting{Ask},
Rockbox will prompt the user about whether to include subdirectories. Rockbox will prompt the user about whether to include sub-directories.
Options: \setting{Off}, \setting{Ask}, \setting{On} Options: \setting{Off}, \setting{Ask}, \setting{On}
\item[Warn When Erasing Dynamic Playlist: ] \item[Warn When Erasing Dynamic Playlist: ]
@ -190,7 +190,7 @@ of free space on the disk.
Software version and credits display. Software version and credits display.
\item[Debug (Keep Out!):] \item[Debug (Keep Out!):]
This submenu is intended to be used \emph{only} by Rockbox developers. This sub menu is intended to be used \emph{only} by Rockbox developers.
It shows hardware, disk, battery status and other technical information. It shows hardware, disk, battery status and other technical information.
\warn{It is not recommended that users access this menu unless instructed to \warn{It is not recommended that users access this menu unless instructed to
do so in the course of fixing a problem with Rockbox. If you think you have do so in the course of fixing a problem with Rockbox. If you think you have

18
manual/rockbox_interface/main.tex
View file

@ -25,7 +25,7 @@ picture above. In detail the buttons are described in the following paragraph.
On the right side the buttons \ButtonOn{}, \ButtonOff{}, \ButtonMode{} and On the right side the buttons \ButtonOn{}, \ButtonOff{}, \ButtonMode{} and
the hold switch. Next comes on the bottom the USB port, the hold switch. Next comes on the bottom the USB port,
a small hole for resetting the \dap{}, charger plug. On the left side located a small hole for resetting the \dap{}, charger plug. On the left side located
is the button \ButtonRec{}. At least the top has headphone minijack plug, is the button \ButtonRec{}. At least the top has headphone mini-jack plug,
remote port, optical/line in and optical/line out. remote port, optical/line in and optical/line out.
The joystick in the middle of the \dap{} is The joystick in the middle of the \dap{} is
used to navigate menus by pressing it up, down, left and right. Pressing the used to navigate menus by pressing it up, down, left and right. Pressing the
@ -42,7 +42,7 @@ picture above. In detail the buttons are described in the following paragraph.
four directional buttons used to navigate up, down, left and right. four directional buttons used to navigate up, down, left and right.
On the top panel of the \dap{}, from left to right, you can find the On the top panel of the \dap{}, from left to right, you can find the
following: headphone minijack plug, remote port, Line-in, Line-out. following: headphone mini jack plug, remote port, Line-in, Line-out.
On the bottom panel of the \dap{}, from left to right, you can find the On the bottom panel of the \dap{}, from left to right, you can find the
following: power jack and two USB ports. The USB port on the right is used following: power jack and two USB ports. The USB port on the right is used
@ -147,7 +147,7 @@ audio files to it.
When you have files on your \dap{} you'll see the supported ones now. Of When you have files on your \dap{} you'll see the supported ones now. Of
course you can change this view later. You can also completely switch to course you can change this view later. You can also completely switch to
a view that is based on the metadata\footnote{ID3 Tags, Vorbis comments, etc.} a view that is based on the meta-data\footnote{ID3 Tags, Vorbis comments, etc.}
of your audio files. This view is called Tag Cache (see of your audio files. This view is called Tag Cache (see
\reference{ref:tagcache}). Now you can start browsing the folder structure of \reference{ref:tagcache}). Now you can start browsing the folder structure of
your \dap{}. your \dap{}.
@ -176,7 +176,7 @@ stops the playback instead of going up a level.
Rockbox' main screen is the \setting{File Browser}. This is pretty different to Rockbox' main screen is the \setting{File Browser}. This is pretty different to
most other players that use the ``While Playing Screen'' as their main screen. most other players that use the ``While Playing Screen'' as their main screen.
In Rockbox' view this doesn't make any sense as when you are not playing a In Rockbox' view this doesn't make any sense as when you are not playing a
file, information about the currently playing file isn't available and therfore file, information about the currently playing file isn't available and therefore
useless. Because of this the \dap{} switches to the \setting{File Browser} when useless. Because of this the \dap{} switches to the \setting{File Browser} when
playback gets stopped. There is no point showing the WPS when playback is playback gets stopped. There is no point showing the WPS when playback is
stopped, so this is not and will not be possible. stopped, so this is not and will not be possible.
@ -199,23 +199,23 @@ Some views, especially the file browser and the WPS have a context menu.
From the file browser this can be accessed with \ActionStdContext{}. From the file browser this can be accessed with \ActionStdContext{}.
The contents of the context menu vary, depending on the situation it gets The contents of the context menu vary, depending on the situation it gets
called. The context menu itself presents you with some operations you can called. The context menu itself presents you with some operations you can
perform with the currently hightlighted file. In the file browser this is perform with the currently highlighted file. In the file browser this is
the file (or folder) that is highlighted by the cursor. From the WPS this is the file (or folder) that is highlighted by the cursor. From the WPS this is
the currently playing file. Also there are some actions that don't apply the currently playing file. Also there are some actions that don't apply
to the current file but refer to the screen from which the context menu to the current file but refer to the screen from which the context menu
gets called. One example is the playback menu, which can be called using gets called. One example is the playback menu, which can be called using
the context menu from within the WPS. the context menu from within the WPS.
\section{Customizing Rockbox} \section{Customising Rockbox}
Rockbox' User Interface can be customized using ``Themes''. Themes usually Rockbox' User Interface can be customised using ``Themes''. Themes usually
only affect the visual apperance, but an advanced user can create a theme only affect the visual appearance, but an advanced user can create a theme
that also changes various other settings like file view, LCD settings and that also changes various other settings like file view, LCD settings and
all other settings that can be modified using \fname{.cfg} files. This topic all other settings that can be modified using \fname{.cfg} files. This topic
is discussed in more detail in \reference{ref:manage_settings}. is discussed in more detail in \reference{ref:manage_settings}.
The Rockbox distribution comes with some themes that should look nice on The Rockbox distribution comes with some themes that should look nice on
your \dap{}. \note{Some of the themes shipped with Rockbox need additional your \dap{}. \note{Some of the themes shipped with Rockbox need additional
fonts from the fonts package, so make sure you installed them. fonts from the fonts package, so make sure you installed them.
Also, if you downloaded additional themes from the internet make sure you Also, if you downloaded additional themes from the Internet make sure you
have the needed fonts installed as otherwise the theme may get displayed have the needed fonts installed as otherwise the theme may get displayed
garbled.} garbled.}

4
manual/rockbox_interface/playback.tex
View file

@ -168,10 +168,10 @@ On the other hand, if the \setting{Playlist Submenu} is invoked on a
directory, Rockbox adds all of the tracks in that directory to the playlist. directory, Rockbox adds all of the tracks in that directory to the playlist.
\note{You can control whether or not Rockbox includes the contents of \note{You can control whether or not Rockbox includes the contents of
subdirectories when adding an entire directory to a playlists. Set the sub-directories when adding an entire directory to a playlists. Set the
\setting{Main Menu $\rightarrow$ Playlist Options $\rightarrow$ Recursively \setting{Main Menu $\rightarrow$ Playlist Options $\rightarrow$ Recursively
Insert Directories} setting to \setting{Yes} if you would like Rockbox to Insert Directories} setting to \setting{Yes} if you would like Rockbox to
include tracks in subdirectories as well as tracks in the currently-selected include tracks in sub-directories as well as tracks in the currently-selected
directory.} directory.}
If you want to have Rockbox create a playlist of a whole folder (to play an If you want to have Rockbox create a playlist of a whole folder (to play an

16
manual/rockbox_interface/tagcache.tex
View file

@ -8,8 +8,8 @@ contained in the tags (ID3v1, ID3v2%
) in your audio files, Rockbox builds and maintains a database of the music ) in your audio files, Rockbox builds and maintains a database of the music
files on your player and allows you to browse them by Artist, Album and Genre. files on your player and allows you to browse them by Artist, Album and Genre.
\subsection{Initializing the Tag Cache} \subsection{Initialising the Tag Cache}
Before you use the Tag Cache for the first time, you must initialize it by using Before you use the Tag Cache for the first time, you must initialise it by using
the \setting{Initialize Now} function in the \setting{Tag Cache Menu}, which is the \setting{Initialize Now} function in the \setting{Tag Cache Menu}, which is
described in the following section. described in the following section.
@ -43,7 +43,7 @@ described in the following section.
deleted files from the database you need to run \setting{Update Now}.}% deleted files from the database you need to run \setting{Update Now}.}%
\item[Initialize Now.] \item[Initialize Now.]
Before you use the Tag Cache for the first time, you must initialize it by Before you use the Tag Cache for the first time, you must Initialize it by
using the \setting{Initialize Now} function in the \setting{Tag Cache using the \setting{Initialize Now} function in the \setting{Tag Cache
Menu}. Menu}.
\warn{\setting{Initialize Now} removes all database files (removing \warn{\setting{Initialize Now} removes all database files (removing
@ -52,9 +52,9 @@ described in the following section.
\dap{}, and may require a restart to allow the files to be committed to the \dap{}, and may require a restart to allow the files to be committed to the
cache. cache.
The Tag Cache initialization happens in the background, so you can continue The Tag Cache initialisation happens in the background, so you can continue
to listen to music while the Tag Cache is being initialized. If you shut to listen to music while the Tag Cache is being initialised. If you shut
down your player during initialization, the database building process will down your player during initialisation, the database building process will
continue next time you turn it on. continue next time you turn it on.
\item[Update Now.] \item[Update Now.]
@ -83,12 +83,12 @@ described in the following section.
\item[Import modifications.] \item[Import modifications.]
Allows the \fname{/.rockbox/tagcache\_changelog.txt} backup to be Allows the \fname{/.rockbox/tagcache\_changelog.txt} backup to be
conveniently loaded into the Tag Cache. This is performed automatically when conveniently loaded into the Tag Cache. This is performed automatically when
the Tag Cache is initialized. the Tag Cache is initialised.
\end{description} \end{description}
\subsection{Using the Tag Cache} \subsection{Using the Tag Cache}
Once the Tag Cache has been initialized, you can browse your music by Artist, Once the Tag Cache has been initialised, you can browse your music by Artist,
Album, Genre and Song Name. To use the Tag Cache, change the Album, Genre and Song Name. To use the Tag Cache, change the
\setting{Show Files} show mode by changing the \setting{General Settings \setting{Show Files} show mode by changing the \setting{General Settings
$\rightarrow$ File View $\rightarrow$ Show files} option to $\rightarrow$ File View $\rightarrow$ Show files} option to

2
manual/rockbox_interface/wps.tex
View file

@ -4,7 +4,7 @@ The While Playing Screen (WPS) displays various pieces of information about the
currently playing audio file. currently playing audio file.
% %
\opt{HAVE_LCD_BITMAP}{% \opt{HAVE_LCD_BITMAP}{%
The apperance of the WPS can be configured using wps configuration files. The appearance of the WPS can be configured using WPS configuration files.
The items shown depend on your configuration -- all item can be turned on The items shown depend on your configuration -- all item can be turned on
or off independently. Refer to \reference{ref:wps_tags} for details on how or off independently. Refer to \reference{ref:wps_tags} for details on how
to change the display of the WPS. to change the display of the WPS.

8
manual/working_with_playlists/main.tex
View file

@ -111,10 +111,10 @@ accept it and you're done.
\subsection{Helpful Hints} \subsection{Helpful Hints}
\subsubsection{Including subdirectories in playlists} \subsubsection{Including sub-directories in playlists}
You can control whether or not Rockbox includes the contents of You can control whether or not Rockbox includes the contents of
subdirectories when adding an entire directory to a playlists. sub-directories when adding an entire directory to a playlists.
Set the \setting{Main Menu $\rightarrow$ Playlist Options $\rightarrow$ Set the \setting{Main Menu $\rightarrow$ Playlist Options $\rightarrow$
Recusively Insert Directories} setting to \setting{Yes} if you would like Recursively Insert Directories} setting to \setting{Yes} if you would like
Rockbox to include tracks in subdirectories as well as tracks in the Rockbox to include tracks in sub-directories as well as tracks in the
currently selected directory. currently selected directory.