Add gigabeat F/S volume limits to the manual, and a few minor formatting changes.
git-svn-id: svn://svn.rockbox.org/rockbox/trunk@22513 a1c6a512-1295-4272-9138-f99709370657
diff --git a/manual/advanced_topics/main.tex b/manual/advanced_topics/main.tex
index f6ba4ae..f956922 100644
--- a/manual/advanced_topics/main.tex
+++ b/manual/advanced_topics/main.tex
@@ -16,7 +16,8 @@
\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$ Theme Settings $\rightarrow$ Font}
- in the \setting{Main Menu}.
+ 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}
@@ -28,11 +29,11 @@
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$ Language }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
-must be a maximum of 24 characters long.}
+must be a maximum of 24 characters long.\\}
If your language is not yet supported and you want to write your own language
file find the instructions on the Rockbox website:
@@ -220,7 +221,7 @@
If you use the upper-case versions of the
three tags: \config{F}, \config{I} and \config{D}, they will instead refer to
the next song instead of the current one. Example: \config{\%Ig} is the genre
-name used in the next song and \config{\%Ff} is the mp3 frequency.
+name used in the next song and \config{\%Ff} is the mp3 frequency.\\
\note{The next song information \emph{will not} be available at all
times, but will most likely be available at the end of a song. We
@@ -396,7 +397,7 @@
settings. Create a few different files with different settings, give
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.}
+ 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
@@ -482,6 +483,7 @@
\opt{iaudio}{\fname{.iaudio}.} %
\opt{sansa,h10,h10_5gb}{\fname{.mi4}.} %
\opt{sansaAMS}{\fname{.sansa}.} %
+\opt{gigabeatf,gigabeats}{\fname{.gigabeat}.} %
This can be used to test new firmware versions without deleting your
current version.
diff --git a/manual/configure_rockbox/playback_options.tex b/manual/configure_rockbox/playback_options.tex
index fef0af2..e34fc87 100644
--- a/manual/configure_rockbox/playback_options.tex
+++ b/manual/configure_rockbox/playback_options.tex
@@ -71,12 +71,12 @@
\opt{masd,masf}{
The anti-skip buffer can be set to a value between 0 and 7
- seconds.
+ seconds.\\
}
\opt{swcodec}{
The anti-skip buffer can be set to various values between
- 5 seconds and 10 minutes.
+ 5 seconds and 10 minutes.\\
}
\note{Having a large anti-skip buffer tends to use more power, and may
@@ -139,7 +139,7 @@
\note{The rules above apply except in the instance where
\setting{Fade Out Delay} plus \setting{Fade Out Duration} is less then
\setting{Fade In Delay} (which would create a gap in the audio). In this case,
- the \setting{Fade In Delay} is reduced to eliminate the gap.}
+ the \setting{Fade In Delay} is reduced to eliminate the gap.\\}
The graphic below illustrates how the different settings work in practice.
@@ -152,8 +152,9 @@
same apparent volume. This prevents sudden changes in volume when
changing between songs recorded at different volume levels.
For replaygain to work, the songs must have been processed by a program
- that adds replaygain information to the ID3 tags (or Vorbis tags).
- \note{APEv2 tags are not currently supported.}
+ that adds replaygain information to the ID3 tags (or Vorbis tags).\\
+
+ \note{APEv2 tags are not currently supported.\\}
Options for replaygain are:
\begin{description}
@@ -208,9 +209,11 @@
\setting{Auto-Change Directory} is set to \setting{No}, playback will stop at
the end of the current playlist. Using the \setting{Random} feature requires
you to first generate a folder list via the Random Folder Advance Configuration
- plugin (see \reference{ref:random_folder_advance_config}).
+ plugin (see \reference{ref:random_folder_advance_config}).\\
+
\note{You must have the \setting{Repeat} option set to \setting{No} for
- \setting{Auto-Change Directory} to function properly.}
+ \setting{Auto-Change Directory} to function properly.\\}
+
\note{This feature only works when songs have been played from the file
browser. Using it with the database may cause unexpected behavior.}
@@ -249,7 +252,8 @@
start the logging. The log-file is called
\opt{rtc}{\fname{.scrobbler.log},}%
\nopt{rtc}{\fname{.scrobbler-timeless.log},}%
- and is to be found in the root directory of your \dap{}.
+ and is to be found in the root directory of your \dap{}.\\
+
\note{See \wikilink{LastFMLog} for a further description, and for tools you
can use to submit your Last.fm log.}
diff --git a/manual/configure_rockbox/sound_settings.tex b/manual/configure_rockbox/sound_settings.tex
index e8e4f8a..6a7d423 100644
--- a/manual/configure_rockbox/sound_settings.tex
+++ b/manual/configure_rockbox/sound_settings.tex
@@ -11,7 +11,7 @@
can produce without possible distortion (clipping). All values lower than
this reference will be negative and yield a progressively softer volume.
\opt{player,recorder,recorderv2fm,ondio,x5,m5,ipodnano,ipodvideo,
- ipodcolor,ipod1g2g,h10,h10_5gb,sansa,sansaAMS}{
+ ipodcolor,ipod1g2g,h10,h10_5gb,sansa,sansaAMS,gigabeats,gigabeatf}{
Values higher than 0 dB are available and can be used to raise the
volume more than would otherwise be possible. These volume levels will
ordinarily lead to distorted sound, but might work nicely for music that has
@@ -25,6 +25,8 @@
\opt{ipodvideo}{minimum of -57 dB to a maximum of +6 dB.}%
\opt{ipodcolor,ipod1g2g,h10,h10_5gb,sansa,sansaAMS}{minimum of -74 dB to a maximum
of +6 db.}%
+ \opt{gigabeats}{minimum of -90 dB to a maximum of +6 dB.}%
+ \opt{gigabeatf}{minimum of -74 dB to a maximum of +6 dB.}%
\section{Bass}
This setting emphasises
@@ -211,7 +213,7 @@
headphones more similar to listening to music with stereo speakers. When you
listen to music through speakers, each ear will hear sound originating from
both speakers. However, the sound from the left speaker reaches your right
- ear slightly later than it does your left ear, and vice versa.
+ ear slightly later than it does your left ear, and vice versa.\\
The human ear and brain together are very good at interpreting the time
differences between direct sounds and reflected sounds and using that
@@ -220,7 +222,7 @@
channel corresponding to it. The left ear hears only the left channel and
the right ear hears only the right channel. The result is that sound from
headphones does not provide the same spatial cues to your ear and brain as
- speakers, and might for that reason sound unnatural to some listeners.
+ speakers, and might for that reason sound unnatural to some listeners.\\
The crossfeed function uses an algorithm to feed a delayed and filtered
portion of the signal from the right channel into the left channel and vice
@@ -229,7 +231,7 @@
result is a more natural stereo image that can be especially appreciated in
older rock and jazz records, where one instrument is often hard-panned to
just one of the speakers. Many people will find such records tiring to listen
- to using earphones and no crossfeed effect.
+ to using earphones and no crossfeed effect.\\
Crossfeed has the following settings:
\begin{description}
@@ -256,7 +258,6 @@
virtual speaker placement suited to ones preference.
% TODO: adapt the guidelines for crossfeed settings found here?
% http://www.ohl.to/interests-in-audio/crossfeed-and-eq-for-headphones/
-
Beware that the crossfeed function is capable of making the audio distort
if you choose settings which result in a too high output level.
}
@@ -268,7 +269,7 @@
parametric EQ lets you control several different parameters for each
band of the EQ. In some ways the EQ is similar to the \setting{Bass}
and \setting{Treble} settings described earlier, but the EQ allows you to
- control the sound much more carefully.
+ control the sound much more carefully.\\
Rockbox's parametric EQ is composed of five different bands:
\begin{description}
@@ -436,10 +437,8 @@
\opt{swcodec}{
\section{Timestretch}
-Enabling \setting{Timestretch} allows you to change the playback speed without it
-affecting the pitch of the recording.
-
-After enabling this feature and rebooting, you can access this via the \setting{Pitch Screen}.
-This function is intended for speech playback and may significantly dilute your listening
-experience with more complex audio.
-}
+Enabling \setting{Timestretch} allows you to change the playback speed without
+it affecting the pitch of the recording. After enabling this feature and
+rebooting, you can access this via the \setting{Pitch Screen}. This function is
+intended for speech playback and may significantly dilute your listening
+experience with more complex audio.}
diff --git a/manual/plugins/goban.tex b/manual/plugins/goban.tex
index 815eec5..385ee28 100644
--- a/manual/plugins/goban.tex
+++ b/manual/plugins/goban.tex
@@ -2,13 +2,10 @@
\screenshot{plugins/images/ss-goban}{Goban}{The Rockbox Goban plugin}
Goban is a a plugin for playing, viewing and recording games of Go (also known
as Weiqi, Baduk, Igo and Goe). It uses standard Smart Game Format (SGF) files
-for saving and loading games.
-
-You can find a short introduction to Go at
+for saving and loading games. You can find a short introduction to Go at
\url{http://senseis.xmp.net/?WhatIsGo} and more information about SGF files
can be read at \url{http://senseis.xmp.net/?SmartGameFormat} or the SGF
-specification at
-\url{http://www.red-bean.com/sgf/}.
+specification at \url{http://www.red-bean.com/sgf/}.\\
This plugin can load all modern SGF files (file format 3 or 4) with few problems.
It attempts to preserve SGF properties which it doesn't understand, and most common
@@ -17,18 +14,18 @@
although the load and save times can be on the order of a minute or two on
particularly slow devices. Large SGF files may stop audio playback for the duration
of the plugin's run in order to free up more memory and some very large SGF files will
-not even load on devices with little available memory.
+not even load on devices with little available memory.\\
-\emph{Note: } The plugin does \emph{NOT} support SGF files with multiple games in
+\note{The plugin does \emph{NOT} support SGF files with multiple games in
one file. These are rare, but if you have one don't even try it (the file will most
-likely be corrupted if you save over it). You have been warned.
+likely be corrupted if you save over it). You have been warned.\\}
The file \fname {"/sgf/gbn\_def.sgf"} is used by the plugin to store any unsaved
changes in the most recently loaded game. This means that if you forget to save your
changes, you should load \fname {"/sgf/gbn\_def.sgf"} immediately to offload the changes
to another file. If you load another file first then your changes will be lost
permanently. The \fname {"/sgf/gbn\_def.sgf"} file is also the file loaded if another
-is not selected.
+is not selected.\\
The information panel which displays the current move number may also contain
these markers: \\
diff --git a/manual/plugins/main.tex b/manual/plugins/main.tex
index 1a57fc9..a737598 100644
--- a/manual/plugins/main.tex
+++ b/manual/plugins/main.tex
@@ -6,7 +6,7 @@
a plugin is loaded, you need to exit it to return to the Rockbox interface.
Most plugins will not interfere with music playback but some of them will stop
playback while running. Plugins have the file extension \fname{.rock}. Most of
-them can be started from \setting{Browse Plugins} in the \setting{Main Menu}.
+them can be started from \setting{Browse Plugins} in the \setting{Main Menu}.\\
Viewer plugins get started automatically by opening an associated file (i.e.
text files%
diff --git a/manual/plugins/pngviewer.tex b/manual/plugins/pngviewer.tex
index c205ac0..40e9197 100644
--- a/manual/plugins/pngviewer.tex
+++ b/manual/plugins/pngviewer.tex
@@ -1,10 +1,10 @@
% $Id: $id$ %
\subsection{PNG viewer}
-Open a PNG file in the \setting{File Browser} to view it%
+Open a PNG file in the \setting{File Browser} to view it.\\%
\opt{swcodec}{
\note{When an audio file is playing the size of the image is limited as
the decoding process needs to share memory with audio tracks. To be able to
- view a bigger file you may need to stop playback.}
+ view a bigger file you may need to stop playback.\\}
}
\nopt{large_plugin_buffer}{%
\note{This plugin will cause playback to stop.}%
diff --git a/manual/plugins/ppmviewer.tex b/manual/plugins/ppmviewer.tex
index 7de2b8c..7594faf 100644
--- a/manual/plugins/ppmviewer.tex
+++ b/manual/plugins/ppmviewer.tex
@@ -1,11 +1,8 @@
% $Id$ %
\subsection{PPM viewer}
-Open a PPM file in the \setting{File Browser} to view it.
+Open a PPM file in the \setting{File Browser} to view it. PPM viewer exits
+when any button is pressed.\\
-ppmviewer exits when any button is pressed.
-
-\note{
-Both ASCII PPM (P3) and raw PPM (P6) files are supported.
-
-For more information about PPM files, see \url{http://netpbm.sourceforge.net/doc/ppm.html}
-}
+\note{Both ASCII PPM (P3) and raw PPM (P6) files are supported.
+For more information about PPM files, see
+\url{http://netpbm.sourceforge.net/doc/ppm.html}}
diff --git a/manual/rockbox_interface/browsing_and_playing.tex b/manual/rockbox_interface/browsing_and_playing.tex
index f605452..bdbb97e 100644
--- a/manual/rockbox_interface/browsing_and_playing.tex
+++ b/manual/rockbox_interface/browsing_and_playing.tex
@@ -121,12 +121,12 @@
The \setting{Context Menu} allows you to perform certain operations on files or
directories. To access the \setting{Context Menu}, position the selector over a file
-or directory and access the context menu with \ActionStdContext{}.
+or directory and access the context menu with \ActionStdContext{}.\\
\note{The \setting{Context Menu} is a context sensitive menu. If the
\setting{Context Menu} is invoked on a file, it will display options available
for files. If the \setting{Context Menu} is invoked on a directory,
-it will display options for directories.}
+it will display options for directories.\\}
The \setting{Context Menu} contains the following options (unless otherwise noted,
each option pertains both to files and directories):
diff --git a/manual/working_with_playlists/main.tex b/manual/working_with_playlists/main.tex
index bdc82c0..96781e0 100644
--- a/manual/working_with_playlists/main.tex
+++ b/manual/working_with_playlists/main.tex
@@ -40,7 +40,7 @@
Whenever a song is selected from the \setting{File Browser} with
\ActionTreeEnter, Rockbox will automatically create a playlist containing
all of the songs in that directory and start playback with the selected
-song.
+song.\\
\note{If you already have created a dynamic playlist, playing a new
song will \emph{erase} the current dynamic playlist and create a new one.
@@ -60,7 +60,7 @@
in the \setting{Context Menu}. There you will have two choices,
\setting{Add to playlist} adds the selected track or directory to an existing
playlist and \setting{Add to a new playlist} creates a new playlist containing
-the selected track or directory.
+the selected track or directory.\\
\note{All playlists in the \setting{Playlist catalog} are stored by default
in the \fname{/Playlists} directory in the root of your \daps{} disk and
@@ -121,17 +121,17 @@
invoked on a single track, it will put only that track into the playlist.
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.
+playlist.\\
\note{You can control whether or not Rockbox includes the contents of
subdirectories when adding an entire directory to a playlists. Set the
\setting{Settings $\rightarrow$ General Settings $\rightarrow$ Playlist
$\rightarrow$ Recursively Insert Directories} setting to \setting{Yes} if
you would like Rockbox to include tracks in subdirectories as well as tracks
- in the currently-selected directory.}
+ in the currently-selected directory.\\}
Dynamic playlists are saved so resume will restore them exactly as they
-were before shutdown.
+were before shutdown.\\
\note{To view, save or reshuffle the current dynamic playlist use the
\setting{Playlist} sub menu in the WPS context menu or in the