snapshot of project "lynx", label v2-8-3dev_18

1 files changed, 58 insertions, 50 deletions

diff --git a/lynx.cfg b/lynx.cfg
index aa526fb3..a8075276 100644
--- a/lynx.cfg
+++ b/lynx.cfg
@@ -6,7 +6,7 @@
 # Definition pairs are of the form  VARIABLE:DEFINITION
 # NO spaces are allowed between the pair items.
 #
-#  If you do not have write access to /usr/local/bin you may change
+#  If you do not have write access to /usr/local/lib you may change
 #  the default location of this file in the userdefs.h file and recompile,
 #  or specify its location on the command line with the "-cfg"
 #  command line option.
@@ -18,7 +18,13 @@
 # An HTML'ized description of all settings (based on comments in this file,
 # with alphabetical table of settings and with table of settings by category)
 # is available at http://www.hippo.ru/~hvv/lynxcfg_toc.html
+#
+### The conversion is done via the scripts/cfg2html.pl script.
+### Several directives beginning with '.' are used for this purpose.
+
+.h1 Internal Behavior
 
+.h2 INCLUDE
 # 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.
@@ -46,9 +52,11 @@
 #   INCLUDE:filename for <space-separated-list-of-allowed-settings>
 #
 # sample:
+.ex
 #INCLUDE:~/lynx.cfg for COLOR VIEWER KEYMAP
 # only one space character should surround the word 'for'.  On Unix systems ':'
 # is also accepted as separator.  In that case, the example can be written as
+.ex
 #INCLUDE:~/lynx.cfg:COLOR VIEWER KEYMAP
 # In the example, only the settings COLOR, VIEWER and KEYMAP are accepted by
 # lynx.  Other settings are ignored.  Note:  INCLUDE is also treated as a
@@ -82,6 +90,7 @@ STARTFILE:http://lynx.browser.org/
 #
 # As an alternative, you may want to use a local URL.  A good choice for this is
 # the user's home directory:
+.ex
 #STARTFILE:file://localhost/~/
 #
 # Your choice of STARTFILE should reflect your site's needs, and be a URL that
@@ -1359,12 +1368,10 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 # the rendition of documents that you browse with lynx, but can change various
 # delays and resource utilization.
 
-.h2 CSO_PROXY
-.h2 FINGER_PROXY
+.h2 HTTP_PROXY
+.h2 HTTPS_PROXY
 .h2 FTP_PROXY
 .h2 GOPHER_PROXY
-.h2 HTTPS_PROXY
-.h2 HTTP_PROXY
 .h2 NEWSPOST_PROXY
 .h2 NEWSREPLY_PROXY
 .h2 NEWS_PROXY
@@ -1373,6 +1380,8 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 .h2 SNEWSREPLY_PROXY
 .h2 SNEWS_PROXY
 .h2 WAIS_PROXY
+.h2 FINGER_PROXY
+.h2 CSO_PROXY
 # 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
@@ -2702,21 +2711,9 @@ MINIMAL_COMMENTS:TRUE
 #	RULE:Redirect	http://old.server/*	http://new.server/*
 
 .h1 Appearance
-
-.h2 HTMLSRC_ABRACKET
-.h2 HTMLSRC_ATTRIB
 .h2 HTMLSRC_ATTRNAME_XFORM
-.h2 HTMLSRC_ATTRVAL
-.h2 HTMLSRC_BADATTR
-.h2 HTMLSRC_BADSEQ
-.h2 HTMLSRC_BADTAG
-.h2 HTMLSRC_COMM
-.h2 HTMLSRC_ENTIRE
-.h2 HTMLSRC_ENTITY
-.h2 HTMLSRC_HREF
-.h2 HTMLSRC_SGMLSPECIAL
-.h2 HTMLSRC_TAG
 .h2 HTMLSRC_TAGNAME_XFORM
+.h2 PRETTYSRC_SPEC
 # Pretty source view settings. These settings are in effect when -prettysrc
 # is specified.
 # The following lexical elements (lexemes) are recognized:
@@ -2725,7 +2722,7 @@ MINIMAL_COMMENTS:TRUE
 # bad tag, bad attribute, sgml special.
 #  The following group of option tells which styles will surround each
 # lexeme. The syntax of option in this group is:
-#HTMLSRC_<LEXEMENAME>:<TAGSPEC>:<TAGSPEC>
+#PRETTYSRC_SPEC:<LEXEMENAME>:<TAGSPEC>:<TAGSPEC>
 # The first <TAGSPEC> specifies what tags will precede lexemes of that class
 # in the internal html markup. The second - what will be placed (internally)
 # after it.
@@ -2775,46 +2772,46 @@ MINIMAL_COMMENTS:TRUE
 # 5) Angle brackets of html specials won't be surrounded by markup for ABRACKET
 #
 .ex
-# HTMLSRC_COMM:B I:!I !B
+# PRETTYSRC_SPEC:COMM:B I:!I !B
 #           HTML comments will be surrounded by <b><i> and </i></b> in the
 #           internal html markup
 .ex
-# HTMLSRC_ATTRVAL: span.attrval : !span
+# PRETTYSRC_SPEC:ATTRVAL: span.attrval : !span
 #           Values of the attributes will be surrounded by the
 #           <SPAN class=attrval> </SPAN>
 .ex
-# HTMLSRC_HREF::
+# PRETTYSRC_SPEC:HREF::
 #           No special html markup will surround hyperlink destinations (
 #           this means that only default color style for hrefs will be applied
 #           to them)
 #
 # For lynx compiled with lss support, the following settings are the default:
-#HTMLSRC_COMM:span.htmlsrc_comment:!span
-#HTMLSRC_TAG:span.htmlsrc_tag:!span
-#HTMLSRC_ATTRIB:span.htmlsrc_attrib:!span
-#HTMLSRC_ATTRVAL:span.htmlsrc_attrval:!span
-#HTMLSRC_ABRACKET:span.htmlsrc_abracket:!span
-#HTMLSRC_ENTITY:span.htmlsrc_entity:!span
-#HTMLSRC_HREF:span.htmlsrc_href:!span
-#HTMLSRC_ENTIRE:span.htmlsrc_entire:!span
-#HTMLSRC_BADSEQ:span.htmlsrc_badseq:!span
-#HTMLSRC_BADTAG:span.htmlsrc_badtag:!span
-#HTMLSRC_BADATTR:span.htmlsrc_badattr:!span
-#HTMLSRC_SGMLSPECIAL:span.htmlsrc_sgmlspecial:!span
+#PRETTYSRC_SPEC:COMM:span.htmlsrc_comment:!span
+#PRETTYSRC_SPEC:TAG:span.htmlsrc_tag:!span
+#PRETTYSRC_SPEC:ATTRIB:span.htmlsrc_attrib:!span
+#PRETTYSRC_SPEC:ATTRVAL:span.htmlsrc_attrval:!span
+#PRETTYSRC_SPEC:ABRACKET:span.htmlsrc_abracket:!span
+#PRETTYSRC_SPEC:ENTITY:span.htmlsrc_entity:!span
+#PRETTYSRC_SPEC:HREF:span.htmlsrc_href:!span
+#PRETTYSRC_SPEC:ENTIRE:span.htmlsrc_entire:!span
+#PRETTYSRC_SPEC:BADSEQ:span.htmlsrc_badseq:!span
+#PRETTYSRC_SPEC:BADTAG:span.htmlsrc_badtag:!span
+#PRETTYSRC_SPEC:BADATTR:span.htmlsrc_badattr:!span
+#PRETTYSRC_SPEC:SGMLSPECIAL:span.htmlsrc_sgmlspecial:!span
 # the styles corresponding to them are present in sample .lss file.
 # For lynx compiled without lss support, the following settings are the default:
-#HTMLSRC_COMM:b:!b
-#HTMLSRC_TAG:b:!b
-#HTMLSRC_ATTRIB:b:!b
-#HTMLSRC_ATTRVAL::
-#HTMLSRC_ABRACKET:b:!b
-#HTMLSRC_ENTITY:b:!b
-#HTMLSRC_HREF::
-#HTMLSRC_ENTIRE::
-#HTMLSRC_BADSEQ:b:!b
-#HTMLSRC_BADTAG::
-#HTMLSRC_BADATTR::
-#HTMLSRC_SGMLSPECIAL:b:!b
+#PRETTYSRC_SPEC:COMM:b:!b
+#PRETTYSRC_SPEC:TAG:b:!b
+#PRETTYSRC_SPEC:ATTRIB:b:!b
+#PRETTYSRC_SPEC:ATTRVAL::
+#PRETTYSRC_SPEC:ABRACKET:b:!b
+#PRETTYSRC_SPEC:ENTITY:b:!b
+#PRETTYSRC_SPEC:HREF::
+#PRETTYSRC_SPEC:ENTIRE::
+#PRETTYSRC_SPEC:BADSEQ:b:!b
+#PRETTYSRC_SPEC:BADTAG::
+#PRETTYSRC_SPEC:BADATTR::
+#PRETTYSRC_SPEC:SGMLSPECIAL:b:!b
 #
 # Other source-view related options:
 #
@@ -2824,15 +2821,15 @@ MINIMAL_COMMENTS:TRUE
 #HTMLSRC_TAGNAME_XFORM:2
 #HTMLSRC_ATTRNAME_XFORM:2
 
-.h2 PSRCVIEW_NO_ANCHOR_NUMBERING
-# PSRCVIEW_NO_ANCHOR_NUMBERING - pretty source view setting
+.h2 PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING
+# PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING - pretty source view setting
 # If "keypad mode" in 'O'ptions screen is "Links are numbered" or
-# "Links and form fields are numbered", and PSRCVIEW_NO_ANCHOR_NUMBERING is
+# "Links and form fields are numbered", and PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING is
 # TRUE, then links won't be numbered in psrc view and will be numbered
 # otherwise. Set this setting to TRUE if you prefer numbered links, but wish
 # to get valid HTML source when printing or mailing when in psrc view.
 # Default is FALSE.
-#PSRCVIEW_NO_ANCHOR_NUMBERING:FALSE
+#PRETTYSRC_VIEW_NO_ANCHOR_NUMBERING:FALSE
 
 .h1 HTML Parsing
 
@@ -2860,6 +2857,17 @@ MINIMAL_COMMENTS:TRUE
 #
 #JUSTIFY:TRUE
 
+.h2 JUSTIFY_MAX_VOID_PERCENT 
+# JUSTIFY_MAX_VOID_PERCENT - Appearance
+# This option controls the maximum allowed value for ratio (in percents) of
+# 'the number of spaces to spread across the line to justify it' to
+# 'max line size for current style and nesting' when justification is allowed.
+# When that ratio exceeds the value specified, that particular line won't be
+# justified. I.e. the value 28 for this setting will mean maximum value for
+# that ratio is 0.28.
+#
+#JUSTIFY_MAX_VOID_PERCENT:35
+
 .h1 Interaction
 
 .h2 TEXTFIELDS_NEED_ACTIVATION