diff options
| author | Thomas E. Dickey <dickey@invisible-island.net> | 1999-09-29 11:47:35 -0400 |
|---|---|---|
| committer | Thomas E. Dickey <dickey@invisible-island.net> | 1999-09-29 11:47:35 -0400 |
| commit | 95586cc28c61df18b7a2cd2a9b3ee4c4c83aa583 (patch) | |
| tree | 292eb191b3e53e39d8be1e1e546104122fbf1cfa /lynx_help | |
| parent | 2b52e9e64b2fc32242c207a0784521b2cf6d1976 (diff) | |
| download | lynx-snapshots-95586cc28c61df18b7a2cd2a9b3ee4c4c83aa583.tar.gz | |
snapshot of project "lynx", label v2-8-3dev_10
Diffstat (limited to 'lynx_help')
| -rw-r--r-- | lynx_help/Lynx_users_guide.html | 1985 | ||||
| -rw-r--r-- | lynx_help/keystrokes/bashlike_edit_help.html | 4 | ||||
| -rw-r--r-- | lynx_help/keystrokes/dired_help.html | 50 | ||||
| -rw-r--r-- | lynx_help/keystrokes/environments.html | 14 | ||||
| -rw-r--r-- | lynx_help/keystrokes/gopher_types_help.html | 2 | ||||
| -rw-r--r-- | lynx_help/keystrokes/keystroke_help.html | 88 | ||||
| -rw-r--r-- | lynx_help/keystrokes/movement_help.html | 6 | ||||
| -rw-r--r-- | lynx_help/keystrokes/other_help.html | 124 | ||||
| -rw-r--r-- | lynx_help/keystrokes/scrolling_help.html | 2 | ||||
| -rw-r--r-- | lynx_help/keystrokes/xterm_help.html | 2 | ||||
| -rw-r--r-- | lynx_help/lynx_url_support.html | 213 |
11 files changed, 1264 insertions, 1226 deletions
diff --git a/lynx_help/Lynx_users_guide.html b/lynx_help/Lynx_users_guide.html index 94f264c2..016a9fdf 100644 --- a/lynx_help/Lynx_users_guide.html +++ b/lynx_help/Lynx_users_guide.html @@ -85,7 +85,7 @@ the '<em>k</em>' key if vi-like key movement is not on). <h2 ID="Local"><A NAME="Local"><em>Viewing local files with Lynx</em></A></h2> Lynx can be started by entering the Lynx command along with -the name of a file to display. For example these commands could +the name of a file to display. For example these commands could all be used to display an arbitrary ASCII text or HTML file: <dl> @@ -119,7 +119,7 @@ Language</em> (<em>HTML</em>), if the file's name ends with the characters <em>.html</em>, <em>.htm</em>, <em>.shtml</em>, <em>.htmlx</em>, <em>.html3</em>, or <em>.ht3</em>. HTML is a file format that allows users to create a file that contains (among other things) hypertext links to other -files. Several files linked together may be described as a +files. Several files linked together may be described as a <em>hypertext document</em>. If the filename does not have one of the suffixes mapped by Lynx to HTML, the <em>-force_html</em> command line option can be included to force treatment of the file as hypertext. @@ -182,34 +182,34 @@ general form: <dl> <dt><code>PROTOCOL</code> - <dd>identifies the communications protocol (<em>scheme</em>) used - by the server that will provide the file. As mentioned earlier, - Lynx (and any WWW client) can interact with a variety of servers, - each with its own protocol. + <dd>identifies the communications protocol (<em>scheme</em>) used + by the server that will provide the file. As mentioned earlier, + Lynx (and any WWW client) can interact with a variety of servers, + each with its own protocol. <dt><code>HOST</code> - <dd>is the Internet address of the computer system on which the - server is running, and + <dd>is the Internet address of the computer system on which the + server is running, and <dt><code>PATH</code> - <dd>is a scheme-specific field which for some schemes may - correspond to a directory path and/or filename. + <dd>is a scheme-specific field which for some schemes may + correspond to a directory path and/or filename. </dl> Here are some sample URLs. <dl> <dt>HTTP (HyperText Transfer Protocol) - <dd><code>http://www.crl.com/~subir/lynx.html</code> + <dd><code>http://www.crl.com/~subir/lynx.html</code> <dt>Gopher - <dd><code>gopher://gopher.micro.umn.edu/11/</code> + <dd><code>gopher://gopher.micro.umn.edu/11/</code> <dt>FTP (File Transfer Protocol) - <dd><code>ftp://ftp2.cc.ukans.edu/pub/lynx/README</code> + <dd><code>ftp://ftp2.cc.ukans.edu/pub/lynx/README</code> <dt>WAIS (Wide Area Information Service protocol) - <dd><code>wais://cnidr.org/directory-of-servers</code> + <dd><code>wais://cnidr.org/directory-of-servers</code> <dt>A URL may be specified to Lynx on the command line, as in: <dd><code>lynx http://kufacts.cc.ukans.edu/cwis/kufacts_start.html</code> @@ -217,13 +217,13 @@ Here are some sample URLs. Lynx also will attempt to create a complete URL if you include adequate portions of it in the startfile argument. For example:<br> -<tab indent="34"><em>wfbr</em> -<tab indent="62">will be expanded to:<br> -<tab indent="12"><em>http://www.wfbr.edu/</em> -<tab indent="62">and:<br> -<tab indent="26"><em>ftp.more.net/pub</em> -<tab indent="62">will be expanded to:<br> -<tab indent="14"><em>ftp://ftp.more.net/pub</em><br> +<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. [<A HREF="#ToC-Remote">ToC</A>] @@ -235,10 +235,10 @@ environment variable, <dt>UNIX <dd> <dl> - <dt>ksh - <dd><code>export WWW_HOME=http://www.w3.org/</code> - <dt>csh - <dd><code>setenv WWW_HOME http://www.w3.org/</code> + <dt>ksh + <dd><code>export WWW_HOME=http://www.w3.org/</code> + <dt>csh + <dd><code>setenv WWW_HOME http://www.w3.org/</code> </dl> <dt>VMS <dd><code>define "WWW_HOME" "http://www.w3.org/"</code> @@ -322,7 +322,7 @@ mail files to themselves and print the entire file to the screen. Lynx from their own accounts (that is, so-called "non-anonymous users"). In particular, the <em>Save to a local file</EM> option allows you to save the document into a file on your disk -space. Additional print options may also be +space. Additional print options may also be available as configured in the <A HREF="#lynx.cfg">lynx.cfg</A> file. <p>Some options, such as <em>Save to a local file</em>, involve prompting @@ -441,7 +441,7 @@ are case sensitive and case insensitive. These searches are entirely local to Lynx. <p>Some documents are designated <em>index documents</em> by virtue of an -ISINDEX element in their HEAD section. These documents can be used to +ISINDEX element in their HEAD section. These documents can be used to retrieve additional information based on searches using words or phrases submitted to an index server. The Lynx statusline will indicate that you are viewing such a document, and if so, the '<em>s</em>' key will invoke a @@ -469,8 +469,10 @@ searches directly via WAIS or Gopher servers in conjunction with the internal gateways for such servers. For example, an HTML index document can act as a <em>cover page</em> describing a WAIS database and how to formulate query strings for searching it, and include an element such as:<BR> -<tab indent="12"><em><ISINDEX <tab id="idx">PROMPT="Enter WAIS query:"<BR> -<tab to="idx">HREF="wais://net.bio.net/biologists-addresses"></em><BR> +<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. [<A HREF="#ToC-Search">ToC</A>] @@ -592,322 +594,322 @@ return to Lynx or the '<em>></em>' command to save the options to a <dl> <dt>Editor - <dd>The editor to be invoked when editing browsable files, and - sending mail or comments. The full pathname of the editor - command should be specified when possible. + <dd>The editor to be invoked when editing browsable files, and + sending mail or comments. The full pathname of the editor + command should be specified when possible. <dt>DISPLAY variable - <dd>This option is only relevant to X Window users. The DISPLAY - (Unix) or DECW$DISPLAY (VMS) variable is picked up automatically - from the environment if it has been previously set. + <dd>This option is only relevant to X Window users. The DISPLAY + (Unix) or DECW$DISPLAY (VMS) variable is picked up automatically + from the environment if it has been previously set. <dt>Multi-bookmarks - <dd>Lynx supports a default bookmark file, and up to 26 total - bookmark files (see below). When multi-bookmarks is OFF, - the default bookmark file is used for the '<em>v</em>'iew - bookmarks and '<em>a</em>'dd bookmark link commands. If - multi-bookmark support is available in your account, the - setting can be changed to STANDARD or ADVANCED. In STANDARD - mode, a menu of available bookmarks always is invoked when - you seek to view a bookmark file or add a link, and you select - the bookmark file by its letter token (see - <em>Bookmark file</em>, below) in that menu. In ADVANCED mode, - you instead are prompted for the letter of the desired bookmark - file, but can enter '<em>=</em>' to invoke the STANDARD selection - menu, or <em>RETURN</em> for the default bookmark file. + <dd>Lynx supports a default bookmark file, and up to 26 total + bookmark files (see below). When multi-bookmarks is OFF, + the default bookmark file is used for the '<em>v</em>'iew + bookmarks and '<em>a</em>'dd bookmark link commands. If + multi-bookmark support is available in your account, the + setting can be changed to STANDARD or ADVANCED. In STANDARD + mode, a menu of available bookmarks always is invoked when + you seek to view a bookmark file or add a link, and you select + the bookmark file by its letter token (see + <em>Bookmark file</em>, below) in that menu. In ADVANCED mode, + you instead are prompted for the letter of the desired bookmark + file, but can enter '<em>=</em>' to invoke the STANDARD selection + menu, or <em>RETURN</em> for the default bookmark file. <dt>Bookmark file - <dd>When multi-bookmarks is OFF, this is the filename and location - of your default personal bookmark file. Enter '<em>B</em>' to - modify the filename and/or location via the <a - href="keystrokes/edit_help.html">Line Editor</a>. - Bookmark files allow frequently traveled links to be stored in - personal easy to access files. Using the '<em>a</em>'dd bookmark - link command (see <a href="#Bookmarks">Lynx bookmarks</a>) you may save - any link that does not have associated POST content into a - bookmark file. All bookmark files must be in or under your - account's home directory. If the location specified does not - begin with a dot-slash (./), its presence will still be assumed, - and referenced to the home directory. When multi-bookmarks is - STANDARD or ADVANCED, entering '<em>B</em>' will invoke a menu - of up to 26 bookmark files (associated with the letters of the - English alphabet), for editing their filenames and locations - (<em>filepath</em>), and descriptions. Lynx will create bookmark - files, if they don't already exist, when you first '<em>a</em>'dd - a bookmark link to them. However, if you've specified a - subdirectory (e.g., ./BM/lynx_bookmarks.html), that subdirectory - must already exist. Note that on VMS you should use the URL - syntax for the filepath (e.g., <em>not</em> - [.BM]lynx_bookmarks.html). - For Win32, see [???]. + <dd>When multi-bookmarks is OFF, this is the filename and location + of your default personal bookmark file. Enter '<em>B</em>' to + modify the filename and/or location via the <a + href="keystrokes/edit_help.html">Line Editor</a>. + Bookmark files allow frequently traveled links to be stored in + personal easy to access files. Using the '<em>a</em>'dd bookmark + link command (see <a href="#Bookmarks">Lynx bookmarks</a>) you may save + any link that does not have associated POST content into a + bookmark file. All bookmark files must be in or under your + account's home directory. If the location specified does not + begin with a dot-slash (./), its presence will still be assumed, + and referenced to the home directory. When multi-bookmarks is + STANDARD or ADVANCED, entering '<em>B</em>' will invoke a menu + of up to 26 bookmark files (associated with the letters of the + English alphabet), for editing their filenames and locations + (<em>filepath</em>), and descriptions. Lynx will create bookmark + files, if they don't already exist, when you first '<em>a</em>'dd + a bookmark link to them. However, if you've specified a + subdirectory (e.g., ./BM/lynx_bookmarks.html), that subdirectory + must already exist. Note that on VMS you should use the URL + syntax for the filepath (e.g., <em>not</em> + [.BM]lynx_bookmarks.html). + For Win32, see [???]. <dt>FTP sort criteria - <dd>This option allows you to specify how files will be sorted - within FTP listings. The current options include - "<code>By Filename</code>", "<code>By Size</code>", - "<code>By Type</code>", and "<code>By Date</code>". + <dd>This option allows you to specify how files will be sorted + within FTP listings. The current options include + "<code>By Filename</code>", "<code>By Size</code>", + "<code>By Type</code>", and "<code>By Date</code>". <dt>Personal mail address - <dd>This mail address will be used to help you send files to - yourself and will be included as the From: address in any mail - or comments that you send. It will also be sent as the From: - field in HTTP or HTTPS requests if inclusion of that header - has been enabled via the NO_FROM_HEADER definition in - <A HREF="#lynx.cfg">lynx.cfg</A> - (the compilation default is not to send the header), or via the - <em>-from</em> command line toggle. + <dd>This mail address will be used to help you send files to + yourself and will be included as the From: address in any mail + or comments that you send. It will also be sent as the From: + field in HTTP or HTTPS requests if inclusion of that header + has been enabled via the NO_FROM_HEADER definition in + <A HREF="#lynx.cfg">lynx.cfg</A> + (the compilation default is not to send the header), or via the + <em>-from</em> command line toggle. <dt>Searching type - <dd>Searching type has two possible values: CASE INSENSITIVE - (default) and CASE SENSITIVE. The searching type effects - inter-document searches only, and determines whether searches - for words within documents will be done in a case-sensitive or - case-insensitive manner. + <dd>Searching type has two possible values: CASE INSENSITIVE + (default) and CASE SENSITIVE. The searching type effects + inter-document searches only, and determines whether searches + for words within documents will be done in a case-sensitive or + case-insensitive manner. <dt>Preferred Document Language - <dd>The language you prefer if multi-language files are available - from servers. Use RFC 1766 abbreviations, e.g., en for English, - fr for French, etc. Can be a comma-separated list, which may - be interpreted by servers as descending order of preferences. - You can also make your order of preference explicit by using - q factors as defined by the HTTP protocol, for servers which - understand it, for example: - da, en-gb;q=0.8, en;q=0.7 + <dd>The language you prefer if multi-language files are available + from servers. Use RFC 1766 abbreviations, e.g., en for English, + fr for French, etc. Can be a comma-separated list, which may + be interpreted by servers as descending order of preferences. + You can also make your order of preference explicit by using + q factors as defined by the HTTP protocol, for servers which + understand it, for example: + da, en-gb;q=0.8, en;q=0.7 <dt>Preferred Document Charset - <dd>The character set you prefer if sets in addition to ISO-8859-1 - and US-ASCII are available from servers. Use MIME notation - (e.g., ISO-8859-2) and do not include ISO-8859-1 or US-ASCII, - since those values are always assumed by default. Can be a - comma-separated list, which may be interpreted by servers as - descending order of preferences. You can also make your order - of preference explicit by using q factors as defined by the - HTTP protocol, for servers which understand it, for example: - iso-8859-5, utf-8;q=0.8 + <dd>The character set you prefer if sets in addition to ISO-8859-1 + and US-ASCII are available from servers. Use MIME notation + (e.g., ISO-8859-2) and do not include ISO-8859-1 or US-ASCII, + since those values are always assumed by default. Can be a + comma-separated list, which may be interpreted by servers as + descending order of preferences. You can also make your order + of preference explicit by using q factors as defined by the + HTTP protocol, for servers which understand it, for example: + iso-8859-5, utf-8;q=0.8 <dt>Display Character set - <dd>This option allows you to set up the default character set for - your specific terminal. The display character set provides a - mapping from the character encodings of viewed documents and - from HTML entities into viewable characters. It should be set - according to your terminal's character set so that characters - other than 7-bit ASCII can be displayed correctly, using - approximations if necessary. You must have the selected - character set installed on your terminal. (Since Lynx now - supports a wide range of platforms it may be useful to note - that cpXXX codepages used within IBM PC computers, and - windows-xxxx within native MS-Windows apps.) + <dd>This option allows you to set up the default character set for + your specific terminal. The display character set provides a + mapping from the character encodings of viewed documents and + from HTML entities into viewable characters. It should be set + according to your terminal's character set so that characters + other than 7-bit ASCII can be displayed correctly, using + approximations if necessary. You must have the selected + character set installed on your terminal. (Since Lynx now + supports a wide range of platforms it may be useful to note + that cpXXX codepages used within IBM PC computers, and + windows-xxxx within native MS-Windows apps.) <dt>Raw 8-bit or CJK Mode - <dd>Whether 8-bit characters are assumed to correspond with the - display character set and therefore are processed without - translation via the chartrans conversion tables. Should be ON - by default when the display character set is one of the - Asian (CJK) sets and the 8-bit characters are Kanji multibytes. - Should be OFF for the other display 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 specified 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-8859-1 or another 'assumed document character set'. - 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. + <dd>Whether 8-bit characters are assumed to correspond with the + display character set and therefore are processed without + translation via the chartrans conversion tables. Should be ON + by default when the display character set is one of the + Asian (CJK) sets and the 8-bit characters are Kanji multibytes. + Should be OFF for the other display 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 specified 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-8859-1 or another 'assumed document character set'. + 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. <dt>Assumed document character set - <dd>This option changes the handling of documents which do not - explicitly specify a charset. Normally Lynx assumes that 8-bit - characters in those documents are encoded according to iso-8859-1 - (the official default for the HTTP protocol). Unfortunately, - many non-English web pages "forget" to include proper charset info; - this option helps you to browse those broken pages if you know - by some means what the charset is. When the value - given here or by an -assume_charset command line flag is in effect, - Lynx will treat documents as if they were encoded accordingly. - This option active when 'Raw 8-bit or CJK Mode' is OFF. + <dd>This option changes the handling of documents which do not + explicitly specify a charset. Normally Lynx assumes that 8-bit + characters in those documents are encoded according to iso-8859-1 + (the official default for the HTTP protocol). Unfortunately, + many non-English web pages "forget" to include proper charset info; + this option helps you to browse those broken pages if you know + by some means what the charset is. When the value + given here or by an -assume_charset command line flag is in effect, + Lynx will treat documents as if they were encoded accordingly. + This option active when 'Raw 8-bit or CJK Mode' is OFF. <dt>Show color. - <dd>This option will be present if color support is available. - If set to ON or ALWAYS, color mode will be forced on if possible. - If (n)curses color support is available but cannot be used for - the current terminal type, selecting ON is rejected with a message. - If set to OFF or NEVER, color mode will be turned off.<BR> - ALWAYS and - NEVER are not offered in anonymous accounts. If saved to a - <em>.lynxrc</em> file in non-anonymous accounts, ALWAYS will - cause Lynx to set color mode on at startup if supported. - If Lynx is built with the slang library, this is equivalent to - having included the <em>-color</em> command line switch or having the - <em>COLORTERM</em> environment variable set. If color support is - provided by curses or ncurses, this is equivalent to the default - behavior of using color when the terminal type supports it. - If (n)curses color support is available but cannot be used for - the current terminal type, the preference can still be saved - but will have no effect.<BR> - A saved value of NEVER will - cause Lynx to assume a monochrome terminal at startup. - It is similar to the <em>-nocolor</em> switch, but (when the - slang library is used) can be overridden with the <em>-color</em> - switch.<BR> - If the setting is OFF or ON - when the current options are saved to a <em>.lynxrc</em> file, - the default startup behavior is retained, such that color mode - will be turned on at startup only if the terminal info indicates - that you have a color-capable terminal, or (when the - slang library is used) if forced on via the - <em>-color</em> switch or <em>COLORTERM</em> variable. This - default behavior always is used in anonymous accounts, or if - the <em>option_save</em> restriction is set explicitly. If - for any reason the startup color mode is incorrect for your - terminal, set it appropriately on or off via this option. + <dd>This option will be present if color support is available. + If set to ON or ALWAYS, color mode will be forced on if possible. + If (n)curses color support is available but cannot be used for + the current terminal type, selecting ON is rejected with a message. + If set to OFF or NEVER, color mode will be turned off.<BR> + ALWAYS and + NEVER are not offered in anonymous accounts. If saved to a + <em>.lynxrc</em> file in non-anonymous accounts, ALWAYS will + cause Lynx to set color mode on at startup if supported. + If Lynx is built with the slang library, this is equivalent to + having included the <em>-color</em> command line switch or having the + <em>COLORTERM</em> environment variable set. If color support is + provided by curses or ncurses, this is equivalent to the default + behavior of using color when the terminal type supports it. + If (n)curses color support is available but cannot be used for + the current terminal type, the preference can still be saved + but will have no effect.<BR> + A saved value of NEVER will + cause Lynx to assume a monochrome terminal at startup. + It is similar to the <em>-nocolor</em> switch, but (when the + slang library is used) can be overridden with the <em>-color</em> + switch.<BR> + If the setting is OFF or ON + when the current options are saved to a <em>.lynxrc</em> file, + the default startup behavior is retained, such that color mode + will be turned on at startup only if the terminal info indicates + that you have a color-capable terminal, or (when the + slang library is used) if forced on via the + <em>-color</em> switch or <em>COLORTERM</em> variable. This + default behavior always is used in anonymous accounts, or if + the <em>option_save</em> restriction is set explicitly. If + for any reason the startup color mode is incorrect for your + terminal, set it appropriately on or off via this option. <dt>VI keys - <dd>If set to ON then the lowercase h, j, k, and l keys will be - mapped to left, down, up, and right arrow, respectively. The - uppercase H, J, K, and L keys remain mapped to their configured - bindings (normally HELP, JUMP, KEYMAP, and LIST, respectively). + <dd>If set to ON then the lowercase h, j, k, and l keys will be + mapped to left, down, up, and right arrow, respectively. The + uppercase H, J, K, and L keys remain mapped to their configured + bindings (normally HELP, JUMP, KEYMAP, and LIST, respectively). - <p>Note: this has no effect on the line-editor's key bindings. + <p>Note: this has no effect on the line-editor's key bindings. <dt>Emacs keys - <dd>If set to ON then the CTRL-P, CTRL-N, CTRL-F, and CTRL-B keys - will be mapped to up-arrow, down-arrow, right-arrow, and - left-arrow, respectively. Otherwise, they remain mapped to - their configured bindings (normally UP_TWO lines, DOWN_TWO - lines, NEXT_PAGE, and PREV_PAGE, respectively). + <dd>If set to ON then the CTRL-P, CTRL-N, CTRL-F, and CTRL-B keys + will be mapped to up-arrow, down-arrow, right-arrow, and + left-arrow, respectively. Otherwise, they remain mapped to + their configured bindings (normally UP_TWO lines, DOWN_TWO + lines, NEXT_PAGE, and PREV_PAGE, respectively). - <p>Note: this has no direct effect on the line-editor's key bindings. + <p>Note: this has no direct effect on the line-editor's key bindings. <dt>Show dot files - <dd>If display/creation of hidden (dot) files/directories is - enabled, you can turn the feature on or off via this setting. + <dd>If display/creation of hidden (dot) files/directories is + enabled, you can turn the feature on or off via this setting. <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. + <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>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. + <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> - <a href="keystrokes/follow_help.html" - >Follow link (or page) number:</a> and<br> - <a - href="keystrokes/follow_help.html#select-option" - >Select option (or page) number:</a><br> - help for more information. + <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> + <a href="keystrokes/follow_help.html" + >Follow link (or page) number:</a> and<br> + <a + href="keystrokes/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 alternative key bindings for the - built-in line editor, if alternative line-edit bindings have - been compiled in. Otherwise, Lynx uses the <a - href="keystrokes/edit_help.html">Default Binding</a>. + <dd>This option allows you to set alternative key bindings for the + built-in line editor, if alternative line-edit bindings have + been compiled in. Otherwise, Lynx uses the <a + href="keystrokes/edit_help.html">Default Binding</a>. <dt>List directory style - <dd>Applies to Directory Editing. Files and directories can be - presented in the following ways: - <dl> - <dt>Mixed style - <dd>Files and directories are listed together in alphabetical - order. - <dt>Directories first - <dd>Files and directories are separated into two alphabetical - lists. Directories are listed first. - <dt>Files first - <dd>Files and directories are separated into two alphabetical - lists. Files are listed first. - </dl> + <dd>Applies to Directory Editing. Files and directories can be + presented in the following ways: + <dl> + <dt>Mixed style + <dd>Files and directories are listed together in alphabetical + order. + <dt>Directories first + <dd>Files and directories are separated into two alphabetical + lists. Directories are listed first. + <dt>Files first + <dd>Files and directories are separated into two alphabetical + lists. Files are listed first. + </dl> <dt>User Mode <dd>There are three possible choices: Novice, Intermediate, and - Advanced. - <dl> - <dt>Novice - <dd>In Novice mode two lines of help are displayed at the - bottom of the screen. - <dt>Intermediate - <dd>Intermediate mode turns off the help lines. - <dt>Advanced - <dd>Advanced mode displays the URL of the currently selected - link at the bottom of the screen. - </dl> + Advanced. + <dl> + <dt>Novice + <dd>In Novice mode two lines of help are displayed at the + bottom of the screen. + <dt>Intermediate + <dd>Intermediate mode turns off the help lines. + <dt>Advanced + <dd>Advanced mode displays the URL of the currently selected + link at the bottom of the screen. + </dl> <dt>Verbose Images - <dd>Controls whether or not Lynx replaces the [LINK], [INLINE] and - [IMAGE] comments (for images without ALT) with filenames of these - images. This is extremely useful because now we can determine - immediately what images are just decorations (button.gif, line.gif) - and what images are important. This setting can also be toggled - on startup via the <em>-verbose</em> switch. + <dd>Controls whether or not Lynx replaces the [LINK], [INLINE] and + [IMAGE] comments (for images without ALT) with filenames of these + images. This is extremely useful because now we can determine + immediately what images are just decorations (button.gif, line.gif) + and what images are important. This setting can also be toggled + on startup via the <em>-verbose</em> switch. <dt>User Agent - <dd>The header string which Lynx sends to servers to indicate the - User-Agent is displayed here. Changes may be disallowed via - the <em>-restrictions</em> switch. Otherwise, the header can be - changed temporarily to a string such as <em>L_y_n_x/2.8.2</em> - for access to sites which discriminate against Lynx based on - checks for the presence of "Lynx" in the header. If - changed during a Lynx session, the default User-Agent header can - be restored by deleting the modified string in the - Options Menu. Whenever the User-Agent header is - changed, the current document is reloaded, with the no-cache - flags set, on exit from the Options Menu. Changes of - the header are not saved in the RC file. - <dd><em>NOTE</em> that Netscape Communications Corp. has claimed - that false transmissions of "Mozilla" as the User-Agent are a - copyright infringement, which will be prosecuted. <em>DO NOT</em> - misrepresent Lynx as Mozilla. The Options Menu issues - a warning about possible copyright infringement whenever the - header is changed to one which does not include "Lynx" - or "lynx". + <dd>The header string which Lynx sends to servers to indicate the + User-Agent is displayed here. Changes may be disallowed via + the <em>-restrictions</em> switch. Otherwise, the header can be + changed temporarily to a string such as <em>L_y_n_x/2.8.2</em> + for access to sites which discriminate against Lynx based on + checks for the presence of "Lynx" in the header. If + changed during a Lynx session, the default User-Agent header can + be restored by deleting the modified string in the + Options Menu. Whenever the User-Agent header is + changed, the current document is reloaded, with the no-cache + flags set, on exit from the Options Menu. Changes of + the header are not saved in the RC file. + <dd><em>NOTE</em> that Netscape Communications Corp. has claimed + that false transmissions of "Mozilla" as the User-Agent are a + copyright infringement, which will be prosecuted. <em>DO NOT</em> + misrepresent Lynx as Mozilla. The Options Menu issues + a warning about possible copyright infringement whenever the + header is changed to one which does not include "Lynx" + or "lynx". <dt>Local execution scripts or links - <dd>Local execution can be activated by the system administrator. - If it has not been activated you will not see this option - in the <em>Options Menu</em>. - <dd>When a local execution script is encountered Lynx checks the - users options to see whether the script can be executed. Users - have the following options: - <dl> - <dt> Always off - <dd>Local execution scripts will never be executed - <dt>For Local files only - <dd>Local execution scripts will only be executed if the - script to be executed resides on the local machine, - and is referenced by a URL that begins with - <em>file://localhost</em> - <dt>Always on - <dd>All local execution scripts will be executed - </dl> - - <dd>If the users options permit the script to be executed Lynx will - spawn a shell and run the script. If the script cannot be - executed Lynx will show the script within the Lynx window and - inform the user that the script is not allowed to be executed - and will ask the user to check his/her options. - [<A HREF="#ToC-InteractiveOptions">ToC</A>] + <dd>Local execution can be activated by the system administrator. + If it has not been activated you will not see this option + in the <em>Options Menu</em>. + <dd>When a local execution script is encountered Lynx checks the + users options to see whether the script can be executed. Users + have the following options: + <dl> + <dt> Always off + <dd>Local execution scripts will never be executed + <dt>For Local files only + <dd>Local execution scripts will only be executed if the + script to be executed resides on the local machine, + and is referenced by a URL that begins with + <em>file://localhost</em> + <dt>Always on + <dd>All local execution scripts will be executed + </dl> + + <dd>If the users options permit the script to be executed Lynx will + spawn a shell and run the script. If the script cannot be + executed Lynx will show the script within the Lynx window and + inform the user that the script is not allowed to be executed + and will ask the user to check his/her options. + [<A HREF="#ToC-InteractiveOptions">ToC</A>] </dl> <h2 ID="Mail"><A NAME="Mail"><em>Comments and mailto: links</em></A></h2> @@ -964,25 +966,25 @@ received the article supports posting from your site, a link that says <dl> <dt>Reply to user@host - <dd>user@host will correspond to the mail address of the - person who posted the news article. Selecting the link will - allow you to send a message to the person who wrote the message - you are currently viewing. You will be given the option of - including the original message in your reply. + <dd>user@host will correspond to the mail address of the + person who posted the news article. Selecting the link will + allow you to send a message to the person who wrote the message + you are currently viewing. You will be given the option of + including the original message in your reply. <dt>Followup to newsgroup(s) - <dd>Selecting this link will allow you to post back to the - newsgroup that you are currently reading and any newsgroups - to which the message was cross-posted. You will be given - the option of including the original message in your reply. - Once you have typed in your message, you will be asked for - confirmation of whether to proceed with the posting, and - whether to append your signature file if one was defined in - <A HREF="#lynx.cfg">lynx.cfg</A> and is accessible. See <a - href="lynx_url_support.html">Supported URLs</a> for more - information about the URL schemes for posting or sending - followups (replies) to nntp servers with Lynx. - [<A HREF="#ToC-News">ToC</A>] + <dd>Selecting this link will allow you to post back to the + newsgroup that you are currently reading and any newsgroups + to which the message was cross-posted. You will be given + the option of including the original message in your reply. + Once you have typed in your message, you will be asked for + confirmation of whether to proceed with the posting, and + whether to append your signature file if one was defined in + <A HREF="#lynx.cfg">lynx.cfg</A> and is accessible. See <a + href="lynx_url_support.html">Supported URLs</a> for more + information about the URL schemes for posting or sending + followups (replies) to nntp servers with Lynx. + [<A HREF="#ToC-News">ToC</A>] </dl> <h2 ID="Bookmarks"><A NAME="Bookmarks"><em>Lynx bookmarks</em></A></h2> @@ -995,7 +997,7 @@ a document. To use the bookmark feature you must first use the bookmark file press the '<em>a</em>' key and you will be asked: <blockquote> - Save D)ocument or L)ink to bookmark file or C)ancel? (d,l,c): + 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 @@ -1005,16 +1007,16 @@ your bookmark file. <p>A bookmark file will be created in conjunction with acting on the '<em>a</em>'dd command if it does not already exist. Otherwise, the link -will be added to the bottom of the pre-existing bookmark file. You must +will be added to the bottom of the pre-existing bookmark file. You must have created a bookmark file via the '<em>a</em>'dd command before you can view it. <p>Use the '<em>v</em>' command to view the list of bookmarks you have -saved. While viewing the bookmark list you may select a bookmark as you +saved. While viewing the bookmark list you may select a bookmark as you would any other link. <p>You can remove a link from the bookmark list by pressing the -'<em>r</em>' key when positioned on that link. You also can use a +'<em>r</em>' key when positioned on that link. You also can use a standard text editor (e.g., via the '<em>e</em>'dit command while viewing a bookmark file, if an external editor has been defined via the <em>Options menu</em>) to delete or re-order links in the bookmark file, or to modify @@ -1107,7 +1109,7 @@ on your local system. The commands available in DIRED mode are <dd>Type '<em>r</em>' to remove the selected file or directory. <dt><code>T)ag</code> -<dd>Type '<em>t</em>' to tag highlighted file. Further operations will be +<dd>Type '<em>t</em>' to tag highlighted file. Further operations will be performed on tagged files instead of highlighted ones. <dt><code>U)pload</code> @@ -1125,177 +1127,177 @@ commands. <dl> <dt><em>^A</em> - <dd><em>Control-A</em> jumps you to the beginning of the current - document. It is a synonym for the Keypad <em>Home</em> key, and - can be used also when <em>Links are numbered</em> mode is on. The - <em>Find</em> Function key also is a synonym, and ideally the - latter has been mapped to the Function key labeled <em>Home</em> - if you are using an IBM Enhanced Keyboard. + <dd><em>Control-A</em> jumps you to the beginning of the current + document. It is a synonym for the Keypad <em>Home</em> key, and + can be used also when <em>Links are numbered</em> mode is on. The + <em>Find</em> Function key also is a synonym, and ideally the + latter has been mapped to the Function key labeled <em>Home</em> + if you are using an IBM Enhanced Keyboard. <dt><em>^E</em> - <dd><em>Control-E</em> jumps you to the end of the current document. - It is a synonym for the Keypad <em>End</em> key, and can be used - also when <em>Links are numbered</em> mode is on. The <em>Select</em> - Function key also is a synonym, and ideally the latter has been - mapped to the Function key labeled <em>End</em> if you are using - an IBM Enhanced Keyboard. + <dd><em>Control-E</em> jumps you to the end of the current document. + It is a synonym for the Keypad <em>End</em> key, and can be used + also when <em>Links are numbered</em> mode is on. The <em>Select</em> + Function key also is a synonym, and ideally the latter has been + mapped to the Function key labeled <em>End</em> if you are using + an IBM Enhanced Keyboard. <dt><em>^B</em> - <dd><em>Control-B</em> normally jumps you to the previous page of - the current document, and thus is a synonym for the Keypad and - Function <em>Page-Up</em> keys. However, <em>Control-B</em> - acts as <em>right-arrow</em> when emacs-like key movement is - enabled (see <A HREF="#InteractiveOptions">Lynx - Options Menu</A>). + <dd><em>Control-B</em> normally jumps you to the previous page of + the current document, and thus is a synonym for the Keypad and + Function <em>Page-Up</em> keys. However, <em>Control-B</em> + acts as <em>right-arrow</em> when emacs-like key movement is + enabled (see <A HREF="#InteractiveOptions">Lynx + Options Menu</A>). <dt><em>^F</em> - <dd><em>Control-F</em> normally jumps you to the next page of the - current document, and thus is a synonym for the Keypad and - Function <em>Page-Down</em> keys. However, <em>Control-F</em> - becomes <em>right-arrow</em> when emacs-like key movement is - enabled. + <dd><em>Control-F</em> normally jumps you to the next page of the + current document, and thus is a synonym for the Keypad and + Function <em>Page-Down</em> keys. However, <em>Control-F</em> + becomes <em>right-arrow</em> when emacs-like key movement is + enabled. <dt><em>^N</em> - <dd><em>Control-N</em> normally jumps you forward two lines in the - current document. The <em>Remove</em> Function key (labeled - <em>Delete</em> on IBM Enhanced keyboards, and distinct - from their <em>Backspace</em> key) is a synonym. - <em>Control-N</em> becomes <em>down-arrow</em> when emacs-like - key movement is enabled. + <dd><em>Control-N</em> normally jumps you forward two lines in the + current document. The <em>Remove</em> Function key (labeled + <em>Delete</em> on IBM Enhanced keyboards, and distinct + from their <em>Backspace</em> key) is a synonym. + <em>Control-N</em> becomes <em>down-arrow</em> when emacs-like + key movement is enabled. <dt><em>^P</em> - <dd><em>Control-P</em> normally jumps you back two lines in the - current document. The <em>Insert</em> Function key is a synonym. - <em>Control-P</em> becomes <em>up-arrow</em> when emacs-like - key movement is enabled. + <dd><em>Control-P</em> normally jumps you back two lines in the + current document. The <em>Insert</em> Function key is a synonym. + <em>Control-P</em> becomes <em>up-arrow</em> when emacs-like + key movement is enabled. <dt><em>)</em> - <dd>The <em>)</em> command jumps you forward half a page in the - current document. + <dd>The <em>)</em> command jumps you forward half a page in the + current document. <dt><em>(</em> - <dd>The <em>(</em> command jumps you back half a page in the - current document. + <dd>The <em>(</em> command jumps you back half a page in the + current document. <dt><em>#</em> - <dd>The '<em>#</em>' command jumps you to the pseudo Toolbar or - Banner if present in the current document. Use - <em>left-arrow</em> to return from there to your previous - position in the document. + <dd>The '<em>#</em>' command jumps you to the pseudo Toolbar or + Banner if present in the current document. Use + <em>left-arrow</em> to return from there to your previous + position in the document. <dt><em>!</em> - <dd>When '<em>!</em>' is pressed your default shell will be spawned. - When you quit or exit the shell you will return to Lynx (usually - <em>exit</em> under Unix and <em>logout</em> under VMS). This - command is usually disabled for anonymous users. On VMS, - '<em>$</em>' normally is a synonym. - On Win32, this has no effect [???]. + <dd>When '<em>!</em>' is pressed your default shell will be spawned. + When you quit or exit the shell you will return to Lynx (usually + <em>exit</em> under Unix and <em>logout</em> under VMS). This + command is usually disabled for anonymous users. On VMS, + '<em>$</em>' normally is a synonym. + On Win32, this has no effect [???]. <dt><em>g</em> - <dd>The '<em>g</em>' command allows any URL to be viewed. Pressing - the '<em>g</em>' command will bring up a prompt asking for a URL. - Type in the URL that you wish to view. All previously entered - goto URLs are saved in a circular buffer, and can be accessed at - the prompt by pressing the <em>up-arrow</em> or - <em>down-arrow</em> keys. + <dd>The '<em>g</em>' command allows any URL to be viewed. Pressing + the '<em>g</em>' command will bring up a prompt asking for a URL. + Type in the URL that you wish to view. All previously entered + goto URLs are saved in a circular buffer, and can be accessed at + the prompt by pressing the <em>up-arrow</em> or + <em>down-arrow</em> keys. <dt><em>G</em> - <dd>The '<em>G</em>' command allows you to edit the URL of the - current document and then use that as a goto URL. Pressing - the '<em>G</em>' command will bring up a prompt asking you - to edit the current document's URL. If you do not modify - it, or completely delete it, or enter Control-G, the command - will be cancelled. If the current document has POST content - associated with it, an Alert will be issued. If you do edit - that URL, and it does not simply involve a fragment change - (for seeking a position in the current document), the modified - URL will be submitted with method GET and no POST content. If - a modification of the current document's URL results in a - submission, that modified URL will be entered into the circular - buffer for goto URLs, and can be accessed for further - modification via the '<em>g</em>' command. + <dd>The '<em>G</em>' command allows you to edit the URL of the + current document and then use that as a goto URL. Pressing + the '<em>G</em>' command will bring up a prompt asking you + to edit the current document's URL. If you do not modify + it, or completely delete it, or enter Control-G, the command + will be cancelled. If the current document has POST content + associated with it, an Alert will be issued. If you do edit + that URL, and it does not simply involve a fragment change + (for seeking a position in the current document), the modified + URL will be submitted with method GET and no POST content. If + a modification of the current document's URL results in a + submission, that modified URL will be entered into the circular + buffer for goto URLs, and can be accessed for further + modification via the '<em>g</em>' command. <dt><em>E</em> - <dd>The '<em>E</em>' command allows you to edit the URL (or ACTION) - of the current link and then use that as a goto URL. Pressing - the '<em>E</em>' command will bring up a prompt asking you - to edit the current link's URL. If you do not modify it, or - completely delete it, or enter Control-G, the command will be - cancelled. Otherwise, the request for the 'E'dited URL will be - sent with method GET, and will be entered into the circular - buffer for goto URLs so that it can be accessed for further - modification via the '<em>g</em>' command. Note that lower - case 'e' invokes the external editor for the current document. + <dd>The '<em>E</em>' command allows you to edit the URL (or ACTION) + of the current link and then use that as a goto URL. Pressing + the '<em>E</em>' command will bring up a prompt asking you + to edit the current link's URL. If you do not modify it, or + completely delete it, or enter Control-G, the command will be + cancelled. Otherwise, the request for the 'E'dited URL will be + sent with method GET, and will be entered into the circular + buffer for goto URLs so that it can be accessed for further + modification via the '<em>g</em>' command. Note that lower + case 'e' invokes the external editor for the current document. <dt><em>=</em> - <dd>The '<em>=</em>' command shows information about the current - document and the currently selected link if there is one. The - number of lines in the file, URL, title, owner, and type are - shown. + <dd>The '<em>=</em>' command shows information about the current + document and the currently selected link if there is one. The + number of lines in the file, URL, title, owner, and type are + shown. <dt><em>^T</em> - <dd><em>Control-T</em> toggles Lynx trace mode on and off. This is - useful for diagnosing bad html. If you get a <em>Bad HTML</em> - statusline message when loading a document, enter - <em>Control-T</em> and then <em>Control-R</em> to reload the - document in trace mode. You may then examine the - <em>Lynx Trace Log</em> file with the <em>;</em> command - if enabled (see below), watch out especially for lines marked - with a number of asterisks '<tt>*****</tt>'. - You also can submit the document for - validation via links in the online help menu. If you are able - to diagnose the problem, send a message about it to the - document's author. + <dd><em>Control-T</em> toggles Lynx trace mode on and off. This is + useful for diagnosing bad html. If you get a <em>Bad HTML</em> + statusline message when loading a document, enter + <em>Control-T</em> and then <em>Control-R</em> to reload the + document in trace mode. You may then examine the + <em>Lynx Trace Log</em> file with the <em>;</em> command + if enabled (see below), watch out especially for lines marked + with a number of asterisks '<tt>*****</tt>'. + You also can submit the document for + validation via links in the online help menu. If you are able + to diagnose the problem, send a message about it to the + document's author. <dt><em>;</em> - <dd>The <em>;</em> command shows the <em>Lynx Trace Log</em> - (<em>Lynx.trace</em> in the home directory) if one has been - started for the current session. If a log has not been started, - any trace messages will be sent to the screen - (and will disturb the normal display) unless the system supports - piping and that was used to redirect stderr messages to a file. - The log is started when Lynx trace mode is turned on via the - <em>-trace</em> command line switch, or via the - <em>Control-T</em> toggle, if Lynx has been compiled to log - the trace and other stderr messages by default. If not, - ability to create a log can be toggled on with - the <em>-tlog</em> switch. Note that this ability is - probably disabled in anonymous or validation accounts. + <dd>The <em>;</em> command shows the <em>Lynx Trace Log</em> + (<em>Lynx.trace</em> in the home directory) if one has been + started for the current session. If a log has not been started, + any trace messages will be sent to the screen + (and will disturb the normal display) unless the system supports + piping and that was used to redirect stderr messages to a file. + The log is started when Lynx trace mode is turned on via the + <em>-trace</em> command line switch, or via the + <em>Control-T</em> toggle, if Lynx has been compiled to log + the trace and other stderr messages by default. If not, + ability to create a log can be toggled on with + the <em>-tlog</em> switch. Note that this ability is + probably disabled in anonymous or validation accounts. <dt><A NAME="*-key"><em>*</em></A> - <dd>The '<em>*</em>' command toggles image_links mode on and off. - When on, links will be created for all images, including inlines. - If you have an image viewer mapped to the image's MIME type, you - can activate such links to view an inline image. You should - normally have this mode toggled off. + <dd>The '<em>*</em>' command toggles image_links mode on and off. + When on, links will be created for all images, including inlines. + If you have an image viewer mapped to the image's MIME type, you + can activate such links to view an inline image. You should + normally have this mode toggled off. <dt><em>@</em> - <dd>The '<em>@</em>' command toggles raw 8-bit or CJK mode on and off. - When on, the charset is assumed to match the selected character - set and 8-bit characters are not reverse translated with respect - to the ISO-8859-1 conversion tables. + <dd>The '<em>@</em>' command toggles raw 8-bit or CJK mode on and off. + When on, the charset is assumed to match the selected character + set and 8-bit characters are not reverse translated with respect + to the ISO-8859-1 conversion tables. <dt><A NAME="[-key"><em>[</em></A> - <dd>The '<em>[</em>' command toggles pseudo_inlines mode on and off. - When on, inline images which have no ALT string specified will - have an <em>[INLINE]</em> pseudo-ALT string inserted in the Lynx - display. When off, they will be treated as having ALT="" (i.e., - they'll be ignored). If image_links mode is toggled on, the - pseudo-ALT strings will be restored, to serve as links to the - inline images' sources. + <dd>The '<em>[</em>' command toggles pseudo_inlines mode on and off. + When on, inline images which have no ALT string specified will + have an <em>[INLINE]</em> pseudo-ALT string inserted in the Lynx + display. When off, they will be treated as having ALT="" (i.e., + they'll be ignored). If image_links mode is toggled on, the + pseudo-ALT strings will be restored, to serve as links to the + inline images' sources. <dt><em>]</em> - <dd>The '<em>]</em>' command is used to send HEAD requests for the - current document or link. It applies only to documents or links - (or form submit buttons) of http servers. A statusline message - will notify you if the context for this command was inappropriate. - The HEAD requests always are sent to the http server, i.e., Lynx - does not retrieve any previous server replies from its cache. - Note that for form submissions, http servers vary in whether - they'll treat HEAD requests as valid and return the CGI script's - headers, or treat it as invalid and return an error message. + <dd>The '<em>]</em>' command is used to send HEAD requests for the + current document or link. It applies only to documents or links + (or form submit buttons) of http servers. A statusline message + will notify you if the context for this command was inappropriate. + The HEAD requests always are sent to the http server, i.e., Lynx + does not retrieve any previous server replies from its cache. + Note that for form submissions, http servers vary in whether + they'll treat HEAD requests as valid and return the CGI script's + headers, or treat it as invalid and return an error message. <dt><em>^K</em> - <dd><em>Control-K</em> invokes the <a - href="keystrokes/cookie_help.html">Cookie Jar Page</a> - if it contains cookies. + <dd><em>Control-K</em> invokes the <a + href="keystrokes/cookie_help.html">Cookie Jar Page</a> + if it contains cookies. <dt><em>z</em> - <dd>Lynx supports completely interruptible I/O processes. Press the - '<em>z</em>' key at any time during a connect or transfer process - and the process will be halted. If any data was transferred - before the interrupt, it will be displayed. + <dd>Lynx supports completely interruptible I/O processes. Press the + '<em>z</em>' key at any time during a connect or transfer process + and the process will be halted. If any data was transferred + before the interrupt, it will be displayed. <dt><em>numbers</em> - <dd>Lynx offers other, advanced navigation features when numbers - are used to invoke the <a - href="keystrokes/follow_help.html" - >Follow link (or goto link or page) number:</a> or<br> - <a - href="keystrokes/follow_help.html#select-option" - >Select option (or page) number:</a><br> - prompts. - [<A HREF="#ToC-MiscKeys">ToC</A>] + <dd>Lynx offers other, advanced navigation features when numbers + are used to invoke the <a + href="keystrokes/follow_help.html" + >Follow link (or goto link or page) number:</a> or<br> + <a + href="keystrokes/follow_help.html#select-option" + >Select option (or page) number:</a><br> + prompts. + [<A HREF="#ToC-MiscKeys">ToC</A>] </dl> <h2 ID="Forms"><A NAME="Forms"><em>Lynx and HTML Forms</em></a></h2> @@ -1308,7 +1310,6 @@ on the form can be used to search a database or complete a survey. <p>An HTML Form provides for the use of buttons to perform an action (such as <em>submit</em>), checkboxes, radio buttons or popups to select options from a list, and fields for entering text. -<p> <dl> <dt>Buttons: <dd>Buttons are displayed in the same way that Lynx displays links in @@ -1347,10 +1348,10 @@ options from a list, and fields for entering text. <dt> Text Entry Fields <dd>Text entry (INPUT) fields are displayed as a row of underscores the length of the entry field: <em>_______</em>. You may enter text directly - by typing at the keyboard. Use the <a + by typing at the keyboard. Use the <a href="keystrokes/edit_help.html">Line Editor</a> keys to correct errors. If you try to input more text than the field can hold, - the line editor will not accept the additional characters. If you fill + the line editor will not accept the additional characters. If you fill a text field the cursor will not move off the field but remain at the last field position. Use the <em>up-arrow</em>, and <em>down-arrow</em>, <em>TAB</em> or <em>Return</em> keys to move up, or down from the text @@ -1367,7 +1368,7 @@ options from a list, and fields for entering text. <em>down-arrow</em> or <em>Return</em> keys move you to the preceding, or next line of the overall message, as for INPUT fields, and the <em>TAB</em> key will move you down beyond the bottom of the TEXTAREA - field.<P> + field. <dt>Editing TEXTAREA Fields <dd>TEXTAREA fields can be edited using an external editor @@ -1424,7 +1425,7 @@ keystroke with <em>^V</em> to temporarily escape from line editing. <p>To <A name="submit"><em>submit</em></a> the form press <em>right-arrow</em> or <em>Return</em> when positioned on the form's -submit button. If you've submitted the form previously during the Lynx +submit button. If you've submitted the form previously during the Lynx session, have not changed any of the form content, and the METHOD was <em>GET</em>, Lynx will retrieve from its cache what was returned from the previous submission. If you wish to resubmit that form to the server with @@ -1433,10 +1434,10 @@ positioned on the submit button. The <em>right-arrow</em> and <em>Return</em> keys also will invoke a no-cache resubmission if the reply from a form submission included a META element with a no-cache Pragma or Cache-Control directive:<BR> -<tab indent="12" -><em><META HTTP-EQUIV="Pragma" CONTENT="no-cache"></em><BR> -<tab indent="12" -><em><META HTTP-EQUIV="Cache-Control" CONTENT="no-cache"></em><BR> +<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. @@ -1564,9 +1565,10 @@ Otherwise, Lynx uses the last symbolic element in the path for the FORM's ACTION, which is normally the script, itself, or a PATH_INFO field, and thus might be misleading. This also can be done via a META element in any document: -<tab indent="12" -><em><META <tab id="cdis">HTTP-EQUIV="Content-Disposition"<BR> -<tab to="cdis">CONTENT="file; filename=name.suffix"></em><BR> +<pre> + <em><META HTTP-EQUIV="Content-Disposition" + CONTENT="file; filename=name.suffix"></em> +</pre> [<A HREF="#ToC-Forms">ToC</A>] <h2 ID="Images"><A NAME="Images"><em>Lynx and HTML Images</em></a></h2> @@ -1576,13 +1578,13 @@ As a text browser, Lynx does not display images as such but users can choose a number of ways of showing their presence. <p> There are 3 choices in <em>lynx.cfg</em>, with 2 corresponding keys: -<p><pre> +<pre> MAKE_LINKS_FOR_ALL_IMAGES * IMAGE_TOGGLE MAKE_PSEUDO_ALTS_FOR_INLINES [ INLINE_TOGGLE VERBOSE_IMAGES no corresponding key </pre><p> You can also use the Options Menu, as outlined below: -<p><pre> +<pre> key lynx.cfg FM LM .lynxrc variable in source * MAKE_LINKS_ Y N N clickable_images @@ -1595,7 +1597,7 @@ the other two cannot be saved between sessions. </pre><p> In the Forms Menu, the 3-way `Show images' selection combines the effects of the `*' & `[' keys, as follows: -<p><pre> +<pre> Ignore clickable_images = FALSE, pseudo_inline_alts = FALSE As labels clickable_images = FALSE, pseudo_inline_alts = TRUE As links clickable_images = TRUE, pseudo_inline_alts = unchanged @@ -1633,7 +1635,7 @@ TAB element only when LEFT alignment is in effect. If the alignment is CENTER or RIGHT (JUSTIFY is not yet implemented in Lynx, and is treated as a synonym for LEFT), or if the TAB element indicates a position to the left of the current position on the screen, it is treated as a collapsible -space. For purposes of implementing TAB, Lynx treats <em>en</em> units as +space. For purposes of implementing TAB, Lynx treats <em>en</em> units as half a character cell width when specified by the INDENT attribute, and rounds up for odd values (e.g., a value of either 5 or 6 will be treated as three spaces, each the width of a character cell). See the example @@ -1695,7 +1697,7 @@ a number of others which have subsequently been proposed. These <em>Section</em>, <em>Subsection</em>, <em>Alternate</em>, <em>Documentation</em>, <em>Biblioentry</em>, <em>Bibliography</em>, <em>Start</em>, <em>Appendix</em>, -<em>Bookmark</em> and <em>Banner</em>. Any LINK elements with those +<em>Bookmark</em> and <em>Banner</em>. Any LINK elements with those tokens as the REL attribute value, and an HREF attribute value in the LINK, will invoke creation of a <em>banner</em> at the top of the first page, with the element's HREF as the link, and the token as the default link @@ -1751,13 +1753,14 @@ document. However, in contrast to named <em>A</em>nchors, the FN container element is treated as a block (i.e., as if a new paragraph were indicated whether or not that is indicated in its content) with greater than normal left and right margins, and the block will begin with a <em>FOOTNOTE:</em> -label. For example, if the document contains:<BR> -<tab indent="16">See the <em><A -HREF="#fn1"></em><a href="#an1">footnote</a><em></A></em>.<BR> +label. For example, if the document contains: +<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: - -<p><tab indent="16"><em><FN ID="fn1"></em><p><a name="an1">Lynx -does not use popups for FN blocks.</a></p><em></FN></em> +<pre> + <em><FN ID="fn1"></em><p><a name="an1">Lynx does not use popups for FN blocks.</a></p><em></FN></em> +</pre> <p>i.e., position it at the top of the page. Then, upon reading the footnote, you can return to your previous position in the document by pressing the @@ -1780,12 +1783,13 @@ default label <em>NOTE:</em> will be used. Lynx recognizes the values have an ID attribute, which will be treated as a named <em>A</em>nchor, as for <a href="#Footnotes">HTML Footnotes</a>, but the NOTE block need not be placed -at the bottom of the document. The content of a NOTE block can be any HTML +at the bottom of the document. The content of a NOTE block can be any HTML markup that is valid in the BODY of the document. This is an example:<BR> -<tab indent="12"><em><NOTE CLASS="warning" ID="too-bad"><BR> -<tab indent="14"><p>The W3C vendors did not retain -NOTE in the HTML 3.2 draft.</p><BR> -<tab indent="12"></NOTE></em><BR> +<pre> + <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. [<A HREF="#ToC-Notes">ToC</A>] @@ -1797,8 +1801,8 @@ href="http://www.w3.org/MarkUp/html3/Contents.html">HTML 3.0</a> list elements UL (<em>Unordered List</em>), OL (<em>Ordered List</em>), and DL (<em>Definition List</em>), and their associated attributes, and elements (LH, LI, DT, and DD) for the most part as described in that -specification. The lists can be nested, yielding progressively greater -indentation, up to six levels. The <a +specification. The lists can be nested, yielding progressively greater +indentation, up to six levels. The <a href="http://www.w3.org/MarkUp/html-spec/html-spec_toc.html" >HTML 2.0</a> MENU and DIR elements <em>both</em> are treated as synonyms for UL with the PLAIN attribute (no <em>bullets</em>, see below). Note, @@ -1830,7 +1834,7 @@ alphabetical depending on the TYPE for the block. The values can range from For Roman numerals, they can range from <em>1</em> (<em>I</em> or <em>i</em>) to <em>3000</em> (<em>MMM</em> or <em>mmm.</em>). For alphabetical orders, the values can range from <em>1</em> (<em>A</em> or <em>a</em>) to -<em>18278</em> (<em>ZZZ</em> or <em>zzz</em>). If the CONTINUE attribute is +<em>18278</em> (<em>ZZZ</em> or <em>zzz</em>). If the CONTINUE attribute is used, you do not need to specify a START or SEQNUM attribute to extend the ordering from a previous block, and you can include a TYPE attribute to change among Arabic, Roman, or alphabetical ordering styles, or their casing, @@ -1914,7 +1918,7 @@ sight-challenged Webizens, and thus did not include ALT attributes, Lynx uses the resolved URLs pointed to by the HREF attributes as the link names. Lynx uses the TITLE attribute of the IMG element, or the TITLE attribute of the MAP, if either was present in the markup, as the title and main header -of the menu. Otherwise, it uses the ALT attribute of the IMG element. If +of the menu. Otherwise, it uses the ALT attribute of the IMG element. If neither TITLE nor ALT attributes were present in the markup, Lynx creates and uses a <em>[USEMAP]</em> pseudo-ALT. The MAPs need not be in the same document as the IMG elements. If not in the same document, Lynx will fetch @@ -1962,9 +1966,10 @@ in META elements, and one such instruction, via the token <em>Refresh</em>, should invoke reloading of the document, fetched from a server with the same URL or a new URL, at a specified number of seconds following receipt of the current document. This procedure has been termed -<em>client-side-pull</em>. An example of such an element is:<BR> -<tab indent="12"><em><META HTTP-EQUIV="Refresh" CONTENT="3; -URL="http://host/path"></em><BR> +<em>client-side-pull</em>. An example of such an element is: +<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> @@ -2028,7 +2033,7 @@ cookies from that <em>domain</em> (server's Fully Qualified Domain Name, or site-identifying portion of the FQDN) without further confirmation prompts, or ne'<em>V</em>'er to never allow cookies from that <em>domain</em> to be accepted (silently ignore its <em>Set-Cookie</em> -MIME headers). All unexpired cookies are held in a hypothetical +MIME headers). All unexpired cookies are held in a hypothetical <em>Cookie Jar</em> which can be examined via the COOKIE_JAR keystroke command, normally mapped to <em>Ctrl-K</em>, for invoking the <a href="keystrokes/cookie_help.html">Cookie Jar Page</a>. If Lynx has been @@ -2037,7 +2042,7 @@ will be stored between sessions in the filename set with the COOKIE_FILE option in your .lynxrc. <p>A common use of cookies by http servers is simply to track the -documents visited by individual users. Though this can be useful to the +documents visited by individual users. Though this can be useful to the site's WebMaster for evaluating and improving the organization of links in the various documents of the site, if the user has configured Lynx to include a <em>From</em> MIME header with the user's email address in @@ -2069,502 +2074,502 @@ be represented as one of the following: <dl> <dt><code>Command</code> - <dd><code>lynx [options]</code> - <dd><code>lynx [options] startfile</code> + <dd><code>lynx [options]</code> + <dd><code>lynx [options] startfile</code> </dl> where <dl> <dt><code>startfile</code> - <dd>is the file or URL that Lynx will load at start-up. - <ul> - <li>If startfile is not specified, Lynx will use a default - starting file and base directory determined during - installation. - <li>If a specified file is local (i.e., not a URL) Lynx - displays that file and uses the directory in which that - file resides as the base directory. - <li>If a URL is specified, the file will be retrieved, - and only the server base directory will be relevant - to further accesses. - </ul> + <dd>is the file or URL that Lynx will load at start-up. + <ul> + <li>If startfile is not specified, Lynx will use a default + starting file and base directory determined during + installation. + <li>If a specified file is local (i.e., not a URL) Lynx + displays that file and uses the directory in which that + file resides as the base directory. + <li>If a URL is specified, the file will be retrieved, + and only the server base directory will be relevant + to further accesses. + </ul> <dt><code>options</code> - <dd>can be selected from the following list, where items in all-caps - indicate that a substitution must be made. Many options are - "toggles", meaning that they will change the default action, - however it was specified. To always set the option on, use the - syntax "-option+", "-option=on", or "-option:on". To always set - the option off, use the syntax "-option-", "-option=off", or - "-option:off". The syntax with the "=" may not work under DOS - because of operating system constraints. Use one of the other - forms in that case. - <dl> - <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 - <em>-post_data</em> arguments (see below). - It can also be used to avoid having sensitive information - in the invoking command line (which would be visible to - other processes on most systems), especially when - the <em>-auth</em> or <em>-pauth</em> options are used. - On VMS, the dash - must be encased in double-quotes ("-") and the - keyboard input terminated with <em>Control-Z</em> or the - command file input terminated by a line that begins - with '<em>$</em>'. On Unix, the keyboard input terminator - is <em>Control-D</em>. On Win32, [???]. - <dt><code>-accept_all_cookies</code> - <dd>accept all cookies. - <dt><code>-anonymous</code> - <dd>apply restrictions appropriate for an anonymous + <dd>can be selected from the following list, where items in all-caps + indicate that a substitution must be made. Many options are + "toggles", meaning that they will change the default action, + however it was specified. To always set the option on, use the + syntax "-option+", "-option=on", or "-option:on". To always set + the option off, use the syntax "-option-", "-option=off", or + "-option:off". The syntax with the "=" may not work under DOS + because of operating system constraints. Use one of the other + forms in that case. + <dl> + <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 + <em>-post_data</em> arguments (see below). + It can also be used to avoid having sensitive information + in the invoking command line (which would be visible to + other processes on most systems), especially when + the <em>-auth</em> or <em>-pauth</em> options are used. + On VMS, the dash + must be encased in double-quotes ("-") and the + keyboard input terminated with <em>Control-Z</em> or the + command file input terminated by a line that begins + with '<em>$</em>'. On Unix, the keyboard input terminator + is <em>Control-D</em>. On Win32, [???]. + <dt><code>-accept_all_cookies</code> + <dd>accept all cookies. + <dt><code>-anonymous</code> + <dd>apply restrictions appropriate for an anonymous account, see <em>-restrictions</em> below for some - details. - <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>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 dumps. - <dt><code>-blink</code> - <dd>forces high intensity bg colors for color mode, - if available and supported by the terminal. - Lynx needs to be compiled with the slang library for this - flag. - <dt><code>-book</code> - <dd>use the bookmark page as the startfile. The default or - command line startfile is still set for the Main screen - command, and will be used if the bookmark page is - unavailable or blank. - <dt><code>-buried_news</code> - <dd>toggles scanning of news articles for buried references, - and converts them to news links. Not recommended because - email addresses enclosed in angle brackets will be - converted to false news links, and uuencoded messages can - be trashed. - <dt><code>-cache=NUMBER</code> - <dd>set the <em>NUMBER</em> of documents cached in memory. - The default is 10. - <dt><code>-case</code> - <dd>enable case-sensitive string searching. - <dt><code>-cfg=FILENAME</code> - <dd>specifies a Lynx configuration file other than the default - <A HREF="#lynx.cfg">lynx.cfg</A>. - <dt><code>-child</code> - <dd>exit on left-arrow in startfile, and disable save to disk. - <dt><code>-color</code> - <dd>forces color mode on, if available. Default color control sequences - which work for many terminal types are assumed if the terminal - capability description does not specify how to handle color. - Lynx needs to be compiled with the slang library for this flag. - It is equivalent to setting the COLORTERM environment variable. - (If color support is instead provided by a color-capable curses - library like ncurses, Lynx relies completely on the terminal - description to determine whether color mode is possible, and - this flag is not needed and thus unavailable.) - A saved show_color=always setting found in a .lynxrc file at - startup has the same effect. A saved show_color=always found - in .lynxrc on startup is overridden by this flag. - <dt><code>-cookies</code> - <dd>toggles handling of Set-Cookie headers. - <dt><code>-core</code> - <dd>toggles forced core dumps on fatal errors. (Unix only) - <dt><code>-crawl</code> - <dd>with <em>-traversal</em>, output each page to a file.<br> - with <em>-dump</em>, format output as with - <em>-traversal</em>, but to stdout. - <dt><code>-display=DISPLAY</code> - <dd>set the display variable for X rexe-ced programs. - <dt><code>-dump</code> - <dd>dumps the formatted output of the default document - or one specified on the command line to standard out. - This can be used in the following way:<br> - <em>lynx -dump http://www.w3.org/</em> - <dt><code>-editor=EDITOR</code> - <dd>enable external editing using the specified - <em>EDITOR</em>. (vi, ed, emacs, etc.) - <dt><code>-emacskeys</code> - <dd>enable emacs-like key movement. - <dt><code>-enable_scrollback</code> - <dd>toggles behavior compatible with the scrollback keys in - some communications software (may be incompatible with - some curses packages). - <dt><code>-error_file=FILENAME</code> - <dd>the status code from the HTTP request is placed in this - file. - <dt><code>-fileversions</code> - <dd>include all versions of files in local VMS directory - 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. - <dt><code>-ftp</code> - <dd>disable ftp access. - <dt><code>-get_data</code> - <dd>properly formatted data for a get form are read in from - stdin and passed to the form. Input is terminated by a - line that starts with '---'. - <dt><code>-head</code> - <dd>send a HEAD request for the mime headers. - <dt><code>-help</code> - <dd>print this Lynx command syntax usage message. - <dt><code>-historical</code> - <dd>toggles use of '>' or '-->' as a terminator for - comments. - <dt><code>-homepage=URL</code> - <dd>set homepage separate from start page. Will be used - if a fetch of the start page fails or if it is a - script which does not return a document, and as the - <code>URL</code> for the '<em>m</em>'ain menu command. - <dt><code>-image_links</code> - <dd>toggles inclusion of links for all images. - <dt><code>-ismap</code> - <dd>toggles inclusion of ISMAP links when client-side - MAPs are present. - <dt><code>-index=URL</code> - <dd>set the default index file to the specified <em>URL</em> - <dt><code>-link=NUMBER</code> - <dd>starting count for lnk#.dat files produced by - <em>-crawl</em>. - <dt><code>-localhost</code> - <dd>disable URLs that point to remote hosts. - <dt><code>-locexec</code> - <dd>enable local program execution from local files only - (if lynx was compiled with local execution enabled). - <dt><code>-mime_header</code> - <dd>include mime headers and force source dump. - <dt><code>-minimal</code> - <dd>toggles minimal versus valid comment parsing. When - minimal, any '-->' serves as a terminator for a - comment element. When valid, pairs of '--' are - treated as delimiters for series of comments within - the overall comment element. If historical is set, - that overrides minimal or valid comment parsing. - <dt><code>-newschunksize=NUMBER</code> - <dd>number of articles in chunked news listings. - <dt><code>-newsmaxchunk=NUMBER</code> - <dd>maximum news articles in listings before chunking. - <dt><code>-nobrowse</code> - <dd>disable directory browsing. - <dt><code>-nocc</code> - <dd>disable Cc: prompts for self copies of mailings. Note - that this does not disable any CCs which are incorporated - within a mailto URL or form ACTION. - <dt><code>-nocolor</code> - <dd>force color mode off, overriding terminal capabilities and any - <em>-color</em> flags, <em>COLORTERM</em> variable, and saved .lynxrc settings. - <dt><code>-noexec</code> - <dd>disable local program execution. (DEFAULT) - <dt><code>-nofilereferer</code> - <dd>disable transmissions of Referer headers for file URLs. - <dt><code>-nolist</code> - <dd>disable the link list feature in dumps. - <dt><code>-nolog</code> - <dd>disable mailing of error messages to document owners. - <dt><code>-nonrestarting_sigwinch</code> - <dd>make window size change handler non-restarting. - This flag is not available on all systems, - Lynx needs to be compiled with HAVE_SIGACTION defined. - If available, this flag <em>may</em> cause Lynx to react - more immediately to window changes when run within an - xterm. - <dt><code>-nopause</code> - <dd>disable forced pauses for statusline messages. - <dt><code>-noprint</code> - <dd>disable most print functions. - <dt><code>-noredir</code> - <dd>don't follow URL redirections - <dt><code>-noreferer</code> - <dd>disable transmissions of Referer headers. - <dt><code>-nosocks</code> - <dd>disable SOCKS proxy usage by a SOCKSified Lynx. - <dt><code>-nostatus</code> - <dd>disable the retrieval status messages. - <dt><code>-number_links</code> - <dd>force numbering of links. - <dt><code>-partial</code> - <dd>toggles displaying of partial pages while downloading. - <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. The default - configuration can be changed in userdefs.h or - <A HREF="#lynx.cfg">lynx.cfg</A>. - 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 - line that starts with '---'. - <dt><code>-preparsed</code> - <dd>show source preparsed and reformatted when used with - -source or in source view ('<em>\</em>'). - May be useful for debugging of broken HTML markup - to visualize the difference between SortaSGML and TagSoup - <A HREF="keystrokes/option_help.html#tagsoup">recovery modes</A>, - switched by '<em>^V</em>'. - <dt><code>-print</code> - <dd>enable print functions. (default) - <dt><code>-pseudo_inlines</code> - <dd>toggles pseudo-ALTs for inlines with no ALT string. - <dt><code>-raw</code> - <dd>toggles default setting of 8-bit character translations - or CJK mode for the startup character set. - <dt><code>-realm</code> - <dd>restricts access to URLs in the starting realm. - <dt><code>-reload</code> - <dd>flushes the cache on a proxy server - (only the first document affected). - <dt><code>-restrictions</code> - <dd>allows a list of services to be disabled - selectively and takes the following form: - <dd><em>lynx -restrictions=[option][,option][,option]...</em> - <dd>The list of recognized options is printed if none - are specified. - <dl> - <dt>? - <dd>if used alone, lists restrictions in effect. - <dt>all - <dd>restricts all options listed below. - <dt>bookmark - <dd>disallow changing the location of the bookmark - file. - <dt>bookmark_exec - <dd>disallow execution links via the bookmark file. - <dt>change_exec_perms - <dd>disallow changing the eXecute permission on - files (but still allow it for directories) when - local file management is enabled. - <dt>default - <dd>same as command line option <em>-anonymous</em>. - Set default restrictions for anonymous users. - All specific services listed are always - restricted, except for: - inside_telnet, outside_telnet, inside_ftp, - outside_ftp, inside_rlogin, outside_rlogin, - inside_news, outside_news, telnet_port, jump, - mail, print, exec, and goto. The settings for these, - as well as additional goto restrictions for - specific URL schemes that are also applied, - are derived from definitions within userdefs.h.<br> - Note that this is the only option value that - may have the effect of <em>removing</em> some - restrictions, if they have been set by other - options, namely for those services that - <em>are</em> allowed by default according to - userdefs.h. However, if the separate command - line option form (<em>-anonymous</em>) is used, - Lynx takes care to set the default restrictions - before handling additional <em>-restrictions=</em> - options (even if they precede the - <em>anonymous</em> option), so that this cannot - happen. - <dt>dired_support - <dd>disallow local file management. - <dt>disk_save - <dd>disallow saving to disk in the download and print - menus. - <dt>dotfiles - <dd>disallow access to, or creation of, hidden (dot) - files. - <dt>download - <dd>disallow some downloaders in the download menu. - This does <em>not</em> imply the disk_save - restriction. It also does not disable the - DOWNLOAD command, and does not prevent - "Download or Cancel" offers when a MIME type - cannot otherwise be handled. Those are only - disabled if additionally the disk_save - restriction is in effect <em>and</em> - no download methods are defined in a <A - HREF="#lynx.cfg">Lynx configuration - file</A> that are marked as "always ENABLED" - (or, alternatively, if the -validate switch - is used). - <dt>editor - <dd>disallow external editing. - <dt>exec - <dd>disable execution scripts. - <dt>exec_frozen - <dd>disallow the user from changing the local - execution option. - <dt>externals - <dd>disallow some "EXTERNAL" configuration lines, - if support for passing URLs to external - applications (with the EXTERN command) is - compiled in. - <dt>file_url - <dd>disallow using G)oto, served links or bookmarks - for file: URLs. - <dt>goto - <dd>disable the '<em>g</em>' (goto) command. - <dt>inside_ftp - <dd>disallow ftps for people coming from inside your - domain. - <dt>inside_news - <dd>disallow USENET news reading and posting for - people coming from inside you domain. This - applies to "news", "nntp", "newspost", and - "newsreply" URLs, but not to "snews", "snewspost", - or "snewsreply" in case they are supported. - - <dt>inside_rlogin - <dd>disallow rlogins for people coming from inside - your domain. - <dt>inside_telnet - <dd>disallow telnets for people coming from inside - your domain. - <dt>jump - <dd>disable the '<em>j</em>' (jump) command. - <dt>mail - <dd>disallow mailing feature. - <dt>multibook - <dd>disallow multiple bookmarks. - <dt>news_post - <dd>disallow USENET News posting, - <dt>options_save - <dd>disallow saving options in .lynxrc. - <dt>outside_ftp - <dd>disallow ftps for people coming from outside your - domain. - <dt>outside_news - <dd>disallow USENET news reading and posting for - people coming from outside you domain. This - applies to "news", "nntp", "newspost", and - "newsreply" URLs, but not to "snews", "snewspost", - or "snewsreply" in case they are supported. - <dt>outside_rlogin - <dd>disallow rlogins for people coming from outside - your domain. - <dt>outside_telnet - <dd>disallow telnets for people coming from - outside your domain. - <dt>print - <dd>disallow most print options. - <dt>shell - <dd>disallow shell escapes. - <dt>suspend - <dd>disallow <em>Control-Z</em> suspends with escape - to shell on Unix. - <dt>telnet_port - <dd>disallow specifying a port in telnet G)oto's. - <dt>useragent - <dd>disallow modifications of the User-Agent header. - </dl> - - <dt><code>-resubmit_posts</code> - <dd>toggles forced resubmissions (no-cache) of forms with - method POST when the documents they returned are sought - with the PREV_DOC (<em>left-arrow</em>) command or from - the <em>History Page</em>. - <dt><code>-rlogin</code> - <dd>disable recognition of rlogin commands. - <dt><code>-selective</code> - <dd>require .www_browsable files to browse directories. - <dt><code>-show_cursor </code> - <dd>If enabled the cursor will not be hidden in the right hand - corner but will instead be positioned at the start of the - currently selected link. Show cursor is the default for - systems without FANCY_CURSES capabilities. The default - configuration can be changed in userdefs.h or - <A HREF="#lynx.cfg">lynx.cfg</A>. - 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 - treated '<em>></em>' as a co-terminator for - double-quotes and tags. - <dt><code>-source</code> - <dd>works the same as dump but outputs HTML source instead of - formatted text. - <dt><code>-startfile_ok</code> - <dd>allow non-http startfile and homepage with - <em>-validate</em>. - <dt><code>-tagsoup</code> - <dd>initialize DTD with "TagSoup" tables, - <A HREF="keystrokes/option_help.html#tagsoup">more details</A>. - <dt><code>-telnet</code> - <dd>disable recognition of telnet commands. - <dt><code>-term=TERM</code> - <dd>tell Lynx what terminal type to assume its talking to. - (This may be useful for remote execution, when, for - example, Lynx connects to a remote TCP/IP port that starts - a script that, in turn, starts another Lynx process.) - <dt><code>-tlog</code> - <dd>toggles use of a <em>Lynx Trace Log</em> for the - session. The log is named <em>Lynx.trace</em> and is - created in the home directory when Lynx trace mode is - turned on via the <em>-trace</em> command line switch - (see below), or via the TRACE_TOGGLE (<em>Control-T</em>) - keystroke command. Once a log is started for the session, - all trace and other stderr messages are written to the - log. The contents of the log can be examined during - the session via the TRACE_LOG (normally, '<em>;</em>') - keystroke command. If use of a Lynx Trace Log - is turned off, any trace output will go to the standard - error stream. - <dt><code>-trace</code> - <dd>turns on Lynx trace mode. If a Lynx Trace Log - (<em>Lynx.trace</em> in the home directory) has - been started for the current session, all trace - messages are written to that log, and - can be examined during the session via the TRACE_LOG - (normally, '<em>;</em>') command. If no Trace Log - file is in use, trace messages go to stderr. - <dt><code>-traversal</code> - <dd>traverse all http links derived from startfile. When - used with <em>-crawl</em>, each link that begins with the - same string as startfile is output to a file, intended for - indexing. See CRAWL.announce for more information. - <dt><code>-underscore</code> - <dd>toggles use of _underline_ format in dumps. - <dt><code>-useragent=NAME</code> - <dd>set different Lynx User-Agent header. - <dt><code>-use_mouse</code> - <dd>turn on mouse support, if available. - <dt><code>-validate</code> - <dd>accept only http URLs (meant for validation). - <dd>This flag implies security restrictions - generally more severe than <em>-anonymous</em>: - restriction options as for - <em>-restrictions=all</em>, with the notable - exception that goto remains enabled for - http and https URLs; in addition, - the PRINT and DOWNLOAD commands are completely - disabled, and use of a Trace Log file is - forced off. - <dd>Any relaxing of restriction that might be implied - by an also present (or implied) <em>-anonymous</em> - flag is overridden, the only way to possibly relax - <em>some</em> of the restrictions to the level - applicable for "anononymous" accounts is with an - explicit <em>-restrictions=default</em>. - <dt><code>-verbose</code> - <dd>toggles [LINK], [IMAGE] and [INLINE] comments - with filenames of these images. - <dt><code>-version</code> - <dd>print version information. - <dt><code>-vikeys</code> - <dd>enable vi-like key movement. - <dt><code>-width=NUMBER</code> - <dd>number of columns for formatting of dumps, default is 80. - </dl> + details. + <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>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 dumps. + <dt><code>-blink</code> + <dd>forces high intensity bg colors for color mode, + if available and supported by the terminal. + Lynx needs to be compiled with the slang library for this + flag. + <dt><code>-book</code> + <dd>use the bookmark page as the startfile. The default or + command line startfile is still set for the Main screen + command, and will be used if the bookmark page is + unavailable or blank. + <dt><code>-buried_news</code> + <dd>toggles scanning of news articles for buried references, + and converts them to news links. Not recommended because + email addresses enclosed in angle brackets will be + converted to false news links, and uuencoded messages can + be trashed. + <dt><code>-cache=NUMBER</code> + <dd>set the <em>NUMBER</em> of documents cached in memory. + The default is 10. + <dt><code>-case</code> + <dd>enable case-sensitive string searching. + <dt><code>-cfg=FILENAME</code> + <dd>specifies a Lynx configuration file other than the default + <A HREF="#lynx.cfg">lynx.cfg</A>. + <dt><code>-child</code> + <dd>exit on left-arrow in startfile, and disable save to disk. + <dt><code>-color</code> + <dd>forces color mode on, if available. Default color control sequences + which work for many terminal types are assumed if the terminal + capability description does not specify how to handle color. + Lynx needs to be compiled with the slang library for this flag. + It is equivalent to setting the COLORTERM environment variable. + (If color support is instead provided by a color-capable curses + library like ncurses, Lynx relies completely on the terminal + description to determine whether color mode is possible, and + this flag is not needed and thus unavailable.) + A saved show_color=always setting found in a .lynxrc file at + startup has the same effect. A saved show_color=always found + in .lynxrc on startup is overridden by this flag. + <dt><code>-cookies</code> + <dd>toggles handling of Set-Cookie headers. + <dt><code>-core</code> + <dd>toggles forced core dumps on fatal errors. (Unix only) + <dt><code>-crawl</code> + <dd>with <em>-traversal</em>, output each page to a file.<br> + with <em>-dump</em>, format output as with + <em>-traversal</em>, but to stdout. + <dt><code>-display=DISPLAY</code> + <dd>set the display variable for X rexe-ced programs. + <dt><code>-dump</code> + <dd>dumps the formatted output of the default document + or one specified on the command line to standard out. + This can be used in the following way:<br> + <em>lynx -dump http://www.w3.org/</em> + <dt><code>-editor=EDITOR</code> + <dd>enable external editing using the specified + <em>EDITOR</em>. (vi, ed, emacs, etc.) + <dt><code>-emacskeys</code> + <dd>enable emacs-like key movement. + <dt><code>-enable_scrollback</code> + <dd>toggles behavior compatible with the scrollback keys in + some communications software (may be incompatible with + some curses packages). + <dt><code>-error_file=FILENAME</code> + <dd>the status code from the HTTP request is placed in this + file. + <dt><code>-fileversions</code> + <dd>include all versions of files in local VMS directory + 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. + <dt><code>-ftp</code> + <dd>disable ftp access. + <dt><code>-get_data</code> + <dd>properly formatted data for a get form are read in from + stdin and passed to the form. Input is terminated by a + line that starts with '---'. + <dt><code>-head</code> + <dd>send a HEAD request for the mime headers. + <dt><code>-help</code> + <dd>print this Lynx command syntax usage message. + <dt><code>-historical</code> + <dd>toggles use of '>' or '-->' as a terminator for + comments. + <dt><code>-homepage=URL</code> + <dd>set homepage separate from start page. Will be used + if a fetch of the start page fails or if it is a + script which does not return a document, and as the + <code>URL</code> for the '<em>m</em>'ain menu command. + <dt><code>-image_links</code> + <dd>toggles inclusion of links for all images. + <dt><code>-ismap</code> + <dd>toggles inclusion of ISMAP links when client-side + MAPs are present. + <dt><code>-index=URL</code> + <dd>set the default index file to the specified <em>URL</em> + <dt><code>-link=NUMBER</code> + <dd>starting count for lnk#.dat files produced by + <em>-crawl</em>. + <dt><code>-localhost</code> + <dd>disable URLs that point to remote hosts. + <dt><code>-locexec</code> + <dd>enable local program execution from local files only + (if lynx was compiled with local execution enabled). + <dt><code>-mime_header</code> + <dd>include mime headers and force source dump. + <dt><code>-minimal</code> + <dd>toggles minimal versus valid comment parsing. When + minimal, any '-->' serves as a terminator for a + comment element. When valid, pairs of '--' are + treated as delimiters for series of comments within + the overall comment element. If historical is set, + that overrides minimal or valid comment parsing. + <dt><code>-newschunksize=NUMBER</code> + <dd>number of articles in chunked news listings. + <dt><code>-newsmaxchunk=NUMBER</code> + <dd>maximum news articles in listings before chunking. + <dt><code>-nobrowse</code> + <dd>disable directory browsing. + <dt><code>-nocc</code> + <dd>disable Cc: prompts for self copies of mailings. Note + that this does not disable any CCs which are incorporated + within a mailto URL or form ACTION. + <dt><code>-nocolor</code> + <dd>force color mode off, overriding terminal capabilities and any + <em>-color</em> flags, <em>COLORTERM</em> variable, and saved .lynxrc settings. + <dt><code>-noexec</code> + <dd>disable local program execution. (DEFAULT) + <dt><code>-nofilereferer</code> + <dd>disable transmissions of Referer headers for file URLs. + <dt><code>-nolist</code> + <dd>disable the link list feature in dumps. + <dt><code>-nolog</code> + <dd>disable mailing of error messages to document owners. + <dt><code>-nonrestarting_sigwinch</code> + <dd>make window size change handler non-restarting. + This flag is not available on all systems, + Lynx needs to be compiled with HAVE_SIGACTION defined. + If available, this flag <em>may</em> cause Lynx to react + more immediately to window changes when run within an + xterm. + <dt><code>-nopause</code> + <dd>disable forced pauses for statusline messages. + <dt><code>-noprint</code> + <dd>disable most print functions. + <dt><code>-noredir</code> + <dd>don't follow URL redirections + <dt><code>-noreferer</code> + <dd>disable transmissions of Referer headers. + <dt><code>-nosocks</code> + <dd>disable SOCKS proxy usage by a SOCKSified Lynx. + <dt><code>-nostatus</code> + <dd>disable the retrieval status messages. + <dt><code>-number_links</code> + <dd>force numbering of links. + <dt><code>-partial</code> + <dd>toggles displaying of partial pages while downloading. + <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. The default + configuration can be changed in userdefs.h or + <A HREF="#lynx.cfg">lynx.cfg</A>. + 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 + line that starts with '---'. + <dt><code>-preparsed</code> + <dd>show source preparsed and reformatted when used with + -source or in source view ('<em>\</em>'). + May be useful for debugging of broken HTML markup + to visualize the difference between SortaSGML and TagSoup + <A HREF="keystrokes/option_help.html#tagsoup">recovery modes</A>, + switched by '<em>^V</em>'. + <dt><code>-print</code> + <dd>enable print functions. (default) + <dt><code>-pseudo_inlines</code> + <dd>toggles pseudo-ALTs for inlines with no ALT string. + <dt><code>-raw</code> + <dd>toggles default setting of 8-bit character translations + or CJK mode for the startup character set. + <dt><code>-realm</code> + <dd>restricts access to URLs in the starting realm. + <dt><code>-reload</code> + <dd>flushes the cache on a proxy server + (only the first document affected). + <dt><code>-restrictions</code> + <dd>allows a list of services to be disabled + selectively and takes the following form: + <dd><em>lynx -restrictions=[option][,option][,option]...</em> + <dd>The list of recognized options is printed if none + are specified. + <dl> + <dt>? + <dd>if used alone, lists restrictions in effect. + <dt>all + <dd>restricts all options listed below. + <dt>bookmark + <dd>disallow changing the location of the bookmark + file. + <dt>bookmark_exec + <dd>disallow execution links via the bookmark file. + <dt>change_exec_perms + <dd>disallow changing the eXecute permission on + files (but still allow it for directories) when + local file management is enabled. + <dt>default + <dd>same as command line option <em>-anonymous</em>. + Set default restrictions for anonymous users. + All specific services listed are always + restricted, except for: + inside_telnet, outside_telnet, inside_ftp, + outside_ftp, inside_rlogin, outside_rlogin, + inside_news, outside_news, telnet_port, jump, + mail, print, exec, and goto. The settings for these, + as well as additional goto restrictions for + specific URL schemes that are also applied, + are derived from definitions within userdefs.h.<br> + Note that this is the only option value that + may have the effect of <em>removing</em> some + restrictions, if they have been set by other + options, namely for those services that + <em>are</em> allowed by default according to + userdefs.h. However, if the separate command + line option form (<em>-anonymous</em>) is used, + Lynx takes care to set the default restrictions + before handling additional <em>-restrictions=</em> + options (even if they precede the + <em>anonymous</em> option), so that this cannot + happen. + <dt>dired_support + <dd>disallow local file management. + <dt>disk_save + <dd>disallow saving to disk in the download and print + menus. + <dt>dotfiles + <dd>disallow access to, or creation of, hidden (dot) + files. + <dt>download + <dd>disallow some downloaders in the download menu. + This does <em>not</em> imply the disk_save + restriction. It also does not disable the + DOWNLOAD command, and does not prevent + "Download or Cancel" offers when a MIME type + cannot otherwise be handled. Those are only + disabled if additionally the disk_save + restriction is in effect <em>and</em> + no download methods are defined in a <A + HREF="#lynx.cfg">Lynx configuration + file</A> that are marked as "always ENABLED" + (or, alternatively, if the -validate switch + is used). + <dt>editor + <dd>disallow external editing. + <dt>exec + <dd>disable execution scripts. + <dt>exec_frozen + <dd>disallow the user from changing the local + execution option. + <dt>externals + <dd>disallow some "EXTERNAL" configuration lines, + if support for passing URLs to external + applications (with the EXTERN command) is + compiled in. + <dt>file_url + <dd>disallow using G)oto, served links or bookmarks + for file: URLs. + <dt>goto + <dd>disable the '<em>g</em>' (goto) command. + <dt>inside_ftp + <dd>disallow ftps for people coming from inside your + domain. + <dt>inside_news + <dd>disallow USENET news reading and posting for + people coming from inside you domain. This + applies to "news", "nntp", "newspost", and + "newsreply" URLs, but not to "snews", "snewspost", + or "snewsreply" in case they are supported. + + <dt>inside_rlogin + <dd>disallow rlogins for people coming from inside + your domain. + <dt>inside_telnet + <dd>disallow telnets for people coming from inside + your domain. + <dt>jump + <dd>disable the '<em>j</em>' (jump) command. + <dt>mail + <dd>disallow mailing feature. + <dt>multibook + <dd>disallow multiple bookmarks. + <dt>news_post + <dd>disallow USENET News posting, + <dt>options_save + <dd>disallow saving options in .lynxrc. + <dt>outside_ftp + <dd>disallow ftps for people coming from outside your + domain. + <dt>outside_news + <dd>disallow USENET news reading and posting for + people coming from outside you domain. This + applies to "news", "nntp", "newspost", and + "newsreply" URLs, but not to "snews", "snewspost", + or "snewsreply" in case they are supported. + <dt>outside_rlogin + <dd>disallow rlogins for people coming from outside + your domain. + <dt>outside_telnet + <dd>disallow telnets for people coming from + outside your domain. + <dt>print + <dd>disallow most print options. + <dt>shell + <dd>disallow shell escapes. + <dt>suspend + <dd>disallow <em>Control-Z</em> suspends with escape + to shell on Unix. + <dt>telnet_port + <dd>disallow specifying a port in telnet G)oto's. + <dt>useragent + <dd>disallow modifications of the User-Agent header. + </dl> + + <dt><code>-resubmit_posts</code> + <dd>toggles forced resubmissions (no-cache) of forms with + method POST when the documents they returned are sought + with the PREV_DOC (<em>left-arrow</em>) command or from + the <em>History Page</em>. + <dt><code>-rlogin</code> + <dd>disable recognition of rlogin commands. + <dt><code>-selective</code> + <dd>require .www_browsable files to browse directories. + <dt><code>-show_cursor </code> + <dd>If enabled the cursor will not be hidden in the right hand + corner but will instead be positioned at the start of the + currently selected link. Show cursor is the default for + systems without FANCY_CURSES capabilities. The default + configuration can be changed in userdefs.h or + <A HREF="#lynx.cfg">lynx.cfg</A>. + 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 + treated '<em>></em>' as a co-terminator for + double-quotes and tags. + <dt><code>-source</code> + <dd>works the same as dump but outputs HTML source instead of + formatted text. + <dt><code>-startfile_ok</code> + <dd>allow non-http startfile and homepage with + <em>-validate</em>. + <dt><code>-tagsoup</code> + <dd>initialize DTD with "TagSoup" tables, + <A HREF="keystrokes/option_help.html#tagsoup">more details</A>. + <dt><code>-telnet</code> + <dd>disable recognition of telnet commands. + <dt><code>-term=TERM</code> + <dd>tell Lynx what terminal type to assume its talking to. + (This may be useful for remote execution, when, for + example, Lynx connects to a remote TCP/IP port that starts + a script that, in turn, starts another Lynx process.) + <dt><code>-tlog</code> + <dd>toggles use of a <em>Lynx Trace Log</em> for the + session. The log is named <em>Lynx.trace</em> and is + created in the home directory when Lynx trace mode is + turned on via the <em>-trace</em> command line switch + (see below), or via the TRACE_TOGGLE (<em>Control-T</em>) + keystroke command. Once a log is started for the session, + all trace and other stderr messages are written to the + log. The contents of the log can be examined during + the session via the TRACE_LOG (normally, '<em>;</em>') + keystroke command. If use of a Lynx Trace Log + is turned off, any trace output will go to the standard + error stream. + <dt><code>-trace</code> + <dd>turns on Lynx trace mode. If a Lynx Trace Log + (<em>Lynx.trace</em> in the home directory) has + been started for the current session, all trace + messages are written to that log, and + can be examined during the session via the TRACE_LOG + (normally, '<em>;</em>') command. If no Trace Log + file is in use, trace messages go to stderr. + <dt><code>-traversal</code> + <dd>traverse all http links derived from startfile. When + used with <em>-crawl</em>, each link that begins with the + same string as startfile is output to a file, intended for + indexing. See CRAWL.announce for more information. + <dt><code>-underscore</code> + <dd>toggles use of _underline_ format in dumps. + <dt><code>-useragent=NAME</code> + <dd>set different Lynx User-Agent header. + <dt><code>-use_mouse</code> + <dd>turn on mouse support, if available. + <dt><code>-validate</code> + <dd>accept only http URLs (meant for validation). + <dd>This flag implies security restrictions + generally more severe than <em>-anonymous</em>: + restriction options as for + <em>-restrictions=all</em>, with the notable + exception that goto remains enabled for + http and https URLs; in addition, + the PRINT and DOWNLOAD commands are completely + disabled, and use of a Trace Log file is + forced off. + <dd>Any relaxing of restriction that might be implied + by an also present (or implied) <em>-anonymous</em> + flag is overridden, the only way to possibly relax + <em>some</em> of the restrictions to the level + applicable for "anononymous" accounts is with an + explicit <em>-restrictions=default</em>. + <dt><code>-verbose</code> + <dd>toggles [LINK], [IMAGE] and [INLINE] comments + with filenames of these images. + <dt><code>-version</code> + <dd>print version information. + <dt><code>-vikeys</code> + <dd>enable vi-like key movement. + <dt><code>-width=NUMBER</code> + <dd>number of columns for formatting of dumps, default is 80. + </dl> </dl> <p>No options are required, nor is a startfile argument required. @@ -2630,12 +2635,12 @@ A custom hypertext format was developed to support hypertext links to local files and files on remote Gopher servers. Using Gopher servers for distributed file service allowed information providers to publish information from a wide variety of platforms (including Unix, VMS, -VM/CMS and Macintosh). In addition, Lynx became the most user-friendly +VM/CMS and Macintosh). In addition, Lynx became the most user-friendly Gopher client, although that was only an ancillary capability. <p>This distributed approach let providers retain complete control over their information, but it made communication between users -and providers somewhat more difficult. Following the lead of Neal +and providers somewhat more difficult. Following the lead of Neal Erdwien, of Kansas State University, the Lynx hypertext format was extended to include links for including ownership information with each file. This information made it possible for users running diff --git a/lynx_help/keystrokes/bashlike_edit_help.html b/lynx_help/keystrokes/bashlike_edit_help.html index b451dc56..eea18fd9 100644 --- a/lynx_help/keystrokes/bashlike_edit_help.html +++ b/lynx_help/keystrokes/bashlike_edit_help.html @@ -196,8 +196,8 @@ Meta + other (mostly, printable character) keys: Modifier ignored, or sequence swallowed (see [5]). M-@, M-E...M-Z [5], M-\, M-^, M-_ attempt to interpret as 7-bit escape representation for character in 8-bit - control (C1) range if appropriate according to - Display Character Set. + control (C1) range if appropriate according to + Display Character Set. [emacskey] Normal key action subject to emacs_keys setting. diff --git a/lynx_help/keystrokes/dired_help.html b/lynx_help/keystrokes/dired_help.html index eb1d1ae6..3cb11d7e 100644 --- a/lynx_help/keystrokes/dired_help.html +++ b/lynx_help/keystrokes/dired_help.html @@ -8,40 +8,40 @@ <h1>+++DIRED HELP+++</h1> Lynx changes into Dired mode when you use a URL of the type -<em>file://localhost/path/</em>. While in Dired mode, some keys are +<em>file://localhost/path/</em>. While in Dired mode, some keys are remapped to do the following functions: <pre> - C)reate - Create a new, empty file in the current - directory. You will be prompted to enter - a name for the file. + C)reate - Create a new, empty file in the current + directory. You will be prompted to enter + a name for the file. - D)ownload - Download selection using options listed in - the download options screen. + D)ownload - Download selection using options listed in + the download options screen. - E)dit - Spawn the editor defined in the <a - href="option_help.html">options screen</a> - and load selection for editing. + E)dit - Spawn the editor defined in the <a + href="option_help.html">options screen</a> + and load selection for editing. - F)ull menu - Show a full menu of commands for currently - selected file or directory. + F)ull menu - Show a full menu of commands for currently + selected file or directory. - M)odify - Modify the name or location of selection. If - multiple files have been selected, you will - only be able to change the location. Choose - between changing the name or location and then - enter a new filename or path. + M)odify - Modify the name or location of selection. If + multiple files have been selected, you will + only be able to change the location. Choose + between changing the name or location and then + enter a new filename or path. - R)emove - Delete currently selected files. + R)emove - Delete currently selected files. - T)ag - Tag the highlighted file. Multiple files may - be tagged and all other commands except "Create" - will be performed on tagged files instead of the - one highlighted. Press '<em>t</em>' again to untag - a file. + T)ag - Tag the highlighted file. Multiple files may + be tagged and all other commands except "Create" + will be performed on tagged files instead of the + one highlighted. Press '<em>t</em>' again to untag + a file. - U)pload - Upload a file to the current directory using - one of the options listed in the upload - options screen. + U)pload - Upload a file to the current directory using + one of the options listed in the upload + options screen. </pre> <em>Note:</em> Dired mode must be activated at compile time by the diff --git a/lynx_help/keystrokes/environments.html b/lynx_help/keystrokes/environments.html index 9e578fdc..c4d7c9a3 100644 --- a/lynx_help/keystrokes/environments.html +++ b/lynx_help/keystrokes/environments.html @@ -261,10 +261,10 @@ NATIVE LANGUAGE SUPPORT ISO 3166. LANGUAGE This variable, if set, will override - the default message language. This is a - GNU extension that has higher priority for - setting the message catalog than LANG or - LC_ALL. + the default message language. This is a + GNU extension that has higher priority for + setting the message catalog than LANG or + LC_ALL. LC_ALL and @@ -273,9 +273,9 @@ NATIVE LANGUAGE SUPPORT style. They are POSIXly correct. LINGUAS This variable, if set prior to configuration, - limits the installed languages to specific values. - It is a space-separated list of two-letter codes. - Currently, it is hard-coded to a wish list. + limits the installed languages to specific values. + It is a space-separated list of two-letter codes. + Currently, it is hard-coded to a wish list. NLSPATH This variable, if set, is used as the path prefix for message catalogs. diff --git a/lynx_help/keystrokes/gopher_types_help.html b/lynx_help/keystrokes/gopher_types_help.html index 629256e1..cadd6441 100644 --- a/lynx_help/keystrokes/gopher_types_help.html +++ b/lynx_help/keystrokes/gopher_types_help.html @@ -49,7 +49,7 @@ view images <dd>The link will open a connection to another host using telnet <dt>(3270) -<dd>The link will open a connection to another +<dd>The link will open a connection to another host using tn3270 <dt>(UKN) diff --git a/lynx_help/keystrokes/keystroke_help.html b/lynx_help/keystrokes/keystroke_help.html index 5cf588a8..64a71010 100644 --- a/lynx_help/keystrokes/keystroke_help.html +++ b/lynx_help/keystrokes/keystroke_help.html @@ -19,86 +19,86 @@ - - Scroll up to previous page (Page-Up) SPACE - Scroll down to next page (Page-Down) b - Scroll up to previous page (Page-Up) - CTRL-A - Go to first page of the current document (Home) - CTRL-E - Go to last page of the current document (End) - CTRL-B - Scroll up to previous page (Page-Up) - CTRL-F - Scroll down to next page (Page-Down) - CTRL-N - Go forward two lines in the current document - CTRL-P - Go back two lines in the current document - ) - Go forward half a page in the current document - ( - Go back half a page in the current document - # - Go to Toolbar or Banner in the current document + CTRL-A - Go to first page of the current document (Home) + CTRL-E - Go to last page of the current document (End) + CTRL-B - Scroll up to previous page (Page-Up) + CTRL-F - Scroll down to next page (Page-Down) + CTRL-N - Go forward two lines in the current document + CTRL-P - Go back two lines in the current document + ) - Go forward half a page in the current document + ( - Go back half a page in the current document + # - Go to Toolbar or Banner in the current document - <A HREF="dired_help.html">DIRED</A>: c - Create a new file - d - Download selected file - e - Edit selected file - f - Show a full menu of options for current file - m - Modify the name or location of selected file - r - Remove selected file - t - Tag highlighted file - u - Upload a file into the current directory + <A HREF="dired_help.html">DIRED</A>: c - Create a new file + d - Download selected file + e - Edit selected file + f - Show a full menu of options for current file + m - Modify the name or location of selected file + r - Remove selected file + t - Tag highlighted file + u - Upload a file into the current directory <A HREF="other_help.html">OTHER</A>: ? (or h) - Help (this screen) a - Add the current link to a bookmark file c - Send a comment to the document owner d - Download the current link - e - Edit the current file - E - Edit the current link's URL (or ACTION) and + e - Edit the current file + E - Edit the current link's URL (or ACTION) and use that as a goto URL. g - Goto a user specified <a - href="../lynx_url_support.html">URL</a> or file + href="../lynx_url_support.html">URL</a> or file G - Edit the current document's URL and use that as a goto URL. - i - Show an index of documents - j - Execute a jump operation - k - Show list of actual key mappings - l - List references (links) in current document + i - Show an index of documents + j - Execute a jump operation + k - Show list of actual key mappings + l - List references (links) in current document m - Return to main screen o - Set your <A HREF="option_help.html">options</A> p - <a href="print_help.html" - >Print</a> to a file, mail, printers, or other + >Print</a> to a file, mail, printers, or other q - Quit (Capital 'Q' for quick quit) / - Search for a string within the current document s - Enter a search string for an external search n - Go to the next search string v - View a <A HREF="bookmark_help.html" - >bookmark file</A> + >bookmark file</A> V - Go to the <A HREF="visited_help.html" - >Visited Links Page</A> + >Visited Links Page</A> x - Force submission of form or link with no-cache z - Cancel transfer in progress [backspace] - Go to the <A HREF="history_help.html" - >History Page</A> + >History Page</A> = - Show info about current document, URL and link \ - Toggle document source/rendered view - ! - Spawn your default shell - ' - Toggle "historical" vs minimal or valid comment - parsing - _ - Clear all authorization info for this session - ` - Toggle minimal or valid comment parsing - * - Toggle image_links mode on and off - @ - Toggle raw 8-bit translations or CJK mode - on or off - [ - Toggle pseudo_inlines mode on and off - ] - Send a HEAD request for the current doc or link - " - Toggle valid or "soft" double-quote parsing + ! - Spawn your default shell + ' - Toggle "historical" vs minimal or valid comment + parsing + _ - Clear all authorization info for this session + ` - Toggle minimal or valid comment parsing + * - Toggle image_links mode on and off + @ - Toggle raw 8-bit translations or CJK mode + on or off + [ - Toggle pseudo_inlines mode on and off + ] - Send a HEAD request for the current doc or link + " - Toggle valid or "soft" double-quote parsing CTRL-R - Reload current file and refresh the screen CTRL-V - Switch to <A HREF="option_help.html#tagsoup" >alternative parsing</A> of HTML documents CTRL-L - Refresh the screen CTRL-U - Erase input line (<a href="edit_help.html" - >more input line commands</a>) + >more input line commands</a>) CTRL-G - Cancel input or transfer CTRL-T - Toggle trace mode on and off ; - View the Lynx Trace Log for the current session CTRL-K - Invoke the <A HREF="cookie_help.html" - >Cookie Jar Page</A> + >Cookie Jar Page</A> numbers - Invoke the prompt - <a href="follow_help.html" - >Follow link (or goto link or page) number:</a> + <a href="follow_help.html" + >Follow link (or goto link or page) number:</a> or the <a href="follow_help.html#select-option" - >Select option (or page) number:</a> + >Select option (or page) number:</a> prompt </PRE> </BODY> diff --git a/lynx_help/keystrokes/movement_help.html b/lynx_help/keystrokes/movement_help.html index 4655db31..b5c9e237 100644 --- a/lynx_help/keystrokes/movement_help.html +++ b/lynx_help/keystrokes/movement_help.html @@ -27,9 +27,9 @@ from the '.lynxrc' file, lowercase h,j,k,l will move left, down, up, and right, respectively. - *note: If 'Emacs Keys' are enabled from the options menu or - from the '.lynxrc' file, Ctrl-B, Ctrl-N, Ctrl-P, - Ctrl-F will move left, down, up, and right, respectively. + *note: If 'Emacs Keys' are enabled from the options menu or + from the '.lynxrc' file, Ctrl-B, Ctrl-N, Ctrl-P, + Ctrl-F will move left, down, up, and right, respectively. *note: If the 'Num Lock' on your keyboard is on, Lynx will translate the numbers of your keypad into movement diff --git a/lynx_help/keystrokes/other_help.html b/lynx_help/keystrokes/other_help.html index 2aa7f337..8ad98ead 100644 --- a/lynx_help/keystrokes/other_help.html +++ b/lynx_help/keystrokes/other_help.html @@ -7,55 +7,55 @@ <BODY> <h1>+++ Other Commands +++</h1> <PRE> - a - Places the link that you are currently positioned - on into a personal <A HREF="bookmark_help.html">bookmark file</A>. + a - Places the link that you are currently positioned + on into a personal <A HREF="bookmark_help.html">bookmark file</A>. - c - Allows you to send a mail message to the owner - or maintainer of the data that you are currently - viewing. In the case that no owner is known, - you cannot send a comment. + c - Allows you to send a mail message to the owner + or maintainer of the data that you are currently + viewing. In the case that no owner is known, + you cannot send a comment. - d - Downloads the file pointed to by the current link - and displays an option menu allowing the file to - be saved or transferred by configurable options. - Can also be used when positioned on a form SUBMIT - button to download the reply to a form submission. + d - Downloads the file pointed to by the current link + and displays an option menu allowing the file to + be saved or transferred by configurable options. + Can also be used when positioned on a form SUBMIT + button to download the reply to a form submission. e - Allows you to edit the current document if it is a - local file. + local file. E - Allows you to edit the current link's URL (or ACTION) and - use that as a <em>goto</em> URL. + use that as a <em>goto</em> URL. - g - Allows you to enter any <a href="http://www.ncsa.uiuc.edu/demoweb/url-primer.html">URL</a> or filename that - you wish to view, and then <em>goto</em> it. + g - Allows you to enter any <a href="http://www.ncsa.uiuc.edu/demoweb/url-primer.html">URL</a> or filename that + you wish to view, and then <em>goto</em> it. - G - Allows you to edit the current document's URL and use that + G - Allows you to edit the current document's URL and use that as a <em>goto</em> URL. - ? or H - Hypertext help to explain how to navigate in - Lynx and use its features. + ? or H - Hypertext help to explain how to navigate in + Lynx and use its features. - i - Shows an index of files or subjects. This is - configurable by the System administrator, or - within documents that you may be viewing. + i - Shows an index of files or subjects. This is + configurable by the System administrator, or + within documents that you may be viewing. - j - Allows you to enter a "short" name to execute a - jump command configured by your system administrator. - Press "?" and ENTER to see a list of defined - jump commands. + j - Allows you to enter a "short" name to execute a + jump command configured by your system administrator. + Press "?" and ENTER to see a list of defined + jump commands. - k - Shows a list of key mappings. Keys remapped in - "lynx.cfg" show up in this list. + k - Shows a list of key mappings. Keys remapped in + "lynx.cfg" show up in this list. - l - Brings up a list of references (links) in the current - document, which can be used for rapid access to the - links in large documents. + l - Brings up a list of references (links) in the current + document, which can be used for rapid access to the + links in large documents. - m - Returns to the first screen and empties the - history stack. + m - Returns to the first screen and empties the + history stack. - p - Brings up a list of <A HREF="print_help.html">print commands</A>. + p - Brings up a list of <A HREF="print_help.html">print commands</A>. o - Brings up a list of settable <A HREF="option_help.html">options</A>. @@ -65,36 +65,36 @@ (case insensitive or case sensitive depending on the <A HREF="option_help.html">options</A> set). - s - Search through an external searchable indexed document. + s - Search through an external searchable indexed document. - n - Move to the next instance of a search string if you - have searched previously. + n - Move to the next instance of a search string if you + have searched previously. - v - View a <A HREF="bookmark_help.html">Bookmark file</A>. + v - View a <A HREF="bookmark_help.html">Bookmark file</A>. V - Go to the <A HREF="visited_help.html">Visited Links Page</A> x - Force submission of form or link with no-cache. - z - Abort a network transfer in progress. If any partial + z - Abort a network transfer in progress. If any partial data has been transferred it will be displayed. <backspace> - displays the <a href="history_help.html">History Page</A>. - = - Show information about the file and link that you - are currently viewing. + = - Show information about the file and link that you + are currently viewing. - \ - Toggles between viewing the HTML source of a - document and the rendered version of the document. + \ - Toggles between viewing the HTML source of a + document and the rendered version of the document. - ! - Spawns your default operating system shell. + ! - Spawns your default operating system shell. - ' - Toggles "historical" vs minimal or valid comment parsing. + ' - Toggles "historical" vs minimal or valid comment parsing. When historical, any close-angle-bracket will be treated - as a comment terminator, emulating the parsing bug in old - versions of Mosaic and Netscape, rather than validly - requiring pairs of two successive dashes to delimit - comments within the angle-brackets. + as a comment terminator, emulating the parsing bug in old + versions of Mosaic and Netscape, rather than validly + requiring pairs of two successive dashes to delimit + comments within the angle-brackets. _ - Clears all authorization info for the current session. Can be used when leaving one's terminal without ending the Lynx @@ -103,13 +103,13 @@ Note that any protected documents that are still in cache can still be accessed. - ` - Toggles minimal or valid comment parsing. When minimal, any - two successive dashes followed by a close-angle-bracket will - be treated as a comment terminator, emulating the parsing bug - in Netscape v2.0. If historical comment parsing is set, that - will override minimal or valid comment parsing. + ` - Toggles minimal or valid comment parsing. When minimal, any + two successive dashes followed by a close-angle-bracket will + be treated as a comment terminator, emulating the parsing bug + in Netscape v2.0. If historical comment parsing is set, that + will override minimal or valid comment parsing. - * - Toggles image_links mode on and off. When on, links will + * - Toggles image_links mode on and off. When on, links will be created for all images, including inlines. @ - Toggles raw 8-bit translations or CJK mode on and off, only @@ -139,21 +139,21 @@ the CGI script's headers, or treat it as invalid and return an error message. - " - Toggles valid or "soft" double-quote parsing. When soft, + " - Toggles valid or "soft" double-quote parsing. When soft, a close-angle-bracket will serve as both a close-double- - quote and close-tag, emulating the parsing bug in old - versions of Mosaic and Netscape. + quote and close-tag, emulating the parsing bug in old + versions of Mosaic and Netscape. - CTRL-R - Reloads the current document and resets the display. + CTRL-R - Reloads the current document and resets the display. - CTRL-V - Switches to an alternative way of parsing HTML documents. + CTRL-V - Switches to an alternative way of parsing HTML documents. This may help to get a more readable rendering of some documents with invalidly placed HTML tags, <A HREF="option_help.html#tagsoup">more details</A>. - CTRL-W - Resets or cleans up the display. + CTRL-W - Resets or cleans up the display. - CTRL-U - Clears text from an input field or prompt. + CTRL-U - Clears text from an input field or prompt. CTRL-G - Cancels any input prompt, mail message or data transfer. @@ -168,7 +168,7 @@ <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> + >Select option (or page) number:</a> prompts. </PRE> </BODY> diff --git a/lynx_help/keystrokes/scrolling_help.html b/lynx_help/keystrokes/scrolling_help.html index d1931346..8a42dda4 100644 --- a/lynx_help/keystrokes/scrolling_help.html +++ b/lynx_help/keystrokes/scrolling_help.html @@ -15,7 +15,7 @@ or CTRL-B) will bring you back up one page (Page-Up). If the 'Num Lock' on your keyboard is on, Lynx will translate - the numbers of your keypad into movement commands as follows: + the numbers of your keypad into movement commands as follows: 9 - page up 8 - up arrow diff --git a/lynx_help/keystrokes/xterm_help.html b/lynx_help/keystrokes/xterm_help.html index d40ea450..05d13ea7 100644 --- a/lynx_help/keystrokes/xterm_help.html +++ b/lynx_help/keystrokes/xterm_help.html @@ -22,7 +22,7 @@ programs, usually called X servers, that make them act like X Window terminals and are frequently used as X terminals. <dl> -<dt>Note: +<dt>Note: <dd>The terminology used to describe processes associated with X terminals can be confusing. An X terminal is also known as an "X display server," and the program running on the host diff --git a/lynx_help/lynx_url_support.html b/lynx_help/lynx_url_support.html index 759e32f2..80d6bf1f 100644 --- a/lynx_help/lynx_url_support.html +++ b/lynx_help/lynx_url_support.html @@ -76,8 +76,10 @@ according to the rules specified in RFC1808 and subsequent IETF drafts. <H2><a name="http">The <em>http</em> and <em>https</em> URLs:</a></H2> Lynx handles http URLs exactly as specified in RFC1738. The format -is:<BR> -<tab indent="12"><em>http://host:port/path?searchpart#fragment</em><BR> +is: +<pre> + <em>http://host:port/path?searchpart#fragment</em> +</pre> where <em>:port</em> is optional and defaults to <em>:80</em>, <em>/path</em> if present is a slash-separated series of symbolic elements, and <em>?searchpart</em> if present is the query for an ISINDEX @@ -100,8 +102,10 @@ in the general distributions of freeware WWW clients such as Lynx. Sorry. >The <em>telnet</em>, <em>tn3270</em>, and <em>rlogin</em> URLs:</a></H2> A <em>telnet</em> URL generally results in Lynx spawning a telnet -session. Lynx implements the complete telnet URL scheme, i.e.:<BR> -<tab indent="12"><em>telnet://user:password@host:port</em> +session. Lynx implements the complete telnet URL scheme, i.e.: +<pre> + <em>telnet://user:password@host:port</em> +</pre> <p>The <em>user</em> and/or <em>:password</em> fields may be omitted, and the <em>@</em> should be omitted if neither is present. The port defaults @@ -120,8 +124,10 @@ or not one was included in the URL. <H2><a name="gopher">The <em>gopher</em> URL:</a></H2> -The gopher URL takes the form:<BR> -<tab indent="12"><em>gopher://host:port/gopher-path</em><BR> +The gopher URL takes the form: +<pre> + <em>gopher://host:port/gopher-path</em> +</pre> where <em>:port</em> is optional and defaults to <em>:70</em>, and the <em>/gopher-path</em> is opaque (not fully equivalent to the slash-separated series of symbolic elements of http paths) as explained @@ -150,9 +156,13 @@ but other WWW clients may mishandle it. <p>For the <em>gophertype</em> which signifies HTML (<em>h</em>), if the <em>selector</em> begins with <em>GET%20/</em> Lynx will convert the gopher URL to an http URL, e.g.:<BR> -<tab indent="12"><em>gopher://www.wfbr.edu:80/hGET%20/</em><BR> +<pre> +<em>gopher://www.wfbr.edu:80/hGET%20/</em> +</pre> will become:<BR> -<tab indent="12"><em>http://www.wfbr.edu/</em><BR> +<pre> +<em>http://www.wfbr.edu/</em> +</pre> The port field will be retained if it is not <em>:80</em>, and will default to <em>:70</em> if it was defaulted originally. These conventions were adopted during development of the University of Minnesota gopher software @@ -166,23 +176,27 @@ and UMN Gopherisms. The file URL is used to retrieve files or generate a directory listing on the local host. The host field can be <em>localhost</em> or a domain name for the local host:<BR> -<tab indent="12"><em>file://localhost/path</em><BR> +<pre> +<em>file://localhost/path</em> +</pre> If you do not use <em>localhost</em> or a domain name for the local host, Lynx will substitute <em>ftp://</em> for <em>file://</em> and treat it as an ftp URL. <p>The <em>/path</em> is treated as originating at the root, unless -you include a tilde (<em>~</em>), e.g.:<BR> -<tab indent="12"><em>file://localhost/~/foo</em> -<tab indent="60">will be converted to:<BR> -<tab indent="12"><em>file://localhost/your/login/directory/foo</em><BR> +you include a tilde (<em>~</em>), e.g.: +<pre> + <em>file://localhost/~/foo</em> will be converted to: + <em>file://localhost/your/login/directory/foo</em> +</pre> The latter feature is a Lynxism, is done homologously on Unix and VMS, and should be used ONLY in local documents intended for Lynx. <p>On VMS, the first element of the path, if not a tilde, is assumed to -be a device, e.g.:<BR> -<tab indent="12" -><em>file://localhost/www_root/directory/filename.suffix</em><BR> +be a device, e.g.: +<pre> + <em>file://localhost/www_root/directory/filename.suffix</em> +</pre> should be used for: <em>www_root:[directory]filename.suffix</em><BR> If you are unsure how to specify a file URL in local documents on VMS, invoke Lynx with the desired file or directory as the @@ -193,9 +207,10 @@ URL which Lynx created for it. <H2><a name="ftp">The <em>ftp</em> URL:</a></H2> -The ftp URL has the general format:<BR> -<tab indent="12" -><em>ftp://username:password@host:port/path;type=[D,I, or A]</em><BR> +The ftp URL has the general format: +<pre> + <em>ftp://username:password@host:port/path;type=[D,I, or A]</em> +</pre> <p>The default port is <em>:21</em> and the default <em>username</em> is <em>anonymous</em>. If <em>username</em> is included but not @@ -221,12 +236,16 @@ string if present is treated as in or under the login directory. For VMS ftp servers, if you wish to have the first element treated as a device rather than file or subdirectory name, begin it with a hex-escaped slash (<em>%2f</em>), e.g.:<BR> -<tab indent="12"><em>ftp://user@myhost/%2fsys$common/syshlp</em><BR> +<pre> +<em>ftp://user@myhost/%2fsys$common/syshlp</em> +</pre> can be used for a listing of sys$common:[syshlp]<BR> Also, on VM/CMS ftp servers, if the <em>path</em> string begins with <em>vmsysu%3a</em> it receives special handling as an SFS -path, e.g.:<BR> -<tab indent="12"><em>ftp://ubvm.cc.buffalo.edu/vmsysu%3alistserv.webshare</em> +path, e.g.: +<pre> + <em>ftp://ubvm.cc.buffalo.edu/vmsysu%3alistserv.webshare</em> +</pre> <p>For Unix and Unix-emulation ftp servers, RFC1738 is not respected and the lead slash is treated as the root, i.e., the <em>/path</em> is @@ -235,17 +254,21 @@ irrelevant for anonymous ftp, but matters when using ftp for non-anonymous accounts. If you are using ftp with a Unix server and do wish to get a listing of the login directory or have the <em>path</em> string treated as a file or path under the login directory, include a -tilde (<em>~</em>) as for <a href="#file">file</a> URLs, e.g.:<BR> -<tab indent="12"><em>ftp://user@myhost/~</em> +tilde (<em>~</em>) as for <a href="#file">file</a> URLs, e.g.: +<pre> + <em>ftp://user@myhost/~</em> +</pre> <HR> <H2><a name="wais">The <em>wais</em> URL:</a></H2> The wais URL is used to retrieve resources using the Wide Area Information -System protocol. The format is:<BR> -<tab indent="12"><em>wais://host:port/database</em><BR> -<tab indent="12"><em>wais://host:port/database?wais_query</em><BR> -<tab indent="12"><em>wais://host:port/database/wais_type/wais_path</em><BR> +System protocol. The format is: +<pre> + <em>wais://host:port/database</em> + <em>wais://host:port/database?wais_query</em> + <em>wais://host:port/database/wais_type/wais_path</em> +</pre> where <em>:port</em> defaults to <em>:210</em> <p>Direct wais support is built into Lynx for VMS, and can be compiled @@ -275,15 +298,14 @@ but cannot be included in the general distribution (sorry, see <a href="#http">http and https</a>). <p>The formats are:<BR> -<tab indent="12"><em>news:newsgroup</em> <tab -id="ng">(retrieves list of messages in newsgroup)<BR> -<tab indent="12"><em>news:messageID</em> <tab -to="ng">(retrieves the message)<BR> -<tab indent="12"><em>news:*</em> <tab -to="ng">(retrieves list of all available newsgroups)<BR> -<tab indent="12"><em>nntp://host:port/newsgroup</em><BR> -<tab indent="12"><em>nntp://host:port/messageID</em><BR> -<tab indent="12"><em>nntp://host:port/*</em><BR> +<pre> + <em>news:newsgroup</em> (retrieves list of messages in newsgroup) + <em>news:messageID</em> (retrieves the message) + <em>news:*</em> (retrieves list of all available newsgroups) + <em>nntp://host:port/newsgroup</em> + <em>nntp://host:port/messageID</em> + <em>nntp://host:port/*</em> +</pre> (snews same as nntp, but the default port is <em>:563</em>) <p>The <em>messageID</em> is the message's unique identifier, consisting @@ -291,9 +313,11 @@ of an identification string and the host of origin for the message (<em>ident_string@origin_host</em>). <p>Lynx also supports wildcarding via an asterisk for listings of news -hierarchies or sub-hierarchies, e.g.:<BR> -<tab indent="12"><em>news:comp.infosystems.*</em><BR> -<tab indent="12"><em>nntp://host:port/comp.infosystems.*</em><BR> +hierarchies or sub-hierarchies, e.g.: +<pre> + <em>news:comp.infosystems.*</em> + <em>nntp://host:port/comp.infosystems.*</em> +</pre> (snews same as nntp, but the default port is <em>:563</em>)<BR> This is not in RFC1738 and may not be supported by all other clients. @@ -306,12 +330,12 @@ snewspost, snewsreply</a>). with a supported scheme into a link for accessing that URL. <p>Lynx also supports the newsgroup and message number URL scheme:<BR> -<tab indent="12"><em>news:newsgroup/startNo-endNo</em> <tab -id="ngno">(lists message range in newsgroup)<BR> -<tab indent="12"><em>news:newsgroup/messageNo</em> <tab -to="ngno">(retrieves the message by number)<BR> -<tab indent="12"><em>nntp://host:port/newsgroup/startNo-endNo</em><BR> -<tab indent="12"><em>nntp://host:port/newsgroup/messageNo</em><BR> +<pre> + <em>news:newsgroup/startNo-endNo</em> (lists message range in newsgroup) + <em>news:newsgroup/messageNo</em> (retrieves the message by number) + <em>nntp://host:port/newsgroup/startNo-endNo</em> + <em>nntp://host:port/newsgroup/messageNo</em> +</pre> (snews same as nntp, but the default port is <em>:563</em>)<BR> Use of this scheme is not recommended, because the message numbers are specific to each nntp server, unlike the unique identifiers for @@ -336,11 +360,11 @@ with SSL capable nntp servers, but the latter requires patches for built in SSL support, or use of a daemon which handles the secure communications on behalf of Lynx. -<p>The formats are:<BR> -<tab indent="12"><em>newspost://host:port/newsgroup(s)</em> <tab -id="ngp">(post a new message)<BR> -<tab indent="12"><em>newsreply://host:port/newsgroup(s)</em> <tab -to="ngp">(post a followup message)<BR> +<p>The formats are: +<pre> + <em>newspost://host:port/newsgroup(s)</em> (post a new message) + <em>newsreply://host:port/newsgroup(s)</em> (post a followup message) +</pre> (snewspost and snewsreply have the same formats, but the default port is <em>:563</em>) @@ -368,8 +392,10 @@ are supported only by Lynx. The mailto URL is used to provide links that when activated can be used to send a comment or the content of a FORM to an Internet email -address (user@host). The format is:<BR> -<tab indent="12"><em>mailto:user@host</em> +address (user@host). The format is: +<pre> + <em>mailto:user@host</em> +</pre> <p>The description of the mailto URL in RFC1738 has been interpreted by some as allowing only a single recipient, but Lynx invented the mailto URL, @@ -383,18 +409,18 @@ at the <em>?</em>, and uses the value as the default Subject: for the message or FORM content mailing. This is not recommended practice. The preferred way to indicate the default Subject: for a LINK or Anchor with a mailto HREF, or a FORM with a mailto ACTION, is via a TITLE -attribute with the subject string as its value, e.g.:<BR> -<tab indent="12"><em><LINK <tab id="rev">REV="made"<BR> -<tab to="rev">HREF="mailto:me@myhost,her@herhost" TITLE="The Subject"></em> +attribute with the subject string as its value, e.g.: +<pre> + <em><LINK REV="made" + HREF="mailto:me@myhost,her@herhost" TITLE="The Subject"></em> -<p><tab indent="12"><em><A -HREF="mailto:user@host" TITLE="The Subject">...</A></em> + <em><A HREF="mailto:user@host" TITLE="The Subject">...</A></em> -<p><tab indent="12"><em><FORM <tab id="met">METHOD="post" -ENCTYPE="text/plain"<BR> -<tab to="met">ACTION="mailto:WebMaster@host" TITLE="The Subject"><BR> -<tab indent="14">...<BR> -<tab indent="12"></FORM></em> + <em><FORM METHOD="post" ENCTYPE="text/plain" + ACTION="mailto:WebMaster@host" TITLE="The Subject"> + ... + </FORM></em> +</pre> <p>Note that a TITLE attribute for FORM is now included in the HTML specifications. Some clients use a SUBJECT attribute for this purpose @@ -425,14 +451,14 @@ normally would lead to a new scheme being used (e.g., <em>mail:</em>, or ACTION, Lynx will not hex escape the name=value pairs of the FORM's content, and will use physical newlines instead of '<em>&</em>' or '<em>;</em>' to separate the pairs, so that the content will be readable directly. -Otherwise, Lynx will mail the content with the default:<BR> -<tab indent="12" -><em>ENCTYPE="application/x-www-form-urlencoded"</em> <tab id="enc">('<em ->&</em>' separates pairs)<BR> -or:<BR> -<tab indent="12" -><em>ENCTYPE="application/sgml-form-urlencoded"</em> <tab to="enc">('<em ->;</em>' separates pairs)<BR> +Otherwise, Lynx will mail the content with the default: +<pre> + <em>ENCTYPE="application/x-www-form-urlencoded"</em> ('<em >&</em>' separates pairs) +</pre> +or: +<pre> + <em>ENCTYPE="application/sgml-form-urlencoded"</em> ('<em >;</em>' separates pairs) +</pre> if the latter was indicated. <p>Note that when mailing FORM content Lynx wraps any lines longer than 78 @@ -489,11 +515,15 @@ creation of links for any strings which appear to be supported URLs. The cso URL is intended to provide a gateway to CSO/PH (QI) servers. The requests are made on port 105 by default (<em>:105</em>), with the following overt cso URL format:<BR> -<tab indent="12"><em>cso://host</em><BR> +<pre> +<em>cso://host</em> +</pre> <p>You also can use a gopher URL format with port 105 and the CSO -(<em>2</em>) <em>gophertype</em> specified:<BR> -<tab indent="12"><em>gopher://host:105/2</em> +(<em>2</em>) <em>gophertype</em> specified: +<pre> + <em>gopher://host:105/2</em> +</pre> <p>Lynx will parse the stream returned by the server for the above URLs and create a FORM for submitting additional requests (searches) @@ -508,12 +538,12 @@ If execution of spawned commands has been enabled in your Lynx image, the lynxexec and lynxprog URLs can be used to execute arbitrary system commands or invoke system utilities. Any system command and associated switches or qualifiers can be used, with the syntax appropriate for a shell running -Lynx on Unix, or for DCL on VMS, e.g.:<BR> -<tab indent="12"><em>lynxexec:dir/date/size foo:[blah]</em> <tab -id="listing">(VMS)<BR> -<tab indent="12"><em>lynxexec:ls -l /foo/blah</em> <tab -to="listing">(Unix)<BR> -<tab indent="12"><em>lynxprog:news</em><BR> +Lynx on Unix, or for DCL on VMS, e.g.: +<pre> + <em>lynxexec:dir/date/size foo:[blah]</em> (VMS) + <em>lynxexec:ls -l /foo/blah</em> (Unix) + <em>lynxprog:news</em> +</pre> (Note, however, that restrictions on acceptable commands or utilities may be imposed by the system administrator.) @@ -532,10 +562,11 @@ solely for Lynx. <H2><a name="cgi">The <em>lynxcgi</em> URL:</a></H2> The lynxcgi URL is implemented only on Unix, can be used as the -ACTION for a FORM, and if enabled in your Lynx image has the format:<BR> -<tab indent="12"><em>ly<tab id="lh"> -nxcgi://localhost/path_to_CGI_script</em><BR> -<tab to="lh">where <em>//localhost/</em> is optional and always implied. +ACTION for a FORM, and if enabled in your Lynx image has the format: +<pre> + <em>lynxcgi://localhost/path_to_CGI_script</em> +</pre> +where <em>//localhost/</em> is optional and always implied. The output of the script should be text/html and is rendered and displayed by Lynx. (Note that restrictions on acceptable paths can be imposed by the system administrator.) @@ -559,15 +590,17 @@ objects for communication among its display modules. If you discover what they are, and are tempted to use them externally in documents, find the self-restraint to <em>resist</em> that temptation!!! -<p>For example, tempting though it might be, do <em>not</em> use these:<BR> -<tab indent="12" -><em>Return to your <A HREF="LYNXHIST:0">Startfile</A></em><BR> -<tab indent="12" -><em>Review your <A HREF="LYNXKEYMAP:">Keymap</A></em><BR> +<p>For example, tempting though it might be, do <em>not</em> use these: +<pre> + <em>Return to your <A HREF="LYNXHIST:0">Startfile</A></em> + <em>Review your <A HREF="LYNXKEYMAP:">Keymap</A></em> +</pre> (Yes, they'll work. No, they won't do any harm. But...) <p>If you <em>must</em> try one, the second is OK from the command line:<BR> -<tab indent="12"><em>lynx LYNXKEYMAP:</em><BR> +<pre> + <em>lynx LYNXKEYMAP:</em> +</pre> But within Lynx, use the '<em>K</em>' keystroke command. </BODY> </HTML> |