snapshot of project "lynx", label v2-7-1ac_0-36

6 files changed, 202 insertions, 81 deletions

diff --git a/lynx_help/Lynx_users_guide.html b/lynx_help/Lynx_users_guide.html
index 356a98aa..58e2780f 100644
--- a/lynx_help/Lynx_users_guide.html
+++ b/lynx_help/Lynx_users_guide.html
@@ -464,7 +464,7 @@ options.
      preferred document lan(G)uage: en
      preferred document c(H)arset : NONE
      V)I keys: OFF    e(M)acs keys: OFF     sho(W) dot files: OFF
-     popups for selec(T) fields   : ON
+     popups for selec(T) fields   : ON      show cursor (@) : OFF
      K)eypad mode                 : Numbers act as arrows
      li(N)e edit style            : Default Binding
      l(I)st directory style	  : Mixed style
@@ -473,11 +473,12 @@ options.
      local e(X)ecution links	  : FOR LOCAL FILES ONLY
 </pre>
 
-An option can be changed by entering the capital letter of the option
-you want to change (i.e.  '<em>E</em>' for Editor). For fields where text
-must be entered, simply enter the text by typing on the keyboard.  The
-<a href="keystroke_commands/edit_help.html">Line Editor</a> can be used
-to correct mistakes, and <em>Control-U</em> can be used to erase the whole
+An option can be changed by entering the capital letter or character in
+parentheses for the option you wish to change (e.g. '<em>E</em>' for Editor
+or '<em>@</em>' for show cursor).  For fields where text must be entered,
+simply enter the text by typing on the keyboard.  The <a
+href="keystroke_commands/edit_help.html">Line Editor</a> can be used to
+correct mistakes, and <em>Control-U</em> can be used to erase the whole
 line.  When you are done entering a change press the <em>Return</em> key
 to get back to the <em>Command?</em> prompt.
 
@@ -567,23 +568,25 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
    <dt>Display Character set
 	<dd>This option allows you to set up the default character set for
 	    your specific terminal.  The character set provides a mapping
-	    of 8-bit ISO Latin character entities and/or Asian (CJK)
-	    characters into viewable characters and should be set in
+	    of 8-bit ISO Latin character entities and/or Asian (CJK) or
+	    UTF-8 characters into viewable characters and should be set in
 	    relation to your terminal's character set if you will be
 	    viewing such characters with Lynx.  You must have the selected
 	    character set installed on your terminal.
 
    <dt>Raw 8-bit or CJK Mode
-	<dd>Whether 8-bit characters are are assumed to correspond with
-	    the selected character set and therefore are processed without
-	    translation via the ISO Latin 1 conversion tables.  Should be
-	    ON by default when the selected character set is ISO Latin 1,
-	    or is one of the Asian (CJK) sets and the 8-bit characters are
-	    Kanji multibytes.  Should be OFF for the other character sets,
-	    but can be turned ON when there's a match, e.g., the document's
-	    charset is ISO-8859-2 and ISO Latin 2 has been selected.  Should
-	    be OFF when an Asian (CJK) set is selected but the document is
-	    ISO-8850-1.  The setting also can be toggled via the RAW_TOGGLE
+	<dd>Whether 8-bit characters are assumed to correspond with the
+	    selected character set and therefore are processed without
+	    translation via the chartrans conversion tables.  Should be ON
+	    by default when the selected character set is one of the Asian
+	    (CJK) sets and the 8-bit characters are Kanji multibytes.
+	    Should be OFF for the other character sets, but can be turned ON
+	    when the document's charset is unknown (e.g., is not ISO-8859-1
+	    and no charset parameter was included in a reply header from
+	    an HTTP server to indicate what it is) but you know by some
+	    means that you have the matching display character set selected.
+	    Should be OFF when an Asian (CJK) set is selected but the document
+	    is ISO-8850-1.  The setting also can be toggled via the RAW_TOGGLE
 	    command, normally mapped to '<em>@</em>', and at startup via the
 	    <em>-raw</em> switch.
 
@@ -619,19 +622,38 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
 
    <dt>Popups for select fields
 	<dd>Lynx normally uses a popup window for the OPTIONs in form
-	SELECT fields when the field does not have the MULTIPLE attribute
-	specified, and thus only one OPTION can be selected.  The use of
-	popup windows can be disabled by changing this setting to OFF, in
-	which case the OPTIONs will be rendered as a list of radio buttons.
-	Note that if the SELECT field does have the MULTIPLE attribute
-	specified, the OPTIONs always are rendered as a list of checkboxes. 
-
-   <dt>Keypad as arrows or numbered links
-	<dd>This option gives the choice between navigating with the arrow
-	    keys or having every link numbered so that the links may be
-	    selected by numbers as well as using the arrow keys.  See the
-	    <a href="keystroke_commands/follow_help.html"
-	    >Follow link (or goto link or page) number:</a> help for more information.
+	    SELECT fields when the field does not have the MULTIPLE
+	    attribute specified, and thus only one OPTION can be selected.
+	    The use of popup windows can be disabled by changing this setting
+	    to OFF, in which case the OPTIONs will be rendered as a list of
+	    radio buttons.  Note that if the SELECT field does have the
+	    MULTIPLE attribute specified, the OPTIONs always are rendered
+	    as a list of checkboxes. 
+
+   <dt>Show cursor for current link or option.
+	<dd>Lynx normally hides the cursor by positioning it to the right
+	    and if possible the very bottom of the screen, so that the
+	    current link or OPTION is indicated solely by its highlighting
+	    or color.  If show cursor is set to ON, the cursor will be
+	    positioned at the left of the current link or OPTION.  This
+	    is helpful when Lynx is being used with a speech or braille
+	    interface.  It also is useful for sighted users when the
+	    terminal cannot distinguish the character attributes used
+	    to distinguish the current link or OPTION from the others in
+	    the screen display.
+
+   <dt>Keypad as arrows, numbered links, or numbered links and form fields
+	<dd>This option gives the choice among navigating with the arrow
+	    keys, or having every link numbered so that the links may be
+	    selected or made current by numbers as well as using the arrow
+	    keys, or having every link as well as every form field numbered
+	    so that they can be selected or sought by numbers.  See the<br>
+	    &nbsp;&nbsp<a href="keystroke_commands/follow_help.html"
+	    >Follow link (or page) number:</a> and<br>
+	    &nbsp;&nbsp<a
+	    href="keystroke_commands/follow_help.html#select-option"
+	    >Select option (or page) number:</a><br>
+	    help for more information.
 
    <dt>Line edit style
    	<dd>This option allows you to set alternate key bindings for the
@@ -1054,7 +1076,11 @@ commands.
 	<dd>Lynx offers other, advanced navigation features when numbers
 	    are used to invoke the <a
 	    href="keystroke_commands/follow_help.html"
-	    >Follow link (or goto link or page) number:</a> prompt.
+	    >Follow link (or goto link or page) number:</a> or<br>
+	    &nbsp;&nbsp;<a
+	    href="keystroke_commands/follow_help.html#select-option"
+	    >Select option (or page) number:</a><br>
+	    prompts.
 	    [<A HREF="#TOC">ToC</A>]
 </dl>
 
@@ -1746,8 +1772,8 @@ where
   	<dd>can be selected from the following list, where items in
 	    all-caps indicate that a substitution must be made.
   	   <dl>
-   	      <dt><code>-</code>
-    		<dd>If the only argument is '<code>-</code>' (dash), then Lynx
+   	     <dt><code>-</code>
+    		<dd>If the argument is only '<code>-</code>' (dash), then Lynx
 		    expects to receive the arguments from stdin. This is to
 		    allow for the potentially very long command line that can
 		    be associated with the <em>-get_data</em> or
@@ -1755,11 +1781,20 @@ where
 		    must be encased in double-quotes (&quot;-&quot;) and the
 		    keyboard input terminated with <em>Control-Z</em> or the
 		    command file input terminated by a line that begins
-		    with '<em>$</em>'.
-   	      <dt><code>-anonymous</code>
+		    with '<em>$</em>'.  On Unix, the keyboard input terminator
+		    is <em>Control-D</em>.
+   	     <dt><code>-anonymous</code>
     		<dd>used to specify the anonymous account.
+   	     <dt><code>-assume_charset=MIMEname</code>
+    		<dd>charset for documents that don't specify it.
+   	     <dt><code>-assume_local_charset=MIMEname</code>
+    		<dd>charset assumed for local files.
+   	     <dt><code>-assume_unrec_charset=MIMEname</code>
+    		<dd>use this instead of unrecognized charsets.
 	     <dt><code>-auth=ID:PW</code>
-		<dd>id and password for protected pages.
+		<dd>set authorization ID and password for protected documents
+		    at startup.  Be sure to protect any script files which use
+		    this switch.
 	     <dt><code>-base</code>
 		<dd>prepend a request URL comment and BASE tag to text/html
 		    outputs for -source or -mime_header dumps.
@@ -1817,6 +1852,8 @@ where
 		    listings.
 	     <dt><code>-force_html</code> 
 		<dd>forces the first document to be interpreted as HTML.
+	     <dt><code>-force_secure</code> 
+		<dd>toggles forcing of the secure flag for SSL cookies.
              <dt><code>-from</code>
     		<dd>toggles transmissions of From headers to HTTP or HTTPS
 		    servers.
@@ -1887,9 +1924,16 @@ where
     		<dd>disable the retrieval status messages.
              <dt><code>-number_links</code>
     		<dd>force numbering of links.
+	     <dt><code>-pauth=ID:PW</code>
+		<dd>set authorization ID and password for a protected proxy
+		    server at startup.  Be sure to protect any script files
+		    which use this switch.
 	     <dt><code>-popup</code>
 		<dd>toggles handling of single-choice SELECT options via
-		    popup windows or as lists of radio buttons.
+		    popup windows or as lists of radio buttons.  The default
+          	    configuration can be changed in userdefs.h or lynx.cfg.
+		    It also can be set and saved via the 'o'ptions menu.
+                    The command line switch toggles the default.
 	     <dt><code>-post_data</code>
 		<dd>properly formatted data for a post form are read in from
 		    stdin and passed to the form. Input is terminated by a
@@ -2012,6 +2056,7 @@ where
           	    currently selected link.  Show cursor is the default for
 		    systems without FANCY_CURSES capabilities.  The default
           	    configuration can be changed in userdefs.h or lynx.cfg.
+		    It also can be set and saved via the 'o'ptions menu.
                     The command line switch toggles the default.
              <dt><code>-soft_dquotes</code>
     		<dd>toggles emulation of the old Netscape and Mosaic bug which
diff --git a/lynx_help/keystroke_commands/follow_help.html b/lynx_help/keystroke_commands/follow_help.html
index 3f2e9c81..f30fbb77 100644
--- a/lynx_help/keystroke_commands/follow_help.html
+++ b/lynx_help/keystroke_commands/follow_help.html
@@ -5,40 +5,76 @@
 <LINK rev="made" href="mailto:lynx-dev@sig.net">
 </HEAD>
 <BODY>
-<h1>+++ Follow link (or goto link or page) number Help +++</h1>
+<h1>+++ Follow link (or goto link or page) number Help +++<br>
++++ Select option (or page) number Help +++</h1>
 
 If a user has set <em>Keypad mode</em> to <em>Links are numbered</em>
-as the default or for the current session via the <em>Options menu</em>,
-then hypertext links which have visible link names are prefixed with
-numbers in square brackets.  Entering a keyboard or keypad number is
-treated as an <em>F_LINK_NUM</em> command, and should invoke the
-<em>Follow link (or goto link or page) number:</em> statusline prompt for
-a potentially multiple digit number corresponding to an indicated link
+or <em>Links and form fields are numbered</em> as the default or for
+the current session via the <em>Options menu</em>, then hypertext links
+(and form fields, depending on the keypad mode)
+are prefixed with numbers in square brackets.  Entering a keyboard
+or keypad number is treated as an <em>F_LINK_NUM</em> command, and should
+invoke the <em>Follow link (or goto link or page) number:</em> statusline 
+prompt for a
+potentially multiple digit number corresponding to an indicated link
 number.  If RETURN is pressed to terminate the number entry (e.g.,
-<em>123</em>), Lynx will retrieve the document for that link as if you
-had paged or used other navigation commands to make it the current link
-and then ACTIVATE-ed it.  The prompt can be invoked via <em>0</em>,
-but it will not be treated as the lead digit for the number entry,
-whereas <em>1</em> through <em>9</em> both invoke the prompt and are
-treated as the first digit.
+<em>123</em>) and it corresponds to a hypertext link, Lynx will retrieve
+the document for that link as if you had paged or used other navigation
+commands to make it the current link and then ACTIVATE-ed it.  The prompt
+can be invoked via '<em>0</em>', but it will not be treated as the lead
+digit for the number entry, whereas '<em>1</em>' through '<em>9</em>' both
+invoke the prompt and are treated as the first digit.  In <em>Links and
+form fields are numbered</em> mode, if the number corresponds to a form
+field you will be positioned on that field, but if it is a submit button
+it will not be ACTIVATE-ed.
 
 <p>If the number entered at the prompt has a '<em>g</em>' suffix (e.g.,
 <em>123g</em>), then Lynx will make the link corresponding to that number
 the current link, paging as appropriate if the link does not appear in
-the currently displayed page.  Alternatively, if the number is given a
-'<em>p</em>' suffix (e.g., <em>123p</em>), Lynx will make the page
-corresponding to that number the currently displayed page, and the first
-link on that page, if any, the current link.  The '<em>g</em>' and
-'<em>p</em>' suffixes thus convert the 
-<em>Follow link (or goto link or page) number:</em>
-feature to an advanced navigation aid.
+the currently displayed page.  The '<em>g</em>' suffix is implied (need
+not be entered) for form fields in <em>Links and form fields are
+numbered</em> mode.
 
-<p>If the user has set <em>Keypad mode</em> to <em>Numbers as arrows</em>,
+<p>Alternatively, if the number is given a '<em>p</em>' suffix (e.g.,
+<em>123p</em>), Lynx will make the page corresponding to that number
+the currently displayed page, and the first link on that page, if any,
+the current link.  The '<em>g</em>' and '<em>p</em>' suffixes thus
+convert the 
+<em>Follow link (or goto link or page) number:</em> feature to an advanced
+navigation aid.
+
+<p>If the user has set <em>Keypad mode</em> to <em>Numbers act as arrows</em>,
 then only '<em>0</em>', rather than every number, will be treated as an
 <em>F_LINK_NUM</em> command for invoking the <em>Follow link (or goto link or page)
 number:</em> prompt.  The '<em>0</em>' will not be treated as the first
 digit for the number, or number plus suffix, entry.
 
+<p>Numbers are associated with form fields only when <em>Links and form
+fields are numbered</em> mode has been selected.  If you have selected
+<em>Numbers act as arrows</em> or <em>Links are numbered</em> mode, you
+can seek form fields in the document via WHEREIS searches for strings in
+their displayed values.  If they are INPUT or TEXTAREA fields with no
+values as yet, you can use two or more underscores as the search string,
+because underscores are used as placeholders for form fields in the
+displayed document.
+
+<p ID="select-option">When you have invoked a popup window for a list of
+OPTIONs in a form's SELECT block, each OPTION is associated with a number,
+and that number will be displayed in <em>Links and form fields are
+numbered</em> mode.  In any keypad mode, the <em>F_LINK_NUM</em>
+('<em>0</em>') command will invoke a <em>Select option (or page)
+number:</em> prompt, and you can enter a number, and optionally a
+'<em>g</em>' or '<em>p</em>' suffix, to select or seek an OPTION in that
+list.  If only an number is entered at the prompt, the corresponding OPTION
+will be selected and the popup will be retracted.  If the '<em>g</em>'
+suffix is included, then you will be positioned on the corresponding OPTION
+in the list, paging through the list if necessary, but it will not be
+treated as selected unless you enter the ACTIVATE (RETURN or right-arrow)
+command when positioned on the OPTION.  For purposes of paging (e.g., in
+conjunction with the '<em>p</em>' suffix), a <em>page</em> is defined as
+the number of OPTIONs displayed within the vertical dimension of the popup
+window.
+
 <p>Note that HTML can be structured so that it includes <em>hidden
 links</em>, i.e., without a visible link name intended for ACTIVATE-ing
 the link.  Such links may be created, for example, by making an IMG element
@@ -81,5 +117,16 @@ for SRC attritute values of IMG elements, because this indicates that the
 user does have some form of image handling enabled via a helper application, 
 or wishes to download files for subsequent use with a graphic browsers or
 other suitable software.
+
+<p>HTML forms also can have fields with a HIDDEN attribute, indicating that
+a name/value pair for the fields should be included in the content submitted
+for the form, but the value should not be displayed in the rendered form.
+Lynx respects this attribute as well, and neither displays the HIDDEN field,
+nor assigns it a number for the F_LINK_NUM ('<em>0</em>') command and
+<em>Links and form fields are numbered</em> keypad mode handling, nor
+includes an entry for it in the menu created for the LIST ('<em>l</em>')
+command.  However, the HIDDEN name/value pairs are included in any displays
+of submitted form content in the <em>Information about the current
+document</em> that is invoked by the INFO ('<em>=</em>') command.
 </BODY>
 </HTML>
diff --git a/lynx_help/keystroke_commands/keystroke_help.html b/lynx_help/keystroke_commands/keystroke_help.html
index 6c10aa58..dc6740ce 100644
--- a/lynx_help/keystroke_commands/keystroke_help.html
+++ b/lynx_help/keystroke_commands/keystroke_help.html
@@ -90,7 +90,11 @@
 	       			>Cookie Jar Page</A>
                numbers        - Invoke the prompt 
 				<a href="follow_help.html"
-				>Follow link (or goto link or page) number:</a>
+	                          >Follow link (or goto link or page) number:</a>
+                                  or the
+                                  <a href="follow_help.html#select-option"
+	                          >Select option (or page) number:</a>
+                                prompt
 </PRE>
 </BODY>
 </HTML>
diff --git a/lynx_help/keystroke_commands/option_help.html b/lynx_help/keystroke_commands/option_help.html
index b601b939..f3023275 100644
--- a/lynx_help/keystroke_commands/option_help.html
+++ b/lynx_help/keystroke_commands/option_help.html
@@ -63,29 +63,31 @@
 
      Display Character  -  This option allows you to set up the default
      set                   character set for your specific terminal.
-                           The character set provides a mapping of 8-bit
-                           ISO Latin character entities and/or Asian (CJK)
-                           characters into viewable characters and should
-                           be set in relation to your terminal's character
-                           set if you will be viewing such characters with
-                           Lynx.  You must have the selected character set
-                           installed on your terminal.
+                           The character set provides a mapping of 8-bit ISO
+                           Latin character entities and/or Asian (CJK) or
+                           UTF-8 characters into viewable characters and
+                           should be set in relation to your terminal's
+                           character set if you will be viewing such
+                           characters with Lynx.  You must have the selected
+                           character set installed on your terminal.
 
      Raw 8-bit or CJK   -  Toggles whether 8-bit characters are assumed to
      mode                  correspond with the selected character set and
                            therefore are processed without translation via
-                           the ISO Latin 1 conversion tables.  Should be
-	                   ON by default when the selected character set is
-                           ISO Latin 1, or is one of the Asian (CJK) sets
-                           and the 8-bit characters are Kanji multibytes.
-                           Should be OFF for the other character sets, but
-                           can be turned ON when there's a match, e.g., the
-                           document's charset is ISO-8859-2 and ISO Latin 2
-                           has been selected.  Should be OFF when an Asian
-                           (CJK) set is selected but the document is
-                           ISO-8850-1.  The setting also can be toggled via
-                           the RAW_TOGGLE command, normally mapped to '@',
-                           and at startup via the -raw switch.
+                           the chartrans conversion tables.  Should be ON
+                           by default when the selected character set is one
+                           of the Asian (CJK) sets and the 8-bit characters
+                           are Kanji multibytes.  Should be OFF for the other
+                           character sets, but can be turned ON when the
+                           document's charset is unknown (e.g., is not
+                           ISO-8859-1 and no charset parameter was included in
+                           a reply header from an HTTP server to indicate what
+                           it is) but you know by some means that you have the
+                           matching display character set selected.  Should be
+                           OFF when an Asian (CJK) set is selected but the
+                           document is ISO-8850-1.  The setting also can be
+                           toggled via the RAW_TOGGLE command, normally mapped
+                           to '@', and at startup via the -raw switch.
 
      Preferred Document -  The language you prefer if multi-language files are
      Language              available from servers.  Use MIME abbreviations,
@@ -131,7 +133,20 @@
                            MULTIPLE attribute specified, the OPTIONs always
                            are rendered as a list of checkboxes.
 
-     Keypad mode  -        This option gives the choice between navigating 
+     Show cursor for   -   Lynx normally hides the cursor by positioning it
+     current link or       to the right and if possible the very bottom of
+     option                the screen, so that the current link or OPTION
+                           is indicated solely by its highlighting or color.
+                           If show cursor is set to ON, the cursor will be
+	                   positioned at the left of the current link or
+                           OPTION.  This is helpful when Lynx is being used
+                           with a speech or braille interface.  It also is
+                           useful for sighted users when the terminal cannot
+                           distinguish the character attributes used to
+                           distinguish the current link or OPTION from the
+                           others in the screen display.
+
+     Keypad mode       -   This option gives the choice between navigating 
                            with the keypad (as arrows; see Lynx Navigation)
                            and having every link numbered (numbered links)
 			   so that the links may be selected by numbers
@@ -164,7 +179,7 @@
                            Advanced 
                               The URL is shown on the statusline. 
 
-      User Agent        -  The header string which Lynx sends to servers
+      User Agent       -   The header string which Lynx sends to servers
                            to indicate the User-Agent is displayed here.
                            Changes may be disallowed via the -restrictions
                            switch.  Otherwise, the header can be changed
diff --git a/lynx_help/keystroke_commands/other_help.html b/lynx_help/keystroke_commands/other_help.html
index a62320c1..064fe852 100644
--- a/lynx_help/keystroke_commands/other_help.html
+++ b/lynx_help/keystroke_commands/other_help.html
@@ -141,6 +141,14 @@
        ;      - Views the Lynx Trace Log for the current session.
 
      CTRL-K   - Invokes the Cookie Jar Page.
+
+     numbers  - Lynx offers other, advanced navigation features when
+                numbers are used to invoke the
+                  <a href="follow_help.html"
+                  >Follow link (or goto link or page) number:</a> or
+                  <a href="follow_help.html#select-option"
+		  >Select option (or page) number:</a>
+                prompts.
 </PRE>
 </BODY>
 </HTML>
diff --git a/lynx_help/lynx_help_main.html b/lynx_help/lynx_help_main.html
index 94af6f80..762d058d 100644
--- a/lynx_help/lynx_help_main.html
+++ b/lynx_help/lynx_help_main.html
@@ -39,6 +39,8 @@ href="http://www.w3.org/pub/WWW/MarkUp/html-spec/html-spec_toc.html"
 >HTML i18n</a>
 | <a href="http://www.w3.org/pub/WWW/MarkUp/"
 >HTML 3.2</a>
+| <a href="http://www.w3.org/TR/WD-html40/"
+>HTML 4.0</a>
 
 <ul plain>
 <li><a href="http://www.stonehand.com/doc/"