diff options
Diffstat (limited to 'manual/plugins/text_viewer.tex')
-rw-r--r-- | manual/plugins/text_viewer.tex | 155 |
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 @@ | |||
2 | This is a Viewer for text files with word wrap. Just open a .txt file to | 2 | This is a Viewer for text files with word wrap. Just open a .txt file to |
3 | display it. The text vewer features controls to handle various styles of text | 3 | display it. The text vewer features controls to handle various styles of text |
4 | formatting, has top{}-of{}-file and bottom{}-of{}-file buttons. You can view | 4 | formatting, has top{}-of{}-file and bottom{}-of{}-file buttons. You can view |
5 | files without a \fname{.txt} extension by using \textbf{Open with} from the | 5 | files 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} |
40 | Settings are not remembered after the viewer has been exited. | 43 | Settings 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}{ |
42 | If file fits on one screen, there is no scrollbar and toggling Scrollbar mode has no effect.} | 45 | If 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 |
106 | format. Latin{}-alphabet Unicode files are a l m o s t r e a d a b l | 128 | format. Latin{}-alphabet Unicode files are \emph{almost} readable. |
107 | e. | ||
108 | \item Currently prefers fixed{}-width fonts. With proportional fonts, | 129 | \item Currently prefers fixed{}-width fonts. With proportional fonts, |
109 | pretends all characters are the width of a lower{}-case 'o'. | 130 | pretends 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} |