about summary refs log tree commit diff stats
path: root/lynx_help/keystrokes/option_help.html
blob: 69d7c8c9e588012ea9bb3a150f98a789ab7dc024 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN">
<HTML>
<HEAD>
<TITLE>Options Screen Help</TITLE>
<LINK rev="made" href="mailto:lynx-dev@sig.net">
</HEAD>
<BODY>
<h1>+++ Options Screen Help +++</h1>
<PRE>
        The Options Screen allows you to set and
        modify many of Lynx's features. The following
        options may be set.

     Editor             -  If non-empty it defines the editor to spawn
                           when editing a local file or sending mail.
                           Any valid text editor may be entered here.

     DISPLAY variable   -  If non-empty it specifies your <A HREF="xterm_help.html">X terminal</A>
                           display address.

     Multi-bookmarks    -  When OFF, the default bookmark file is used
                           for the 'v'iew bookmarks and 'a'dd bookmark
                           link commands.  If set to STANDARD, a menu
                           of available bookmarks always is invoked
                           when you seek to view a bookmark file or add
                           a link, and you select the bookmark file by
                           its letter token in that menu.  If set to
                           ADVANCED, you instead are prompted for the
                           letter of the desired bookmark file, but can
                           enter '=' to invoke the STANDARD selection
                           menu, or RETURN for the default bookmark file.

     Bookmark file      -  If non-empty and multi-bookmarks is OFF, it
                           specifies your default '<A HREF="bookmark_help.html">Bookmark file</A>'.
                           If multi-bookmarks is STANDARD or ADVANCED,
                           entering 'B' will invoke a menu in which you
                           can specify the filepaths and descriptions
                           of up to 26 bookmark files.  The filepaths
                           must be from your home directory, and begin
                           with dot-slash (./) if subdirectories are
                           included (e.g, ./BM/lynx_bookmarks.html).
                           Lynx will create bookmark files when you
                           first 'a'dd a link, but any subdirectories
                           in the filepath must already exist.

     FTP sort criteria  -  This option allows you to specify how files
                           will be sorted within FTP listings.  The
                           current options include "By Filename",
                           "By Size", "By Type", and "By Date".

     Personal Mail      -  You may set your mail address here so that
     Address               when mailing messages to other people or
                           mailing files to yourself, your email address
                           can be automatically filled in.  Your email
                           address will also be sent to HTTP servers in
                           a from: field.

     Searching type     -  If set to 'case sensitive', user searches
                           invoked by the '/' command will be case
                           sensitive substring searches.  The
                           default is 'Case Insensitive' substring
                           searches

     Preferred Document -  The language you prefer if multi-language files
     Language              are available from servers.  Use RFC 1766 tags,
                           e.g., en for English, fr for French, etc.  Can be
                           a comma-separated list, which may be interpreted
                           by servers as descending order of preferences.
                           You can also make your order of preference explicit
                           by using q factors as defined by the HTTP protocol,
                           for servers which understand it, for example:
                                <kbd>da, en-gb;q=0.8, en;q=0.7</kbd>

     Preferred Document -  The character set you prefer if sets in addition
     Charset               to ISO-8859-1 and US-ASCII are available from
                           servers.  Use MIME notation (e.g., ISO-8859-2)
                           and do not include ISO-8859-1 or US-ASCII, since
                           those values are always assumed by default.  Can
                           be a comma-separated list, which may be interpreted
                           by servers as descending order of preferences.
                           You can also make your order of preference explicit
                           by using q factors as defined by the HTTP protocol,
                           for servers which understand it, for example:
                                <kbd>iso-8859-5, utf-8;q=0.8</kbd>

     Display Character  -  This option allows you to set up the default
     set                   character set for your specific terminal. The
                           display character set provides a mapping from the
                           character encodings of viewed documents and from
                           HTML entities into viewable characters. It should
                           be set according to your terminal's character set
                           so that characters other than 7-bit ASCII can be
                           displayed correctly, using approximations if
                           necessary. You must have the selected character set
                           installed on your terminal. (Since Lynx now supports
			   a wide range of platforms it may be useful to note
			   that cpXXX codepages are used within IBM PC
			   computers, and windows-xxxx within native MS-Windows
			   applications).

     Raw 8-bit or CJK   -  This option set automatically but can be toggled
     mode                  manually in certain special cases:
                           it toggles whether 8-bit characters are assumed to
                           correspond with the display character set and
                           therefore are processed without translation via the
                           chartrans conversion tables. ON by default when the
                           display character set is one of the Asian (CJK)
                           sets and the 8-bit characters are Kanji multibytes.
                           OFF for the other display character sets, but can
                           be turned ON when the document's charset is unknown
                           (e.g., is not ISO-8859-1 and no charset parameter
                           was specified in a reply header from an HTTP server
                           to indicate what it is) but you have no better idea
                           than viewing it as from display character set (see
                           also 'assumed document character set' for best
                           choice).  Should be OFF when an Asian (CJK) set is
                           selected but the document is ISO-8859-1 or another
                           'assumed document character set'. The setting also
                           can be toggled via the RAW_TOGGLE command, normally
                           mapped to '@', and at startup via the -raw switch.

     Assumed document   -  This option changes the handling of documents
     character set         which do not explicitly specify a charset.
                           Normally Lynx assumes that 8-bit characters in
                           those documents are encoded according to iso-8859-1
                           (the official default for the HTTP protocol).
                           Unfortunately, many non-English web pages "forget"
                           to include proper charset info; this option helps
                           you to browse those broken pages if you know by
                           some means what the charset is.  When the value
                           given here or by an -assume_charset command line
                           flag is in effect, Lynx will treat documents as if
                           they were encoded accordingly. This option active
                           when 'Raw 8-bit or CJK Mode' is OFF.

     Show color        -   This option will be present if color support is
                           available.  If set to ON or ALWAYS, color mode will
                           be forced on if possible.  If (n)curses color
                           support is available but cannot be used for the
                           current terminal type, selecting ON is rejected
                           with a message.  If set to OFF or NEVER, color mode
                           will be turned off.
                           ALWAYS and NEVER are not offered in anonymous
                           accounts.  If saved to a '.lynxrc' file in
                           non-anonymous accounts, ALWAYS will cause Lynx to
                           set color mode on at startup if supported.  If Lynx
                           is built with the slang library, this is equivalent
                           to having included the -color command line switch
                           or having the COLORTERM environment variable
                           set. If color support is provided by curses or
                           ncurses, this is equivalent to the default behavior
                           of using color when the terminal type supports it.
                           If (n)curses color support is available but cannot
                           be used for the current terminal type, the
                           preference can still be saved but will have no
                           effect.
                           A saved value of NEVER will cause Lynx to assume a
                           monochrome terminal at startup.  It is similar to
                           the -nocolor switch, but (when the slang library is
                           used) can be overridden with the -color switch.
                           If the setting is OFF or ON when the current
                           options are saved to a '.lynxrc' file, the default
                           startup behavior is retained, such that color mode
                           will be turned on at startup only if the terminal
                           info indicates that you have a color-capable
                           terminal, or (when the slang library is used) if
                           forced on via the -color switch or COLORTERM
                           variable.  This default behavior always is used in
                           anonymous accounts, or if the 'option'_save
                           restriction is set explicitly.  If for any reason
                           the startup color mode is incorrect for your
                           terminal, set it appropriately on or off via this
                           option.

     VI keys           -   If set to 'ON' then the lowercase h, j, k, and l,
                           keys will be mapped to left-arrow, down-arrow,
                           up-arrow, and right-arrow, respectively.  The
                           uppercase H, J, K, and L keys remain mapped to
                           their configured bindings (normally HELP, JUMP,
                           KEYMAP, and LIST, respectively).

     Emacs keys        -   If set to 'ON' then the CTRL-P, CTRL-N, CTRL-F,
                           and CTRL-B keys will be mapped to up-arrow,
                           down-arrow, right-arrow,  and left-arrow,
                           respectively.  Otherwise, they remain mapped
                           to their configured bindings (normally UP_TWO
                           lines, DOWN_TWO lines, NEXT_PAGE, and PREV_PAGE,
                           respectively).

     Show dot files    -   If display/creation of hidden (dot)
                           files/directories is enabled, you can turn
                           the feature on or off via this setting.

     Popups for select -   Lynx normally uses a popup window for the
     fields                OPTIONs in form SELECT fields when the field
                           does not have the MULTIPLE attribute specified,
                           and thus only one OPTION can be selected.  The
                           use of popup windows can be disabled by changing
                           this setting to OFF, in which case the OPTIONs
                           will be rendered as a list of radio buttons.
                           Note that if the SELECT field does have the
                           MULTIPLE attribute specified, the OPTIONs always
                           are rendered as a list of checkboxes.

     Show cursor for   -   Lynx normally hides the cursor by positioning it
     current link or       to the right and if possible the very bottom of
     option                the screen, so that the current link or OPTION
                           is indicated solely by its highlighting or color.
                           If show cursor is set to ON, the cursor will be
                           positioned at the left of the current link or
                           OPTION.  This is helpful when Lynx is being used
                           with a speech or braille interface.  It also is
                           useful for sighted users when the terminal cannot
                           distinguish the character attributes used to
                           distinguish the current link or OPTION from the
                           others in the screen display.

     Keypad mode       -   This option gives the choice between navigating
                           with the keypad (as arrows; see Lynx Navigation)
                           and having every link numbered (numbered links)
                           so that the links may be selected by numbers
                           instead of moving to them with the arrow keys.

     Line edit style   -   This option allows you to set alternate key
                           bindings for the built-in line editor, if your
                           system administrator has installed alternates.
                           Otherwise, Lynx uses the <A HREF="edit_help.html">Default Binding</A>.

     List directory    -   Applies to Directory Editing.  Files and
     style                 directories can be presented in the following
                           ways:
                            Mixed style
                              Files and directories are listed together in
                              alphabetical order.
                            Directories first
                              Files and directories are separated into two
                              alphabetical lists.  Directories are listed
                              first.
                            Files first
                              Files and directories are separated into two
                              alphabetical lists.  Files are listed first.

     User Mode         -   Novice
                              Shows two extra lines of help at the bottom
                              of the screen for beginners
                           Intermediate (normal mode)
                              The "normal" statusline messages appear.
                           Advanced
                              The URL is shown on the statusline.

     Verbose Images    -   Controls whether or not Lynx replaces the [LINK],
                           [INLINE] and [IMAGE] comments (for images without
                           ALT) with filenames of these images.  This is
                           extremely useful because now we can determine
                           immediately what images are just decorations
                           (button.gif, line.gif) and what images are
                           important.

     User Agent        -   The header string which Lynx sends to servers
                           to indicate the User-Agent is displayed here.
                           Changes may be disallowed via the -restrictions
                           switch.  Otherwise, the header can be changed
                           temporarily to a string such as L_y_n_x/2.8.1 for
                           access to sites which discriminate against Lynx
                           based on checks for the presence of "Lynx" in the
                           header. If changed during a Lynx session, the
                           default User-Agent header can be restored by
                           deleting the modified string in the Options Menu.
                           Whenever the User-Agent header is changed, the
                           current document is reloaded, with the no-cache
                           flags set, on exit from the Options Menu.  Changes
                           of the header are not saved in the RC file.
                           NOTE that Netscape Communications Corp. has
                           claimed that false transmissions of "Mozilla" as
                           the User-Agent are a copyright infringement, which
                           will be prosecuted.  DO NOT misrepresent Lynx as
                           Mozilla.  The Options Menu issues a warning about
                           possible copyright infringement whenever the header
                           is changed to one which does not include "Lynx" or
                           "lynx".

     Local execution   -   If set to 'ALWAYS ON', Lynx will locally execute
     links                 commands contained inside of any links.  This
                           can be HIGHLY DANGEROUS so it is recommended
                           that they remain 'ALWAYS OFF' or 'FOR LOCAL
                           FILES ONLY' unless otherwise set by your system
                           administrator.  This option may not be available
                           on most versions of Lynx.

</PRE>
</BODY>
</HTML>