wip update
[nyanlinux.git] / files / lynx.cfg.dev10
blob28af550f091c5dd899d5668afaaf129af97d3951
1 # $LynxId: lynx.cfg,v 1.324 2021/08/11 10:25:15 tom Exp $
2 # lynx.cfg file.
3 # The default placement for this file is /usr/local/lib/lynx.cfg (Unix)
4 #                                     or Lynx_Dir:lynx.cfg (VMS)
6 # $Format: "#PRCS LYNX_VERSION \"$ProjectVersion$\""$
7 #PRCS LYNX_VERSION "2.9.0dev.10"
9 # $Format: "#PRCS LYNX_DATE \"$ProjectDate$\""$
10 #PRCS LYNX_DATE "Wed, 11 Aug 2021 06:25:16 -0400"
12 # Definition pairs (configuration settings) are of the form
13 #       VARIABLE:DEFINITION
14 # NO spaces are allowed around the colon ":" between the pair items.
16 #  If you do not have write access to /usr/local/lib you may change
17 #  the default location of this file in the userdefs.h file and recompile,
18 #  or specify its location on the command line with the "-cfg"
19 #  command line option.
21 # Items may be commented out by putting a '#' as the FIRST char of the line
22 # (Any line beginning with punctuation is ignored).  Leading blanks on each
23 # line are ignored; trailing blanks may be significant depending on the option.
25 # In most cases, a definition can be overridden by another later in the
26 # file, or in an including configuration file.  You can see the effect of
27 # definitions (and redefinitions) in the trace file Lynx.log by using the
28 # "-trace" and "-trace-mask" options, e.g.,
29 #       lynx -trace -trace-mask=8
31 # As a documentation aid, the default values for each setting are shown
32 # commented-out.  By convention, these default value comments have no space
33 # after the "#", e.g.,
34 #       #HTTP_PROTOCOL:1.0
36 # An HTML'ized description of all settings (based on comments in this file,
37 # with alphabetical table of settings and with table of settings by category)
38 # is available at https://lynx.invisible-island.net/release/breakout/lynx_help/cattoc.html
40 ### The conversion is done via the scripts/cfg2html.pl script.
41 ### Several directives beginning with '.' are used for this purpose.
43 .h1 Auxiliary Facilities
44 # These settings control the auxiliary navigating facilities of lynx, e.g.,
45 # jumpfiles, bookmarks, default URLs.
47 .h2 INCLUDE
48 # Starting with Lynx 2.8.1, the lynx.cfg file has a crude "include"
49 # facility.  This means that you can take advantage of the global lynx.cfg
50 # while also supplying your own tweaks.
52 # You can use a command-line argument (-cfg /where/is/lynx.cfg) or an
53 # environment variable (LYNX_CFG=/where/is/lynx.cfg).
54 # For instance, put in your .profile or .login:
56 #   LYNX_CFG=~/lynx.cfg; export LYNX_CFG   # in .profile for sh/ksh/bash/etc.
57 #   setenv LYNX_CFG ~/lynx.cfg             # in .login for [t]csh
59 # Then in ~/lynx.cfg:
61 #   INCLUDE:/usr/local/lib/lynx.cfg
62 #           ^^^^^^^^^^^^^^^^^^^^^^^ or whatever is appropriate on your system
63 # and now your own tweaks.  If you omit the directory name, e.g.,
65 #   INCLUDE:lynx.cfg
67 # then lynx first checks if it is in any of the directories listed in the
68 # environment variable LYNX_CFG_PATH, then tries the directory of the default
69 # config-file.
71 # You can also suppress all but specific settings that will be read from
72 # included files.  This allows sysadmins to provide users the ability to
73 # customize lynx with options that normally do not affect security, such as
74 # COLOR, VIEWER, KEYMAP.
76 # The syntax is
78 #   INCLUDE:filename for <space-separated-list-of-allowed-settings>
80 # sample:
81 .ex
82 #INCLUDE:~/lynx.cfg for COLOR VIEWER KEYMAP
83 # only one space character should surround the word 'for'.  On Unix systems ':'
84 # is also accepted as separator.  In that case, the example can be written as
85 .ex
86 #INCLUDE:~/lynx.cfg:COLOR VIEWER KEYMAP
87 # In the example, only the settings COLOR, VIEWER and KEYMAP are accepted by
88 # lynx.  Other settings are ignored.  Note:  INCLUDE is also treated as a
89 # setting, so to allow an included file to include other files, put INCLUDE in
90 # the list of allowed settings.
92 # If you allow an included file to include other files, and if a list of
93 # allowed settings is specified for that file with the INCLUDE command, nested
94 # files are only allowed to include the list of settings that is the set AND of
95 # settings allowed for the included file and settings allowed by nested INCLUDE
96 # commands.  In short, there is no security hole introduced by including a
97 # user-defined configuration file if the original list of allowed settings is
98 # secure.
100 .h2 STARTFILE
101 # STARTFILE is the default starting URL if none is specified
102 #   on the command line or via a WWW_HOME environment variable;
103 #   Lynx will refuse to start without a starting URL of some kind.
104 # STARTFILE can be remote, e.g. http://www.w3.org/default.html ,
105 #                or local, e.g. file://localhost/PATH_TO/FILENAME ,
106 #           where PATH_TO is replaced with the complete path to FILENAME
107 #           using Unix shell syntax and including the device on VMS.
109 # Normally we expect you will connect to a remote site, e.g., the Lynx starting
110 # site:
111 STARTFILE:https://lynx.invisible-island.net/
113 # As an alternative, you may want to use a local URL.  A good choice for this is
114 # the user's home directory:
116 #STARTFILE:file://localhost/~/
118 # Your choice of STARTFILE should reflect your site's needs, and be a URL that
119 # you can connect to reliably.  Otherwise users will become confused and think
120 # that they cannot run Lynx.
122 .h2 HELPFILE
123 # HELPFILE must be defined as a URL and must have a
124 # complete path if local:
125 # file://localhost/PATH_TO/lynx_help/lynx_help_main.html
126 #   Replace PATH_TO with the path to the lynx_help subdirectory
127 #   for this distribution (use SHELL syntax including the device
128 #   on VMS systems).
129 # The default HELPFILE is:
130 .url https://lynx.invisible-island.net/lynx_help/lynx_help_main.html
131 #   This should be changed to the local path.
132 # This definition will be overridden if the "LYNX_HELPFILE" environment
133 # variable has been set.
135 HELPFILE:https://lynx.invisible-island.net/lynx_help/lynx_help_main.html
137 #HELPFILE:file://localhost/PATH_TO/lynx_help/lynx_help_main.html
139 .h2 DEFAULT_INDEX_FILE
140 # DEFAULT_INDEX_FILE is the default file retrieved when the
141 # user presses the 'I' key when viewing any document.
142 # An index to your CWIS can be placed here or a document containing
143 # pointers to lots of interesting places on the web.
145 DEFAULT_INDEX_FILE:http://scout.wisc.edu/
147 .h1 Interaction
149 .h2 GOTOBUFFER
150 # Set GOTOBUFFER to TRUE if you want to have the previous goto URL,
151 # if any, offered for reuse or editing when using the 'g'oto command.
152 # The default is defined in userdefs.h.  If left FALSE, the circular
153 # buffer of previously entered goto URLs can still be invoked via the
154 # Up-Arrow or Down-Arrow keys after entering the 'g'oto command.
156 #GOTOBUFFER:FALSE
158 .h2 JUMP_PROMPT
159 # JUMP_PROMPT is the default statusline prompt for selecting a jumps file
160 # shortcut.  (see below).
161 # You can change the prompt here from that defined in userdefs.h.  Any
162 # trailing white space will be trimmed, and a single space is added by Lynx
163 # following the last non-white character.  You must set the default prompt
164 # before setting the default jumps file (below).  If a default jumps file
165 # was set via userdefs.h, and you change the prompt here, you must set the
166 # default jumps file again (below) for the change to be implemented.
168 #JUMP_PROMPT:Jump to (use '?' for list):
170 .h1 Auxiliary Facilities
172 .h2 JUMPFILE
173 # JUMPFILE is the local file checked for short-cut names for URLs when
174 # the user presses the 'j' (JUMP) key.  The file contains an HTML
175 # definition list (DL).  The definition titles (DT) are used as
176 # short-cut name; the definition data (DD) are URLs.
178 # There is an example jumps file in the samples subdirectory.
180 # After pressing 'j', the user will be prompted to enter a short-cut
181 # name for an URL, which Lynx will then follow in a similar manner to
182 # 'g'oto; alternatively, s/he can enter '?' to view the full JUMPFILE
183 # list of short-cuts with associated URLs.
185 # If the URL contains one or more "%s" markers, Lynx will prompt the user
186 # for text to fill in for each marker.  If no text is given, the jump is
187 # cancelled.
189 # If not defined here or in userdefs.h, the JUMP command will invoke the
190 # NO_JUMPFILE statusline message (see LYMessages_en.h ).
192 # To allow '?' to work, include in the JUMPFILE
193 # a short-cut to the JUMPFILE itself, e.g.
194 # <dt>?<dd><a href="file://localhost/path/jumps.html">This Shortcut List</a>
196 # On VMS, use Unix SHELL syntax (including a lead slash) to define it.
198 # Alternate jumps files can be defined and mapped to keys here.  If the
199 # keys have already been mapped, then those mappings will be replaced,
200 # but you should leave at least one key mapped to the default jumps
201 # file.  You optionally may include a statusline prompt string for the
202 # mapping.  You must map upper and lowercase keys separately (beware of
203 # mappings to keys which the user can further remap via the 'o'ptions
204 # menu).  The format is:
206 #       JUMPFILE:path:key[:prompt]
208 # where path should begin with a '/' (i.e., not include file://localhost).
209 # Any white space following a prompt string will be trimmed, and a single
210 # space will be added by Lynx.
212 # In the following line, include the actual full local path to JUMPFILE,
213 # but do not include 'file://localhost' in the line.
214 #JUMPFILE:/FULL_LOCAL_PATH/jumps.html
216 #JUMPFILE:/Lynx_Dir/ips.html:i:IP or Interest group (? for list):
218 .h2 JUMPBUFFER
219 # Set JUMPBUFFER to TRUE if you want to have the previous jump target,
220 # if any, offered for reuse or editing when using the 'J'ump command.
221 # The default is defined in userdefs.h.  If left FALSE, the circular
222 # buffer of previously entered targets (shortcuts) can still be invoked
223 # via the Up-Arrow or Down-Arrow keys after entering the 'J'ump command.
224 # If multiple jumps files are installed, the recalls of shortcuts will
225 # be specific to each file.  If Lynx was built with PERMIT_GOTO_FROM_JUMP
226 # defined, any random URLs used instead of shortcuts will be stored in the
227 # goto URL buffer, not in the shortcuts buffer(s), and the single character
228 # ':' can be used as a target to invoke the goto URL buffer (as if 'g'oto
229 # followed by Up-Arrow had been entered).
231 #JUMPBUFFER:FALSE
233 .h1 Internal Behavior
235 .h2 SAVE_SPACE
236 # If SAVE_SPACE is defined, it will be used as a path prefix for the
237 # suggested filename in "Save to Disk" operations from the 'p'rint or
238 # 'd'ownload menus.  On VMS, you can use either VMS (e.g., "SYS$LOGIN:")
239 # or Unix syntax (including '~' for the HOME directory).  On Unix, you
240 # must use Unix syntax.  If the symbol is not defined, or is zero-length
241 # (""), no prefix will be used, and only a filename for saving in the
242 # current default directory will be suggested.
243 # This definition will be overridden if a "LYNX_SAVE_SPACE" environment
244 # variable has been set on Unix, or logical has been defined on VMS.
246 #SAVE_SPACE:~/foo/
248 .h2 REUSE_TEMPFILES
249 # Lynx uses temporary files for (among other purposes) the content of
250 # various user interface pages.  REUSE_TEMPFILES changes the behavior
251 # for some of these temp files, among them pages shown for HISTORY,
252 # VLINKS, OPTIONS, INFO, PRINT, DOWNLOAD commands.
253 # If set to TRUE, the same file can be used multiple times for the same
254 # purpose.  If set to FALSE, a new filename is generated each time before
255 # rewriting such a page.  With TRUE, repeated invocation of these commands
256 # is less likely to push previous documents out of the cache of rendered
257 # texts (see also DEFAULT_CACHE_SIZE).  This is especially useful with
258 # intermittent (dialup) network connections, when it is desirable to
259 # continue browsing through the cached documents after disconnecting.
260 # With the default setting of FALSE, there can be more than one incarnation
261 # of e.g. the VLINKS page cached in memory (but still only the most recently
262 # generated one is kept as a file), resulting in sometimes less surprising
263 # behaviour when returning to such a page via HISTORY or PREV_DOC functions
264 # (most users will not encounter and notice this difference).
266 #REUSE_TEMPFILES:FALSE
268 .h2 LYNX_HOST_NAME
269 # If LYNX_HOST_NAME is defined here or in userdefs.h, it will be
270 # treated as an alias for the local host name in checks for URLs on
271 # the local host (e.g., when the -localhost switch is set), and this
272 # host name, "localhost", and HTHostName (the fully qualified domain
273 # name of the system on which Lynx is running) will all be passed as
274 # local.  A different definition here will override that in userdefs.h.
276 #LYNX_HOST_NAME:www.cc.ukans.edu
278 .h2 LOCALHOST_ALIAS
279 # localhost aliases
280 # Any LOCALHOST_ALIAS definitions also will be accepted as local when
281 # the -localhost switch is set.  These need not actually be local, i.e.,
282 # in contrast to LYNX_HOST_NAME, you can define them to trusted hosts at
283 # other Internet sites.
285 .ex 2
286 #LOCALHOST_ALIAS:gopher.server.domain
287 #LOCALHOST_ALIAS:news.server.domain
289 .h2 LOCAL_DOMAIN
290 # LOCAL_DOMAIN is used for a tail match with the ut_host element of
291 # the utmp or utmpx structure on systems with utmp capabilities, to
292 # determine if a user is local to your campus or organization when
293 # handling -restrictions=inside_foo or outside_foo settings for ftp,
294 # news, telnet/tn3270 and rlogin URLs.  An "inside" user is assumed
295 # if your system does not have utmp capabilities.  CHANGE THIS here
296 # if it was not changed in userdefs.h at compilation time.
298 #LOCAL_DOMAIN:ukans.edu
300 .h1 Session support
302 .h2 AUTO_SESSION
303 # If AUTO_SESSION is TRUE lynx will save/restore useful information about
304 # your browsing history when closing/starting current lynx session if
305 # no command-line session switches override this setting.
306 # This setting is useful only if SESSION_FILE is defined here or in the user's
307 # .lynxrc file.
309 #AUTO_SESSION:FALSE
311 .h2 SESSION_FILE
312 # SESSION_FILE defines the file name where lynx will store user sessions.
313 # This setting is used only when AUTO_SESSION is true.
314 # Note: the default setting will store/resume each session in a different
315 # folder under same file name (if that is allowed by operating system)
316 # when lynx is invoked from different directories.
317 # (The current working directory may be changed inside lynx)
319 # If you want to use the same session file wherever you invoke Lynx,
320 # enter the full path below, eg '/home/<username>/.lynx_session'.
322 # If you do not want this feature, leave the setting commented.
323 # Users can still customize SESSION_FILE and AUTO_SESSION via
324 # their .lynxrc file.
326 #SESSION_FILE:lynx_session
328 .h2 SESSION_LIMIT
329 # SESSION_LIMIT defines maximum number of:  searched strings, goto URLs,
330 # visited links and history entries which will be saved in session file.  The
331 # minimum allowed is 1, the maximum is 10000.
333 # For instance, if SESSION_LIMIT is 250, a per-session limit of 250 entries of
334 # searched strings, goto URLs, visited links and history entries will be saved
335 # in the session file.
337 # There is no fixed limit on the number of entries which can be restored;
338 # It is limited only by available memory.
340 #SESSION_LIMIT:250
342 .h1 Character Sets
344 .h2 CHARACTER_SET
345 # CHARACTER_SET defines the display character set, i.e., assumed to be
346 # installed on the user's terminal.  It determines which characters or strings
347 # will be used to represent 8-bit character entities within HTML.  New
348 # character sets may be defined as explained in the README files of the
349 # src/chrtrans directory in the Lynx source code distribution.  For Asian (CJK)
350 # character sets, it also determines how Kanji code will be handled.  The
351 # default is defined in userdefs.h and can be changed here or via the
352 # 'o'ptions menu.  The 'o'ptions menu setting will be stored in the user's RC
353 # file whenever those settings are saved, and thereafter will be used as the
354 # default.  For Lynx a "character set" has two names:  a MIME name (for
355 # recognizing properly labeled charset parameters in HTTP headers etc.), and a
356 # human-readable string for the 'O'ptions Menu (so you may find info about
357 # language or group of languages besides MIME name).  Not all 'human-readable'
358 # names correspond to exactly one valid MIME charset (example is "Chinese");
359 # in that case an appropriate valid (and more specific) MIME name should be
360 # used where required.  Well-known synonyms are also processed in the code.
362 # Raw (CJK) mode
364 # Lynx normally translates characters from a document's charset to display
365 # charset, using ASSUME_CHARSET value (see below) if the document's charset
366 # is not specified explicitly.  Raw (CJK) mode is OFF for this case.
367 # When the document charset is specified explicitly, that charset
368 # overrides any assumption like ASSUME_CHARSET or raw (CJK) mode.
370 # For the Asian (CJK) display character sets, the corresponding charset is
371 # assumed in documents, i.e., raw (CJK) mode is ON by default.  In raw CJK
372 # mode, 8-bit characters are not reverse translated in relation to the entity
373 # conversion arrays, i.e., they are assumed to be appropriate for the display
374 # character set.  The mode should be toggled OFF when an Asian (CJK) display
375 # character set is selected but the document is not CJK and its charset not
376 # specified explicitly.
378 # Raw (CJK) mode may be toggled by user via '@' (LYK_RAW_TOGGLE) key,
379 # the -raw command line switch or from the 'o'ptions menu.
381 # Raw (CJK) mode effectively changes the charset assumption about unlabeled
382 # documents.  You can toggle raw mode ON if you believe the document has a
383 # charset which does correspond to your Display Character Set.  On the other
384 # hand, if you set ASSUME_CHARSET the same as Display Character Set you get raw
385 # mode ON by default (but you get assume_charset=iso-8859-1 if you try raw mode
386 # OFF after it).
388 # Note that "raw" does not mean that every byte will be passed to the screen.
389 # HTML character entities may get expanded and translated, inappropriate
390 # control characters filtered out, etc.  There is a "Transparent" pseudo
391 # character set for more "rawness".
393 # Since Lynx now supports a wide range of platforms it may be useful to note
394 # the cpXXX codepages used by IBM PC compatible computers, and windows-xxxx
395 # used by native MS-Windows apps.  We also note that cpXXX pages rarely are
396 # found on Internet, but are mostly for local needs on DOS.
398 # Recognized character sets include:
401 #    string for 'O'ptions Menu          MIME name
402 #    ===========================        =========
403 #    7 bit approximations (US-ASCII)    us-ascii
404 #    Western (ISO-8859-1)               iso-8859-1
405 #    Western (ISO-8859-15)              iso-8859-15
406 #    Western (cp850)                    cp850
407 #    Western (windows-1252)             windows-1252
408 #    IBM PC US codepage (cp437)         cp437
409 #    DEC Multinational                  dec-mcs
410 #    Macintosh (8 bit)                  macintosh
411 #    NeXT character set                 next
412 #    HP Roman8                          hp-roman8
413 #    Chinese                            euc-cn
414 #    Japanese (EUC-JP)                  euc-jp
415 #    Japanese (Shift_JIS)               shift_jis
416 #    Korean                             euc-kr
417 #    Taipei (Big5)                      big5
418 #    Vietnamese (VISCII)                viscii
419 #    Eastern European (ISO-8859-2)      iso-8859-2
420 #    Eastern European (cp852)           cp852
421 #    Eastern European (windows-1250)    windows-1250
422 #    Latin 3 (ISO-8859-3)               iso-8859-3
423 #    Latin 4 (ISO-8859-4)               iso-8859-4
424 #    Baltic Rim (ISO-8859-13)           iso-8859-13
425 #    Baltic Rim (cp775)                 cp775
426 #    Baltic Rim (windows-1257)          windows-1257
427 #    Celtic (ISO-8859-14)               iso-8859-14
428 #    Cyrillic (ISO-8859-5)              iso-8859-5
429 #    Cyrillic (cp866)                   cp866
430 #    Cyrillic (windows-1251)            windows-1251
431 #    Cyrillic (KOI8-R)                  koi8-r
432 #    Arabic (ISO-8859-6)                iso-8859-6
433 #    Arabic (cp864)                     cp864
434 #    Arabic (windows-1256)              windows-1256
435 #    Greek (ISO-8859-7)                 iso-8859-7
436 #    Greek (cp737)                      cp737
437 #    Greek2 (cp869)                     cp869
438 #    Greek (windows-1253)               windows-1253
439 #    Hebrew (ISO-8859-8)                iso-8859-8
440 #    Hebrew (cp862)                     cp862
441 #    Hebrew (windows-1255)              windows-1255
442 #    Turkish (ISO-8859-9)               iso-8859-9
443 #    North European (ISO-8859-10)       iso-8859-10
444 #    Ukrainian Cyrillic (cp866u)        cp866u
445 #    Ukrainian Cyrillic (KOI8-U)        koi8-u
446 #    UNICODE (UTF-8)                    utf-8
447 #    RFC 1345 w/o Intro                 mnemonic+ascii+0
448 #    RFC 1345 Mnemonic                  mnemonic
449 #    Transparent                        x-transparent
452 # The value should be the MIME name of a character set recognized by
453 # Lynx (case insensitive).
454 # Find RFC 1345 at
455 .url http://tools.ietf.org/html/rfc1345
457 #CHARACTER_SET:iso-8859-1
459 .h2 LOCALE_CHARSET
460 # LOCALE_CHARSET overrides CHARACTER_SET if true, using the current locale to
461 # lookup a MIME name that corresponds, and use that as the display charset.
463 # It also modifies the default value for ASSUME_CHARSET; it does not override
464 # that setting.
466 # Note that while nl_langinfo(CODESET) itself is standardized, the return
467 # values and their relationship to the locale value is not.  GNU libiconv
468 # happens to give useful values, but other implementations are not guaranteed
469 # to do this.
470 #LOCALE_CHARSET:FALSE
472 .h2 HTML5_CHARSETS
473 # HTML5_CHARSETS is an alternative to ASSUME_CHARSET and ASSUME_LOCAL_CHARSET.
474 # Those assume by default that the character set of an HTML document is (as is
475 # standard in HTML4) ISO-8859-1, in the absence of locale information.
477 # HTML5 introduces a "compatibility" (sic) feature which assumes that the
478 # default is Windows 1252.  In the same way, it equates ISO-8859-4 and Windows
479 # 1254.  Finally, it also makes recommendations which selectively reinterpret
480 # the locale encoding.
482 # This option currently implements only the equating of ISO-8859-1 and Windows
483 # 1252.
485 #HTML5_CHARSETS:FALSE
487 .h2 ASSUME_CHARSET
488 # ASSUME_CHARSET changes the handling of documents which do not
489 # explicitly specify a charset.  Normally Lynx assumes that 8-bit
490 # characters in those documents are encoded according to iso-8859-1
491 # (the official default for the HTTP protocol).  When ASSUME_CHARSET
492 # is defined here or by an -assume_charset command line flag is in effect,
493 # Lynx will treat documents as if they were encoded accordingly.
494 # See above on how this interacts with "raw mode" and the Display
495 # Character Set.
496 # ASSUME_CHARSET can also be changed via the 'o'ptions menu but will
497 # not be saved as permanent value in user's .lynxrc file to avoid more chaos.
499 #ASSUME_CHARSET:iso-8859-1
501 .h2 ASSUMED_DOC_CHARSET_CHOICE
502 .h2 DISPLAY_CHARSET_CHOICE
503 # It is possible to reduce the number of charset choices in the 'O'ptions menu
504 # for "display charset" and "assumed document charset" fields via
505 # DISPLAY_CHARSET_CHOICE and ASSUMED_DOC_CHARSET_CHOICE settings correspondingly.
506 # Each of these settings can be used several times to define the set of possible
507 # choices for corresponding field. The syntax for the values is
509 #       string | prefix* | *
511 # where
513 #       'string' is either the MIME name of charset or it's full name (listed
514 #               either in the left or in the right column of table of
515 #               recognized charsets), case-insensitive - e.g.  'Koi8-R' or
516 #               'Cyrillic (KOI8-R)' (both without quotes),
518 #       'prefix' is any string, and such value will select all charsets having
519 #               the name with prefix matching given (case insensitive), i.e.,
520 #               for the charsets listed in the table of recognized charsets,
523 # ASSUMED_DOC_CHARSET_CHOICE:cyrillic*
524 #               will be equal to specifying
525 .ex 4
526 # ASSUMED_DOC_CHARSET_CHOICE:cp866
527 # ASSUMED_DOC_CHARSET_CHOICE:windows-1251
528 # ASSUMED_DOC_CHARSET_CHOICE:koi8-r
529 # ASSUMED_DOC_CHARSET_CHOICE:iso-8859-5
530 #               or lines with full names of charsets.
532 #       literal string '*' (without quotes) will enable all charset choices
533 #               in corresponding field.  This is useful for overriding site
534 #               defaults in private pieces of lynx.cfg included via INCLUDE
535 #               directive.
537 # Default values for both settings are '*', but any occurrence of settings
538 # with values that denote any charsets will make only listed choices available
539 # for corresponding field.
540 #ASSUMED_DOC_CHARSET_CHOICE:*
541 #DISPLAY_CHARSET_CHOICE:*
543 .h2 ASSUME_LOCAL_CHARSET
544 # ASSUME_LOCAL_CHARSET is like ASSUME_CHARSET but only applies to local
545 # files.  If no setting is given here or by an -assume_local_charset
546 # command line option, the value for ASSUME_CHARSET or -assume_charset
547 # is used.  It works for both text/plain and text/html files.
548 # This option will ignore "raw mode" toggling when local files are viewed
549 # (it is "stronger" than "assume_charset" or the effective change
550 # of the charset assumption caused by changing "raw mode"),
551 # so only use when necessary.
553 #ASSUME_LOCAL_CHARSET:iso-8859-1
555 .h2 PREPEND_CHARSET_TO_SOURCE
556 # PREPEND_CHARSET_TO_SOURCE:TRUE tells Lynx to prepend a META CHARSET line
557 # to text/html source files when they are retrieved for 'd'ownloading
558 # or passed to 'p'rint functions, so HTTP headers will not be lost.
559 # This is necessary for resolving charset for local html files,
560 # while the assume_local_charset is just an assumption.
561 # For the 'd'ownload option, a META CHARSET will be added only if the HTTP
562 # charset is present.  The compilation default is TRUE.
563 # It is generally desirable to have charset information for every local
564 # html file, but META CHARSET string potentially could cause
565 # compatibility problems with other browsers, see also PREPEND_BASE_TO_SOURCE.
566 # Note that the prepending is not done for -source dumps.
568 #PREPEND_CHARSET_TO_SOURCE:TRUE
570 .h2 NCR_IN_BOOKMARKS
571 # NCR_IN_BOOKMARKS:TRUE allows you to save 8-bit characters in bookmark titles
572 # in the unicode format (NCR).  This may be useful if you need to switch
573 # display charsets frequently.  This is the case when you use Lynx on different
574 # platforms, e.g., on UNIX and from a remote PC, and want to keep the bookmarks
575 # file persistent.
576 # Another aspect is compatibility:  NCR is part of I18N and HTML4.0
577 # specifications supported starting with Lynx 2.7.2, Netscape 4.0 and MSIE 4.0.
578 # Older browser versions will fail so keep NCR_IN_BOOKMARKS:FALSE if you
579 # plan to use them.
581 #NCR_IN_BOOKMARKS:FALSE
583 .h2 FORCE_8BIT_TOUPPER
584 # FORCE_8BIT_TOUPPER overrides locale settings and uses internal 8-bit
585 # case-conversion mechanism for case-insensitive searches in non-ASCII display
586 # character sets.  It is FALSE by default and should not be changed unless
587 # you encounter problems with case-insensitive searches.
589 #FORCE_8BIT_TOUPPER:FALSE
591 .h2 OUTGOING_MAIL_CHARSET
592 # While Lynx supports different platforms and display character sets
593 # we need to limit the charset in outgoing mail to reduce
594 # trouble for remote recipients who may not recognize our charset.
595 # You may try US-ASCII as the safest value (7 bit), any other MIME name,
596 # or leave this field blank (default) to use the display character set.
597 # Charset translations currently are implemented for mail "subjects= " only.
599 #OUTGOING_MAIL_CHARSET:
601 .h2 ASSUME_UNREC_CHARSET
602 # If Lynx encounters a charset parameter it doesn't recognize, it will
603 # replace the value given by ASSUME_UNREC_CHARSET (or a corresponding
604 # -assume_unrec_charset command line option) for it.  This can be used
605 # to deal with charsets unknown to Lynx, if they are "sufficiently
606 # similar" to one that Lynx does know about, by forcing the same
607 # treatment.  There is no default, and you probably should leave this
608 # undefined unless necessary.
610 #ASSUME_UNREC_CHARSET:iso-8859-1
612 .h2 PREFERRED_LANGUAGE
613 # PREFERRED_LANGUAGE is the language in MIME notation (e.g., "en",
614 # "fr") which will be indicated by Lynx in its Accept-Language headers
615 # as the preferred language.  If available, the document will be
616 # transmitted in that language.  Users can override this setting via
617 # the 'o'ptions menu and save that preference in their RC file.
618 # This may be a comma-separated list of languages in decreasing preference.
620 #PREFERRED_LANGUAGE:en
622 .h2 PREFERRED_CHARSET
623 # PREFERRED_CHARSET specifies the character set in MIME notation (e.g.,
624 # "ISO-8859-2", "ISO-8859-5") which Lynx will indicate you prefer in
625 # requests to http servers using an Accept-Charsets header.  Users can
626 # change it via the 'o'ptions menu and save that preference in their RC file.
627 # The value should NOT include "ISO-8859-1" or "US-ASCII",
628 # since those values are always assumed by default.
629 # If a file in that character set is available, the server will send it.
630 # If no Accept-Charset header is present, the default is that any
631 # character set is acceptable.  If an Accept-Charset header is present,
632 # and if the server cannot send a response which is acceptable
633 # according to the Accept-Charset header, then the server SHOULD send
634 # an error response with the 406 (not acceptable) status code, though
635 # the sending of an unacceptable response is also allowed.  See RFC 2068
636 .url http://tools.ietf.org/html/rfc2068
638 #PREFERRED_CHARSET:
640 .h2 CHARSETS_DIRECTORY
641 # CHARSETS_DIRECTORY specifies the directory with the fonts (glyph data)
642 # used by Lynx to switch the display-font to a font best suited for the
643 # given document.  The font should be in a format understood by the
644 # platforms TTY-display-font-switching API.  Currently supported on OS/2 only.
646 # Lynx expects the glyphs for the charset CHARSET with character cell
647 # size HHHxWWW to be stored in a file HHHxWWW/CHARSET.fnt inside the directory
648 # specified by CHARSETS_DIRECTORY.  E.g., the font for koi8-r sized 14x9
649 # should be in the file 14x9/koi8-r.fnt.
651 #CHARSETS_DIRECTORY:
653 .h2 CHARSET_SWITCH_RULES
654 # CHARSET_SWITCH_RULES hints lynx on how to choose the best display font given
655 # the document encoding.  This string is a sequence of chunks, each chunk
656 # having the following form:
658 # IN_CHARSET1 IN_CHARSET2 ... IN_CHARSET5 :OUT_CHARSET
660 # For readability, one may insert arbitrary additional punctuation (anything
661 # but : is ignored).  E.g., if lynx is able to switch only to display charsets
662 # cp866, cp850, cp852, and cp862, then the following setting may be useful
663 # (split for readability):
665 # CHARSET_SWITCH_RULES: koi8-r ISO-8859-5 windows-1251 cp866u KOI8-U :cp866,
666 #       iso-8859-1 windows-1252 ISO-8859-15 :cp850,
667 #       ISO-8859-2 windows-1250 :cp852,
668 #       ISO-8859-8 windows-1255 :cp862
670 #CHARSET_SWITCH_RULES:
672 .h1 Interaction
674 .h2 URL_DOMAIN_PREFIXES
675 .h2 URL_DOMAIN_SUFFIXES
676 # URL_DOMAIN_PREFIXES and URL_DOMAIN_SUFFIXES are strings which will be
677 # prepended (together with a scheme://) and appended to the first element
678 # of command line or 'g'oto arguments which are not complete URLs and
679 # cannot be opened as a local file (file://localhost/string).  Both
680 # can be comma-separated lists.  Each prefix must end with a dot, each
681 # suffix must begin with a dot, and either may contain other dots (e.g.,
682 # .com.jp).  The default lists are defined in userdefs.h and can be
683 # replaced here.  Each prefix will be used with each suffix, in order,
684 # until a valid Internet host is created, based on a successful DNS
685 # lookup (e.g., foo will be tested as www.foo.com and then www.foo.edu
686 # etc.).  The first element can include a :port and/or /path which will
687 # be restored with the expanded host (e.g., wfbr:8002/dir/lynx will
688 # become http://www.wfbr.edu:8002/dir/lynx).  The prefixes will not be
689 # used if the first element ends in a dot (or has a dot before the
690 # :port or /path), and similarly the suffixes will not be used if the
691 # the first element begins with a dot (e.g., .nyu.edu will become
692 # http://www.nyu.edu without testing www.nyu.com).  Lynx will try to
693 # guess the scheme based on the first field of the expanded host name,
694 # and use "http://" as the default (e.g., gopher.wfbr.edu or gopher.wfbr.
695 # will be made gopher://gopher.wfbr.edu).
697 #URL_DOMAIN_PREFIXES:www.
698 #URL_DOMAIN_SUFFIXES:.com,.edu,.net,.org
700 .h2 FORMS_OPTIONS
701 # Toggle whether the Options Menu is key-based or form-based;
702 # the key-based version is available only if specified at compile time.
703 #FORMS_OPTIONS:TRUE
705 .h2 PARTIAL
706 # Display partial pages while downloading
707 #PARTIAL:TRUE
709 .h2 PARTIAL_THRES
710 # Set the threshold # of lines Lynx must render before it
711 # redraws the screen in PARTIAL mode.  Anything < 0 implies
712 # use of the screen size.
713 #PARTIAL_THRES:-1
715 .h2 SHOW_KB_RATE
716 # While getting large files, Lynx shows the approximate rate of transfer.
717 # Set this to change the units shown.  "Kilobytes" denotes 1024 bytes:
718 #       NONE to disable the display of transfer rate altogether.
719 #       TRUE or KB for Kilobytes/second.
720 #       FALSE or BYTES for bytes/second.
721 #       KB,ETA to show Kilobytes/second with estimated completion time.
722 #       BYTES,ETA to show BYTES/second with estimated completion time.
723 #       KB2,ETA to show Kilobytes/second with estimated completion time using 2-digits.
724 #       BYTES2,ETA to show BYTES/second with estimated completion time using 2-digits.
725 # Note that the "ETA" values are available if USE_READPROGRESS was defined.
726 #SHOW_KB_RATE:TRUE
728 .h2 SHOW_KB_NAME
729 # Set the abbreviation for Kilobytes (1024).
730 # Quoting from
731 .url http://www.romulus2.com/articles/guides/misc/bitsbytes.shtml
732 # In December 1998, the International Electrotechnical Commission (IEC)
733 # approved a new IEC International Standard.  Instead of using the metric
734 # prefixes for multiples in binary code, the new IEC standard invented specific
735 # prefixes for binary multiples made up of only the first two letters of the
736 # metric prefixes and adding the first two letters of the word "binary".  Thus,
737 # for instance, instead of Kilobyte (KB) or Gigabyte (GB), the new terms would
738 # be kibibyte (KiB) or gibibyte (GiB).
740 # If you prefer using the conventional (and more common) "KB", modify this
741 # setting.
742 #SHOW_KB_NAME:KiB
744 .h1 Timeouts
746 .h2 INFOSECS
747 .h2 MESSAGESECS
748 .h2 ALERTSECS
749 .h2 NO_PAUSE
750 # The following definitions set the number of seconds for
751 # pauses following statusline messages that would otherwise be
752 # replaced immediately, and are more important than the unpaused
753 # progress messages.  Those set by INFOSECS are also basically
754 # progress messages (e.g., that a prompted input has been canceled)
755 # and should have the shortest pause.  Those set by MESSAGESECS are
756 # informational (e.g., that a function is disabled) and should have
757 # a pause of intermediate duration.  Those set by ALERTSECS typically
758 # report a serious problem and should be paused long enough to read
759 # whenever they appear (typically unexpectedly).  The default values
760 # are defined in userdefs.h, and can be modified here should longer
761 # pauses be desired for braille-based access to Lynx.
763 # SVr4-curses implementations support time delays in milliseconds,
764 # hence the value may be given shorter, e.g., 0.5
766 # Use the NO_PAUSE option (like the command-line -nopause) to override
767 # all of the delay times.
769 #INFOSECS:1
770 #MESSAGESECS:2
771 #ALERTSECS:3
772 #NO_PAUSE:FALSE
774 .h2 DEBUGSECS
775 # Set DEBUGSECS to a nonzero value to slow down progress messages
776 # (see "-delay" option).
777 #DEBUGSECS:0
779 .h2 REPLAYSECS
780 # Set REPLAYSECS to a nonzero value to allow for slow replaying of
781 # command scripts (see "-cmd_script" option).
782 #REPLAYSECS:0
784 .h1 Appearance
785 # These settings control the appearance of Lynx's screen and the way
786 # Lynx renders some tags.
788 .h2 USE_SELECT_POPUPS
789 # If USE_SELECT_POPUPS is set FALSE, Lynx will present a vertical list of
790 # radio buttons for the OPTIONs in SELECT blocks which lack the MULTIPLE
791 # attribute, instead of using a popup menu.  Note that if the MULTIPLE
792 # attribute is present in the SELECT start tag, Lynx always will create a
793 # vertical list of checkboxes for the OPTIONs.
794 # The default defined here or in userdefs.h can be changed via the 'o'ptions
795 # menu and saved in the RC file, and always can be toggled via the -popup
796 # command line switch.
798 #USE_SELECT_POPUPS:TRUE
800 .h2 SHOW_CURSOR
801 # SHOW_CURSOR controls whether or not the cursor is hidden or appears
802 # over the current link in documents or the current option in popups.
803 # Showing the cursor is handy if you are a sighted user with a poor
804 # terminal that can't do bold and reverse video at the same time or
805 # at all.  It also can be useful to blind users, as an alternative
806 # or supplement to setting LINKS_AND_FIELDS_ARE_NUMBERED or
807 # LINKS_ARE_NUMBERED.
808 # The default defined here or in userdefs.h can be changed via the
809 # 'o'ptions menu and saved in the RC file, and always can be toggled
810 # via the -show_cursor command line switch.
812 #SHOW_CURSOR:FALSE
814 .h2 UNDERLINE_LINKS
815 # UNDERLINE_LINKS controls whether links are underlined by default, or shown
816 # in bold.  Normally this default is set from the configure script.
818 #UNDERLINE_LINKS:FALSE
820 .h2 BOLD_HEADERS
821 # If BOLD_HEADERS is set to TRUE the HT_BOLD default style will be acted
822 # upon for <H1> through <H6> headers.  The compilation default is FALSE
823 # (only the indentation styles are acted upon, but see BOLD_H1, below).
824 # On Unix, compilation with -DUNDERLINE_LINKS also will apply to the
825 # HT_BOLD style for headers when BOLD_HEADERS is TRUE.
827 #BOLD_HEADERS:FALSE
829 .h2 BOLD_H1
830 # If BOLD_H1 is set to TRUE the HT_BOLD default style will be acted
831 # upon for <H1> headers even if BOLD_HEADERS is FALSE.  The compilation
832 # default is FALSE.  On Unix, compilation with -DUNDERLINE_LINKS also
833 # will apply to the HT_BOLD style for headers when BOLD_H1 is TRUE.
835 #BOLD_H1:FALSE
837 .h2 BOLD_NAME_ANCHORS
838 # If BOLD_NAME_ANCHORS is set to TRUE the content of anchors without
839 # an HREF attribute, (i.e., anchors with a NAME or ID attribute) will
840 # have the HT_BOLD default style.  The compilation default is FALSE.
841 # On Unix, compilation with -DUNDERLINE_LINKS also will apply to the
842 # HT_BOLD style for NAME (ID) anchors when BOLD_NAME_ANCHORS is TRUE.
844 #BOLD_NAME_ANCHORS:FALSE
846 .h1 Internal Behavior
848 .h2 DEFAULT_CACHE_SIZE
849 .h2 DEFAULT_VIRTUAL_MEMORY_SIZE
850 # The DEFAULT_CACHE_SIZE specifies the number of WWW documents to be
851 # cached in memory at one time.
853 # This so-called cache size (actually, number) is defined in userdefs.h and
854 # may be modified here and/or with the command line argument -cache=NUMBER
855 # The minimum allowed value is 2, for the current document and at least one
856 # to fetch, and there is no absolute maximum number of cached documents.
857 # On Unix, and VMS not compiled with VAXC, whenever the number is exceeded
858 # the least recently displayed document will be removed from memory.
860 # On VMS compiled with VAXC, the DEFAULT_VIRTUAL_MEMORY_SIZE specifies the
861 # amount (bytes) of virtual memory that can be allocated and not yet be freed
862 # before previous documents are removed from memory.  If the values for both
863 # the DEFAULT_CACHE_SIZE and DEFAULT_VIRTUAL_MEMORY_SIZE are exceeded, then
864 # the least recently displayed documents will be freed until one or the other
865 # value is no longer exceeded.  The default value is defined in userdefs.h.
867 # The Unix and VMS (but not VAXC) implementations use the C library malloc's
868 # and calloc's for memory allocation, but procedures for taking the actual
869 # amount of cache into account still need to be developed.  They use only
870 # the DEFAULT_CACHE_SIZE value, and that specifies the absolute maximum
871 # number of documents to cache (rather than the maximum number only if
872 # DEFAULT_VIRTUAL_MEMORY_SIZE has been exceeded, as with VAXC/VAX).
874 #DEFAULT_CACHE_SIZE:10
875 #DEFAULT_VIRTUAL_MEMORY_SIZE:512000
877 .h2 SOURCE_CACHE
878 # SOURCE_CACHE sets the source caching behavior for Lynx:
880 # FILE causes Lynx to keep a temporary file for each cached document
881 #   containing the HTML source of the document, which it uses to regenerate
882 #   the document when certain settings are changed (for instance,
883 #   historical vs. minimal vs. valid comment parsing) instead of reloading
884 #   the source from the network.
886 # MEMORY is like FILE, except the document source is kept in memory.  You
887 #   may wish to adjust DEFAULT_CACHE_SIZE and DEFAULT_VIRTUAL_MEMORY_SIZE
888 #   accordingly.
890 # NONE is the default; the document source is not cached, and is reloaded
891 #   from the network when needed.
893 #SOURCE_CACHE:NONE
895 .h2 SOURCE_CACHE_FOR_ABORTED
896 # This setting controls what will happen with cached source for the document
897 # being fetched from the net if fetching was aborted (either user pressed
898 # 'z' or network went down). If set to KEEP, the source fetched so far will
899 # be preserved (and used as cache), if set to DROP lynx will drop the
900 # source cache for that document (i.e. only completely downloaded documents
901 # will be cached in that case).
902 #SOURCE_CACHE_FOR_ABORTED:DROP
904 .h2 ALWAYS_RESUBMIT_POSTS
905 # If ALWAYS_RESUBMIT_POSTS is set TRUE, Lynx always will resubmit forms
906 # with method POST, dumping any cache from a previous submission of the
907 # form, including when the document returned by that form is sought with
908 # the PREV_DOC command or via the history list.  Lynx always resubmits
909 # forms with method POST when a submit button or a submitting text input
910 # is activated, but normally retrieves the previously returned document
911 # if it had links which you activated, and then go back with the PREV_DOC
912 # command or via the history list.
914 # The default defined here or in userdefs.h can be toggled via
915 # the -resubmit_forms command line switch.
917 #ALWAYS_RESUBMIT_POSTS:FALSE
919 .h2 TRIM_INPUT_FIELDS
920 # If TRIM_INPUT_FIELDS is set TRUE, Lynx will trim trailing whitespace (e.g.,
921 # space, tab, carriage return, line feed and form feed) from the text entered
922 # into form text and textarea fields.  Older versions of Lynx do this trimming
923 # unconditionally, but other browsers do not, which would yield different
924 # behavior for CGI scripts.
925 #TRIM_INPUT_FIELDS:FALSE
927 .h1 HTML Parsing
929 .h2 NO_ISMAP_IF_USEMAP
930 # If NO_ISMAP_IF_USEMAP is set TRUE, Lynx will not include a link to the
931 # server-side image map if both a server-side and client-side map for the
932 # same image is indicated in the HTML markup.  The compilation default is
933 # FALSE, such that a link with "[ISMAP]" as the link name, followed by a
934 # hyphen, will be prepended to the ALT string or "[USEMAP]" pseudo-ALT for
935 # accessing Lynx's text-based rendition of the client-side map (based on
936 # the content of the associated MAP element).  If the "[ISMAP]" link is
937 # activated, Lynx will send a 0,0 coordinate pair to the server, which
938 # Lynx-friendly sites can map to a for-text-client document, homologous
939 # to what is intended for the content of a FIG element.
941 # The compilation default, or default defined here, can be toggled via
942 # the "-ismap" command line switch.
944 #NO_ISMAP_IF_USEMAP:FALSE
946 .h2 SEEK_FRAG_MAP_IN_CUR
947 # If SEEK_FRAG_MAP_IN_CUR is set FALSE, then USEMAP attribute values
948 # (in IMG or OBJECT tags) consisting of only a fragment (USEMAP="#foo")
949 # will be resolved with respect to the current document's base, which
950 # might not be the same as the current document's URL.
951 # The compilation default is to use the current document's URL in all
952 # cases (i.e., assume the MAP is present below, if it wasn't present
953 # above the point in the HTML stream where the USEMAP attribute was
954 # detected).  Lynx's present "single pass" rendering engine precludes
955 # checking below before making the decision on how to resolve a USEMAP
956 # reference consisting solely of a fragment.
958 #SEEK_FRAG_MAP_IN_CUR:TRUE
960 .h2 SEEK_FRAG_AREA_IN_CUR
961 # If SEEK_FRAG_AREA_IN_CUR is set FALSE, then HREF attribute values
962 # in AREA tags consisting of only a fragment (HREF="#foo") will be
963 # resolved with respect to the current document's base, which might
964 # not be the same as the current document's URL.  The compilation
965 # default is to use the current document's URL, as is done for the
966 # HREF attribute values of Anchors and LINKs that consist solely of
967 # a fragment.
969 #SEEK_FRAG_AREA_IN_CUR:TRUE
971 .h1 CGI scripts
972 # These settings control Lynx's ability to execute various types of scripts.
974 .h2 LOCAL_EXECUTION_LINKS_ALWAYS_ON
975 .h2 LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE
976 # Local execution links and scripts are by default completely disabled,
977 # unless a change is made to the userdefs.h file to enable them or
978 # the configure script is used with the corresponding options
979 # (-enable-exec-links and -enable-exec-scripts).
980 # See the Lynx source code distribution and the userdefs.h
981 # file for more detail on enabling execution links and scripts.
983 # If you have enabled execution links or scripts the following
984 # two variables control Lynx's action when an execution link
985 # or script is encountered.
987 # If LOCAL_EXECUTION_LINKS_ALWAYS_ON is set to TRUE any execution
988 # link or script will be executed no matter where it came from.
989 # This is EXTREMELY dangerous.  Since Lynx can access files from
990 # anywhere in the world, you may encounter links or scripts that
991 # will cause damage or compromise the security of your system.
993 # If LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE is set to TRUE only
994 # links or scripts that reside on the local machine and are
995 # referenced with a URL beginning with "file://localhost/" or meet
996 # TRUSTED_EXEC or ALWAYS_TRUSTED_EXEC rules (see below) will be
997 # executed.  This is much less dangerous than enabling all execution
998 # links, but can still be dangerous.
1000 #LOCAL_EXECUTION_LINKS_ALWAYS_ON:FALSE
1001 #LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE:FALSE
1003 .h2 TRUSTED_EXEC
1004 # If LOCAL_EXECUTION_LINK_ON_BUT_NOT_REMOTE is TRUE, and no TRUSTED_EXEC
1005 # rule is defined, it defaults to "file://localhost/" and any lynxexec
1006 # or lynxprog command will be permitted if it was referenced from within
1007 # a document whose URL begins with that string.  If you wish to restrict the
1008 # referencing URLs further, you can extend the string to include a trusted
1009 # path.  You also can specify a trusted directory for http URLs, which will
1010 # then be treated as if they were local rather than remote.  For example:
1012 #       TRUSTED_EXEC:file://localhost/trusted/
1013 #       TRUSTED_EXEC:http://www.wfbr.edu/trusted/
1015 # If you also wish to restrict the commands which can be executed, create
1016 # a series of rules with the path (Unix) or command name (VMS) following
1017 # the string, separated by a tab.  For example:
1019 # Unix:
1020 # ====
1021 #       TRUSTED_EXEC:file://localhost/<tab>/bin/cp
1022 #       TRUSTED_EXEC:file://localhost/<tab>/bin/rm
1023 # VMS:
1024 # ===
1025 #       TRUSTED_EXEC:file://localhost/<tab>copy
1026 #       TRUSTED_EXEC:file://localhost/<tab>delete
1028 # Once you specify a TRUSTED_EXEC referencing string, the default is
1029 # replaced, and all the referencing strings you desire must be specified
1030 # as a series.  Similarly, if you associate a command with the referencing
1031 # string, you must specify all of the allowable commands as a series of
1032 # TRUSTED_EXEC rules for that string.  If you specify ALWAYS_TRUSTED_EXEC
1033 # rules below, you need not repeat them as TRUSTED_EXEC rules.
1035 # If EXEC_LINKS and JUMPFILE have been defined, any lynxexec or lynxprog
1036 # URLs in that file will be permitted, regardless of other settings.  If
1037 # you also set LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE:TRUE and a single
1038 # TRUSTED_EXEC rule that will always fail (e.g., "none"), then *ONLY* the
1039 # lynxexec or lynxprog URLs in JUMPFILE (and any ALWAYS_TRUSTED_EXEC rules,
1040 # see below) will be allowed.  Note, however, that if Lynx was compiled with
1041 # CAN_ANONYMOUS_JUMP set to FALSE (default is TRUE), or -restrictions=jump
1042 # is included with the -anonymous switch at run time, then users of an
1043 # anonymous account will not be able to access the jumps file or enter
1044 # 'j'ump shortcuts, and this selective execution feature will be overridden
1045 # as well (i.e., they will only be able to access lynxexec or lynxprog
1046 # URLs which meet any ALWAYS_TRUSTED_EXEC rules).
1048 #TRUSTED_EXEC:none
1050 .h2 ALWAYS_TRUSTED_EXEC
1051 # If EXEC_LINKS was defined, any lynxexec or lynxprog URL can be made
1052 # always enabled by an ALWAYS_TRUSTED_EXEC rule for it.  This is useful for
1053 # anonymous accounts in which you have disabled execution links generally,
1054 # and may also have disabled jumps file links, but still want to allow
1055 # execution of particular utility scripts or programs.  The format is
1056 # like that for TRUSTED_EXEC.  For example:
1058 # Unix:
1059 # ====
1060 #   ALWAYS_TRUSTED_EXEC:file://localhost/<tab>/usr/local/kinetic/bin/usertime
1061 #   ALWAYS_TRUSTED_EXEC:http://www.more.net/<tab>/usr/local/kinetic/bin/who.sh
1062 # VMS:
1063 # ===
1064 #   ALWAYS_TRUSTED_EXEC:file://localhost/<tab>usertime
1065 #   ALWAYS_TRUSTED_EXEC:http://www.more.net/<tab>show users
1067 # The default ALWAYS_TRUSTED_EXEC rule is "none".
1069 #ALWAYS_TRUSTED_EXEC:none
1071 .h2 TRUSTED_LYNXCGI
1072 # Unix:
1073 # =====
1074 # TRUSTED_LYNXCGI rules define the permitted sources and/or paths for
1075 # lynxcgi links (if LYNXCGI_LINKS is defined in userdefs.h).  The format
1076 # is the same as for TRUSTED_EXEC rules (see above).  Example rules:
1078 #       TRUSTED_LYNXCGI:file://localhost/
1079 #       TRUSTED_LYNXCGI:<tab>/usr/local/etc/httpd/cgi-bin/
1080 #       TRUSTED_LYNXCGI:file://localhost/<tab>/usr/local/www/cgi-bin/
1082 # VMS:
1083 # ====
1084 # Do not define this.
1086 # The default TRUSTED_LYNXCGI rule is "none".
1088 #TRUSTED_LYNXCGI:none
1090 .h2 LYNXCGI_ENVIRONMENT
1091 # Unix:
1092 # =====
1093 # LYNXCGI_ENVIRONMENT adds the current value of the specified
1094 # environment variable to the list of environment variables passed on to the
1095 # lynxcgi script.  Useful variables are HOME, USER, etc...  If proxies
1096 # are in use, and the script invokes another copy of lynx (or a program like
1097 # wget) in a subsidiary role, it can be useful to add http_proxy and other
1098 # *_proxy variables.
1100 # VMS:
1101 # ====
1102 # Do not define this.
1104 #LYNXCGI_ENVIRONMENT:
1106 .h2 LYNXCGI_DOCUMENT_ROOT
1107 # Unix:
1108 # =====
1109 # LYNXCGI_DOCUMENT_ROOT is the value of DOCUMENT_ROOT that will be passed
1110 # to lynxcgi scripts.  If set and the URL has PATH_INFO data, then
1111 # PATH_TRANSLATED will also be generated.  Examples:
1112 #       LYNXCGI_DOCUMENT_ROOT:/usr/local/etc/httpd/htdocs
1113 #       LYNXCGI_DOCUMENT_ROOT:/data/htdocs/
1115 # VMS:
1116 # ====
1117 # Do not define this.
1119 #LYNXCGI_DOCUMENT_ROOT:
1121 .h1 Cookies
1123 .h2 FORCE_SSL_COOKIES_SECURE
1124 # If FORCE_SSL_COOKIES_SECURE is set to TRUE, then SSL encrypted cookies
1125 # received from https servers never will be sent unencrypted to http
1126 # servers.  The compilation default is to impose this block only if the
1127 # https server included a secure attribute for the cookie.  The normal
1128 # default or that defined here can be toggled via the -force_secure
1129 # command line switch.
1131 #FORCE_SSL_COOKIES_SECURE:FALSE
1133 .h1 Internal Behavior
1135 .h2 MAIL_SYSTEM_ERROR_LOGGING
1136 #  MAIL_SYSTEM_ERROR_LOGGING will send a message to the owner of
1137 #  the information, or ALERTMAIL if there is no owner, every time
1138 #  that a document cannot be accessed!
1140 #  NOTE:  This can generate A LOT of mail, be warned.
1142 #MAIL_SYSTEM_ERROR_LOGGING:FALSE
1144 .h2 CHECKMAIL
1145 # If CHECKMAIL is set to TRUE, the user will be informed (via a statusline
1146 # message) about the existence of any unread mail at startup of Lynx, and
1147 # will get statusline messages if subsequent new mail arrives.  If a jumps
1148 # file with a lynxprog URL for invoking mail is available, or your html
1149 # pages include an mail launch file URL, the user thereby can access mail
1150 # and read the messages.  The checks and statusline reports will not be
1151 # performed if Lynx has been invoked with the -restrictions=mail switch.
1153 # VMS USERS !!!
1154 # =============
1155 # New mail is normally broadcast as it arrives, via "unsolicited screen
1156 # broadcasts", which can be "wiped" from the Lynx display via the Ctrl-W
1157 # command.  You may prefer to disable the broadcasts and use CHECKMAIL
1158 # instead (e.g., in a public account which will be used by people who
1159 # are ignorant about VMS).
1161 #CHECKMAIL:FALSE
1163 .h1 News-groups
1165 .h2 NNTPSERVER
1166 # To enable news reading ability via Lynx, the environment variable NNTPSERVER
1167 # must be set so that it points to your site's NNTP server
1168 # (see Lynx Users Guide on environment variables).
1169 # Lynx respects RFC 1738
1170 .url http://tools.ietf.org/html/rfc1738
1171 # and does not accept a host field in news URLs (use nntp: instead of news: for
1172 # the scheme if you wish to specify an NNTP host in a URL, as explained in the
1173 # RFC).  If you have not set the variable externally, you can set it at run
1174 # time via this configuration file.  It will not override an external setting.
1175 # Note that on VMS it is set as a process logical rather than symbol, and will
1176 # outlive the Lynx image.
1177 # The news reading facility in Lynx is quite limited.  Lynx does not provide a
1178 # full featured news reader with elaborate error checking and safety features.
1180 #NNTPSERVER:news.server.dom
1182 .h2 LIST_NEWS_NUMBERS
1183 # If LIST_NEWS_NUMBERS is set TRUE, Lynx will use an ordered list and include
1184 # the numbers of articles in news listings, instead of using an unordered
1185 # list.  The default is defined in userdefs.h, and can be overridden here.
1187 #LIST_NEWS_NUMBERS:FALSE
1189 .h2 LIST_NEWS_DATES
1190 # If LIST_NEWS_DATES is set TRUE, Lynx will include the dates of articles in
1191 # news listings.  The dates always are included in the articles, themselves.
1192 # The default is defined in userdefs.h, and can be overridden here.
1194 #LIST_NEWS_DATES:FALSE
1196 .h2 NEWS_CHUNK_SIZE
1197 .h2 NEWS_MAX_CHUNK
1198 # NEWS_CHUNK_SIZE and NEWS_MAX_CHUNK regulate the chunking of news article
1199 # listings with inclusion of links for listing earlier and/or later articles.
1200 # The defaults are defined in HTNews.c as 30 and 40, respectively.  If the
1201 # news group contains more than NEWS_MAX_CHUNK articles, they will be listed
1202 # in NEWS_CHUNK_SIZE chunks.  You can change the defaults here, and/or on
1203 # the command line via -newschunksize=NUMBER and/or -newsmaxchunk=NUMBER
1204 # switches.  Note that if the chunk size is increased, here or on the command
1205 # line, to a value greater than the current maximum, the maximum will be
1206 # increased to that number.  Conversely, if the maximum is set to a number
1207 # less than the current chunk size, the chunk size will be reduced to that
1208 # number.  Thus, you need use only one of the two switches on the command
1209 # line, based on the direction of intended change relative to the compilation
1210 # or configuration defaults.  The compilation defaults ensure that there will
1211 # be at least 10 earlier articles before bothering to chunk and create a link
1212 # for earlier articles.
1214 #NEWS_CHUNK_SIZE:30
1215 #NEWS_MAX_CHUNK:40
1217 .h2 NEWS_POSTING
1218 # Set NEWS_POSTING to FALSE if you do not want to support posting to
1219 # news groups via Lynx.  If left TRUE, Lynx will use its news gateway to
1220 # post new messages or followups to news groups, using the URL schemes
1221 # described in the "Supported URLs" section of the online 'h'elp.  The
1222 # posts will be attempted via the nntp server specified in the URL, or
1223 # if none was specified, via the NNTPSERVER configuration or environment
1224 # variable.  Links with these URLs for posting or sending followups are
1225 # created by the news gateway when reading group listings or articles
1226 # from nntp servers if the server indicates that it permits posting.
1227 # The compilation default set in userdefs.h can be changed here.  If
1228 # the default is TRUE, posting can still be disallowed via the
1229 # -restrictions command line switch.
1230 # The posting facility in Lynx is quite limited.  Lynx does not provide a
1231 # full featured news poster with elaborate error checking and safety features.
1233 #NEWS_POSTING:TRUE
1235 .h2 LYNX_SIG_FILE
1236 # LYNX_SIG_FILE defines the name of a file containing a signature which
1237 # can be appended to email messages and news postings or followups.  The
1238 # user will be prompted whether to append it.  It is sought in the home
1239 # directory.  If it is in a subdirectory, begin it with a dot-slash
1240 # (e.g., ./lynx/.lynxsig).  The definition is set in userdefs.h and can
1241 # be changed here.
1243 #LYNX_SIG_FILE:.lynxsig
1245 .h1 Bibliographic Protocol (bibp scheme)
1247 .h2 BIBP_GLOBAL_SERVER
1248 # BIBP_GLOBAL_SERVER is the default global server for bibp: links, used
1249 # when a local bibhost or document-specified citehost is unavailable.
1250 # Set in userdefs.h and can be changed here.
1251 #BIBP_GLOBAL_SERVER:http://usin.org/
1253 .h2 BIBP_BIBHOST
1254 # BIBP_BIBHOST is the URL at which local bibp service may be found, if
1255 # it exists.   Defaults to http://bibhost/ for protocol conformance, but
1256 # may be overridden here or via -bibhost parameter.
1257 #BIBP_BIBHOST:http://bibhost/
1259 .h1 Interaction
1260 # These settings control interaction of the user with lynx.
1262 .h2 SCROLLBAR
1263 # If SCROLLBAR is set TRUE, Lynx will show scrollbar on windows.  With mouse
1264 # enabled, the scrollbar strip outside the bar is clickable, and scrolls the
1265 # window by pages.  The appearance of the scrollbar can be changed from
1266 # LYNX_LSS file:  define attributes scroll.bar, scroll.back (for the bar, and
1267 # for the strip along which the scrollbar moves).
1268 #SCROLLBAR:FALSE
1270 .h2 SCROLLBAR_ARROW
1271 # If SCROLLBAR_ARROW is set TRUE, Lynx's scrollbar will have arrows at the
1272 # ends.  With mouse enabled, the arrows are clickable, and scroll the window by
1273 # 2 lines.  The appearance of the scrollbar arrows can be changed from LYNX_LSS
1274 # file:  define attributes scroll.arrow, scroll.noarrow (for enabled-arrows,
1275 # and disabled arrows).  An arrow is "disabled" if the bar is at this end of
1276 # the strip.
1277 #SCROLLBAR_ARROW:TRUE
1279 .h2 USE_MOUSE
1280 # If Lynx is configured with ncurses, PDcurses or slang & USE_MOUSE is TRUE,
1281 # users can perform commands by left-clicking certain parts of the screen:
1282 #   on a link = `g'oto + ACTIVATE (i.e., move highlight & follow the link);
1283 #   on the top/bottom lines = PREV/NEXT_PAGE (i.e., go up/down 1 page);
1284 #   on the top/bottom left corners = PREV/NEXT_DOC (i.e., go to the previous
1285 #   document / undo goto previous document);
1286 #   on the top/bottom right corners = HISTORY/VLINKS (i.e., call up the history
1287 #   page or visited links page if on history page).
1288 # NB if the mouse is defined in this way, it will not be available
1289 # for copy/paste operations using the clipboard of a desktop manager:
1290 # for flexibility instead, use the command-line switch  -use_mouse .
1292 # ncurses and slang have built-in support for the xterm mouse protocol.  In
1293 # addition, ncurses can be linked with the gpm mouse library, to automatically
1294 # provide support for this interface in applications such as Lynx.  (Please
1295 # read the ncurses faq to work around broken gpm configurations packaged by
1296 # some distributors).  PDCurses implements mouse support for win32 console
1297 # windows, as does slang.
1298 #USE_MOUSE:FALSE
1300 .h1 HTML Parsing
1301 # These settings control the way Lynx parses invalid HTML
1302 # and how it may resolve such issues.
1304 .h2 COLLAPSE_BR_TAGS
1305 # If COLLAPSE_BR_TAGS is set FALSE, Lynx will not collapse serial BR tags.
1306 # If set TRUE, two or more concurrent BRs will be collapsed into a single
1307 # line break.  Note that the valid way to insert extra blank lines in HTML
1308 # is via a PRE block with only newlines in the block.
1310 #COLLAPSE_BR_TAGS:TRUE
1312 .h2 TRIM_BLANK_LINES
1313 # If TRIM_BLANK_LINES is set FALSE, Lynx will not trim trailing blank lines
1314 # from the document.  Also, Lynx will not collapse BR-tags onto the previous
1315 # line when it happens to be empty.
1316 #TRIM_BLANK_LINES:TRUE
1318 .h2 TAGSOUP
1319 # If TAGSOUP is set, Lynx uses the "Tag Soup DTD" rather than "SortaSGML".
1320 # The two approaches differ by the style of error detection and recovery.
1321 # Tag Soup DTD allows for improperly nested tags; SortaSGML is stricter.
1322 #TAGSOUP:FALSE
1324 .h1 Cookies
1326 .h2 COOKIE_VERSION
1327 # Select the RFC cookie version using the RFC number.  Most users will not
1328 # need to change this, but because RFC 6265 makes incompatible changes versus
1329 # the older RFCs, it is interesting to compare behavior.
1331 # For reference:
1332 .url http://tools.ietf.org/html/rfc6265
1333 .url http://tools.ietf.org/html/rfc2965
1334 .url http://tools.ietf.org/html/rfc2109
1335 #COOKIE_VERSION:RFC-6265
1337 .h2 SET_COOKIES
1338 # If SET_COOKIES is set FALSE, Lynx will ignore Set-Cookie headers
1339 # in http server replies.  Note that if a COOKIE_FILE is in use (see
1340 # below) that contains cookies at startup, Lynx will still send those
1341 # persistent cookies in requests as appropriate.  Setting SET_COOKIES
1342 # to FALSE just prevents accepting any new cookies from servers.  To
1343 # prevent all cookie processing (sending *and* receiving) in a session,
1344 # make sure that PERSISTENT_COOKIES is not TRUE or that COOKIE_FILE does
1345 # not point to a file with cookies, in addition to setting SET_COOKIES
1346 # to FALSE.
1347 # The default is defined in userdefs.h, and can be overridden here,
1348 # and/or toggled via the -cookies command line switch.
1350 #SET_COOKIES:TRUE
1352 .h2 ACCEPT_ALL_COOKIES
1353 # If ACCEPT_ALL_COOKIES is set TRUE, Lynx will accept cookies from all
1354 # domains with no user interaction.  This is equivalent to automatically
1355 # replying to all cookie 'Allow?' prompts with 'A'lways.  Note that it
1356 # does not preempt validity checking, which has to be controlled separately
1357 # (see below).
1358 # The default is defined in userdefs.h and can be overridden here, or
1359 # in the .lynxrc file via an o(ptions) screen setting.  It may also be
1360 # toggled via the -accept_all_cookies command line switch.
1362 #ACCEPT_ALL_COOKIES:FALSE
1364 .h2 COOKIE_ACCEPT_DOMAINS
1365 .h2 COOKIE_REJECT_DOMAINS
1366 # COOKIE_ACCEPT_DOMAINS and COOKIE_REJECT_DOMAINS are comma-delimited lists
1367 # of domains from which Lynx should automatically accept or reject cookies
1368 # without asking for confirmation.  If the same domain is specified in both
1369 # lists, rejection will take precedence.
1370 # Note that in order to match cookies, domains have to be spelled out exactly
1371 # in the form in which they would appear on the Cookie Jar page (case is
1372 # insignificant).  They are not wildcards.  Domains that apply to more than
1373 # one host have a leading '.', but have to match *the cookie's* domain
1374 # exactly.
1376 #COOKIE_ACCEPT_DOMAINS:
1377 #COOKIE_REJECT_DOMAINS:
1379 .h2 COOKIE_LOOSE_INVALID_DOMAINS
1380 .h2 COOKIE_STRICT_INVALID_DOMAINS
1381 .h2 COOKIE_QUERY_INVALID_DOMAINS
1382 # COOKIE_LOOSE_INVALID_DOMAINS, COOKIE_STRICT_INVALID_DOMAINS, and
1383 # COOKIE_QUERY_INVALID_DOMAINS are comma-delimited lists of domains.
1384 # They control the degree of validity checking that is applied to cookies
1385 # for the specified domains.
1386 # Note that in order to match cookies, domains have to be spelled out exactly
1387 # in the form in which they would appear on the Cookie Jar page (case is
1388 # insignificant).  They are not wildcards.  Domains that apply to more than
1389 # one host have a leading '.', but have to match *the cookie's* domain
1390 # exactly.
1391 # If a domain is set to strict checking, strict conformance to RFC 2109 will
1392 # be applied.  A domain with loose checking will be allowed to set cookies
1393 # with an invalid path or domain attribute.  All domains will default to
1394 # asking the user for confirmation in case of an invalid path or domain.
1395 # Cookie validity checking takes place as a separate step before the
1396 # final decision to accept or reject (see previous options), therefore
1397 # a cookie that passes validity checking may still be automatically
1398 # rejected or cause another prompt.
1400 #COOKIE_LOOSE_INVALID_DOMAINS:
1401 #COOKIE_STRICT_INVALID_DOMAINS:
1402 #COOKIE_QUERY_INVALID_DOMAINS:
1404 .h2 MAX_COOKIES_DOMAIN
1405 .h2 MAX_COOKIES_GLOBAL
1406 .h2 MAX_COOKIES_BUFFER
1407 # MAX_COOKIES_DOMAIN,
1408 # MAX_COOKIES_GLOBAL and
1409 # MAX_COOKIES_BUFFER are limits on the total number of cookies for each domain,
1410 # globally, and the per-cookie buffer size.  These limits are by default large
1411 # enough for reasonable usage; if they are very high, some sites may present
1412 # undue performance waste.
1414 #MAX_COOKIES_DOMAIN:50
1415 #MAX_COOKIES_GLOBAL:500
1416 #MAX_COOKIES_BUFFER:4096
1418 .h2 PERSISTENT_COOKIES
1419 # PERSISTENT_COOKIES indicates that cookies should be read at startup from
1420 # the COOKIE_FILE, and saved at exit for storage between Lynx sessions.
1421 # It is not used if Lynx was compiled without USE_PERSISTENT_COOKIES.
1422 # The default is FALSE, so that the feature needs to be enabled here
1423 # explicitly if you want it.
1425 #PERSISTENT_COOKIES:FALSE
1427 .h2 COOKIE_FILE
1428 # COOKIE_FILE is the default file from which persistent cookies are read
1429 # at startup (if the file exists), if Lynx was compiled with
1430 # USE_PERSISTENT_COOKIES and the PERSISTENT_COOKIES option is enabled.
1431 # The cookie file can also be specified in .lynxrc or on the command line.
1433 #COOKIE_FILE:~/.lynx_cookies
1435 .h2 COOKIE_SAVE_FILE
1436 # COOKIE_SAVE_FILE is the default file in which persistent cookies are
1437 # stored at exit, if Lynx was compiled with USE_PERSISTENT_COOKIES and the
1438 # PERSISTENT_COOKIES option is enabled.  The cookie save file can also be
1439 # specified on the command line.
1441 # With an interactive Lynx session, COOKIE_SAVE_FILE will default to
1442 # COOKIE_FILE if it is not set.  With a non-interactive Lynx session (e.g.,
1443 # -dump), cookies will only be saved to file if COOKIE_SAVE_FILE is set.
1445 #COOKIE_SAVE_FILE:~/.lynx_cookies
1447 .h1 Mail-related
1449 .h2 SYSTEM_MAIL
1450 .h2 SYSTEM_MAIL_FLAGS
1451 # VMS:
1452 # ===
1453 # The mail command and qualifiers are defined in userdefs.h.  Lynx
1454 # will spawn a subprocess to send replies and error messages.  The
1455 # command, and qualifiers (if any), can be re-defined here.  If
1456 # you use PMDF then headers will we passed via a header file.
1457 # If you use "generic" VMS MAIL, the subject will be passed on the
1458 # command line via a /subject="SUBJECT" qualifier, and inclusion
1459 # of other relevant headers may not be possible.
1460 # If your mailer uses another syntax, some hacking of the mailform()
1461 # mailmsg() and reply_by_mail() functions in LYMail.c, and send_file_to_mail()
1462 # function in LYPrint.c, may be required.
1464 .ex 2
1465 #SYSTEM_MAIL:PMDF SEND
1466 #SYSTEM_MAIL_FLAGS:/headers
1468 .ex 2
1469 #SYSTEM_MAIL:MAIL
1470 #SYSTEM_MAIL_FLAGS:
1472 # Unix:
1473 #======
1474 # The mail path and flags normally are defined for sendmail (or submit
1475 # with MMDF) in userdefs.h.  You can change them here, but should first
1476 # read the zillions of CERT advisories about security problems with Unix
1477 # mailers.
1479 .ex 2
1480 #SYSTEM_MAIL:/usr/mmdf/bin/submit
1481 #SYSTEM_MAIL_FLAGS:-mlruxto,cc\*
1483 .ex 2
1484 #SYSTEM_MAIL:/usr/sbin/sendmail
1485 #SYSTEM_MAIL_FLAGS:-t -oi
1487 .ex 2
1488 #SYSTEM_MAIL:/usr/lib/sendmail
1489 #SYSTEM_MAIL_FLAGS:-t -oi
1491 # Win32:
1492 #=======
1493 # The Win32 port assumes that the mailer cannot read via a pipe.  That is, it
1494 # must read all information from files.  The "sendmail" utility in the 2.8.1
1495 # release is able to work with that assumption.  There is no way to tell the
1496 # Win32 port of Lynx to send its information to the sendmail utility via a
1497 # pipe.
1499 # Please read sendmail.txt in the LYNX_W32.ZIP distribution
1500 .url    http://invisible-mirror.net/archives/lynx/tarballs/lynx2.8.1_w32.zip
1501 .url    ftp://ftp.invisible-island.net/lynx/tarballs/lynx2.8.1_w32.zip
1503 # As an alternative, the newer "sendmail for windows" may be useful:
1504 .url    http://glob.com.au/sendmail/
1506 # See also BLAT_MAIL and ALT_BLAT_MAIL flags.
1508 #SYSTEM_MAIL:sendmail -f me@my.host -h my.host -r my.smtp.mailer -m SMTP
1510 .h2 MAIL_ADRS
1511 # VMS ONLY:
1512 # ========
1513 # MAIL_ADRS is defined in userdefs.h and normally is structured for PMDF's
1514 # IN%"INTERNET_ADDRESS" scheme.  The %s is replaced with the address given
1515 # by the user.  If you are using a different Internet mail transport, change
1516 # the IN appropriately (e.g., to SMTP, MX, or WINS).
1518 #MAIL_ADRS:"IN%%""%s"""
1520 .h2 USE_FIXED_RECORDS
1521 # VMS ONLY:
1522 # ========
1523 # If USE_FIXED_RECORDS is set to TRUE here or in userdefs.h, Lynx will
1524 # convert 'd'ownloaded binary files to FIXED 512 record format before saving
1525 # them to disk or acting on a DOWNLOADER option.  If set to FALSE, the
1526 # headers of such files will indicate that they are Stream_LF with Implied
1527 # Carriage Control, which is incorrect, and can cause downloading software
1528 # to get confused and unhappy.  If you do set it FALSE, you can use the
1529 # FIXED512.COM command file, which is included in this distribution, to do
1530 # the conversion externally.
1532 #USE_FIXED_RECORDS:TRUE
1534 .h1 Keyboard Input
1535 # These settings control the way Lynx interprets user input.
1537 .h2 VI_KEYS_ALWAYS_ON
1538 .h2 EMACS_KEYS_ALWAYS_ON
1539 # Vi or Emacs movement keys, i.e. familiar hjkl or ^N^P^F^B .
1540 # These are defaults, which can be changed in the Options Menu or .lynxrc .
1541 #VI_KEYS_ALWAYS_ON:FALSE
1542 #EMACS_KEYS_ALWAYS_ON:FALSE
1544 .h2 DEFAULT_KEYPAD_MODE
1545 # DEFAULT_KEYPAD_MODE may be set to NUMBERS_AS_ARROWS
1546 #                                or LINKS_ARE_NOT_NUMBERED (the same)
1547 #                                or LINKS_ARE_NUMBERED
1548 #                                or LINKS_AND_FIELDS_ARE_NUMBERED
1549 #                                or FIELDS_ARE_NUMBERED
1550 # to specify whether numbers (e.g. [10]) appear next to all links,
1551 # allowing immediate access by entering the number on the keyboard,
1552 # or numbers on the numeric key-pad work like arrows;
1553 # the "FIELDS" options cause form fields also to be numbered.
1554 # This may be overridden by the keypad_mode setting in .lynxrc,
1555 # and can also be changed via the Options Menu.
1557 #DEFAULT_KEYPAD_MODE:NUMBERS_AS_ARROWS
1559 .h2 NUMBER_LINKS_ON_LEFT
1560 .h2 NUMBER_FIELDS_ON_LEFT
1561 # Denotes the position for link- and field-numbers (whether it is on the left
1562 # or right of the anchor).  These are subject to DEFAULT_KEYPAD_MODE, which
1563 # determines whether numbers are shown.
1564 #NUMBER_LINKS_ON_LEFT:TRUE
1565 #NUMBER_FIELDS_ON_LEFT:TRUE
1567 .h2 DEFAULT_KEYPAD_MODE_IS_NUMBERS_AS_ARROWS
1568 # Obsolete form of DEFAULT_KEYPAD_MODE,
1569 # numbers work like arrows or numbered links.
1570 # Set to TRUE, indicates numbers act as arrows,
1571 # and set to FALSE indicates numbers refer to numbered links on the page.
1572 # LINKS_AND_FIELDS_ARE_NUMBERED cannot be set by this option because
1573 # it allows only two values (true and false).
1575 #DEFAULT_KEYPAD_MODE_IS_NUMBERS_AS_ARROWS:TRUE
1577 .h2 CASE_SENSITIVE_ALWAYS_ON
1578 # The default search type.
1579 # This is a default that can be overridden by the user!
1581 #CASE_SENSITIVE_ALWAYS_ON:FALSE
1583 .h1 Auxiliary Facilities
1585 .h2 DEFAULT_BOOKMARK_FILE
1586 # DEFAULT_BOOKMARK_FILE is the filename used for storing personal bookmarks.
1587 # It will be prepended by the user's home directory.
1588 # NOTE that a file ending in .html or other suffix mapped to text/html
1589 # should be used to ensure its treatment as HTML.  The built-in default
1590 # is lynx_bookmarks.html.  On both Unix and VMS, if a subdirectory off of
1591 # the HOME directory is desired, the path should begin with "./" (e.g.,
1592 # ./BM/lynx_bookmarks.html), but the subdirectory must already exist.
1593 # Lynx will create the bookmark file, if it does not already exist, on
1594 # the first ADD_BOOKMARK attempt if the HOME directory is indicated
1595 # (i.e., if the definition is just filename.html without any slashes),
1596 # but requires a pre-existing subdirectory to create the file there.
1597 # The user can re-define the default bookmark file, as well as a set
1598 # of sub-bookmark files if multiple bookmark file support is enabled
1599 # (see below), via the 'o'ptions menu, and can save those definitions
1600 # in the .lynxrc file.
1602 #DEFAULT_BOOKMARK_FILE:lynx_bookmarks.html
1604 .h2 MULTI_BOOKMARK_SUPPORT
1605 # If MULTI_BOOKMARK_SUPPORT is set TRUE, and BLOCK_MULTI_BOOKMARKS (see
1606 # below) is FALSE, and sub-bookmarks exist, all bookmark operations will
1607 # first prompt the user to select an active sub-bookmark file or the
1608 # default bookmark file.  FALSE is the default so that one (the default)
1609 # bookmark file will be available initially.  The definition here will
1610 # override that in userdefs.h.  The user can turn on multiple bookmark
1611 # support via the 'o'ptions menu, and can save that choice as the startup
1612 # default via the .lynxrc file.  When on, the setting can be STANDARD or
1613 # ADVANCED.  If SUPPORT is set to the latter, and the user mode also is
1614 # ADVANCED, the VIEW_BOOKMARK command will invoke a statusline prompt at
1615 # which the user can enter the letter token (A - Z) of the desired bookmark,
1616 # or '=' to get a menu of available bookmark files.  The menu always is
1617 # presented in NOVICE or INTERMEDIATE mode, or if the SUPPORT is set to
1618 # STANDARD.  No prompting or menu display occurs if only one (the startup
1619 # default) bookmark file has been defined (define additional ones via the
1620 # 'o'ptions menu).  The startup default, however set, can be overridden on
1621 # the command line via the -restrictions=multibook or the -anonymous or
1622 # -validate switches.
1624 #MULTI_BOOKMARK_SUPPORT:FALSE
1626 .h2 BLOCK_MULTI_BOOKMARKS
1627 # If BLOCK_MULTI_BOOKMARKS is set TRUE, multiple bookmark support will
1628 # be forced off, and cannot to toggled on via the 'o'ptions menu.  The
1629 # compilation setting is normally FALSE, and can be overridden here.
1630 # It can also be set via the -restrictions=multibook or the -anonymous
1631 # or -validate command line switches.
1633 #BLOCK_MULTI_BOOKMARKS:FALSE
1635 .h1 Interaction
1637 .h2 DEFAULT_USER_MODE
1638 # DEFAULT_USER_MODE sets the default user mode for Lynx users.
1639 # NOVICE shows a three line help message at the bottom of the screen.
1640 # INTERMEDIATE shows normal amount of help (one line).
1641 # ADVANCED help is replaced by the URL of the current link.
1643 #DEFAULT_USER_MODE:NOVICE
1645 .h1 External Programs
1647 .h2 DEFAULT_EDITOR
1648 # If DEFAULT_EDITOR is defined, users may edit local documents with it
1649 # & it will also be used for sending mail messages.
1650 # If no editor is defined here or by the user,
1651 # the user will not be able to edit local documents
1652 # and a primitive line-oriented mail-input mode will be used.
1654 # For sysadmins: do not define a default editor
1655 # unless you know EVERY user will know how to use it;
1656 # users can easily define their own editor in the Options Menu.
1658 #DEFAULT_EDITOR:
1660 .h2 SYSTEM_EDITOR
1661 # SYSTEM_EDITOR behaves the same as DEFAULT_EDITOR,
1662 # except that it can't be changed by users.
1664 #SYSTEM_EDITOR:
1666 .h3 POSITIONABLE_EDITOR
1667 # If POSITIONABLE_EDITOR is defined once or multiple times and if the same
1668 # editor is used as editor in lynx, lynx will use its features, i.e., adding an
1669 # option to set the initial line-position, when editing files and textarea.
1670 # The commented editors below are already known; there is no need to uncomment
1671 # them.
1673 #POSITIONABLE_EDITOR:emacs
1674 #POSITIONABLE_EDITOR:jed
1675 #POSITIONABLE_EDITOR:jmacs
1676 #POSITIONABLE_EDITOR:joe
1677 #POSITIONABLE_EDITOR:jove
1678 #POSITIONABLE_EDITOR:jpico
1679 #POSITIONABLE_EDITOR:jstar
1680 #POSITIONABLE_EDITOR:nano
1681 #POSITIONABLE_EDITOR:pico
1682 #POSITIONABLE_EDITOR:rjoe
1683 #POSITIONABLE_EDITOR:vi
1685 .h1 Proxy
1687 .h2 HTTP_PROXY
1688 .h2 HTTPS_PROXY
1689 .h2 FTP_PROXY
1690 .h2 GOPHER_PROXY
1691 .h2 NEWSPOST_PROXY
1692 .h2 NEWSREPLY_PROXY
1693 .h2 NEWS_PROXY
1694 .h2 NNTP_PROXY
1695 .h2 SNEWSPOST_PROXY
1696 .h2 SNEWSREPLY_PROXY
1697 .h2 SNEWS_PROXY
1698 .h2 WAIS_PROXY
1699 .h2 FINGER_PROXY
1700 .h2 CSO_PROXY
1701 # Lynx version 2.2 and beyond supports the use of proxy servers that can act as
1702 # firewall gateways and caching servers.  They are preferable to the older
1703 # gateway servers.  Each protocol used by Lynx can be mapped separately using
1704 # PROTOCOL_proxy environment variables (see Lynx Users Guide).  If you have not set
1705 # them externally, you can set them at run time via this configuration file.
1706 # They will not override external settings.  The no_proxy variable can be used
1707 # to inhibit proxying to selected regions of the Web (see below).  Note that on
1708 # VMS these proxy variables are set as process logicals rather than symbols, to
1709 # preserve lowercasing, and will outlive the Lynx image.
1711 .ex 15
1712 #http_proxy:http://some.server.dom:port/
1713 #https_proxy:http://some.server.dom:port/
1714 #ftp_proxy:http://some.server.dom:port/
1715 #gopher_proxy:http://some.server.dom:port/
1716 #news_proxy:http://some.server.dom:port/
1717 #newspost_proxy:http://some.server.dom:port/
1718 #newsreply_proxy:http://some.server.dom:port/
1719 #snews_proxy:http://some.server.dom:port/
1720 #snewspost_proxy:http://some.server.dom:port/
1721 #snewsreply_proxy:http://some.server.dom:port/
1722 #nntp_proxy:http://some.server.dom:port/
1723 #wais_proxy:http://some.server.dom:port/
1724 #finger_proxy:http://some.server.dom:port/
1725 #cso_proxy:http://some.server.dom:port/
1726 #no_proxy:host.domain.dom
1728 .h2 NO_PROXY
1729 # The no_proxy variable can be a comma-separated list of strings defining
1730 # no-proxy zones in the DNS domain name space.  If a tail substring of the
1731 # domain-path for a host matches one of these strings, transactions with that
1732 # node will not be proxied.
1734 #no_proxy:domain.path1,path2
1736 # A single asterisk as an entry will override all proxy variables and no
1737 # transactions will be proxied.
1739 #no_proxy:*
1740 # This is the only allowed use of * in no_proxy.
1742 # Warning:  Note that setting 'il' as an entry in this list will block proxying
1743 # for the .mil domain as well as the .il domain.  If the entry is '.il' this
1744 # will not happen.
1746 .h1 External Programs
1748 .h2 PRINTER
1749 .h2 DOWNLOADER
1750 .h2 UPLOADER
1751 # PRINTER, DOWNLOADER & UPLOADER DEFINITIONS:
1752 # Lynx has 4 pre-defined print options & 1 pre-defined download option,
1753 # which are called up on-screen when `p' or `d' are entered;
1754 # any number of options can be added by the user, as explained below.
1755 # Uploaders can be defined only for UNIX with DIRED_SUPPORT:
1756 # see the Makefile in the top directory & the header of src/LYUpload.c .
1758 # For `p' pre-defined options are: `Save to local file', `E-mail the file',
1759 # `Print to screen' and `Print to local printer attached to vt100'.
1760 # `Print to screen' allows file transfers in the absence of alternatives
1761 # and is often the only option allowed here for anonymous users;
1762 # the 3rd & 4th options are not pre-defined for DOS/WINDOWS versions of Lynx.
1763 # For `d' the pre-defined option is: `Download to local file'.
1765 # To define your own print or download option use the following formats:
1767 # PRINTER:<name>:<command>:<option>:<lines/page>[:<environment>]
1769 # DOWNLOADER:<name>:<command>:<option>[:<environment>]
1771 # <name>       is what you will see on the print/download screen.
1773 # <command>    is the command your system will execute:
1774 #              the 1st %s in the command will be replaced
1775 #              by the temporary filename used by Lynx;
1776 #              a 2nd %s will be replaced by a filename of your choice,
1777 #              for which Lynx will prompt, offering a suggestion.
1778 #              On Unix, which has pipes, you may use a '|' as the first
1779 #              character of the command, and Lynx will open a pipe to
1780 #              the command.
1781 #              If the command format of your printer/downloader requires
1782 #              a different layout, you will need to use a script
1783 #              (see the last 2 download examples below).
1785 # <option>     TRUE : the printer/downloader will always be ENABLED,
1786 #              except that downloading is disabled when -validate is used;
1787 #              FALSE : both will be DISABLED for anonymous users
1788 #              and printing will be disabled when -noprint is used.
1790 # <lines/page> (printers: optional) the number of lines/page (default 66):
1791 #              used to compute the approximate output size
1792 #              and prompt if the document is > 4 printer pages;
1793 #              it uses current screen length for the computation
1794 #              when `Print to screen' is selected.
1796 # [:<environment>]
1797 #              optional, if XWINDOWS then printer/downloader will be
1798 #              enabled if DISPLAY environment variable IS defined and
1799 #              disabled otherwise, if environment is NON_XWINDOWS
1800 #              then printer/downloader will be enabled if DISPLAY
1801 #              environment variable IS NOT defined and disabled otherwise,
1802 #              for anything else or if environment is not specified
1803 #              printer/downloader is always enabled.
1805 # You must put the whole definition on one line;
1806 # if you use a colon, precede it with a backslash.
1808 # `Printer' can be any file-handling program you find useful,
1809 # even if it does not physically print anything.
1811 # Usually, down/up-loading involves the use of (e.g.) Ckermit or ZModem
1812 # to transfer files to a user's local machine over a serial link,
1813 # but download options do not have to be download-protocol programs.
1815 # Printer examples:
1816 .ex 3
1817 #PRINTER:Computer Center printer:lpr -Pccprt %s:FALSE
1818 #PRINTER:Office printer:lpr -POffprt %s:TRUE
1819 #PRINTER:VMS printer:print /queue=cc$print %s:FALSE:58
1820 # If you have a very busy VMS print queue
1821 # and Lynx deletes the temporary files before they have been queued,
1822 # use the VMSPrint.com included in the distribution:
1824 #PRINTER:Busy VMS printer:@Lynx_Dir\:VMSPrint sys$print %s:FALSE:58
1825 # To specify a print option at run-time:
1826 # NBB if you have ANONYMOUS users, DO NOT allow this option!
1828 #PRINTER:Specify at run-time:echo -n "Enter a print command\: "; read word; sh -c "$word %s":FALSE
1829 # To pass to a sophisticated file viewer: -k suppresses invocation
1830 # of hex display mode if 8-bit or control characters are present;
1831 # +s invokes secure mode (see ftp://space.mit.edu/pub/davis/most):
1833 #PRINTER:Use Most to view:most -k +s %s:TRUE:23
1835 # Downloader examples:
1836 # in Kermit, -s %s is the filename sent, -a %s the filename on arrival
1837 # (if they are given in reverse order here, the command will fail):
1839 #DOWNLOADER:Use Kermit to download to the terminal:kermit -i -s %s -a %s:TRUE
1840 # NB don't use -k with Most, so that binaries will invoke hexadecimal mode:
1842 #DOWNLOADER:Use Most to view:most +s %s:TRUE
1843 # The following example gives wrong filenames
1844 # (`sz' doesn't support a suggested filename parameter):
1846 #DOWNLOADER:Use Zmodem to download to the local terminal:sz %s:TRUE
1847 # The following example returns correct filenames
1848 # by using a script to make a subdirectory in /tmp,
1849 # but may conflict with very strong security or permissions restrictions:
1851 #DOWNLOADER:Use Zmodem to download to the local terminal:set %s %s;td=/tmp/Lsz$$;mkdir $td;ln -s $1 $td/"$2";sz $td/"$2";rm -r $td:TRUE
1852 .ex 2
1853 #UPLOADER:Use Kermit to upload from your computer: kermit -i -r -a %s:TRUE
1854 #UPLOADER:Use Zmodem to upload from your computer: rz %s:TRUE
1856 # Note for OS/390: /* S/390 -- gil -- 1464 */
1857 # The following is strongly recommended to undo ASCII->EBCDIC conversion.
1859 #DOWNLOADER:Save OS/390 binary file: iconv -f IBM-1047 -t ISO8859-1 %s >%s:FALSE
1861 .h1 Interaction
1863 .h2 NO_DOT_FILES
1864 # If NO_DOT_FILES is TRUE (normal default via userdefs.h), the user will not
1865 # be allowed to specify files beginning with a dot in reply to output filename
1866 # prompts, and files beginning with a dot (e.g., file://localhost/path/.lynxrc)
1867 # will not be included in the directory browser's listings.  If set FALSE, you
1868 # can force it to be treated as TRUE via -restrictions=dotfiles.  If set FALSE
1869 # and not forced TRUE, the user can regulate it via the 'o'ptions menu (and
1870 # may save the preference in the RC file).
1872 #NO_DOT_FILES:TRUE
1874 .h1 Internal Behavior
1876 .h2 NO_FROM_HEADER
1877 # If NO_FROM_HEADER is set FALSE, From headers will be sent in transmissions
1878 # to http or https servers if the personal_mail_address has been defined via
1879 # the 'o'ptions menu.  The compilation default is TRUE (no From header is
1880 # sent) and the default can be changed here.  The default can be toggled at
1881 # run time via the -from switch.  Note that transmissions of From headers
1882 # have become widely considered to create an invasion of privacy risk.
1884 #NO_FROM_HEADER:TRUE
1886 .h2 NO_REFERER_HEADER
1887 # If NO_REFERER_HEADER is TRUE, Referer headers never will be sent in
1888 # transmissions to servers.  Lynx normally sends the URL of the document
1889 # from which the link was derived, but not for startfile URLs, 'g'oto
1890 # URLs, 'j'ump shortcuts, bookmark file links, history list links, or
1891 # URLs that include the content from form submissions with method GET.
1892 # If left FALSE here, it can be set TRUE at run time via the -noreferer
1893 # switch.
1895 #NO_REFERER_HEADER:FALSE
1897 .h1 Internal Behavior
1899 .h2 NO_FILE_REFERER
1900 # If NO_FILE_REFERER is TRUE, Referer headers never will be sent in
1901 # transmissions to servers for links or actions derived from documents
1902 # or forms with file URLs.  This ensures that paths associated with
1903 # the local file system are never indicated to servers, even if
1904 # NO_REFERER_HEADER is FALSE.  If set to FALSE here, it can still be
1905 # set TRUE at run time via the -nofilereferer switch.
1907 #NO_FILE_REFERER:TRUE
1909 .h2 REFERER_WITH_QUERY
1910 # REFERER_WITH_QUERY controls what happens when the URL in a Referer
1911 # header to be sent would contain a query part in the form of a '?'
1912 # character followed by one or more attribute=value pairs.  Query parts
1913 # often contain sensitive or personal information resulting from filling
1914 # out forms, or other info that allows tracking of a user's browsing path
1915 # through a site, an thus should not be put in a Referer header (which may
1916 # get sent to an unrelated third-party site).  On the other hand, some
1917 # sites (improperly) rely on browsers sending Referer headers, even when
1918 # the user is coming from a page whose URL has a query part.
1920 # If REFERER_WITH_QUERY is SEND, full Referer headers will be sent
1921 # including the query part (unless sending of Referer is disabled in
1922 # general, see NO_REFERER_HEADER above).  If REFERER_WITH_QUERY is
1923 # PARTIAL, the Referer header will contain a partial URL, with the query
1924 # part stripped off.  This is not strictly correct, but should satisfy
1925 # those sites that check only whether the user arrived at a page from an
1926 # "outside" link.  If REFERER_WITH_QUERY is set to DROP (or anything else
1927 # unrecognized), the default, no Referer header is sent at all in this
1928 # situation.
1930 #REFERER_WITH_QUERY:DROP
1932 .h1 Appearance
1934 .h2 VERBOSE_IMAGES
1935 # VERBOSE_IMAGES controls whether Lynx replaces [LINK], [INLINE] and [IMAGE]
1936 # (for images without ALT) with filenames of these images.
1937 # This can be useful in determining what images are important
1938 # and which are mere decorations, e.g. button.gif, line.gif,
1939 # provided the author uses meaningful names.
1941 # The definition here will override the setting in userdefs.h.
1943 #VERBOSE_IMAGES:TRUE
1945 .h2 MAKE_LINKS_FOR_ALL_IMAGES
1946 # If MAKE_LINKS_FOR_ALL_IMAGES is TRUE, all images will be given links
1947 # which can be ACTIVATEd.  For inlines, the ALT or pseudo-ALT ("[INLINE]")
1948 # strings will be links for the resolved SRC rather than just text.
1949 # For ISMAP or other graphic links, ALT or pseudo-ALT ("[ISMAP]" or "[LINK]")
1950 # will have '-' and a link labeled "[IMAGE]" for the resolved SRC appended.
1951 # See also VERBOSE_IMAGES flag.
1953 # The definition here will override that in userdefs.h
1954 # and can be toggled via an "-image_links" command-line switch.
1955 # The user can also use the LYK_IMAGE_TOGGLE key (default `*')
1956 # or `Show Images' in the Form-based Options Menu.
1958 #MAKE_LINKS_FOR_ALL_IMAGES:FALSE
1960 .h2 MAKE_PSEUDO_ALTS_FOR_INLINES
1961 # If MAKE_PSEUDO_ALTS_FOR_INLINES is FALSE, inline images which don't specify
1962 # an ALT string will not have "[INLINE]" inserted as a pseudo-ALT,
1963 # i.e. they'll be treated as having ALT="".
1964 # Otherwise (if TRUE), pseudo-ALTs will be created for inlines,
1965 # so that they can be used as links to the SRCs.
1966 # See also VERBOSE_IMAGES flag.
1968 # The definition here will override that in userdefs.h
1969 # and can be toggled via a "-pseudo_inlines" command-line switch.
1970 # The user can also use the LYK_INLINE_TOGGLE key (default `[')
1971 # or `Show Images' in the Form-based Options Menu.
1973 #MAKE_PSEUDO_ALTS_FOR_INLINES:TRUE
1975 .h2 SUBSTITUTE_UNDERSCORES
1976 # If SUBSTITUTE_UNDERSCORES is TRUE, the _underline_ format will be used
1977 # for emphasis tags in dumps.
1979 # The default defined here will override that in userdefs.h, and the user
1980 # can toggle the default via a "-underscore" command line switch.
1982 #SUBSTITUTE_UNDERSCORES:FALSE
1984 .h1 Interaction
1986 .h2 QUIT_DEFAULT_YES
1987 # If QUIT_DEFAULT_YES is TRUE then when the QUIT command is entered, any
1988 # response other than n or N will confirm.  It should be FALSE if you
1989 # prefer the more conservative action of requiring an explicit Y or y to
1990 # confirm.  The default defined here will override that in userdefs.h.
1992 #QUIT_DEFAULT_YES:TRUE
1994 .h1 HTML Parsing
1996 .h2 HISTORICAL_COMMENTS
1997 # If HISTORICAL_COMMENTS is TRUE, Lynx will revert to the "Historical"
1998 # behavior of treating any '>' as a terminator for comments, instead of
1999 # seeking a valid '-->' terminator (note that white space can be present
2000 # between the '--' and '>' in valid terminators).  The compilation default
2001 # is FALSE.
2003 # The compilation default, or default defined here, can be toggled via a
2004 # "-historical" command line switch, and via the LYK_HISTORICAL command key.
2006 #HISTORICAL_COMMENTS:FALSE
2008 .h2 MINIMAL_COMMENTS
2009 # If MINIMAL_COMMENTS is TRUE, Lynx will not use Valid comment parsing
2010 # of '--' pairs as serial comments within an overall comment element,
2011 # and instead will seek only a '-->' terminator for the overall comment
2012 # element.  This emulates the Netscape v2.0 comment parsing bug, and
2013 # will help Lynx cope with the use of dashes as "decorations", which
2014 # consequently has become common in so-called "Enhanced for Netscape"
2015 # pages.  Note that setting Historical comments on will override the
2016 # Minimal or Valid setting.
2018 # The compilation default for MINIMAL_COMMENTS is FALSE, but we'll
2019 # set it TRUE here, until Netscape gets its comment parsing right,
2020 # and "decorative" dashes cease to be so common.
2022 # The compilation default, or default defined here, can be toggled via a
2023 # "-minimal" command line switch, and via the LYK_MINIMAL command key.
2025 MINIMAL_COMMENTS:TRUE
2027 .h2 SOFT_DQUOTES
2028 # If SOFT_DQUOTES is TRUE, Lynx will emulate the invalid behavior of
2029 # treating '>' as a co-terminator of a double-quoted attribute value
2030 # and the tag which contains it, as was done in old versions of Netscape
2031 # and Mosaic.  The compilation default is FALSE.
2033 # The compilation default, or default defined here, can be toggled via
2034 # a "-soft_dquotes" command line switch.
2036 #SOFT_DQUOTES:FALSE
2038 .h2 STRIP_DOTDOT_URLS
2039 # If STRIP_DOTDOT_URLS is TRUE, Lynx emulates the invalid behavior of many
2040 # browsers to strip a leading "../" segment from relative URLs in HTML
2041 # documents with a http or https base URL, if this would otherwise lead to
2042 # an absolute URLs with those characters still in it.  Such URLs are normally
2043 # erroneous and not what is intended by page authors.  Lynx will issue
2044 # a warning message when this occurs.
2046 # If STRIP_DOTDOT_URLS is FALSE, Lynx will use those URLs for requests
2047 # without taking any special actions or issuing Warnings, in most cases
2048 # this will result in an error response from the server.
2050 # Note that Lynx never tries to fix similar URLs for protocols other than
2051 # http and https, since they are less common and may actually be valid in
2052 # some cases.
2054 #STRIP_DOTDOT_URLS:TRUE
2056 .h1 Appearance
2058 .h2 ENABLE_SCROLLBACK
2059 # If ENABLE_SCROLLBACK is TRUE, Lynx will clear the entire screen before
2060 # displaying each new screenful of text.  Though less efficient for normal
2061 # use, this allows programs that maintain a buffer of previously-displayed
2062 # text to recognize the continuity of what has been displayed, so that
2063 # previous screenfuls can be reviewed by whatever method the program uses
2064 # to scroll back through previous text.  For example, the PC comm program
2065 # QModem has a key that can be pressed to scroll back; if ENABLE_SCROLLBACK
2066 # is TRUE, pressing the scrollback key will access previous screenfuls which
2067 # will have been stored on the local PC and will therefore be displayed
2068 # instantaneously, instead of needing to be retransmitted by Lynx at the
2069 # speed of the comm connection (but Lynx will not know about the change,
2070 # so you must restore the last screen before resuming with Lynx commands).
2072 # The default compilation or configuration setting can be toggled via an
2073 # "-enable_scrollback" command line switch.
2075 #ENABLE_SCROLLBACK:FALSE
2077 .h2 SCAN_FOR_BURIED_NEWS_REFS
2078 # If SCAN_FOR_BURIED_NEWS_REFS is set to TRUE, Lynx will scan the bodies
2079 # of news articles for buried article and URL references and convert them
2080 # to links.  The compilation default is TRUE, but some email addresses
2081 # enclosed in angle brackets ("<user@address>") might be converted to false
2082 # news links, and uuencoded messages might be corrupted.  The conversion is
2083 # not done when the display is toggled to source or when 'd'ownloading, so
2084 # uuencoded articles can be saved intact regardless of these settings.
2086 # The default setting can be toggled via a "-buried_news" command line
2087 # switch.
2089 #SCAN_FOR_BURIED_NEWS_REFS:TRUE
2091 .h2 PREPEND_BASE_TO_SOURCE
2092 # If PREPEND_BASE_TO_SOURCE is set to FALSE, Lynx will not prepend a
2093 # Request URL comment and BASE element to text/html source files when
2094 # they are retrieved for 'd'ownloading or passed to 'p'rint functions.
2095 # The compilation default is TRUE.  Note that this prepending is not
2096 # done for -source dumps, unless the -base switch also was included on
2097 # the command line, and the latter switch overrides the setting of the
2098 # PREPEND_BASE_TO_SOURCE configuration variable.
2100 #PREPEND_BASE_TO_SOURCE:TRUE
2102 .h1 External Programs
2103 # MIME types and viewers!
2105 # file extensions may be assigned to MIME types using
2106 # the SUFFIX: definition.
2108 # NOTE: It is normally preferable to define new extension mappings in
2109 #       EXTENSION_MAP files (see below) instead of here:  Definitions
2110 #       here are overridden by those in EXTENSION_MAP files and even by
2111 #       some built-in defaults in src/HTInit.c.  On the other hand,
2112 #       definitions here allow some more fields that are not possible
2113 #       in those files.
2115 #       Extension mappings have an effect mostly for ftp and local files,
2116 #       they are NOT used to determine the type of content for URLs with
2117 #       the http protocol.  This is because HTTP servers already specify
2118 #       the MIME type in the Content-Type header.  [It may still be
2119 #       necessary to set up an appropriate suffix for some MIME types,
2120 #       even if they are accessed only via the HTTP protocol, if the viewer
2121 #       (see below) for those MIME types requires a certain suffix for the
2122 #       temporary file passed to it.]
2124 .h2 GLOBAL_EXTENSION_MAP
2125 .h2 PERSONAL_EXTENSION_MAP
2126 # The global and personal EXTENSION_MAP files allow you to assign extensions
2127 # to MIME types which will override any of the suffix maps in this (lynx.cfg)
2128 # configuration file, or in src/HTInit.c.  See the example mime.types file
2129 # in the samples subdirectory.
2131 # Unix:
2132 # ====
2133 #GLOBAL_EXTENSION_MAP:/usr/local/lib/mosaic/mime.types
2134 # VMS:
2135 # ===
2136 #GLOBAL_EXTENSION_MAP:Lynx_Dir:mime.types
2138 #       Unix (sought in user's home directory):
2139 #PERSONAL_EXTENSION_MAP:.mime.types
2140 #       VMS (sought in user's sys$login directory):
2141 #PERSONAL_EXTENSION_MAP:mime.types
2143 .h2 SUFFIX_ORDER
2144 # With SUFFIX_ORDER the precedence of suffix mappings can be changed.
2145 # Two kinds of settings are recognized:
2147 #    PRECEDENCE_OTHER or PRECEDENCE_HERE
2148 #      Suffix mappings can come from four sources: (1) SUFFIX rules
2149 #      given here - see below, (2) built-in defaults (HTInit.c), and the
2150 #      (3) GLOBAL_EXTENSION_MAP and (4) PERSONAL_EXTENSION_MAP files.
2151 #      The order of precedence is normally as listed: (1) has the
2152 #      *lowest*, (4) has the *highest* precedence if there are conflicts.
2153 #      In other words, SUFFIX mappings here are overridden by conflicting
2154 #      ones elsewhere.  This default ordering is called PRECEDENCE_OTHER.
2155 #      With PRECEDENCE_HERE, the order becomes (2) (3) (4) (1), i.e.
2156 #      mappings here override others made elsewhere.
2158 #    NO_BUILTIN
2159 #      This disables all built-in default rules.  In other words, (2) in the
2160 #      list above is skipped.  Some recognition for compressed files (".gz",
2161 #      ".Z") is still hardwired.   A mapping for some basic types, at least
2162 #      for text/html is probably necessary to get a usable configuration,
2163 #      it can be given in a SUFFIX rule below or an extension map file.
2164 # Both kinds of settings can be combined, separated by comma as in
2165 #        SUFFIX_ORDER:PRECEDENCE_HERE,NO_BUILTIN
2166 # Note: Using PRECEDENCE_HERE has only an effect on SUFFIX rules that follow.
2167 # Moreover, if GLOBAL_EXTENSION_MAP or PERSONAL_EXTENSION_MAP directives
2168 # are used, they should come *before* a SUFFIX_ORDER:PRECEDENCE_HERE.
2170 #SUFFIX_ORDER:PRECEDENCE_OTHER
2172 .h2 SUFFIX
2173 # The SUFFIX definition takes the form of:
2175 #    SUFFIX:<file extension>:<mime type>:<encoding>:<quality>:<description>
2177 # All fields after <mime type> are optional (including the separators
2178 # if no more fields follow).
2180 #     <file extension> trailing end of file name.  This need not strictly
2181 #                      be a file extension as understood by the OS, a dot
2182 #                      has to be given explicitly if it is indented, for
2183 #                      some uses one could even match full filenames here.
2184 #                      In addition, two forms are special: "*.*" and "*"
2185 #                      refer to the defaults for otherwise unmatched files
2186 #                      (the first for filenames with a dot somewhere in
2187 #                      the name, the second without), these are currently
2188 #                      mapped to text/plain in the (HTInit.c) built-in code.
2189 #                      Lynx compares the file-extensions ignoring case.
2191 #     <mime type> a MIME content type.  It can also contain a charset
2192 #                 parameter, see example below.  This should be given in
2193 #                 all lowercase, use <description> for more fancy labels.
2194 #                 It can be left empty if an HTTP style encoding is given.
2196 # Fields in addition to the usual ones are
2198 #     <encoding>  either a mail style trivial encoding (7bit, 8bit, binary)
2199 #                 which could be used on some systems to determine how to
2200 #                 open local files (currently it isn't), and is used to
2201 #                 determine transfer mode for some FTP URLs; or a HTTP style
2202 #                 content encoding (gzip (equivalent to x-gzip), compress)
2204 #     <quality> a floating point quality factor, usually between 0.0 and 1.0
2205 #               currently unused in most situations.
2207 #     <description> text that can appear in FTP directory listings, and in
2208 #                   local directory listings (see LIST_FORMAT, code %t)
2210 # For instance the following definition maps the
2211 # extension ".gif" to the mime type "image/gif"
2213 #    SUFFIX:.gif:image/gif
2215 # The following can be used if you have a convention to label
2216 # HTML files in some character set that differs from your local
2217 # default (see also ASSUME_LOCAL_CHARSET) with a different
2218 # extension, here ".html-u8".  It also demonstrates use of the
2219 # description field, note extra separators for omitted fields:
2221 #    SUFFIX:.html-u8:text/html;charset=utf-8:::UTF-8 HTML
2223 # The following shows how a suffix can indicate a combination
2224 # of MIME type and compression method. (The ending ".ps.gz" should
2225 # already be recognized by default; the form below could be used on
2226 # systems that don't allow more than one dot in filenames.)
2228 #    SUFFIX:.ps_gz:application/postscript:gzip::gzip'd Postscript
2230 # The following is meant to match a full filename (but can match
2231 # any file ending in "core", so be careful):
2233 #    SUFFIX:core:application/x-core-file
2235 # file suffixes are case INsensitive!
2237 # The suffix definitions listed here in the default lynx.cfg file are
2238 # similar to those normally established via src/HTInit.c.  You can change
2239 # the defaults by editing that file or disable them, or via the global or
2240 # personal mime.types files at run time (except for the additional fields).
2241 # Assignments made here are overridden by entries in those files
2242 # unless preceded with a SUFFIX_ORDER:PRECEDENCE_HERE.
2244 .ex 29
2245 #SUFFIX:.ps:application/postscript
2246 #SUFFIX:.eps:application/postscript
2247 #SUFFIX:.ai:application/postscript
2248 #SUFFIX:.rtf:application/rtf
2249 #SUFFIX:.snd:audio/basic
2250 #SUFFIX:.gif:image/gif
2251 #SUFFIX:.rgb:image/x-rgb
2252 #SUFFIX:.png:image/png
2253 #SUFFIX:.xbm:image/x-xbitmap
2254 #SUFFIX:.tiff:image/tiff
2255 #SUFFIX:.jpg:image/jpeg
2256 #SUFFIX:.jpeg:image/jpeg
2257 #SUFFIX:.mpg:video/mpeg
2258 #SUFFIX:.mpeg:video/mpeg
2259 #SUFFIX:.mov:video/quicktime
2260 #SUFFIX:.hqx:application/mac-binhex40
2261 #SUFFIX:.bin:application/octet-stream
2262 #SUFFIX:.exe:application/octet-stream
2263 #SUFFIX:.tar:application/x-tar
2264 #SUFFIX:.tgz:application/x-tar:gzip
2265 #SUFFIX:.Z::compress
2266 #SUFFIX:.gz::gzip
2267 #SUFFIX:.bz2:application/x-bzip2
2268 #SUFFIX:.zip:application/zip
2269 #SUFFIX:.lzh:application/x-lzh
2270 #SUFFIX:.lha:application/x-lha
2271 #SUFFIX:.dms:application/x-dms
2272 #SUFFIX:.html:text/html
2273 #SUFFIX:.txt:text/plain
2275 .h2 XLOADIMAGE_COMMAND
2276 # VMS:
2277 # ====
2278 # XLOADIMAGE_COMMAND will be used as a default in src/HTInit.c
2279 # for viewing image content types when the DECW$DISPLAY logical
2280 # is set.  Make it the foreign command for your system's X image
2281 # viewer (commonly, "xv").  It can be anything that will handle GIF,
2282 # TIFF and other popular image formats.  Freeware ports of xv for
2283 # VMS were available in the ftp://ftp.wku.edu/vms/unsupported and
2284 # http://www.openvms.digital.com/cd/XV310A/ subdirectories.  You
2285 # must also have a "%s" for the filename.  The default is defined
2286 # in userdefs.h and can be overridden here, or via the global or
2287 # personal mailcap files (see below).
2289 # Make this empty (but not commented out) if you don't have such a viewer or
2290 # want to disable the built-in default viewer mappings for image types.
2292 #XLOADIMAGE_COMMAND:xv %s
2293 XLOADIMAGE_COMMAND:
2295 # Unix:
2296 # =====
2297 # XLOADIMAGE_COMMAND will be used as a default in src/HTInit.c for
2298 # viewing image content types when the DISPLAY environment variable
2299 # is set.  Make it the full path and name of the xli (also know as
2300 # xloadimage or xview) command, or other image viewer.  It can be
2301 # anything that will handle GIF, TIFF and other popular image formats
2302 # (xli does).  The freeware distribution of xli is available in the
2303 # ftp://ftp.x.org/contrib subdirectory.  The shareware, xv, also is
2304 # suitable.  You must also have a "%s" for the filename; "&" for
2305 # background is optional.  The default is defined in userdefs.h and can be
2306 # overridden here, or via the global or personal mailcap files (see below).
2307 # Make this empty (but not commented out) if you don't have such a
2308 # viewer or don't want to disable the built-in default viewer
2309 # mappings for image types.
2310 # Note that open is used as the default for NeXT, instead of the
2311 # XLOADIMAGE_COMMAND definition.
2312 # If you use xli, you may want to add the -quiet flag.
2314 #XLOADIMAGE_COMMAND:xli %s &
2316 .h2 VIEWER
2317 # MIME types may be assigned to external viewers using
2318 # the VIEWER definition.
2320 # NOTE: if you do not define a viewer to a new MIME type
2321 #       that you assigned above then it will be saved to
2322 #       disk by default.
2323 #       It is normally preferable to define new viewers in
2324 #       MAILCAP files (see below) instead of here:  Definitions
2325 #       here are overridden by those in MAILCAP files and even
2326 #       by some built-in defaults in src/HTInit.c.
2328 # The VIEWER definition takes the form of:
2329 #    VIEWER:<mime type>:<viewer command>[:<environment>]
2330 #      where -mime type is the MIME content type of the file
2331 #            -viewer command is a system command that can be
2332 #             used to display the file where %s is replaced
2333 #             within the command with the physical filename
2334 #             (e.g., "ghostview %s" becomes "ghostview /tmp/temppsfile")
2335 #            -environment is optional.  The only valid keywords
2336 #             are currently XWINDOWS and NON_XWINDOWS.  If the XWINDOWS
2337 #             environment is specified then the viewer will only be
2338 #             defined when the user has the environment variable DISPLAY
2339 #             (DECW$DISPLAY on VMS) defined.  If the NON_XWINDOWS environment
2340 #             is specified the specified viewer will only be defined when the
2341 #             user DOES NOT have the environment variable DISPLAY defined.
2342 #  examples:
2343 #               VIEWER:image/gif:xli %s:XWINDOWS
2344 #               VIEWER:image/gif:ascii-view %s:NON_XWINDOWS
2345 #               VIEWER:application/start-elm:elm
2347 # You must put the whole definition on one line.
2349 # If you must use a colon in the viewer command, precede it with a backslash!
2351 # The MIME_type:viewer:XWINDOWS definitions listed here in the lynx.cfg
2352 # file are among those established via src/HTInit.c.  For the image types,
2353 # HTInit.c uses the XLOADIMAGE_COMMAND definition in userdefs.h or above
2354 # (open is used for NeXT).  You can change any of these defaults via the
2355 # global or personal mailcap files.  Assignments made here will be overridden
2356 # by entries in those files.
2358 .ex 7
2359 #VIEWER:application/postscript:ghostview %s&:XWINDOWS
2360 #VIEWER:image/gif:xli %s&:XWINDOWS
2361 #VIEWER:image/x-xbm:xli %s&:XWINDOWS
2362 #VIEWER:image/png:xli %s&:XWINDOWS
2363 #VIEWER:image/tiff:xli %s&:XWINDOWS
2364 #VIEWER:image/jpeg:xli %s&:XWINDOWS
2365 #VIEWER:video/mpeg:mpeg_play %s &:XWINDOWS
2367 .h2 GLOBAL_MAILCAP
2368 .h2 PERSONAL_MAILCAP
2369 # The global and personal MAILCAP files allow you to specify external
2370 # viewers to be spawned when Lynx encounters different MIME types, which
2371 # will override any of the suffix maps in this (lynx.cfg) configuration
2372 # file, or in src/HTInit.c.  See
2373 .url http://tools.ietf.org/html/rfc1524
2374 # and the example mailcap file in the samples subdirectory.
2376 # Unix:
2377 # ====
2378 #GLOBAL_MAILCAP:/usr/local/lib/mosaic/mailcap
2379 # VMS:
2380 # ===
2381 #GLOBAL_MAILCAP:Lynx_Dir:mailcap
2383 #       Sought in user's home (Unix) or sys$login (VMS) directory.
2384 #PERSONAL_MAILCAP:.mailcap
2386 .h2 PREFERRED_MEDIA_TYPES
2387 # When doing a GET, lynx lists the MIME types which it knows how to present
2388 # (the "Accept:" string).  Depending on your system configuration, the
2389 # mime.types or other data given by the GLOBAL_EXTENSION_MAP may include many
2390 # entries that lynx really does not handle.  Use this option to select one
2391 # of the built-in subsets of the MIME types that lynx could list in the
2392 # Accept.
2394 # Values for this option are keywords:
2395 #       INTERNAL        lynx's built-in types for internal conversions
2396 #       CONFIGFILE      adds lynx.cfg
2397 #       USER            adds PERSONAL_EXTENSION_MAP settings
2398 #       SYSTEM          adds GLOBAL_EXTENSION_MAP  settings
2399 #       ALL             adds lynx's built-in types for external conversions
2401 #PREFERRED_MEDIA_TYPES:internal
2403 .h2 PREFERRED_ENCODING
2404 # When doing a GET, lynx tells what types of compressed data it can decompress
2405 # (the "Accept-Encoding:" string).  This is determined by compiled-in support
2406 # for decompression or external decompression programs.
2408 # Values for this option are keywords:
2409 #       NONE            Do not request compressed data
2410 #       GZIP            For gzip
2411 #       COMPRESS        For compress
2412 #       BZIP2           For bzip2
2413 #       ALL             All of the above.
2414 #PREFERRED_ENCODING:all
2416 .h2 PREFERRED_CONTENT_TYPE
2417 # When doing a GET, lynx expects the server to provide a Content-Type, i.e.,
2418 # the MIME name which tells it how to present data.  When that is missing
2419 # lynx uses this value.
2420 #PREFERRED_CONTENT_TYPE: text/plain
2422 .h1 Keyboard Input
2424 .h2 KEYBOARD_LAYOUT
2425 # If your terminal (or terminal emulator, or operating system) does not
2426 # support 8-bit input (at all or in easy way), you can use Lynx to
2427 # generate 8-bit characters from 7-bit ones output by terminal.
2429 # Currently available keyboard layouts:
2430 #       ROT13'd keyboard layout
2431 #       JCUKEN Cyrillic, for AT 101-key kbd
2432 #       YAWERTY Cyrillic, for DEC LK201 kbd
2434 # This feature is ifdef'd with EXP_KEYBOARD_LAYOUT.
2435 #KEYBOARD_LAYOUT:JCUKEN Cyrillic, for AT 101-key kbd
2437 .h2 KEYMAP
2438 # Key remapping definitions!
2440 # You may redefine the keymapping of any function in Lynx by
2441 # using the KEYMAP option.  The basic form of KEYMAP is:
2442 #  KEYMAP:<KEYSTROKE>:<LYNX FUNCTION>
2443 # (See below for an extended format.)
2445 # You must map upper and lowercase keys separately.
2447 # A representative list of functions mapped to their default keys is
2448 # provided below.  All of the mappings are commented out by default
2449 # since they just repeat the default mappings, except for TOGGLE_HELP
2450 # (see below).  See LYKeymap.c for the complete key mapping.  Use the
2451 # 'K'eymap command when running Lynx for a list of the _current_ keymappings.
2453 # You can disable any of the default key-mappings by mapping the key to
2454 # "UNMAPPED".
2456 # (However, in contrast to the output of 'K' command,
2457 # 'H'elp (lynx_help/*.html and lynx_help/keystrokes/*.html files) shows
2458 # the default mapping unless you change that files manually,
2459 # so you are responsible for possible deviations
2460 # when you are changing any KEYMAP below).
2462 # Lynx accepts special keys either by name, or by lynx-specific codes.  These
2463 # names and codes are listed below, with a brief description:
2465 #         UPARROW: 0x100 (Up Arrow)
2466 #         DNARROW: 0x101 (Down Arrow)
2467 #         RTARROW: 0x102 (Right Arrow)
2468 #         LTARROW: 0x103 (Left Arrow)
2469 #          PGDOWN: 0x104 (Page Down)
2470 #            PGUP: 0x105 (Page Up)
2471 #            HOME: 0x106 (Keypad Home)
2472 #             END: 0x107 (Keypad End)
2473 #              F1: 0x108 (VT220 Function-key 1, also Help Key)
2474 #          DO_KEY: 0x109 (VT220 Function key 16, also "Do" Key)
2475 #        FIND_KEY: 0x10A (VT220 key with label "Home" may be treated as Find)
2476 #      SELECT_KEY: 0x10B (VT220 key with label "End" may be treated as Select)
2477 #      INSERT_KEY: 0x10C (VT220 Insert Key)
2478 #      REMOVE_KEY: 0x10D (VT220 Remove (DEL) Key)
2479 #      DO_NOTHING: 0x10E (reserved for internal use, DO_NOTHING)
2480 #     BACKTAB_KEY: 0x10F (Back Tab, e.g., using Shift)
2481 #              F2: 0x110 (VT220 Function-key 2)
2482 #              F3: 0x111 (VT220 Function-key 3)
2483 #              F4: 0x112 (VT220 Function-key 4)
2484 #              F5: 0x113 (VT220 Function-key 5)
2485 #              F6: 0x114 (VT220 Function-key 6)
2486 #              F7: 0x115 (VT220 Function-key 7)
2487 #              F8: 0x116 (VT220 Function-key 8)
2488 #              F9: 0x117 (VT220 Function-key 9)
2489 #             F10: 0x118 (VT220 Function-key 10)
2490 #             F11: 0x119 (VT220 Function-key 11)
2491 #             F12: 0x11A (VT220 Function-key 12)
2492 #           MOUSE: 0x11D (reserved for internal use with -use_mouse)
2494 # Other codes not listed above may be available for additional keys,
2495 # depending on operating system and libraries used to compile Lynx.
2496 # On Unix-like systems, if compiled with slang or ncurses, an additional
2497 # level of key mapping is supported via an external ".lynx-keymaps" file.
2498 # This file, if found in the home directory at startup, will always be
2499 # used under those conditions; see lynx-keymaps distributed in the samples
2500 # subdirectory for further explanation.  Note that mapping via
2501 # .lynx-keymaps, if applicable, is a step that logically comes before the
2502 # mappings done here: KEYMAP maps the result of that step (which still
2503 # represents a key) to a function (which represents an action that Lynx
2504 # should perform).
2507 #KEYMAP:0x5C:SOURCE             # Toggle source viewing mode (show HTML source)
2508 #KEYMAP:^R:RELOAD               # Reload the current document and redisplay
2509 #KEYMAP:^U:NEXT_DOC             # Undo PREV_DOC)
2510 #KEYMAP:q:QUIT                  # Ask the user to quit
2511 #KEYMAP:Q:ABORT                 # Quit without verification
2512 #KEYMAP:0x20:NEXT_PAGE          # Move down to next page
2513 #KEYMAP:-:PREV_PAGE             # Move up to previous page
2514 #KEYMAP:^P:UP_TWO               # Move display up two lines
2515 #KEYMAP:INSERT_KEY:UP_TWO       # Function key Insert - Move display up two lines
2516 #KEYMAP:^N:DOWN_TWO             # Move display down two lines
2517 #KEYMAP:REMOVE_KEY:DOWN_TWO     # Function key Remove - Move display down two lines
2518 #KEYMAP:(:UP_HALF               # Move display up half a page
2519 #KEYMAP:):DOWN_HALF             # Move display down half a page
2520 #KEYMAP:^W:REFRESH              # Refresh the screen
2521 #KEYMAP:^A:HOME                 # Go to top of current document
2522 #KEYMAP:HOME:HOME               # Keypad Home - Go to top of current document
2523 #KEYMAP:FIND_KEY:HOME           # Function key Find - Go to top of current document
2524 #KEYMAP:^E:END                  # Go to bottom of current document
2525 #KEYMAP:END:END                 # Keypad End - Go to bottom of current document
2526 #KEYMAP:SELECT_KEY:END          # Function key Select - Go to bottom of current document
2527 #KEYMAP:UPARROW:PREV_LINK       # Move to the previous link or page
2528 #KEYMAP:DNARROW:NEXT_LINK       # Move to the next link or page
2529 #KEYMAP:BACKTAB_KEY:FASTBACKW_LINK      # Back Tab - Move to previous link or text area
2530 #KEYMAP:^I:FASTFORW_LINK        # Tab key - Move always to next link or text area
2531 #KEYMAP:^:FIRST_LINK            # Move to the first link on line
2532 #KEYMAP:$:LAST_LINK             # Move to the last link on line
2533 #KEYMAP:<:UP_LINK               # Move to the link above
2534 #KEYMAP:>:DOWN_LINK             # Move to the link below
2535 #KEYMAP:0x7F:HISTORY            # Show the history list
2536 #KEYMAP:0x08:HISTORY            # Show the history list
2537 #KEYMAP:LTARROW:PREV_DOC        # Return to the previous document in history stack
2538 #KEYMAP:RTARROW:ACTIVATE        # Select the current link
2539 #KEYMAP:DO_KEY:ACTIVATE         # Function key Do - Select the current link
2540 #KEYMAP:g:GOTO                  # Goto a random URL
2541 #KEYMAP:G:ECGOTO                # Edit the current document's URL and go to it
2542 #KEYMAP:H:HELP                  # Show default help screen
2543 #KEYMAP:F1:DWIMHELP             # Function key Help - Show a help screen
2544 #KEYMAP:i:INDEX                 # Show default index
2545 #*** Edit FORM_LINK_* messages in LYMessages_en.h if you change NOCACHE ***
2546 #KEYMAP:x:NOCACHE               # Force submission of form or link with no-cache
2547 #*** Do not change INTERRUPT from 'z' & 'Z' ***
2548 #KEYMAP:z:INTERRUPT             # Interrupt network transmission
2549 #KEYMAP:m:MAIN_MENU             # Return to the main menu
2550 #KEYMAP:o:OPTIONS               # Show the options menu
2551 #KEYMAP:i:INDEX_SEARCH          # Search a server based index
2552 #KEYMAP:/:WHEREIS               # Find a string within the current document
2553 #KEYMAP:n:NEXT                  # Find next occurrence of string within document
2554 #KEYMAP:c:COMMENT               # Comment to the author of the current document
2555 #KEYMAP:C:CHDIR                 # Change current directory
2556 #KEYMAP:e:EDIT                  # Edit current document or form's textarea (call: ^Ve)
2557 #KEYMAP:E:ELGOTO                # Edit the current link's URL or ACTION and go to it
2558 #KEYMAP:=:INFO                  # Show info about current document
2559 #KEYMAP:p:PRINT                 # Show print options
2560 #KEYMAP:a:ADD_BOOKMARK          # Add current document to bookmark list
2561 #KEYMAP:v:VIEW_BOOKMARK         # View the bookmark list
2562 #KEYMAP:V:VLINKS                # List links visited during the current Lynx session
2563 #KEYMAP:!:SHELL                 # Spawn default shell
2564 #KEYMAP:d:DOWNLOAD              # Download current link
2565 #KEYMAP:j:JUMP                  # Jump to a predefined target
2566 #KEYMAP:k:KEYMAP                # Display the current key map
2567 #KEYMAP:l:LIST                  # List the references (links) in the current document
2568 #KEYMAP:#:TOOLBAR               # Go to the Toolbar or Banner in the current document
2569 #KEYMAP:^T:TRACE_TOGGLE         # Toggle detailed tracing for debugging
2570 #KEYMAP:;:TRACE_LOG             # View trace log if available for the current session
2571 #KEYMAP:*:IMAGE_TOGGLE          # Toggle inclusion of links for all images
2572 #KEYMAP:[:INLINE_TOGGLE         # Toggle pseudo-ALTs for inlines with no ALT string
2573 #KEYMAP:]:HEAD                  # Send a HEAD request for current document or link
2574 #*** Must be compiled with USE_EXTERNALS to enable EXTERN_LINK, EXTERN_PAGE ***
2575 #KEYMAP:,:EXTERN_PAGE           # Run external program with current page
2576 #KEYMAP:.:EXTERN_LINK           # Run external program with current link
2577 #*** Escaping from text input fields with ^V is independent from this: ***
2578 #KEYMAP:^V:SWITCH_DTD           # Toggle between SortaSGML and TagSoup HTML parsing
2579 #KEYMAP:0x00:DO_NOTHING         # Does nothing (ignore this key)
2580 #KEYMAP:DO_NOTHING:DO_NOTHING   # Does nothing (ignore this key)
2581 #KEYMAP:{:SHIFT_LEFT            # shift the screen left
2582 #KEYMAP:}:SHIFT_RIGHT           # shift the screen right
2583 #KEYMAP:|:LINEWRAP_TOGGLE       # toggle linewrap on/off, for shift-commands
2584 #KEYMAP:~:NESTED_TABLES         # toggle nested-tables parsing on/off
2586 # In addition to the bindings available by default, the following functions
2587 # are not directly mapped to any keys by default, although some of them may
2588 # be mapped in specific line-editor bindings (effective while in text input
2589 # fields):
2592 #KEYMAP:???:RIGHT_LINK          # Move to the link to the right
2593 #KEYMAP:???:LEFT_LINK           # Move to the link to the left
2594 #KEYMAP:???:LPOS_PREV_LINK      # Like PREV_LINK, last column pos if form input
2595 #KEYMAP:???:LPOS_NEXT_LINK      # Like NEXT_LINK, last column pos if form input
2596 #*** Only useful in form text fields , need PASS or prefixing with ^V: ***
2597 #KEYMAP:???:DWIMHELP            # Display help page that may depend on context
2598 #KEYMAP:???:DWIMEDIT            # Use external editor for context-dependent purpose
2599 #*** Only useful in a form textarea, need PASS or prefixing with ^V: ***
2600 #KEYMAP:???:EDITTEXTAREA        # use external editor to edit a form textarea
2601 #KEYMAP:???:GROWTEXTAREA        # Add some blank lines to bottom of textarea
2602 #KEYMAP:???:INSERTFILE          # Insert file into a textarea (just above cursor)
2603 #*** Only useful with dired support and OK_INSTALL: ***
2604 #KEYMAP:???:INSTALL             # install (i.e. copy) local files to new location
2607 # If TOGGLE_HELP is mapped, in novice mode the second help menu line
2608 # can be toggled among NOVICE_LINE_TWO_A, _B, and _C, as defined in
2609 # LYMessages_en.h  Otherwise, it will be NOVICE_LINE_TWO.
2611 #KEYMAP:O:TOGGLE_HELP           # Show other commands in the novice help menu
2613 # KEYMAP lines can have one or two additional fields.  The extended format is
2614 #  KEYMAP:<KEYSTROKE>:[<MAIN LYNX FUNCTION>]:<OTHER BINDING>[:<SELECT>]
2616 # If the additional field OTHER BINDING specifies DIRED, then the function is
2617 # mapped in the override table used only in DIRED mode.  This is only valid
2618 # if lynx was compiled with dired support and OK_OVERRIDE defined.  A
2619 # MAIN LYNX FUNCTION must be given (it should of course be one that makes
2620 # sense in Dired mode), and SELECT is meaningless.  Default built-in override
2621 # mappings are
2623 #KEYMAP:^U:NEXT_DOC:DIRED       # Undo going back to the previous document
2624 #KEYMAP:.:TAG_LINK:DIRED        # Tag a file or directory for later action
2625 #KEYMAP:c:CREATE:DIRED          # Create a new file or directory
2626 #KEYMAP:C:CHDIR:DIRED           # change current directory
2627 #KEYMAP:f:DIRED_MENU:DIRED      # Display a menu of file operations
2628 #KEYMAP:m:MODIFY:DIRED          # Modify name or location of a file or directory
2629 #KEYMAP:r:REMOVE:DIRED          # Remove files or directories
2630 #KEYMAP:t:TAG_LINK:DIRED        # Tag a file or directory for later action
2631 #KEYMAP:u:UPLOAD:DIRED          # Show menu of "Upload Options"
2633 # If the OTHER BINDING field does not specify DIRED, then it is taken as a
2634 # line-editor action.  It is possible to keep the MAIN LYNX FUNCTION field
2635 # empty in that case, for changing only the line-editing behavior.
2636 # If alternative line edit styles are compiled in, and modifying a key's
2637 # line-editor binding on a per style basis is possible, then SELECT can be
2638 # used to specify which styles are affected.  By default, or if SELECT is
2639 # 0, all line edit styles are affected.  If SELECT is a positive integer
2640 # number, only the binding for the numbered style is changed (numbering
2641 # is in the order in which styles are shown in the Options Menu, starting
2642 # with 1 for the Default style).  If SELECT is negative (-n), all styles
2643 # except n are affected.
2646 #  NOP          # Do Nothing
2647 #  ABORT        # Input cancelled
2649 #  BOL          # Go to begin of line
2650 #  EOL          # Go to end   of line
2651 #  FORW         # Cursor forwards
2652 #  FORW_RL      # Cursor forwards or right link
2653 #  BACK         # Cursor backwards
2654 #  FORWW        # Word forward
2655 #  BACKW        # Word back
2656 #  BACK_LL      # Cursor backwards or left link
2658 #  DELN         # Delete next/curr char
2659 #  DELP         # Delete prev      char
2660 #  DELNW        # Delete next word
2661 #  DELPW        # Delete prev word
2662 #  DELBL        # Delete back to BOL
2663 #  DELEL        # Delete thru EOL
2664 #  ERASE        # Erase the line
2665 #  LOWER        # Lower case the line
2666 #  UPPER        # Upper case the line
2668 #  LKCMD        # In fields: Invoke key command prompt (default for ^V)
2669 #  PASS         # In fields: handle as non-lineedit key; in prompts: ignore
2672 # Modify following key (prefixing only works within line-editing, edit actions
2673 # of some resulting prefixed keys are built-in, see Line Editor help pages)
2674 #  SETM1        # Set modifier 1 flag (default for ^X - key prefix)
2675 #  SETM2        # Set modifier 2 flag (another key prefix - same effect)
2677 # May not always be compiled in:
2680 #  TPOS         # Transpose characters
2681 #  SETMARK      # emacs-like set-mark-command
2682 #  XPMARK       # emacs-like exchange-point-and-mark
2683 #  KILLREG      # emacs-like kill-region
2684 #  YANK         # emacs-like yank
2685 #  SWMAP        # Switch input keymap
2686 #  PASTE        # ClipBoard to Lynx - Windows Extension
2689 # May work differently from expected if not bound to their expected keys:
2692 #  CHAR         # Insert printable char (default for all ASCII printable)
2693 #  ENTER        # Input complete, return char/lynxkeycode (for RETURN/ENTER)
2694 #  TAB          # Input complete, return TAB (for ASCII TAB char ^I)
2697 # Internal use, probably not useful for binding, listed for completeness:
2700 #  UNMOD        # Fall back to no-modifier command
2701 #  AIX          # Hex 97
2702 #  C1CHAR       # Insert C1 char if printable
2705 # If OTHER BINDING specifies PASS, then if the key is pressed in a text input
2706 # field it is passed by the built-in line-editor to normal KEYMAP handling,
2707 # i.e. this flag acts like an implied ^V escape (always overrides line-editor
2708 # behavior of the key).  For example,
2709 #KEYMAP:INSERT_KEY:UP_TWO:PASS # Function key Insert - Move display up two lines
2711 # Other examples (repeating built-in bindings)
2712 #KEYMAP:^V::LKCMD       # set (only) line-edit action for ^V
2713 #KEYMAP:^V:SWITCH_DTD:LKCMD # set main lynxaction and line-edit action for ^V
2714 #KEYMAP:^U::ERASE:1     # set line-edit binding for ^U, for default style
2715 #KEYMAP:^[::SETM2:3     # use escape key as modifier - works only sometimes
2717 .h1 External Programs
2718 # These settings control the ability of Lynx to invoke various programs for
2719 # the user.
2721 .h2 CSWING_PATH
2722 # VMS ONLY:
2723 #==========
2724 # On VMS, CSwing (an XTree emulation for VTxxx terminals) is intended for
2725 # use as the Directory/File Manager (sources, objects, or executables were
2726 # available from ftp://narnia.memst.edu/).  CSWING_PATH should be defined
2727 # here or in userdefs.h to your foreign command for CSwing, with any
2728 # regulatory switches you want included.  If not defined, or defined as
2729 # a zero-length string ("") or "none" (case-insensitive), the support
2730 # will be disabled.  It will also be disabled if the -nobrowse or
2731 # -selective switches are used, or if the file_url restriction is set.
2733 # When enabled, the DIRED_MENU command (normally 'f' or 'F') will invoke
2734 # CSwing, normally with the current default directory as an argument to
2735 # position the user on that node of the directory tree.  However, if the
2736 # current document is a local directory listing, or a local file and not
2737 # one of the temporary menu or list files, the associated directory will
2738 # be passed as an argument, to position the user on that node of the tree.
2740 #CSWING_PATH:swing
2742 .h1 Internal Behavior
2744 .h2 AUTO_UNCACHE_DIRLISTS
2745 # AUTO_UNCACHE_DIRLISTS determines when local file directory listings are
2746 # automatically regenerated (by re-reading the actual directory from disk).
2747 # Set the value to 0 to avoid automatic regeneration in most cases.  This is
2748 # useful for browsing large directories that take some time to read and format.
2749 # An update can still always be forced with the RELOAD key, and specific DIRED
2750 # actions may cause a refresh anyway.  Set the value to 1 to force regeneration
2751 # after commands that usually change the directory or some files and would make
2752 # the displayed info stale, like EDIT and REMOVE.  Set it to 2 (the default) or
2753 # greater to force regeneration even after leaving the displayed directory
2754 # listing by some action that usually causes no change, like GOTO or entering a
2755 # file with the ACTIVATE key.  This option is only honored in DIRED mode (i.e.
2756 # when lynx is compiled with DIRED_SUPPORT and it is not disabled with a
2757 # -restriction).  Local directories displayed without DIRED normally act as if
2758 # AUTO_UNCACHE_DIRLISTS:0 was in effect.
2760 #AUTO_UNCACHE_DIRLISTS:2
2762 .h1 Appearance
2764 .h2 LIST_FORMAT
2765 # LIST_FORMAT defines the display for local files when Lynx has been
2766 # compiled with LONG_LIST defined in the Makefile.  The default is set
2767 # in userdefs.h, normally to "ls -l" format, and can be changed here
2768 # by uncommenting the indicated lines, or adding a definition with a
2769 # modified parameter list.
2771 # This feature is not available for VMS.
2773 # The percent items in the list are interpreted as follows:
2776 #       %p      Unix-style permission bits
2777 #       %l      link count
2778 #       %o      owner of file
2779 #       %g      group of file
2780 #       %d      date of last modification
2781 #       %a      anchor pointing to file or directory
2782 #       %A      as above but don't show symbolic links
2783 #       %t      type of file (description derived from MIME type)
2784 #       %T      MIME type as known by Lynx (from mime.types or default)
2785 #       %k      size of file in Kilobytes
2786 #       %K      as above but omit size for directories
2787 #       %s      size of file in bytes
2790 # Anything between the percent and the letter is passed on to sprintf.
2791 # A double percent yields a literal percent on output.  Other characters
2792 # are passed through literally.
2794 # If you want only the filename:
2797 #LIST_FORMAT:    %a
2799 # If you want a brief output:
2802 #LIST_FORMAT:   %4K %-12.12d %a
2804 # If you want the Unix "ls -l" format:
2807 #LIST_FORMAT:    %p %4l %-8.8o %-8.8g %7s %-12.12d %a
2809 .h1 External Programs
2811 .h2 DIRED_MENU
2812 # Unix ONLY:
2813 #===========
2814 # DIRED_MENU items are used to compose the F)ull menu list in DIRED mode
2815 # The behavior of the default configuration given here is much the same
2816 # as it was when this menu was hard-coded but these items can now be adjusted
2817 # to suit local needs.  In particular, many of the LYNXDIRED actions can be
2818 # replaced with lynxexec, lynxprog and lynxcgi script references.
2820 # NOTE that defining even one DIRED_MENU line overrides all the built-in
2821 # definitions, so a complete set must then be defined here.
2823 # Each line consists of the following fields:
2826 #       DIRED_MENU:type:suffix:link text:extra text:action
2828 #       type: TAG:   list only when one or more files are tagged
2829 #             FILE:  list only when the current selection is a regular file
2830 #             DIR:   list only when the current selection is a directory
2831 #             LINK:  list only when the current selection is a symbolic link
2833 #       suffix:  list only if the current selection ends in this pattern
2835 #       link text:  the displayed text of the link
2837 #       extra text:  the text displayed following the link
2839 #       action:  the URL to be followed upon selection
2841 #       link text and action are scanned for % sequences that are expanded
2842 #       at display time as follows:
2844 #               %p  path of current selection
2845 #               %f  filename (last component) of current selection
2846 #               %t  tagged list (full paths)
2847 #               %l  list of tagged file names
2848 #               %d  the current directory
2851 #DIRED_MENU:::New File:(in current directory):LYNXDIRED://NEW_FILE%d
2852 #DIRED_MENU:::New Directory:(in current directory):LYNXDIRED://NEW_FOLDER%d
2854 # Following depends on OK_INSTALL
2855 #DIRED_MENU:FILE::Install:selected file to new location:LYNXDIRED://INSTALL_SRC%p
2856 #DIRED_MENU:DIR::Install:selected directory to new location:LYNXDIRED://INSTALL_SRC%p
2858 #DIRED_MENU:FILE::Modify File Name:(of current selection):LYNXDIRED://MODIFY_NAME%p
2859 #DIRED_MENU:DIR::Modify Directory Name:(of current selection):LYNXDIRED://MODIFY_NAME%p
2860 #DIRED_MENU:LINK::Modify Name:(of selected symbolic link):LYNXDIRED://MODIFY_NAME%p
2862 # Following depends on OK_PERMIT
2863 #DIRED_MENU:FILE::Modify File Permissions:(of current selection):LYNXDIRED://PERMIT_SRC%p
2864 #DIRED_MENU:DIR::Modify Directory Permissions:(of current selection):LYNXDIRED://PERMIT_SRC%p
2866 #DIRED_MENU:FILE::Change Location:(of selected file):LYNXDIRED://MODIFY_LOCATION%p
2867 #DIRED_MENU:DIR::Change Location:(of selected directory):LYNXDIRED://MODIFY_LOCATION%p
2868 #DIRED_MENU:LINK::Change Location:(of selected symbolic link):LYNXDIRED://MODIFY_LOCATION%p
2869 #DIRED_MENU:FILE::Remove File:(current selection):LYNXDIRED://REMOVE_SINGLE%p
2870 #DIRED_MENU:DIR::Remove Directory:(current selection):LYNXDIRED://REMOVE_SINGLE%p
2871 #DIRED_MENU:LINK::Remove Symbolic Link:(current selection):LYNXDIRED://REMOVE_SINGLE%p
2873 # Following depends on OK_UUDECODE and !ARCHIVE_ONLY
2874 #DIRED_MENU:FILE::UUDecode:(current selection):LYNXDIRED://UUDECODE%p
2876 # Following depends on OK_TAR and !ARCHIVE_ONLY
2877 #DIRED_MENU:FILE:.tar.Z:Expand:(current selection):LYNXDIRED://UNTAR_Z%p
2879 # Following depend on OK_TAR and OK_GZIP and !ARCHIVE_ONLY
2880 #DIRED_MENU:FILE:.tar.gz:Expand:(current selection):LYNXDIRED://UNTAR_GZ%p
2881 #DIRED_MENU:FILE:.tgz:Expand:(current selection):LYNXDIRED://UNTAR_GZ%p
2883 # Following depends on !ARCHIVE_ONLY
2884 #DIRED_MENU:FILE:.Z:Uncompress:(current selection):LYNXDIRED://DECOMPRESS%p
2886 # Following depends on OK_GZIP and !ARCHIVE_ONLY
2887 #DIRED_MENU:FILE:.gz:Uncompress:(current selection):LYNXDIRED://UNGZIP%p
2889 # Following depends on OK_ZIP and !ARCHIVE_ONLY
2890 #DIRED_MENU:FILE:.zip:Uncompress:(current selection):LYNXDIRED://UNZIP%p
2892 # Following depends on OK_TAR and !ARCHIVE_ONLY
2893 #DIRED_MENU:FILE:.tar:UnTar:(current selection):LYNXDIRED://UNTAR%p
2895 # Following depends on OK_TAR
2896 #DIRED_MENU:DIR::Tar:(current selection):LYNXDIRED://TAR%p
2898 # Following depends on OK_TAR and OK_GZIP
2899 #DIRED_MENU:DIR::Tar and compress:(using GNU gzip):LYNXDIRED://TAR_GZ%p
2901 # Following depends on OK_ZIP
2902 #DIRED_MENU:DIR::Package and compress:(using zip):LYNXDIRED://ZIP%p
2904 #DIRED_MENU:FILE::Compress:(using Unix compress):LYNXDIRED://COMPRESS%p
2906 # Following depends on OK_GZIP
2907 #DIRED_MENU:FILE::Compress:(using gzip):LYNXDIRED://GZIP%p
2909 # Following depends on OK_ZIP
2910 #DIRED_MENU:FILE::Compress:(using zip):LYNXDIRED://ZIP%p
2912 #DIRED_MENU:TAG::Move all tagged items to another location.::LYNXDIRED://MOVE_TAGGED%d
2914 # Following depends on OK_INSTALL
2915 #DIRED_MENU:TAG::Install tagged files into another directory.::LYNXDIRED://INSTALL_SRC%00
2917 #DIRED_MENU:TAG::Remove all tagged files and directories.::LYNXDIRED://REMOVE_TAGGED
2918 #DIRED_MENU:TAG::Untag all tagged items.::LYNXDIRED://CLEAR_TAGGED
2920 .h1 Internal Behavior
2922 .h2 NONRESTARTING_SIGWINCH
2923 # Some systems only:
2924 #===================
2925 # Lynx tries to detect window size changes with a signal handler for
2926 # SIGWINCH if supported.  If NONRESTARTING_SIGWINCH is set to TRUE,
2927 # and the sigaction interface is available on the system, the handler
2928 # is installed as 'non-restarting'.  On some systems (depending on the
2929 # library used for handling keyboard input, e.g. ncurses), this allows
2930 # more immediate notification of window size change events.  If the value
2931 # is set to FALSE, the signal() interface is used; this normally makes
2932 # the handler 'restarting', with the effect that lynx can react to size
2933 # changes only after some key is pressed.  The value can also be set to
2934 # XWINDOWS; this is equivalent to TRUE when the user has the environment
2935 # variable DISPLAY defined *at program start*, and equivalent to FALSE
2936 # otherwise.  The non-restarting behavior can also be changed to TRUE
2937 # or FALSE with the -nonrestarting_sigwinch switch, which overrides the
2938 # value in this file.
2940 # Note that Lynx never re-parses document text purely as a result of a
2941 # window size change, so text lines may appear truncated after narrowing
2942 # the window, until the document is reloaded with ^R or a similar key
2943 # or until a different text is loaded.
2945 # The default is FALSE since there is a possibility that non-restarting
2946 # interrupts may be mis-interpreted as fatal input errors in some
2947 # configurations (leading to an abrupt program exit), and since this
2948 # option is useful mostly only for users running Lynx under xterm or a
2949 # similar X terminal emulator.  On systems where the preconditions don't
2950 # apply this option is ignored.
2952 #NONRESTARTING_SIGWINCH:FALSE
2954 .h2 NO_FORCED_CORE_DUMP
2955 # Unix ONLY:
2956 #===========
2957 # If NO_FORCED_CORE_DUMP is set to TRUE, Lynx will not force
2958 # core dumps via abort() calls on fatal errors or assert()
2959 # calls to check potentially fatal errors.  The compilation
2960 # default normally is FALSE, and can be changed here.  The
2961 # compilation or configuration default can be toggled via
2962 # the -core command line switch.
2963 # Note that this setting cannot be used to prevent core dumps
2964 # with certainty.  If this is important, means provided by the
2965 # operating system or kernel should be used.
2967 #NO_FORCED_CORE_DUMP:FALSE
2969 .h1 Appearance
2971 .h2 COLOR
2972 # COLORS are only available if compiled with SVr4 curses or slang.  This is
2973 # the old color configuration.  The COLOR_STYLE configuration is compiled-in
2974 # and can simulate this if the ".lss" filename is empty.
2976 # The line must be of the form:
2978 # COLOR:Integer:Foreground:Background
2981 # The Integer value is interpreted as follows:
2982 #   0 - normal                      - normal text
2983 #   1 - bold                        - hyperlinks, see also BOLD_* options above
2984 #   2 - reverse                     - statusline
2985 #   3 - bold + reverse              (not used)
2986 #   4 - underline                   - text emphasis (EM, I, B tags etc.)
2987 #   5 - bold + underline            - hyperlinks within text emphasis
2988 #   6 - reverse + underline         - currently selected hyperlink
2989 #   7 - reverse + underline + bold  - WHEREIS search hits
2991 # Each Foreground and Background value must be one of:
2992 #   black         red            green         brown
2993 #   blue          magenta        cyan          lightgray
2994 #   gray          brightred      brightgreen   yellow
2995 #   brightblue    brightmagenta  brightcyan    white
2997 # or (if you have configured using -enable-default-colors with ncurses or
2998 # slang), "default" may be used for foreground and background.
3000 # Note that in most cases a white background is really "lightgray", since
3001 # terminals generally do not implement bright backgrounds.
3003 # Uncomment and change any of the compilation defaults.
3005 #COLOR:0:black:white
3006 #COLOR:1:blue:white
3007 #COLOR:2:yellow:blue
3008 #COLOR:3:green:white
3009 #COLOR:4:magenta:white
3010 #COLOR:5:blue:white
3011 #COLOR:6:red:white
3012 COLOR:6:brightred:black
3013 #COLOR:7:magenta:cyan
3015 .h2 COLOR_STYLE
3016 # Also known as "lss" (lynx style-sheet), the color-style file assigns color
3017 # combination to tags and combinations of tags.  Normally a non-empty value
3018 # is compiled into lynx, and the user can override that using the -lss
3019 # command-line option.  The configure script allows one to compile in an
3020 # empty string.  If lynx finds no value for this setting, it simulates the
3021 # non-color-style assignments using the COLOR settings.
3023 # If neither the command-line "-lss" or this COLOR_STYLE setting are given,
3024 # lynx tries the environment variables "LYNX_LSS" and "lynx_lss".  If neither
3025 # is set, lynx uses the first compiled-in value (which as noted, may be empty).
3027 # At startup, lynx remembers the name of the color-style file which was used,
3028 # and together with each file specified, provides those as choices in the
3029 # O)ptions menu.
3031 #COLOR_STYLE: lynx.lss
3032 #COLOR_STYLE: blue-background.lss
3033 #COLOR_STYLE: bright-blue.lss
3034 #COLOR_STYLE: midnight.lss
3035 #COLOR_STYLE: mild-colors.lss
3036 #COLOR_STYLE: opaque.lss
3038 .h2 NESTED_TABLES
3039 # This is an experimental feature for improving table layout.
3040 # It is enabled by default when the COLOR_STYLE configuration is used,
3041 # and false otherwise.
3043 #NESTED_TABLES: true
3045 .h2 NO_TABLE_CENTER
3046 # Normally table cells are centered on the table grid.
3047 # Set this option to true to disable centering.
3048 # The -center command-line option toggles this setting between true/false.
3049 #NO_TABLE_CENTER: false
3051 .h2 ASSUMED_COLOR
3052 # If built with a library that recognizes default colors (usually ncurses or
3053 # slang), and if the corresponding option is compiled into lynx, lynx
3054 # initializes it to assume the corresponding foreground and background colors.
3055 # Default colors are those that the terminal (emulator) itself is initialized
3056 # to.  For instance, you might have an xterm running with black text on a white
3057 # background, and want lynx to display colored text on the white background,
3058 # but leave the possibility of using the same configuration to draw colored
3059 # text on a different xterm, this time using its background set to black.
3061 # If built with conventional SVr3/SVr4 curses, tells lynx to use color pair 0
3062 # when the given colors match this setting.  That gives a similar effect,
3063 # though not as flexible.  You will get the best results by setting the
3064 # terminal's default colors to match the prevailing text and background colors
3065 # that you have setup with lynx, and then alter the ASSUMED_COLOR setting to
3066 # match that.  If you do not alter the ASSUMED_COLOR setting, curses assumes
3067 # color pair 0's background is black, which implies that its foreground (text)
3068 # is white.
3070 # The first value given is the foreground, the second is the background.
3071 #ASSUMED_COLOR:default:default
3073 .h2 DEFAULT_COLORS
3074 # If built with a library that recognizes default colors (usually ncurses or
3075 # slang), and if the corresponding option is compiled into lynx, lynx
3076 # initializes it to assume the corresponding foreground and background colors.
3077 # Default colors are those that the terminal (emulator) itself is initialized
3078 # to.
3080 # Use this feature to disable the default-colors feature at runtime.
3081 # This is useful for constructing scripts which use the non-color-style
3082 # scheme, e.g., the oldlynx script.
3084 # This should precede ASSUMED_COLOR settings.
3085 #DEFAULT_COLORS:true
3087 .h1 External Programs
3089 .h2 EXTERNAL
3090 # External application support.  This feature allows Lynx to pass a given
3091 # URL to an external program.  It was written for three reasons.
3093 # 1) To overcome the deficiency of Lynx_386 not supporting ftp and news.
3094 #    External programs can be used instead by passing the URL.
3096 # 2) To allow for background    transfers in multitasking systems.
3097 #    I use wget for http and ftp transfers via the external command.
3099 # 3) To allow for new URLs to be used through Lynx.
3100 #         URLs can be made up such as mymail: to spawn desired applications
3101 #         via the external command.
3103 # Restrictions can be imposed using -restrictions=externals at the Lynx command
3104 # line.  This will disallow all EXTERNAL lines in lynx.cfg that have FALSE in
3105 # the 3rd field (not counting the name of the setting).  TRUE lines will still
3106 # function.
3108 # The lynx.cfg line is as follows:
3110 # EXTERNAL:<url>:<command> %s:<norestriction>:<allow_for_activate>[:environment]
3112 # <url> Any given URL.  This can be normal ones like ftp or http or it
3113 # can be one made up like mymail.
3115 # <command> The command to run with %s being the URL that will be passed.
3116 # In Linux I use "wget -q %s &" (no quotes) to spawn a copy of wget for
3117 # downloading http and ftp files in the background.  In Win95 I use
3118 # "start ncftp %s" to spawn ncftp in a new window.
3120 # <norestriction> This complements the -restrictions=externals feature to allow
3121 # for certain externals to be enabled while restricting others.  TRUE means
3122 # a command will still function while Lynx is restricted.  WB
3124 # <allow_for_activate> Setting this to TRUE allows the use of this command not
3125 # only when EXTERN key is pressed, but also when ACTIVATE command is invoked
3126 # (i.e., activating the link with the given prefix will be equivalent to
3127 # pressing EXTERN key on it).  If this component of the line is absent, then
3128 # FALSE is assumed.
3130 # [:environment] Optional, if XWINDOWS then command is allowed only if
3131 # $DISPLAY environment variable is set, else if NON_XWINDOWS then command
3132 # is allowed only if $DISPLAY environment variable is not set, if absent or
3133 # anything else command is always allowed.
3135 # For invoking the command use the EXTERN_LINK or EXTERN_PAGE key.  By default
3136 # EXTERN_LINK is mapped to '.', and EXTERN_PAGE to ',' (if the feature is
3137 # enabled), see the KEYMAP section above.
3139 #EXTERNAL:ftp:wget %s &:TRUE
3141 .h2 EXTERNAL_MENU
3142 # Like EXTERNAL, but allows customizing the menu name.
3143 # Here is the syntax:
3144 .ex 1
3145 # EXTERNAL_MENU:<url>:<menu>:<command> %s:<norestriction>:<allow_for_activate>[:environment]
3147 .h1 Internal Behavior
3149 .h2 RULE
3150 .h2 RULESFILE
3151 # CERN-style rules, EXPERIMENTAL  -  URL-specific rules
3153 # A CERN-style rules file can be given with RULESFILE.  Use the system's
3154 # native format for filenames, on Unix '~' is also recognized.  If a filename
3155 # is given, the file must exist.
3157 # Single CERN-style rules can be specified with RULES.
3159 # Both options can be repeated, rules accumulate in the order
3160 # given, they will be applied in first-to-last order.  See cernrules.txt
3161 # in the samples subdirectory for further explanation.
3163 # Examples:
3164 .ex 5
3165 #       RULESFILE:/etc/lynx/cernrules
3166 #       RULE:Fail       gopher:*                     # reject by scheme
3167 #       RULE:Pass       finger://*@localhost/        # allow this,
3168 #       RULE:Fail       finger:*                     # but not others
3169 #       RULE:Redirect   http://old.server/*     http://new.server/*
3171 .h1 Appearance
3173 .h2 PRETTYSRC
3174 # Enable pretty source view
3175 #PRETTYSRC:FALSE
3177 .h2 PRETTYSRC_SPEC
3178 # Pretty source view settings. These settings are in effect when -prettysrc
3179 # is specified.
3180 # The following lexical elements (lexemes) are recognized:
3181 # comment, tag, attribute, attribute value, generalized angle brackets (
3182 # '<' '>' '</' ), entity, hyperlink destination, entire file, bad sequence,
3183 # bad tag, bad attribute, sgml special.
3184 #  The following group of option tells which styles will surround each
3185 # lexeme. The syntax of option in this group is:
3186 #PRETTYSRC_SPEC:<LEXEMENAME>:<TAGSPEC>:<TAGSPEC>
3187 # The first <TAGSPEC> specifies what tags will precede lexemes of that class
3188 # in the internal html markup. The second - what will be placed (internally)
3189 # after it.
3190 # TAGSPEC has the following syntax:
3191 # <TAGSPEC>:= [ (<TAGOPEN> | <TAGCLOSE>) <SPACE>+ ]*
3192 # <TAGOPEN>:= tagname[.classname]
3193 # <TAGCLOSE>:= !tagname
3195 # The following table gives correspondence between lexeme and lexeme name
3197 # Lexeme                   LEXEMENAME  FURTHER EXPLANATION
3198 # =========================================================
3199 # comment                  COMM
3200 # tag                      TAG         recognized tag name only
3201 # attribute                ATTRIB
3202 # attribute value          ATTRVAL
3203 # generalized brackets     ABRACKET    <  >  </
3204 # entity                   ENTITY
3205 # hyperlink destination    HREF
3206 # entire file              ENTIRE
3207 # bad sequence             BADSEQ      bad entity or invalid construct at text
3208 #                                      level.
3209 # bad tag                  BADTAG      Unrecognized construct in generalized
3210 #                                      brackets.
3211 # bad attribute            BADATTR     The name of the attribute unknown to lynx
3212 #                                      of the tag known to lynx. (i.e.,
3213 #                                      attributes of unknown tags will have
3214 #                                      markup of  ATTRIB)
3215 # sgml special             SGMLSPECIAL doctype, sgmlelt, sgmlele,
3216 #                                      sgmlattlist, marked section, identifier
3219 # Notes:
3221 # 1) The markup for HTML_ENTIRE will be emitted only once - it will surround
3222 #    entire file source.
3224 # 2) The tagnames specified by TAGSPEC should be valid html tag names.
3226 # 3) If the tag/class combination given by TAGOPEN is not assigned a color
3227 #    style in lss file (for lynx compiled with lss support), that tag/class
3228 #    combination will be emitted anyway during internal html markup. Such
3229 #    combinations will be also reported to the trace log.
3231 # 4) Lexeme 'tag' means tag name only
3233 # 5) Angle brackets of html specials won't be surrounded by markup for ABRACKET
3236 # PRETTYSRC_SPEC:COMM:B I:!I !B
3237 #           HTML comments will be surrounded by <b><i> and </i></b> in the
3238 #           internal html markup
3240 # PRETTYSRC_SPEC:ATTRVAL: span.attrval : !span
3241 #           Values of the attributes will be surrounded by the
3242 #           <SPAN class=attrval> </SPAN>
3244 # PRETTYSRC_SPEC:HREF::
3245 #           No special html markup will surround hyperlink destinations (
3246 #           this means that only default color style for hrefs will be applied
3247 #           to them)
3249 # For lynx compiled with lss support, the following settings are the default:
3250 #PRETTYSRC_SPEC:COMM:span.htmlsrc_comment:!span
3251 #PRETTYSRC_SPEC:TAG:span.htmlsrc_tag:!span
3252 #PRETTYSRC_SPEC:ATTRIB:span.htmlsrc_attrib:!span
3253 #PRETTYSRC_SPEC:ATTRVAL:span.htmlsrc_attrval:!span
3254 #PRETTYSRC_SPEC:ABRACKET:span.htmlsrc_abracket:!span
3255 #PRETTYSRC_SPEC:ENTITY:span.htmlsrc_entity:!span
3256 #PRETTYSRC_SPEC:HREF:span.htmlsrc_href:!span
3257 #PRETTYSRC_SPEC:ENTIRE:span.htmlsrc_entire:!span
3258 #PRETTYSRC_SPEC:BADSEQ:span.htmlsrc_badseq:!span
3259 #PRETTYSRC_SPEC:BADTAG:span.htmlsrc_badtag:!span
3260 #PRETTYSRC_SPEC:BADATTR:span.htmlsrc_badattr:!span
3261 #PRETTYSRC_SPEC:SGMLSPECIAL:span.htmlsrc_sgmlspecial:!span
3262 # the styles corresponding to them are present in sample .lss file.
3263 # For lynx compiled without lss support, the following settings are the default:
3264 #PRETTYSRC_SPEC:COMM:b:!b
3265 #PRETTYSRC_SPEC:TAG:b:!b
3266 #PRETTYSRC_SPEC:ATTRIB:b:!b
3267 #PRETTYSRC_SPEC:ATTRVAL::
3268 #PRETTYSRC_SPEC:ABRACKET:b:!b
3269 #PRETTYSRC_SPEC:ENTITY:b:!b
3270 #PRETTYSRC_SPEC:HREF::
3271 #PRETTYSRC_SPEC:ENTIRE::
3272 #PRETTYSRC_SPEC:BADSEQ:b:!b
3273 #PRETTYSRC_SPEC:BADTAG::
3274 #PRETTYSRC_SPEC:BADATTR::
3275 #PRETTYSRC_SPEC:SGMLSPECIAL:b:!b
3277 .h2 HTMLSRC_ATTRNAME_XFORM
3278 .h2 HTMLSRC_TAGNAME_XFORM
3279 # Options HTMLSRC_TAGNAME_XFORM and HTMLSRC_ATTRNAME_XFORM control the way the
3280 # names of tags and names of attributes are transformed correspondingly.
3281 # Possible values: 0 - lowercase, 1 - leave as is, 2 - uppercase.
3282 #HTMLSRC_TAGNAME_XFORM:2
3283 #HTMLSRC_ATTRNAME_XFORM:2
3285 .h2 PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING
3286 # PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING - pretty source view setting
3287 # If "keypad mode" in 'O'ptions screen is "Links are numbered" or
3288 # "Links and form fields are numbered", and PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING is
3289 # TRUE, then links won't be numbered in psrc view and will be numbered
3290 # otherwise. Set this setting to TRUE if you prefer numbered links, but wish
3291 # to get valid HTML source when printing or mailing when in psrc view.
3292 # Default is FALSE.
3293 #PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING:FALSE
3295 .h1 HTML Parsing
3297 .h2 FORCE_EMPTY_HREFLESS_A
3298 # FORCE_EMPTY_HREFLESS_A - HTML parsing
3299 # This option mirrors command-line option with the same name.  Default is
3300 # FALSE.  If true, then any 'A' element without HREF will be closed
3301 # immediately.  This is useful when viewing documentation produced by broken
3302 # translator that doesn't emit balanced A elements.  If lynx was compiled with
3303 # color styles, setting this option to TRUE will make lynx screen much more
3304 # reasonable (otherwise all text will probably have color corresponding to the
3305 # A element).
3307 #FORCE_EMPTY_HREFLESS_A:FALSE
3309 .h2 HIDDEN_LINK_MARKER
3310 # HIDDEN_LINK_MARKER - HTML parsing
3311 # This option defines the string that will be used as title of hidden link (a
3312 # link that otherwise will have no label associated with it).  Using an empty
3313 # string as the value will cause lynx to behave in the old way - hidden links
3314 # will be handled according to other settings (mostly the parameter of
3315 # -hiddenlinks command-line switch).  If the value is non-empty string, hidden
3316 # link becomes non-hidden so it won't be handled as hidden link, e.g., listed
3317 # among hidden links on 'l'isting page.
3319 #HIDDEN_LINK_MARKER:
3321 .h2 XHTML_PARSING
3322 # XHTML_PARSING - HTML parsing
3323 # When true, tells lynx that it can ignore certain tags which have no content
3324 # in an XHTML 1.0 document.  For example
3325 #       <p />
3326 #       <a />
3327 # When the option is false, lynx will not treat the tag as an ending.
3328 #XHTML_PARSING:FALSE
3330 .h1 Appearance
3332 .h2 JUSTIFY
3333 # JUSTIFY - Appearance
3334 # This option mirrors command-line option with same name.  Default is TRUE.  If
3335 # true, most of text (except headers and like this) will be justified.  This
3336 # has no influence on CJK text rendering.
3338 # This option is only available if Lynx was compiled with USE_JUSTIFY_ELTS.
3340 #JUSTIFY:FALSE
3342 .h2 JUSTIFY_MAX_VOID_PERCENT
3343 # JUSTIFY_MAX_VOID_PERCENT - Appearance
3344 # This option controls the maximum allowed value for ratio (in percents) of
3345 # 'the number of spaces to spread across the line to justify it' to
3346 # 'max line size for current style and nesting' when justification is allowed.
3347 # When that ratio exceeds the value specified, that particular line won't be
3348 # justified. I.e. the value 28 for this setting will mean maximum value for
3349 # that ratio is 0.28.
3351 #JUSTIFY_MAX_VOID_PERCENT:35
3353 .h1 Interaction
3355 .h2 TEXTFIELDS_NEED_ACTIVATION
3356 # If TEXTFIELDS_NEED_ACTIVATION is set to TRUE, and lynx was compiled with
3357 # TEXTFIELDS_MAY_NEED_ACTIVATION defined, then text input form fields need
3358 # to be activated (by pressing the Enter key or similar) before the user
3359 # can enter or modify input.  By default, input fields become automatically
3360 # activated when selected.  Requiring explicit activation can be desired for
3361 # users who use alphanumeric keys for navigation (or other keys that have
3362 # special meaning in the line editor - ' ', 'b', INS, DEL, etc), and don't
3363 # want to 'get stuck' in form fields.  Instead of setting the option here,
3364 # explicit activation can also be requested with the -tna command line
3365 # option.
3367 #TEXTFIELDS_NEED_ACTIVATION:FALSE
3369 .h2 LEFTARROW_IN_TEXTFIELD_PROMPT
3370 # LEFTARROW_IN_TEXTFIELD_PROMPT
3371 # This option controls what happens when a Left Arrow key is pressed while
3372 # in the first position of an active text input field.  By default, Lynx
3373 # asks for confirmation ("Do you want to go back to the previous document?")
3374 # only if the contents of the fields have been changed since entering it.
3375 # If set to TRUE, the confirmation prompt is always issued.
3377 #LEFTARROW_IN_TEXTFIELD_PROMPT:FALSE
3379 .h1 Timeouts
3381 .h2 CONNECT_TIMEOUT
3382 # Specifies (in seconds) connect timeout. Default value is rather huge.
3383 #CONNECT_TIMEOUT:18000
3385 .h2 READ_TIMEOUT
3386 # Specifies (in seconds) read-timeout. Default value is rather huge.
3387 #READ_TIMEOUT:18000
3389 .h1 Internal Behavior
3390 # These settings control internal lynx behavior - the way it interacts with the
3391 # operating system and Internet.  Modifying these settings will not change
3392 # the rendition of documents that you browse with lynx, but can change various
3393 # delays and resource utilization.
3395 .h2 FTP_PASSIVE
3396 # Set FTP_PASSIVE to TRUE if you want to use passive mode ftp transfers.
3397 # You might have to do this if you're behind a restrictive firewall.
3398 #FTP_PASSIVE:TRUE
3400 .h2 ENABLE_LYNXRC
3401 # The forms-based O'ptions menu shows a (!) marker beside items which are not
3402 # saved to ~/.lynxrc -- the reason for disabling some of these items is that
3403 # they are likely to cause confusion if they are read from the .lynxrc file for
3404 # each session.  However, they can be enabled or disabled using the
3405 # ENABLE_LYNXRC settings.  The default (compiled-in) settings are shown below.
3406 # The second column is the name by which a setting is saved to .lynxrc (which
3407 # is chosen where possible to correspond with lynx.cfg).  Use "OFF" to disable
3408 # writing a setting, "ON" to enable it.  Settings are read from .lynxrc after
3409 # the corresponding data from lynx.cfg, so they override lynx.cfg, which is
3410 # probably what users expect.
3412 # Note that a few settings (Cookies and Show images) are comprised of more than
3413 # one lynx.cfg setting.
3415 ENABLE_LYNXRC:ACCEPT_ALL_COOKIES:ON
3416 ENABLE_LYNXRC:ASSUME_CHARSET:ON
3417 ENABLE_LYNXRC:AUTO_SESSION:ON
3418 ENABLE_LYNXRC:BOOKMARK_FILE:ON
3419 ENABLE_LYNXRC:CASE_SENSITIVE_SEARCHING:ON
3420 ENABLE_LYNXRC:CHARACTER_SET:ON
3421 ENABLE_LYNXRC:COLLAPSE_BR_TAGS:ON
3422 ENABLE_LYNXRC:COOKIE_ACCEPT_DOMAINS:ON
3423 ENABLE_LYNXRC:COOKIE_FILE:ON
3424 ENABLE_LYNXRC:COOKIE_LOOSE_INVALID_DOMAINS:ON
3425 ENABLE_LYNXRC:COOKIE_QUERY_INVALID_DOMAINS:ON
3426 ENABLE_LYNXRC:COOKIE_REJECT_DOMAINS:ON
3427 ENABLE_LYNXRC:COOKIE_STRICT_INVALID_DOMAIN:ON
3428 ENABLE_LYNXRC:DIR_LIST_STYLE:ON
3429 ENABLE_LYNXRC:DISPLAY:ON
3430 ENABLE_LYNXRC:EMACS_KEYS:ON
3431 ENABLE_LYNXRC:FILE_EDITOR:ON
3432 ENABLE_LYNXRC:FILE_SORTING_METHOD:ON
3433 ENABLE_LYNXRC:FORCE_COOKIE_PROMPT:ON
3434 ENABLE_LYNXRC:FORCE_SSL_PROMPT:ON
3435 ENABLE_LYNXRC:FTP_PASSIVE:ON
3436 ENABLE_LYNXRC:HTML5_CHARSETS:ON
3437 ENABLE_LYNXRC:HTTP_PROTOCOL:ON
3438 ENABLE_LYNXRC:IDNA_MODE:TR46
3439 ENABLE_LYNXRC:KBLAYOUT:ON
3440 ENABLE_LYNXRC:KEYPAD_MODE:ON
3441 ENABLE_LYNXRC:LINEEDIT_MODE:ON
3442 ENABLE_LYNXRC:LOCALE_CHARSET:ON
3443 ENABLE_LYNXRC:MAKE_LINKS_FOR_ALL_IMAGES:ON
3444 ENABLE_LYNXRC:MAKE_PSEUDO_ALTS_FOR_INLINES:ON
3445 ENABLE_LYNXRC:MULTI_BOOKMARK:ON
3446 ENABLE_LYNXRC:NO_PAUSE:ON
3447 ENABLE_LYNXRC:PERSONAL_MAIL_ADDRESS:ON
3448 ENABLE_LYNXRC:PREFERRED_CHARSET:ON
3449 ENABLE_LYNXRC:PREFERRED_ENCODING:ON
3450 ENABLE_LYNXRC:PREFERRED_LANGUAGE:ON
3451 ENABLE_LYNXRC:PREFERRED_MEDIA_TYPES:ON
3452 ENABLE_LYNXRC:RAW_MODE:ON
3453 ENABLE_LYNXRC:RUN_ALL_EXECUTION_LINKS:ON
3454 ENABLE_LYNXRC:RUN_EXECUTION_LINKS_LOCAL:ON
3455 ENABLE_LYNXRC:SCROLLBAR:ON
3456 ENABLE_LYNXRC:SELECT_POPUPS:ON
3457 ENABLE_LYNXRC:SEND_USERAGENT:ON
3458 ENABLE_LYNXRC:SESSION_FILE:ON
3459 ENABLE_LYNXRC:SET_COOKIES:ON
3460 ENABLE_LYNXRC:SHOW_CURSOR:ON
3461 ENABLE_LYNXRC:SHOW_KB_RATE:ON
3462 ENABLE_LYNXRC:SUB_BOOKMARKS:ON
3463 ENABLE_LYNXRC:TAGSOUP:ON
3464 ENABLE_LYNXRC:UNDERLINE_LINKS:ON
3465 ENABLE_LYNXRC:USER_MODE:ON
3466 ENABLE_LYNXRC:USERAGENT:ON
3467 ENABLE_LYNXRC:VERBOSE_IMAGES:ON
3468 ENABLE_LYNXRC:VI_KEYS:ON
3469 ENABLE_LYNXRC:VISITED_LINKS:ON
3472 .h1 External Programs
3473 # Any of the compiled-in pathnames of external programs can be overridden
3474 # by specifying the corresponding xxx_PATH variable.  If the variable is
3475 # given as an empty string, lynx will not use the program.  For a few cases,
3476 # there are internal functions which can be used instead.
3478 .h2 BZIP2_PATH
3479 # This is the path used for DIRED mode and web connections to compress a file
3480 # to ".bz2", e.g., the Unix command "bzip2".
3482 .h2 CHMOD_PATH
3483 # This is the path used for DIRED mode to change file protection, e.g., the
3484 # Unix command "chmod".
3486 # Setting this to an empty string will let lynx use a built-in version.
3488 .h2 COMPRESS_PATH
3489 # This is the path used for DIRED mode and web connections to compress a file
3490 # to ".Z", e.g., the Unix command "compress".
3492 .h2 COPY_PATH
3493 # This is the path used for DIRED mode to copy a file, e.g., the
3494 # Unix command "cp".
3496 # Setting this to an empty string will let lynx use a built-in version.
3498 .h2 GZIP_PATH
3499 # This is the path used for DIRED mode and web connections to compress a file
3500 # to ".gz", e.g., the Unix command "gzip".
3502 .h2 INFLATE_PATH
3503 # This is the path used for web connections to compress a file using "inflate"
3504 # compression.
3506 .h2 INSTALL_PATH
3507 # This is the path used for DIRED mode to install files, e.g., the
3508 # Unix command "install".
3510 .h2 MKDIR_PATH
3511 # This is the path used for DIRED mode to create a directory, e.g., the
3512 # Unix command "mkdir".
3514 # Setting this to an empty string will let lynx use a built-in version.
3516 .h2 MV_PATH
3517 # This is the path used for DIRED mode to move a file, e.g., the
3518 # Unix command "mv".
3520 # Setting this to an empty string will let lynx use a built-in version.
3522 .h2 RLOGIN_PATH
3523 # This is the path used for DIRED mode to login remotely, e.g., the
3524 # Unix command "rlogin".
3526 .h2 RMDIR_PATH
3527 # This is the path used for DIRED mode to remove a directory, e.g., the
3528 # Unix command "rmdir".
3530 # Setting this to an empty string will let lynx use a built-in version.
3532 .h2 RM_PATH
3533 # This is the path used for DIRED mode to remove a file, e.g., the
3534 # Unix command "rm".
3536 # Setting this to an empty string will let lynx use a built-in version.
3538 .h2 SETFONT_PATH
3539 # This is the path used for a command which can be used to load a console font
3540 # for the experimental font-switch feature, e.g., the program "setfont".
3542 .h2 TAR_PATH
3543 # This is the path used for DIRED mode to create a tar archive from one or more
3544 # files.
3546 .h2 TELNET_PATH
3547 # This is the path for a program which can be used to make a "telnet" connection
3548 # to a remote host.
3550 .h2 TN3270_PATH
3551 # This is the path for a program which can be used to make an "IBM 3270"
3552 # connection to a remote host.
3554 .h2 TOUCH_PATH
3555 # This is the path used for DIRED mode to update the modification time of a
3556 # file to the current time,, e.g., the Unix command "touch".
3558 # Setting this to an empty string will let lynx use a built-in version.
3560 .h2 UNCOMPRESS_PATH
3561 # This is the path used for DIRED mode and web connections to decompress a file
3562 # with ".Z" suffix, e.g., the Unix command "uncompress".
3564 .h2 UNZIP_PATH
3565 # This is the path used for DIRED mode to extract files from a zip-archive the
3566 # program "unzip".
3568 .h2 UUDECODE_PATH
3569 # This is the path used for DIRED mode to extract files from uuencoded files
3570 # e.g., the program "uudecode".
3572 .h2 ZCAT_PATH
3573 # This is the path used for DIRED mode to decompress files, writing the result
3574 # to a pipe as part of a shell command, e.g., the program "zcat".
3576 .h2 ZIP_PATH
3577 # This is the path used for DIRED mode to create a zip-archive from one or more
3578 # files, e.g., the program "unzip".
3580 .h1 Interaction
3582 .h2 FORCE_SSL_PROMPT
3583 # If FORCE_SSL_PROMPT is set to "yes", then questionable conditions, such as
3584 # self-signed certificates will be ignored.  If set to "no", these will be
3585 # reported, but not attempted.  The default "prompt" permits the user to make
3586 # this choice on a case-by-case basis.
3588 #FORCE_SSL_PROMPT:PROMPT
3590 .h2 FORCE_COOKIE_PROMPT
3591 # If FORCE_COOKIE_PROMPT is set to "yes", then questionable conditions, such as
3592 # cookies with invalid syntax will be ignored.  If set to "no", these will be
3593 # reported, but not attempted.  The default "prompt" permits the user to make
3594 # this choice on a case-by-case basis.
3596 #FORCE_COOKIE_PROMPT:PROMPT
3598 .h2 SSL_CERT_FILE
3599 # Set SSL_CERT_FILE to the file that contains all valid CA certificates lynx
3600 # should accept, in case the $SSL_CERT_FILE environment variable is not set,
3601 # e.g.,
3603 #SSL_CERT_FILE:/etc/ssl/certs/ca-certificates.crt
3604 #SSL_CERT_FILE:NULL
3606 .h2 SSL_CLIENT_CERT_FILE
3607 # Set SSL_CLIENT_CERT_FILE to the file that contains a client certificate
3608 # (in PEM format) in case the $SSL_CLIENT_CERT_FILE environment variable is
3609 # not set, e.g.,
3611 #SSL_CLIENT_CERT_FILE:/home/qux/certs/cert.crt
3612 #SSL_CLIENT_CERT_FILE:NULL
3614 .h2 SSL_CLIENT_KEY_FILE
3615 # Set SSL_CLIENT_KEY_FILE to the file that contains a client certificate
3616 # key (in PEM format), in case the $SSL_CLIENT_KEY_FILE environment variable
3617 # is not set, e.g.,
3619 #SSL_CLIENT_KEY_FILE:/home/qux/certs/cert.key
3620 #SSL_CLIENT_KEY_FILE:NULL
3622 .h1 Appearance
3624 .h2 SCREEN_SIZE
3625 # For win32, allow the console window to be resized to the given values.  This
3626 # requires PDCurses 2.5.  The values given are width,height.
3627 #SCREEN_SIZE:80,24
3629 .h2 NO_MARGINS
3630 # Disable left/right margins in the default style sheet.
3631 # This is the same as the command-line "-nomargins" option.
3632 #NO_MARGINS:FALSE
3634 .h2 NO_TITLE
3635 # Disable title and blank line from top of page.
3636 # This is the same as the command-line "-notitle" option.
3637 #NO_TITLE:FALSE
3639 .h2 UPDATE_TERM_TITLE
3640 # Enables updating the title in terminal emulators.
3641 # If your terminal emulator supports that escape code,
3642 # you can set this to TRUE.
3643 # This is the same as the command-line "-update_term_title" option.
3644 #UPDATE_TERM_TITLE:FALSE
3646 .h1 External Programs
3648 .h2 SYSLOG_REQUESTED_URLS
3649 # Log the requested URLs using the syslog interface.
3650 #SYSLOG_REQUESTED_URLS:TRUE
3652 .h2 SYSLOG_TEXT
3653 # Add the given text to calls made to syslog, to distinguish Lynx from other
3654 # applications which use that interface.
3655 #SYSLOG_TEXT:
3657 .h1 Internal Behavior
3658 .h2 BROKEN_FTP_RETR
3659 # Some ftp servers are known to have a broken implementation of RETR.  If asked
3660 # to retrieve a directory, they get confused and fails subsequent commands such
3661 # as CWD and LIST.  Workaround: reconnect after a failed RETR, which is slow.
3663 # Each BROKEN_FTP_RETR gives a string match for the reported FTP server version
3664 #BROKEN_FTP_RETR:ProFTPD 1.2.5
3665 #BROKEN_FTP_RETR:spftp/
3667 .h2 BROKEN_FTP_EPSV
3668 # Some ftp servers are known to have a broken implementation of EPSV.  The
3669 # server will hang for a long time when we attempt to connect after issuing
3670 # this command.   Workaround: do not use EPSV, just use PASV.
3672 # Each BROKEN_FTP_EPSV gives a string match for the reported FTP server version
3673 #BROKEN_FTP_EPSV:(Version wu-2.6.2-12)
3675 .h1 Appearance
3676 .h2 FTP_FORMAT
3677 # FTP_FORMAT defines the display for remote files.
3678 # It uses the same "%" codes as LIST_FORMAT.
3679 #FTP_FORMAT:%d  %-16.16t %a  %K
3681 .h1 Internal Behavior
3683 .h2 STATUS_BUFFER_SIZE
3684 # STATUS_BUFFER_SIZE controls the size of the buffer used for the LYNXMESSAGES
3685 # special url.
3687 # The default size is 40.
3688 #STATUS_BUFFER_SIZE:40
3690 .h2 MAX_URI_SIZE
3691 # MAX_URI_SIZE controls the size of the buffer used for parsing URIs, e.g., the
3692 # HREF value in an anchor.
3694 # The default size is 8192.
3695 #MAX_URI_SIZE:8192
3697 .h1 Appearance
3698 .h2 UNIQUE_URLS
3699 # UNIQUE_URLS can be set to tell Lynx to check for duplicate link numbers in
3700 # the page and corresponding lists, and reusing the original link number.
3701 # This can be set via command-line "-unique-urls".
3702 #UNIQUE_URLS:FALSE
3704 .h1 Character Sets
3705 .h2 MESSAGE_LANGUAGE
3706 # MESSAGE_LANGUAGE can be set to set the LANG environment variable explicitly.
3707 # This is mainly useful in non-Unix environments, e.g., Windows, since normally
3708 # LC_ALL is set, overriding LANG (as well as the more apt LC_MESSAGES variable).
3709 #MESSAGE_LANGUAGE:
3711 .h2 CONV_JISX0201KANA
3712 # If CONV_JISX0201KANA is set, Lynx will convert JIS X0201 Kana to JIS X0208
3713 # Kana, i.e., convert half-width kana to full-width.
3714 #CONV_JISX0201KANA:TRUE
3716 .h1 External Programs
3717 .h2 WAIT_VIEWER_TERMINATION
3718 # The WAIT_VIEWER_TERMINATION is used in the Windows environment to tell Lynx
3719 # to wait until a viewer has terminated.
3720 #WAIT_VIEWER_TERMINATION:FALSE
3722 .h1 Mail-related
3723 .h2 BLAT_MAIL
3724 # BLAT_MAIL is used in the Win32 port.  It tells Lynx whether to use the
3725 # "blat" mailer, or the "sendmail" utility.  Normally the "blat" mailer is
3726 # used for Win32, because the sendmail look-alikes have fewer features.
3727 # This feature can also be set/reset via the command-line "-noblat" option.
3729 # Blat is available from
3730 .url http://www.blat.net
3732 # See also ALT_BLAT_MAIL and SYSTEM_MAIL flags.
3733 #BLAT_MAIL:TRUE
3735 .h2 ALT_BLAT_MAIL
3736 # BLAT_MAIL is used in the Win32 port.  It tells Lynx whether to use the
3737 # "blat" mailer, or the "blatj" utility.  This feature can also be set/reset
3738 # via the command-line "-altblat" option.
3740 # Some users prefer blatj, which can handle Japanese characters.  It is
3741 # available from
3742 .url http://www.piedey.co.jp/blatj/
3743 # (caution - the page is in Japanese).
3745 # See also BLAT_MAIL and SYSTEM_MAIL flags.
3746 #ALT_BLAT_MAIL:FALSE
3748 .h1 Internal Behavior
3749 .h2 TRACK_INTERNAL_LINKS
3750 # With `internal links' (links within a document to a location within the same
3751 # document) enabled, Lynx will distinguish between, for example, `<A
3752 # HREF="foo#frag">' and `<A HREF="#frag">' within a document whose URL is
3753 # `foo'.  It may handle such links differently, although practical differences
3754 # would appear only if the document containing them resulted from a POST
3755 # request or had a no-cache flag set.  This feature attempts to interpret
3756 # URL-references as suggested by RFC 2396, and to prevent mistaken
3757 # resubmissions of form content with the POST method.  An alternate opinion
3758 # asserts that the feature could actually result in inappropriate resubmission
3759 # of form content.
3760 #TRACK_INTERNAL_LINKS:FALSE
3762 .h1 HTML Parsing
3764 .h2 DONT_WRAP_PRE
3765 # Inhibit wrapping of text when  -dump'ing  and  -crawl'ing,  mark
3766 # wrapped lines of <pre> in interactive session.
3767 #DONT_WRAP_PRE:FALSE
3769 .h2 FORCE_HTML
3770 # When true, this forces the first document specified on the command-line
3771 # to be interpreted as HTML.
3772 #FORCE_HTML:FALSE
3774 .h2 HIDDENLINKS
3775 # Control the display of hidden links, using one of the following names:
3777 # MERGE
3778 #  hidden links show up as bracketed numbers  and  are  numbered
3779 #  together with other links in the sequence of their occurrence
3780 #  in the document.
3782 # LISTONLY
3783 #  hidden links are shown only on  L)ist  screens  and  listings
3784 #  generated  by  -dump  or  from  the  P)rint  menu, but appear
3785 #  separately at the end of those lists.  This  is  the  default
3786 #  behavior.
3788 # IGNORE
3789 #  hidden links do not appear even in listings.
3791 #HIDDENLINKS:LISTONLY
3793 .h1 Appearance
3794 .h2 SHORT_URL
3795 # If true, show very long URLs in the status line with "..." to represent the
3796 # portion which cannot be displayed.  The beginning and end of the URL are
3797 # displayed, rather than suppressing the end.
3798 #SHORT_URL:FALSE
3800 .h1 Dump/Crawl
3801 .h2 LISTONLY
3802 # For -dump, show only the list of links.
3803 #LISTONLY:FALSE
3805 .h2 LIST_INLINE
3806 # For -dump, show the links inline with the text.
3807 #LIST_INLINE:FALSE
3809 .h2 LOCALHOST
3810 # When true, this disables URLs that point to remote hosts.
3811 #LOCALHOST:FALSE
3813 .h2 WITH_BACKSPACES
3814 # Emit backspaces in output if -dump'ing or -crawl'ing (like 'man' does).
3815 #WITH_BACKSPACES:FALSE
3817 .h1 Internal Behavior
3818 .h2 HTTP_PROTOCOL
3819 # Normally Lynx negotiates HTTP/1.0, because it does not support chunked
3820 # transfer (a requirement for all HTTP/1.1 clients), although it supports
3821 # several other features of HTTP/1.1.  You may encounter a server which does
3822 # not support HTTP/1.0 which can be used by switching to the later protocol.
3823 #HTTP_PROTOCOL:1.0
3825 .h2 GUESS_SCHEME
3826 # When true, Lynx may fill in a missing "scheme" for URIs which you provide.
3827 # This is different from URL_DOMAIN_PREFIXES and URL_DOMAIN_SUFFIXES.
3829 # If no "scheme" (such as "http:", "ftp:") is given in a URI, Lynx first checks
3830 # if there is a corresponding local file which can be accessed directly. 
3831 # Failing that, Lynx may inspect the URI to see if it begins with a prefix
3832 # which implies a scheme.
3834 # Lynx uses these schemes for the corresponding prefixes:
3836 # cso:
3837 #  "cso."
3838 #  "ns."
3839 #  "ph."
3840 # ftp:
3841 #  "ftp."
3842 # gopher:
3843 #  "gopher."
3844 # http:
3845 #  "www".
3846 # news:
3847 #   "news."
3848 # nntp:
3849 #   "nntp."
3850 # wais:
3851 #  "wais."
3853 # The default value FALSE disables this guess, telling Lynx to just assume that
3854 # "http:" was intended.
3855 #GUESS_SCHEME:FALSE
3857 .h2 REDIRECTION_LIMIT
3858 # HTTP 1.0 suggested a redirection-limit of 5; lynx doubled that.  Some users
3859 # believe they can improve their experience with a higher limit.
3860 REDIRECTION_LIMIT:25
3862 .h1 Appearance
3863 .h2 LIST_DECODED
3864 # For -dump, show URL-encoded links decoded.
3865 #LIST_DECODED:TRUE