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