snapshot of project "lynx", label v2-8-2dev_2

1 files changed, 308 insertions, 236 deletions

diff --git a/lynx.cfg b/lynx.cfg
index 5c73de82..3a51c92a 100644
--- a/lynx.cfg
+++ b/lynx.cfg
@@ -2,6 +2,7 @@
 # The default placement for this file is /usr/local/lib/lynx.cfg (Unix)
 #                                     or Lynx_Dir:lynx.cfg (VMS)
 #
+#
 # Definition pairs are of the form  VARIABLE:DEFINITION
 # NO spaces are allowed between the pair items.
 #
@@ -15,6 +16,24 @@
 # All definitions must be flush left and have NO spaces.!!!
 #
 #
+# Starting with Lynx 2.8.1, the lynx.cfg file has a crude "include"
+# facility.  This means that you can take advantage of the global lynx.cfg
+# while also supplying your own tweaks.
+#
+# You can use a command-line argument (-cfg /where/is/lynx.cfg) or an
+# environment variable (LYNX_CFG=/where/is/lynx.cfg).
+# For instance, put in your .profile or .login:
+#
+#   LYNX_CFG=~/lynx.cfg; export LYNX_CFG   # in .profile for sh/ksh/bash/etc.
+#   setenv LYNX_CFG ~/lynx.cfg             # in .login for [t]csh
+#
+# Then in ~/lynx.cfg:
+#
+#INCLUDE:/usr/local/lib/lynx.cfg
+#       ^^^^^^^^^^^^^^^^^^^^^^^ or whatever's appropriate on your system
+#and now your own tweaks.
+
+#
 # STARTFILE is the default URL if none is specified on the command line
 # or via a WWW_HOME environment variable.
 # note: these files can be remote (http://www.w3.org/default.html)
@@ -141,95 +160,107 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 #
 #LOCAL_DOMAIN:ukans.edu
 
-# CHARACTER_SET defines the default character set, i.e., that assumed
-# to be installed on the user's terminal.  It determines which characters
-# or strings will be used to represent 8-bit character entities within
-# HTML.  New character sets may be defined as explained in the README
-# files of the src/chrtrans directory in the Lynx source code distribution.
-# For Asian (CJK) character sets, it also determines how Kanji code will
-# be handled.  The default is defined in userdefs.h and can be changed
-# here, and via the 'o'ptions menu.  The 'o'ptions menu setting will be
-# stored in the user's RC file whenever those settings are saved, and
-# thereafter will be used as the default.  For Lynx a "character set" has
-# two names: a Display Character Set string for the Options screen and
-# for setting CHARACTER_SET here, and a corresponding MIME name (for
-# recognizing properly labelled charset parameters in HTTP headers etc.).
-# Not all Display Character Set names correspond to exactly one valid MIME
-# charset (for example "Chinese", "Transparent"), in that case
-# an appropriate valid (and more specific) MIME name should be used
-# where required.  The actions of the -raw switch and LYK_RAW_TOGGLE ('@')
-# are dependent on the character set.  For the Asian (CJK) sets the
-# corresponding charset is assumed in documents, i.e., raw or CJK mode is
-# ON by default, so that -raw or the initial LYK_RAW_TOGGLE will turn the
-# mode OFF.  The toggling also can be done via the 'o'ptions menu.  In raw
-# CJK mode, 8-bit characters are not reverse translated in relation to the
-# entity conversion arrays, i.e., they are assumed to be appropriate for
-# the current character set.  It should be toggled OFF when an Asian (CJK)
-# character set is selected but the document is not CJK.
-# The default for "raw mode" (before it is changed by -raw or LYK_RAW_TOGGLE),
-# if the display character set is not a CJK character set, depends on the
-# display character set as well as the ASSUME_CHARSET value (see below) from
-# either this file or an -assume_charset command line option.  The mode
-# defaults to ON if the ASSUME_CHARSET value corresponds to the display
-# character set, otherwise to OFF.
-# It can be toggled ON if you believe the document has a charset which does
-# correspond to your Display Character Set, but was not detected to have
-# that charset and was handled as having the default charset (normally
-# iso-8859-1).  You also can specify the default charset (to one other
-# than iso-8859-1) via the ASSUME_CHARSET value (see below) from either
-# this file or an -assume_charset command line option.  Note that "raw"
-# does not mean that every byte will be passed to the screen.  HTML
-# character entities may get expanded and translated, inappropriate control
-# characters filtered out, etc.  Raw mode effectively changes the charset
-# assumption about unlabelled documents. There is a "Transparent" pseudo
+# CHARACTER_SET defines the display character set, i.e., that assumed to be
+# installed on the user's terminal.  It determines which characters or strings
+# will be used to represent 8-bit character entities within HTML.  New
+# character sets may be defined as explained in the README files of the
+# src/chrtrans directory in the Lynx source code distribution.  For Asian (CJK)
+# character sets, it also determines how Kanji code will be handled.  The
+# default is defined in userdefs.h and can be changed here, and via the
+# 'o'ptions menu.  The 'o'ptions menu setting will be stored in the user's RC
+# file whenever those settings are saved, and thereafter will be used as the
+# default.  For Lynx a "character set" has two names:  MIME name (for
+# recognizing properly labeled charset parameters in HTTP headers etc.), and a
+# human-readable string for the 'O'ptions Menu (so you may find info about
+# language or group of languages besides MIME name).  Not all 'human-readable'
+# names correspond to exactly one valid MIME charset (example is "Chinese"), in
+# that case an appropriate valid (and more specific) MIME name should be used
+# where required.  Well-known synonyms are also processed in the code.
+#
+# Lynx normally translates characters from document's charset to display
+# charset, using ASSUME_CHARSET value (see below) if document's charset is not
+# specified explicitly.  There is the so called `raw or CJK mode' which is OFF
+# for this case. (When the document charset specified explicitly 
+# it override any assumption like ASSUME_CHARSET or raw or CJK mode). 
+#
+# For the Asian (CJK) display character sets the corresponding charset is
+# assumed in documents, i.e., raw or CJK mode is ON by default.  In raw CJK
+# mode, 8-bit characters are not reverse translated in relation to the entity
+# conversion arrays, i.e., they are assumed to be appropriate for the display
+# character set.  It should be toggled OFF when an Asian (CJK) display
+# character set is selected but the document is not CJK and its charset not
+# specified explicitly.
+#
+# The `raw or CJK mode' may be toggled by user via '@' (LYK_RAW_TOGGLE) key,
+# with -raw command line switch or from 'o'ptions menu.
+#
+# Raw mode effectively changes the charset assumption about unlabeled
+# documents.  You can toggle raw mode ON if you believe the document has a
+# charset which does correspond to your Display Character Set.  On the other
+# hand, if you set ASSUME_CHARSET the same as Display Character Set you get raw
+# mode ON by default (but you get assume_charset=iso-8859-1 if you try raw mode
+# OFF after it).
+#
+# Note that "raw" does not mean that every byte will be passed to the screen.
+# HTML character entities may get expanded and translated, inappropriate
+# control characters filtered out, etc.  There is a "Transparent" pseudo
 # character set for more "rawness".
 #
-# The default character sets include:
-#    Display Character Set name		MIME name
-#    ==========================		=========
-#    7 bit approximations		us-ascii
-#    Chinese				euc-cn
-#    DEC Multinational			dec-mcs
-#    DosArabic (cp864)			cp864
-#    DosBaltRim (cp775) 		cp775
-#    DosCyrillic (cp866)		cp866
-#    DosGreek (cp737)			cp737
-#    DosGreek2 (cp869)			cp869
-#    DosHebrew (cp862)			cp862
-#    DosLatin1 (cp850)			cp850
-#    DosLatin2 (cp852)			cp852
-#    DosLatinUS (cp437) 		cp437
-#    ISO 8859-10			iso-8859-10
-#    ISO 8859-5 Cyrillic		iso-8859-5
-#    ISO 8859-6 Arabic			iso-8859-6
-#    ISO 8859-7 Greek			iso-8859-7
-#    ISO 8859-8 Hebrew			iso-8859-8
-#    ISO 8859-9 (Latin 5)		iso-8859-9
-#    ISO Latin 1			iso-8859-1
-#    ISO Latin 2			iso-8859-2
-#    ISO Latin 3			iso-8859-3
-#    ISO Latin 4			iso-8859-4
-#    Japanese (EUC)			euc-jp
-#    Japanese (SJIS)			shift_jis
-#    KOI8-R Cyrillic			koi8-r
-#    Korean				euc-kr
-#    Macintosh (8 bit)			macintosh
-#    NeXT character set 		next
-#    RFC 1345 Mnemonic			mnemonic
-#    RFC 1345 w/o Intro 		mnemonic+ascii+0
-#    Taipei (Big5)			big5
-#    Transparent			x-transparent
-#    UNICODE UTF 8			utf-8
-#    Vietnamese (VISCII)		viscii
-#    WinArabic (cp1256) 		windows-1256
-#    WinBaltRim (cp1257)		windows-1257
-#    WinCyrillic (cp1251)		windows-1251
-#    WinGreek (cp1253)			windows-1253
-#    WinHebrew (cp1255) 		windows-1255
-#    WinLatin1 (cp1252) 		windows-1252
-#    WinLatin2 (cp1250) 		windows-1250
-#
-#CHARACTER_SET:ISO Latin 1
+# Since Lynx now supports a wide range of platforms it may be useful to note
+# that cpXXX codepages used by IBM PC compatible computers, and windows-xxxx
+# used by native MS-Windows apps.  We also note that cpXXX pages rerely found
+# on Internet but mostly for local needs on DOS.
+#
+# Recognized character sets include:
+#
+#    string for 'O'ptions Menu          MIME name
+#    ===========================        =========
+#    7 bit approximations (US-ASCII)    us-ascii
+#    Western (ISO-8859-1)               iso-8859-1
+#    Western (cp850)                    cp850
+#    Western (windows-1252)             windows-1252
+#    IBM PC US codepage (cp437)         cp437
+#    DEC Multinational                  dec-mcs
+#    Macintosh (8 bit)                  macintosh
+#    NeXT character set                 next
+#    Chinese                            euc-cn
+#    Japanese (EUC-JP)                  euc-jp
+#    Japanese (Shift_JIS)               shift_jis
+#    Korean                             euc-kr
+#    Taipei (Big5)                      big5
+#    Vietnamese (VISCII)                viscii
+#    Eastern European (ISO-8859-2)      iso-8859-2
+#    Eastern European (cp852)           cp852
+#    Eastern European (windows-1250)    windows-1250
+#    Latin 3 (ISO-8859-3)               iso-8859-3
+#    Latin 4 (ISO-8859-4)               iso-8859-4
+#    Baltic Rim (cp775)                 cp775
+#    Baltic Rim (windows-1257)          windows-1257
+#    Cyrillic (ISO-8859-5)              iso-8859-5 
+#    Cyrillic (cp866)                   cp866
+#    Cyrillic (windows-1251)            windows-1251
+#    Cyrillic (KOI8-R)                  koi8-r
+#    Arabic (ISO-8859-6)                iso-8859-6
+#    Arabic (cp864)                     cp864
+#    Arabic (windows-1256)              windows-1256
+#    Greek (ISO-8859-7)                 iso-8859-7
+#    Greek (cp737)                      cp737
+#    Greek2 (cp869)                     cp869
+#    Greek (windows-1253)               windows-1253
+#    Hebrew (ISO-8859-8)                iso-8859-8
+#    Hebrew (cp862)                     cp862
+#    Hebrew (windows-1255)              windows-1255
+#    Turkish (ISO-8859-9)               iso-8859-9
+#    ISO-8859-10                        iso-8859-10
+#    UNICODE (UTF-8)                    utf-8
+#    RFC 1345 w/o Intro                 mnemonic+ascii+0
+#    RFC 1345 Mnemonic                  mnemonic
+#    Transparent                        x-transparent
+#
+# The value should be the MIME name of a character set recognized by
+# Lynx (case insensitive).
+#
+#CHARACTER_SET:iso-8859-1
 
 # ASSUME_CHARSET changes the handling of documents which do not
 # explicitly specify a charset.  Normally Lynx assumes that 8-bit
@@ -239,8 +270,8 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 # Lynx will treat documents as if they were encoded accordingly.
 # See above on how this interacts with "raw mode" and the Display
 # Character Set.
-# The value should be the MIME name of a character set recognized by
-# Lynx (case insensitive).
+# ASSUME_CHARSET can also be changed via the 'o'ptions menu but will
+# not be saved as permanent value in user's .lynxrc file to avoid more chaos.
 #
 #ASSUME_CHARSET:iso-8859-1
 
@@ -248,9 +279,10 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 # files.  If no setting is given here or by an -assume_local_charset
 # command line option, the value for ASSUME_CHARSET or -assume_charset
 # is used. It works for both text/plain and text/html files.
-# This option may interfere with "raw mode" toggling when local files
-# are viewed (it is "stronger" than the effective change of the charset
-# assumption caused by changing "raw mode"), so only use when necessary.
+# This option will ignore "raw mode" toggling when local files are viewed
+# (it is "stronger" than "assume_charset" or the effective change
+# of the charset assumption caused by changing "raw mode"),
+# so only use when necessary.
 #
 #ASSUME_LOCAL_CHARSET:iso-8859-1
 
@@ -270,6 +302,33 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 #
 #PREPEND_CHARSET_TO_SOURCE:FALSE
 
+# NCR_IN_BOOKMARKS:TRUE allows you to save 8-bit characters in bookmark titles
+# with unicode format (NCR).  This may be useful if you need switching display
+# charset frequently.  This is the case when you use lynx on different
+# platforms, e.g.  on UNIX and from remote PC, but want to keep bookmarks file
+# persistent.
+# Another side is compatibility:  NCR as part of I18N and HTML4.0
+# specifications supported starting with Lynx 2.7.2, Netscape 4.0 and MSIE 4.0
+# Older versions fail, keep NCR_IN_BOOKMARKS:FALSE if you plan to use them.
+#
+#NCR_IN_BOOKMARKS:FALSE
+
+# FORCE_8BIT_TOUPPER overrides locale settings and uses internal 8-bit
+# case-conversion mechanism for case-insensitive searches in non-ASCII display
+# character set, FALSE by default (should not be changed unless you encounter
+# problems with case-insensitive searches).
+#
+#FORCE_8BIT_TOUPPER:FALSE
+
+# While lynx supports different platforms and display character sets
+# we need to limit outgoing mail character repertoire to reduce
+# trouble for remote recipient who may not recognize our charset.
+# You may try US-ASCII as the safest value (7 bit), any other MIME name
+# or leave this field blank (default) to use display character set. 
+# (Translation currently implemented for mail "subjects= " only).
+#
+#OUTGOING_MAIL_CHARSET:
+
 # If Lynx encounters a charset parameter it doesn't recognize, it will
 # replace the value given by ASSUME_UNREC_CHARSET (or a corresponding
 # -assume_unrec_charset command line option) for it.  This can be used
@@ -296,12 +355,12 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 # The value should NOT include "ISO-8859-1" or "US-ASCII",
 # since those values are always assumed by default.
 # If a file in that character set is available, the server will send it.
-# If no Accept-Charset header is present, the default is that any
+# "If no Accept-Charset header is present, the default is that any 
 # character set is acceptable. If an Accept-Charset header is present,
 # and if the server cannot send a response which is acceptable
 # according to the Accept-Charset header, then the server SHOULD send
 # an error response with the 406 (not acceptable) status code, though
-# the sending of an unacceptable response is also allowed. (RFC2068)
+# the sending of an unacceptable response is also allowed." (RFC2068) 
 #
 #PREFERRED_CHARSET:
 
@@ -329,11 +388,28 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 #URL_DOMAIN_PREFIXES:www.
 #URL_DOMAIN_SUFFIXES:.com,.edu,.net,.org
 
+# Lynx Options Menu style toggle: forms-based or old-style.
+# Works if old-style menu is compiled in as well as the forms-based menu.
+#FORMS_OPTIONS:TRUE
+
+# Display partial pages while downloading
+#PARTIAL:TRUE
+
+# Set the threshold # of lines Lynx must render before it
+# redraws the screen in PARTIAL mode.  Anything < 0 implies
+# use the screen size.
+#PARTIAL_THRES:-1
+
+# While getting large files, Lynx shows the approximate rate of transfer.
+# Set this to change the units shown:
+# TRUE for KB/sec or FALSE for bytes/sec: default is TRUE.
+#SHOW_KB_RATE:TRUE
+
 # The following three definitions set the number of seconds for
 # pauses following statusline messages that would otherwise be
 # replaced immediately, and are more important than the unpaused
 # progress messages.  Those set by INFOSECS are also basically
-# progress messages (e.g., that a prompted input has been cancelled)
+# progress messages (e.g., that a prompted input has been canceled)
 # and should have the shortest pause.  Those set by MESSAGESECS are
 # informational (e.g., that a function is disabled) and should have
 # a pause of intermediate duration.  Those set by ALERTSECS typically
@@ -370,6 +446,14 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 #
 #SHOW_CURSOR:FALSE
 
+# VERBOSE_IMAGES controls whether or not Lynx replaces the [LINK], [INLINE] and
+# [IMAGE] comments (for images without ALT) with filenames of these images.
+# This is extremely useful because now we can determine immediately what images
+# are just decorations (button.gif, line.gif) and what images are important.
+#
+# If this option is set here, it will override the setting in userdefs.h.
+#VERBOSE_IMAGES:TRUE
+
 # If BOLD_HEADERS is set to TRUE the HT_BOLD default style will be acted
 # upon for <H1> through <H6> headers.  The compilation default is FALSE
 # (only the indentation styles are acted upon, but see BOLD_H1, below).
@@ -711,12 +795,17 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 #USE_MOUSE: FALSE
 
 # If COLLAPSE_BR_TAGS is set FALSE, Lynx will not collapse serial BR tags.
-# Note that the valid way to insert extra blank lines in HTML is via a PRE
-# block with only newlines in the block.
-# The default is defined in userdefs.h, and can be overridden here.
+# If set TRUE, two or more concurrent BRs will be collapsed into a single
+# line break.  Note that the valid way to insert extra blank lines in HTML
+# is via a PRE block with only newlines in the block.
 #
 #COLLAPSE_BR_TAGS:TRUE
 
+# If TAGSOUP is set, Lynx uses the "Tag Soup DTD" rather than "SortaSGML".
+# The two approaches differ by the style of error detection and recovery.
+# Tag Soup DTD allows for improperly nested tags; SortaSGML is stricter.
+#TAGSOUP:FALSE
+
 # If SET_COOKIES is set FALSE, Lynx will ignore Set-Cookie headers
 # in http server replies.
 # The default is defined in userdefs.h, and can be overridden here,
@@ -724,6 +813,32 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 #
 #SET_COOKIES:TRUE
 
+# If ACCEPT_ALL_COOKIES is set TRUE, Lynx will accept cookies from all
+# domains with no user interaction.
+# The default is defined in userdefs.h and can be overridden here,
+# and/or toggled via the -accept_all_cookies command line switch.
+#
+#ACCEPT_ALL_COOKIES:FALSE
+
+# COOKIE_ACCEPT_DOMAINS and COOKIE_REJECT_DOMAINS are comma-delimited lists of
+# domains (with a leading '.') to automatically accept or reject all cookies
+# from.  These can also be specified in the lynxrc file, and are overridden by
+# the ACCEPT_ALL_COOKIES parameter.  If a single domain is specified in both
+# COOKIE_ACCEPT_DOMAINS and in COOKIE_REJECT_DOMAINS, the rejection will take
+# precedence.
+#
+#COOKIE_ACCEPT_DOMAINS:
+#COOKIE_REJECT_DOMAINS:
+
+# COOKIE_FILE is the default file to store persistent downloaded cookies
+# in, if Lynx was compiled with EXP_PERSISTENT_COOKIES. The cookie file
+# can also be specified in .lynxrc or on the commandline.
+#COOKIE_FILE:~/.lynx_cookies
+
+# PERSISTENT_COOKIES is tested only if Lynx was compiled with
+# EXP_PERSISTENT_COOKIES.  Use this flag to disable the feature.
+#PERSISTENT_COOKIES:TRUE
+
 # VMS:
 #=====
 # The mail command and qualifiers are defined in userdefs.h.  Lynx
@@ -738,7 +853,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 # function in LYPrint.c, may be required.
 #
 #SYSTEM_MAIL:PMDF SEND
-#SYSERM_MAIL_FLAGS:/headers
+#SYSTEM_MAIL_FLAGS:/headers
 #
 #SYSTEM_MAIL:MAIL
 #SYSTEM_MAIL_FLAGS:
@@ -879,16 +994,15 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 #SYSTEM_EDITOR:
 
 # Proxy variables
-# Lynx version 2.2 and beyond supports the use of proxy servers that can
-# act as firewall gateways and caching servers.  They are preferable to
-# the older gateway servers.  Each protocol used by Lynx can be mapped
-# separately using PROTOCOL_proxy environment variables (see INSTALLATION).
-# If you have not set them externally, you can set them at run time via
-# this configuration file.  They will not override external settings.
-# The no_proxy variable can be a comma-separated list of hosts which should
-# not be proxied, or an asterisk to override all proxy variables.
-# Note that on VMS they are set as process logicals rather than symbols,
-# to preserve lowercasing, and will outlive the Lynx image.
+# Lynx version 2.2 and beyond supports the use of proxy servers that can act as
+# firewall gateways and caching servers.  They are preferable to the older
+# gateway servers.  Each protocol used by Lynx can be mapped separately using
+# PROTOCOL_proxy environment variables (see INSTALLATION).  If you have not set
+# them externally, you can set them at run time via this configuration file.
+# They will not override external settings.  The no_proxy variable can be used
+# to inhibit proxying to selected regions of the Web (see below).  Note that on
+# VMS these proxy variables are set as process logicals rather than symbols, to
+# preserve lowercasing, and will outlive the Lynx image.
 #
 #http_proxy:http://some.server.dom:port/
 #https_proxy:http://some.server.dom:port/
@@ -906,119 +1020,94 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 #cso_proxy:http://some.server.dom:port/
 #no_proxy:host.domain.dom
 
-# Printer definitions
-# any number of printers may be defined by using multiple
-# printer definition sets.  Printers may be any program
-# that could be useful to your users, they do not necessarily
-# have to print.
-#
-# the definition of a printer is of the form
-# PRINTER:<printer name>:<printer command>:<printer option>:<lines/page>
-#
-#    <printer name> is the name that the user will see.
-# <printer command> is the command line arguments for printing a file.
-#		    The %s will be replaced with the file being printed.
-#                   If a second %s is given the second %s will be replaced by
-#                   a suggested filename that is prettier than the tempfile
-#                   name given in the first %s.  This does not remove the first
-#                   %s from the command line in any manner.  If you need to
-#                   use only the second %s file name in your printer command,
-#                   then I suggest creating a script which will first copy the
-#                   first %s file name to the second %s file name, and then
-#                   executing your print command with the second %s file name.
-#  <printer option> specifies whether the printer should be disabled for
-#		    users without printing options.  The options are
-#		    TRUE or FALSE;
-#		    TRUE means the printer will always be ENABLED
-#			 regardless of printer or anonymous settings
-#		    FALSE means the printer will be DISABLED when
-#			  the -noprint option is on, or for anonymous
-#			  users which are not allowed to print
-#
-#  <lines/page>    is an optional parameter for indicating the number of
-#		   lines per page for the printer.  Defaults to 66.  Used
-#		   for computing the approximate number of pages and
-#		   generating a statusline query of whether to proceed if
-#		   the document is longer than 4 printer pages.  Uses the
-#		   current screen length for the computation when the
-#		   built in "print to screen" option is selected.
-#
-#  You must put the whole definition on one line.
-#
-#  If you must use a colon, precede it with a backslash!
-#
-#  If you have a very busy VMS print queue and Lynx deletes the temporary
-#  files before they have been queued, use the VMSPrint.com included in
-#  the distribution.
-#
-#    examples
+# The no_proxy variable can be a comma-separated list of strings defining
+# no-proxy zones in the DNS domain name space.  If a tail substring of the
+# domain-path for a host matches one of these strings, transactions with that
+# node will not be proxied.
+#no_proxy:domain.path1,path2
+#
+# A single asterisk as an entry will override all proxy variables and no
+# transactions will be proxied.
+#no_proxy:*
+# This is the only allowed use of * in no_proxy.
+#
+# Warning:  Note that setting 'il' as an entry in this list will block proxying
+# for the .mil domain as well as the .il domain.  If the entry is '.il' this
+# will not happen.
+
+# PRINTER & DOWNLOADER DEFINITIONS:
+# Lynx has 4 pre-defined print options & 1 pre-defined download option,
+# which are called up on-screen when `p' or `d' are entered;
+# any number of options can be added by the user, as explained below.
+#
+# For `p' pre-defined options are: `Save to local file', `E-mail the file',
+# `Print to screen' and `Print to local printer attached to vt100'.
+# `Print to screen' allows file transfers in the absence of alternatives
+# and is often the only option allowed here for anonymous users;
+# the 3rd & 4th options are not pre-defined for DOS/WINDOWS versions of Lynx.
+# For `d' the pre-defined option is: `Download to local file'.
+#
+# To define your own print or download option use the following formats:
+# PRINTER:<name>:<command>:<option>:<lines/page>
+# DOWNLOADER:<name>:<command>:<option>
+#
+# <name>       is what you will see on the print/download screen.
+# <command>    is the command your system will execute:
+#              the 1st %s in the command will be replaced
+#              by the temporary filename used by Lynx;
+#              a 2nd %s will be replaced by a filename of your choice,
+#              for which Lynx will prompt, offering a suggestion;
+#              if the command format of your printer/downloader requires
+#              a different layout, you will need to use a script
+#              (see the last 2 download examples below).
+# <option>     TRUE : the printer/downloader will always be ENABLED,
+#              except that downloading is disabled when -validate is used;
+#              FALSE : both will be DISABLED for anonymous users
+#              and printing will be disabled when -noprint is used.
+# <lines/page> (printers: optional) the number of lines/page (default 66):
+#              used to compute the approximate output size
+#              and prompt if the document is > 4 printer pages;
+#              it uses current screen length for the computation
+#              when `Print to screen' is selected.
+#
+# You must put the whole definition on one line;
+# if you use a colon, precede it with a backslash.
+#
+# `Printer' can be any file-handling program you find useful,
+# even if it does not physically print anything.
+# Usually, downloading involves the use of (e.g.) Ckermit or ZModem
+# to transfer files to a user's local machine over a serial link,
+# but download options do not have to be download-protocol programs.
+#
+# Printer examples:
 #PRINTER:Computer Center printer:lpr -Pccprt %s:FALSE
 #PRINTER:Office printer:lpr -POffprt %s:TRUE
 #PRINTER:VMS printer:print /queue=cc$print %s:FALSE:58
+# If you have a very busy VMS print queue
+# and Lynx deletes the temporary files before they have been queued,
+# use the VMSPrint.com included in the distribution:
 #PRINTER:Busy VMS printer:@Lynx_Dir\:VMSPrint sys$print %s:FALSE:58
-#  Check out the lpansi program in utils/ for printing on vt100
-#  attached printers.
-#PRINTER:Use vt100 print sequence to print from your local terminal:lpansi %s:TRUE
-#  Don't use the following printer on anonymous accounts since
-#  allowing shell input is very dangerous.
-#PRINTER:Specify your own print command:echo -n "Enter a print command\: "; read word; sh -c "$word %s":FALSE
-#  Pass to a sophisticated file viewer (sources for most are available in
-#  ftp://space.mit.edu/pub/davis/most).  The most -k switch suppresses the
-#  invocation of hexadecimal display mode if 8-bit or control characters
-#  are present.  The +s switch invokes secure mode.
+# To specify a print option at run-time:
+# NBB if you have ANONYMOUS users, DO NOT allow this option!
+#PRINTER:Specify at run-time:echo -n "Enter a print command\: "; read word; sh -c "$word %s":FALSE
+# To pass to a sophisticated file viewer: -k suppresses invocation
+# of hex display mode if 8-bit or control characters are present;
+# +s invokes secure mode (see ftp://space.mit.edu/pub/davis/most):
 #PRINTER:Use Most to view:most -k +s %s:TRUE:23
-
-# Downloader definitions
-# any number of downloaders may be defined by using multiple
-# downloader definition sets.  Downloaders may be any program
-# that could be useful to your users, they do not necessarily
-# have to be a download protocol program. The most common use
-# of a downloader is to use Ckermit or some other transfer
-# program so that the user may easily transfer files back to
-# their local machine over a serial link.
-#
-# the definition of a downloader is of the form
-# DOWNLOADER:<downloadername>:<downloader command>:<downloader option>
-#
-#    <downloader name> is the name that the user will see.
-# <downloader command> is the command line arguments for downloading a file.
-#                      The %s will be replaced with the file being downloaded.
-#                      If a second %s is given the second %s will be replaced
-#                      by a suggested filename that is nicer than the tempfile
-#                      name given in the first %s.  This does not replace the
-#                      first %s in the command line.  If your command needs
-#                      the suggest file name on the command line only, then
-#                      I suggest creating a script that will first copy the
-#                      first %s file name to the second %s file name, and then
-#                      execute the downloading command using the second %s file
-#                      name (e.g., 'sz' needs such a script interposed).
-#  <downloader option> specifies whether the downloader should be disabled for
-#                      anonymous users.  The options are
-#                      TRUE or FALSE;
-#                      TRUE means the downloader will always be ENABLED
-#                           regardless of the anonymous settings (however,
-#			    all downloading is disabled by -validate).
-#                      FALSE means the downloader will be DISABLED when
-#                            the user is anonymous.
-#
-#  You must put the whole definition on one line.
-#
-#  If you must use a colon, precede it with a backslash!
 #
-#    examples
+# Downloader examples:
+# in Kermit, -s %s is the filename sent, -a %s the filename on arrival
+# (if they are given in reverse order here, the command will fail):
+#DOWNLOADER:Use Kermit to download to the terminal:kermit -i -s %s -a %s:TRUE
+# NB don't use -k with Most, so that binaries will invoke hexadecimal mode:
 #DOWNLOADER:Use Most to view:most +s %s:TRUE
-#  (don't use most's -k switch, so that binaries will invoke hexadecimal mode)
-#DOWNLOADER:Use Kermit to download to the local terminal:kermit -i -s %s -a %s:TRUE
+# The following example gives wrong filenames
+# (`sz' doesn't support a suggested filename parameter):
 #DOWNLOADER:Use Zmodem to download to the local terminal:sz %s:TRUE
+# The following example returns correct filenames
+# by using a script to make a subdirectory in /tmp,
+# but may conflict with very strong security or permissions restrictions:
 #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
-#
-# Note for Zmodem: The first variant gives wrong filenames ("sz" doesn't support
-# a suggested filename parameter, sorry). The second returns correct filenames
-# but may conflict with very strong security or permissions restrictions
-# (it uses the script to make a subdirectory in /tmp, see below).
-#    (example script in lieu of :sz %s: for offering a suggested filename)
-#  :set %s %s;td=/tmp/Lsz$$;mkdir $td;ln -s $1 $td/"$2";sz $td/"$2";rm -r $td:
-#
 
 # Unix ONLY:
 #===========
@@ -1045,6 +1134,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 #
 #    example
 #UPLOADER:Use Kermit to upload from your computer: kermit -i -r -a %s:TRUE
+#UPLOADER:Use Zmodem to upload from your computer: rz %s:TRUE
 
 # If NO_DOT_FILES is TRUE (normal default via userdefs.h), the user will not
 # be allowed to specify files beginning with a dot in reply to output filename
@@ -1089,7 +1179,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 # strings will be links for the resolved SRC rather than just text.  For
 # ISMAP or other graphic links, the ALT or pseudo-ALT ("[ISMAP]" or "[LINK]")
 # strings will have '-' and a link labeled "[IMAGE]" for the resolved SRC
-# appended.
+# appended. See also VERBOSE_IMAGES flag.
 #
 # The default defined here will override that in userdefs.h, and the user
 # can use LYK_IMAGE_TOGGLE to toggle the feature on or off at run time.
@@ -1103,6 +1193,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 # i.e., they'll be treated as having ALT="".  If MAKE_LINKS_FOR_ALL_IMAGES
 # is defined or toggled to TRUE, however, the pseudo-ALTs will be created
 # for inlines, so that they can be used as links to the SRCs.
+# See also VERBOSE_IMAGES flag.
 #
 # The default defined here will override that in userdefs.h, and the user
 # can use LYK_INLINE_TOGGLE to toggle the feature on or off at run time.
@@ -1267,6 +1358,7 @@ MINIMAL_COMMENTS:TRUE
 #SUFFIX:.tar:application/octet-stream
 #SUFFIX:.Z:application/octet-stream
 #SUFFIX:.gz:application/octet-stream
+#SUFFIX:.bz2:application/octet-stream
 #SUFFIX:.zip:application/octet-stream
 #SUFFIX:.lzh:application/octet-stream
 #SUFFIX:.lha:application/octet-stream
@@ -1457,7 +1549,7 @@ MINIMAL_COMMENTS:TRUE
 #KEYMAP:o:OPTIONS	# Show the options menu
 #KEYMAP:i:INDEX_SEARCH	# Search a server based index
 #KEYMAP:/:WHEREIS	# Find a string within the current document
-#KEYMAP:n:NEXT		# Find next occurence of string within document
+#KEYMAP:n:NEXT		# Find next occurrence of string within document
 #KEYMAP:c:COMMENT	# Comment to the author of the current document
 #KEYMAP:e:EDIT		# Edit current document
 #KEYMAP:E:ELGOTO	# Edit the current link's URL or ACTION and go to it
@@ -1559,7 +1651,7 @@ MINIMAL_COMMENTS:TRUE
 # Unix ONLY:
 #===========
 # DIRED_MENU items are used to compose the F)ull menu list in DIRED mode
-# The behaviour of the default configuration given here is much the same
+# The behavior of the default configuration given here is much the same
 # as it was when this menu was hard-coded but these items can now be adjusted
 # to suit local needs.  In particular, many of the LYNXDIRED actions can be
 # replaced with lynxexec, lynxprog and lynxcgi script references.
@@ -1737,23 +1829,3 @@ MINIMAL_COMMENTS:TRUE
 #
 # EXTERNAL:ftp:wget %s &:TRUE
 
-# Raw DOS Key hack
-# If RAW_DOS_KEY_HACK is set to FALSE, it will bypass the DOS key hack.
-# The DOS key hack is only present if compiled with -DRAWDOSKEYHACK
-# The hack is as follows:
-# if (c == 0) c = '/';
-# if (c > 255) {      /* handle raw dos keys */
-#		switch (c)
-#		{
-#			case 464: c = '-'; break;  /* keypad minus*/
-#			case 465: c = '+'; break;  /* keypad plus*/
-#			case 459: c = 13; break;  /* keypad enter*/
-#			case 463: c = '*'; break;  /* keypad * */
-#			case 440: c = 'Q'; break;  /* alt x */
-#			case 265: c = 'H'; break;  /* F1 */
-#			default: break;
-#		}
-#	}
-#
-# RAW_DOS_KEY_HACK:TRUE
-