diff options
Diffstat (limited to 'lynx_help/Lynx_users_guide.html')
-rw-r--r-- | lynx_help/Lynx_users_guide.html | 236 |
1 files changed, 141 insertions, 95 deletions
diff --git a/lynx_help/Lynx_users_guide.html b/lynx_help/Lynx_users_guide.html index b7fba2dc..b703bfaa 100644 --- a/lynx_help/Lynx_users_guide.html +++ b/lynx_help/Lynx_users_guide.html @@ -1,10 +1,10 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> -<!-- $LynxId: Lynx_users_guide.html,v 1.116 2012/01/31 23:55:11 tom Exp $ --> +<!-- $LynxId: Lynx_users_guide.html,v 1.118 2013/05/22 00:56:39 tom Exp $ --> +<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"> <html> <head> <meta name="generator" content= - "HTML Tidy for Linux/x86 (vers 6 November 2007), see www.w3.org"> + "HTML Tidy for Linux (vers 25 March 2009), see www.w3.org"> <title>Lynx Users Guide v2.8.7</title> <link rev="made" href="mailto:lynx-dev@nongnu.org"> @@ -318,12 +318,14 @@ <dd>is a scheme-specific field which for some schemes may correspond to a directory path and/or filename.</dd> - </dl>Here are some sample URLs. + </dl> + + <p>Here are some sample URLs.</p> <dl> <dt>HTTP (HyperText Transfer Protocol)</dt> - <dd><code>http://www.subir.com/lynx.html</code></dd> + <dd><code>http://lynx.isc.org</code></dd> <dt>Gopher</dt> @@ -342,17 +344,21 @@ <dd><code>lynx http://kufacts.cc.ukans.edu/cwis/kufacts_start.html</code></dd> - </dl>Lynx also will attempt to create a complete URL if you - include adequate portions of it in the startfile argument. For - example:<br> + </dl> + + <p>Lynx also will attempt to create a complete URL if you include + adequate portions of it in the startfile argument. For + example:<br></p> <pre> 1234.6789.1234.6789.1234.6789.1234.6789.1234.6789.1234.6789.1234.6789.1234.6789 <em>wfbr</em> will be expanded to: <em>http://www.wfbr.edu/</em> and: <em>ftp.more.net/pub</em> will be expanded to: <em>ftp://ftp.more.net/pub</em> -</pre>See <a href="lynx_url_support.html">URL Schemes Supported by -Lynx</a> for more detailed information. +</pre> + + <p>See <a href="lynx_url_support.html">URL Schemes Supported by + Lynx</a> for more detailed information.</p> <p>[<a href="#ToC-Remote">ToC</a>]</p> @@ -385,8 +391,10 @@ Lynx</a> for more detailed information. <dd><code>WWW_HOME=http://www.w3.org/ [or in registry]</code></dd> - </dl>Note that on VMS the double-quoting <em>must</em> be - included to preserve casing. + </dl> + + <p>Note that on VMS the double-quoting <em>must</em> be included + to preserve casing.</p> <p>[<a href="#ToC-EnVar">ToC</a>]</p> @@ -412,29 +420,32 @@ Lynx</a> for more detailed information. |<-- prev | next | | sel. -->| | of | | | DOWN | | doc. | link \|/| link | | text 1| \|/ 2| 3| +---------+---------+---------+ +-------+-------+-------+ -</pre>There are also a few other keyboard commands to aid in -navigation. The Control and Function keys used for navigation -within the current document are described in <a href= -"#MiscKeys"><em>Scrolling and Other useful commands</em></a>. Some -additional commands depend on the fact that Lynx keeps a list of -each link you visited to reach the current document, called the -<a href="keystrokes/history_help.html">History Page</a>, and a list -of all links visited during the current Lynx session, called the -<a href="keystrokes/visited_help.html">Visited Links Page</a>. The -HISTORY keystroke command, normally mapped to <em>Backspace</em> or -<em>Delete</em>, will show you the <em>History Page</em> of links -leading to your access of the current document. Any of the previous -documents shown in the list may be revisited by selecting them from -the history screen. The VLINKS keystroke command, normally mapped -to uppercase '<em>V</em>', will show the <em>Visited Links -Page</em>, and you similarly can select links in that list. The -MAIN_MENU keystroke command, normally mapped to '<em>m</em>' and -'<em>M</em>', will take you back to the starting document unless -you specified the <em>-homepage=URL</em> option at the command -line. Also, the LIST and ADDRLIST keystroke commands, normally -mapped to '<em>l</em>' and <em>A</em>' respectively, will create a -compact lists of all the links in the current document, and they -can be selected via those lists. +</pre> + + <p>There are also a few other keyboard commands to aid in + navigation. The Control and Function keys used for navigation + within the current document are described in <a href= + "#MiscKeys"><em>Scrolling and Other useful commands</em></a>. + Some additional commands depend on the fact that Lynx keeps a + list of each link you visited to reach the current document, + called the <a href="keystrokes/history_help.html">History + Page</a>, and a list of all links visited during the current Lynx + session, called the <a href= + "keystrokes/visited_help.html">Visited Links Page</a>. The + HISTORY keystroke command, normally mapped to <em>Backspace</em> + or <em>Delete</em>, will show you the <em>History Page</em> of + links leading to your access of the current document. Any of the + previous documents shown in the list may be revisited by + selecting them from the history screen. The VLINKS keystroke + command, normally mapped to uppercase '<em>V</em>', will show the + <em>Visited Links Page</em>, and you similarly can select links + in that list. The MAIN_MENU keystroke command, normally mapped to + '<em>m</em>' and '<em>M</em>', will take you back to the starting + document unless you specified the <em>-homepage=URL</em> option + at the command line. Also, the LIST and ADDRLIST keystroke + commands, normally mapped to '<em>l</em>' and <em>A</em>' + respectively, will create a compact lists of all the links in the + current document, and they can be selected via those lists.</p> <p>The '<em>i</em>' key presents an index of documents. The default index offered contains many useful links, but can be @@ -521,14 +532,16 @@ can be selected via those lists. <dd><code>lynx file://localhost/FULL/PATH/FILENAME</code></dd> <dd><code>lynx path/filename.html</code></dd> - </dl>In addition, the user must also specify an editor in the + </dl> + + <p>In addition, the user must also specify an editor in the <em>Options Menu</em> so that Lynx knows which editor to use. If the file is specified correctly and an editor is defined, then you may edit documents by using the '<em>e</em>' command. When the '<em>e</em>' command is entered your specified editor is spawned to edit the file. After changes are completed, exit your editor and you will return to Lynx. Lynx will reload and render - the file so that changes can be immediately examined. + the file so that changes can be immediately examined.</p> <p>[<a href="#ToC-LocalSource">ToC</a>]</p> @@ -556,11 +569,14 @@ can be selected via those lists. will be that Lynx optionally puts</p> <blockquote> - <!--X-URL: http://www.site.foo/path/to/file.html --><br> - <BASE href="http://www.site.foo/path/to/file.html"> - </blockquote>at the start of the file so that relative URLs in - the document will still work. Even this modification can be - prevented by setting PREPEND_BASE_TO_SOURCE:FALSE in lynx.cfg. + <p><!--X-URL: http://www.site.foo/path/to/file.html + --><br> + <BASE href="http://www.site.foo/path/to/file.html"></p> + </blockquote> + + <p>at the start of the file so that relative URLs in the document + will still work. Even this modification can be prevented by + setting PREPEND_BASE_TO_SOURCE:FALSE in lynx.cfg.</p> <p>Some options, such as <em>Save to disk</em>, involve prompting for an output filename. All output filename entries are saved in @@ -643,8 +659,10 @@ can be selected via those lists. <pre> <em><ISINDEX PROMPT="Enter WAIS query:" HREF="wais://net.bio.net/biologists-addresses"></em> -</pre>for submitting a search of the Biologist's Addresses database -directly to the net.bio.net WAIS server. +</pre> + + <p>for submitting a search of the Biologist's Addresses database + directly to the net.bio.net WAIS server.</p> <p>[<a href="#ToC-Search">ToC</a>]</p> @@ -663,7 +681,6 @@ directly to the net.bio.net WAIS server. generated at runtime, in which the user fills in choices as in any ordinary HTML form.</p> <pre> - Options Menu (Lynx Version 2.8.7rel.1) Accept Changes - Reset Changes Left Arrow cancels changes <a href="keystrokes/option_help.html">HELP!</a> @@ -746,7 +763,6 @@ directly to the net.bio.net WAIS server. accessed by setting FORMS_OPTIONS to TRUE in <a href= "#lynx.cfg">lynx.cfg</a>.</p> <pre> - Options Menu (Lynx Version 2.8.7rel.1) (E)ditor : emacs @@ -767,15 +783,18 @@ directly to the net.bio.net WAIS server. (U)ser mode : Advanced verbose images (!) : ON user (A)gent : [User-Agent header] local e(X)ecution links : FOR LOCAL FILES ONLY -</pre>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="keystrokes/edit_help.html">Line -Editor</a> can be used to correct mistakes, and <em>Control-U</em> -can be used to erase the line. When you are done entering a change -press the <em>Return</em> key to get back to the <em>Command?</em> -prompt. +</pre> + + <p>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= + "keystrokes/edit_help.html">Line Editor</a> can be used to + correct mistakes, and <em>Control-U</em> can be used to erase the + line. When you are done entering a change press the + <em>Return</em> key to get back to the <em>Command?</em> + prompt.</p> <p>For fields where you must choose one of two choices, press any key to toggle the choices and press the <em>Return</em> key to @@ -1470,12 +1489,14 @@ prompt. <LINK REV="made" HREF="mailto:user@somedomain.com"> … </HEAD> -</pre>You may also add a TITLE attribute with, for example, the -name of your page) If no ownership is specified then comments are -disabled. Certain links called <a href= -"lynx_url_support.html#mailto_url">mailto:</a> links will also -allow you to send mail to other people. Using the mail features -within Lynx is straightforward. +</pre> + + <p>You may also add a TITLE attribute with, for example, the name + of your page) If no ownership is specified then comments are + disabled. Certain links called <a href= + "lynx_url_support.html#mailto_url">mailto:</a> links will also + allow you to send mail to other people. Using the mail features + within Lynx is straightforward.</p> <p>Once you have decided to send a comment or have selected a <em>mailto:</em> link a new screen will appear showing you to @@ -1536,8 +1557,10 @@ within Lynx is straightforward. information about the URL schemes for posting or sending followups (replies) to nntp servers with Lynx. [<a href= "#ToC-News">ToC</a>]</dd> - </dl>See also <a href= - "http://www.w3.org/Protocols/rfc977/rfc977">RFC 977</a>. + </dl> + + <p>See also <a href= + "http://www.w3.org/Protocols/rfc977/rfc977">RFC 977</a>.</p> <h2 id="id-Bookmarks"><a name="Bookmarks" id="Bookmarks"><em>Lynx bookmarks</em></a></h2> @@ -1554,11 +1577,14 @@ within Lynx is straightforward. asked:</p> <blockquote> - Save D)ocument or L)ink to bookmark file or C)ancel? (d,l,c): - </blockquote>Answer '<em>d</em>' to save a link to the document - you are currently viewing or '<em>l</em>' to save the link that - is currently selected on the page. Selecting '<em>c</em>' will - cancel without saving anything to your bookmark file. + <p>Save D)ocument or L)ink to bookmark file or C)ancel? + (d,l,c):</p> + </blockquote> + + <p>Answer '<em>d</em>' to save a link to the document you are + currently viewing or '<em>l</em>' to save the link that is + currently selected on the page. Selecting '<em>c</em>' will + cancel without saving anything to your bookmark file.</p> <p>A bookmark file will be created in conjunction with acting on the '<em>a</em>'dd command if it does not already exist. @@ -2096,9 +2122,11 @@ within Lynx is straightforward. to use, it might for example say <pre> <strong>(Textarea) Enter text. </strong>[ ..... ]<strong> (^Xe for editor).</strong> -</pre>An external editor has to be defined, for example in the -<a href="#InteractiveOptions">Options Menu</a>, before you can -start using this function. +</pre> + + <p>An external editor has to be defined, for example in the + <a href="#InteractiveOptions">Options Menu</a>, before you + can start using this function.</p> <p>A key to invoke external TEXTAREA editing is normally provided by the <a href= @@ -2156,11 +2184,13 @@ start using this function. which libraries are used, and behavior of the connection and terminal type).</p> </dd> - </dl>In general, you can move around the form using the standard + </dl> + + <p>In general, you can move around the form using the standard Lynx navigation keys. The <em>up-arrow</em> and <em>down-arrow</em> keys, respectively, select the previous or next field, box, or button. The <em>TAB</em> key selects the next - field, box, or button. + field, box, or button.</p> <p>To <a name="submit" id="submit"><em>submit</em></a> the form press <em>right-arrow</em> or <em>Return</em> when positioned on @@ -2177,8 +2207,10 @@ start using this function. <pre> <em><META HTTP-EQUIV="Pragma" CONTENT="no-cache"></em> <em><META HTTP-EQUIV="Cache-Control" CONTENT="no-cache"></em> -</pre>or the server sent a "Pragma" or "Cache-Control" MIME header -with a no-cache directive. +</pre> + + <p>or the server sent a "Pragma" or "Cache-Control" MIME header + with a no-cache directive.</p> <p>You also can use the DOWNLOAD ('<em>d</em>') keystroke command when positioned on a form submit button if you wish to download @@ -2417,7 +2449,9 @@ the other two cannot be saved between sessions. <li>Most attributes are ignored, including borders, <code>WIDTH</code>, vertical alignment.</li> - </ul>Horizontal alignments (<code>LEFT</code>, + </ul> + + <p>Horizontal alignments (<code>LEFT</code>, <code>CENTER</code>, <code>RIGHT</code>), <code>COLSPAN</code>, and <code>ROWSPAN</code> are interpreted according to HTML 4.01. (<code>ROWSPAN</code> can only reserve empty space in @@ -2431,7 +2465,7 @@ the other two cannot be saved between sessions. within table cells) and not essential for understanding the textual contents, it remains basically ignored. Some more information on details is available in the file - <kbd>README.TRST</kbd> of the source distribution. + <kbd>README.TRST</kbd> of the source distribution.</p> </div> <p>For tabular display of more complex tables, Lynx users can @@ -2601,8 +2635,10 @@ the other two cannot be saved between sessions. <pre> See the <em><A HREF="#fn1"></em><a href= "#an1">footnote</a><em></A></em>. -</pre>activating that link will take you to the labeled rendering -of: +</pre> + + <p>activating that link will take you to the labeled rendering + of:</p> <pre> <em><FN ID="fn1"></em><p><a name="an1" id= "an1">Lynx does not use popups for FN blocks.</a></p><em></FN></em> @@ -2640,9 +2676,11 @@ of: <em><NOTE CLASS="warning" ID="too-bad"> <p>The W3C vendors did not retain NOTE in the HTML 3.2 draft.</p> </NOTE></em> -</pre>It will <em>degrade gracefully</em> for WWW browsers which do -not support NOTE, except for recognition of the ID attribute as a -named <em>A</em>nchor. +</pre> + + <p>It will <em>degrade gracefully</em> for WWW browsers which do + not support NOTE, except for recognition of the ID attribute as a + named <em>A</em>nchor.</p> <p>[<a href="#ToC-Notes">ToC</a>]</p> @@ -2854,11 +2892,13 @@ named <em>A</em>nchor. <em>client-side-pull</em>. An example of such an element is:</p> <pre> <em><META HTTP-EQUIV="Refresh" CONTENT="3; URL=http://host/path"></em> -</pre>which instructs a client to fetch the indicated URL in 3 -seconds after receiving the current document. If the <em>URL=</em> -field is omitted, the URL defaults to that of the current document. -A <em>no-cache</em> directive is implied when the <em>Refresh</em> -if for the same URL. +</pre> + + <p>which instructs a client to fetch the indicated URL in 3 + seconds after receiving the current document. If the + <em>URL=</em> field is omitted, the URL defaults to that of the + current document. A <em>no-cache</em> directive is implied when + the <em>Refresh</em> if for the same URL.</p> <p>Lynx recognizes and processes <em>Refresh</em> directives in META elements, but puts up a labeled link, typically in the upper @@ -3079,7 +3119,9 @@ if for the same URL. <dd><code>lynx [options]</code></dd> <dd><code>lynx [options] startfile</code></dd> - </dl>where + </dl> + + <p>where</p> <dl> <dt><code>startfile</code></dt> @@ -3129,9 +3171,11 @@ if for the same URL. -center:off -center=off -center-</code> -</pre>Lynx recognizes "1", "+", "on" and "true" for true values, -and "0", "-", "off" and "false" for false values. Other -option-values are ignored. +</pre> + + <p>Lynx recognizes "1", "+", "on" and "true" for true values, + and "0", "-", "off" and "false" for false values. Other + option-values are ignored.</p> <p>The default boolean, number and string option values that are compiled into lynx are displayed in the help-message @@ -4006,10 +4050,12 @@ option-values are ignored. <tt> lynx -source . >foo.html </tt> -</pre>generates HTML source listing the files in the current -directory. Each file is marked by an HREF relative to the parent -directory. Add a trailing slash to make the HREF's relative to the -current directory: +</pre> + + <p>generates HTML source listing the files in the current + directory. Each file is marked by an HREF relative to the + parent directory. Add a trailing slash to make the HREF's + relative to the current directory:</p> <pre> <tt> lynx -source ./ >foo.html |