diff options
| author | Thomas E. Dickey <dickey@invisible-island.net> | 1998-02-28 21:10:46 -0500 |
|---|---|---|
| committer | Thomas E. Dickey <dickey@invisible-island.net> | 1998-02-28 21:10:46 -0500 |
| commit | 349da2fb30fd6d2be4bd47a95fee9915b50f6d67 (patch) | |
| tree | 3452a35c54ff9cddbd3348c878b2ea57c9b431df /lynx_help/Lynx_users_guide.html | |
| parent | 86b4d41a7463bd35cf662fc748aa338caef609c9 (diff) | |
| download | lynx-snapshots-349da2fb30fd6d2be4bd47a95fee9915b50f6d67.tar.gz | |
snapshot of project "lynx", label v2-8pre_2
Diffstat (limited to 'lynx_help/Lynx_users_guide.html')
| -rw-r--r-- | lynx_help/Lynx_users_guide.html | 734 |
1 files changed, 369 insertions, 365 deletions
diff --git a/lynx_help/Lynx_users_guide.html b/lynx_help/Lynx_users_guide.html index 303ce116..49cec8d3 100644 --- a/lynx_help/Lynx_users_guide.html +++ b/lynx_help/Lynx_users_guide.html @@ -18,7 +18,8 @@ well as files on remote systems running <em>http</em>, <em>gopher</em>, <em>cso</em>/<em>ph</em>/<em>qi</em> servers, and services accessible via logins to <em>telnet</em>, <em>tn3270</em> or <em>rlogin</em> accounts (see <a href="lynx_url_support.html">URL Schemes Supported by Lynx</a>). -<a href="#32">Current</a> versions of Lynx run on Unix and VMS. +<a href="#32">Current</a> versions of Lynx run on Unix, VMS, +Windows95/NT, 386DOS and OS/2 EMX. <p>Lynx can be used to access information on the <em>WWW</em>, or to build information systems intended primarily for local access. For example, Lynx @@ -75,11 +76,11 @@ information on navigating through the help files. and their key bindings is available by pressing the '<em>K</em>' key (or the '<em>k</em>' key if vi-like key movement is not on). [<A HREF="#TOC">ToC</A>] - + <h2><A NAME="2"><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> @@ -95,9 +96,10 @@ all be used to display an arbitrary ASCII text or HTML file: <dd><code>lynx sys$login:filename</code> <dd><code>lynx /sys$login/filename</code> <dt>Win32/DOS - <dd><code>lynx filename [???]</code> - <dd><code>lynx C:/dir/filename [???]</code> - <dd><code>lynx //n/dir/filename [???]</code> + <dd><code>lynx file:///filename</code> + <dd><code>lynx filename</code> + <dd><code>lynx c:/dir/filename</code> + <dd><code>lynx //n/dir/filename</code> </dl> <p>When executed, Lynx will clear the screen and display as much of the @@ -112,13 +114,13 @@ 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. - + <p>When Lynx displays an HTML file, it shows links as "bold face" -text, except for one link, which is shown as "highlighted" text. +text, except for one link, which is shown as "highlighted" text. Whether "boldface" or "highlighted" text shows up as reverse video, boldface type, or a color change, etc. depends on the display device being used (and the way in which that device has @@ -177,7 +179,7 @@ general form: <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. + each with its own protocol. <dt><code>HOST</code> <dd>is the Internet address of the computer system on which the @@ -192,20 +194,20 @@ 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> -</dl> +</dl> Lynx also will attempt to create a complete URL if you include adequate portions of it in the startfile argument. For example:<br> @@ -228,16 +230,16 @@ 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> <dt>win32 <dd><code>WWW_HOME=http://www.w3.org/ [or in registry]</code> -</dl> +</dl> Note that on VMS the double-quoting <em>must</em> be included to preserve casing. @@ -246,7 +248,7 @@ casing. The process of moving within a hypertext web, selecting and displaying links is known as "navigation." With Lynx almost all navigation can be -accomplished with the arrow keys and the numeric keypad. +accomplished with the arrow keys and the numeric keypad. <pre> +-------+-------+-------+ | TOP | /|\ | Page | @@ -283,7 +285,7 @@ and '<em>M</em>', will take you back to the starting document unless you specified the <em>-homepage=URL</em> option at the command line. Also, the LIST keystroke command, normally mapped to '<em>l</em>' and <em>L</em>', will create a compact list of all the links in the current document, and -they can be selected via that list. +they can be selected via that list. <p>The '<em>i</em>' key presents an index of documents. The default index is usually a document pointing to servers around the world, but the index @@ -315,7 +317,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. Any number of additional print options may also be +space. Any number of additional print options may also be available as configured by your system administrator. <p>Some options, such as <em>Save to a local file</em>, involve prompting @@ -417,7 +419,7 @@ options 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 @@ -454,7 +456,7 @@ to the net.bio.net WAIS server. [<A HREF="#TOC">ToC</A>] The Lynx <em>Options Menu</em> may be accessed by pressing the '<em>o</em>' key. The current <em>Options Menu</em> contains the following configurable -options. +options. <pre> Options Menu @@ -473,10 +475,10 @@ options. popups for selec(T) fields : ON show cursor (@) : OFF K)eypad mode : Numbers act as arrows li(N)e edit style : Default Binding - l(I)st directory style : Mixed style + l(I)st directory style : Mixed style U)ser mode : Advanced user (A)gent : [User-Agent header] - local e(X)ecution links : FOR LOCAL FILES ONLY + local e(X)ecution links : FOR LOCAL FILES ONLY </pre> An option can be changed by entering the capital letter or character in @@ -501,7 +503,7 @@ key to cycle through the choices, then press the <em>Return</em> key to finish the change. <p>When you are done changing options use the '<em>r</em>' command to -return to Lynx or the '<em>></em>' command to save the options to a +return to Lynx or the '<em>></em>' command to save the options to a <em>.lynxrc</em> file and return to Lynx. <p>The following table describes the options available on the @@ -511,7 +513,7 @@ return to Lynx or the '<em>></em>' command to save the options to a <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. + command should be specified when possible. <dt>DISPLAY variable <dd>This option is only relevant to X Window users. The DISPLAY @@ -519,7 +521,7 @@ return to Lynx or the '<em>></em>' command to save the options to a from the environment if it has been previously set. <dt>Multi-bookmarks - <dd>Lynx supports a default bookmark file, and up to 26 total + <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 @@ -560,14 +562,14 @@ return to Lynx or the '<em>></em>' command to save the options to a <dt>FTP sort criteria <dd>This option allows you to specify how files will be sorted - within FTP listings. The current options include + 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: + 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 lynx.cfg (the compilation default is not to send the header), or via the @@ -578,7 +580,7 @@ return to Lynx or the '<em>></em>' command to save the options to a (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. + case-insensitive manner. <dt>Preferred Document Language <dd>The language you prefer if multi-language files are available @@ -595,16 +597,16 @@ return to Lynx or the '<em>></em>' command to save the options to a 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 + 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 + 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 @@ -648,7 +650,7 @@ return to Lynx or the '<em>></em>' command to save the options to a 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> + 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, @@ -667,14 +669,14 @@ return to Lynx or the '<em>></em>' command to save the options to a 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). - + <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). - + <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. @@ -687,7 +689,7 @@ return to Lynx or the '<em>></em>' command to save the options to a 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. + 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 @@ -696,7 +698,7 @@ return to Lynx or the '<em>></em>' command to save the options to a 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 + 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. @@ -706,7 +708,7 @@ return to Lynx or the '<em>></em>' command to save the options to a 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> + 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 @@ -715,13 +717,13 @@ return to Lynx or the '<em>></em>' command to save the options to a help for more information. <dt>Line edit style - <dd>This option allows you to set alternate key bindings for the + <dd>This option allows you to set alternate key bindings for the built-in line editor, if your system administrator has installed alternates. 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 + <dd>Applies to Directory Editing. Files and directories can be presented in the following ways: <dl> <dt>Mixed style @@ -737,22 +739,22 @@ return to Lynx or the '<em>></em>' command to save the options to a <dt>User Mode <dd>There are three possible choices: Novice, Intermediate, and - Advanced. - <dl> + Advanced. + <dl> <dt>Novice - <dd>In Novice mode two lines of help are displayed at the + <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> + </dl> <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 + the <em>-restrictions</em> switch. Otherwise, the header can be changed temporarily to a string such as <em>L_y_n_x/2.8</em> for access to sites which discriminate against Lynx based on checks for the presence of "Lynx" in the header. If @@ -760,7 +762,7 @@ return to Lynx or the '<em>></em>' command to save the options to a be restored by deleting the modified string in the <em>Options Menu</em>. Whenever the User-Agent header is changed, the current document is reloaded, with the no-cache - flags set, on exit from the <em>Options Menu</em>. Changes of + flags set, on exit from the <em>Options Menu</em>. 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 @@ -771,29 +773,29 @@ return to Lynx or the '<em>></em>' command to save the options to a 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 + <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, + 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. + <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">ToC</A>] </dl> @@ -807,16 +809,16 @@ ownership is specified then comments are disabled. Certain links called you to send mail to other people. Using the mail features within Lynx is straightforward. -<p>Once you have decided to send a comment or have selected a +<p>Once you have decided to send a comment or have selected a <em>mailto:</em> link a new screen will appear showing you to whom you -are sending the message. Lynx will ask for your name, your e-mail -address, and the subject of the message. If you have filled in the +are sending the message. Lynx will ask for your name, your e-mail +address, and the subject of the message. If you have filled in the "personal mail address" field in the <em>Options Menu</em>, your e-mail address will be filled in automatically. After entering the above information, if you have an editor defined in the <em>Options Menu</em> and you are not an anonymous user then your specified editor will be spawned for you so that you can enter your message. If you do not have -an editor defined or you are an anonymous user, a simple line mode input +an editor defined or you are an anonymous user, a simple line mode input scheme will allow you to enter your message. <p>To finish sending the message, exit your spawned editor or, if you are @@ -836,28 +838,28 @@ href="http://www.w3.org/hypertext/DataSources/News/Groups/Overview.html" <em>Reply to: user@host</em> and, if the nntp server from which you received the article supports posting from your site, a link that says <em>Followup to: newsgroup(s)</em> - + <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 + <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 lynx.cfg 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">ToC</A>] + [<A HREF="#TOC">ToC</A>] </dl> <h2><A NAME="15"><em>Lynx bookmarks</em></A></h2> @@ -880,16 +882,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 @@ -911,7 +913,7 @@ and '<em>r</em>'emove commands may not work properly. <p>When multi-bookmarks (see <a href="#12">Options Menu</a>) is OFF, you will always view or add links to the default bookmark file. When it is STANDARD, a menu of up to 26 bookmark files will be invoked, -and you select the bookmark file by entering its letter token. When +and you select the bookmark file by entering its letter token. When it is ADVANCED, you will be prompted for the letter token, but can enter '<em>=</em>' to invoke the STANDARD selection menu, or <em>RETURN</em> for the default bookmark file. @@ -948,7 +950,7 @@ on your local system. The commands available in DIRED mode are <dd>Type '<em>c</em>' to create a new file. New file will be empty. <dt><code>D)ownload</code> -<dd>Type '<em>d</em>' to download selection using one of the options defined +<dd>Type '<em>d</em>' to download selection using one of the options defined by your system administrator. <dt><code>E)dit</code> @@ -956,8 +958,8 @@ on your local system. The commands available in DIRED mode are and load a selected file for editing. <dt><code>F)ull Menu</code> -<dd>Type '<em>f</em>' to show full menu of options available for selection. - Menu may vary according to type of file selected and compression +<dd>Type '<em>f</em>' to show full menu of options available for selection. + Menu may vary according to type of file selected and compression facilities available. <!-- List of full menu options --> @@ -970,13 +972,13 @@ 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> <dd>Type '<em>u</em>' to upload a file to the present directory. Upload methods are defined by your system administrator. -</dl> +</dl> [<A HREF="#TOC">ToC</A>] <h2><A NAME="18"><em>Scrolling and Other useful commands</em></A></h2> @@ -988,103 +990,103 @@ commands. <dl> <dt><em>^A</em> - <dd><em>Control-A</em> jumps you to the beginning of the current + <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. + <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 + <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="#12">Lynx Options Menu</A>). <dt><em>^F</em> - <dd><em>Control-F</em> normally jumps you to the next page of the + <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 + <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 + <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 + <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 + <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. + <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 [???]. + 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 + <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 + <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 + 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 + 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 + 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) + <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 + 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 + 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 + modification via the '<em>g</em>' command. Note that lower case 'e' invokes the editor for the current document. <dt><em>=</em> - <dd>The '<em>=</em>' command shows information about the current + <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 + <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 @@ -1093,7 +1095,7 @@ commands. 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> + <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 and other stderr messages will be sent to the screen @@ -1107,18 +1109,18 @@ commands. Note that this ability is disabled in anonymous or validation accounts. <dt><em>*</em> - <dd>The '<em>*</em>' command toggles image_links mode on and 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. + <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><em>[</em> - <dd>The '<em>[</em>' command toggles pseudo_inlines mode on and off. + <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., @@ -1126,7 +1128,7 @@ commands. 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 + <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. @@ -1134,9 +1136,9 @@ commands. 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. + headers, or treat it as invalid and return an error message. <dt><em>^K</em> - <dd><em>Control-K</em> invokes the <a + <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> @@ -1166,7 +1168,7 @@ 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> +<p> <dl> <dt>Buttons: <dd>Buttons are displayed in the same way that Lynx displays links in @@ -1204,10 +1206,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 @@ -1240,7 +1242,7 @@ button or box when you want to use Lynx keystrokes. <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 @@ -1400,7 +1402,7 @@ space before the content of each TH and TD start tag. This generally makes all of the content of the <em>table</em> readable, preserves most of the intra-cell organization, and makes all of the links in the <em>table</em> accessible, but any information critically dependent on the column and row -alignments intended for the <em>table</em> will be missed. +alignments intended for the <em>table</em> will be missed. <p>If inherently tabular data must be presented with Lynx, one can use PRE formatted content, or, if the <em>table</em> includes markup not allowed @@ -1417,7 +1419,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 @@ -1438,7 +1440,7 @@ clients, that is intended to create an array of simultaneously displayed, independently scrolling windows. Such windows have been termed <em>frames</em>. -<p>Lynx recognizes the Netscape and MicroSoft Explorer FRAME, FRAMESET, +<p>Lynx recognizes the Netscape and Microsoft Explorer FRAME, FRAMESET, and NOFRAMES elements, but is not capable of windowing to create the intended positioning of <em>frames</em>. Instead, Lynx creates labeled links to the <em>frame</em> sources, typically positioned in the upper @@ -1477,7 +1479,7 @@ a number of others which have subsequently been proposed. These <em>First</em>, <em>End</em>, <em>Last</em>, <em>Pointer</em>, <em>Translation</em>, <em>Definition</em>, <em>Chapter</em>, <em>Documentation</em>, <em>Biblioentry</em>, <em>Bibliography</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 @@ -1514,7 +1516,7 @@ or subsequent pages of the document are being displayed. href="http://www.w3.org/MarkUp/html3/Contents.html">HTML 3.0</a> BANNER container element, and will create a <em>banner</em> based on its content if one has not already been created based on LINK elements. Lynx -treats the MicroSoft MARQUEE element as a synonym for BANNER (i.e., +treats the Microsoft MARQUEE element as a synonym for BANNER (i.e., presenting it's markup as a static <em>banner</em>, without any horizontal scrolling of its content). Lynx does not prefix the BANNER or MARQUEE content with a '<em>#</em>' because the content need not be only a series @@ -1522,7 +1524,7 @@ of links with brief, descriptive links names, but does add a '<em>#</em>' at the top, left-hand corner of the screen when the content is not being displayed, to indicate it's accessibility via the TOOLBAR keystroke command. [<A HREF="#TOC">ToC</A>] - + <h2><A NAME="24"><em>Lynx and HTML Footnotes</em></a></h2> Lynx implements the <a @@ -1533,7 +1535,7 @@ 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> +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> activating that link will take you to the labeled rendering of: @@ -1561,7 +1563,7 @@ default label <em>NOTE:</em> will be used. Lynx recognizes the values <em>CAUTION:</em> or <em>WARNING:</em> will be used. The NOTE element can have an ID attribute, which will be treated as a named <em>A</em>nchor, as for <a href="#24">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 @@ -1578,8 +1580,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, @@ -1611,7 +1613,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, @@ -1685,7 +1687,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 @@ -1787,7 +1789,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>. The @@ -1795,7 +1797,7 @@ href="keystrokes/cookie_help.html">Cookie Jar Page</a>. The 'allow' settings, do not presently outlast the Lynx session. <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 @@ -1827,49 +1829,49 @@ 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 + <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 + <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> + <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 + <dd>can be selected from the following list, where items in all-caps indicate that a substitution must be made. - <dl> - <dt><code>-</code> - <dd>If the argument is only '<code>-</code>' (dash), then Lynx + <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). On VMS, it + <em>-post_data</em> arguments (see below). On VMS, it 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 + with '<em>$</em>'. On Unix, the keyboard input terminator is <em>Control-D</em>. On Win32, [???]. - <dt><code>-anonymous</code> - <dd>used to specify the anonymous account. - <dt><code>-assume_charset=MIMEname</code> - <dd>charset for documents that don't specify it. - <dt><code>-assume_local_charset=MIMEname</code> - <dd>charset assumed for local files. - <dt><code>-assume_unrec_charset=MIMEname</code> - <dd>use this instead of unrecognized charsets. + <dt><code>-anonymous</code> + <dd>used to specify the anonymous account. + <dt><code>-assume_charset=MIMEname</code> + <dd>charset for documents that don't specify it. + <dt><code>-assume_local_charset=MIMEname</code> + <dd>charset assumed for local files. + <dt><code>-assume_unrec_charset=MIMEname</code> + <dd>use this instead of unrecognized charsets. <dt><code>-auth=ID:PW</code> <dd>set authorization ID and password for protected documents at startup. Be sure to protect any script files which use @@ -1884,26 +1886,26 @@ where 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. + 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 - lynx.cfg. - <dt><code>-child</code> - <dd>exit on left-arrow in startfile, and disable save to disk. - <dt><code>-color</code> + <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 + lynx.cfg. + <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. @@ -1911,28 +1913,28 @@ where 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 + <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 + <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 edit mode using the specified + This can be used in the following way:<br> + <em>lynx -dump http://www.w3.org/</em> + <dt><code>-editor=EDITOR</code> + <dd>enable edit mode 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 + <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> @@ -1941,17 +1943,17 @@ where <dt><code>-locexec</code> <dd>enable local program execution from local files only (if lynx was compiled with local execution enabled). - <dt><code>-fileversions</code> + <dt><code>-fileversions</code> <dd>include all versions of files in local VMS directory listings. - <dt><code>-force_html</code> + <dt><code>-force_html</code> <dd>forces the first document to be interpreted as HTML. - <dt><code>-force_secure</code> + <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 + <dt><code>-from</code> + <dd>toggles transmissions of From headers to HTTP or HTTPS servers. - <dt><code>-ftp</code> + <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 @@ -1959,28 +1961,28 @@ where 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 + <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 + <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 + <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 + <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>-localhost</code> + <dd>disable URLs that point to remote hosts. <dt><code>-mime_header</code> <dd>include mime headers and force source dump. <dt><code>-minimal</code> @@ -1990,126 +1992,126 @@ where 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 + <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 + <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>-nopause</code> - <dd>disable forced pauses for statusline messages. - <dt><code>-noprint</code> - <dd>disable print functions. + <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>-nopause</code> + <dd>disable forced pauses for statusline messages. + <dt><code>-noprint</code> + <dd>disable 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>-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>-pauth=ID:PW</code> <dd>set authorization ID and password for a protected proxy - server at startup. Be sure to protect any script files + 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 lynx.cfg. + configuration can be changed in userdefs.h or lynx.cfg. It also can be set and saved via the 'o'ptions menu. - The command line switch toggles the default. + 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>'). - <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 + <dt><code>-preparsed</code> + <dd>show source preparsed and reformatted when used with + -source or in source view ('<em>\</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>This list is printed if no options are specified. - <dl> - <dt>all - <dd>restricts all options. - <dt>bookmark - <dd>disallow changing the location of the bookmark + <dl> + <dt>all + <dd>restricts all options. + <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>. - Disables default services for anonymous users. - Currently set to all restricted except for: - inside_telnet, outside_telnet, inside_news, + <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>. + Disables default services for anonymous users. + Currently set to all restricted except for: + inside_telnet, outside_telnet, inside_news, inside_ftp, outside_ftp, inside_rlogin, - outside_rlogin, jump, mail and goto. Defaults + outside_rlogin, jump, mail and goto. Defaults are settable within userdefs.h. - <dt>dired_support - <dd>disallow local file management. - <dt>disk_save - <dd>disallow saving to disk in the download and print + <dt>dired_support + <dd>disallow local file management. + <dt>disk_save + <dd>disallow saving to disk in the download and print menus. <dt>download <dd>disallow downloaders in the download menu. - <dt>editor + <dt>editor <dd>disallow editing. - <dt>exec + <dt>exec <dd>disable execution scripts. - <dt>exec_frozen - <dd>disallow the user from changing the local + <dt>exec_frozen + <dd>disallow the user from changing the local execution option. - <dt>file_url - <dd>disallow using G)oto, served links or bookmarks + <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>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 posting for people coming + <dd>disallow USENET news posting for people coming from inside you domain. <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>inside_telnet + <dd>disallow telnets for people coming from inside + your domain. <dt>jump <dd>disable the '<em>j</em>' (jump) command. <dt>mail @@ -2118,102 +2120,104 @@ where <dd>disallow multiple bookmarks. <dt>news_post <dd>disallow USENET News posting. - <dt>options_save - <dd>disallow saving options in .lynxrc. + <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 posting for people coming + <dd>disallow USENET news posting for people coming from outside you domain. <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 + <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 + <dt>suspend <dd>disallow <em>Control-Z</em> suspends with escape to shell on Unix. - <dt>telnet_port + <dt>telnet_port <dd>disallow specifying a port in telnet G)oto's. - <dt>useragent + <dt>useragent <dd>disallow modifications of the User-Agent header. - </dl> + </dl> - <dt><code>-resubmit_posts</code> + <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> + <dt><code>-rlogin</code> <dd>disable recognition of rlogin commands. - <dt><code>-selective</code> + <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 lynx.cfg. + <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 lynx.cfg. It also can be set and saved via the 'o'ptions menu. - The command line switch toggles the default. - <dt><code>-soft_dquotes</code> - <dd>toggles emulation of the old Netscape and Mosaic bug which + 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> + <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>-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 + <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 current + <dt><code>-tlog</code> + <dd>toggles use of a <em>Lynx Trace Log</em> for the current 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 TOGGLE_TRACE (<em>Control-T</em>) - keystroke command. Once a log is started for the session, + 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. - <dt><code>-trace</code> - <dd>turns on Lynx trace mode. If a Lynx Trace Log + <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 and other stderr messages are written to that log, and can be examined during the session via the TRACE_LOG (normally, '<em>;</em>') command. - <dt><code>-traversal</code> - <dd>traverse all http links derived from startfile. When + <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>-validate</code> - <dd>accept only http URLs (for validation). Complete + <dt><code>-underscore</code> + <dd>toggles use of _underline_ format in dumps. + <dt><code>-useragent=Name</code> + <dd>set alternate Lynx User-Agent header. + <dt><code>-validate</code> + <dd>accept only http URLs (for validation). Complete security restrictions also are implemented. - <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> + <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. @@ -2230,12 +2234,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 |