<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
<!-- $LynxId: follow_help.html,v 1.10 2012/01/31 23:16:38 tom Exp $ -->
<html>
<head>
<meta name="generator" content=
"HTML Tidy for Linux/x86 (vers 6 November 2007), see www.w3.org">
<title>Help on the Follow link (or page) number feature</title>
<link rev="made" href="mailto:lynx-dev@nongnu.org">
<meta http-equiv="Content-Type" content=
"text/html; charset=us-ascii">
</head>
<body>
<h1>Follow link (or goto link or page) number Help<br>
Select option (or page) number Help</h1>
<p>If a user has set <em>Keypad mode</em> to <em>Links are
numbered</em>, or <em>Form fields are numbered</em>, 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>) 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>Form fields are numbered</em>
or <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>
<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. The
'<em>g</em>' suffix is inferred (need not be entered) for form
fields in <em>Form fields are numbered</em> or <em>Links and form
fields are numbered</em> mode.</p>
<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>
<p>Finally, a user may add a <em>+</em> or <em>-</em> suffix to a
number command to indicate jumping forward or back relative to
the current link or page. For example, typing <em>1g+</em>
followed by RETURN will move the current link to the next
numbered link, skipping any intervening pages or unnumbered
links; <em>1g-</em> goes to the preceding numbered link. On a
page without links, <em>3g+</em> goes to the 3rd link
<em>following</em> the page. <em>5p+</em> skips ahead 5 pages,
and so on. You can also enter <em>5+</em> or <em>5-</em>, which
will activate the 5th link ahead/behind where you are currently
positioned. Note that typing <em>1g+</em> is different from
typing a down arrow in that <em>1g+</em> skips pages containing
no links, or intervening non-numbered links, such as form fields
when form fields are not numbered. It also differs from the
<em><tab></em> command in that <em>1g+</em> does not skip
over whole textareas, unless form fields are not numbered.</p>
<p><em>NOTE:</em> <em>1+g 1-g 1+p 1-p</em> are all recognized as
equivalent to <em>1g+ 1g- 1p+ 1p-</em> . Any other (mistyped)
characters end the formula: e.g. <em>1gh+</em> is treated as
<em>1g</em>.</p>
<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>
<p>Numbers are associated with form fields only when <em>Form
fields are numbered</em> or <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>
<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>Form fields are numbered</em> or <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 a
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. Finally, the <em>+</em> and
<em>-</em> suffixes can be used to move forward or back from the
current option or page in a popup menu, similarly to the way they
are used for links For example, while viewing a popup window, the
user can type <em>3p+</em> and RETURN to skip ahead 3 pages, and
<em>50g-</em> will move the current selection back 50 options.
This will work whether or not <em>keypad mode</em> is <em>Form
fields are numbered</em> or <em>Links and form fields are
numbered</em> since options are numbered internally. If form
field numbering is turned off, the option numbers won't appear on
screen, but the user can still navigate using these commands.</p>
<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 the sole content of an Anchor
element, and including an ALT="" attribute name/value pair to
suppress access to the link when the browser does not have
support for image handling available. They also can be created by
having truly empty Anchor content, in cases for which the value
of an Anchor's HREF attribute is intended as a navigation aid for
robots (typically indexers) and not as content for a browser's
rendition of the document. With the <em>-ismap</em> command line
switch, Lynx will additionally treat a link to a server-side
image maps as hidden if there also is a client-side map for the
same image. Finally, in some cases links that are not intended to
be hidden may effectively become <em>hidden links</em> because of
bad HTML. The <em>hidden links</em> differ from Anchors that have
only a NAME or ID attribute name/value pair (intended as
positioning targets from other links which do have HREF
attributes and values that include a fragment).</p>
<p>Lynx respects instructions for <em>hidden links</em> and
normally does not include them in the rendition of the document.
However, if the command line switch <em>-hiddenlinks=merge</em>
is used, such links will still be numbered in sequence with other
links which are not hidden, and if <em>Links are numbered</em>
mode is also on, link numbers will appear for them in the
displayed text (except for links to image maps which are hidden
because of <em>-ismap</em>). If <em>-hiddenlinks=listonly</em> or
<em>-hiddenlinks=ignore</em> is in effect, <em>hidden links</em>
will not be shown in the text even in <em>links are numbered</em>
mode. Not using a <em>-hiddenlinks</em> flag at all is equivalent
to <em>-hiddenlinks=listonly</em>.</p>
<p>If a document includes <em>hidden links</em>, they will be
reported, with appropriate labeling, in the menus created for the
LIST ('<em>l</em>') or ADDRLIST ('<em>A</em>') commands, unless
<em>-hiddenlinks=ignore</em> is used. They can then be
ACTIVATE-ed via those menus. Also, if a link was hidden because
of an ALT attribute in an IMG element, it will be converted to a
<em>visible link</em> whenever the IMAGE_TOGGLE ('<em>*</em>')
command is used to create links for SRC attribute 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
browser or other suitable software.</p>
<p>HTML forms also may 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>Form fields are numbered</em> or <em>Links and form fields
are numbered</em> keypad mode handling, nor includes an entry for
it in the menus created for the LIST ('<em>l</em>') or ADDRLIST
('<em>A</em>') commands. 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.</p>
</body>
</html>