[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
lynx-dev some proposed nit fixes in lynx.cfg
From: |
Larry W. Virden |
Subject: |
lynx-dev some proposed nit fixes in lynx.cfg |
Date: |
Sat, 7 Nov 1998 11:08:47 -0500 (EST) |
--- 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.
- lynx-dev some proposed nit fixes in lynx.cfg,
Larry W. Virden <=