1 files changed, 145 insertions, 109 deletions

diff --git a/manual/plugins/text_viewer.tex b/manual/plugins/text_viewer.tex
index 4028f56adc..2bffae0ad7 100644
--- a/manual/plugins/text_viewer.tex
+++ b/manual/plugins/text_viewer.tex
@@ -5,135 +5,171 @@ formatting, has top{}-of{}-file and bottom{}-of{}-file buttons. You can view
 files without a \fname{.txt} extension by using \emph{Open with} from the
 \emph{Context Menu} (see \reference{ref:Contextmenu}).
 
-\subsubsection{Mode settings}
-
-\begin{description}
-\item[Word mode] toggles between Wrap and Chop.
-    \begin{description}
-        \item[Wrap] breaks lines at white space or hyphen.
-        \item[Chop] breaks lines at the maximum column limit.
-    \end{description}  
-\item[Line mode] cycles through Normal, Join and Expand.
-    \begin{description}
-        \item[Normal] breaks lines at newline characters.
-        \item[Join] ignores unpaired newline characters (i.e., joins lines).
-        Useful for adopting the orphans that occur with e{}-mail style
-        (i.e.,pre{}-wrapped) text files.
-        \item[Expand] doubles unpaired newlines (i.e., adds a blank line).
-        Useful for making the paragraphs clearer in some book style text files.
-    \end{description}
-\item[View mode] toggles between Narrow and Wide.
-    \begin{description}
-        \item[Narrow] sets maximum column to the screen width.
-        \item[Wide] sets maximum column to 114. Useful for navigating large files. (Currently, Wide and Join cannot be selected together.)
-    \end{description}
-\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IRIVER_H10_PAD,SANSA_E200_PAD}{
-\item[Page mode] toggles between Normal and Overlap.
-    \begin{description}
-        \item[Normal] sets page{}-down/page{}-up to one full screen.
-        \item[Overlap] tells page{}-down/page{}-up to retain one line from previous screen.    
-    \end{description}
-\item[Scrollbar mode] toggles scrollbar for the current View mode.
-    \begin{description}
-        \item[Narrow mode] has no scrollbar by default, until toggled.
-        \item[Wide mode] has a scrollbar by default, until toggled.
-    \end{description}
-}
-\end{description}
-Settings are not remembered after the viewer has been exited.
-\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IRIVER_H10_PAD,ANSA_E200_PAD}{
-If file fits on one screen, there is no scrollbar and toggling Scrollbar mode has no effect.}
 
 \begin{table}
     \begin{btnmap}{}{}
     \opt{PLAYER_PAD}{\ButtonLeft}
-    \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,GIGABEAT_PAD,MROBE100_PAD}{\ButtonUp}
-    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollBack} 
+    \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD%
+        ,SANSA_E200_PAD,GIGABEAT_PAD,MROBE100_PAD}{\ButtonUp}
+    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollBack}
     \opt{IRIVER_H10_PAD}{\ButtonScrollUp}
-        & Page{}-up (one screen up)\\
-        
+    \opt{SANSA_C200_PAD}{\ButtonVolUp}
+        & Scroll{}-up\\
+
     \opt{PLAYER_PAD}{\ButtonRight}
-    \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD,SANSA_E200_PAD,GIGABEAT_PAD,MROBE100_PAD}{\ButtonDown}
-    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollFwd} 
+    \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD%
+        ,SANSA_E200_PAD,GIGABEAT_PAD,MROBE100_PAD}{\ButtonDown}
+    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonScrollFwd}
     \opt{IRIVER_H10_PAD}{\ButtonScrollDown}
-    & Page{}-down (one screen down)\\
-        
+    \opt{SANSA_C200_PAD}{\ButtonVolDown}
+        & Scroll{}-down\\
+
     \opt{PLAYER_PAD}{\ButtonMenu+\ButtonLeft}
-    \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,GIGABEAT_PAD,MROBE100_PAD}{\ButtonLeft} 
-    & Top of file (Narrow mode) One screen left (Wide mode)\\
-        
+    \nopt{PLAYER_PAD}{\ButtonLeft}
+        & Top of file (Narrow mode) /
+        One screen left (Wide mode)\\
+
     \opt{PLAYER_PAD}{\ButtonMenu+\ButtonRight}
-    \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,GIGABEAT_PAD,MROBE100_PAD}
-        {\ButtonRight} 
-    & Bottom of file (Narrow mode) One screen right (Wide mode)\\
-        
-    \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}
-       {\ButtonOn+\ButtonUp & One line up\\}
-    
-    \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}
-       {\ButtonOn+\ButtonDown & One line down\\}
-    
-    \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}
-       {\ButtonOn+\ButtonLeft & One column left\\}
-        
-    \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}
-       {\ButtonOn+\ButtonRight & One column right\\}
-        
-    \opt{PLAYER_PAD}{\ButtonOn+\ButtonLeft}
+    \nopt{PLAYER_PAD}{\ButtonRight}
+        & Bottom of file (Narrow mode) /
+        One screen right (Wide mode)\\
+
+    \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{%
+        \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonUp}
+        \opt{SANSA_E200_PAD}{\ButtonScrollBack}
+        \opt{SANSA_C200_PAD}{\ButtonUp}
+        & One line up\\
+    }
+
+    \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,SANSA_E200_PAD,SANSA_C200_PAD}{%
+        \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonDown}
+        \opt{SANSA_E200_PAD}{\ButtonScrollFwd}
+        \opt{SANSA_C200_PAD}{\ButtonDown}
+        & One line down\\
+    }
+
+    \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{
+        \ButtonOn+\ButtonLeft
+        & One column left\\
+    }
+
+    \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{
+        \ButtonOn+\ButtonRight
+        & One column right\\
+    }
+
+    \opt{RECORDER_PAD,PLAYER_PAD,IPOD_4G_PAD,IPOD_3G_PAD,IAUDIO_X5_PAD,IRIVER_H10_PAD}{\ButtonPlay}
+    \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonSelect}
+    \opt{ONDIO_PAD}{\ButtonMenu}
+    \opt{GIGABEAT_PAD}{\ButtonA}
+    \opt{SANSA_C200_PAD,SANSA_E200_PAD}{\ButtonRec}
+    \opt{MROBE100_PAD}{\ButtonDisplay}
+        & Toggle autoscroll\\
+
     \opt{RECORDER_PAD}{\ButtonFOne}
-    \opt{ONDIO_PAD}{\ButtonMenu+\ButtonLeft}
-    \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonRec}
-    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonLeft}
-    \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD}{\ButtonPlay}
-    \opt{SANSA_E200_PAD}{\ButtonScrollBack}
-        & Toggles Word mode\\
-        
-    \opt{PLAYER_PAD}{\ButtonOn+\ButtonMenu+\ButtonRight}
-    \opt{RECORDER_PAD}{\ButtonFTwo}
-    \opt{ONDIO_PAD}{\ButtonMenu+\ButtonUp}
+    \opt{ONDIO_PAD}{Long \ButtonMenu}
+    \opt{PLAYER_PAD,IPOD_4G_PAD,IPOD_3G_PAD,GIGABEAT_PAD,MROBE100_PAD}{\ButtonMenu}
     \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
-    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonPlay}
-    \opt{IAUDIO_X5_PAD}{Long press on \ButtonPlay}
-    \opt{IRIVER_H10_PAD,SANSA_E200_PAD}{n/a}
-        & Cycles line mode\\
-        
-    \opt{PLAYER_PAD}{\ButtonOn+\ButtonRight}
-    \opt{RECORDER_PAD}{\ButtonFThree}
-    \opt{ONDIO_PAD}{\ButtonMenu+\ButtonRight}
-    \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{\ButtonSelect}
-    \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonSelect+\ButtonRight}
-    \opt{IRIVER_H10_PAD,SANSA_E200_PAD}{n/a}
-        & Toggles view mode\\
-        
-    \opt{RECORDER_PAD}{\ButtonOn+\ButtonFOne & Toggles page mode\\}
-    \opt{ONDIO_PAD}{\ButtonMenu+\ButtonDown & Toggles page mode\\}
-    \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}
-        {\ButtonOn+\ButtonMode & Toggles page mode\\}
-    \opt{IPOD_4G_PAD,IPOD_3G_PAD}
-        {\ButtonSelect+\ButtonMenu+\ButtonLeft & Toggles page mode\\}
-        
-    \opt{RECORDER_PAD}{\ButtonOn+\ButtonFThree & Toggles scrollbar mode\\}
-    \opt{ONDIO_PAD}{\ButtonMenu+\ButtonOff & Toggles scrollbar mode\\}
-    \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}
-        {\ButtonOn+\ButtonRec & Toggles scrollbar mode\\}
-    \opt{IPOD_4G_PAD,IPOD_3G_PAD}
-        {\ButtonSelect+\ButtonLeft+\ButtonRight & Toggles scrollbar mode\\}
-        
+    \opt{IAUDIO_X5_PAD,SANSA_C200_PAD,SANSA_E200_PAD}{\ButtonSelect}
+    \opt{IRIVER_H10_PAD}{\ButtonRew}
+        & Enter menu\\
+
     \opt{PLAYER_PAD}{\ButtonStop}
     \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
     \opt{IPOD_4G_PAD,IPOD_3G_PAD}{\ButtonMenu}
-    \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,GIGABEAT_PAD,MROBE100_PAD}{\ButtonPower}
+    \opt{IAUDIO_X5_PAD,IRIVER_H10_PAD,SANSA_E200_PAD,SANSA_C200_PAD,GIGABEAT_PAD%
+        ,MROBE100_PAD}{\ButtonPower}
         & Exit text viewer\\
+
     \end{btnmap}
 \end{table}
 
+\subsubsection{The Viewer's Menu}
+
+\begin{description}
+\item[Quit] Exits the plugin.
+\item[Viewer Options]
+    \begin{description}
+    \item[Encoding]
+    sets the codepage in the text viewer.
+% ToDo: wrap some of the following settings into a \opt{lcd_bitmap} to exlude
+% ones that don't work on charcell - as soon as the plugin itself does
+    Available settings:
+    \setting{UTF-8} (Unicode),
+    \setting{BIG5} (Traditional Chinese),
+    \setting{KSX-1001} (Korean),
+    \setting{GB-2312} (Simple Chinese),
+    \setting{SJIS} (Japanese),
+    \setting{CP1250} (Central European),
+    \setting{ISO-8859-2} (Latin Extended),
+    \setting{ISO-8859-9} (Turkish),
+    \setting{ISO-8859-6} (Arabic),
+    \setting{ISO-8859-11} (Thai),
+    \setting{CP1251} (Cyrillic),
+    \setting{ISO-8859-8} (Hebrew),
+    \setting{ISO-8859-7} (Greek),
+    \setting{ISO-8859-1} (Latin 1).
+    This setting only applies to the plugin and is independent from the
+    \setting{Default Codepage} setting (see \reference{ref:Defaultcodepage}).
+    \item[Word Wrap] toggles between Wrap and Chop.
+        \begin{description}
+            \item[Off (Chop Words)] breaks lines at white space or hyphen.
+            \item[On] breaks lines at the maximum column limit.
+        \end{description}
+    \item[Line Mode] cycles through Normal, Join and Expand and Reflow Lines.
+        \begin{description}
+            \opt{lcd_bitmap}{
+            \item[Reflow Lines] justifies the text fully.
+            }
+            \item[Expand] adds a blank line. Useful for making the paragraphs
+            clearer in some book style text files.
+            \item[Join] joins lines. Useful for adopting the orphans that
+            occur with e{}-mail style (i.e. pre{}-wrapped) text files.
+            \item[Normal] breaks lines at newline characters.
+        \end{description}
+    \item[Wide View] toggles between Narrow and Wide.
+        \begin{description}
+            \item[Yes] sets maximum column to 114. Useful for navigating large files.
+            (Currently, Wide and Join cannot be selected together.)
+            \item[No (Narrow)] sets maximum column to the screen width.
+        \end{description}
+    \opt{lcd_bitmap}{
+    \item[Show Scrollbar] toggles scrollbar for the current View mode. If the
+    file fits on one screen, there is no scrollbar and toggling this setting
+    has no effect.
+        \begin{description}
+            \item[On] has a scrollbar by default, until toggled.
+            \item[Off] has no scrollbar by default, until toggled.
+        \end{description}
+    \item[Overlap Pages] toggles between Normal and Overlap.
+        \begin{description}
+            \item[Yes] tells page{}-down/page{}-up to retain one line from previous screen.
+            \item[No] sets page{}-down/page{}-up to one full screen.
+        \end{description}
+    }
+    \item[Scroll Mode] controls the function of the ``Scroll-up'' and
+    ``Scroll-down'' buttons.
+        \begin{description}
+            \item[Scroll by Line]
+            \item[Scroll by Page]
+        \end{description}
+    \item[Auto-scroll Speed]
+    controls the speed of auto-scrolling in number of lines per scroll step,
+    available options are \setting{1} to \setting{10} lines. As an example,
+    a setting of \setting{4} will scroll up the text four lines per second.
+    \end{description}
+
+\item[Show Playback Menu] controls the playback of the currently loaded playlist
+and change the volume of your \dap without leaving the plugin.
+\item[Return] to the text view.
+\end{description}
+
+\note{The text viewer automatically saves its settings and also stores the
+current position in the viewed text files (up to the last 46 files).}
+
 \subsubsection{Compatibility}
 
 \begin{itemize}
-\item Correctly reads plain text files in Unix, Win/DOS, or Macintosh
-format. Latin{}-alphabet Unicode files are  \emph{almost} readable.
-\item Currently prefers fixed{}-width fonts. With proportional fonts,
-pretends all characters are the width of a lower{}-case `o'.
-\item Currently messages are in English 
+\item Currently messages are in English
 \item Does not currently support right{}-to{}-left languages.
 \end{itemize}