config

My configuration files and custom scripts.
git clone https://git.tronto.net/config
Download | Log | Files | Refs

lynx.cfg (163481B)


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