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

1 files changed, 73 insertions, 14 deletions

diff --git a/lynx.cfg b/lynx.cfg
index cb4ab723..f4c6691e 100644
--- a/lynx.cfg
+++ b/lynx.cfg
@@ -128,8 +128,8 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 # in a similar manner to 'g'oto; alternatively, s/he can enter '?'
 # to view the full JUMPFILE list of short-cuts with associated URLs.
 # There is an example jumps file in the samples subdirectory.
-# If not defined here or in  userdefs.h , the JUMP command will invoke
-# the NO_JUMPFILE statusline message (cp  LYMessages_en.h ).
+# If not defined here or in userdefs.h, the JUMP command will invoke
+# the NO_JUMPFILE statusline message (see  LYMessages_en.h ).
 #
 # To allow '?' to work, include in the JUMPFILE
 # a short-cut to the JUMPFILE itself, e.g.
@@ -618,8 +618,10 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 #
 #SEEK_FRAG_AREA_IN_CUR:TRUE
 
-# Local execution links and scripts are by default completely disabled
-# unless a change is made to the userdefs.h file to enabled them.
+# Local execution links and scripts are by default completely disabled,
+# unless a change is made to the userdefs.h file to enabled them or
+# the configure script is used with the corresponding options
+# (--enable-exec-links and --enable-exec-scripts).
 # See the Lynx source code distribution and the userdefs.h
 # file for more detail on enabling execution links and scripts.
 #
@@ -645,11 +647,11 @@ DEFAULT_INDEX_FILE:http://www.ncsa.uiuc.edu/SDG/Software/Mosaic/MetaIndex.html
 
 # If LOCAL_EXECUTION_LINK_ON_BUT_NOT_REMOTE is TRUE, and no TRUSTED_EXEC
 # rule is defined, it defaults to "file://localhost/" and any lynxexec
-# or lynxprog command will be permitted if it was referenced with a URL
-# beginning with that string.  If you wish to restrict the referencing URLs
-# further, you can extend the string to include a trusted path.  You also can
-# specify a trusted directory for http URLs, which will then be treated as
-# if they were local rather than remote.  For example:
+# or lynxprog command will be permitted if it was referenced from within
+# a document whose URL begins with that string.  If you wish to restrict the
+# referencing URLs further, you can extend the string to include a trusted
+# path.  You also can specify a trusted directory for http URLs, which will
+# then be treated as if they were local rather than remote.  For example:
 #
 #	TRUSTED_EXEC:file://localhost/trusted/
 #	TRUSTED_EXEC:http://www.wfbr.edu/trusted/
@@ -1595,7 +1597,7 @@ MINIMAL_COMMENTS:TRUE
 # Key remapping definitions!
 #
 # You may redefine the keymapping of any function in Lynx by
-# using the KEYMAP variable.  The form of KEYMAP is:
+# using the KEYMAP option.  The form of KEYMAP is:
 #  KEYMAP:<KEYSTROKE>:<LYNX FUNCTION>
 #
 # You must map upper and lowercase keys separately.
@@ -1636,8 +1638,15 @@ MINIMAL_COMMENTS:TRUE
 #
 # Other codes not listed above may be available for additional keys,
 # depending on operating system and libraries used to compile Lynx.
-
-#KEYMAP:0x2F:SOURCE	# Toggle source viewing mode (show HTML source)
+# On some systems, if compiled with recent versions of slang or ncurses
+# if macro USE_KEYMAPS was in effect during compilation), an additional
+# level of key mapping is supported via an external ".lynx-keymaps" file.
+# This file, if found in the home directory at startup, will always be
+# used under those conditions; see lynx-keymaps distributed in the samples
+# subdirectory for furhter explanation.  Note that mapping via
+# .lynx-keymaps, if applicable, is a step that precedes KEYMAP.
+
+#KEYMAP:0x5C:SOURCE	# Toggle source viewing mode (show HTML source)
 #KEYMAP:^R:RELOAD	# Reload the current document and redisplay
 #KEYMAP:q:QUIT		# Ask the user to quit
 #KEYMAP:Q:ABORT		# Quit without verification
@@ -1707,10 +1716,28 @@ MINIMAL_COMMENTS:TRUE
 #KEYMAP:0x00:DO_NOTHING	# Does nothing (ignore this key)
 #KEYMAP:0x10E:DO_NOTHING # Does nothing (ignore this key)
 #
-# In addition, the following functions are not mapped to any keys by default:
+# KEYMAP lines can have an additional field with content PASS.  If present,
+# if the key is pressed in a text input field it is passed by the built-in
+# line-editor to normal KEYMAP handling, i.e. this flag acts like an implied
+# ^V escape.  It overrides any line-editor binding for the key.  For example,
+#
+#KEYMAP:0x108:HELP:PASS  # Function key Help (or F1) - Always default help
+#
+# In addition, the following functions are not directly mapped to any keys
+# by default, although some of them may be mapped in specific line-editor
+# bindings (effective while in text input fields):
 #
 #KEYMAP:???:RIGHT_LINK	# Move to the link to the right
 #KEYMAP:???:LEFT_LINK	# Move to the link to the left
+#KEYMAP:???:LPOS_PREV_LINK # Like PREV_LINK, last column pos if form input
+#KEYMAP:???:LPOS_NEXT_LINK # Like NEXT_LINK, last column pos if form input
+#*** Only useful in form text fields , need PASS or prefixing with ^V: ***
+#KEYMAP:???:DWIMHELP       # Display help page that may depend on context
+#KEYMAP:???:DWIMEDIT       # Use external editor for context-dependent purpose
+#*** Only useful in a form textarea, need PASS or prefixing with ^V: ***
+#KEYMAP:???:EDITTEXTAREA   # use external editor to edit a form textarea
+#KEYMAP:???:GROWTEXTAREA   # Add some blank lines to bottom of textarea
+#KEYMAP:???:INSERTFILE     # Insert file into a textarea (just above cursor)
 
 # If TOGGLE_HELP is mapped, in novice mode the second help menu line
 # can be toggled among NOVICE_LINE_TWO_A, _B, and _C, as defined in
@@ -1893,6 +1920,35 @@ MINIMAL_COMMENTS:TRUE
 #DIRED_MENU:TAG::Remove all tagged files and directories.::LYNXDIRED://REMOVE_TAGGED
 #DIRED_MENU:TAG::Untag all tagged items.::LYNXDIRED://CLEAR_TAGGED
 
+# Some systems only:
+#===================
+# Lynx tries to detect window size changes with a signal handler for
+# SIGWINCH if supported.  If NONRESTARTING_SIGWINCH is set to TRUE,
+# and the sigaction interface is available on the system, the handler
+# is installed as 'non-restarting'.  On some systems (depending on the
+# library used for handling keyboard input, e.g. ncurses), this allows
+# more immediate notification of window size change events.  If the value
+# is set to FALSE, the signal() interface is used; this normally makes
+# the handler 'restarting', with the effect that lynx can react to size
+# changes only after some key is pressed.  The value can also be set to
+# XWINDOWS; this is equivalent to TRUE when the user has the environment
+# variable DISPLAY defined *at program start*, and equivalent to FALSE
+# otherwise.  The non-restarting behavior can also be changed to TRUE
+# or FALSE with -nonrestarting_sigwinch switch, which overrides the
+# value in this file.
+# Note that Lynx never re-parses document text purely as a result of a
+# window size change, so text lines may appear truncated after narrowing
+# the window, until the document is reloaded with ^R or a similar key
+# or until a different text is loaded.
+# The default is FALSE since there is a possibility that non-restarting
+# interrupts may be mis-interpreted as fatal input errors in some
+# configurations (leading to an abrupt program exit), and since this
+# option is useful mostly only for users running Lynx under xterm or a
+# similar X terminal emulator.  On systems where the preconditions don't
+# apply this option is ignored.
+# 
+#NONRESTARTING_SIGWINCH:FALSE
+
 # Unix ONLY:
 #===========
 # If NO_FORCED_CORE_DUMP is set to TRUE, Lynx will not force
@@ -1975,6 +2031,9 @@ MINIMAL_COMMENTS:TRUE
 # for certain externals to be enabled while restricting others.  TRUE means
 # a command will still function while Lynx is restricted.  WB
 #
+# For invoking the command use the EXTERN key.  By default it is mapped
+# to '.' (if the feature is enabled), see the KEYMAP section above.
+#
 # EXTERNAL:ftp:wget %s &:TRUE
 
 # CERN-style rules, EXPERIMENTAL  -  URL-specific rules
@@ -1994,7 +2053,7 @@ MINIMAL_COMMENTS:TRUE
 #	RULE:Fail	gopher:*		     # reject by scheme
 #	RULE:Pass	finger://*@localhost/	     # allow this,
 #	RULE:Fail	finger:*		     # but not others
-#	RULE:Map	http://old.server/*	http://new.server/*
+#	RULE:Redirect	http://old.server/*	http://new.server/*
 
 
 # Pretty source view settings. These settings are in effect when -prettysrc