snapshot of project "lynx", label v2-8-4dev_20

1 files changed, 22 insertions, 16 deletions

diff --git a/lynx.cfg b/lynx.cfg
index 852658f1..69f58b6b 100644
--- a/lynx.cfg
+++ b/lynx.cfg
@@ -1104,7 +1104,7 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 #LYNX_SIG_FILE:.lynxsig
 
 .h1 Bibliographic Protocol (bibp scheme)
-     
+
 .h2 BIBP_GLOBAL_SERVER
 # BIBP_GLOBAL_SERVER is the default global server for bibp: links, used
 # when a local bibhost or document-specified citehost is unavailable.
@@ -1140,11 +1140,15 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 
 
 .h2 USE_MOUSE
-# If USE_MOUSE is set TRUE, Lynx (when configured with ncurses, PDcurses or
-# slang) will allow the user to click with button-1 on links to select them. 
-# Other mouse-usable operations include:  clicking on the top or bottom of a
-# page to make it scroll up or down, clicking on the left edge to pop the
-# history stack, to move to a text entry field, or manipulate a popup menu.
+# If Lynx is configured with ncurses, PDcurses or slang & USE_MOUSE is TRUE,
+# users can perform commands by left-clicking certain parts of the screen:
+#   on a link = `g'oto + ACTIVATE (ie move highlight & follow the link);
+#   on the top/bottom lines = PREV/NEXT_PAGE (ie go up/down 1 page);
+#   on the top/bottom left corners = PREV_DOC (ie go to the previous document);
+#   on the top/bottom right corners = HISTORY (ie call up the history page).
+# NB if the mouse is defined in this way, it will not be available
+# for copy/paste operations using the clipboard of a desktop manager:
+# for flexibility instead, use the command-line switch  -use_mouse .
 #
 # ncurses and slang have built-in support for the xterm mouse protocol.  In
 # addition, ncurses can be linked with the gpm mouse library, to automatically
@@ -2351,8 +2355,9 @@ MINIMAL_COMMENTS:TRUE
 #KEYMAP:*:IMAGE_TOGGLE		# Toggle inclusion of links for all images
 #KEYMAP:[:INLINE_TOGGLE		# Toggle pseudo-ALTs for inlines with no ALT string
 #KEYMAP:]:HEAD			# Send a HEAD request for current document or link
-#*** Must be compiled with USE_EXTERNALS to enable EXTERN ***
-#KEYMAP:.:EXTERN		# Run external program with url
+#*** Must be compiled with USE_EXTERNALS to enable EXTERN_LINK, EXTERN_PAGE ***
+#KEYMAP:,:EXTERN_PAGE		# Run external program with current page
+#KEYMAP:.:EXTERN_LINK		# Run external program with current link
 #*** Escaping from text input fields with ^V is independent from this: ***
 #KEYMAP:^V:SWITCH_DTD		# Toggle between SortaSGML and TagSoup HTML parsing
 #KEYMAP:0x00:DO_NOTHING		# Does nothing (ignore this key)
@@ -2524,16 +2529,16 @@ MINIMAL_COMMENTS:TRUE
 
 .h2 AUTO_UNCACHE_DIRLISTS
 # AUTO_UNCACHE_DIRLISTS determines when local file directory listings are
-# automatically regenerated (by re-reading the actual directory from disk). 
+# automatically regenerated (by re-reading the actual directory from disk).
 # Set the value to 0 to avoid automatic regeneration in most cases.  This is
-# useful for browsing large directories that take some time to read and format. 
+# useful for browsing large directories that take some time to read and format.
 # An update can still always be forced with the RELOAD key, and specific DIRED
 # actions may cause a refresh anyway.  Set the value to 1 to force regeneration
 # after commands that usually change the directory or some files and would make
 # the displayed info stale, like EDIT and REMOVE.  Set it to 2 (the default) or
 # greater to force regeneration even after leaving the displayed directory
 # listing by some action that usually causes no change, like GOTO or entering a
-# file with the ACTIVATE key.  This option is only honored in DIRED mode (i.e. 
+# file with the ACTIVATE key.  This option is only honored in DIRED mode (i.e.
 # when lynx is compiled with DIRED_SUPPORT and it is not disabled with a
 # -restriction).  Local directories displayed without DIRED normally act as if
 # AUTO_UNCACHE_DIRLISTS:0 was in effect.
@@ -2846,12 +2851,13 @@ MINIMAL_COMMENTS:TRUE
 #
 # <allow_for_activate> Setting this to TRUE allows the use of this command not
 # only when EXTERN key is pressed, but also when ACTIVATE command is invoked
-# (i.e activating the link with the given prefix will be equivalent to
+# (i.e., activating the link with the given prefix will be equivalent to
 # pressing EXTERN key on it).  If this component of the line is absent, then
 # FALSE is assumed.
-# 
-# For invoking the command use the EXTERN key.  By default it is mapped
-# to '.' (if the feature is enabled), see the KEYMAP section above.
+#
+# For invoking the command use the EXTERN_LINK or EXTERN_PAGE key.  By default
+# EXTERN_LINK is mapped to '.', and EXTERN_PAGE to ',' (if the feature is
+# enabled), see the KEYMAP section above.
 #
 #EXTERNAL:ftp:wget %s &:TRUE
 
@@ -3046,7 +3052,7 @@ MINIMAL_COMMENTS:TRUE
 #
 #JUSTIFY:TRUE
 
-.h2 JUSTIFY_MAX_VOID_PERCENT 
+.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