1 # Filename: /etc/lynx.cfg
2 # Purpose: configuration file for text browsr lynx
3 # Authors: grml-team (grml.org), (c) Michael Prokop <mika@grml.org>
4 # Bug-Reports: see http://grml.org/bugs/
5 # License: This file is licensed under the GPL v2.
6 # Latest change: Fri May 12 21:55:37 CEST 2006 [mika]
7 ################################################################################
9 # The default placement for this file is /usr/local/lib/lynx.cfg (Unix)
10 # or Lynx_Dir:lynx.cfg (VMS)
12 # $Format: "#PRCS LYNX_VERSION \"$ProjectVersion$\""$
13 #PRCS LYNX_VERSION "2.8.5rel.1"
15 # $Format: "#PRCS LYNX_DATE \"$ProjectDate$\""$
16 #PRCS LYNX_DATE "Wed, 04 Feb 2004 04:07:09 -0800"
18 # Definition pairs are of the form VARIABLE:DEFINITION
19 # NO spaces are allowed between the pair items.
21 # If you do not have write access to /usr/local/lib you may change
22 # the default location of this file in the userdefs.h file and recompile,
23 # or specify its location on the command line with the "-cfg"
24 # command line option.
26 # Items may be commented out by putting a '#' as the FIRST char of the line
27 # (Any line beginning with punctuation is ignored). Leading blanks on each
28 # line are ignored; trailing blanks may be significant depending on the option.
30 # An HTML'ized description of all settings (based on comments in this file,
31 # with alphabetical table of settings and with table of settings by category)
32 # is available at http://www.hippo.ru/~hvv/lynxcfg_toc.html
34 ### The conversion is done via the scripts/cfg2html.pl script.
35 ### Several directives beginning with '.' are used for this purpose.
38 .h1 Auxiliary Facilities
39 # These settings control the auxiliary navigating facilities of lynx, e.g.,
40 # jumpfiles, bookmarks, default URLs.
44 # Starting with Lynx 2.8.1, the lynx.cfg file has a crude "include"
45 # facility. This means that you can take advantage of the global lynx.cfg
46 # while also supplying your own tweaks.
48 # You can use a command-line argument (-cfg /where/is/lynx.cfg) or an
49 # environment variable (LYNX_CFG=/where/is/lynx.cfg).
50 # For instance, put in your .profile or .login:
52 # LYNX_CFG=~/lynx.cfg; export LYNX_CFG # in .profile for sh/ksh/bash/etc.
53 # setenv LYNX_CFG ~/lynx.cfg # in .login for [t]csh
57 # INCLUDE:/usr/local/lib/lynx.cfg
58 # ^^^^^^^^^^^^^^^^^^^^^^^ or whatever is appropriate on your system
59 # and now your own tweaks.
61 # Starting with Lynx 2.8.2, the INCLUDE facility is yet more powerful. You can
62 # suppress all but specific settings that will be read from included files.
63 # This allows sysadmins to provide users the ability to customize lynx with
64 # options that normally do not affect security, such as COLOR, VIEWER, KEYMAP.
68 # INCLUDE:filename for <space-separated-list-of-allowed-settings>
72 #INCLUDE:~/lynx.cfg for COLOR VIEWER KEYMAP
73 # only one space character should surround the word 'for'. On Unix systems ':'
74 # is also accepted as separator. In that case, the example can be written as
76 #INCLUDE:~/lynx.cfg:COLOR VIEWER KEYMAP
77 # In the example, only the settings COLOR, VIEWER and KEYMAP are accepted by
78 # lynx. Other settings are ignored. Note: INCLUDE is also treated as a
79 # setting, so to allow an included file to include other files, put INCLUDE in
80 # the list of allowed settings.
82 # If you allow an included file to include other files, and if a list of
83 # allowed settings is specified for that file with the INCLUDE command, nested
84 # files are only allowed to include the list of settings that is the set AND of
85 # settings allowed for the included file and settings allowed by nested INCLUDE
86 # commands. In short, there is no security hole introduced by including a
87 # user-defined configuration file if the original list of allowed settings is
92 # STARTFILE is the default starting URL if none is specified
93 # on the command line or via a WWW_HOME environment variable;
94 # Lynx will refuse to start without a starting URL of some kind.
95 # STARTFILE can be remote, e.g. http://www.w3.org/default.html ,
96 # or local, e.g. file://localhost/PATH_TO/FILENAME ,
97 # where PATH_TO is replaced with the complete path to FILENAME
98 # using Unix shell syntax and including the device on VMS.
100 # Normally we expect you will connect to a remote site, e.g., the Lynx starting
102 STARTFILE:file://localhost/usr/share/doc/lynx/lynx_help/lynx_help_main.html
104 # As an alternative, you may want to use a local URL. A good choice for this is
105 # the user's home directory:
107 #STARTFILE:file://localhost/~/
109 # Your choice of STARTFILE should reflect your site's needs, and be a URL that
110 # you can connect to reliably. Otherwise users will become confused and think
111 # that they cannot run Lynx.
115 # HELPFILE must be defined as a URL and must have a
116 # complete path if local:
117 # file://localhost/PATH_TO/lynx_help/lynx_help_main.html
118 # Replace PATH_TO with the path to the lynx_help subdirectory
119 # for this distribution (use SHELL syntax including the device
121 # The default HELPFILE is:
122 # http://www.subir.com/lynx/lynx_help/lynx_help_main.html
123 # This should be changed to the local path.
125 HELPFILE:file://localhost/usr/share/doc/lynx/lynx_help/lynx_help_main.html
127 #HELPFILE:file://localhost/PATH_TO/lynx_help/lynx_help_main.html
130 .h2 DEFAULT_INDEX_FILE
131 # DEFAULT_INDEX_FILE is the default file retrieved when the
132 # user presses the 'I' key when viewing any document.
133 # An index to your CWIS can be placed here or a document containing
134 # pointers to lots of interesting places on the web.
136 DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
142 # Set GOTOBUFFER to TRUE if you want to have the previous goto URL,
143 # if any, offered for reuse or editing when using the 'g'oto command.
144 # The default is defined in userdefs.h. If left FALSE, the circular
145 # buffer of previously entered goto URLs can still be invoked via the
146 # Up-Arrow or Down-Arrow keys after entering the 'g'oto command.
152 # JUMP_PROMPT is the default statusline prompt for selecting a jumps file
153 # shortcut. (see below).
154 # You can change the prompt here from that defined in userdefs.h. Any
155 # trailing white space will be trimmed, and a single space is added by Lynx
156 # following the last non-white character. You must set the default prompt
157 # before setting the default jumps file (below). If a default jumps file
158 # was set via userdefs.h, and you change the prompt here, you must set the
159 # default jumps file again (below) for the change to be implemented.
161 #JUMP_PROMPT:Jump to (use '?' for list):
164 .h1 Auxiliary Facilities
167 # JUMPFILE is the local file checked for short-cut names for URLs
168 # when the user presses the 'j' (JUMP) key. The user will be prompted
169 # to enter a short-cut name for an URL, which Lynx will then follow
170 # in a similar manner to 'g'oto; alternatively, s/he can enter '?'
171 # to view the full JUMPFILE list of short-cuts with associated URLs.
172 # There is an example jumps file in the samples subdirectory.
173 # If not defined here or in userdefs.h, the JUMP command will invoke
174 # the NO_JUMPFILE statusline message (see LYMessages_en.h ).
176 # To allow '?' to work, include in the JUMPFILE
177 # a short-cut to the JUMPFILE itself, e.g.
178 # <dt>?<dd><a href="file://localhost/path/jumps.html">This Shortcut List</a>
180 # On VMS, use Unix SHELL syntax (including a lead slash) to define it.
182 # Alternate jumps files can be defined and mapped to keys here. If the
183 # keys have already been mapped, then those mappings will be replaced,
184 # but you should leave at least one key mapped to the default jumps
185 # file. You optionally may include a statusline prompt string for the
186 # mapping. You must map upper and lowercase keys separately (beware of
187 # mappings to keys which the user can further remap via the 'o'ptions
188 # menu). The format is:
190 # JUMPFILE:path:key[:prompt]
192 # where path should begin with a '/' (i.e., not include file://localhost).
193 # Any white space following a prompt string will be trimmed, and a single
194 # space will be added by Lynx.
196 # In the following line, include the actual full local path to JUMPFILE,
197 # but do not include 'file://localhost' in the line.
198 #JUMPFILE:/FULL_LOCAL_PATH/jumps.html
200 #JUMPFILE:/Lynx_Dir/ips.html:i:IP or Interest group (? for list):
204 # Set JUMPBUFFER to TRUE if you want to have the previous jump target,
205 # if any, offered for reuse or editing when using the 'J'ump command.
206 # The default is defined in userdefs.h. If left FALSE, the circular
207 # buffer of previously entered targets (shortcuts) can still be invoked
208 # via the Up-Arrow or Down-Arrow keys after entering the 'J'ump command.
209 # If multiple jumps files are installed, the recalls of shortcuts will
210 # be specific to each file. If Lynx was built with PERMIT_GOTO_FROM_JUMP
211 # defined, any random URLs used instead of shortcuts will be stored in the
212 # goto URL buffer, not in the shortcuts buffer(s), and the single character
213 # ':' can be used as a target to invoke the goto URL buffer (as if 'g'oto
214 # followed by Up-Arrow had been entered).
219 .h1 Internal Behavior
222 # If SAVE_SPACE is defined, it will be used as a path prefix for the
223 # suggested filename in "Save to Disk" operations from the 'p'rint or
224 # 'd'ownload menus. On VMS, you can use either VMS (e.g., "SYS$LOGIN:")
225 # or Unix syntax (including '~' for the HOME directory). On Unix, you
226 # must use Unix syntax. If the symbol is not defined, or is zero-length
227 # (""), no prefix will be used, and only a filename for saving in the
228 # current default directory will be suggested.
229 # This definition will be overridden if a "LYNX_SAVE_SPACE" environment
230 # variable has been set on Unix, or logical has been defined on VMS.
236 # Lynx uses temporary files for (among other purposes) the content of
237 # various user interface pages. REUSE_TEMPFILES changes the behavior
238 # for some of these temp files, among them pages shown for HISTORY,
239 # VLINKS, OPTIONS, INFO, PRINT, DOWNLOAD commands.
240 # If set to TRUE, the same file can be used multiple times for the same
241 # purpose. If set to FALSE, a new filename is generated each time before
242 # rewriting such a page. With TRUE, repeated invocation of these commands
243 # is less likely to push previous documents out of the cache of rendered
244 # texts (see also DEFAULT_CACHE_SIZE). This is especially useful with
245 # intermittent (dialup) network connections, when it is desirable to
246 # continue browsing through the cached documents after disconnecting.
247 # With the default setting of FALSE, there can be more than one incarnation
248 # of e.g. the VLINKS page cached in memory (but still only the most recently
249 # generated one is kept as a file), resulting in sometimes less surprising
250 # behaviour when returning to such a page via HISTORY or PREV_DOC functions
251 # (most users will not encounter and notice this difference).
253 #REUSE_TEMPFILES:FALSE
257 # If LYNX_HOST_NAME is defined here or in userdefs.h, it will be
258 # treated as an alias for the local host name in checks for URLs on
259 # the local host (e.g., when the -localhost switch is set), and this
260 # host name, "localhost", and HTHostName (the fully qualified domain
261 # name of the system on which Lynx is running) will all be passed as
262 # local. A different definition here will override that in userdefs.h.
264 #LYNX_HOST_NAME:www.cc.ukans.edu
269 # Any LOCALHOST_ALIAS definitions also will be accepted as local when
270 # the -localhost switch is set. These need not actually be local, i.e.,
271 # in contrast to LYNX_HOST_NAME, you can define them to trusted hosts at
272 # other Internet sites.
275 #LOCALHOST_ALIAS:gopher.server.domain
276 #LOCALHOST_ALIAS:news.server.domain
280 # LOCAL_DOMAIN is used for a tail match with the ut_host element of
281 # the utmp or utmpx structure on systems with utmp capabilities, to
282 # determine if a user is local to your campus or organization when
283 # handling -restrictions=inside_foo or outside_foo settings for ftp,
284 # news, telnet/tn3270 and rlogin URLs. An "inside" user is assumed
285 # if your system does not have utmp capabilities. CHANGE THIS here
286 # if it was not changed in userdefs.h at compilation time.
288 #LOCAL_DOMAIN:ukans.edu
294 # CHARACTER_SET defines the display character set, i.e., assumed to be
295 # installed on the user's terminal. It determines which characters or strings
296 # will be used to represent 8-bit character entities within HTML. New
297 # character sets may be defined as explained in the README files of the
298 # src/chrtrans directory in the Lynx source code distribution. For Asian (CJK)
299 # character sets, it also determines how Kanji code will be handled. The
300 # default is defined in userdefs.h and can be changed here or via the
301 # 'o'ptions menu. The 'o'ptions menu setting will be stored in the user's RC
302 # file whenever those settings are saved, and thereafter will be used as the
303 # default. For Lynx a "character set" has two names: a MIME name (for
304 # recognizing properly labeled charset parameters in HTTP headers etc.), and a
305 # human-readable string for the 'O'ptions Menu (so you may find info about
306 # language or group of languages besides MIME name). Not all 'human-readable'
307 # names correspond to exactly one valid MIME charset (example is "Chinese");
308 # in that case an appropriate valid (and more specific) MIME name should be
309 # used where required. Well-known synonyms are also processed in the code.
313 # Lynx normally translates characters from a document's charset to display
314 # charset, using ASSUME_CHARSET value (see below) if the document's charset
315 # is not specified explicitly. Raw (CJK) mode is OFF for this case.
316 # When the document charset is specified explicitly, that charset
317 # overrides any assumption like ASSUME_CHARSET or raw (CJK) mode.
319 # For the Asian (CJK) display character sets, the corresponding charset is
320 # assumed in documents, i.e., raw (CJK) mode is ON by default. In raw CJK
321 # mode, 8-bit characters are not reverse translated in relation to the entity
322 # conversion arrays, i.e., they are assumed to be appropriate for the display
323 # character set. The mode should be toggled OFF when an Asian (CJK) display
324 # character set is selected but the document is not CJK and its charset not
325 # specified explicitly.
327 # Raw (CJK) mode may be toggled by user via '@' (LYK_RAW_TOGGLE) key,
328 # the -raw command line switch or from the 'o'ptions menu.
330 # Raw (CJK) mode effectively changes the charset assumption about unlabeled
331 # documents. You can toggle raw mode ON if you believe the document has a
332 # charset which does correspond to your Display Character Set. On the other
333 # hand, if you set ASSUME_CHARSET the same as Display Character Set you get raw
334 # mode ON by default (but you get assume_charset=iso-8859-1 if you try raw mode
337 # Note that "raw" does not mean that every byte will be passed to the screen.
338 # HTML character entities may get expanded and translated, inappropriate
339 # control characters filtered out, etc. There is a "Transparent" pseudo
340 # character set for more "rawness".
342 # Since Lynx now supports a wide range of platforms it may be useful to note
343 # the cpXXX codepages used by IBM PC compatible computers, and windows-xxxx
344 # used by native MS-Windows apps. We also note that cpXXX pages rarely are
345 # found on Internet, but are mostly for local needs on DOS.
347 # Recognized character sets include:
350 # string for 'O'ptions Menu MIME name
351 # =========================== =========
352 # 7 bit approximations (US-ASCII) us-ascii
353 # Western (ISO-8859-1) iso-8859-1
354 # Western (ISO-8859-15) iso-8859-15
355 # Western (cp850) cp850
356 # Western (windows-1252) windows-1252
357 # IBM PC US codepage (cp437) cp437
358 # DEC Multinational dec-mcs
359 # Macintosh (8 bit) macintosh
360 # NeXT character set next
361 # HP Roman8 hp-roman8
363 # Japanese (EUC-JP) euc-jp
364 # Japanese (Shift_JIS) shift_jis
367 # Vietnamese (VISCII) viscii
368 # Eastern European (ISO-8859-2) iso-8859-2
369 # Eastern European (cp852) cp852
370 # Eastern European (windows-1250) windows-1250
371 # Latin 3 (ISO-8859-3) iso-8859-3
372 # Latin 4 (ISO-8859-4) iso-8859-4
373 # Baltic Rim (cp775) cp775
374 # Baltic Rim (windows-1257) windows-1257
375 # Cyrillic (ISO-8859-5) iso-8859-5
376 # Cyrillic (cp866) cp866
377 # Cyrillic (windows-1251) windows-1251
378 # Cyrillic (KOI8-R) koi8-r
379 # Arabic (ISO-8859-6) iso-8859-6
380 # Arabic (cp864) cp864
381 # Arabic (windows-1256) windows-1256
382 # Greek (ISO-8859-7) iso-8859-7
383 # Greek (cp737) cp737
384 # Greek2 (cp869) cp869
385 # Greek (windows-1253) windows-1253
386 # Hebrew (ISO-8859-8) iso-8859-8
387 # Hebrew (cp862) cp862
388 # Hebrew (windows-1255) windows-1255
389 # Turkish (ISO-8859-9) iso-8859-9
390 # ISO-8859-10 iso-8859-10
391 # Ukrainian Cyrillic (cp866u) cp866u
392 # Ukrainian Cyrillic (KOI8-U) koi8-u
393 # UNICODE (UTF-8) utf-8
394 # RFC 1345 w/o Intro mnemonic+ascii+0
395 # RFC 1345 Mnemonic mnemonic
396 # Transparent x-transparent
399 # The value should be the MIME name of a character set recognized by
400 # Lynx (case insensitive).
401 # Find RFC 1345 at http://www.ics.uci.edu/pub/ietf/uri/rfc1345.txt .
403 #CHARACTER_SET:iso-8859-1
406 # LOCALE_CHARSET overrides CHARACTER_SET if true, using the current locale to
407 # lookup a MIME name that corresponds, and use that as the display charset.
408 # This feature is experimental because while nl_langinfo(CODESET) itself is
409 # standardized, the return values and their relationship to the locale value is
410 # not. GNU libiconv happens to give useful values, but other implementations
411 # are not guaranteed to do this.
412 #LOCALE_CHARSET:FALSE
416 # ASSUME_CHARSET changes the handling of documents which do not
417 # explicitly specify a charset. Normally Lynx assumes that 8-bit
418 # characters in those documents are encoded according to iso-8859-1
419 # (the official default for the HTTP protocol). When ASSUME_CHARSET
420 # is defined here or by an -assume_charset command line flag is in effect,
421 # Lynx will treat documents as if they were encoded accordingly.
422 # See above on how this interacts with "raw mode" and the Display
424 # ASSUME_CHARSET can also be changed via the 'o'ptions menu but will
425 # not be saved as permanent value in user's .lynxrc file to avoid more chaos.
427 #ASSUME_CHARSET:iso-8859-1
430 .h2 ASSUMED_DOC_CHARSET_CHOICE
431 .h2 DISPLAY_CHARSET_CHOICE
432 # It is possible to reduce the number of charset choices in the 'O'ptions menu
433 # for "display charset" and "assumed document charset" fields via
434 # DISPLAY_CHARSET_CHOICE and ASSUMED_DOC_CHARSET_CHOICE settings correspondingly.
435 # Each of these settings can be used several times to define the set of possible
436 # choices for corresponding field. The syntax for the values is
438 # string | prefix* | *
442 # 'string' is either the MIME name of charset or it's full name (listed
443 # either in the left or in the right column of table of
444 # recognized charsets), case-insensitive - e.g. 'Koi8-R' or
445 # 'Cyrillic (KOI8-R)' (both without quotes),
447 # 'prefix' is any string, and such value will select all charsets having
448 # the name with prefix matching given (case insensitive), i.e.,
449 # for the charsets listed in the table of recognized charsets,
452 # ASSUMED_DOC_CHARSET_CHOICE:cyrillic*
453 # will be equal to specifying
455 # ASSUMED_DOC_CHARSET_CHOICE:cp866
456 # ASSUMED_DOC_CHARSET_CHOICE:windows-1251
457 # ASSUMED_DOC_CHARSET_CHOICE:koi8-r
458 # ASSUMED_DOC_CHARSET_CHOICE:iso-8859-5
459 # or lines with full names of charsets.
461 # literal string '*' (without quotes) will enable all charset choices
462 # in corresponding field. This is useful for overriding site
463 # defaults in private pieces of lynx.cfg included via INCLUDE
466 # Default values for both settings are '*', but any occurrence of settings
467 # with values that denote any charsets will make only listed choices available
468 # for corresponding field.
469 #ASSUMED_DOC_CHARSET_CHOICE:*
470 #DISPLAY_CHARSET_CHOICE:*
473 .h2 ASSUME_LOCAL_CHARSET
474 # ASSUME_LOCAL_CHARSET is like ASSUME_CHARSET but only applies to local
475 # files. If no setting is given here or by an -assume_local_charset
476 # command line option, the value for ASSUME_CHARSET or -assume_charset
477 # is used. It works for both text/plain and text/html files.
478 # This option will ignore "raw mode" toggling when local files are viewed
479 # (it is "stronger" than "assume_charset" or the effective change
480 # of the charset assumption caused by changing "raw mode"),
481 # so only use when necessary.
483 #ASSUME_LOCAL_CHARSET:iso-8859-1
486 .h2 PREPEND_CHARSET_TO_SOURCE
487 # PREPEND_CHARSET_TO_SOURCE:TRUE tells Lynx to prepend a META CHARSET line
488 # to text/html source files when they are retrieved for 'd'ownloading
489 # or passed to 'p'rint functions, so HTTP headers will not be lost.
490 # This is necessary for resolving charset for local html files,
491 # while the assume_local_charset is just an assumption.
492 # For the 'd'ownload option, a META CHARSET will be added only if the HTTP
493 # charset is present. The compilation default is TRUE.
494 # It is generally desirable to have charset information for every local
495 # html file, but META CHARSET string potentially could cause
496 # compatibility problems with other browsers, see also PREPEND_BASE_TO_SOURCE.
497 # Note that the prepending is not done for -source dumps.
499 PREPEND_CHARSET_TO_SOURCE:FALSE
503 # NCR_IN_BOOKMARKS:TRUE allows you to save 8-bit characters in bookmark titles
504 # in the unicode format (NCR). This may be useful if you need to switch
505 # display charsets frequently. This is the case when you use Lynx on different
506 # platforms, e.g., on UNIX and from a remote PC, and want to keep the bookmarks
508 # Another aspect is compatibility: NCR is part of I18N and HTML4.0
509 # specifications supported starting with Lynx 2.7.2, Netscape 4.0 and MSIE 4.0.
510 # Older browser versions will fail so keep NCR_IN_BOOKMARKS:FALSE if you
513 #NCR_IN_BOOKMARKS:FALSE
516 .h2 FORCE_8BIT_TOUPPER
517 # FORCE_8BIT_TOUPPER overrides locale settings and uses internal 8-bit
518 # case-conversion mechanism for case-insensitive searches in non-ASCII display
519 # character sets. It is FALSE by default and should not be changed unless
520 # you encounter problems with case-insensitive searches.
522 #FORCE_8BIT_TOUPPER:FALSE
525 .h2 OUTGOING_MAIL_CHARSET
526 # While Lynx supports different platforms and display character sets
527 # we need to limit the charset in outgoing mail to reduce
528 # trouble for remote recipients who may not recognize our charset.
529 # You may try US-ASCII as the safest value (7 bit), any other MIME name,
530 # or leave this field blank (default) to use the display character set.
531 # Charset translations currently are implemented for mail "subjects= " only.
533 #OUTGOING_MAIL_CHARSET:
536 .h2 ASSUME_UNREC_CHARSET
537 # If Lynx encounters a charset parameter it doesn't recognize, it will
538 # replace the value given by ASSUME_UNREC_CHARSET (or a corresponding
539 # -assume_unrec_charset command line option) for it. This can be used
540 # to deal with charsets unknown to Lynx, if they are "sufficiently
541 # similar" to one that Lynx does know about, by forcing the same
542 # treatment. There is no default, and you probably should leave this
543 # undefined unless necessary.
545 #ASSUME_UNREC_CHARSET:iso-8859-1
547 .h2 PREFERRED_LANGUAGE
548 # PREFERRED_LANGUAGE is the language in MIME notation (e.g., "en",
549 # "fr") which will be indicated by Lynx in its Accept-Language headers
550 # as the preferred language. If available, the document will be
551 # transmitted in that language. Users can override this setting via
552 # the 'o'ptions menu and save that preference in their RC file.
553 # This may be a comma-separated list of languages in decreasing preference.
555 #PREFERRED_LANGUAGE:en
558 .h2 PREFERRED_CHARSET
559 # PREFERRED_CHARSET specifies the character set in MIME notation (e.g.,
560 # "ISO-8859-2", "ISO-8859-5") which Lynx will indicate you prefer in
561 # requests to http servers using an Accept-Charsets header. Users can
562 # change it via the 'o'ptions menu and save that preference in their RC file.
563 # The value should NOT include "ISO-8859-1" or "US-ASCII",
564 # since those values are always assumed by default.
565 # If a file in that character set is available, the server will send it.
566 # If no Accept-Charset header is present, the default is that any
567 # character set is acceptable. If an Accept-Charset header is present,
568 # and if the server cannot send a response which is acceptable
569 # according to the Accept-Charset header, then the server SHOULD send
570 # an error response with the 406 (not acceptable) status code, though
571 # the sending of an unacceptable response is also allowed. See RFC 2068
572 # (http://www.ics.uci.edu/pub/ietf/uri/rfc2068.txt).
577 .h2 CHARSETS_DIRECTORY
578 # CHARSETS_DIRECTORY specifies the directory with the fonts (glyph data)
579 # used by Lynx to switch the display-font to a font best suited for the
580 # given document. The font should be in a format understood by the
581 # platforms TTY-display-font-switching API. Currently supported on OS/2 only.
583 # Lynx expects the glyphs for the charset CHARSET with character cell
584 # size HHHxWWW to be stored in a file HHHxWWW/CHARSET.fnt inside the directory
585 # specified by CHARSETS_DIRECTORY. E.g., the font for koi8-r sized 14x9
586 # should be in the file 14x9/koi8-r.fnt.
591 .h2 CHARSET_SWITCH_RULES
592 # CHARSET_SWITCH_RULES hints lynx on how to choose the best display font given
593 # the document encoding. This string is a sequence of chunks, each chunk
594 # having the following form:
596 # IN_CHARSET1 IN_CHARSET2 ... IN_CHARSET5 :OUT_CHARSET
598 # For readability, one may insert arbitrary additional punctuation (anything
599 # but : is ignored). E.g., if lynx is able to switch only to display charsets
600 # cp866, cp850, cp852, and cp862, then the following setting may be useful
601 # (split for readability):
603 # CHARSET_SWITCH_RULES: koi8-r ISO-8859-5 windows-1251 cp866u KOI8-U :cp866,
604 # iso-8859-1 windows-1252 ISO-8859-15 :cp850,
605 # ISO-8859-2 windows-1250 :cp852,
606 # ISO-8859-8 windows-1255 :cp862
608 #CHARSET_SWITCH_RULES:
613 .h2 URL_DOMAIN_PREFIXES
614 .h2 URL_DOMAIN_SUFFIXES
615 # URL_DOMAIN_PREFIXES and URL_DOMAIN_SUFFIXES are strings which will be
616 # prepended (together with a scheme://) and appended to the first element
617 # of command line or 'g'oto arguments which are not complete URLs and
618 # cannot be opened as a local file (file://localhost/string). Both
619 # can be comma-separated lists. Each prefix must end with a dot, each
620 # suffix must begin with a dot, and either may contain other dots (e.g.,
621 # .com.jp). The default lists are defined in userdefs.h and can be
622 # replaced here. Each prefix will be used with each suffix, in order,
623 # until a valid Internet host is created, based on a successful DNS
624 # lookup (e.g., foo will be tested as www.foo.com and then www.foo.edu
625 # etc.). The first element can include a :port and/or /path which will
626 # be restored with the expanded host (e.g., wfbr:8002/dir/lynx will
627 # become http://www.wfbr.edu:8002/dir/lynx). The prefixes will not be
628 # used if the first element ends in a dot (or has a dot before the
629 # :port or /path), and similarly the suffixes will not be used if the
630 # the first element begins with a dot (e.g., .nyu.edu will become
631 # http://www.nyu.edu without testing www.nyu.com). Lynx will try to
632 # guess the scheme based on the first field of the expanded host name,
633 # and use "http://" as the default (e.g., gopher.wfbr.edu or gopher.wfbr.
634 # will be made gopher://gopher.wfbr.edu).
636 #URL_DOMAIN_PREFIXES:www.
637 #URL_DOMAIN_SUFFIXES:.com,.edu,.net,.org
641 # Toggle whether the Options Menu is key-based or form-based;
642 # the key-based version is available only if specified at compile time.
647 # Display partial pages while downloading
652 # Set the threshold # of lines Lynx must render before it
653 # redraws the screen in PARTIAL mode. Anything < 0 implies
654 # use of the screen size.
659 # While getting large files, Lynx shows the approximate rate of transfer.
660 # Set this to change the units shown. "Kilobytes" denotes 1024 bytes:
661 # NONE to disable the display of transfer rate altogether.
662 # TRUE or KB for Kilobytes/second.
663 # FALSE or BYTES for bytes/second.
664 # KB,ETA to show Kilobytes/second with estimated completion time.
665 # BYTES,ETA to show BYTES/second with estimated completion time.
666 # Note that the "ETA" values are available if USE_READPROGRESS was defined.
670 # Set the abbreviation for Kilobytes (1024).
672 # http://www.romulus2.com/articles/guides/misc/bitsbytes.shtml
673 # In December 1998, the International Electrotechnical Commission (IEC)
674 # approved a new IEC International Standard. Instead of using the metric
675 # prefixes for multiples in binary code, the new IEC standard invented specific
676 # prefixes for binary multiples made up of only the first two letters of the
677 # metric prefixes and adding the first two letters of the word "binary". Thus,
678 # for instance, instead of Kilobyte (KB) or Gigabyte (GB), the new terms would
679 # be kibibyte (KiB) or gibibyte (GiB).
681 # If you prefer using the conventional (and more common) "KB", modify this
690 # The following definitions set the number of seconds for
691 # pauses following statusline messages that would otherwise be
692 # replaced immediately, and are more important than the unpaused
693 # progress messages. Those set by INFOSECS are also basically
694 # progress messages (e.g., that a prompted input has been canceled)
695 # and should have the shortest pause. Those set by MESSAGESECS are
696 # informational (e.g., that a function is disabled) and should have
697 # a pause of intermediate duration. Those set by ALERTSECS typically
698 # report a serious problem and should be paused long enough to read
699 # whenever they appear (typically unexpectedly). The default values
700 # are defined in userdefs.h, and can be modified here should longer
701 # pauses be desired for braille-based access to Lynx.
703 # SVr4-curses implementations support time delays in milliseconds,
704 # hence the value may be given shorter, e.g., 0.5
711 # Set DEBUGSECS to a nonzero value to slow down progress messages
712 # (see "-delay" option).
716 # Set REPLAYSECS to a nonzero value to allow for slow replaying of
717 # command scripts (see "-cmd_script" option).
721 # These settings control the appearance of Lynx's screen and the way
722 # Lynx renders some tags.
724 .h2 USE_SELECT_POPUPS
725 # If USE_SELECT_POPUPS is set FALSE, Lynx will present a vertical list of
726 # radio buttons for the OPTIONs in SELECT blocks which lack the MULTIPLE
727 # attribute, instead of using a popup menu. Note that if the MULTIPLE
728 # attribute is present in the SELECT start tag, Lynx always will create a
729 # vertical list of checkboxes for the OPTIONs.
730 # The default defined here or in userdefs.h can be changed via the 'o'ptions
731 # menu and saved in the RC file, and always can be toggled via the -popup
732 # command line switch.
734 #USE_SELECT_POPUPS:TRUE
738 # SHOW_CURSOR controls whether or not the cursor is hidden or appears
739 # over the current link in documents or the current option in popups.
740 # Showing the cursor is handy if you are a sighted user with a poor
741 # terminal that can't do bold and reverse video at the same time or
742 # at all. It also can be useful to blind users, as an alternative
743 # or supplement to setting LINKS_AND_FIELDS_ARE_NUMBERED or
744 # LINKS_ARE_NUMBERED.
745 # The default defined here or in userdefs.h can be changed via the
746 # 'o'ptions menu and saved in the RC file, and always can be toggled
747 # via the -show_cursor command line switch.
753 # UNDERLINE_LINKS controls whether links are underlined by default, or shown
754 # in bold. Normally this default is set from the configure script.
756 #UNDERLINE_LINKS:FALSE
759 # If BOLD_HEADERS is set to TRUE the HT_BOLD default style will be acted
760 # upon for <H1> through <H6> headers. The compilation default is FALSE
761 # (only the indentation styles are acted upon, but see BOLD_H1, below).
762 # On Unix, compilation with -DUNDERLINE_LINKS also will apply to the
763 # HT_BOLD style for headers when BOLD_HEADERS is TRUE.
769 # If BOLD_H1 is set to TRUE the HT_BOLD default style will be acted
770 # upon for <H1> headers even if BOLD_HEADERS is FALSE. The compilation
771 # default is FALSE. On Unix, compilation with -DUNDERLINE_LINKS also
772 # will apply to the HT_BOLD style for headers when BOLD_H1 is TRUE.
777 .h2 BOLD_NAME_ANCHORS
778 # If BOLD_NAME_ANCHORS is set to TRUE the content of anchors without
779 # an HREF attribute, (i.e., anchors with a NAME or ID attribute) will
780 # have the HT_BOLD default style. The compilation default is FALSE.
781 # On Unix, compilation with -DUNDERLINE_LINKS also will apply to the
782 # HT_BOLD style for NAME (ID) anchors when BOLD_NAME_ANCHORS is TRUE.
784 #BOLD_NAME_ANCHORS:FALSE
787 .h1 Internal Behavior
789 .h2 DEFAULT_CACHE_SIZE
790 .h2 DEFAULT_VIRTUAL_MEMORY_SIZE
791 # The DEFAULT_CACHE_SIZE specifies the number of WWW documents to be
792 # cached in memory at one time.
794 # This so-called cache size (actually, number) is defined in userdefs.h and
795 # may be modified here and/or with the command line argument -cache=NUMBER
796 # The minimum allowed value is 2, for the current document and at least one
797 # to fetch, and there is no absolute maximum number of cached documents.
798 # On Unix, and VMS not compiled with VAXC, whenever the number is exceeded
799 # the least recently displayed document will be removed from memory.
801 # On VMS compiled with VAXC, the DEFAULT_VIRTUAL_MEMORY_SIZE specifies the
802 # amount (bytes) of virtual memory that can be allocated and not yet be freed
803 # before previous documents are removed from memory. If the values for both
804 # the DEFAULT_CACHE_SIZE and DEFAULT_VIRTUAL_MEMORY_SIZE are exceeded, then
805 # the least recently displayed documents will be freed until one or the other
806 # value is no longer exceeded. The default value is defined in userdefs.h.
808 # The Unix and VMS (but not VAXC) implementations use the C library malloc's
809 # and calloc's for memory allocation, but procedures for taking the actual
810 # amount of cache into account still need to be developed. They use only
811 # the DEFAULT_CACHE_SIZE value, and that specifies the absolute maximum
812 # number of documents to cache (rather than the maximum number only if
813 # DEFAULT_VIRTUAL_MEMORY_SIZE has been exceeded, as with VAXC/VAX).
815 #DEFAULT_CACHE_SIZE:10
816 #DEFAULT_VIRTUAL_MEMORY_SIZE:512000
820 # SOURCE_CACHE sets the source caching behavior for Lynx:
821 # FILE causes Lynx to keep a temporary file for each cached document
822 # containing the HTML source of the document, which it uses to regenerate
823 # the document when certain settings are changed (for instance,
824 # historical vs. minimal vs. valid comment parsing) instead of reloading
825 # the source from the network.
826 # MEMORY is like FILE, except the document source is kept in memory. You
827 # may wish to adjust DEFAULT_CACHE_SIZE and DEFAULT_VIRTUAL_MEMORY_SIZE
829 # NONE is the default; the document source is not cached, and is reloaded
830 # from the network when needed.
835 .h2 SOURCE_CACHE_FOR_ABORTED
836 # This setting controls what will happen with cached source for the document
837 # being fetched from the net if fetching was aborted (either user pressed
838 # 'z' or network went down). If set to KEEP, the source fetched so far will
839 # be preserved (and used as cache), if set to DROP lynx will drop the
840 # source cache for that document (i.e. only completely downloaded documents
841 # will be cached in that case).
842 #SOURCE_CACHE_FOR_ABORTED:DROP
844 .h2 ALWAYS_RESUBMIT_POSTS
845 # If ALWAYS_RESUBMIT_POSTS is set TRUE, Lynx always will resubmit forms
846 # with method POST, dumping any cache from a previous submission of the
847 # form, including when the document returned by that form is sought with
848 # the PREV_DOC command or via the history list. Lynx always resubmits
849 # forms with method POST when a submit button or a submitting text input
850 # is activated, but normally retrieves the previously returned document
851 # if it had links which you activated, and then go back with the PREV_DOC
852 # command or via the history list.
854 # The default defined here or in userdefs.h can be toggled via
855 # the -resubmit_forms command line switch.
857 #ALWAYS_RESUBMIT_POSTS:FALSE
859 .h2 TRIM_INPUT_FIELDS
860 # If TRIM_INPUT_FIELDS is set TRUE, Lynx will trim trailing whitespace (e.g.,
861 # space, tab, carriage return, line feed and form feed) from the text entered
862 # into form text and textarea fields. Older versions of Lynx do this trimming
863 # unconditionally, but other browsers do not, which would yield different
864 # behavior for CGI scripts.
865 #TRIM_INPUT_FIELDS:FALSE
869 .h2 NO_ISMAP_IF_USEMAP
870 # If NO_ISMAP_IF_USEMAP is set TRUE, Lynx will not include a link to the
871 # server-side image map if both a server-side and client-side map for the
872 # same image is indicated in the HTML markup. The compilation default is
873 # FALSE, such that a link with "[ISMAP]" as the link name, followed by a
874 # hyphen, will be prepended to the ALT string or "[USEMAP]" pseudo-ALT for
875 # accessing Lynx's text-based rendition of the client-side map (based on
876 # the content of the associated MAP element). If the "[ISMAP]" link is
877 # activated, Lynx will send a 0,0 coordinate pair to the server, which
878 # Lynx-friendly sites can map to a for-text-client document, homologous
879 # to what is intended for the content of a FIG element.
881 # The compilation default, or default defined here, can be toggled via
882 # the "-ismap" command line switch.
884 #NO_ISMAP_IF_USEMAP:FALSE
887 .h2 SEEK_FRAG_MAP_IN_CUR
888 # If SEEK_FRAG_MAP_IN_CUR is set FALSE, then USEMAP attribute values
889 # (in IMG or OBJECT tags) consisting of only a fragment (USEMAP="#foo")
890 # will be resolved with respect to the current document's base, which
891 # might not be the same as the current document's URL.
892 # The compilation default is to use the current document's URL in all
893 # cases (i.e., assume the MAP is present below, if it wasn't present
894 # above the point in the HTML stream where the USEMAP attribute was
895 # detected). Lynx's present "single pass" rendering engine precludes
896 # checking below before making the decision on how to resolve a USEMAP
897 # reference consisting solely of a fragment.
899 #SEEK_FRAG_MAP_IN_CUR:TRUE
902 .h2 SEEK_FRAG_AREA_IN_CUR
903 # If SEEK_FRAG_AREA_IN_CUR is set FALSE, then HREF attribute values
904 # in AREA tags consisting of only a fragment (HREF="#foo") will be
905 # resolved with respect to the current document's base, which might
906 # not be the same as the current document's URL. The compilation
907 # default is to use the current document's URL, as is done for the
908 # HREF attribute values of Anchors and LINKs that consist solely of
911 #SEEK_FRAG_AREA_IN_CUR:TRUE
915 # These settings control Lynx's ability to execute various types of scripts.
917 .h2 LOCAL_EXECUTION_LINKS_ALWAYS_ON
918 .h2 LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE
919 # Local execution links and scripts are by default completely disabled,
920 # unless a change is made to the userdefs.h file to enable them or
921 # the configure script is used with the corresponding options
922 # (--enable-exec-links and --enable-exec-scripts).
923 # See the Lynx source code distribution and the userdefs.h
924 # file for more detail on enabling execution links and scripts.
926 # If you have enabled execution links or scripts the following
927 # two variables control Lynx's action when an execution link
928 # or script is encountered.
930 # If LOCAL_EXECUTION_LINKS_ALWAYS_ON is set to TRUE any execution
931 # link or script will be executed no matter where it came from.
932 # This is EXTREMELY dangerous. Since Lynx can access files from
933 # anywhere in the world, you may encounter links or scripts that
934 # will cause damage or compromise the security of your system.
936 # If LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE is set to TRUE only
937 # links or scripts that reside on the local machine and are
938 # referenced with a URL beginning with "file://localhost/" or meet
939 # TRUSTED_EXEC or ALWAYS_TRUSTED_EXEC rules (see below) will be
940 # executed. This is much less dangerous than enabling all execution
941 # links, but can still be dangerous.
943 LOCAL_EXECUTION_LINKS_ALWAYS_ON:FALSE
944 LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE:FALSE
948 # If LOCAL_EXECUTION_LINK_ON_BUT_NOT_REMOTE is TRUE, and no TRUSTED_EXEC
949 # rule is defined, it defaults to "file://localhost/" and any lynxexec
950 # or lynxprog command will be permitted if it was referenced from within
951 # a document whose URL begins with that string. If you wish to restrict the
952 # referencing URLs further, you can extend the string to include a trusted
953 # path. You also can specify a trusted directory for http URLs, which will
954 # then be treated as if they were local rather than remote. For example:
956 # TRUSTED_EXEC:file://localhost/trusted/
957 # TRUSTED_EXEC:http://www.wfbr.edu/trusted/
959 # If you also wish to restrict the commands which can be executed, create
960 # a series of rules with the path (Unix) or command name (VMS) following
961 # the string, separated by a tab. For example:
965 # TRUSTED_EXEC:file://localhost/<tab>/bin/cp
966 # TRUSTED_EXEC:file://localhost/<tab>/bin/rm
969 # TRUSTED_EXEC:file://localhost/<tab>copy
970 # TRUSTED_EXEC:file://localhost/<tab>delete
972 # Once you specify a TRUSTED_EXEC referencing string, the default is
973 # replaced, and all the referencing strings you desire must be specified
974 # as a series. Similarly, if you associate a command with the referencing
975 # string, you must specify all of the allowable commands as a series of
976 # TRUSTED_EXEC rules for that string. If you specify ALWAYS_TRUSTED_EXEC
977 # rules below, you need not repeat them as TRUSTED_EXEC rules.
979 # If EXEC_LINKS and JUMPFILE have been defined, any lynxexec or lynxprog
980 # URLs in that file will be permitted, regardless of other settings. If
981 # you also set LOCAL_EXECUTION_LINKS_ON_BUT_NOT_REMOTE:TRUE and a single
982 # TRUSTED_EXEC rule that will always fail (e.g., "none"), then *ONLY* the
983 # lynxexec or lynxprog URLs in JUMPFILE (and any ALWAYS_TRUSTED_EXEC rules,
984 # see below) will be allowed. Note, however, that if Lynx was compiled with
985 # CAN_ANONYMOUS_JUMP set to FALSE (default is TRUE), or -restrictions=jump
986 # is included with the -anonymous switch at run time, then users of an
987 # anonymous account will not be able to access the jumps file or enter
988 # 'j'ump shortcuts, and this selective execution feature will be overridden
989 # as well (i.e., they will only be able to access lynxexec or lynxprog
990 # URLs which meet any ALWAYS_TRUSTED_EXEC rules).
995 .h2 ALWAYS_TRUSTED_EXEC
996 # If EXEC_LINKS was defined, any lynxexec or lynxprog URL can be made
997 # always enabled by an ALWAYS_TRUSTED_EXEC rule for it. This is useful for
998 # anonymous accounts in which you have disabled execution links generally,
999 # and may also have disabled jumps file links, but still want to allow
1000 # execution of particular utility scripts or programs. The format is
1001 # like that for TRUSTED_EXEC. For example:
1005 # ALWAYS_TRUSTED_EXEC:file://localhost/<tab>/usr/local/kinetic/bin/usertime
1006 # ALWAYS_TRUSTED_EXEC:http://www.more.net/<tab>/usr/local/kinetic/bin/who.sh
1009 # ALWAYS_TRUSTED_EXEC:file://localhost/<tab>usertime
1010 # ALWAYS_TRUSTED_EXEC:http://www.more.net/<tab>show users
1012 # The default ALWAYS_TRUSTED_EXEC rule is "none".
1014 ALWAYS_TRUSTED_EXEC:none
1020 # TRUSTED_LYNXCGI rules define the permitted sources and/or paths for
1021 # lynxcgi links (if LYNXCGI_LINKS is defined in userdefs.h). The format
1022 # is the same as for TRUSTED_EXEC rules (see above), but no defaults are
1023 # defined, i.e., if no TRUSTED_LYNXCGI rules are defined here, any source
1024 # and path for lynxcgi links will be permitted. Example rules:
1026 # TRUSTED_LYNXCGI:file://localhost/
1027 # TRUSTED_LYNXCGI:<tab>/usr/local/etc/httpd/cgi-bin/
1028 # TRUSTED_LYNXCGI:file://localhost/<tab>/usr/local/www/cgi-bin/
1032 # Do not define this.
1034 TRUSTED_LYNXCGI:none
1037 .h2 LYNXCGI_ENVIRONMENT
1040 # LYNXCGI_ENVIRONMENT adds the current value of the specified
1041 # environment variable to the list of environment variables passed on to the
1042 # lynxcgi script. Useful variables are HOME, USER, etc... If proxies
1043 # are in use, and the script invokes another copy of lynx (or a program like
1044 # wget) in a subsidiary role, it can be useful to add http_proxy and other
1045 # *_proxy variables.
1049 # Do not define this.
1051 #LYNXCGI_ENVIRONMENT:
1054 .h2 LYNXCGI_DOCUMENT_ROOT
1057 # LYNXCGI_DOCUMENT_ROOT is the value of DOCUMENT_ROOT that will be passed
1058 # to lynxcgi scripts. If set and the URL has PATH_INFO data, then
1059 # PATH_TRANSLATED will also be generated. Examples:
1060 # LYNXCGI_DOCUMENT_ROOT:/usr/local/etc/httpd/htdocs
1061 # LYNXCGI_DOCUMENT_ROOT:/data/htdocs/
1065 # Do not define this.
1067 #LYNXCGI_DOCUMENT_ROOT:
1072 .h2 FORCE_SSL_COOKIES_SECURE
1073 # If FORCE_SSL_COOKIES_SECURE is set to TRUE, then SSL encrypted cookies
1074 # received from https servers never will be sent unencrypted to http
1075 # servers. The compilation default is to impose this block only if the
1076 # https server included a secure attribute for the cookie. The normal
1077 # default or that defined here can be toggled via the -force_secure
1078 # command line switch.
1080 #FORCE_SSL_COOKIES_SECURE:FALSE
1083 .h1 Internal Behavior
1085 .h2 MAIL_SYSTEM_ERROR_LOGGING
1086 # MAIL_SYSTEM_ERROR_LOGGING will send a message to the owner of
1087 # the information, or ALERTMAIL if there is no owner, every time
1088 # that a document cannot be accessed!
1090 # NOTE: This can generate A LOT of mail, be warned.
1092 #MAIL_SYSTEM_ERROR_LOGGING:FALSE
1096 # If CHECKMAIL is set to TRUE, the user will be informed (via a statusline
1097 # message) about the existence of any unread mail at startup of Lynx, and
1098 # will get statusline messages if subsequent new mail arrives. If a jumps
1099 # file with a lynxprog URL for invoking mail is available, or your html
1100 # pages include an mail launch file URL, the user thereby can access mail
1101 # and read the messages. The checks and statusline reports will not be
1102 # performed if Lynx has been invoked with the -restrictions=mail switch.
1106 # New mail is normally broadcast as it arrives, via "unsolicited screen
1107 # broadcasts", which can be "wiped" from the Lynx display via the Ctrl-W
1108 # command. You may prefer to disable the broadcasts and use CHECKMAIL
1109 # instead (e.g., in a public account which will be used by people who
1110 # are ignorant about VMS).
1118 # To enable news reading ability via Lynx, the environment variable NNTPSERVER
1119 # must be set so that it points to your site's NNTP server
1120 # (see Lynx Users Guide on environment variables).
1121 # Lynx respects RFC 1738 (http://www.ics.uci.edu/pub/ietf/uri/rfc1738.txt)
1122 # and does not accept a host field in news URLs (use nntp: instead of news: for
1123 # the scheme if you wish to specify an NNTP host in a URL, as explained in the
1124 # RFC). If you have not set the variable externally, you can set it at run
1125 # time via this configuration file. It will not override an external setting.
1126 # Note that on VMS it is set as a process logical rather than symbol, and will
1127 # outlive the Lynx image.
1128 # The news reading facility in Lynx is quite limited. Lynx does not provide a
1129 # full featured news reader with elaborate error checking and safety features.
1134 .h2 LIST_NEWS_NUMBERS
1135 # If LIST_NEWS_NUMBERS is set TRUE, Lynx will use an ordered list and include
1136 # the numbers of articles in news listings, instead of using an unordered
1137 # list. The default is defined in userdefs.h, and can be overridden here.
1139 #LIST_NEWS_NUMBERS:FALSE
1143 # If LIST_NEWS_DATES is set TRUE, Lynx will include the dates of articles in
1144 # news listings. The dates always are included in the articles, themselves.
1145 # The default is defined in userdefs.h, and can be overridden here.
1147 #LIST_NEWS_DATES:FALSE
1152 # NEWS_CHUNK_SIZE and NEWS_MAX_CHUNK regulate the chunking of news article
1153 # listings with inclusion of links for listing earlier and/or later articles.
1154 # The defaults are defined in HTNews.c as 30 and 40, respectively. If the
1155 # news group contains more than NEWS_MAX_CHUNK articles, they will be listed
1156 # in NEWS_CHUNK_SIZE chunks. You can change the defaults here, and/or on
1157 # the command line via -newschunksize=NUMBER and/or -newsmaxchunk=NUMBER
1158 # switches. Note that if the chunk size is increased, here or on the command
1159 # line, to a value greater than the current maximum, the maximum will be
1160 # increased to that number. Conversely, if the maximum is set to a number
1161 # less than the current chunk size, the chunk size will be reduced to that
1162 # number. Thus, you need use only one of the two switches on the command
1163 # line, based on the direction of intended change relative to the compilation
1164 # or configuration defaults. The compilation defaults ensure that there will
1165 # be at least 10 earlier articles before bothering to chunk and create a link
1166 # for earlier articles.
1173 # Set NEWS_POSTING to FALSE if you do not want to support posting to
1174 # news groups via Lynx. If left TRUE, Lynx will use its news gateway to
1175 # post new messages or followups to news groups, using the URL schemes
1176 # described in the "Supported URLs" section of the online 'h'elp. The
1177 # posts will be attempted via the nntp server specified in the URL, or
1178 # if none was specified, via the NNTPSERVER configuration or environment
1179 # variable. Links with these URLs for posting or sending followups are
1180 # created by the news gateway when reading group listings or articles
1181 # from nntp servers if the server indicates that it permits posting.
1182 # The compilation default set in userdefs.h can be changed here. If
1183 # the default is TRUE, posting can still be disallowed via the
1184 # -restrictions command line switch.
1185 # The posting facility in Lynx is quite limited. Lynx does not provide a
1186 # full featured news poster with elaborate error checking and safety features.
1192 # LYNX_SIG_FILE defines the name of a file containing a signature which
1193 # can be appended to email messages and news postings or followups. The
1194 # user will be prompted whether to append it. It is sought in the home
1195 # directory. If it is in a subdirectory, begin it with a dot-slash
1196 # (e.g., ./lynx/.lynxsig). The definition is set in userdefs.h and can
1199 #LYNX_SIG_FILE:.lynxsig
1201 .h1 Bibliographic Protocol (bibp scheme)
1203 .h2 BIBP_GLOBAL_SERVER
1204 # BIBP_GLOBAL_SERVER is the default global server for bibp: links, used
1205 # when a local bibhost or document-specified citehost is unavailable.
1206 # Set in userdefs.h and can be changed here.
1207 #BIBP_GLOBAL_SERVER:http://usin.org/
1210 # BIBP_BIBHOST is the URL at which local bibp service may be found, if
1211 # it exists. Defaults to http://bibhost/ for protocol conformance, but
1212 # may be overridden here or via --bibhost parameter.
1213 #BIBP_BIBHOST:http://bibhost/
1216 # These settings control interaction of the user with lynx.
1219 # If SCROLLBAR is set TRUE, Lynx will show scrollbar on windows. With mouse
1220 # enabled, the scrollbar strip outside the bar is clickable, and scrolls the
1221 # window by pages. The appearance of the scrollbar can be changed from
1222 # LYNX_LSS file: define attributes scroll.bar, scroll.back (for the bar, and
1223 # for the strip along which the scrollbar moves).
1228 # If SCROLLBAR_ARROW is set TRUE, Lynx's scrollbar will have arrows at the
1229 # ends. With mouse enabled, the arrows are clickable, and scroll the window by
1230 # 2 lines. The appearance of the scrollbar arrows can be changed from LYNX_LSS
1231 # file: define attributes scroll.arrow, scroll.noarrow (for enabled-arrows,
1232 # and disabled arrows). An arrow is "disabled" if the bar is at this end of
1234 #SCROLLBAR_ARROW:TRUE
1238 # If Lynx is configured with ncurses, PDcurses or slang & USE_MOUSE is TRUE,
1239 # users can perform commands by left-clicking certain parts of the screen:
1240 # on a link = `g'oto + ACTIVATE (ie move highlight & follow the link);
1241 # on the top/bottom lines = PREV/NEXT_PAGE (ie go up/down 1 page);
1242 # on the top/bottom left corners = PREV_DOC (ie go to the previous document);
1243 # on the top/bottom right corners = HISTORY (ie call up the history page).
1244 # NB if the mouse is defined in this way, it will not be available
1245 # for copy/paste operations using the clipboard of a desktop manager:
1246 # for flexibility instead, use the command-line switch -use_mouse .
1248 # ncurses and slang have built-in support for the xterm mouse protocol. In
1249 # addition, ncurses can be linked with the gpm mouse library, to automatically
1250 # provide support for this interface in applications such as Lynx. (Please
1251 # read the ncurses faq to work around broken gpm configurations packaged by
1252 # some distributors). PDCurses implements mouse support for win32 console
1253 # windows, as does slang.
1258 # These settings control the way Lynx parses invalid HTML
1259 # and how it may resolve such issues.
1261 .h2 COLLAPSE_BR_TAGS
1262 # If COLLAPSE_BR_TAGS is set FALSE, Lynx will not collapse serial BR tags.
1263 # If set TRUE, two or more concurrent BRs will be collapsed into a single
1264 # line break. Note that the valid way to insert extra blank lines in HTML
1265 # is via a PRE block with only newlines in the block.
1267 #COLLAPSE_BR_TAGS:TRUE
1271 # If TAGSOUP is set, Lynx uses the "Tag Soup DTD" rather than "SortaSGML".
1272 # The two approaches differ by the style of error detection and recovery.
1273 # Tag Soup DTD allows for improperly nested tags; SortaSGML is stricter.
1280 # If SET_COOKIES is set FALSE, Lynx will ignore Set-Cookie headers
1281 # in http server replies. Note that if a COOKIE_FILE is in use (see
1282 # below) that contains cookies at startup, Lynx will still send those
1283 # persistent cookies in requests as appropriate. Setting SET_COOKIES
1284 # to FALSE just prevents accepting any new cookies from servers. To
1285 # prevent all cookie processing (sending *and* receiving) in a session,
1286 # make sure that PERSISTENT_COOKIES is not TRUE or that COOKIE_FILE does
1287 # not point to a file with cookies, in addition to setting SET_COOKIES
1289 # The default is defined in userdefs.h, and can be overridden here,
1290 # and/or toggled via the -cookies command line switch.
1295 .h2 ACCEPT_ALL_COOKIES
1296 # If ACCEPT_ALL_COOKIES is set TRUE, Lynx will accept cookies from all
1297 # domains with no user interaction. This is equivalent to automatically
1298 # replying to all cookie 'Allow?' prompts with 'A'lways. Note that it
1299 # does not preempt validity checking, which has to be controlled separately
1301 # The default is defined in userdefs.h and can be overridden here, or
1302 # in the .lynxrc file via an o(ptions) screen setting. It may also be
1303 # toggled via the -accept_all_cookies command line switch.
1305 #ACCEPT_ALL_COOKIES:FALSE
1308 .h2 COOKIE_ACCEPT_DOMAINS
1309 .h2 COOKIE_REJECT_DOMAINS
1310 # COOKIE_ACCEPT_DOMAINS and COOKIE_REJECT_DOMAINS are comma-delimited lists
1311 # of domains from which Lynx should automatically accept or reject cookies
1312 # without asking for confirmation. If the same domain is specified in both
1313 # lists, rejection will take precedence.
1314 # Note that in order to match cookies, domains have to be spelled out exactly
1315 # in the form in which they would appear on the Cookie Jar page (case is
1316 # insignificant). They are not wildcards. Domains that apply to more than
1317 # one host have a leading '.', but have to match *the cookie's* domain
1320 #COOKIE_ACCEPT_DOMAINS:
1321 #COOKIE_REJECT_DOMAINS:
1324 .h2 COOKIE_LOOSE_INVALID_DOMAINS
1325 .h2 COOKIE_STRICT_INVALID_DOMAINS
1326 .h2 COOKIE_QUERY_INVALID_DOMAINS
1327 # COOKIE_LOOSE_INVALID_DOMAINS, COOKIE_STRICT_INVALID_DOMAINS, and
1328 # COOKIE_QUERY_INVALID_DOMAINS are comma-delimited lists of domains.
1329 # They control the degree of validity checking that is applied to cookies
1330 # for the specified domains.
1331 # Note that in order to match cookies, domains have to be spelled out exactly
1332 # in the form in which they would appear on the Cookie Jar page (case is
1333 # insignificant). They are not wildcards. Domains that apply to more than
1334 # one host have a leading '.', but have to match *the cookie's* domain
1336 # If a domain is set to strict checking, strict conformance to RFC2109 will
1337 # be applied. A domain with loose checking will be allowed to set cookies
1338 # with an invalid path or domain attribute. All domains will default to
1339 # asking the user for confirmation in case of an invalid path or domain.
1340 # Cookie validity checking takes place as a separate step before the
1341 # final decision to accept or reject (see previous options), therefore
1342 # a cookie that passes validity checking may still be automatically
1343 # rejected or cause another prompt.
1345 #COOKIE_LOOSE_INVALID_DOMAINS:
1346 #COOKIE_STRICT_INVALID_DOMAINS:
1347 #COOKIE_QUERY_INVALID_DOMAINS:
1350 .h2 PERSISTENT_COOKIES
1351 # PERSISTENT_COOKIES indicates that cookies should be read at startup from
1352 # the COOKIE_FILE, and saved at exit for storage between Lynx sessions.
1353 # It is not used if Lynx was compiled without USE_PERSISTENT_COOKIES.
1354 # The default is FALSE, so that the feature needs to be enabled here
1355 # explicitly if you want it.
1357 #PERSISTENT_COOKIES:FALSE
1361 # COOKIE_FILE is the default file from which persistent cookies are read
1362 # at startup (if the file exists), if Lynx was compiled with
1363 # USE_PERSISTENT_COOKIES and the PERSISTENT_COOKIES option is enabled.
1364 # The cookie file can also be specified in .lynxrc or on the command line.
1366 #COOKIE_FILE:~/.lynx_cookies
1369 .h2 COOKIE_SAVE_FILE
1370 # COOKIE_SAVE_FILE is the default file in which persistent cookies are
1371 # stored at exit, if Lynx was compiled with USE_PERSISTENT_COOKIES and the
1372 # PERSISTENT_COOKIES option is enabled. The cookie save file can also be
1373 # specified on the command line.
1375 # With an interactive Lynx session, COOKIE_SAVE_FILE will default to
1376 # COOKIE_FILE if it is not set. With a non-interactive Lynx session (e.g.,
1377 # -dump), cookies will only be saved to file if COOKIE_SAVE_FILE is set.
1379 #COOKIE_SAVE_FILE:~/.lynx_cookies
1385 .h2 SYSTEM_MAIL_FLAGS
1388 # The mail command and qualifiers are defined in userdefs.h. Lynx
1389 # will spawn a subprocess to send replies and error messages. The
1390 # command, and qualifiers (if any), can be re-defined here. If
1391 # you use PMDF then headers will we passed via a header file.
1392 # If you use "generic" VMS MAIL, the subject will be passed on the
1393 # command line via a /subject="SUBJECT" qualifier, and inclusion
1394 # of other relevant headers may not be possible.
1395 # If your mailer uses another syntax, some hacking of the mailform()
1396 # mailmsg() and reply_by_mail() functions in LYMail.c, and send_file_to_mail()
1397 # function in LYPrint.c, may be required.
1400 #SYSTEM_MAIL:PMDF SEND
1401 #SYSTEM_MAIL_FLAGS:/headers
1409 # The mail path and flags normally are defined for sendmail (or submit
1410 # with MMDF) in userdefs.h. You can change them here, but should first
1411 # read the zillions of CERT advisories about security problems with Unix
1415 #SYSTEM_MAIL:/usr/mmdf/bin/submit
1416 #SYSTEM_MAIL_FLAGS:-mlruxto,cc\*
1419 #SYSTEM_MAIL:/usr/sbin/sendmail
1420 #SYSTEM_MAIL_FLAGS:-t -oi
1423 #SYSTEM_MAIL:/usr/lib/sendmail
1424 #SYSTEM_MAIL_FLAGS:-t -oi
1428 # Please read sendmail.txt in the LYNX_W32.ZIP distribution
1430 #SYSTEM_MAIL:sendmail -f me@my.host -h my.host -r my.smtp.mailer -m SMTP
1436 # MAIL_ADRS is defined in userdefs.h and normally is structured for PMDF's
1437 # IN%"INTERNET_ADDRESS" scheme. The %s is replaced with the address given
1438 # by the user. If you are using a different Internet mail transport, change
1439 # the IN appropriately (e.g., to SMTP, MX, or WINS).
1441 #MAIL_ADRS:"IN%%""%s"""
1444 .h2 USE_FIXED_RECORDS
1447 # If USE_FIXED_RECORDS is set to TRUE here or in userdefs.h, Lynx will
1448 # convert 'd'ownloaded binary files to FIXED 512 record format before saving
1449 # them to disk or acting on a DOWNLOADER option. If set to FALSE, the
1450 # headers of such files will indicate that they are Stream_LF with Implied
1451 # Carriage Control, which is incorrect, and can cause downloading software
1452 # to get confused and unhappy. If you do set it FALSE, you can use the
1453 # FIXED512.COM command file, which is included in this distribution, to do
1454 # the conversion externally.
1456 #USE_FIXED_RECORDS:TRUE
1460 # These settings control the way Lynx interprets user input.
1463 .h2 VI_KEYS_ALWAYS_ON
1464 .h2 EMACS_KEYS_ALWAYS_ON
1465 # Vi or Emacs movement keys, i.e. familiar hjkl or ^N^P^F^B .
1466 # These are defaults, which can be changed in the Options Menu or .lynxrc .
1467 #VI_KEYS_ALWAYS_ON:FALSE
1468 #EMACS_KEYS_ALWAYS_ON:FALSE
1471 .h2 DEFAULT_KEYPAD_MODE
1472 # DEFAULT_KEYPAD_MODE may be set to NUMBERS_AS_ARROWS
1473 # or LINKS_ARE_NOT_NUMBERED (the same)
1474 # or LINKS_ARE_NUMBERED
1475 # or LINKS_AND_FIELDS_ARE_NUMBERED
1476 # or FIELDS_ARE_NUMBERED
1477 # to specify whether numbers (e.g. [10]) appear next to all links,
1478 # allowing immediate access by entering the number on the keyboard,
1479 # or numbers on the numeric key-pad work like arrows;
1480 # the "FIELDS" options cause form fields also to be numbered.
1481 # This may be overridden by the keypad_mode setting in .lynxrc,
1482 # and can also be changed via the Options Menu.
1484 #DEFAULT_KEYPAD_MODE:NUMBERS_AS_ARROWS
1487 .h2 NUMBER_LINKS_ON_LEFT
1488 .h2 NUMBER_FIELDS_ON_LEFT
1489 # Denotes the position for link- and field-numbers (whether it is on the left
1490 # or right of the anchor). These are subject to DEFAULT_KEYPAD_MODE, which
1491 # determines whether numbers are shown.
1492 #NUMBER_LINKS_ON_LEFT:TRUE
1493 #NUMBER_FIELDS_ON_LEFT:TRUE
1495 .h2 DEFAULT_KEYPAD_MODE_IS_NUMBERS_AS_ARROWS
1496 # Obsolete form of DEFAULT_KEYPAD_MODE,
1497 # numbers work like arrows or numbered links.
1498 # Set to TRUE, indicates numbers act as arrows,
1499 # and set to FALSE indicates numbers refer to numbered links on the page.
1500 # LINKS_AND_FIELDS_ARE_NUMBERED cannot be set by this option because
1501 # it allows only two values (true and false).
1503 #DEFAULT_KEYPAD_MODE_IS_NUMBERS_AS_ARROWS:TRUE
1506 .h2 CASE_SENSITIVE_ALWAYS_ON
1507 # The default search type.
1508 # This is a default that can be overridden by the user!
1510 #CASE_SENSITIVE_ALWAYS_ON:FALSE
1513 .h1 Auxiliary Facilities
1515 .h2 DEFAULT_BOOKMARK_FILE
1516 # DEFAULT_BOOKMARK_FILE is the filename used for storing personal bookmarks.
1517 # It will be prepended by the user's home directory.
1518 # NOTE that a file ending in .html or other suffix mapped to text/html
1519 # should be used to ensure its treatment as HTML. The built-in default
1520 # is lynx_bookmarks.html. On both Unix and VMS, if a subdirectory off of
1521 # the HOME directory is desired, the path should begin with "./" (e.g.,
1522 # ./BM/lynx_bookmarks.html), but the subdirectory must already exist.
1523 # Lynx will create the bookmark file, if it does not already exist, on
1524 # the first ADD_BOOKMARK attempt if the HOME directory is indicated
1525 # (i.e., if the definition is just filename.html without any slashes),
1526 # but requires a pre-existing subdirectory to create the file there.
1527 # The user can re-define the default bookmark file, as well as a set
1528 # of sub-bookmark files if multiple bookmark file support is enabled
1529 # (see below), via the 'o'ptions menu, and can save those definitions
1530 # in the .lynxrc file.
1532 #DEFAULT_BOOKMARK_FILE:lynx_bookmarks.html
1535 .h2 MULTI_BOOKMARK_SUPPORT
1536 # If MULTI_BOOKMARK_SUPPORT is set TRUE, and BLOCK_MULTI_BOOKMARKS (see
1537 # below) is FALSE, and sub-bookmarks exist, all bookmark operations will
1538 # first prompt the user to select an active sub-bookmark file or the
1539 # default bookmark file. FALSE is the default so that one (the default)
1540 # bookmark file will be available initially. The definition here will
1541 # override that in userdefs.h. The user can turn on multiple bookmark
1542 # support via the 'o'ptions menu, and can save that choice as the startup
1543 # default via the .lynxrc file. When on, the setting can be STANDARD or
1544 # ADVANCED. If SUPPORT is set to the latter, and the user mode also is
1545 # ADVANCED, the VIEW_BOOKMARK command will invoke a statusline prompt at
1546 # which the user can enter the letter token (A - Z) of the desired bookmark,
1547 # or '=' to get a menu of available bookmark files. The menu always is
1548 # presented in NOVICE or INTERMEDIATE mode, or if the SUPPORT is set to
1549 # STANDARD. No prompting or menu display occurs if only one (the startup
1550 # default) bookmark file has been defined (define additional ones via the
1551 # 'o'ptions menu). The startup default, however set, can be overridden on
1552 # the command line via the -restrictions=multibook or the -anonymous or
1553 # -validate switches.
1555 #MULTI_BOOKMARK_SUPPORT:FALSE
1558 .h2 BLOCK_MULTI_BOOKMARKS
1559 # If BLOCK_MULTI_BOOKMARKS is set TRUE, multiple bookmark support will
1560 # be forced off, and cannot to toggled on via the 'o'ptions menu. The
1561 # compilation setting is normally FALSE, and can be overridden here.
1562 # It can also be set via the -restrictions=multibook or the -anonymous
1563 # or -validate command line switches.
1565 #BLOCK_MULTI_BOOKMARKS:FALSE
1570 .h2 DEFAULT_USER_MODE
1571 # DEFAULT_USER_MODE sets the default user mode for Lynx users.
1572 # NOVICE shows a three line help message at the bottom of the screen.
1573 # INTERMEDIATE shows normal amount of help (one line).
1574 # ADVANCED help is replaced by the URL of the current link.
1576 #DEFAULT_USER_MODE:NOVICE
1579 .h1 External Programs
1582 # If DEFAULT_EDITOR is defined, users may edit local documents with it
1583 # & it will also be used for sending mail messages.
1584 # If no editor is defined here or by the user,
1585 # the user will not be able to edit local documents
1586 # and a primitive line-oriented mail-input mode will be used.
1588 # For sysadmins: do not define a default editor
1589 # unless you know EVERY user will know how to use it;
1590 # users can easily define their own editor in the Options Menu.
1592 DEFAULT_EDITOR: /usr/bin/sensible-editor
1596 # SYSTEM_EDITOR behaves the same as DEFAULT_EDITOR,
1597 # except that it can't be changed by users.
1613 .h2 SNEWSREPLY_PROXY
1618 # Lynx version 2.2 and beyond supports the use of proxy servers that can act as
1619 # firewall gateways and caching servers. They are preferable to the older
1620 # gateway servers. Each protocol used by Lynx can be mapped separately using
1621 # PROTOCOL_proxy environment variables (see Lynx Users Guide). If you have not set
1622 # them externally, you can set them at run time via this configuration file.
1623 # They will not override external settings. The no_proxy variable can be used
1624 # to inhibit proxying to selected regions of the Web (see below). Note that on
1625 # VMS these proxy variables are set as process logicals rather than symbols, to
1626 # preserve lowercasing, and will outlive the Lynx image.
1629 #http_proxy:http://some.server.dom:port/
1630 #https_proxy:http://some.server.dom:port/
1631 #ftp_proxy:http://some.server.dom:port/
1632 #gopher_proxy:http://some.server.dom:port/
1633 #news_proxy:http://some.server.dom:port/
1634 #newspost_proxy:http://some.server.dom:port/
1635 #newsreply_proxy:http://some.server.dom:port/
1636 #snews_proxy:http://some.server.dom:port/
1637 #snewspost_proxy:http://some.server.dom:port/
1638 #snewsreply_proxy:http://some.server.dom:port/
1639 #nntp_proxy:http://some.server.dom:port/
1640 #wais_proxy:http://some.server.dom:port/
1641 #finger_proxy:http://some.server.dom:port/
1642 #cso_proxy:http://some.server.dom:port/
1643 #no_proxy:host.domain.dom
1647 # The no_proxy variable can be a comma-separated list of strings defining
1648 # no-proxy zones in the DNS domain name space. If a tail substring of the
1649 # domain-path for a host matches one of these strings, transactions with that
1650 # node will not be proxied.
1652 #no_proxy:domain.path1,path2
1654 # A single asterisk as an entry will override all proxy variables and no
1655 # transactions will be proxied.
1658 # This is the only allowed use of * in no_proxy.
1660 # Warning: Note that setting 'il' as an entry in this list will block proxying
1661 # for the .mil domain as well as the .il domain. If the entry is '.il' this
1665 .h1 External Programs
1670 # PRINTER, DOWNLOADER & UPLOADER DEFINITIONS:
1671 # Lynx has 4 pre-defined print options & 1 pre-defined download option,
1672 # which are called up on-screen when `p' or `d' are entered;
1673 # any number of options can be added by the user, as explained below.
1674 # Uploaders can be defined only for UNIX with DIRED_SUPPORT:
1675 # see the Makefile in the top directory & the header of src/LYUpload.c .
1677 # For `p' pre-defined options are: `Save to local file', `E-mail the file',
1678 # `Print to screen' and `Print to local printer attached to vt100'.
1679 # `Print to screen' allows file transfers in the absence of alternatives
1680 # and is often the only option allowed here for anonymous users;
1681 # the 3rd & 4th options are not pre-defined for DOS/WINDOWS versions of Lynx.
1682 # For `d' the pre-defined option is: `Download to local file'.
1684 # To define your own print or download option use the following formats:
1686 # PRINTER:<name>:<command>:<option>:<lines/page>
1688 # DOWNLOADER:<name>:<command>:<option>
1690 # <name> is what you will see on the print/download screen.
1692 # <command> is the command your system will execute:
1693 # the 1st %s in the command will be replaced
1694 # by the temporary filename used by Lynx;
1695 # a 2nd %s will be replaced by a filename of your choice,
1696 # for which Lynx will prompt, offering a suggestion.
1697 # On Unix, which has pipes, you may use a '|' as the first
1698 # character of the command, and Lynx will open a pipe to
1700 # If the command format of your printer/downloader requires
1701 # a different layout, you will need to use a script
1702 # (see the last 2 download examples below).
1704 # <option> TRUE : the printer/downloader will always be ENABLED,
1705 # except that downloading is disabled when -validate is used;
1706 # FALSE : both will be DISABLED for anonymous users
1707 # and printing will be disabled when -noprint is used.
1709 # <lines/page> (printers: optional) the number of lines/page (default 66):
1710 # used to compute the approximate output size
1711 # and prompt if the document is > 4 printer pages;
1712 # it uses current screen length for the computation
1713 # when `Print to screen' is selected.
1715 # You must put the whole definition on one line;
1716 # if you use a colon, precede it with a backslash.
1718 # `Printer' can be any file-handling program you find useful,
1719 # even if it does not physically print anything.
1721 # Usually, down/up-loading involves the use of (e.g.) Ckermit or ZModem
1722 # to transfer files to a user's local machine over a serial link,
1723 # but download options do not have to be download-protocol programs.
1727 #PRINTER:Computer Center printer:lpr -Pccprt %s:FALSE
1728 #PRINTER:Office printer:lpr -POffprt %s:TRUE
1729 #PRINTER:VMS printer:print /queue=cc$print %s:FALSE:58
1730 # If you have a very busy VMS print queue
1731 # and Lynx deletes the temporary files before they have been queued,
1732 # use the VMSPrint.com included in the distribution:
1734 #PRINTER:Busy VMS printer:@Lynx_Dir\:VMSPrint sys$print %s:FALSE:58
1735 # To specify a print option at run-time:
1736 # NBB if you have ANONYMOUS users, DO NOT allow this option!
1738 #PRINTER:Specify at run-time:echo -n "Enter a print command\: "; read word; sh -c "$word %s":FALSE
1739 # To pass to a sophisticated file viewer: -k suppresses invocation
1740 # of hex display mode if 8-bit or control characters are present;
1741 # +s invokes secure mode (see ftp://space.mit.edu/pub/davis/most):
1743 #PRINTER:Use Most to view:most -k +s %s:TRUE:23
1745 # Downloader examples:
1746 # in Kermit, -s %s is the filename sent, -a %s the filename on arrival
1747 # (if they are given in reverse order here, the command will fail):
1749 #DOWNLOADER:Use Kermit to download to the terminal:kermit -i -s %s -a %s:TRUE
1750 # NB don't use -k with Most, so that binaries will invoke hexadecimal mode:
1752 #DOWNLOADER:Use Most to view:most +s %s:TRUE
1753 # The following example gives wrong filenames
1754 # (`sz' doesn't support a suggested filename parameter):
1756 #DOWNLOADER:Use Zmodem to download to the local terminal:sz %s:TRUE
1757 # The following example returns correct filenames
1758 # by using a script to make a subdirectory in /tmp,
1759 # but may conflict with very strong security or permissions restrictions:
1761 #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
1763 #UPLOADER:Use Kermit to upload from your computer: kermit -i -r -a %s:TRUE
1764 #UPLOADER:Use Zmodem to upload from your computer: rz %s:TRUE
1766 # Note for OS/390: /* S/390 -- gil -- 1464 */
1767 # The following is strongly recommended to undo ASCII->EBCDIC conversion.
1769 #DOWNLOADER:Save OS/390 binary file: iconv -f IBM-1047 -t ISO8859-1 %s >%s:FALSE
1775 # If NO_DOT_FILES is TRUE (normal default via userdefs.h), the user will not
1776 # be allowed to specify files beginning with a dot in reply to output filename
1777 # prompts, and files beginning with a dot (e.g., file://localhost/path/.lynxrc)
1778 # will not be included in the directory browser's listings. If set FALSE, you
1779 # can force it to be treated as TRUE via -restrictions=dotfiles. If set FALSE
1780 # and not forced TRUE, the user can regulate it via the 'o'ptions menu (and
1781 # may save the preference in the RC file).
1786 .h1 Internal Behavior
1789 # If NO_FROM_HEADER is set FALSE, From headers will be sent in transmissions
1790 # to http or https servers if the personal_mail_address has been defined via
1791 # the 'o'ptions menu. The compilation default is TRUE (no From header is
1792 # sent) and the default can be changed here. The default can be toggled at
1793 # run time via the -from switch. Note that transmissions of From headers
1794 # have become widely considered to create an invasion of privacy risk.
1796 #NO_FROM_HEADER:TRUE
1799 .h2 NO_REFERER_HEADER
1800 # If NO_REFERER_HEADER is TRUE, Referer headers never will be sent in
1801 # transmissions to servers. Lynx normally sends the URL of the document
1802 # from which the link was derived, but not for startfile URLs, 'g'oto
1803 # URLs, 'j'ump shortcuts, bookmark file links, history list links, or
1804 # URLs that include the content from form submissions with method GET.
1805 # If left FALSE here, it can be set TRUE at run time via the -noreferer
1808 #NO_REFERER_HEADER:FALSE
1811 .h1 Internal Behavior
1814 # If NO_FILE_REFERER is TRUE, Referer headers never will be sent in
1815 # transmissions to servers for links or actions derived from documents
1816 # or forms with file URLs. This ensures that paths associated with
1817 # the local file system are never indicated to servers, even if
1818 # NO_REFERER_HEADER is FALSE. If set to FALSE here, it can still be
1819 # set TRUE at run time via the -nofilereferer switch.
1821 #NO_FILE_REFERER:TRUE
1824 .h2 REFERER_WITH_QUERY
1825 # REFERER_WITH_QUERY controls what happens when the URL in a Referer
1826 # header to be sent would contain a query part in the form of a '?'
1827 # character followed by one or more attribute=value pairs. Query parts
1828 # often contain sensitive or personal information resulting from filling
1829 # out forms, or other info that allows tracking of a user's browsing path
1830 # through a site, an thus should not be put in a Referer header (which may
1831 # get sent to an unrelated third-party site). On the other hand, some
1832 # sites (improperly) rely on browsers sending Referer headers, even when
1833 # the user is coming from a page whose URL has a query part.
1835 # If REFERER_WITH_QUERY is SEND, full Referer headers will be sent
1836 # including the query part (unless sending of Referer is disabled in
1837 # general, see NO_REFERER_HEADER above). If REFERER_WITH_QUERY is
1838 # PARTIAL, the Referer header will contain a partial URL, with the query
1839 # part stripped off. This is not strictly correct, but should satisfy
1840 # those sites that check only whether the user arrived at a page from an
1841 # "outside" link. If REFERER_WITH_QUERY is set to DROP (or anything else
1842 # unrecognized), the default, no Referer header is sent at all in this
1845 #REFERER_WITH_QUERY:DROP
1851 # VERBOSE_IMAGES controls whether Lynx replaces [LINK], [INLINE] and [IMAGE]
1852 # (for images without ALT) with filenames of these images.
1853 # This can be useful in determining what images are important
1854 # and which are mere decorations, e.g. button.gif, line.gif,
1855 # provided the author uses meaningful names.
1857 # The definition here will override the setting in userdefs.h.
1859 #VERBOSE_IMAGES:TRUE
1862 .h2 MAKE_LINKS_FOR_ALL_IMAGES
1863 # If MAKE_LINKS_FOR_ALL_IMAGES is TRUE, all images will be given links
1864 # which can be ACTIVATEd. For inlines, the ALT or pseudo-ALT ("[INLINE]")
1865 # strings will be links for the resolved SRC rather than just text.
1866 # For ISMAP or other graphic links, ALT or pseudo-ALT ("[ISMAP]" or "[LINK]")
1867 # will have '-' and a link labeled "[IMAGE]" for the resolved SRC appended.
1868 # See also VERBOSE_IMAGES flag.
1870 # The definition here will override that in userdefs.h
1871 # and can be toggled via an "-image_links" command-line switch.
1872 # The user can also use the LYK_IMAGE_TOGGLE key (default `*')
1873 # or `Show Images' in the Form-based Options Menu.
1875 #MAKE_LINKS_FOR_ALL_IMAGES:FALSE
1877 .h2 MAKE_PSEUDO_ALTS_FOR_INLINES
1878 # If MAKE_PSEUDO_ALTS_FOR_INLINES is FALSE, inline images which don't specify
1879 # an ALT string will not have "[INLINE]" inserted as a pseudo-ALT,
1880 # i.e. they'll be treated as having ALT="".
1881 # Otherwise (if TRUE), pseudo-ALTs will be created for inlines,
1882 # so that they can be used as links to the SRCs.
1883 # See also VERBOSE_IMAGES flag.
1885 # The definition here will override that in userdefs.h
1886 # and can be toggled via a "-pseudo_inlines" command-line switch.
1887 # The user can also use the LYK_INLINE_TOGGLE key (default `[')
1888 # or `Show Images' in the Form-based Options Menu.
1890 #MAKE_PSEUDO_ALTS_FOR_INLINES:TRUE
1893 .h2 SUBSTITUTE_UNDERSCORES
1894 # If SUBSTITUTE_UNDERSCORES is TRUE, the _underline_ format will be used
1895 # for emphasis tags in dumps.
1897 # The default defined here will override that in userdefs.h, and the user
1898 # can toggle the default via a "-underscore" command line switch.
1900 #SUBSTITUTE_UNDERSCORES:FALSE
1905 .h2 QUIT_DEFAULT_YES
1906 # If QUIT_DEFAULT_YES is TRUE then when the QUIT command is entered, any
1907 # response other than n or N will confirm. It should be FALSE if you
1908 # prefer the more conservative action of requiring an explicit Y or y to
1909 # confirm. The default defined here will override that in userdefs.h.
1911 #QUIT_DEFAULT_YES:TRUE
1916 .h2 HISTORICAL_COMMENTS
1917 # If HISTORICAL_COMMENTS is TRUE, Lynx will revert to the "Historical"
1918 # behavior of treating any '>' as a terminator for comments, instead of
1919 # seeking a valid '-->' terminator (note that white space can be present
1920 # between the '--' and '>' in valid terminators). The compilation default
1923 # The compilation default, or default defined here, can be toggled via a
1924 # "-historical" command line switch, and via the LYK_HISTORICAL command key.
1926 #HISTORICAL_COMMENTS:FALSE
1929 .h2 MINIMAL_COMMENTS
1930 # If MINIMAL_COMMENTS is TRUE, Lynx will not use Valid comment parsing
1931 # of '--' pairs as serial comments within an overall comment element,
1932 # and instead will seek only a '-->' terminator for the overall comment
1933 # element. This emulates the Netscape v2.0 comment parsing bug, and
1934 # will help Lynx cope with the use of dashes as "decorations", which
1935 # consequently has become common in so-called "Enhanced for Netscape"
1936 # pages. Note that setting Historical comments on will override the
1937 # Minimal or Valid setting.
1939 # The compilation default for MINIMAL_COMMENTS is FALSE, but we'll
1940 # set it TRUE here, until Netscape gets its comment parsing right,
1941 # and "decorative" dashes cease to be so common.
1943 # The compilation default, or default defined here, can be toggled via a
1944 # "-minimal" command line switch, and via the LYK_MINIMAL command key.
1946 MINIMAL_COMMENTS:TRUE
1950 # If SOFT_DQUOTES is TRUE, Lynx will emulate the invalid behavior of
1951 # treating '>' as a co-terminator of a double-quoted attribute value
1952 # and the tag which contains it, as was done in old versions of Netscape
1953 # and Mosaic. The compilation default is FALSE.
1955 # The compilation default, or default defined here, can be toggled via
1956 # a "-soft_dquotes" command line switch.
1961 .h2 STRIP_DOTDOT_URLS
1962 # If STRIP_DOTDOT_URLS is TRUE, Lynx emulates the invalid behavior of many
1963 # browsers to strip a leading "../" segment from relative URLs in HTML
1964 # documents with a http or https base URL, if this would otherwise lead to
1965 # an absolute URLs with those characters still in it. Such URLs are normally
1966 # erroneous and not what is intended by page authors. Lynx will issue
1967 # a warning message when this occurs.
1969 # If STRIP_DOTDOT_URLS is FALSE, Lynx will use those URLs for requests
1970 # without taking any special actions or issuing Warnings, in most cases
1971 # this will result in an error response from the server.
1973 # Note that Lynx never tries to fix similar URLs for protocols other than
1974 # http and https, since they are less common and may actually be valid in
1977 #STRIP_DOTDOT_URLS:TRUE
1982 .h2 ENABLE_SCROLLBACK
1983 # If ENABLE_SCROLLBACK is TRUE, Lynx will clear the entire screen before
1984 # displaying each new screenful of text. Though less efficient for normal
1985 # use, this allows programs that maintain a buffer of previously-displayed
1986 # text to recognize the continuity of what has been displayed, so that
1987 # previous screenfuls can be reviewed by whatever method the program uses
1988 # to scroll back through previous text. For example, the PC comm program
1989 # QModem has a key that can be pressed to scroll back; if ENABLE_SCROLLBACK
1990 # is TRUE, pressing the scrollback key will access previous screenfuls which
1991 # will have been stored on the local PC and will therefore be displayed
1992 # instantaneously, instead of needing to be retransmitted by Lynx at the
1993 # speed of the comm connection (but Lynx will not know about the change,
1994 # so you must restore the last screen before resuming with Lynx commands).
1996 # The compilation default is FALSE (if REVERSE_CLEAR_SCREEN_PROBLEM was not
1997 # defined in the Unix Makefile to invoke this behavior as a workaround for
1998 # some poor curses implementations).
2000 # The default compilation or configuration setting can be toggled via an
2001 # "-enable_scrollback" command line switch.
2003 #ENABLE_SCROLLBACK:FALSE
2006 .h2 SCAN_FOR_BURIED_NEWS_REFS
2007 # If SCAN_FOR_BURIED_NEWS_REFS is set to TRUE, Lynx will scan the bodies
2008 # of news articles for buried article and URL references and convert them
2009 # to links. The compilation default is TRUE, but some email addresses
2010 # enclosed in angle brackets ("<user@address>") might be converted to false
2011 # news links, and uuencoded messages might be corrupted. The conversion is
2012 # not done when the display is toggled to source or when 'd'ownloading, so
2013 # uuencoded articles can be saved intact regardless of these settings.
2015 # The default setting can be toggled via a "-buried_news" command line
2018 #SCAN_FOR_BURIED_NEWS_REFS:TRUE
2021 .h2 PREPEND_BASE_TO_SOURCE
2022 # If PREPEND_BASE_TO_SOURCE is set to FALSE, Lynx will not prepend a
2023 # Request URL comment and BASE element to text/html source files when
2024 # they are retrieved for 'd'ownloading or passed to 'p'rint functions.
2025 # The compilation default is TRUE. Note that this prepending is not
2026 # done for -source dumps, unless the -base switch also was included on
2027 # the command line, and the latter switch overrides the setting of the
2028 # PREPEND_BASE_TO_SOURCE configuration variable.
2030 PREPEND_BASE_TO_SOURCE:FALSE
2033 # MIME types and viewers!
2035 # file extensions may be assigned to MIME types using
2036 # the SUFFIX: definition.
2038 # NOTE: It is normally preferable to define new extension mappings in
2039 # EXTENSION_MAP files (see below) instead of here: Definitions
2040 # here are overridden by those in EXTENSION_MAP files and even by
2041 # some built-in defaults in src/HTInit.c. On the other hand,
2042 # definitions here allow some more fields that are not possible
2045 # Extension mappings have an effect mostly for ftp and local files,
2046 # they are NOT used to determine the type of content for URLs with
2047 # the http protocol. This is because HTTP servers already specify
2048 # the MIME type in the Content-Type header. [It may still be
2049 # necessary to set up an appropriate suffix for some MIME types,
2050 # even if they are accessed only via the HTTP protocol, if the viewer
2051 # (see below) for those MIME types requires a certain suffix for the
2052 # temporary file passed to it.]
2055 .h1 External Programs
2057 .h2 GLOBAL_EXTENSION_MAP
2058 .h2 PERSONAL_EXTENSION_MAP
2059 # The global and personal EXTENSION_MAP files allow you to assign extensions
2060 # to MIME types which will override any of the suffix maps in this (lynx.cfg)
2061 # configuration file, or in src/HTInit.c. See the example mime.types file
2062 # in the samples subdirectory.
2066 GLOBAL_EXTENSION_MAP:/etc/mime.types
2069 #GLOBAL_EXTENSION_MAP:Lynx_Dir:mime.types
2071 # Unix (sought in user's home directory):
2072 PERSONAL_EXTENSION_MAP:.mime.types
2073 # VMS (sought in user's sys$login directory):
2074 #PERSONAL_EXTENSION_MAP:mime.types
2078 # With SUFFIX_ORDER the precedence of suffix mappings can be changed.
2079 # Two kinds of settings are recognized:
2081 # PRECEDENCE_OTHER or PRECEDENCE_HERE
2082 # Suffix mappings can come from four sources: (1) SUFFIX rules
2083 # given here - see below, (2) builtin defaults (HTInit.c), and the
2084 # (3) GLOBAL_EXTENSION_MAP and (4) PERSONAL_EXTENSION_MAP files.
2085 # The order of precedence is normally as listed: (1) has the
2086 # *lowest*, (4) has the *highest* precedence if there are conflicts.
2087 # In other words, SUFFIX mappings here are overridden by conflicting
2088 # ones elsewhere. This default ordering is called PRECEDENCE_OTHER.
2089 # With PRECEDENCE_HERE, the order becomes (2) (3) (4) (1), i.e.
2090 # mappings here override others made elsewhere.
2093 # This disables all builtin default rules. In other words, (2) in the
2094 # list above is skipped. Some recognition for compressed files (".gz",
2095 # ".Z") is still hardwired. A mapping for some basic types, at least
2096 # for text/html is probably necessary to get a usable configuration,
2097 # it can be given in a SUFFIX rule below or an extension map file.
2098 # Both kinds of settings can be combined, separated by comma as in
2099 # SUFFIX_ORDER:PRECEDENCE_HERE,NO_BUILTIN
2100 # Note: Using PRECEDENCE_HERE has only an effect on SUFFIX rules that follow.
2101 # Moreover, if GLOBAL_EXTENSION_MAP or PERSONAL_EXTENSION_MAP directives
2102 # are used, they should come *before* a SUFFIX_ORDER:PRECEDENCE_HERE.
2104 #SUFFIX_ORDER:PRECEDENCE_OTHER
2108 # The SUFFIX definition takes the form of:
2110 # SUFFIX:<file extension>:<mime type>:<encoding>:<quality>:<description>
2112 # All fields after <mime type> are optional (including the separators
2113 # if no more fields follow).
2115 # <file extension> trailing end of file name. This need not strictly
2116 # be a file extension as understood by the OS, a dot
2117 # has to be given explicitly if it is indented, for
2118 # some uses one could even match full filenames here.
2119 # In addition, two forms are special: "*.*" and "*"
2120 # refer to the defaults for otherwise unmatched files
2121 # (the first for filenames with a dot somewhere in
2122 # the name, the second without), these are currently
2123 # mapped to text/plain in the (HTInit.c) builtin code.
2125 # <mime type> a MIME content type. It can also contain a charset
2126 # parameter, see example below. This should be given in
2127 # all lowercase, use <description> for more fancy labels.
2128 # It can be left empty if an HTTP style encoding is given.
2130 # Fields in addition to the usual ones are
2132 # <encoding> either a mail style trivial encoding (7bit, 8bit, binary)
2133 # which could be used on some systems to determine how to
2134 # open local files (currently it isn't), and is used to
2135 # determine transfer mode for some FTP URLs; or a HTTP style
2136 # content encoding (gzip (equivalent to x-gzip), compress)
2138 # <quality> a floating point quality factor, usually between 0.0 and 1.0
2139 # currently unused in most situations.
2141 # <description> text that can appear in FTP directory listings, and in
2142 # local directory listings (see LIST_FORMAT, code %t)
2144 # For instance the following definition maps the
2145 # extension ".gif" to the mime type "image/gif"
2147 # SUFFIX:.gif:image/gif
2149 # The following can be used if you have a convention to label
2150 # HTML files in some character set that differs from your local
2151 # default (see also ASSUME_LOCAL_CHARSET) with a different
2152 # extension, here ".html-u8". It also demonstrates use of the
2153 # description field, note extra separators for omitted fields:
2155 # SUFFIX:.html-u8:text/html;charset=utf-8:::UTF-8 HTML
2157 # The following shows how a suffix can indicate a combination
2158 # of MIME type and compression method. (The ending ".ps.gz" should
2159 # already be recognized by default; the form below could be used on
2160 # systems that don't allow more than one dot in filenames.)
2162 # SUFFIX:.ps_gz:application/postscript:gzip::gzip'd Postscript
2164 # The following is meant to match a full filename (but can match
2165 # any file ending in "core", so be careful):
2167 # SUFFIX:core:application/x-core-file
2169 # file suffixes are case INsensitive!
2171 # The suffix definitions listed here in the default lynx.cfg file are
2172 # similar to those normally established via src/HTInit.c. You can change
2173 # the defaults by editing that file or disable them, or via the global or
2174 # personal mime.types files at run time (except for the additional fields).
2175 # Assignments made here are overridden by entries in those files
2176 # unless preceded with a SUFFIX_ORDER:PRECEDENCE_HERE.
2179 #SUFFIX:.ps:application/postscript
2180 #SUFFIX:.eps:application/postscript
2181 #SUFFIX:.ai:application/postscript
2182 #SUFFIX:.rtf:application/rtf
2183 #SUFFIX:.snd:audio/basic
2184 #SUFFIX:.gif:image/gif
2185 #SUFFIX:.rgb:image/x-rgb
2186 #SUFFIX:.png:image/png
2187 #SUFFIX:.xbm:image/x-xbitmap
2188 #SUFFIX:.tiff:image/tiff
2189 #SUFFIX:.jpg:image/jpeg
2190 #SUFFIX:.jpeg:image/jpeg
2191 #SUFFIX:.mpg:video/mpeg
2192 #SUFFIX:.mpeg:video/mpeg
2193 #SUFFIX:.mov:video/quicktime
2194 #SUFFIX:.hqx:application/mac-binhex40
2195 #SUFFIX:.bin:application/octet-stream
2196 #SUFFIX:.exe:application/octet-stream
2197 #SUFFIX:.tar:application/x-tar
2198 #SUFFIX:.tgz:application/x-tar:gzip
2199 #SUFFIX:.Z::compress
2201 #SUFFIX:.bz2:application/x-bzip2
2202 #SUFFIX:.zip:application/zip
2203 #SUFFIX:.lzh:application/x-lzh
2204 #SUFFIX:.lha:application/x-lha
2205 #SUFFIX:.dms:application/x-dms
2206 #SUFFIX:.html:text/html
2207 #SUFFIX:.txt:text/plain
2210 .h2 XLOADIMAGE_COMMAND
2213 # XLOADIMAGE_COMMAND will be used as a default in src/HTInit.c
2214 # for viewing image content types when the DECW$DISPLAY logical
2215 # is set. Make it the foreign command for your system's X image
2216 # viewer (commonly, "xv"). It can be anything that will handle GIF,
2217 # TIFF and other popular image formats. Freeware ports of xv for
2218 # VMS are available in the ftp://ftp.wku.edu/vms/unsupported and
2219 # http://www.openvms.digital.com/cd/XV310A/ subdirectories. You
2220 # must also have a "%s" for the filename. The default is defined
2221 # in userdefs.h and can be overridden here, or via the global or
2222 # personal mailcap files (see below).
2224 # Make this empty (but not commented out) if you don't have such a viewer or
2225 # want to disable the built-in default viewer mappings for image types.
2227 #XLOADIMAGE_COMMAND:xv %s
2231 # XLOADIMAGE_COMMAND will be used as a default in src/HTInit.c for
2232 # viewing image content types when the DISPLAY environment variable
2233 # is set. Make it the full path and name of the xli (also know as
2234 # xloadimage or xview) command, or other image viewer. It can be
2235 # anything that will handle GIF, TIFF and other popular image formats
2236 # (xli does). The freeware distribution of xli is available in the
2237 # ftp://ftp.x.org/contrib subdirectory. The shareware, xv, also is
2238 # suitable. You must also have a "%s" for the filename; "&" for
2239 # background is optional. The default is defined in userdefs.h and can be
2240 # overridden here, or via the global or personal mailcap files (see below).
2241 # Make this empty (but not commented out) if you don't have such a
2242 # viewer or don't want to disable the built-in default viewer
2243 # mappings for image types.
2244 # Note that open is used as the default for NeXT, instead of the
2245 # XLOADIMAGE_COMMAND definition.
2246 # If you use xli, you may want to add the -quiet flag.
2251 # MIME types may be assigned to external viewers using
2252 # the VIEWER definition.
2254 # NOTE: if you do not define a viewer to a new MIME type
2255 # that you assigned above then it will be saved to
2257 # It is normally preferable to define new viewers in
2258 # MAILCAP files (see below) instead of here: Definitions
2259 # here are overridden by those in MAILCAP files and even
2260 # by some built-in defaults in src/HTInit.c.
2262 # The VIEWER definition takes the form of:
2263 # VIEWER:<mime type>:<viewer command>[:environment]
2264 # where -mime type is the MIME content type of the file
2265 # -viewer command is a system command that can be
2266 # used to display the file where %s is replaced
2267 # within the command with the physical filename
2268 # (e.g., "ghostview %s" becomes "ghostview /tmp/temppsfile")
2269 # -environment is optional. The only valid keywords
2270 # are currently XWINDOWS and NON_XWINDOWS. If the XWINDOWS
2271 # environment is specified then the viewer will only be
2272 # defined when the user has the environment variable DISPLAY
2273 # (DECW$DISPLAY on VMS) defined. If the NON_XWINDOWS environment
2274 # is specified the specified viewer will only be defined when the
2275 # user DOES NOT have the environment variable DISPLAY defined.
2277 # VIEWER:image/gif:xli %s:XWINDOWS
2278 # VIEWER:image/gif:ascii-view %s:NON_XWINDOWS
2279 # VIEWER:application/start-elm:elm
2281 # You must put the whole definition on one line.
2283 # If you must use a colon in the viewer command, precede it with a backslash!
2285 # The MIME_type:viewer:XWINDOWS definitions listed here in the lynx.cfg
2286 # file are among those established via src/HTInit.c. For the image types,
2287 # HTInit.c uses the XLOADIMAGE_COMMAND definition in userdefs.h or above
2288 # (open is used for NeXT). You can change any of these defaults via the
2289 # global or personal mailcap files. Assignments made here will be overridden
2290 # by entries in those files.
2293 #VIEWER:application/postscript:ghostview %s&:XWINDOWS
2294 #VIEWER:image/gif:xli %s&:XWINDOWS
2295 #VIEWER:image/x-xbm:xli %s&:XWINDOWS
2296 #VIEWER:image/png:xli %s&:XWINDOWS
2297 #VIEWER:image/tiff:xli %s&:XWINDOWS
2298 #VIEWER:image/jpeg:xli %s&:XWINDOWS
2299 #VIEWER:video/mpeg:mpeg_play %s &:XWINDOWS
2303 .h2 PERSONAL_MAILCAP
2304 # The global and personal MAILCAP files allow you to specify external
2305 # viewers to be spawned when Lynx encounters different MIME types, which
2306 # will override any of the suffix maps in this (lynx.cfg) configuration
2307 # file, or in src/HTInit.c. See http://www.internic.net/rfc/rfc1524.txt
2308 # and the example mailcap file in the samples subdirectory.
2312 GLOBAL_MAILCAP:/etc/mailcap
2315 #GLOBAL_MAILCAP:Lynx_Dir:mailcap
2317 # Sought in user's home (Unix) or sys$login (VMS) directory.
2318 #PERSONAL_MAILCAP:.mailcap
2324 # If your terminal (or terminal emulator, or operating system) does not
2325 # support 8-bit input (at all or in easy way), you can use Lynx to
2326 # generate 8-bit characters from 7-bit ones output by terminal.
2328 # Currently available keyboard layouts:
2329 # ROT13'd keyboard layout
2330 # JCUKEN Cyrillic, for AT 101-key kbd
2331 # YAWERTY Cyrillic, for DEC LK201 kbd
2333 # This feature is ifdef'd with EXP_KEYBOARD_LAYOUT.
2334 #KEYBOARD_LAYOUT:JCUKEN Cyrillic, for AT 101-key kbd
2338 # Key remapping definitions!
2340 # You may redefine the keymapping of any function in Lynx by
2341 # using the KEYMAP option. The basic form of KEYMAP is:
2342 # KEYMAP:<KEYSTROKE>:<LYNX FUNCTION>
2343 # (See below for an extended format.)
2345 # You must map upper and lowercase keys separately.
2347 # A representative list of functions mapped to their default keys is
2348 # provided below. All of the mappings are commented out by default
2349 # since they just repeat the default mappings, except for TOGGLE_HELP
2350 # (see below). See LYKeymap.c for the complete key mapping. Use the
2351 # 'K'eymap command when running Lynx for a list of the _current_ keymappings.
2353 # (However, in contrast to the output of 'K' command,
2354 # 'H'elp (lynx_help/*.html and lynx_help/keystrokes/*.html files) shows
2355 # the default mapping unless you change that files manually,
2356 # so you are responsible for possible deviations
2357 # when you are changing any KEYMAP below).
2360 # Keystrokes for special keys are represented by the following codes:
2363 # Right Arrow: 0x102
2367 # Keypad Home: 0x106 (see also 0x10A)
2368 # Keypad End: 0x107 (see also 0x10B)
2369 # Function key 1: 0x108
2370 # vt100 Help Key: 0x108
2371 # vt100 Do Key: 0x109
2372 # vt100 Find Key: 0x10A (The key with label "Home" may be treated as Find)
2373 # vt100 Select Key: 0x10B (The key with label "End" may be treated as Select)
2375 # Remove (Del) Key: 0x10D
2376 # ignored key 0x10E (reserved for internal use, DO_NOTHING)
2377 # Back (Shift) Tab: 0x10F
2378 # reserved code 0x11D (reserved for internal use with -use_mouse)
2379 # reserved code 0x290 (reserved for internal use with -use_mouse)
2382 # Other codes not listed above may be available for additional keys,
2383 # depending on operating system and libraries used to compile Lynx.
2384 # On some systems, if compiled with recent versions of slang or ncurses
2385 # (if macro USE_KEYMAPS was in effect during compilation), an additional
2386 # level of key mapping is supported via an external ".lynx-keymaps" file.
2387 # This file, if found in the home directory at startup, will always be
2388 # used under those conditions; see lynx-keymaps distributed in the samples
2389 # subdirectory for further explanation. Note that mapping via
2390 # .lynx-keymaps, if applicable, is a step that logically comes before the
2391 # mappings done here: KEYMAP maps the result of that step (which still
2392 # represents a key) to a function (which represents an action that Lynx
2396 #KEYMAP:0x5C:SOURCE # Toggle source viewing mode (show HTML source)
2397 #KEYMAP:^R:RELOAD # Reload the current document and redisplay
2398 #KEYMAP:q:QUIT # Ask the user to quit
2399 #KEYMAP:Q:ABORT # Quit without verification
2400 #KEYMAP:0x20:NEXT_PAGE # Move down to next page
2401 #KEYMAP:-:PREV_PAGE # Move up to previous page
2402 #KEYMAP:^P:UP_TWO # Move display up two lines
2403 #KEYMAP:0x10C:UP_TWO # Function key Insert - Move display up two lines
2404 #KEYMAP:^N:DOWN_TWO # Move display down two lines
2405 #KEYMAP:0x10D:DOWN_TWO # Function key Remove - Move display down two lines
2406 #KEYMAP:(:UP_HALF # Move display up half a page
2407 #KEYMAP:):DOWN_HALF # Move display down half a page
2408 #KEYMAP:^W:REFRESH # Refresh the screen
2409 #KEYMAP:^A:HOME # Go to top of current document
2410 #KEYMAP:0x106:HOME # Keypad Home - Go to top of current document
2411 #KEYMAP:0x10A:HOME # Function key Find - Go to top of current document
2412 #KEYMAP:^E:END # Go to bottom of current document
2413 #KEYMAP:0x107:END # Keypad End - Go to bottom of current document
2414 #KEYMAP:0x10B:END # Function key Select - Go to bottom of current document
2415 #KEYMAP:0x100:PREV_LINK # Move to the previous link or page
2416 #KEYMAP:0x101:NEXT_LINK # Move to the next link or page
2417 #KEYMAP:0x10F:FASTBACKW_LINK # Back Tab - Move to previous link or text area
2418 #KEYMAP:^I:FASTFORW_LINK # Tab key - Move always to next link or text area
2419 #KEYMAP:^:FIRST_LINK # Move to the first link on line
2420 #KEYMAP:$:LAST_LINK # Move to the last link on line
2421 #KEYMAP:<:UP_LINK # Move to the link above
2422 #KEYMAP:>:DOWN_LINK # Move to the link below
2423 #KEYMAP:0x7F:HISTORY # Show the history list
2424 #KEYMAP:0x08:HISTORY # Show the history list
2425 #KEYMAP:0x103:PREV_DOC # Return to the previous document in history stack
2426 #KEYMAP:0x102:ACTIVATE # Select the current link
2427 #KEYMAP:0x109:ACTIVATE # Function key Do - Select the current link
2428 #KEYMAP:g:GOTO # Goto a random URL
2429 #KEYMAP:G:ECGOTO # Edit the current document's URL and go to it
2430 #KEYMAP:H:HELP # Show default help screen
2431 #KEYMAP:0x108:DWIMHELP # Function key Help - Show a help screen
2432 #KEYMAP:i:INDEX # Show default index
2433 #*** Edit FORM_LINK_* messages in LYMessages_en.h if you change NOCACHE ***
2434 #KEYMAP:x:NOCACHE # Force submission of form or link with no-cache
2435 #*** Do not change INTERRUPT from 'z' & 'Z' ***
2436 #KEYMAP:z:INTERRUPT # Interrupt network transmission
2437 #KEYMAP:m:MAIN_MENU # Return to the main menu
2438 #KEYMAP:o:OPTIONS # Show the options menu
2439 #KEYMAP:i:INDEX_SEARCH # Search a server based index
2440 #KEYMAP:/:WHEREIS # Find a string within the current document
2441 #KEYMAP:n:NEXT # Find next occurrence of string within document
2442 #KEYMAP:c:COMMENT # Comment to the author of the current document
2443 #KEYMAP:C:CHDIR # Change current directory
2444 #KEYMAP:e:EDIT # Edit current document or form's textarea (call: ^Ve)
2445 #KEYMAP:E:ELGOTO # Edit the current link's URL or ACTION and go to it
2446 #KEYMAP:=:INFO # Show info about current document
2447 #KEYMAP:p:PRINT # Show print options
2448 #KEYMAP:a:ADD_BOOKMARK # Add current document to bookmark list
2449 #KEYMAP:v:VIEW_BOOKMARK # View the bookmark list
2450 #KEYMAP:V:VLINKS # List links visited during the current Lynx session
2451 #KEYMAP:!:SHELL # Spawn default shell
2452 #KEYMAP:d:DOWNLOAD # Download current link
2453 #KEYMAP:j:JUMP # Jump to a predefined target
2454 #KEYMAP:k:KEYMAP # Display the current key map
2455 #KEYMAP:l:LIST # List the references (links) in the current document
2456 #KEYMAP:#:TOOLBAR # Go to the Toolbar or Banner in the current document
2457 #KEYMAP:^T:TRACE_TOGGLE # Toggle detailed tracing for debugging
2458 #KEYMAP:;:TRACE_LOG # View trace log if available for the current session
2459 #KEYMAP:*:IMAGE_TOGGLE # Toggle inclusion of links for all images
2460 #KEYMAP:[:INLINE_TOGGLE # Toggle pseudo-ALTs for inlines with no ALT string
2461 #KEYMAP:]:HEAD # Send a HEAD request for current document or link
2462 #*** Must be compiled with USE_EXTERNALS to enable EXTERN_LINK, EXTERN_PAGE ***
2463 #KEYMAP:,:EXTERN_PAGE # Run external program with current page
2464 #KEYMAP:.:EXTERN_LINK # Run external program with current link
2465 #*** Escaping from text input fields with ^V is independent from this: ***
2466 #KEYMAP:^V:SWITCH_DTD # Toggle between SortaSGML and TagSoup HTML parsing
2467 #KEYMAP:0x00:DO_NOTHING # Does nothing (ignore this key)
2468 #KEYMAP:0x10E:DO_NOTHING # Does nothing (ignore this key)
2469 #KEYMAP:{:SHIFT_LEFT # shift the screen left
2470 #KEYMAP:}:SHIFT_RIGHT # shift the screen right
2471 #KEYMAP:|:LINEWRAP_TOGGLE # toggle linewrap on/off, for shift-commands
2472 #KEYMAP:~:NESTED_TABLES # toggle nested-tables parsing on/off
2475 # In addition to the bindings available by default, the following functions
2476 # are not directly mapped to any keys by default, although some of them may
2477 # be mapped in specific line-editor bindings (effective while in text input
2481 #KEYMAP:???:RIGHT_LINK # Move to the link to the right
2482 #KEYMAP:???:LEFT_LINK # Move to the link to the left
2483 #KEYMAP:???:LPOS_PREV_LINK # Like PREV_LINK, last column pos if form input
2484 #KEYMAP:???:LPOS_NEXT_LINK # Like NEXT_LINK, last column pos if form input
2485 #*** Only useful in form text fields , need PASS or prefixing with ^V: ***
2486 #KEYMAP:???:DWIMHELP # Display help page that may depend on context
2487 #KEYMAP:???:DWIMEDIT # Use external editor for context-dependent purpose
2488 #*** Only useful in a form textarea, need PASS or prefixing with ^V: ***
2489 #KEYMAP:???:EDITTEXTAREA # use external editor to edit a form textarea
2490 #KEYMAP:???:GROWTEXTAREA # Add some blank lines to bottom of textarea
2491 #KEYMAP:???:INSERTFILE # Insert file into a textarea (just above cursor)
2492 #*** Only useful with dired support and OK_INSTALL: ***
2493 #KEYMAP:???:INSTALL # install (i.e. copy) local files to new location
2496 # If TOGGLE_HELP is mapped, in novice mode the second help menu line
2497 # can be toggled among NOVICE_LINE_TWO_A, _B, and _C, as defined in
2498 # LYMessages_en.h Otherwise, it will be NOVICE_LINE_TWO.
2500 #KEYMAP:O:TOGGLE_HELP # Show other commands in the novice help menu
2502 # KEYMAP lines can have one or two additional fields. The extended format is
2503 # KEYMAP:<KEYSTROKE>:[<MAIN LYNX FUNCTION>]:<OTHER BINDING>[:<SELECT>]
2505 # If the additional field OTHER BINDING specifies DIRED, then the function is
2506 # mapped in the override table used only in DIRED mode. This is only valid
2507 # if lynx was compiled with dired support and OK_OVERRIDE defined. A
2508 # MAIN LYNX FUNCTION must be given (it should of course be one that makes
2509 # sense in Dired mode), and SELECT is meaningless. Default built-in override
2512 #KEYMAP:^U:PREV_DOC:DIRED # Return to the previous document
2513 #KEYMAP:.:TAG_LINK:DIRED # Tag a file or directory for later action
2514 #KEYMAP:c:CREATE:DIRED # Create a new file or directory
2515 #KEYMAP:C:CHDIR:DIRED # change current directory
2516 #KEYMAP:f:DIRED_MENU:DIRED # Display a menu of file operations
2517 #KEYMAP:m:MODIFY:DIRED # Modify name or location of a file or directory
2518 #KEYMAP:r:REMOVE:DIRED # Remove files or directories
2519 #KEYMAP:t:TAG_LINK:DIRED # Tag a file or directory for later action
2520 #KEYMAP:u:UPLOAD:DIRED # Show menu of "Upload Options"
2522 # If the OTHER BINDING field does not specify DIRED, then it is taken as a
2523 # line-editor action. It is possible to keep the MAIN LYNX FUNCTION field
2524 # empty in that case, for changing only the line-editing behavior.
2525 # If alternative line edit styles are compiled in, and modifying a key's
2526 # line-editor binding on a per style basis is possible, then SELECT can be
2527 # used to specify which styles are affected. By default, or if SELECT is
2528 # 0, all line edit styles are affected. If SELECT is a positive integer
2529 # number, only the binding for the numbered style is changed (numbering
2530 # is in the order in which styles are shown in the Options Menu, starting
2531 # with 1 for the Default style). If SELECT is negative (-n), all styles
2532 # except n are affected.
2536 # ABORT # Input cancelled
2538 # BOL # Go to begin of line
2539 # EOL # Go to end of line
2540 # FORW # Cursor forwards
2541 # FORW_RL # Cursor forwards or right link
2542 # BACK # Cursor backwards
2543 # FORWW # Word forward
2545 # BACK_LL # Cursor backwards or left link
2547 # DELN # Delete next/curr char
2548 # DELP # Delete prev char
2549 # DELNW # Delete next word
2550 # DELPW # Delete prev word
2551 # DELBL # Delete back to BOL
2552 # DELEL # Delete thru EOL
2553 # ERASE # Erase the line
2554 # LOWER # Lower case the line
2555 # UPPER # Upper case the line
2557 # LKCMD # In fields: Invoke key command prompt (default for ^V)
2558 # PASS # In fields: handle as non-lineedit key; in prompts: ignore
2561 # Modify following key (prefixing only works within line-editing, edit actions
2562 # of some resulting prefixed keys are built-in, see Line Editor help pages)
2563 # SETM1 # Set modifier 1 flag (default for ^X - key prefix)
2564 # SETM2 # Set modifier 2 flag (another key prefix - same effect)
2566 # May not always be compiled in:
2569 # TPOS # Transpose characters
2570 # SETMARK # emacs-like set-mark-command
2571 # XPMARK # emacs-like exchange-point-and-mark
2572 # KILLREG # emacs-like kill-region
2573 # YANK # emacs-like yank
2574 # SWMAP # Switch input keymap
2575 # PASTE # ClipBoard to Lynx - Windows Extension
2578 # May work differently from expected if not bound to their expected keys:
2581 # CHAR # Insert printable char (default for all ASCII printable)
2582 # ENTER # Input complete, return char/lynxkeycode (for RETURN/ENTER)
2583 # TAB # Input complete, return TAB (for ASCII TAB char ^I)
2586 # Internal use, probably not useful for binding, listed for completeness:
2589 # UNMOD # Fall back to no-modifier command
2591 # C1CHAR # Insert C1 char if printable
2594 # If OTHER BINDING specifies PASS, then if the key is pressed in a text input
2595 # field it is passed by the built-in line-editor to normal KEYMAP handling,
2596 # i.e. this flag acts like an implied ^V escape (always overrides line-editor
2597 # behavior of the key). For example,
2598 #KEYMAP:0x10C:UP_TWO:PASS # Function key Insert - Move display up two lines
2600 # Other examples (repeating built-in bindings)
2601 #KEYMAP:^V::LKCMD # set (only) line-edit action for ^V
2602 #KEYMAP:^V:SWITCH_DTD:LKCMD # set main lynxaction and line-edit action for ^V
2603 #KEYMAP:^U::ERASE:1 # set line-edit binding for ^U, for default style
2604 #KEYMAP:^[::SETM2:3 # use escape key as modifier - works only sometimes
2607 .h1 External Programs
2608 # These settings control the ability of Lynx to invoke various programs for
2614 # On VMS, CSwing (an XTree emulation for VTxxx terminals) is intended for
2615 # use as the Directory/File Manager (sources, objects, or executables are
2616 # available from ftp://narnia.memst.edu/). CSWING_PATH should be defined
2617 # here or in userdefs.h to your foreign command for CSwing, with any
2618 # regulatory switches you want included. If not defined, or defined as
2619 # a zero-length string ("") or "none" (case-insensitive), the support
2620 # will be disabled. It will also be disabled if the -nobrowse or
2621 # -selective switches are used, or if the file_url restriction is set.
2623 # When enabled, the DIRED_MENU command (normally 'f' or 'F') will invoke
2624 # CSwing, normally with the current default directory as an argument to
2625 # position the user on that node of the directory tree. However, if the
2626 # current document is a local directory listing, or a local file and not
2627 # one of the temporary menu or list files, the associated directory will
2628 # be passed as an argument, to position the user on that node of the tree.
2633 .h1 Internal Behavior
2635 .h2 AUTO_UNCACHE_DIRLISTS
2636 # AUTO_UNCACHE_DIRLISTS determines when local file directory listings are
2637 # automatically regenerated (by re-reading the actual directory from disk).
2638 # Set the value to 0 to avoid automatic regeneration in most cases. This is
2639 # useful for browsing large directories that take some time to read and format.
2640 # An update can still always be forced with the RELOAD key, and specific DIRED
2641 # actions may cause a refresh anyway. Set the value to 1 to force regeneration
2642 # after commands that usually change the directory or some files and would make
2643 # the displayed info stale, like EDIT and REMOVE. Set it to 2 (the default) or
2644 # greater to force regeneration even after leaving the displayed directory
2645 # listing by some action that usually causes no change, like GOTO or entering a
2646 # file with the ACTIVATE key. This option is only honored in DIRED mode (i.e.
2647 # when lynx is compiled with DIRED_SUPPORT and it is not disabled with a
2648 # -restriction). Local directories displayed without DIRED normally act as if
2649 # AUTO_UNCACHE_DIRLISTS:0 was in effect.
2651 #AUTO_UNCACHE_DIRLISTS:2
2659 # LIST_FORMAT defines the display for local files when Lynx has been
2660 # compiled with LONG_LIST defined in the Makefile. The default is set
2661 # in userdefs.h, normally to "ls -l" format, and can be changed here
2662 # by uncommenting the indicated lines, or adding a definition with a
2663 # modified parameter list.
2665 # The percent items in the list are interpreted as follows:
2668 # %p Unix-style permission bits
2672 # %d date of last modification
2673 # %a anchor pointing to file or directory
2674 # %A as above but don't show symbolic links
2675 # %t type of file (description derived from MIME type)
2676 # %T MIME type as known by Lynx (from mime.types or default)
2677 # %k size of file in Kilobytes
2678 # %K as above but omit size for directories
2679 # %s size of file in bytes
2682 # Anything between the percent and the letter is passed on to sprintf.
2683 # A double percent yields a literal percent on output. Other characters
2684 # are passed through literally.
2686 # If you want only the filename:
2691 # If you want a brief output:
2694 #LIST_FORMAT: %4K %-12.12d %a
2696 # If you want the Unix "ls -l" format:
2699 #LIST_FORMAT: %p %4l %-8.8o %-8.8g %7s %-12.12d %a
2702 .h1 External Programs
2707 # DIRED_MENU items are used to compose the F)ull menu list in DIRED mode
2708 # The behavior of the default configuration given here is much the same
2709 # as it was when this menu was hard-coded but these items can now be adjusted
2710 # to suit local needs. In particular, many of the LYNXDIRED actions can be
2711 # replaced with lynxexec, lynxprog and lynxcgi script references.
2713 # NOTE that defining even one DIRED_MENU line overrides all the built-in
2714 # definitions, so a complete set must then be defined here.
2716 # Each line consists of the following fields:
2719 # DIRED_MENU:type:suffix:link text:extra text:action
2721 # type: TAG: list only when one or more files are tagged
2722 # FILE: list only when the current selection is a regular file
2723 # DIR: list only when the current selection is a directory
2724 # LINK: list only when the current selection is a symbolic link
2726 # suffix: list only if the current selection ends in this pattern
2728 # link text: the displayed text of the link
2730 # extra text: the text displayed following the link
2732 # action: the URL to be followed upon selection
2734 # link text and action are scanned for % sequences that are expanded
2735 # at display time as follows:
2737 # %p path of current selection
2738 # %f filename (last component) of current selection
2739 # %t tagged list (full paths)
2740 # %l list of tagged file names
2741 # %d the current directory
2744 #DIRED_MENU:::New File:(in current directory):LYNXDIRED://NEW_FILE%d
2745 #DIRED_MENU:::New Directory:(in current directory):LYNXDIRED://NEW_FOLDER%d
2747 # Following depends on OK_INSTALL
2748 #DIRED_MENU:FILE::Install:selected file to new location:LYNXDIRED://INSTALL_SRC%p
2749 #DIRED_MENU:DIR::Install:selected directory to new location:LYNXDIRED://INSTALL_SRC%p
2751 #DIRED_MENU:FILE::Modify File Name:(of current selection):LYNXDIRED://MODIFY_NAME%p
2752 #DIRED_MENU:DIR::Modify Directory Name:(of current selection):LYNXDIRED://MODIFY_NAME%p
2753 #DIRED_MENU:LINK::Modify Name:(of selected symbolic link):LYNXDIRED://MODIFY_NAME%p
2755 # Following depends on OK_PERMIT
2756 #DIRED_MENU:FILE::Modify File Permissions:(of current selection):LYNXDIRED://PERMIT_SRC%p
2757 #DIRED_MENU:DIR::Modify Directory Permissions:(of current selection):LYNXDIRED://PERMIT_SRC%p
2759 #DIRED_MENU:FILE::Change Location:(of selected file):LYNXDIRED://MODIFY_LOCATION%p
2760 #DIRED_MENU:DIR::Change Location:(of selected directory):LYNXDIRED://MODIFY_LOCATION%p
2761 #DIRED_MENU:LINK::Change Location:(of selected symbolic link):LYNXDIRED://MODIFY_LOCATION%p
2762 #DIRED_MENU:FILE::Remove File:(current selection):LYNXDIRED://REMOVE_SINGLE%p
2763 #DIRED_MENU:DIR::Remove Directory:(current selection):LYNXDIRED://REMOVE_SINGLE%p
2764 #DIRED_MENU:LINK::Remove Symbolic Link:(current selection):LYNXDIRED://REMOVE_SINGLE%p
2766 # Following depends on OK_UUDECODE and !ARCHIVE_ONLY
2767 #DIRED_MENU:FILE::UUDecode:(current selection):LYNXDIRED://UUDECODE%p
2769 # Following depends on OK_TAR and !ARCHIVE_ONLY
2770 #DIRED_MENU:FILE:.tar.Z:Expand:(current selection):LYNXDIRED://UNTAR_Z%p
2772 # Following depend on OK_TAR and OK_GZIP and !ARCHIVE_ONLY
2773 #DIRED_MENU:FILE:.tar.gz:Expand:(current selection):LYNXDIRED://UNTAR_GZ%p
2774 #DIRED_MENU:FILE:.tgz:Expand:(current selection):LYNXDIRED://UNTAR_GZ%p
2776 # Following depends on !ARCHIVE_ONLY
2777 #DIRED_MENU:FILE:.Z:Uncompress:(current selection):LYNXDIRED://DECOMPRESS%p
2779 # Following depends on OK_GZIP and !ARCHIVE_ONLY
2780 #DIRED_MENU:FILE:.gz:Uncompress:(current selection):LYNXDIRED://UNGZIP%p
2782 # Following depends on OK_ZIP and !ARCHIVE_ONLY
2783 #DIRED_MENU:FILE:.zip:Uncompress:(current selection):LYNXDIRED://UNZIP%p
2785 # Following depends on OK_TAR and !ARCHIVE_ONLY
2786 #DIRED_MENU:FILE:.tar:UnTar:(current selection):LYNXDIRED://UNTAR%p
2788 # Following depends on OK_TAR
2789 #DIRED_MENU:DIR::Tar:(current selection):LYNXDIRED://TAR%p
2791 # Following depends on OK_TAR and OK_GZIP
2792 #DIRED_MENU:DIR::Tar and compress:(using GNU gzip):LYNXDIRED://TAR_GZ%p
2794 # Following depends on OK_ZIP
2795 #DIRED_MENU:DIR::Package and compress:(using zip):LYNXDIRED://ZIP%p
2797 #DIRED_MENU:FILE::Compress:(using Unix compress):LYNXDIRED://COMPRESS%p
2799 # Following depends on OK_GZIP
2800 #DIRED_MENU:FILE::Compress:(using gzip):LYNXDIRED://GZIP%p
2802 # Following depends on OK_ZIP
2803 #DIRED_MENU:FILE::Compress:(using zip):LYNXDIRED://ZIP%p
2805 #DIRED_MENU:TAG::Move all tagged items to another location.::LYNXDIRED://MOVE_TAGGED%d
2807 # Following depends on OK_INSTALL
2808 #DIRED_MENU:TAG::Install tagged files into another directory.::LYNXDIRED://INSTALL_SRC%00
2810 #DIRED_MENU:TAG::Remove all tagged files and directories.::LYNXDIRED://REMOVE_TAGGED
2811 #DIRED_MENU:TAG::Untag all tagged items.::LYNXDIRED://CLEAR_TAGGED
2814 .h1 Internal Behavior
2816 .h2 NONRESTARTING_SIGWINCH
2817 # Some systems only:
2818 #===================
2819 # Lynx tries to detect window size changes with a signal handler for
2820 # SIGWINCH if supported. If NONRESTARTING_SIGWINCH is set to TRUE,
2821 # and the sigaction interface is available on the system, the handler
2822 # is installed as 'non-restarting'. On some systems (depending on the
2823 # library used for handling keyboard input, e.g. ncurses), this allows
2824 # more immediate notification of window size change events. If the value
2825 # is set to FALSE, the signal() interface is used; this normally makes
2826 # the handler 'restarting', with the effect that lynx can react to size
2827 # changes only after some key is pressed. The value can also be set to
2828 # XWINDOWS; this is equivalent to TRUE when the user has the environment
2829 # variable DISPLAY defined *at program start*, and equivalent to FALSE
2830 # otherwise. The non-restarting behavior can also be changed to TRUE
2831 # or FALSE with the -nonrestarting_sigwinch switch, which overrides the
2832 # value in this file.
2834 # Note that Lynx never re-parses document text purely as a result of a
2835 # window size change, so text lines may appear truncated after narrowing
2836 # the window, until the document is reloaded with ^R or a similar key
2837 # or until a different text is loaded.
2839 # The default is FALSE since there is a possibility that non-restarting
2840 # interrupts may be mis-interpreted as fatal input errors in some
2841 # configurations (leading to an abrupt program exit), and since this
2842 # option is useful mostly only for users running Lynx under xterm or a
2843 # similar X terminal emulator. On systems where the preconditions don't
2844 # apply this option is ignored.
2846 #NONRESTARTING_SIGWINCH:FALSE
2849 .h2 NO_FORCED_CORE_DUMP
2852 # If NO_FORCED_CORE_DUMP is set to TRUE, Lynx will not force
2853 # core dumps via abort() calls on fatal errors or assert()
2854 # calls to check potentially fatal errors. The compilation
2855 # default normally is FALSE, and can be changed here. The
2856 # compilation or configuration default can be toggled via
2857 # the -core command line switch.
2858 # Note that this setting cannot be used to prevent core dumps
2859 # with certainty. If this is important, means provided by the
2860 # operating system or kernel should be used.
2862 #NO_FORCED_CORE_DUMP:FALSE
2868 # COLORS (only available if compiled with SVr4 curses or slang)
2870 # The line must be of the form:
2872 # COLOR:Integer:Foreground:Background
2875 # The Integer value is interpreted as follows:
2876 # 0 - normal - normal text
2877 # 1 - bold - hyperlinks, see also BOLD_* options above
2878 # 2 - reverse - statusline
2879 # 3 - bold + reverse (not used)
2880 # 4 - underline - text emphasis (EM, I, B tags etc.)
2881 # 5 - bold + underline - hyperlinks within text emphasis
2882 # 6 - reverse + underline - currently selected hyperlink
2883 # 7 - reverse + underline + bold - WHEREIS search hits
2885 # Each Foreground and Background value must be one of:
2886 # black red green brown
2887 # blue magenta cyan lightgray
2888 # gray brightred brightgreen yellow
2889 # brightblue brightmagenta brightcyan white
2893 # Note that in most cases a white background is really "lightgray", since
2894 # terminals generally do not implement bright backgrounds.
2896 # Uncomment and change any of the compilation defaults.
2898 #COLOR:0:black:white
2900 #COLOR:2:yellow:blue
2901 #COLOR:3:green:white
2902 #COLOR:4:magenta:white
2904 #COLOR:6:brightred:black
2905 #COLOR:7:magenta:cyan
2909 # If built with a library that recognizes default colors (usually ncurses or
2910 # slang), lynx initializes it to assume the corresponding foreground and
2911 # background colors. Default colors are those that the terminal (emulator)
2912 # itself is initialized to. For instance, you might have an xterm running with
2913 # black text on a white background, and want lynx to display colored text on
2914 # the white background, but leave the possibility of using the same
2915 # configuration to draw colored text on a different xterm, this time using its
2916 # background set to black.
2918 # If built with conventional SVr3/SVr4 curses, tells lynx to use color pair 0
2919 # when the given colors match this setting. That gives a similar effect,
2920 # though not as flexible. You will get the best results by setting the
2921 # terminal's default colors to match the prevailing text and background colors
2922 # that you have setup with lynx, and then alter the ASSUMED_COLOR setting to
2923 # match that. If you do not alter the ASSUMED_COLOR setting, curses assumes
2924 # color pair 0's background is black, which implies that its foreground (text)
2927 # The first value given is the foreground, the second is the background.
2928 #ASSUMED_COLOR:default:default
2931 .h1 External Programs
2934 # External application support. This feature allows Lynx to pass a given
2935 # URL to an external program. It was written for three reasons.
2937 # 1) To overcome the deficiency of Lynx_386 not supporting ftp and news.
2938 # External programs can be used instead by passing the URL.
2940 # 2) To allow for background transfers in multitasking systems.
2941 # I use wget for http and ftp transfers via the external command.
2943 # 3) To allow for new URLs to be used through Lynx.
2944 # URLs can be made up such as mymail: to spawn desired applications
2945 # via the external command.
2947 # Restrictions can be imposed using -restrictions=externals at the Lynx command
2948 # line. This will disallow all EXTERNAL lines in lynx.cfg that have FALSE in
2949 # the 3rd field (not counting the name of the setting). TRUE lines will still
2952 # The lynx.cfg line is as follows:
2954 # EXTERNAL:<url>:<command> %s:<norestriction>:<allow_for_activate>
2956 # <url> Any given URL. This can be normal ones like ftp or http or it
2957 # can be one made up like mymail.
2959 # <command> The command to run with %s being the URL that will be passed.
2960 # In Linux I use "wget -q %s &" (no quotes) to spawn a copy of wget for
2961 # downloading http and ftp files in the background. In Win95 I use
2962 # "start ncftp %s" to spawn ncftp in a new window.
2964 # <norestriction> This complements the -restrictions=externals feature to allow
2965 # for certain externals to be enabled while restricting others. TRUE means
2966 # a command will still function while Lynx is restricted. WB
2968 # <allow_for_activate> Setting this to TRUE allows the use of this command not
2969 # only when EXTERN key is pressed, but also when ACTIVATE command is invoked
2970 # (i.e., activating the link with the given prefix will be equivalent to
2971 # pressing EXTERN key on it). If this component of the line is absent, then
2974 # For invoking the command use the EXTERN_LINK or EXTERN_PAGE key. By default
2975 # EXTERN_LINK is mapped to '.', and EXTERN_PAGE to ',' (if the feature is
2976 # enabled), see the KEYMAP section above.
2978 #EXTERNAL:ftp:wget %s &:TRUE
2981 .h1 Internal Behavior
2985 # CERN-style rules, EXPERIMENTAL - URL-specific rules
2987 # A CERN-style rules file can be given with RULESFILE. Use the system's
2988 # native format for filenames, on Unix '~' is also recognized. If a filename
2989 # is given, the file must exist.
2991 # Single CERN-style rules can be specified with RULES.
2993 # Both options can be repeated, rules accumulate in the order
2994 # given, they will be applied in first-to-last order. See cernrules.txt
2995 # in the samples subdirectory for further explanation.
2999 # RULESFILE:/etc/lynx/cernrules
3000 # RULE:Fail gopher:* # reject by scheme
3001 # RULE:Pass finger://*@localhost/ # allow this,
3002 # RULE:Fail finger:* # but not others
3003 # RULE:Redirect http://old.server/* http://new.server/*
3009 # Enable pretty source view
3013 # Pretty source view settings. These settings are in effect when -prettysrc
3015 # The following lexical elements (lexemes) are recognized:
3016 # comment, tag, attribute, attribute value, generalized angle brackets (
3017 # '<' '>' '</' ), entity, hyperlink destination, entire file, bad sequence,
3018 # bad tag, bad attribute, sgml special.
3019 # The following group of option tells which styles will surround each
3020 # lexeme. The syntax of option in this group is:
3021 #PRETTYSRC_SPEC:<LEXEMENAME>:<TAGSPEC>:<TAGSPEC>
3022 # The first <TAGSPEC> specifies what tags will precede lexemes of that class
3023 # in the internal html markup. The second - what will be placed (internally)
3025 # TAGSPEC has the following syntax:
3026 # <TAGSPEC>:= [ (<TAGOPEN> | <TAGCLOSE>) <SPACE>+ ]*
3027 # <TAGOPEN>:= tagname[.classname]
3028 # <TAGCLOSE>:= !tagname
3030 # The following table gives correspondence between lexeme and lexeme name
3032 # Lexeme LEXEMENAME FURTHER EXPLANATION
3033 # =========================================================
3035 # tag TAG recognized tag name only
3037 # attribute value ATTRVAL
3038 # generalized brackets ABRACKET < > </
3040 # hyperlink destination HREF
3041 # entire file ENTIRE
3042 # bad sequence BADSEQ bad entity or invalid construct at text
3044 # bad tag BADTAG Unrecognized construct in generalized
3046 # bad attribute BADATTR The name of the attribute unknown to lynx
3047 # of the tag known to lynx. (i.e.,
3048 # attributes of unknown tags will have
3050 # sgml special SGMLSPECIAL doctype, sgmlelt, sgmlele,
3051 # sgmlattlist, marked section, identifier
3056 # 1) The markup for HTML_ENTIRE will be emitted only once - it will surround
3057 # entire file source.
3059 # 2) The tagnames specified by TAGSPEC should be valid html tag names.
3061 # 3) If the tag/class combination given by TAGOPEN is not assigned a color
3062 # style in lss file (for lynx compiled with lss support), that tag/class
3063 # combination will be emitted anyway during internal html markup. Such
3064 # combinations will be also reported to the trace log.
3066 # 4) Lexeme 'tag' means tag name only
3068 # 5) Angle brackets of html specials won't be surrounded by markup for ABRACKET
3071 # PRETTYSRC_SPEC:COMM:B I:!I !B
3072 # HTML comments will be surrounded by <b><i> and </i></b> in the
3073 # internal html markup
3075 # PRETTYSRC_SPEC:ATTRVAL: span.attrval : !span
3076 # Values of the attributes will be surrounded by the
3077 # <SPAN class=attrval> </SPAN>
3079 # PRETTYSRC_SPEC:HREF::
3080 # No special html markup will surround hyperlink destinations (
3081 # this means that only default color style for hrefs will be applied
3084 # For lynx compiled with lss support, the following settings are the default:
3085 #PRETTYSRC_SPEC:COMM:span.htmlsrc_comment:!span
3086 #PRETTYSRC_SPEC:TAG:span.htmlsrc_tag:!span
3087 #PRETTYSRC_SPEC:ATTRIB:span.htmlsrc_attrib:!span
3088 #PRETTYSRC_SPEC:ATTRVAL:span.htmlsrc_attrval:!span
3089 #PRETTYSRC_SPEC:ABRACKET:span.htmlsrc_abracket:!span
3090 #PRETTYSRC_SPEC:ENTITY:span.htmlsrc_entity:!span
3091 #PRETTYSRC_SPEC:HREF:span.htmlsrc_href:!span
3092 #PRETTYSRC_SPEC:ENTIRE:span.htmlsrc_entire:!span
3093 #PRETTYSRC_SPEC:BADSEQ:span.htmlsrc_badseq:!span
3094 #PRETTYSRC_SPEC:BADTAG:span.htmlsrc_badtag:!span
3095 #PRETTYSRC_SPEC:BADATTR:span.htmlsrc_badattr:!span
3096 #PRETTYSRC_SPEC:SGMLSPECIAL:span.htmlsrc_sgmlspecial:!span
3097 # the styles corresponding to them are present in sample .lss file.
3098 # For lynx compiled without lss support, the following settings are the default:
3099 #PRETTYSRC_SPEC:COMM:b:!b
3100 #PRETTYSRC_SPEC:TAG:b:!b
3101 #PRETTYSRC_SPEC:ATTRIB:b:!b
3102 #PRETTYSRC_SPEC:ATTRVAL::
3103 #PRETTYSRC_SPEC:ABRACKET:b:!b
3104 #PRETTYSRC_SPEC:ENTITY:b:!b
3105 #PRETTYSRC_SPEC:HREF::
3106 #PRETTYSRC_SPEC:ENTIRE::
3107 #PRETTYSRC_SPEC:BADSEQ:b:!b
3108 #PRETTYSRC_SPEC:BADTAG::
3109 #PRETTYSRC_SPEC:BADATTR::
3110 #PRETTYSRC_SPEC:SGMLSPECIAL:b:!b
3113 .h2 HTMLSRC_ATTRNAME_XFORM
3114 .h2 HTMLSRC_TAGNAME_XFORM
3115 # Options HTMLSRC_TAGNAME_XFORM and HTMLSRC_ATTRNAME_XFORM control the way the
3116 # names of tags and names of attributes are transformed correspondingly.
3117 # Possible values: 0 - lowercase, 1 - leave as is, 2 - uppercase.
3118 #HTMLSRC_TAGNAME_XFORM:2
3119 #HTMLSRC_ATTRNAME_XFORM:2
3122 .h2 PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING
3123 # PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING - pretty source view setting
3124 # If "keypad mode" in 'O'ptions screen is "Links are numbered" or
3125 # "Links and form fields are numbered", and PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING is
3126 # TRUE, then links won't be numbered in psrc view and will be numbered
3127 # otherwise. Set this setting to TRUE if you prefer numbered links, but wish
3128 # to get valid HTML source when printing or mailing when in psrc view.
3130 #PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING:FALSE
3135 .h2 FORCE_EMPTY_HREFLESS_A
3136 # FORCE_EMPTY_HREFLESS_A - HTML parsing
3137 # This option mirrors command-line option with the same name. Default is
3138 # FALSE. If true, then any 'A' element without HREF will be closed
3139 # immediately. This is useful when viewing documentation produced by broken
3140 # translator that doesn't emit balanced A elements. If lynx was compiled with
3141 # color styles, setting this option to TRUE will make lynx screen much more
3142 # reasonable (otherwise all text will probably have color corresponding to the
3145 #FORCE_EMPTY_HREFLESS_A:FALSE
3147 .h2 HIDDEN_LINK_MARKER
3148 # HIDDEN_LINK_MARKER - HTML parsing
3149 # This option defines the string that will be used as title of hidden link (a
3150 # link that otherwise will have no label associated with it). Using an empty
3151 # string as the value will cause lynx to behave in the old way - hidden links
3152 # will be handled according to other settings (mostly the parameter of
3153 # --hiddenlinks command-line switch). If the value is non-empty string, hidden
3154 # link becomes non-hidden so it won't be handled as hidden link, e.g., listed
3155 # among hidden links on 'l'isting page.
3157 #HIDDEN_LINK_MARKER:
3162 # JUSTIFY - Appearance
3163 # This option mirrors command-line option with same name. Default is TRUE. If
3164 # true, most of text (except headers and like this) will be justified. This
3165 # has no influence on CJK text rendering.
3167 # This option is only available if Lynx was compiled with EXP_JUSTIFY_ELTS.
3171 .h2 JUSTIFY_MAX_VOID_PERCENT
3172 # JUSTIFY_MAX_VOID_PERCENT - Appearance
3173 # This option controls the maximum allowed value for ratio (in percents) of
3174 # 'the number of spaces to spread across the line to justify it' to
3175 # 'max line size for current style and nesting' when justification is allowed.
3176 # When that ratio exceeds the value specified, that particular line won't be
3177 # justified. I.e. the value 28 for this setting will mean maximum value for
3178 # that ratio is 0.28.
3180 #JUSTIFY_MAX_VOID_PERCENT:35
3185 .h2 TEXTFIELDS_NEED_ACTIVATION
3186 # If TEXTFIELDS_NEED_ACTIVATION is set to TRUE, and lynx was compiled with
3187 # TEXTFIELDS_MAY_NEED_ACTIVATION defined, then text input form fields need
3188 # to be activated (by pressing the Enter key or similar) before the user
3189 # can enter or modify input. By default, input fields become automatically
3190 # activated when selected. Requiring explicit activation can be desired for
3191 # users who use alphanumeric keys for navigation (or other keys that have
3192 # special meaning in the line editor - ' ', 'b', INS, DEL, etc), and don't
3193 # want to 'get stuck' in form fields. Instead of setting the option here,
3194 # explicit activation can also be requested with the -tna command line
3197 #TEXTFIELDS_NEED_ACTIVATION:FALSE
3199 .h2 LEFTARROW_IN_TEXTFIELD_PROMPT
3200 # LEFTARROW_IN_TEXTFIELD_PROMPT
3201 # This option controls what happens when a Left Arrow key is pressed while
3202 # in the first position of an active text input field. By default, Lynx
3203 # asks for confirmation ("Do you want to go back to the previous document?")
3204 # only if the contents of the fields have been changed since entering it.
3205 # If set to TRUE, the confirmation prompt is always issued.
3207 #LEFTARROW_IN_TEXTFIELD_PROMPT:FALSE
3213 # Specifies (in seconds) connect timeout. Default value is rather huge.
3214 #CONNECT_TIMEOUT:18000
3217 .h1 Internal Behavior
3218 # These settings control internal lynx behavior - the way it interacts with the
3219 # operating system and Internet. Modifying these settings will not change
3220 # the rendition of documents that you browse with lynx, but can change various
3221 # delays and resource utilization.
3224 # Set FTP_PASSIVE to TRUE if you want to use passive mode ftp transfers.
3225 # You might have to do this if you're behind a restrictive firewall.
3229 # The forms-based O'ptions menu shows a (!) marker beside items which are not
3230 # saved to ~/.lynxrc -- the reason for disabling some of these items is that
3231 # they are likely to cause confusion if they are read from the .lynxrc file for
3232 # each session. However, they can be enabled or disabled using the
3233 # ENABLE_LYNXRC settings. The default (compiled-in) settings are shown below.
3234 # The second column is the name by which a setting is saved to .lynxrc (which
3235 # is chosen where possible to correspond with lynx.cfg). Use "OFF" to disable
3236 # writing a setting, "ON" to enable it. Settings are read from .lynxrc after
3237 # the corresponding data from lynx.cfg, so they override lynx.cfg, which is
3238 # probably what users expect.
3240 # Note that a few settings (Cookies and Show images) are comprised of more than
3241 # one lynx.cfg setting.
3243 #ENABLE_LYNXRC:accept_all_cookies:ON
3244 #ENABLE_LYNXRC:assume_charset:OFF
3245 #ENABLE_LYNXRC:bookmark_file:ON
3246 #ENABLE_LYNXRC:case_sensitive_searching:ON
3247 #ENABLE_LYNXRC:character_set:ON
3248 #ENABLE_LYNXRC:cookie_accept_domains:ON
3249 #ENABLE_LYNXRC:cookie_file:ON
3250 #ENABLE_LYNXRC:cookie_loose_invalid_domains:ON
3251 #ENABLE_LYNXRC:cookie_query_invalid_domains:ON
3252 #ENABLE_LYNXRC:cookie_reject_domains:ON
3253 #ENABLE_LYNXRC:cookie_strict_invalid_domains:ON
3254 #ENABLE_LYNXRC:dir_list_style:ON
3255 #ENABLE_LYNXRC:display:OFF
3256 #ENABLE_LYNXRC:emacs_keys:ON
3257 #ENABLE_LYNXRC:file_editor:ON
3258 #ENABLE_LYNXRC:file_sorting_method:ON
3259 #ENABLE_LYNXRC:force_cookie_prompt:OFF
3260 #ENABLE_LYNXRC:force_ssl_prompt:OFF
3261 #ENABLE_LYNXRC:kblayout:ON
3262 #ENABLE_LYNXRC:keypad_mode:ON
3263 #ENABLE_LYNXRC:lineedit_mode:ON
3264 #ENABLE_LYNXRC:locale_charset:ON
3265 #ENABLE_LYNXRC:make_links_for_all_images:OFF
3266 #ENABLE_LYNXRC:make_pseudo_alts_for_inlines:OFF
3267 #ENABLE_LYNXRC:multi_bookmark:ON
3268 #ENABLE_LYNXRC:personal_mail_address:ON
3269 #ENABLE_LYNXRC:preferred_charset:ON
3270 #ENABLE_LYNXRC:preferred_language:ON
3271 #ENABLE_LYNXRC:raw_mode:OFF
3272 #ENABLE_LYNXRC:run_all_execution_links:ON
3273 #ENABLE_LYNXRC:run_execution_links_on_local_files:ON
3274 #ENABLE_LYNXRC:scrollbar:OFF
3275 #ENABLE_LYNXRC:select_popups:ON
3276 #ENABLE_LYNXRC:set_cookies:OFF
3277 #ENABLE_LYNXRC:show_color:ON
3278 #ENABLE_LYNXRC:show_cursor:ON
3279 #ENABLE_LYNXRC:show_dotfiles:ON
3280 #ENABLE_LYNXRC:show_kb_rate:OFF
3281 #ENABLE_LYNXRC:sub_bookmarks:ON
3282 #ENABLE_LYNXRC:tagsoup:OFF
3283 #ENABLE_LYNXRC:underline_links:OFF
3284 #ENABLE_LYNXRC:user_mode:ON
3285 #ENABLE_LYNXRC:useragent:OFF
3286 #ENABLE_LYNXRC:verbose_images:ON
3287 #ENABLE_LYNXRC:vi_keys:ON
3288 #ENABLE_LYNXRC:visited_links:ON
3291 .h1 External Programs
3292 # Any of the compiled-in pathnames of external programs can be overridden
3293 # by specifying the corresponding xxx_PATH variable. If the variable is
3294 # given as an empty string, lynx will not use the program. For a few cases,
3295 # there are internal functions (such as mkdir) which can be used instead.
3319 .h2 FORCE_SSL_PROMPT
3320 # If FORCE_SSL_PROMPT is set to "yes", then questionable conditions, such as
3321 # self-signed certificates will be ignored. If set to "no", these will be
3322 # reported, but not attempted. The default "prompt" permits the user to make
3323 # this choice on a case-by-case basis.
3325 #FORCE_SSL_PROMPT:PROMPT
3327 .h2 FORCE_COOKIE_PROMPT
3328 # If FORCE_COOKIE_PROMPT is set to "yes", then questionable conditions, such as
3329 # cookies with invalid syntax will be ignored. If set to "no", these will be
3330 # reported, but not attempted. The default "prompt" permits the user to make
3331 # this choice on a case-by-case basis.
3333 #FORCE_COOKIE_PROMPT:PROMPT
3336 # For win32, allow the console window to be resized to the given values. This
3337 # requires PDCurses 2.5. The values given are width,height.
3340 ## END OF FILE #################################################################