lynx-dev some proposed nit fixes in lynx.cfg

[Larry W. Virden]

--- lynx.cfg-dist       Fri Nov  6 09:29:41 1998
+++ lynx.cfg-new        Sat Nov  7 11:07:49 1998
@@ -8,3 +8,3 @@
 #
-#  If you do not have access to /usr/local/bin you may change
+#  If you do not have write access to /usr/local/bin you may change
 #  the default location of this file in the userdefs.h file and recompile,
@@ -38,3 +38,3 @@
 # or via a WWW_HOME environment variable.
-# note: these files can be remote (http://www.w3.org/default.html)
+# Note:  these files can be remote (http://www.w3.org/default.html)
 # or local (file://localhost/PATH_TO/FILENAME
@@ -73,7 +73,8 @@
 
-# JUMP_PROMPT is the default statusline prompt for jumps files (see below).
+# JUMP_PROMPT is the default statusline prompt for selecting a jumps file
+# shortcut.  (see below).
 # You can change the prompt here from that defined in userdefs.h.  Any
-# trailing white space will be trimmed, and a single space added by Lynx
+# trailing white space will be trimmed, and a single space is added by Lynx
 # following the last non-white character.  You must set the default prompt
-# before setting the default jumps file (below). If a default jumps file
+# before setting the default jumps file (below).  If a default jumps file
 # was set via userdefs.h, and you change the prompt here, you must set the
@@ -83,3 +84,3 @@
 
-# JUMPFILE is the default local file checked for shortcut URL's when
+# JUMPFILE is the default local file checked for shortcut URLs when
 # the user presses the 'J' (JUMP) key.  The user will be prompted for
@@ -87,3 +88,3 @@
 # or use '?' for a list of the shortcuts with associated links to
-# their actual URL's.  See the sample jumps files in the samples
+# their actual URL's.  See the jumps files in the lynx*/samples
 # subdirectory.  Make sure your jumps file includes a '?' shortcut
@@ -100,3 +101,3 @@
 #
-# Additional, alternate jumps files can be defined and mapped to
+# Additional alternate jumps files can be defined and mapped to
 # keystrokes at the bottom of lynx.cfg, but you should first define
@@ -162,3 +163,3 @@
 
-# CHARACTER_SET defines the display character set, i.e., that assumed to be
+# CHARACTER_SET defines the display character set, i.e., assumed to be
 # installed on the user's terminal.  It determines which characters or strings
@@ -168,6 +169,6 @@
 # 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
+# default is defined in userdefs.h and can be changed here or 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
+# default.  For Lynx a "character set" has two names:  a MIME name (for
 # recognizing properly labeled charset parameters in HTTP headers etc.), and a
@@ -175,17 +176,19 @@
 # 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). 
+# 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.
+#
+# Raw (CJK) mode
+#
+# Lynx normally translates characters from a document's charset to display
+# charset, using ASSUME_CHARSET value (see below) if the document's charset
+# is not specified explicitly.  Raw CJK mode is OFF for this case.
+# When the document charset is specified explicitly, that charset
+# overrides any assumption like ASSUME_CHARSET or raw 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
+# For the Asian (CJK) display character sets, the corresponding charset is
+# assumed in documents, i.e., raw 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.  The mode should be toggled OFF when an Asian (CJK) display
 # character set is selected but the document is not CJK and its charset not
@@ -193,6 +196,6 @@
 #
-# 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 CJK mode may be toggled by user via '@' (LYK_RAW_TOGGLE) key,
+# the -raw command line switch or from the 'o'ptions menu.
 #
-# Raw mode effectively changes the charset assumption about unlabeled
+# Raw CJK mode effectively changes the charset assumption about unlabeled
 # documents.  You can toggle raw mode ON if you believe the document has a
@@ -209,5 +212,5 @@
 # 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.
+# the cpXXX codepages used by IBM PC compatible computers, and windows-xxxx
+# used by native MS-Windows apps.  We also note that cpXXX pages rarely are
+# found on Internet, but are mostly for local needs on DOS.
 #
@@ -238,3 +241,3 @@
 #    Baltic Rim (windows-1257)          windows-1257
-#    Cyrillic (ISO-8859-5)              iso-8859-5 
+#    Cyrillic (ISO-8859-5)              iso-8859-5
 #    Cyrillic (cp866)                   cp866
@@ -268,3 +271,3 @@
 # (the official default for the HTTP protocol).  When ASSUME_CHARSET
-# given here or by an -assume_charset command line flag is in effect,
+# is defined here or by an -assume_charset command line flag is in effect,
 # Lynx will treat documents as if they were encoded accordingly.
@@ -280,3 +283,3 @@
 # command line option, the value for ASSUME_CHARSET or -assume_charset
-# is used. It works for both text/plain and text/html files.
+# is used.  It works for both text/plain and text/html files.
 # This option will ignore "raw mode" toggling when local files are viewed
@@ -288,14 +291,14 @@
 
-# PREPEND_CHARSET_TO_SOURCE:TRUE allow prepending a META CHARSET
+# PREPEND_CHARSET_TO_SOURCE:TRUE tells Lynx to prepend a META CHARSET line
 # to text/html source files when they are retrieved for 'd'ownloading
-# or passed to 'p'rint functions. This is necessary for resolving charset
-# for local html files, while the assume_local_charset just an assumption...
-# For 'd'ownload option charset will be added only if HTTP charset present.
-# The compilation default is FALSE.
-# It is generally desired to have charset information for every
-# local html file, but META CHARSET string may cause
-# compatibility problems with other browsers, so
-# if you use all CHARACTER_SET, ASSUME_CHARSET, ASSUME_LOCAL_CHARSET
-# unchanged from theirs default value iso-8859-1 you usually
-# need not change the compilation default for PREPEND_CHARSET_TO_SOURCE.
+# or passed to 'p'rint functions.  This is necessary for resolving charset
+# for local html files, while the assume_local_charset is just an assumption.
+# For the 'd'ownload option, a META CHARSET will be added only if the HTTP
+# charset is present.  The compilation default is FALSE.
+# It is generally desirable to have charset information for every local
+# html file, but META CHARSET string potentially could cause
+# compatibility problems with other browsers, so if you leave all the
+# CHARACTER_SET, ASSUME_CHARSET, ASSUME_LOCAL_CHARSET variables
+# set to their default value of iso-8859-1 you usually will not need to
+# change the compilation default for PREPEND_CHARSET_TO_SOURCE.
 # Note that the prepending is not done for -source dumps.
@@ -305,9 +308,10 @@
 # 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.
+# in the unicode format (NCR).  This may be useful if you need to switch
+# display charsets frequently.  This is the case when you use Lynx on different
+# platforms, e.g.  on UNIX and from a remote PC, and want to keep the bookmarks
+# file persistent.
+# Another aspect is compatibility:  NCR is part of I18N and HTML4.0
+# specifications supported starting with Lynx 2.7.2, Netscape 4.0 and MSIE 4.0.
+# Older browser versions will fail so keep NCR_IN_BOOKMARKS:FALSE if you
+# plan to use them.
 #
@@ -317,4 +321,4 @@
 # 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).
+# character sets.  It is FALSE by default and should not be changed unless
+# you encounter problems with case-insensitive searches.
 #
@@ -322,8 +326,8 @@
 
-# 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).
+# While Lynx supports different platforms and display character sets
+# we need to limit the charset in outgoing mail to reduce
+# trouble for remote recipients 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 the display character set.
+# Charset translations currently are implemented for mail "subjects= " only.
 #
@@ -352,3 +356,3 @@
 # "ISO-8859-2", "ISO-8859-5") which Lynx will indicate you prefer in
-# requests to http servers using an Accept-Charsets header. Users can
+# requests to http servers using an Accept-Charsets header.  Users can
 # change it via the 'o'ptions menu and save that preference in their RC file.
@@ -357,4 +361,4 @@
 # 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 
-# character set is acceptable. If an Accept-Charset header is present,
+# 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
@@ -362,3 +366,3 @@
 # 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.  See RFC2068.
 #
@@ -373,3 +377,3 @@
 # .com.jp).  The default lists are defined in userdefs.h and can be
-# changed here.  Each prefix will be used with each suffix, in order,
+# replaced here.  Each prefix will be used with each suffix, in order,
 # until a valid Internet host is created, based on a successful DNS
@@ -390,3 +394,3 @@
 
-# Lynx Options Menu style toggle: forms-based or old-style.
+# 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.
@@ -399,3 +403,3 @@
 # redraws the screen in PARTIAL mode.  Anything < 0 implies
-# use the screen size.
+# use of the screen size.
 #PARTIAL_THRES:-1
@@ -404,3 +408,3 @@
 # Set this to change the units shown:
-# TRUE for KB/sec or FALSE for bytes/sec: default is TRUE.
+# TRUE for KB/sec or FALSE for bytes/sec:  default is TRUE.
 #SHOW_KB_RATE:TRUE
@@ -450,4 +454,5 @@
 # [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.
+# This can be useful in determining what images are decorations 
+# (button.gif, line.gif) and what images are important (if the page writer
+# bothers to use useful names).
 #
@@ -493,7 +498,7 @@
 # the DEFAULT_CACHE_SIZE and DEFAULT_VIRTUAL_MEMORY_SIZE are exceeded, then
-# least recently displayed documents will be freed until one or the other
-# value is no longer exceeded.  The default value was defined in userdefs.h.
+# the least recently displayed documents will be freed until one or the other
+# value is no longer exceeded.  The default value is defined in userdefs.h.
 #
-# The Unix and VMS but not VAXC implementations use the C library malloc's
-# and calloc's for memory allocation, and procedures for taking the actual
+# The Unix and VMS (but not VAXC) implementations use the C library malloc's
+# and calloc's for memory allocation, but procedures for taking the actual
 # amount of cache into account still need to be developed.  They use only
@@ -559,6 +564,5 @@
 
-# Local execution links and scripts are completely disabled
-# in the source code unless they are enabled in the
-# userdefs.h file and the sources recompiled.  Please
-# see the Lynx source code distribution and the userdefs.h
+# Local execution links and scripts are by default completely disabled
+# unless a change is made to the userdefs.h file to enabled them.
+# See the Lynx source code distribution and the userdefs.h
 # file for more detail on enabling execution links and scripts.
@@ -632,3 +636,3 @@
 # anonymous accounts in which you have disabled execution links generally,
-# and may also have disabled jump file links, but still want to allow
+# and may also have disabled jumps file links, but still want to allow
 # execution of particular utility scripts or programs.  The format is
@@ -669,3 +673,3 @@
 # environment variable to the list of environment variables passed on to the
-# lynxcgi script. Useful variables are HOME, USER, EDITOR, etc...
+# lynxcgi script.  Useful variables are HOME, USER, EDITOR, etc...
 #
@@ -704,3 +708,3 @@
 #
-#  NOTE: This can generate A LOT of mail, be warned.
+#  NOTE:  This can generate A LOT of mail, be warned.
 #
@@ -727,4 +731,4 @@
 # must be set so that it points to your site's NNTP server (see INSTALLATION).
-# Lynx respects RFC 1738 (http://www.ics.uci.edu/pub/ietf/uri/rfc1738.txt) and
-# and does not accept a host field in news URLs (use nntp: instead news: for
+# Lynx respects RFC 1738 (http://www.ics.uci.edu/pub/ietf/uri/rfc1738.txt) 
+# and does not accept a host field in news URLs (use nntp: instead of news: for
 # the scheme if you wish to specify an NNTP host in a URL, as explained in the
@@ -734,2 +738,4 @@
 # outlive the Lynx image.
+# The news reading facility in Lynx is quite limited.  Lynx does not provide a
+# full featured news reader with elaborate error checking and safety features.
 #
@@ -771,3 +777,3 @@
 # post new messages or followups to news groups, using the URL schemes
-# described in the "Supported URL" section of the online 'h'elp.  The
+# described in the "Supported URLs" section of the online 'h'elp.  The
 # posts will be attempted via the nntp server specified in the URL, or
@@ -780,2 +786,4 @@
 # -restrictions command line switch.
+# The posting facility in Lynx is quite limited.  Lynx does not provide a
+# full featured news poster with elaborate error checking and safety features.
 #
@@ -794,3 +802,3 @@
 # the user to click with button-1 on links to select them.
-#USE_MOUSE: FALSE
+#USE_MOUSE:FALSE
 
@@ -833,3 +841,3 @@
 # COOKIE_FILE is the default file to store persistent downloaded cookies
-# in, if Lynx was compiled with EXP_PERSISTENT_COOKIES. The cookie file
+# in, if Lynx was compiled with EXP_PERSISTENT_COOKIES.  The cookie file
 # can also be specified in .lynxrc or on the commandline.
@@ -837,3 +845,4 @@
 
-# PERSISTENT_COOKIES is tested only if Lynx was compiled with
+# PERSISTENT_COOKIES indicates that cookies should be stored for use between
+# Lynx sessions.  It is only used if Lynx was compiled with
 # EXP_PERSISTENT_COOKIES.  Use this flag to disable the feature.
@@ -908,8 +917,7 @@
 
-# DEFAULT_KEYPAD_MODE specifies whether by default the user
-# has numbers that work like arrows or else numbered links.
-# DEFAULT KEYPAD MODE may be set to TRUE for using numbers
-# as arrows as the default, or FALSE for using numbered links
-# as the default (LINKS_AND_FORM_FIELDS_ARE_NUMBERED cannot
-# currently be set by this option.).
+# DEFAULT_KEYPAD_MODE specifies whether numbers work like arrows or
+# numbered links.
+# DEFAULT_KEYPAD_MODE set to TRUE indicates numbers act as arrows,
+# and set to FALSE indicates numbers refer to numbered links on the patge.
+# LINKS_AND_FORM_FIELDS_ARE_NUMBERED cannot currently be set by this option.
 #
@@ -922,6 +930,6 @@
 
-# DEFAULT_BOOKMARK_FILE is a default filename for use as a personal
-# bookmark file.  It will reference a file from the user's home directory.
+# DEFAULT_BOOKMARK_FILE is the filename used for storing personal bookmarks.
+# It will be prepended by the user's home directory.
 # NOTE that a file ending in .html or other suffix mapped to text/html
-# should be used to ensure it's treatment as HTML.  The built-in default
+# should be used to ensure its treatment as HTML.  The built-in default
 # is lynx_bookmarks.html.  On both Unix and VMS, if a subdirectory off of
@@ -948,3 +956,3 @@
 # default via the .lynxrc file.  When on, the setting can be STANDARD or
-# ADVANCED.  If support is set to the latter, and the user mode also is
+# ADVANCED.  If SUPPORT is set to the latter, and the user mode also is
 # ADVANCED, the VIEW_BOOKMARK command will invoke a statusline prompt at
@@ -952,3 +960,3 @@
 # or '=' to get a menu of available bookmark files.  The menu always is
-# presented in NOVICE or INTERMEDIATE mode, or if the support is set to
+# presented in NOVICE or INTERMEDIATE mode, or if the SUPPORT is set to
 # STANDARD.  No prompting or menu display occurs if only one (the startup
@@ -970,5 +978,5 @@
 # DEFAULT_USER_MODE sets the default user mode for Lynx users.
-# NOVICE  shows a three line help message at the bottom of the screen
-# INTERMEDIATE  shows normal amount of help (one line)
-# ADVANCED  help is replaced by the URL of the current link
+# NOVICE shows a three line help message at the bottom of the screen.
+# INTERMEDIATE shows normal amount of help (one line).
+# ADVANCED help is replaced by the URL of the current link.
 #
@@ -984,3 +992,3 @@
 #       know how to use it.  Most users do not enjoy getting stuck in
-#       an unknown editor that they can't get out of.  Users can
+#       an unknown editor that they can't exit.  Users can
 #       easily define an editor of their own using the options menu,
@@ -1077,2 +1085,3 @@
 # even if it does not physically print anything.
+#
 # Usually, downloading involves the use of (e.g.) Ckermit or ZModem
@@ -1118,4 +1127,4 @@
 # uploader definition sets.  Uploaders may be any program
-# that could be useful to your users, they do not necessarily
-# have to be an upload protocol program. The most common use
+# that could be useful to your users; they do not necessarily
+# have to be an upload protocol program.  The most common use
 # of an uploader is to use Ckermit or some other transfer
@@ -1181,3 +1190,3 @@
 # strings will have '-' and a link labeled "[IMAGE]" for the resolved SRC
-# appended. See also VERBOSE_IMAGES flag.
+# appended.  See also VERBOSE_IMAGES flag.
 #
@@ -1222,3 +1231,3 @@
 # behavior of treating any '>' as a terminator for comments, instead of
-# seeking a valid '-->' terminator (note that white space can be present
+# seeking a valid '-->' terminator (white space can be present
 # between the '--' and '>' in valid terminators).  The compilation default
@@ -1419,3 +1428,3 @@
 #
-# Note: if you do not define a viewer to a new MIME type
+# NOTE: if you do not define a viewer to a new MIME type
 #       that you assigned above then it will be saved to
@@ -1665,16 +1674,16 @@
 #
-#      type: TAG: list only when one or more files are tagged
-#            FILE: list only when the current selection is a regular file
-#            DIR: list only when the current selection is a directory
-#            LINK: list only when the current selection is a symbolic link
+#      type: TAG:   list only when one or more files are tagged
+#            FILE:  list only when the current selection is a regular file
+#            DIR:   list only when the current selection is a directory
+#            LINK:  list only when the current selection is a symbolic link
 #
-#      suffix: list only if the current selection ends in this pattern
+#      suffix:  list only if the current selection ends in this pattern
 #
-#      link text: the displayed text of the link
+#      link text:  the displayed text of the link
 #
-#      extra text: the text displayed following the link
+#      extra text:  the text displayed following the link
 #
-#      action: the URL to be followed upon selection
+#      action:  the URL to be followed upon selection
 #
-#      link text and action are scanned  for % sequences that are expanded
+#      link text and action are scanned for % sequences that are expanded
 #      at display time as follows:
@@ -1796,3 +1805,3 @@
 
-# External application support. This feature allows lynx to pass a given
+# External application support.  This feature allows Lynx to pass a given
 # URL to an external program.  It was written for three reasons.
@@ -1805,3 +1814,3 @@
 #
-# 3) To allow for new URLs to be used through lynx.
+# 3) To allow for new URLs to be used through Lynx.
 #        URLs can be made up such as mymail: to spawn desired applications
@@ -1809,3 +1818,3 @@
 #
-# Restrictions can be imposed using -restrictions=externals at the lynx
+# Restrictions can be imposed using -restrictions=externals at the Lynx
 # command line.  This will disallow all EXTERNAL lines in lynx.cfg that
@@ -1827,3 +1836,3 @@
 # for certain externals to be enabled while restricting others.  TRUE means
-# a command will still function while lynx is restricted.  WB
+# a command will still function while Lynx is restricted.  WB
 #
-- 
Larry W. Virden                 INET: address@hidden
<URL:http://www.purl.org/NET/lvirden/> <*> O- "We are all Kosh."
Unless explicitly stated to the contrary, nothing in this posting should 
be construed as representing my employer's opinions.