summaryrefslogtreecommitdiff
path: root/manual/plugins/text_viewer.tex
diff options
context:
space:
mode:
Diffstat (limited to 'manual/plugins/text_viewer.tex')
-rw-r--r--manual/plugins/text_viewer.tex155
1 files changed, 88 insertions, 67 deletions
diff --git a/manual/plugins/text_viewer.tex b/manual/plugins/text_viewer.tex
index 60ef396993..f35994dac3 100644
--- a/manual/plugins/text_viewer.tex
+++ b/manual/plugins/text_viewer.tex
@@ -2,111 +2,132 @@
2This is a Viewer for text files with word wrap. Just open a .txt file to 2This is a Viewer for text files with word wrap. Just open a .txt file to
3display it. The text vewer features controls to handle various styles of text 3display it. The text vewer features controls to handle various styles of text
4formatting, has top{}-of{}-file and bottom{}-of{}-file buttons. You can view 4formatting, has top{}-of{}-file and bottom{}-of{}-file buttons. You can view
5files without a \fname{.txt} extension by using \textbf{Open with} from the 5files without a \fname{.txt} extension by using \emph{Open with} from the
6\textbf{File Menu} (see page \pageref{ref:Filemenu}). 6\emph{File Menu} (see page \pageref{ref:Filemenu}).
7 7
8\subsubsection{Mode settings} 8\subsubsection{Mode settings}
9 9
10\begin{itemize} 10\begin{description}
11\item\textbf{Word mode} toggles between Wrap and Chop. 11\item[Word mode] toggles between Wrap and Chop.
12 \begin{itemize} 12 \begin{description}
13 \item\textbf{Wrap} breaks lines at white space or hyphen. 13 \item[Wrap] breaks lines at white space or hyphen.
14 \item\textbf{Chop} breaks lines at the maximum column limit. 14 \item[Chop] breaks lines at the maximum column limit.
15 \end{itemize} 15 \end{description}
16\item\textbf{Line mode} cycles through Normal, Join and Expand. 16\item[Line mode] cycles through Normal, Join and Expand.
17 \begin{itemize} 17 \begin{description}
18 \item\textbf{Normal} breaks lines at newline characters. 18 \item[Normal] breaks lines at newline characters.
19 \item\textbf{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. 19 \item[Join] ignores unpaired newline characters (i.e., joins lines).
20 \item\textbf{Expand} doubles unpaired newlines (i.e., adds a blank line). Useful for making the paragraphs clearer in some book style text files. 20 Useful for adopting the orphans that occur with e{}-mail style
21 \end{itemize} 21 (i.e.,pre{}-wrapped) text files.
22\item\textbf{View mode} toggles between Narrow and Wide. 22 \item[Expand] doubles unpaired newlines (i.e., adds a blank line).
23 \begin{itemize} 23 Useful for making the paragraphs clearer in some book style text files.
24 \item\textbf{Narrow} sets maximum column to the screen width. 24 \end{description}
25 \item\textbf{Wide} sets maximum column to 114. Useful for navigating large files. (Currently, Wide and Join cannot be selected together.) 25\item[View mode] toggles between Narrow and Wide.
26 \end{itemize} 26 \begin{description}
27 \item[Narrow] sets maximum column to the screen width.
28 \item[Wide] sets maximum column to 114. Useful for navigating large files. (Currently, Wide and Join cannot be selected together.)
29 \end{description}
27\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD}{ 30\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD}{
28\item\textbf{Page mode} toggles between Normal and Overlap. 31\item[Page mode] toggles between Normal and Overlap.
29 \begin{itemize} 32 \begin{description}
30 \item\textbf{Normal} sets page{}-down/page{}-up to one full screen. 33 \item[Normal] sets page{}-down/page{}-up to one full screen.
31 \item\textbf{Overlap} tells page{}-down/page{}-up to retain one line from previous screen. 34 \item[Overlap] tells page{}-down/page{}-up to retain one line from previous screen.
32 \end{itemize} 35 \end{description}
33\item\textbf{Scrollbar mode} toggles scrollbar for the current View mode. 36\item[Scrollbar mode] toggles scrollbar for the current View mode.
34 \begin{itemize} 37 \begin{description}
35 \item\textbf{Narrow mode} has no scrollbar by default, until toggled. 38 \item[Narrow mode] has no scrollbar by default, until toggled.
36 \item\textbf{Wide mode} has a scrollbar by default, until toggled. 39 \item[Wide mode] has a scrollbar by default, until toggled.
37 \end{itemize} 40 \end{description}
38} 41}
39\end{itemize} 42\end{description}
40Settings are not remembered after the viewer has been exited. 43Settings are not remembered after the viewer has been exited.
41\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD}{ 44\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD}{
42If file fits on one screen, there is no scrollbar and toggling Scrollbar mode has no effect.} 45If file fits on one screen, there is no scrollbar and toggling Scrollbar mode has no effect.}
43 46
44\begin{table}[ht!] 47\begin{table}
45 \begin{center} 48 \begin{btnmap}{}{}
46 \begin{tabular}{ll}\toprule 49 \opt{PLAYER_PAD}{\ButtonLeft}
47 \textbf{Key} & \textbf{Action}\\\midrule 50 \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{\ButtonUp}
48 \opt{PLAYER_PAD}{\ButtonLeft}\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD} 51 \opt{IPOD_4G_PAD}{\ButtonScrollBack}
49 {\ButtonUp}\opt{IPOD_4G_PAD}{\ButtonScrollBack} & Page{}-up (one screen up)\\ 52 & Page{}-up (one screen up)\\
50 53
51 \opt{PLAYER_PAD}{\ButtonRight}\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD} 54 \opt{PLAYER_PAD}{\ButtonRight}
52 {\ButtonDown}\opt{IPOD_4G_PAD}{\ButtonScrollFwd} & Page{}-down (one screen down)\\ 55 \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{\ButtonDown}
56 \opt{IPOD_4G_PAD}{\ButtonScrollFwd}
57 & Page{}-down (one screen down)\\
53 58
54 \opt{PLAYER_PAD}{\ButtonMenu+\ButtonLeft} 59 \opt{PLAYER_PAD}{\ButtonMenu+\ButtonLeft}
55 \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IAUDIO_X5_PAD} 60 \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IAUDIO_X5_PAD}{\ButtonLeft}
56 {\ButtonLeft} & Top of file (Narrow mode) One screen left (Wide mode)\\ 61 & Top of file (Narrow mode) One screen left (Wide mode)\\
57 62
58 \opt{PLAYER_PAD}{\ButtonMenu+\ButtonRight} 63 \opt{PLAYER_PAD}{\ButtonMenu+\ButtonRight}
59 \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IAUDIO_X5_PAD} 64 \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD,IPOD_4G_PAD,IAUDIO_X5_PAD}
60 {\ButtonRight} & Bottom of file (Narrow mode) One screen right (Wide mode)\\ 65 {\ButtonRight}
66 & Bottom of file (Narrow mode) One screen right (Wide mode)\\
61 67
62 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonUp & One line up\\} 68 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}
69 {\ButtonOn+\ButtonUp & One line up\\}
63 70
64 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonDown & One line down\\} 71 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}
72 {\ButtonOn+\ButtonDown & One line down\\}
65 73
66 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonLeft & One column left\\} 74 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}
75 {\ButtonOn+\ButtonLeft & One column left\\}
67 76
68 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonRight & One column right\\} 77 \opt{RECORDER_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}
78 {\ButtonOn+\ButtonRight & One column right\\}
69 79
70 \opt{PLAYER_PAD}{\ButtonOn+\ButtonLeft}\opt{RECORDER_PAD}{\ButtonFOne} 80 \opt{PLAYER_PAD}{\ButtonOn+\ButtonLeft}
71 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonLeft}\opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonRec} 81 \opt{RECORDER_PAD}{\ButtonFOne}
72 \opt{IPOD_4G_PAD}{\ButtonSelect+\ButtonLeft}\opt{IAUDIO_X5_PAD}{\ButtonPlay} 82 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonLeft}
83 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonRec}
84 \opt{IPOD_4G_PAD}{\ButtonSelect+\ButtonLeft}\opt{IAUDIO_X5_PAD}{\ButtonPlay}
73 & Toggles Word mode\\ 85 & Toggles Word mode\\
74 86
75 \opt{PLAYER_PAD}{\ButtonOn+\ButtonMenu+\ButtonRight}\opt{RECORDER_PAD}{\ButtonFTwo} 87 \opt{PLAYER_PAD}{\ButtonOn+\ButtonMenu+\ButtonRight}
76 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonUp}\opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode} 88 \opt{RECORDER_PAD}{\ButtonFTwo}
77 \opt{IPOD_4G_PAD}{\ButtonSelect+\ButtonPlay}\opt{IAUDIO_X5_PAD}{Long press on \ButtonPlay} 89 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonUp}
90 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonMode}
91 \opt{IPOD_4G_PAD}{\ButtonSelect+\ButtonPlay}
92 \opt{IAUDIO_X5_PAD}{Long press on \ButtonPlay}
78 & Cycles line mode\\ 93 & Cycles line mode\\
79 94
80 \opt{PLAYER_PAD}{\ButtonOn+\ButtonRight}\opt{RECORDER_PAD}{\ButtonFThree} 95 \opt{PLAYER_PAD}{\ButtonOn+\ButtonRight}
81 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonRight}\opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{\ButtonSelect} 96 \opt{RECORDER_PAD}{\ButtonFThree}
82 \opt{IPOD_4G_PAD}{\ButtonSelect+\ButtonRight} 97 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonRight}
98 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD,IAUDIO_X5_PAD}{\ButtonSelect}
99 \opt{IPOD_4G_PAD}{\ButtonSelect+\ButtonRight}
83 & Toggles view mode\\ 100 & Toggles view mode\\
84 101
85 \opt{RECORDER_PAD}{\ButtonOn+\ButtonFOne & Toggles page mode\\} 102 \opt{RECORDER_PAD}{\ButtonOn+\ButtonFOne & Toggles page mode\\}
86 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonDown & Toggles page mode\\} 103 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonDown & Toggles page mode\\}
87 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonMode & Toggles page mode\\} 104 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}
88 \opt{IPOD_4G_PAD}{\ButtonSelect+\ButtonMenu+\ButtonLeft & Toggles page mode\\} 105 {\ButtonOn+\ButtonMode & Toggles page mode\\}
106 \opt{IPOD_4G_PAD}
107 {\ButtonSelect+\ButtonMenu+\ButtonLeft & Toggles page mode\\}
89 108
90 \opt{RECORDER_PAD}{\ButtonOn+\ButtonFThree & Toggles scrollbar mode\\} 109 \opt{RECORDER_PAD}{\ButtonOn+\ButtonFThree & Toggles scrollbar mode\\}
91 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonOff & Toggles scrollbar mode\\} 110 \opt{ONDIO_PAD}{\ButtonMenu+\ButtonOff & Toggles scrollbar mode\\}
92 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOn+\ButtonRec & Toggles scrollbar mode\\} 111 \opt{IRIVER_H100_PAD,IRIVER_H300_PAD}
93 \opt{IPOD_4G_PAD}{\ButtonSelect+\ButtonLeft+\ButtonRight & Toggles scrollbar mode\\} 112 {\ButtonOn+\ButtonRec & Toggles scrollbar mode\\}
113 \opt{IPOD_4G_PAD}
114 {\ButtonSelect+\ButtonLeft+\ButtonRight & Toggles scrollbar mode\\}
94 115
95 \opt{PLAYER_PAD}{\ButtonStop}\opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD} 116 \opt{PLAYER_PAD}{\ButtonStop}
96 {\ButtonOff}\opt{IPOD_4G_PAD}{\ButtonMenu}\opt{IAUDIO_X5_PAD}{\ButtonPower} 117 \opt{RECORDER_PAD,ONDIO_PAD,IRIVER_H100_PAD,IRIVER_H300_PAD}{\ButtonOff}
97 & Exit text viewer\\\bottomrule 118 \opt{IPOD_4G_PAD}{\ButtonMenu}
98 \end{tabular} 119 \opt{IAUDIO_X5_PAD}{\ButtonPower}
99 \end{center} 120 & Exit text viewer\\
121 \end{btnmap}
100\end{table} 122\end{table}
101 123
102\subsubsection{Compatibility} 124\subsubsection{Compatibility}
103 125
104\begin{itemize} 126\begin{itemize}
105\item Correctly reads plain text files in Unix, Win/DOS, or Macintosh 127\item Correctly reads plain text files in Unix, Win/DOS, or Macintosh
106format. Latin{}-alphabet Unicode files are a l m o s t r e a d a b l 128format. Latin{}-alphabet Unicode files are \emph{almost} readable.
107e.
108\item Currently prefers fixed{}-width fonts. With proportional fonts, 129\item Currently prefers fixed{}-width fonts. With proportional fonts,
109pretends all characters are the width of a lower{}-case 'o'. 130pretends all characters are the width of a lower{}-case `o'.
110\item Currently messages are in English 131\item Currently messages are in English
111\item Does not currently support right{}-to{}-left languages. 132\item Does not currently support right{}-to{}-left languages.
112\end{itemize} 133\end{itemize}