about summary refs log tree commit diff stats
path: root/lynx_help/keystroke_commands
diff options
context:
space:
mode:
Diffstat (limited to 'lynx_help/keystroke_commands')
-rw-r--r--lynx_help/keystroke_commands/follow_help.html89
-rw-r--r--lynx_help/keystroke_commands/keystroke_help.html6
-rw-r--r--lynx_help/keystroke_commands/option_help.html57
-rw-r--r--lynx_help/keystroke_commands/other_help.html8
4 files changed, 117 insertions, 43 deletions
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>