Adjust voice section to current style. Code policing.

git-svn-id: svn://svn.rockbox.org/rockbox/trunk@10032 a1c6a512-1295-4272-9138-f99709370657

1 files changed, 44 insertions, 21 deletions

diff --git a/manual/configure_rockbox/voice.tex b/manual/configure_rockbox/voice.tex
index 7fcc90c577..c1ff4243bc 100755
--- a/manual/configure_rockbox/voice.tex
+++ b/manual/configure_rockbox/voice.tex
@@ -1,32 +1,55 @@
+% $Id$ %
 \section{\label{ref:Voiceconfiguration}Voice}
 
-  \begin{itemize}
-  \item \textbf{Voice Menus:}
-    This option turns on the Voice User Interface, which will read out menu items and settings as they are selected by the cursor.  In order for this to work, a voice file must be present in the \textbf{/.rockbox/lang/} directory on the \dap.  Voice files are large (1.5MB) and are not shipped with Rockbox by default.
-    The voice file is the name of the language for which it is made, followed by the extension .voice.  So for English, the file name would be \fname{english.voice}.
-    This option is on by default.  It will do nothing unless the appropriate .voice file is installed in the correct place on the \dap.
+  \begin{description}
+  \item[Voice Menus.]
+    This option turns on the Voice User Interface, which will read out menu
+    items and settings as they are selected by the cursor.  In order for this
+    to work, a voice file must be present in the \fname{/.rockbox/lang/}
+    directory on the \dap.  Voice files are large (1.5MB) and are not 
+    shipped with Rockbox by default.
+    The voice file is the name of the language for which it is made, followed
+    by the extension \fname{.voice}.  So for English, the file name would be 
+    \fname{english.voice}.
+    This option is on by default.  It will do nothing unless the 
+    appropriate voice file is installed in the correct place on the \dap.
     The Voice Menus have several limitations:
     \begin{itemize}
-    \item Setting the Sound Option \textbf{Channels} to ``karaoke'' may disable voice menus.
+    \item Setting the Sound Option \setting{Channels} to \setting{Karaoke} may 
+      disable voice menus.
     \item Plugins and the wake up alarm do not support voice features.
     \end{itemize}
 
-  \item \textbf{Voice Directories:}
-    This option turns on the speaking of directory names.  The \dap\ is not powerful enough to produce these voices in real time, so a number of options are available.
-    \begin{itemize}
-    \item \textbf{.talk mp3 clip: }
-      Use special pre{}-recorded MP3 files (\fname{\_dirname.talk}) in each directory.  These must be generated in advance, and are typically produced synthetically using a text to speech engine on a PC.  If no such file exists, the output is as for the ``numbers'' option below.
-    \item \textbf{Spell: }
-      Speak the directory name by spelling it out letter by letter.  Support is provided only for the most common letters and punctuation.
-    \item \textbf{Numbers: }
-      Each directory is assigned a number based upon its position in the file list.  They are then announced as ``Directory 1'', ``Directory 2'' etc.
-    \item \textbf{Off: }
+  \item[Voice Directories.]
+    This option turns on the speaking of directory names.  The \dap{} 
+    is not powerful enough to produce these voices in real time, so a number 
+    of options are available.
+    \begin{description}
+    \item[.talk mp3 clip.]
+      Use special pre-recorded MP3 files (\fname{\_dirname.talk}) in each 
+      directory.  These must be generated in advance, and are typically 
+      produced synthetically using a text to speech engine on a PC.
+      If no such file exists, the output is as for the \setting{numbers}
+      option below.
+    \item[Spell.]
+      Speak the directory name by spelling it out letter by letter.  Support
+      is provided only for the most common letters and punctuation.
+    \item[Numbers.]
+      Each directory is assigned a number based upon its position in the
+      file list.  They are then announced as ``Directory 1'', ``Directory 2''
+      etc.
+    \item[Off.]
       No attempt will be made to speak directory names.
-    \end{itemize}
+    \end{description}
 
-  \item \textbf{Voice Filenames:}
-    This option turns on the speaking of directory names.  The options provided are ``Spell'', ``Numbers'', and ``Off'' which function the same as for \textbf{Voice Directories} and ``.talk mp3 clip,'' which functions as above except that the files are named with the same name as the music file (e.g. \fname{Punkadiddle.mp3 } would require a file called \textbf{Punkadiddle.mp3.talk}).
+  \item[Voice Filenames.]
+    This option turns on the speaking of directory names.  The options provided
+    are \setting{Spell}, \setting{Numbers}, and \setting{Off} which function 
+    the same as for \setting{Voice Directories} and \setting{.talk mp3 clip},
+    which functions as above except that the files are named with the same
+    name as the music file (e.g. \fname{Punkadiddle.mp3} would require a
+    file called \fname{Punkadiddle.mp3.talk}).
 
-  \end{itemize}
+  \end{description}
 
-See \url{http://www.rockbox.org/twiki/bin/view/Main/VoiceHowto} for more details on configuring speech support in Rockbox.
+See \wikilink{VoiceHowto} for more details on configuring speech support in Rockbox.