diff options
| author | Thomas E. Dickey <dickey@invisible-island.net> | 1996-09-02 19:39:24 -0400 |
|---|---|---|
| committer | Thomas E. Dickey <dickey@invisible-island.net> | 1996-09-02 19:39:24 -0400 |
| commit | e087f6d44e87f489fcb3056e86319ebba4218156 (patch) | |
| tree | d045b58011bfbbf5186d34c4fed9e0dedb363275 /lynx_help | |
| download | lynx-snapshots-e087f6d44e87f489fcb3056e86319ebba4218156.tar.gz | |
snapshot of project "lynx", label v2_6
Diffstat (limited to 'lynx_help')
| -rw-r--r-- | lynx_help/Lynx_users_guide.html | 1814 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/bookmark_help.html | 20 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/dired_help.html | 51 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/edit_help.html | 38 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/gopher_types_help.html | 59 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/history_help.html | 28 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/keystroke_help.html | 79 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/movement_help.html | 49 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/option_help.html | 164 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/other_help.html | 137 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/print_help.html | 37 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/scrolling_help.html | 58 | ||||
| -rw-r--r-- | lynx_help/keystroke_commands/xterm_help.html | 32 | ||||
| -rw-r--r-- | lynx_help/lynx_help_main.html | 87 | ||||
| -rw-r--r-- | lynx_help/lynx_url_support.html | 493 |
15 files changed, 3146 insertions, 0 deletions
diff --git a/lynx_help/Lynx_users_guide.html b/lynx_help/Lynx_users_guide.html new file mode 100644 index 00000000..af4b7efc --- /dev/null +++ b/lynx_help/Lynx_users_guide.html @@ -0,0 +1,1814 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<html> +<head> +<title>Lynx Users Guide v2.6</title> +<link rev="made" href="mailto:lynx-dev@sig.net"> +</head> + +<body> +<h1>Lynx Users Guide Version 2.6</h1> + +Lynx is a fully-featured <em>World Wide Web</em> (<em>WWW</em>) client +for users running cursor-addressable, character-cell display devices (e.g., +vt100 terminals, vt100 emulators running on PCs or Macs, or any other +character-cell display). It will display <em>Hypertext Markup Language</em> +(<em>HTML</em>) documents containing links to files on the local system, as +well as files on remote systems running <em>http</em>, <em>gopher</em>, +<em>ftp</em>, <em>wais</em>, <em>nntp</em>, <em>finger</em>, or +<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="#31">Current</a> versions of Lynx run on Unix and VMS. + +<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 +has been used to build several <em>Campus Wide Information Systems</em> +(<em>CWIS</em>). In addition, Lynx can be used to build systems isolated +within a single LAN. + +<h2><A NAME="TOC"><em>Table of Contents</em></A></h2> + +<ul> +<li><A HREF="#1">Lynx online help</A> +<li><A HREF="#2">Viewing local files with Lynx</A> +<li><A HREF="#3">Leaving Lynx</A> +<li><A HREF="#4">Starting Lynx with a Remote File</A> +<li><A HREF="#5">Starting Lynx with the WWW_HOME environment variable.</A> +<li><A HREF="#6">Navigating hypertext documents with Lynx</A> +<li><A HREF="#7">Printing, Mailing, and Saving rendered files to disk.</A> +<li><A HREF="#8">Viewing the HTML document source and editing documents</A> +<li><A HREF="#9">Downloading and Saving source files.</A> +<li><A HREF="#10">Reloading files and refreshing the display</A> +<li><A HREF="#11">Lynx searching commands</A> +<li><A HREF="#12">Lynx Options Menu</A> +<li><A HREF="#13">Comments and mailto: links</A> +<li><A HREF="#14">USENET News posting</A> +<li><A HREF="#15">Lynx bookmarks</A> +<li><A HREF="#16">Jump command</A> +<li><A HREF="#17">Directory Editing</A> +<li><A HREF="#18">Scrolling and Other useful commands</A> +<li><a href="#19">Lynx and HTML Forms</a> +<li><a href="#20">Lynx and HTML Tables</a> +| <a href="#21">Lynx and HTML Tabs</a> +<li><a href="#22">Lynx and HTML Frames</a> +| <a href="#23">Lynx and HTML Banners</a> +<li><a href="#24">Lynx and HTML Footnotes</a> +| <a href="#25">Lynx and HTML Notes</a> +<li><a href="#26">Lynx and HTML Lists</a> +<li><a href="#27">Lynx and HTML Quotes</a> +<li><a href="#28">Lynx and Client-Side-Image-Maps</a> +<li><a href="#29">Lynx and Client-Side-Pull</a> +<li><A HREF="#30">The Lynx command line</A> +<li><A HREF="#31">Lynx development history</A> +</ul> + +<h2><A NAME="1"><em>Lynx online help</em></A></h2> + +Online help is available while viewing any document. Press the +'<em>?</em>' or '<em>H</em>' key (or the '<em>h</em> key if vi-like +key movement is not on) to see a list of help topics. See the section +titled <A HREF="#6">Navigating hypertext documents with Lynx</A> for +information on navigating through the help files. + +<p>In addition, a summary description of all the Lynx keystroke commands +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 +all be used to display an arbitrary ASCII text or HTML file: + +<dl> + <dt>UNIX + <dd><code>lynx filename</code> + <dd><code>lynx /home/my-dir/filename</code> + <dd><code>lynx ~/filename</code> + <dt>VMS + <dd><code>lynx filename</code> + <dd><code>lynx dua5:[my-directory]filename</code> + <dd><code>lynx /dua5/my-directory/filename</code> + <dd><code>lynx ~/filename</code> + <dd><code>lynx sys$login:filename</code> + <dd><code>lynx /sys$login/filename</code> +</dl> + +<p>When executed, Lynx will clear the screen and display as much of the +specified file as will fit on the screen. Pressing a <em>down-arrow</em> +will bring up the next screen, and pressing an <em>up-arrow</em> will bring +up the previous screen. If no file is specified at startup, a default file +will be displayed. (The default is configured by the system administrator +when the command is installed.) + +<p>Lynx will display local files written in the <em>HyperText Markup +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 +<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. +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 +been configured). Lynx has no control over the exact presentation +of links. + +<p>The one link displayed as "highlighted" text is the currently +"selected" link. Lynx will display the file associated with the +selected link when a <em>right-arrow</em> or a <em>Return</em> key is +pressed. To select a particular link, press the <em>up-arrow</em> or +<em>down-arrow</em> keys until the desired link becomes "highlighted," +and then press the <em>right-arrow</em> or <em>Return</em> key to view +the linked information. Information included in the HTML file tells Lynx +where to find the linked file and what kind of server will provide it +(i.e. HTTP, Gopher, etc.). + +<p>Lynx renders HTML files and saves the rendition, not the source, +for initial display and should you select the link again. If you do +select a link again and have reason to desire a new fetch and rendering +of the file, use the NOCACHE command, normally mapped to '<em>x</em>' and +'<em>X</em>', instead of the <em>right-arrow</em> or <em>Return</em> key +when positioned on the link. You also can force a new fetch and rendering +of the currently displayed document via the RELOAD command, normally mapped +to <EM>Control-R</em>. + +<p>When a binary file is encountered Lynx will ask the user if he/she +wishes to download the file or cancel. If the user selects '<em>D'</em> +for download, Lynx will transfer the file into a temporary location and +present the user with a list of options. The only default option is +<em>Save to disk</em>, which is disabled if Lynx is running in anonymous +mode. Any number of additional download methods may be defined in the +lynx.cfg file by the system administrator. Programs like kermit, zmodem +and FTP are some possible options. [<A HREF="#TOC">ToC</A>] + +<h2><A NAME="3"><em>Leaving Lynx</em></A></h2> + +To exit Lynx use the '<em>q</em>' command. You will be asked whether +you really want to quit. Answering '<em>y</em>' will exit and '<em>n</em>' +will return you to the current document. Use '<em>Q</em>' or +<em>Control-D</em> to quit without verification. [<A HREF="#TOC">ToC</A>] + +<h2><A NAME="4"><em>Starting Lynx with a Remote File</em></A></h2> + +If you wish to view a remote file (that is, a file residing on +some computer system other than the one upon which you are running +Lynx) without first viewing a local file, you must identify that +file by using a Uniform Resource Locator (URL). URLs take the +general form: + +<p><code>PROTOCOL :// HOST / PATH</code> + +<p>where + +<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. + + <dt><code>HOST</code> + <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. +</dl> + +Here are some sample URLs. + +<dl> + <dt>HTTP (HyperText Transfer Protocol) + <dd><code>http://www.nyu.edu/pages/wsn/subir/lynx.html</code> + + <dt>Gopher + <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> + + <dt>WAIS (Wide Area Information Service protocol) + <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> + +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> +See <a href="lynx_url_support.html">URL Schemes Supported by Lynx</a> for +more detailed information. [<A HREF="#TOC">ToC</A>] + +<h2><A NAME="5" +><em>Starting Lynx with the WWW_HOME environment variable.</em></A></h2> + +You may also specify a starting file for Lynx using the WWW_HOME +environment variable, +<dl> + <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> + </dl> + <dt>VMS + <dd><code>define "WWW_HOME" "http://www.w3.org/"</code> +</dl> + +Note that on VMS the double-quoting <em>must</em> be included to preserve +casing. + +<h2><A NAME="6"><em>Navigating hypertext documents with Lynx</em></A></h2> + +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. +<pre> + +-------+-------+-------+ + | TOP | /|\ | Page | + arrow keys | of | | | UP | + | text 7| | 8| 9| + +---------+ +-------+-------+-------+ + | SELECT | | | | | + | prev /|\| | <--- | | ---> | + | link | | | 4| 5| 6| + +---------+---------+---------+ +-------+-------+-------+ + | BACK | SELECT | DISPLAY | | END | | | Page | + |<-- prev | next | | sel. -->| | of | | | DOWN | + | doc. | link \|/| link | | text 1| \|/ 2| 3| + +---------+---------+---------+ +-------+-------+-------+ +</pre> + +There are also a few other keyboard commands to aid in navigation. The +Control and Function keys used for navigation within the current document +are described in <A +HREF="#18"><em>Scrolling and Other useful commands</em></A>. Some +additional commands depend on the fact that Lynx keeps a list of each +file you visit called the <a href="keystroke_commands/history_help.html" +>History Page</a>. The <em>Backspace</em> +or <em>Delete</em> key will show you the <em>History Page</em> of links +preceding your access to the current document. Any of the previous +documents shown in the list may be revisited by selecting them from the +history screen. The '<em>m</em>' key command 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 activated 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 +can be changed by the system administrator or on the command line using +the <em>-index</em> switch, and therefore depends on how the Lynx program +you are using was configured. + +<p>If you choose a link to a server with active access authorization, Lynx +will automatically prompt for a username and a password. If you give the +correct information, you will then be served the requested information. +Lynx will automatically send your username and password to the same server +if it is needed again. [<A HREF="#TOC">ToC</A>] + +<h2><A NAME="7" +><em>Printing, Mailing, and Saving rendered files to disk.</em></A></h2> + +Rendered HTML documents, and plain text files, may be printed using the +'<em>p</em>' command while viewing the document. After pressing the +'<em>p</em>' key a menu of <em>Print Options</em> will be displayed. The +menu will vary according to several factors. First, some sites set up +special accounts to let users run Lynx to access local information systems. +Typically these accounts require no passwords and do not require users to +identify themselves. As a result such accounts are called "anonymous" +accounts, and their users are considered "anonymous" users. In most +configurations, all Lynx users (including anonymous users) are able to +mail files to themselves and print the entire file to the screen. + +<p>Additional print options are available for users who are using +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 +available as configured by your system administrator. + +<p>Some options, such as <em>Save to a local file</em>, involve prompting +for an output filename. All output filename entries are saved in a +circular buffer, and any previous entries can be retrieved for re-use by +pressing the <em>up-arrow</em> or <em>down-arrow</em> keys at the prompt. +[<A HREF="#TOC">ToC</A>] + +<h2><A NAME="8" +><em>Viewing the HTML document source and editing documents</em></A></h2> + +When viewing HTML documents it is possible to retrieve and display the +unrendered (i.e., the original HTML) source of the document by pressing +the '<em>\</em>' (backslash) key. The document must be reloaded from the +server or disk to be displayed on the screen unrendered, since Lynx +originally rendered what it received and does not still have it as source. +When viewing unrendered documents you may print them as any normal document. + +<p>Selecting the <em>Print to a local file</em> option from the Print Menu, +makes it possible to save the source of the document to disk so that you +may have a local copy of the document source, but it is better to <a +href="#9">Download</a> the source. + +<p>NOTE: When saving an HTML document it is important to name the +document with a <em>.html</em> extension, if you want to read it with +Lynx again later. + +<p>Lynx can allow users to edit documents that reside on the local +system. To enable editing, documents must be referenced using a +"file:" URL or by specifying a plain filename on the command line as +in the following two examples: + +<dl> +<dt>Command + <dd><code>lynx file://localhost/FULL/PATH/FILENAME</code> + <dd><code>lynx path/filename.html</code> +</dl> + +In addition, the user must also specify an editor in the +<em>Options Menu</em> so that Lynx knows which editor to use. If the +file is specified correctly and an editor is defined, then you may edit +documents by using the '<em>e</em>' command. When the '<em>e</em>' +command is entered your specified editor is spawned to edit the file. +After changes are completed, exit your editor and you will return to Lynx. +Lynx will reload and render the file so that changes can be immediately +examined. [<A HREF="#TOC">ToC</A>] + +<h2><A NAME="9"><em>Downloading and Saving source files.</em></A></h2> + +If the DOWNLOAD keystroke command ('<em>d</em>' or <em>D</em>) is used +when positioned on a link for an HTML, plain text, or binary file, Lynx +will transfer the file, without rendering or modification, into a temporary +location and present the user with a list of options, as when a link for a +binary file of a type for which no viewer has been mapped is activated. +As described above, the only default <em>Download option</em> is +<em>Save to disk</em>, which is disabled if Lynx is running in +anonymous mode, and any number of additional download methods such as +kermit and zmodem may be defined in the <em>lynx.cfg</em> file by the +system administrator. Downloading the sources of HTML and plain text +files, instead of toggling to <a href="#8">display the source</a> +('<em>\</em>') and then using <a href="#7">Printing</a> options, ensures +that no modifications of the source (e.g., expansions of tab characters +to a series of spaces) will occur. + +<p>Some options, such as <em>Save to disk</em>, involve prompting for an +output filename. All output filename entries are saved in a circular buffer, +and any previous entries can be retrieved for re-use by pressing the +<em>up-arrow</em> or <em>down-arrow</em> keys at the prompt. +[<A HREF="#TOC">ToC</A>] + +<h2><A NAME="10" +><em>Reloading files and refreshing the display</em></A></h2> + +The RELOAD (<em>Control-R</em>) command will reload and re-render the file +that you are currently viewing. The REFRESH (<em>Control-L</em> or +<em>Control-W</em>) command will refresh or wipe the screen to remove or +correct any errors that may be caused by operating system or other messages. + +<p>The NOCACHE ('<em>x</em>' or '<em>X</em>') command can be used in lieu +of ACTIVATE (<em>Return</em> or <em>right-arrow</em>) to request an uncached +copy and new rendition for the current link, or resubmission of a FORM, if a +cache from a previous request or submission exits. The request or submission +will include <em>Pragma: no-cache</em> and <em>Cache-Control: no-cache</em> +in its headers. Note that FORMs with POST content will be resubmitted +regardless of whether the NOCACHE or ACTIVATE command is used (see <A +HREF="#19"><em>Lynx and HTML Forms</em></A>). [<A HREF="#TOC">ToC</A>] + +<h2><A NAME="11"><em>Lynx searching commands</em></A></h2> + +Two commands activate searching in Lynx: '<em>/</em>' and '<em>s</em>'. + +<p>While viewing a normal document use the '<em>/</em>' command to find a +word or phrase within the current document. The search type will depend on +the search option setting in the <a href="#12">Options Menu</a>. The search +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 +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 +statusline prompt to enter a query string. The prompt can be specified via +a PROMPT attribute in the ISINDEX element. Otherwise, Lynx will use an +internally configured prompt. The address for submitting the search can be +specified via an HREF or ACTION attribute. Otherwise, Lynx will use the +current document's URL and append your query string as a <em>?searchpart</em> +(see <a href="lynx_url_support.html">Supported URLs</a>). + +<p>All search words or strings which you have entered during a Lynx session +are saved in a circular buffer, and can be retrieved for re-use by pressing +the <em>up-arrow</em> or <em>down-arrow</em> keys at the prompt for a search +word or string. Also, you can use the '<em>n</em>' command to repeated a +search with the last-entered search word or phrase, starting from the current +position in the document. The word or phrase matches will be highlighted +throughout the document, but such highlighting will not persist for new +documents, or if the current document is reloaded. The search cycles to the +top of the document if the word or phrase is not located below your current +position. + +<p>Although <a href="#19">HTML Forms</a> have largely replaced index +documents for searches via http servers, they are still useful for performing +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> +for submitting a search of the Biologist's Addresses database directly +to the net.bio.net WAIS server. [<A HREF="#TOC">ToC</A>] + +<h2><A NAME="12"><em>Lynx Options Menu</em></A></h2> + +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. + +<pre> + Options Menu + + E)ditor : emacs + D)ISPLAY variable : aixtest.cc.ukans.edu:0.0 + B)ookmark file : home_page + F)TP sort criteria : By Filename + P)ersonal mail address : montulli@ukanaix.cc.ukans.edu + S)earching type : CASE INSENSITIVE + display (C)haracter set : ISO Latin 1 + raw 8-bit or CJK m(O)de : ON + preferred document lan(G)uage: en + preferred document c(H)arset : NONE + V)I keys : OFF + e(M)acs keys : OFF + K)eypad mode : Numbers act as arrows + l(I)st directory style : Mixed style + sho(W) dot files : OFF + U)ser mode : Advanced + user (A)gent : [User-Agent header] + L)ocal execution links : Always off +</pre> + +An option can be changed by entering the capital letter of the option +you want to change (i.e. '<em>E</em>' for Editor). For fields where text +must be entered, simply enter the text by typing on the keyboard. The +<a href="keystroke_commands/edit_help.html">Line Editor</a> can be used +to correct mistakes, and <em>Control-U</em> can be used to erase the whole +line. When you are done entering a change press the <em>Return</em> key +to get back to the <em>Command?</em> prompt. + +<p>For fields where you must choose from a list of choices, press any key +to toggle the choices and 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 +<em>.lynxrc</em> file and return to Lynx. + +<p>The following table describes the options available on the +<em>Options Menu</em>: + +<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. + + <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. + + <dt>Bookmark file + <dd>This is the filename and location of your personal bookmark + file. The bookmark file allows frequently traveled links to + be stored in a personal easy to access file. Using the + '<em>a</em>' command (see below) you may save any link into + your bookmark file. If the path specified does not begin with + a slash then the path will reference your home directory. + + <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>". + + <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 all HTTP get requests if inclusion of that HTTP header + has not been disabled via the NO_FROM_HEADER definition in + lynx.cfg or via the <em>-nofrom</em> command line option. + + <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. + + <dt>Display Character set + <dd>This option allows you to set up the default character set for + your specific terminal. The character set provides a mapping + of 8-bit ISO Latin character entities and/or Asian (CJK) + characters into viewable characters and should be set in + relation to your terminal's character set if you will be + viewing such characters with Lynx. You must have the selected + character set installed on your terminal. + + <dt>Raw 8-bit or CJK Mode + <dd>Whether 8-bit characters are are assumed to correspond with + the selected character set and therefore are processed without + translation via the ISO Latin 1 conversion tables. Should be + ON by default when the selected character set is ISO Latin 1, + or is one of the Asian (CJK) sets and the 8-bit characters are + Kanji multibytes. Should be OFF for the other character sets, + but can be turned ON when there's a match, e.g., the document's + charset is ISO-8859-2 and ISO Latin 2 has been selected. Should + be OFF when an Asian (CJK) set is selected but the document is + ISO-8850-1. The setting also can be toggled via the RAW_TOGGLE + command, normally mapped to '<em>@</em>', and at startup via the + <em>-raw</em> switch. + + <dt>Preferred Document Language + <dd>The language you prefer if multi-language files are available + from servers. Use MIME abbreviations, e.g., en for English, + fr for French, etc. Can be a comma-separated list in descending + order of preferences. + + <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 in descending order of preferences. + + <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). + + <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>Keypad as arrows or numbered links + <dd>This option gives the choice between navigating with the arrow + keys or having every link numbered so that the links may be + selected by numbers as well as using the arrow keys. + + <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> + + <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. + + <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> + + <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.6</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 + <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 + 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 <em>Options Menu</em> 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">ToC</A>] +</dl> + +<h2><A NAME="13"><em>Comments and mailto: links</em></A></h2> + +At any time while viewing documents within Lynx, you may use the +'<em>c</em>' command to send a mail message to the owner of the current +document if the author of the document has specified ownership. If no +ownership is specified then comments are disabled. Certain links called +<a href="lynx_url_support.html#mailto">mailto:</a> links will also allow +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 +<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 +"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 +scheme will allow you to enter your message. + +<p>To finish sending the message, exit your spawned editor or, if you are +using the simple line mode input scheme, type a '<em>.</em>' (period) on +a line by itself. You will be asked a final time whether to send the +message. If you press '<em>y</em>' then the message will be sent, if you +press '<em>n</em>' the message will be deleted. [<A HREF="#TOC">ToC</A>] + +<h2><A NAME="14"><em>USENET News posting</em></A></h2> + +While reading <a +href="http://www.w3.org/hypertext/DataSources/News/Groups/Overview.html" +>news</a> articles with Lynx you should see a link that says +<em>Reply to: user@host</em> and 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. + + <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 + that the message may be cross-posted to. You will be given + the option of including the original message in your reply. + Once you have typed in your message the <em>inews</em> program + will be called to post your message to your news host. + [<A HREF="#TOC">ToC</A>] +</dl> + +<h2><A NAME="15"><em>Lynx bookmarks</em></A></h2> + +It is often useful to place a bookmark to aid in returning quickly to +a document. To use the bookmark feature you must first use the +<em>Options Menu</em> to specify a bookmark filename. + +<p>To save a bookmark to the document you wish to place in the +bookmark file press the '<em>a</em>' key and you will be asked + +<dl> +<dt> + <dd><code>Save D)ocument or L)ink to bookmark + file or C)ancel? (d,l,c):</code> +</dl> + +Answer '<em>d</em>' to save a link to the document you are currently +viewing or '<em>l</em>' to save the link that is currently selected on +the page. Selecting '<em>c</em>' will cancel without saving anything to +your bookmark file. + +<p>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 +would any other link. You can remove a link from the bookmark list by +pressing the '<em>r</em>' key when positioned on that link. +[<A HREF="#TOC">ToC</A>] + +<h2><a NAME="16"><em>Jump Command</em></a></h2> + +A feature similar to the Lynx bookmarks is the jump command. The jump +command allows you to enter a shortcut name to access a URL. If the jump +feature is active, typing '<em>j</em>' will produce a prompt where you may +enter the shortcut name. Type '<em>?</em>' at the jump prompt for a list +of shortcut names available. + +<p>All jump shortcut entries are saved in a circular buffer, and any +previous entries can be retrieved for re-use by pressing the +<em>up-arrow</em> or <em>down-arrow</em> keys at the prompt. + +<p>Note to System Administrators: Read the <em>lynx.cfg</em> file on how +to set up the jump command for your system and how to define shortcut names. +[<A HREF="#TOC">ToC</A>] + +<h2><a NAME="17"><em>Directory Editing</em></a></h2> + +Lynx offers extended DIRED support on Unix (on VMS the more powerful +CSwing program is recommended for character cell terminals, and can be +offered via Lynx as a jump shortcut or execution link). When a local +directory is accessed using a URL of the form +<em>file://localhost/path/</em>, a new set of commands is available. +With DIRED support you can create, edit, delete, copy, and move files +on your local system. The commands available in DIRED mode are + +<dl> +<dt><code>C)reate</code> +<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 + by your system administrator. + +<dt><code>E)dit</code> +<dd>Type '<em>e</em>' to spawn the editor defined in <em>Options Menu</em> + 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 + facilities available. + +<!-- List of full menu options --> +<dt><code>M)odify</code> +<dd>Type '<em>m</em>' to modify the name or location of file. Then type + '<em>n</em>' to rename the file or '<em>l</em>' to move the file to + a different location. + +<dt><code>R)emove</code> +<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 + 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> +[<A HREF="#TOC">ToC</A>] + +<h2><A NAME="18"><em>Scrolling and Other useful commands</em></A></h2> + +A summary of all the keystroke commands and their key bindings can +be invoked via the KEYMAP command, normally mapped to '<em>k</em>' and +'<em>K</em>'. The following describes some of the most commonly used +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 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 + 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="#12">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. + <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. + <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. + <dt><em>)</em> + <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. + <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. + <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. + <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 be accessed at + the prompt by pressing the <em>up-arrow</em> or + <em>down-arrow</em> keys. + <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. + <dt><em>^T</em> + <dd><em>Control-T</em> toggles 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 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 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. + <dt><em>[</em> + <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. + <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. + [<A HREF="#TOC">ToC</A>] +</dl> + +<h2><a name="19"><em>Lynx and HTML Forms</em></a></h2> + +This section describes the Lynx Forms Interface. HTML gives document +providers the ability to create on-line forms which may be filled out +when the document is viewed. When a form is submitted the information +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 + a document. To "push" the button press the <em>right-arrow</em> or + <em>Return</em> key. + +<dt>Checkboxes and Radio buttons +<dd>Checkboxes are displayed as square brackets: <em>[ ]</em> and radio + buttons are displayed as parenthesis: <em>( )</em>. When a box is + checked or a button selected, an <em>x</em> appears in the brackets: + <em>[x]</em> or an asterisk appears within the parenthesis: + <em>(*)</em>. To check a box or select a radio button press the + <em>right-arrow</em> or <em>Return</em> key. + +<dt>Selection Fields +<dd>Selection fields are displayed as brackets with the default option + displayed between them: <em>[default__]</em>. To select an option + press the <em>right-arrow</em> or <em>Return</em> key. A box with + a border of asterisks (or line-drawing characters) will pop up with + the list of possible options listed within the box. Use the + <em>up-arrow</em> and <em>down-arrow</em> keys to move the cursor + between options and the <em>right-arrow</em> or <em>Return</em> + key to select an option. + +<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 + href="keystroke_commands/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 + 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 + entry field. NOTE, however, that <em>Return</em> also will <a + href="#submit">submit</a> the form if the text entry field is the + only non-hidden field in the form. +<dd>TEXTAREA fields are handled as if they were a series of text entry + (INPUT) fields for which successive lines imply a newline at the end of + the preceding line. You enter text on each line to construct the overall + message. Any blank lines at the bottom of the TEXTAREA field will be + eliminated from the submission. The <em>up-arrow</em>, and + <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, or to the first line on the next page if the overall field + extends beyond the currently displayed page. +</dl> + +In general, you can move around the form using the standard Lynx navigation +keys. The <em>up-arrow</em> and <em>down-arrow</em> keys, respectively, +select the previous or next field, box, or button. The <em>TAB</em> key +selects the next field (or next page of a TEXTAREA if it extends onto the +next page), box, or button. + +<p><em>NOTE:</em> If you have a text input field selected you will not +have access to most of the Lynx keystroke commands, because they are +interpreted by the <a href="keystroke_commands/edit_help.html" +>Line Editor</a> as either text entries or editing commands. Select a +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 +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 +the same content as previously, use the RESUBMIT command ('<em>x</em>') when +positioned on the submit button. The <em>right-arrow</em> and <em>Return</em> +keys also will invoke a no-cache resubmission if the form's source included a +META tag 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> + +<p>Forms which have <em>POST</em> as the METHOD, or a <a +href="lynx_url_support.html#mailto">mailto:</a> URL as the ACTION, are always +resubmitted, even if the content has not changed, when you activate the +<em>submit</em> button. Lynx normally will not resubmit a form which has +<em>POST</em> as the METHOD if the document returned by the form has links +which you activated, and then you go back via the PREV_DOC +(<em>left-arrow</em>) command or via the <a +href="keystroke_commands/history_help.html">History Page</em>. Lynx can be +compiled so that it resubmits the form in those cases as well, and the default +can be changed via <em>lynx.cfg</em>, and toggled via the +<em>-resubmit_posts</em> command line switch. + +<p>If the form has one <em>text entry</em> field and no other fields except, +possibly, hidden INPUT fields not included in the display, then that field +also serves as a <em>submit</em> button, and pressing <em>right-arrow</em> +or <em>Return</em> on that field will invoke submission of the form. Be +sure to use <em>up-arrow</em>, <em>down-arrow</em> or <em>TAB</em> to move +off the text entry field, in such cases, if it is not your intention to +submit the form (or to retrieve what was returned from an earlier submission +if the content was not changed and the METHOD was <em>GET</em>). + +<p>Forms can have multiple <em>submit</em> buttons, if they have been +assigned names in the markup. In such cases, information about which +one of the buttons was used to submit the form is included in the form +content. + +<p>Inlined images can be used as submit buttons in forms. If such +buttons are assigned names in the markup, for graphic clients they can +also serve as <a href="#28">image maps</a>, and the x,y coordinates of +the graphic client's cursor position in the image when it was +<em>clicked</em> are included in the form content. Since Lynx cannot +inline the image, and the user could not have moved a cursor from the +origin for the image, if no alternatives are made available in the +markup Lynx sends a 0,0 coordinate pair in the form content. Document +authors who use images as submit buttons, but have at least some concern +for text clients and sight-challenged Webizens, should include values for +the buttons in such markup. Lynx will then display the string assigned +to the value, as it would for a normal submit button, and will send that +instead of an artificial 0,0 coordinate pair if that button is named and +is used to submit the form. The script which analyzes the form content +thus can be made aware whether the submission was by a user with a graphic +client, or by a user who did not see the image nor make a conscious choice +within it. + +<p>Forms can have <em>hidden</em> INPUT fields, which are not displayed, +but have names and values included in the content. These often are used +to keep track of information across a series of related form submissions, +but have the potential for including information about the user that might +be considered to represent an invasion of privacy. NOTE, in this regard, +that Lynx has implemented the <a +href="http://www.w3.org/pub/WWW/MarkUp/html3/Contents.html">HTML 3.0</a> +<em>DISABLED</em> attribute for <em>all</em> of its form fields. These +can be used to keep track of information across submissions, and to cast +it unmodifiable in the current form, but keep the user aware that it will +be included in the submission. + +<p>Forms most commonly are submitted to http servers with the content encoded +as <em>ENCTYPE="application/x-www-form-urlencoded"</em> for analysis by a +script, and Lynx treats that as the default if no ENCTYPE is specified in the +FORM tag. However, you can specify a <a +href="lynx_url_support.html#mailto">mailto</a> URL as the form's ACTION to +have the form content sent, instead, to an email address. In such cases, you +may wish to specify <em>ENCTYPE="text/plain"</em> in the form markup, so that +the content will not be encoded, but remain readable as plain text. + +<p>Lynx also supports <em>ENCTYPE="application/sgml-form-urlencoded"</em> +for which all reserved characters in the content will be hex escaped, as +with <em>application/x-www-form-urlencoded</em>, but semicolons +('<em>;</em>') instead of ampersands ('<em>&</em>') will be used as +the separator for name=value pairs in the form content. The use of +semicolons is preferred for forms with the <em>GET</em> METHOD, because +the <em>GET</em> METHOD causes the encoded form content to be appended +as a <em>?searchpart</em> for the form's ACTION, and if such URLs are used +in <em>text/html</em> documents or bookmark files without conversion +of the ampersands to SGML character references (<em>&amp;</em> or +<em>&#38;</em>), their being followed by form field names which might +correspond to SGML entities could lead to corruption of the intended URL. + +<p>NOTE, in this regard, that Lynx converts ampersands to <em>&amp;</em> +when creating bookmarks, and thus the bookmark links will not be vulnerable +to such corruptions. Also NOTE that Lynx allows you to save links in your +bookmark file for documents returned by forms with the <em>GET</em> METHOD, +and which thus have the content appended as a <em>?searchpart</em>, but not +if the METHOD was <em>POST</em>, because the content would be lost and the +link thus would be invalid. + +<p>Lynx does not yet support <em>ENCTYPE="multipart/form-data"</em> for +sending form content with name=value pairs encoded as multipart sections +with individual MIME headers and terminators. If the FORM tag indicates +that ENCTYPE, Lynx will render and display the form fields, but will treat +them as having the <em>DISABLED</em> attribute, so that they can't be +submitted with an inappropriate encoding. [<A HREF="#TOC">ToC</A>] + +<h2><a name="20"><em>Lynx and HTML Tables</em></a></h2> + +HTML includes markup for creating <em>tables</em> structured as arrays of +cells aligned by columns and rows on the displayed page. + +<p>Lynx recognizes the TABLE tag and all of its associated tags as described +in <a href="ftp://ds.internic.net/rfc/rfc1942.txt" +>ftp://ds.internic.net/rfc/rfc1942.txt</a> +and will process any ID attributes in these tags for handling as NAME-ed +anchors, but does not create actual <em>tables</em>. Instead, it treats +the TR tag as a collapsible BR (line break), and inserts a collapsible +space before the content of each TH and TD 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. + +<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 +for PRE content, construct the <em>table</em> using <a +href="#21">HTML Tabs</a>. An example <em>table</em> using <em>TAB</em> +elements is included in the test subdirectory of the Lynx distribution. +[<A HREF="#TOC">ToC</A>] + +<h2><a name="21"><em>Lynx and HTML Tabs</em></a></h2> + +Lynx implements the <a +href="http://www.w3.org/pub/WWW/MarkUp/html3/Contents.html">HTML 3.0</a> +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 +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 +<em>table</em> using TAB elements in the test subdirectory of the Lynx +distribution as a model for using this functionality. + +<p>Note that this <em>Users Guide</em> and the <a +href="lynx_url_support.html">Supported URLs</a> page include TAB markup in +a manner which <em>degrades gracefully</em> for WWW browsers which do not +support it. Toggle to display of <a href="#8">source</a> and <a +href="#11">search</a> for <em><tab</em> to examine the use of TAB markup +in these documents. [<A HREF="#TOC">ToC</A>] + +<h2><a name="22"><em>Lynx and HTML Frames</em></a></h2> + +Some implementations of HTML include markup, primarily designed for graphic +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, +and NOFRAMES tags, 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 +left corner of the display, and renders the NOFRAMES section. If the +document provider has disregard for text clients and sight-challenged +Webizens, and thus does not include substantive content in the NOFRAMES +section or a link in it to a document suitable for text clients, you +can usually guess from the labeling of the <em>frame</em> links which +one has the substantive material (if there is any), or you can try each +of those links to see if anything worthwhile is returned. +[<A HREF="#TOC">ToC</A>] + +<h2><a name="23"><em>Lynx and HTML Banners</em></a></h2> + +Some implementations of HTML markup include provisions for creating a +non-scrolling window to be positioned at the top of each page, containing +links with brief, descriptive link names, analogous to a Windows toolbar. +Such windows have been termed <em>banners</em>. + +<p>Lynx recognizes and processes all of the <a +href="http://www.w3.org/pub/WWW/MarkUp/html3/Contents.html">HTML 3.0</a> +REL attribute tokens in LINK tags for creating a <em>banner</em>. The +LINK tokens are <em>Home</em>, <em>ToC</em>, <em>Index</em>, +<em>Glossary</em>, <em>Copyright</em>, <em>Up</em>, <em>Next</em>, +<em>Previous</em>, and <em>Help</em>. Any LINK tags with those tokens +will invoke creation of a <em>banner</em> at the top of the first page, +with the tag's HREF as the link, and the token as the link name. In +addition, a <em>Bookmark</em> token in conjunction with a TITLE attribute +will invoke a <em>banner</em> link with the value of the TITLE attribute +as the link name. Lynx does not waste screen real estate maintaining the +<em>banner</em> at the top of every page, but the Lynx TOOLBAR keystroke +command ('<em>#</em>') will, any time it is pressed, position you on the +<em>banner</em> so that any of its links can be activated, and pressing +the <em>left-arrow</em> when in the <em>banner</em> will return you to +where you were in the current document. + +<p>Lynx also recognizes the <a +href="http://www.w3.org/pub/WWW/MarkUp/html3/Contents.html">HTML 3.0</a> +BANNER container tag, and will create a <em>banner</em> based on its content +if one has not already been created based on LINK tags. Lynx treats the +MicroSoft MARQUEE tag as a synonym for BANNER (i.e., presenting it's +markup as a static <em>banner</em>, without any horizontal scrolling of +its content). [<A HREF="#TOC">ToC</A>] + +<h2><a name="24"><em>Lynx and HTML Footnotes</em></a></h2> + +Lynx implements the <a +href="http://www.w3.org/pub/WWW/MarkUp/html3/Contents.html">HTML 3.0</a> +FN element similarly to a named <em>A</em>nchor within the current document, +and assumes that the footnotes will be positioned at the bottom of the +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> +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> + +<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 +<em>left-arrow</em> key. The content of an FN element can be any HTML +markup that is valid in the BODY of the document. +[<A HREF="#TOC">ToC</A>] + +<h2><a name="25"><em>Lynx and HTML Notes</em></a></h2> + +Lynx implements the <a +href="http://www.w3.org/pub/WWW/MarkUp/html3/Contents.html">HTML 3.0</a> +NOTE element (<em>Admonishment</em>) as a labeled block, i.e., as if a new +paragraph were indicated whether or not paragraphing markup is included +in its content, with greater than normal left and right margins, and with +the type of note indicated by an emphasized label based on the value of its +CLASS or ROLE attribute. If no CLASS or ROLE attribute is included, the +default label <em>NOTE:</em> will be used. Lynx recognizes the values +<em>caution</em> and <em>warning</em>, for which, respectively, the labels +<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 +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> +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">ToC</A>] + +<h2><a name="26"><em>Lynx and HTML Lists</em></a></h2> + +Lynx implements the <a +href="http://www.w3.org/pub/WWW/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 +href="http://www.w3.org/pub/WWW/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, +thus, that neither DIR nor MENU yields a series of columns with 24-character +spacing. A single nesting index is maintained, so that different types of +List elements can be used for different levels within the nest. Also, the +<a href="http://www.w3.org/pub/WWW/MarkUp/html3/Contents.html">HTML 3.0</a> +FIG, CAPTION and CREDIT elements are treated as valid within list blocks. +They will be rendered with indentation appropriate for the current nesting +depth, and the CAPTION or CREDIT elements will have a <em>CAPTION:</em> or +<em>CREDIT:</em> label beginning the first line of their content. The +content of any APPLET or OBJECT elements in the lists also will be indented +appropriately for the current nesting depth, but those will not invoke line +breaks unless indicated by their content, and it should not include markup +which is inappropriate within the list. + +<p>Lynx also supports the TYPE attribute for OL elements, which can have +values of <em>1</em> for Arabic numbers, <em>I</em> or <em>i</em> for +uppercase or lowercase Roman numerals, or <em>A</em> or <em>a</em> for +uppercase or lowercase letters, that increment for successive LI elements +in the list block. The CONTINUE attribute can be used to continue the +ordering from the preceding list block when the nesting depth is changed. + +<p>Lynx treats the OL attributes START and SEQNUM as synonyms for specifying +the ordering value for the first LI element in the block. The values should +be specified as Arabic numbers, but will be displayed as Arabic, Roman, or +alphabetical depending on the TYPE for the block. The values can range from +<em>-29997</em> to the system's maximum positive integer for Arabic numbers. +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 +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, +without disrupting the sequence. If you do not include a START, SEQNUM or +CONTINUE attribute, the first LI element of each OL block will default to +<em>1</em>, and if you do not include a TYPE attribute, Lynx defaults to +Arabic numbers. + +<p>For UL blocks without the PLAIN attribute, Lynx uses <em>*</em>, +<em>+</em>, <em>o</em>, <em>#</em>, <em>@</em> and <em>-</em> as +<em>bullets</em> to indicate, progressively, the depth within the six +nesting levels. + +<p>Lynx treats UL, OL, DIR, and MENU blocks as having the COMPACT attribute +by default, i.e., single spaces between LH and LI elements within those +blocks. For DL blocks, double spacing will be used to separate the DT and +DD elements unless the COMPACT attribute has been specified. +[<A HREF="#TOC">ToC</A>] + +<h2><a name="27"><em>Lynx and HTML Quotes</em></a></h2> + +The <a +href="http://www.w3.org/pub/WWW/MarkUp/html3/Contents.html">HTML 3.0</a> and +later specifications provide for two classes of quotation in HTML documents. +Block quotes, designated by the BLOCKQUOTE element (or it's abbreviated +synonym BQ in HTML 3.0), have implied paragraph breaks preceding and following +the start and end tags for the block. Character level quotes, designated by +the Q element, in contrast are simply directives in the markup to insert an +appropriate quotation mark. + +<p>Lynx renders block quotes with a greater than normal left and right +indentation. Lynx does not support italics, and normally substitutes +underlining, but does not underline block quotes so as not to obscure any +explicit emphasis tags within the quotation. The BLOCKQUOTE or BQ block +can include a CREDIT block, whose content will be rendered as an implied +new paragraph with a <em>CREDIT:</em> label at the beginning of its first +line. + +<p>Lynx respects nested Q start and end tags, and will use ASCII double-quotes +(<em>"</em>) versus grave accent (<em>`</em>) and apostrophe +(<em>'</em>), respectively, for even versus odd depths in the nest. + +<p>Any ID attributes in BLOCKQUOTE, BQ or Q elements will be treated as +named <em>A</em>nchors. [<A HREF="#TOC">ToC</A>] + +<h2><a name="28"><em>Lynx and Client-Side-Image-Maps</em></a></h2> + +HTML includes markup, designed primarily for graphic clients, that treats +inlined images as maps, such that areas of the image within which a mouse +cursor was positioned when the mouse was <em>clicked</em> can correspond +to URLs which should be retrieved. The original implementations +were based on the client sending an http server the x,y coordinates +associated with the <em>click</em>, for handling by a script invoked by +the server, and have been termed <em>server-side-image-maps</em>. Lynx +has no rational way of coping with such a procedure, and thus simply +sends a 0,0 coordinate pair, which some server scripts treat as an +instruction to return a document suitable for a text client. + +<p>Newer HTML markup provides bases for the client to determine the +URLs associated with areas in the image map, and/or for a text client +to process alternative markup and allow the user to make choices based +on textual information. These have been termed +<em>client-side-image-maps</em>. + +<p>Lynx recognizes and processes the MAP container tag and its AREA tags, +and will create a menu of links for the HREF of each AREA tag when the +link created for the IMG tag with a USEMAP attribute is activated. The +menu uses the ALT attributes of the AREA tags as the link names, or, if +the document's author has disregard for text clients and 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 tag, 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 tag. 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 tags. If not in the same document, Lynx will fetch +the document which contains the referenced MAP, and locate it based on +its NAME or ID attribute. All MAPs encountered in documents during a +Lynx session are cached, so that they need not be retrieved repeatedly +when referenced in different documents. + +<p>If the IMG tag also indicates a <em>server-side-image-map</em> via +an ISMAP attribute, Lynx will create a link for that as well, rather +than ignoring it, and will submit a 0,0 coordinate pair if that link is +activated. However, the <em>client-side-image-map</em> is much more +useful for a client such as Lynx, because all of the URLs associated +with the image map can be accessed, and their nature indicated via ALT +attributes. + +<p>Lynx also recognizes the <a +href="http://www.w3.org/pub/WWW/MarkUp/html3/Contents.html">HTML 3.0</a> +FIG and OVERLAY tags, and will handle them as intended for text clients. +These are the ideal way to handle <em>client-side-image-maps</em>, because +the FIG content provides complete alternative markup, rather than relying +on the client to construct a relatively meager list of links with link +names based on ALT strings. + +<p>The presently experimental OBJECT tag encompasses much of the +functionality of the FIG tag for <em>client-side-image-maps</em>. Lynx +will render and display the content of OBJECT tags which have the SHAPES +attribute equivalently to its handling of FIG. Lynx also handles +OBJECT tags with the USEMAP and/or ISMAP attributes equivalently to +its handling of IMG tags with <em>client-side-image-maps</em> and/or +<em>server-side-image-maps</em>. [<A HREF="#TOC">ToC</A>] + +<h2><a name="29"><em>Lynx and Client-Side-Pull</em></a></h2> + +HTML includes provision for passing instructions to clients via directives +in META tags, 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 a tag is:<BR> +<tab indent="12"><em><META HTTP-EQUIV="Refresh" CONTENT="3; +URL="http://host/path"></em><BR> +which instructs a client to fetch the indicated URL in 3 seconds after +receiving the current document. If the <em>URL=</em> field is omitted, +the URL defaults to that of the current document. A <em>no-cache</em> +directive is implied when the <em>Refresh</em> if for the same URL. + +<p>Lynx recognizes and processes <em>Refresh</em> directives in META tags, +but puts up a labeled link, typically in the upper left corner of the +display, indicating the number of seconds intended before a refresh, +and the URL for the refresh, instead of making the request +automatically after the indicated number of seconds. This allows +people using a braille interface any amount of time to examine the +current document before activating the link for the next URL. In +general, if the number of seconds indicated is short, the timing +is not critical and you can activate the link whenever you like. +If it is long (e.g., 60 seconds), a server process may be generating +new documents or images at that interval, and you would be wasting +bandwidth by activating the link at a shorter interval. +[<A HREF="#TOC">ToC</A>] + +<h2><A NAME="30"><em>The Lynx command line</em></A></h2> + +A summary of the Lynx command line options (switches) is returned to +stdout if Lynx is invoked with the <em>-help</em> switch. A description +of the options also should be available via the system man (Unix) pages +or help (VMS) libraries. The basic syntax of the Lynx command line can +be represented as one of the following: + +<dl> + <dt><code>Command</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> + <dt><code>options</code> + <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 only argument is '<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 + 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>'. + <dt><code>-anonymous</code> + <dd>used to specify the anonymous account. + <dt><code>-auth=ID:PW</code> + <dd>id and password for protected pages. + <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 + lynx.cfg. + <dt><code>-child</code> + <dd>exit on left-arrow in startfile, and disable save to disk. + <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 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 + 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>-locexec</code> + <dd>enable local program execution from local files only + (if lynx was compiled with local execution enabled). + <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>-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>-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>-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>-noexec</code> + <dd>disable local program execution. (DEFAULT) + <dt><code>-nofilereferer</code> + <dd>disable transmissions of Referer headers for file URLs. + <dt><code>-nofrom</code> + <dd>disable transmissions of From headers. + <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>-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>-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>-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 + 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, + inside_ftp, outside_ftp, inside_rlogin, + 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 binary files to disk in the + download menu. + <dt>download + <dd>disallow downloaders in the download menu. + <dt>editor + <dd>disallow editing. + <dt>exec + <dd>disable execution scripts. + <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 + 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 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>jump + <dd>disable the '<em>j</em>' (jump) command. + <dt>mail + <dd>disable mailing feature. + <dt>news_post + <dd>disable 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 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 + <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, and the default + configuration can be changed in userdefs.h. + <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>-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>-trace</code> + <dd>turns on WWW trace mode. + <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 + security restrictions also are implemented. + <dt><code>-version</code> + <dd>print version information + <dt><code>-vikeys</code> + <dd>enable vi-like key movement. + </dl> +</dl> + +<p>No options are required, nor is a startfile argument required. +White space may be substituted for any equal sign ('<em>=</em>') +appearing in the option list above. [<A HREF="#TOC">ToC</A>] + +<h2><A NAME="31"><em>Lynx development history</em></A></h2> + +Lynx grew out of efforts to build a campus-wide information system +at The University of Kansas. The earliest versions of Lynx provided a +user-friendly, distributed hypertext interface for users connected to +multiuser (Unix and VMS) systems via curses-oriented display devices. +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 +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 +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 +Lynx clients to send comments and suggestions via e-mail to the +providers. + +<p>This early version of Lynx was also augmented to support hypertext +links to programs running on remote systems. It included the ability +to open a Telnet connection, as well as the ability to start programs +via rexec, inetd, or by direct socket connects. These capabilities were +included to allow users to access databases or custom program interfaces. + +<p>A subsequent version of Lynx incorporated the World Wide Web libraries +to allow access to the full list of WWW servers, along with the option to +build hypertext documents in HTML, rather than the native Lynx format. +HTML has become far more widely used, and the native format has been phased +out. With the addition of the WWW libraries, Lynx became a fully-featured +WWW client, limited only by the display capabilities offered in the curses +environment. + +<p>Lynx was designed by Lou Montulli, Charles Rezac and Michael Grobe +of Academic Computing Services at The University of Kansas. Lynx was +implemented by Lou Montulli and maintained by Garrett Arch Blythe and +Craig Lavender. + +<p><em>Foteos Macrides</em> and members of the +<a href="../about_lynx/about_lynx-dev.html">lynx-dev</a> list have +developed and supported Lynx since release of v2.3 in May 1994. The +Lynx2-3FM code set was released as v2.4 in June 1995. The Lynx2-4FM +code set was released as v2.5 in May 1996. The Lynx2-5FM code set was +released as v2.6 in September 1996. + +<p>Lynx has incorporated code from a variety of sources along the +way. The earliest versions of Lynx included code from Earl Fogel +of Computing Services at the University of Saskatchewan, who +implemented HYPERREZ in the Unix environment. Those versions also +incorporated libraries from the Unix Gopher clients developed at +the University of Minnesota, and the later versions of Lynx rely +on the WWW client library code developed by Tim Berners-Lee (and +others) and the WWW community. + +<p>Information on obtaining the most current version of Lynx is +available via the +<a href="http://www.nyu.edu/pages/wsn/subir/lynx.html" +>Lynx Enhanced Pages</a>. + +<p>[<A HREF="#TOC">ToC</A>] +</body> +</html> diff --git a/lynx_help/keystroke_commands/bookmark_help.html b/lynx_help/keystroke_commands/bookmark_help.html new file mode 100644 index 00000000..4030be6b --- /dev/null +++ b/lynx_help/keystroke_commands/bookmark_help.html @@ -0,0 +1,20 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<HTML> +<HEAD> +<TITLE>Lynx Bookmark Help</TITLE> +<LINK rev="made" href="mailto:lynx-dev@sig.net"> +</HEAD> +<BODY> +<h1>+++ Bookmark Help +++</h1> + +The <em>Bookmark file</em> is a document that resides on your local +machine and you are able to edit and change. The append feature, +invoked by pressing an '<em>a</em>' while viewing a document will add +the current document or the currently highlighted link to your current +<em>Bookmark file</em>. The remove feature, invoked by pressing an +'<em>r</em>' when your <em>Bookmark file</em> is being displayed, will +remove the currently highlighted link. You may set and modify the path +and name of your current <em>Bookmark file</em> in the <A +HREF="option_help.html">options screen.</A> +</BODY> +</HTML> diff --git a/lynx_help/keystroke_commands/dired_help.html b/lynx_help/keystroke_commands/dired_help.html new file mode 100644 index 00000000..eb1d1ae6 --- /dev/null +++ b/lynx_help/keystroke_commands/dired_help.html @@ -0,0 +1,51 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<html> +<head> +<title>Lynx Dired Help</title> +<link rev="made" href="mailto:lynx-dev@sig.net"> +</head> +<body> +<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 +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. + + 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. + + 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. + + 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. + + 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 +system administrator. Otherwise, the above commands will not be available +and lynx will treat a directory listing as a HTML file. +</body> +</html> diff --git a/lynx_help/keystroke_commands/edit_help.html b/lynx_help/keystroke_commands/edit_help.html new file mode 100644 index 00000000..4baa7232 --- /dev/null +++ b/lynx_help/keystroke_commands/edit_help.html @@ -0,0 +1,38 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<html> +<head> +<title>Lynx Line Editor Default Key Binding</title> +<link rev="made" href="mailto:lynx-dev@sig.net"> +</head> +<body> +<h1>+++DEFAULT BINDING+++</h1> + +Lynx invokes a built-in <em>Line Editor</em> for entering strings in +response to prompts, in forms, and for email messages if an external editor +has not been defined. Administrators can offer alternate key bindings +by adding them in LYEditmap.c before compiling Lynx, and they can +be selected via the 'o'ptions menu. This is the <em>Default Binding</em>: +<pre> + ENTER Input complete - RETURN + TAB Input complete - TAB, Do + ABORT Input cancelled - Ctrl-G, Ctrl-O, Ctrl-C + ERASE Erase the line - Ctrl-U, Ctrl-X + + BACK Cursor back char - Left-Arrow + FORW Cursor forward char - Right-Arrow + BACKW Cursor back word - Ctrl-P + FORWW Cursor forward word - Ctrl-N + BOL Go to begin of line - Ctrl-A, Home, Find + EOL Go to end of line - Ctrl-E, End, Select + + DELP Delete prev char - Ctrl-H, DELETE, Remove + DELC Delete current char - Ctrl-D + DELN Delete next char - Ctrl-R + DELPW Delete prev word - Ctrl-B + DELNW Delete next word - Ctrl-F + + LOWER Lower case the line - Ctrl-K + UPPER Upper case the line - Ctrl-T +</pre> +</body> +</html> diff --git a/lynx_help/keystroke_commands/gopher_types_help.html b/lynx_help/keystroke_commands/gopher_types_help.html new file mode 100644 index 00000000..aa134daa --- /dev/null +++ b/lynx_help/keystroke_commands/gopher_types_help.html @@ -0,0 +1,59 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<HTML> +<HEAD> +<TITLE>Listing of Gopher types</TITLE> +<LINK rev="made" href="mailto:lynx-dev@sig.net"> +</HEAD> +<BODY> +<h1>+++ Gopher Types +++</h1> + +<dl> +<dt>(FILE) +<dd>An ASCII file + +<dt>(DIR) +<dd>A directory listing + +<dt>(CSO) +<dd>The Computing Services Organizations +nameserver interface + +<dt>(BIN) +<dd>A binary file with one of the following meanings +<ul> +<li>A Binary file with PC extensions +<li>A Binary file with UNIX extensions +</ul> + +<dt>(HQX) +<dd>A Macintosh file that has be BinHexed + +<dt>(?) +<dd>A searchable database + + +<dt>(IMG) +<dd>An unknown image type +You must have an <A HREF="xterm_help.html">X terminal</A> to +view images + +<dt>(GIF) +<dd>An image in Graphics Interchange Format +You must have an <A HREF="xterm_help.html">X terminal</A> to +view images + +<dt>(HTML) +<dd>A World Wide Web hypertext file + +<dt>(TEL) +<dd>The link will open a connection to another host using telnet + +<dt>(3270) +<dd>The link will open a connection to another +host using tn3270 + +<dt>(UKN) +<dd>An unknown or unsupported type +</dl> +</BODY> +</HTML> diff --git a/lynx_help/keystroke_commands/history_help.html b/lynx_help/keystroke_commands/history_help.html new file mode 100644 index 00000000..eaf8949e --- /dev/null +++ b/lynx_help/keystroke_commands/history_help.html @@ -0,0 +1,28 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<HTML> +<HEAD> +<TITLE>Help on the History page</TITLE> +<LINK rev="made" href="mailto:lynx-dev@sig.net"> +</HEAD> +<BODY> +<h1>+++ History Page Help +++</h1> + +The History Page displays all of the links that you have traveled through +to reach your current point. If you entered a document and then left it +by using the <em>left-arrow</em> key, it will not be in the history stack. +If you entered a document and left it by selecting another link it will +be in the history stack. + +<p>You may <A HREF="movement_help.html">select</A> any link on the History +Page to review a document that you have previously visited. That link, +and any subsequent to it, will not be removed from the history stack if you +return to it via the History Page. You thus should use a History Page link, +rather than the <em>left-arrow</em> key, if you wish to review previous +documents without needing to remember and repeat the series of selections +for reaching your currently displayed document. + +<p>Upon using <em>left-arrow</em> in the document selected via the History +Page, you will be returned to the document from which you initially went to +the History Page. +</BODY> +</HTML> diff --git a/lynx_help/keystroke_commands/keystroke_help.html b/lynx_help/keystroke_commands/keystroke_help.html new file mode 100644 index 00000000..a11cfb3c --- /dev/null +++ b/lynx_help/keystroke_commands/keystroke_help.html @@ -0,0 +1,79 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<HTML> +<HEAD> +<TITLE>HELP! -- Press the left arrow key to exit help</TITLE> +<LINK rev="made" href="mailto:lynx-dev@sig.net"> +</HEAD> +<BODY> +<h1>+++ Keystroke Commands +++</h1> +<PRE> + <A HREF="movement_help.html">MOVEMENT</A>: Down arrow - Highlight next topic + Up arrow - Highlight previous topic + Right arrow, - Jump to highlighted topic + Return, Enter + Left arrow - Return to previous topic + + <A HREF="scrolling_help.html">SCROLLING</A>: + - Scroll down to next page (Page-Down) + - - 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 + + <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 your bookmark file + c - Send a comment to the document owner + d - Download the current link + e - Edit the current file + g - Goto a user specified <a href="http://www.ncsa.uiuc.edu/demoweb/url-primer.html">URL</a> or file + i - Show an index of documents + j - Execute a jump operation + k - Show a list of 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 + 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 your <A HREF="bookmark_help.html">bookmark file</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> + = - Show file and link info + \ - Toggle document source/rendered view + ! - Spawn your default shell + ' - Toggle "historical" vs minimal or valid comment + parsing + ` - 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-W - Refresh the screen + CTRL-U - Erase input line + CTRL-G - Cancel input or transfer + CTRL-T - Toggle trace mode on and off +</PRE> +</BODY> +</HTML> diff --git a/lynx_help/keystroke_commands/movement_help.html b/lynx_help/keystroke_commands/movement_help.html new file mode 100644 index 00000000..4655db31 --- /dev/null +++ b/lynx_help/keystroke_commands/movement_help.html @@ -0,0 +1,49 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<HTML> +<HEAD> +<TITLE>Help on Lynx Movement commands</TITLE> +<LINK rev="made" href="mailto:lynx-dev@sig.net"> +</HEAD> +<BODY> +<H1>+++ MOVEMENT HELP +++</H1> +<PRE> + Down arrow, - Move to the next hypertext link, + TAB or scroll down if there are no more + links on the page to move to. + + Up arrow - Move to the previous hypertext link, + or scroll up if there are no links + above the current one, and there are + previous pages to move to. + + Right arrow, - select the link that the cursor is + Return, Enter positioned on. + + Left arrow - Retreat from a link. Go back to the + previous topic. + + + *note: If 'VI Keys' are enabled from the options menu or + 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 the 'Num Lock' on your keyboard is on, Lynx will + translate the numbers of your keypad into movement + commands. The translation is as follows. + + 9 - page up + 8 - up arrow + 7 8 9 7 - moves to the top of a document + \|/ 6 - right arrow + 4 - 5 - 6 5 - nothing + /|\ 4 - left arrow + 1 2 3 3 - page down + 2 - down arrow + 1 - moves to the end of a document +</PRE> +</BODY> +</HTML> diff --git a/lynx_help/keystroke_commands/option_help.html b/lynx_help/keystroke_commands/option_help.html new file mode 100644 index 00000000..0cbc8297 --- /dev/null +++ b/lynx_help/keystroke_commands/option_help.html @@ -0,0 +1,164 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<HTML> +<HEAD> +<TITLE>Options Screen Help</TITLE> +<LINK rev="made" href="mailto:lynx-dev@sig.net"> +</HEAD> +<BODY> +<h1>+++ Options Screen Help +++</h1> +<PRE> + The Options Screen allows you to set and + modify many of Lynx's features. The following + options may be set. + + Editor - If non-empty it defines the editor to spawn + when editing a local file or sending mail. + Any valid text editor may be entered here. + + DISPLAY variable - If non-empty it specifies your <A HREF="xterm_help.html">X terminal</A> + display address. + + Bookmark file - If non-empty it specifies the name of your + '<A HREF="bookmark_help.html">Bookmark file</A>'. If the filename is not + absolute, then the path begins from your + home directory. + + Personal Mail - You may set your mail address here so that + Address when mailing messages to other people or + mailing files to yourself, your email address + can be automatically filled in. You email + address will also be sent to HTTP servers in + a from: field. + + Searching type - If set to 'case sensitive', user searches + invoked by the '/' command will be case + sensitive substring searches. The + default is 'Case Insensitive' substring + searches + + Display Character - This option allows you to set up the default + set character set for your specific terminal. + The character set provides a mapping of 8-bit + ISO Latin character entities and/or Asian (CJK) + characters into viewable characters and should + be set in relation to your terminal's character + set if you will be viewing such characters with + Lynx. You must have the selected character set + installed on your terminal. + + Raw 8-bit or CJK - Toggles whether 8-bit characters are assumed to + mode correspond with the selected character set and + therefore are processed without translation via + the ISO Latin 1 conversion tables. Should be + ON by default when the selected character set is + ISO Latin 1, or is one of the Asian (CJK) sets + and the 8-bit characters are Kanji multibytes. + Should be OFF for the other character sets, but + can be turned ON when there's a match, e.g., the + document's charset is ISO-8859-2 and ISO Latin 2 + has been selected. Should be OFF when an Asian + (CJK) set is selected but the document is + ISO-8850-1. The setting also can be toggled via + the RAW_TOGGLE command, normally mapped to '@', + and at startup via the -raw switch. + + Preferred Document - The language you prefer if multi-language files are + Language available from servers. Use MIME abbreviations, + e.g., en for English, fr for French, etc. Can be + a comma-separated list in descending order of + preferences. + + Preferred Document - The character set you prefer if sets in addition + Charset 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 in descending order of + preferences. + + VI keys - If set to 'ON' then the lowercase h, j, k, and l, + keys will be mapped to left-arrow, down-arrow, + up-arrow, 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). + + Emacs keys - 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). + + Keypad mode - This option gives the choice between navigating + with the keypad (as arrows; see Lynx Navigation) + and having every link numbered (numbered links) + so that the links may be selected by numbers + instead of moving to them with the arrow keys. + + Line edit style - 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="edit_help.html">Default Binding</A>. + + List directory - Applies to Directory Editing. Files and + style directories can be presented in the following + ways: + Mixed style + Files and directories are listed together in + alphabetical order. + Directories first + Files and directories are separated into two + alphabetical lists. Directories are listed + first. + Files first + Files and directories are separated into two + alphabetical lists. Files are listed first. + + Show dot files - If display/creation of hidden (dot) + files/directories is enabled, you can turn + the feature on or off via this setting. + + User Mode - Beginner + Shows two extra lines of help at the bottom + of the screen + Intermediate (normal mode) + The "normal" statusline messages appear. + Advanced + The URL is shown on the statusline. + + User Agent - The header string which Lynx sends to servers + to indicate the User-Agent is displayed here. + Changes may be disallowed via the -restrictions + switch. Otherwise, the header can be changed + temporarily to a string such as L_y_n_x/2.6 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. + NOTE that Netscape Communications Corp. has + claimed that false transmissions of "Mozilla" as + the are a copyright infringement, which will be + prosecuted. DO NOT 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". + + Local execution - If set to 'ON', Lynx will locally execute + links commands contained inside of links. This + can be HIGHLY DANGEROUS so it is recommended + that they remain 'ALWAYS OFF' unless + otherwise set by your system administrator. + This option may not be available on most + versions of Lynx. + +</PRE> +</BODY> +</HTML> diff --git a/lynx_help/keystroke_commands/other_help.html b/lynx_help/keystroke_commands/other_help.html new file mode 100644 index 00000000..4d248257 --- /dev/null +++ b/lynx_help/keystroke_commands/other_help.html @@ -0,0 +1,137 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<HTML> +<HEAD> +<TITLE>Help on Misc. Lynx Commands</TITLE> +<LINK rev="made" href="mailto:lynx-dev@sig.net"> +</HEAD> +<BODY> +<h1>+++ Other Commands +++</h1> +<PRE> + a - Places the link that you are currently positioned + on in your 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. + + d - Downloads the file pointed to by the current link + and displays an option menu allowing the file to + be saved or transfered by configurable options. + + 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. + + ? 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. + + 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. + + 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. + + p - Brings up a list of <A HREF="print_help.html">print commands</A>. + + o - Brings up a list of setable <A HREF="option_help.html">options</A>. + + q - Quits Lynx. ('Q' quits without asking) + + / - Search for a string of characters in the current + document case insensitive or case sensitive + depending on the options set. (see <A HREF="option_help.html">options)</A>. + + s - Search through an external searchable indexed document. + + n - Move to the next instance of a search string if you + have searched previously. + + v - Views your current <A HREF="bookmark_help.html">Bookmark file</A>. + + x - Force submission of form or link with no-cache. + + z - Abort a network transfer in progress. If any partial + data has been transfered 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. + + \ - Toggles between viewing the HTML source of a + document and the rendered version of the document. + + ! - Spawns your default operating system shell. + + ' - 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. + + ` - 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 + be created for all images, including inlines. + + @ - Toggles raw 8-bit translations or CJK mode on and off. + Should be on when the document's charset matches the + selected character set, and otherwise off so that 8-bit + characters will be reverse translated with respect to the + ISO-8859-1 conversion table for the character set (see + <A HREF="option_help.html">options)</A>. + + [ - Toggles pseudo_inlines mode on and off. When on, inline + images which have no ALT string specified will have an + "[INLINE]" 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. + + ] - Sends a HEAD request 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. + + " - 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. + + CTRL-R - Reloads the current document and resets the display. + + CTRL-W - Resets or cleans up the display. + + CTRL-U - Clears text from an input field or prompt. + + CTRL-G - Cancels any input prompt, mail message or data transfer. + + CTRL-T - Toggles trace mode on and off. +</PRE> +</BODY> +</HTML> diff --git a/lynx_help/keystroke_commands/print_help.html b/lynx_help/keystroke_commands/print_help.html new file mode 100644 index 00000000..153caa74 --- /dev/null +++ b/lynx_help/keystroke_commands/print_help.html @@ -0,0 +1,37 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<HTML> +<HEAD> +<TITLE>Lynx Print Help</TITLE> +<LINK rev="made" href="mailto:lynx-dev@sig.net"> +</HEAD> +<BODY> +<h1>+++ Printing Help +++</h1> + +After entering the 'p' command you will be presented with a list of +print options. In all cases the file will be printed in ASCII format +with the hypertext links removed. The number of options depends on the +level of printing that your system allows. The following print options +may be available: + +<dl> +<dt>Print to a local file: +<dd>This allows you to save the current file as ASCII text to your + local disk. You will be asked for a path and filename to save + the file to. If no path is given, the file will be saved to the + directory that you were in when you began Lynx. + +<dt>Print to the screen: +<dd>This option simply scrolls the entire document up the screen and + is intended for those who wish to capture the document with their + terminal. + +<dt>Mail the file to yourself: +<dd>This option allows you to mail the file, in ASCII form, to any + valid e-mail address. + +<dt>Custom print options: +<dd>Any number of custom print options may be available, as defined + by your system administrator. +</dl> +</BODY> +</HTML> diff --git a/lynx_help/keystroke_commands/scrolling_help.html b/lynx_help/keystroke_commands/scrolling_help.html new file mode 100644 index 00000000..d1931346 --- /dev/null +++ b/lynx_help/keystroke_commands/scrolling_help.html @@ -0,0 +1,58 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<HTML> +<HEAD> +<TITLE>Lynx Scrolling Help</TITLE> +<LINK rev="made" href="mailto:lynx-dev@sig.net"> +</HEAD> +<BODY> +<H1>+++ SCROLLING HELP +++</H1> +<PRE> + + (or SPACE, - If the bottom of the screen informs you + or CTRL-F) that there is 'more' to see, you may + move to the next page (Page-Down). + + - (or b, - If you have moved down in a document, this + 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: + + 9 - page up + 8 - up arrow + 7 8 9 7 - moves to the top of a document + \|/ 6 - right arrow + 4 - 5 - 6 5 - nothing + /|\ 4 - left arrow + 1 2 3 3 - page down + 2 - down arrow + 1 - moves to the end of a document + + CTRL-A (or Find) - This Control key, and Function key synonym, + brings you back to the first page of the + current document (Home). + + CTRL-E (or Select) - This Control key, and Function key synonym, + takes you to the last page of the current + document (End). + + CTRL-N (or Remove) - This Control key, and Function key synonym, + moves you forward two lines in the current + document (Down-Two). + + CTRL-P (or Insert) - This Control key, and Function key synonym, + moves you back two lines in the current + document (Up-Two). + + ) - Moves you forward half a page in the current + document (Down-Half). + + ( - Moves you back half a page in the current + document (Up-Half). + + # - Jumps you to the pseudo Toolbar or Banner if + present in the current document. Use left-arrow + to return from there to your previous position + in the document. +</PRE> +</BODY> +</HTML> diff --git a/lynx_help/keystroke_commands/xterm_help.html b/lynx_help/keystroke_commands/xterm_help.html new file mode 100644 index 00000000..d40ea450 --- /dev/null +++ b/lynx_help/keystroke_commands/xterm_help.html @@ -0,0 +1,32 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<HTML> +<HEAD> +<TITLE>X Terminal Help</TITLE> +<LINK rev="made" href="mailto:lynx-dev@sig.net"> +</HEAD> +<BODY> +<h1>+++ X Terminal or X Server +++</h1> + +An X terminal is an electronic display terminal that communicates +with a host computer system using the X Window protocol developed at the +Massachusetts Institute of Technology. + +<p>The X Window protocol allows a program running on the host computer +system to display both formatted text and graphics on the X terminal. +Since the X Window protocol is defined to work over any TCP/IP network, +X terminals connected to the Internet can be connected to hosts +located anywhere on the Internet. + +<p>Personal computers (including both PCs and Macintoshes) can execute +programs, usually called X servers, that make them act like X Window +terminals and are frequently used as X terminals. + +<dl> +<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 + computer is usually known as the "X client." +</dl> +</BODY> +</HTML> diff --git a/lynx_help/lynx_help_main.html b/lynx_help/lynx_help_main.html new file mode 100644 index 00000000..42fc5275 --- /dev/null +++ b/lynx_help/lynx_help_main.html @@ -0,0 +1,87 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<html> +<head> +<link rev="made" href="mailto:lynx-dev@sig.net"> +<title>Help! - Press the Left arrow key to exit help</title> +</head> +<body> + +<H1>Lynx Help Menu</h1> + +<ul plain> +<lh><em>Choose a subject:</em></lh> + +<li><a href="../about_lynx/about_lynx.html">About Lynx</a> + +<ul plain> +<li><a href="Lynx_users_guide.html">Lynx Users Guide</a> + +<li><a href="keystroke_commands/keystroke_help.html">Key-stroke Commands</a> +| <a href="keystroke_commands/edit_help.html">Line Editor</a> + +<li><a href="lynx_url_support.html">Supported URLs</a> +| <a href="http://www.w3.org/pub/WWW/Addressing/Addressing.html" +>W3C Help on URLs</a> + +<li><a href="../about_lynx/about_lynx-dev.html">About Lynx-Dev</a> | + <a href="http://www.access.digex.net/~asgilman/lynx/FAQ/">Lynx FAQ</a> + +<li><a href="http://www.nyu.edu/pages/wsn/subir/lynx.html" +>The Lynx Enhanced Pages Index</a> + +</ul> + +<li><a +href="http://www.w3.org/pub/WWW/MarkUp/html-spec/html-spec_toc.html" +>HTML 2.0 Specs</a> +| <a href="http://www.w3.org/pub/WWW/MarkUp/html3/Contents.html" +>HTML 3.0 Specs</a> +| <a href="http://www.alis.com:8085/ietf/html/" +>IETF HTML i18n</a> +| <a href="http://www.w3.org/pub/WWW/MarkUp/" +>W3C HTML Draft</a> + +<ul plain> +<li><a href="http://www.stonehand.com/doc/" +>Spyglass/Stonehand Technical Reference</a> +<ul plain> +<li><a +href="http://www.stonehand.com/doc/comments.html" +>Keep Your Comments Legal</a> +</ul> + +<li><a +href="http://ugweb.cs.ualberta.ca/~gerald/validate/" +>A Kinder, Gentler HTML Validator</a> + +<li><a +href="http://www.webtechs.com/html-val-svc/" +>WebTechs HTML Validation Service</a> + +<li><a href="http://www.ncsa.uiuc.edu/General/Internet/WWW/HTMLPrimer.html" +>HTML Primer</a> +| <a href="http://kuhttp.cc.ukans.edu/lynx_help/HTML_quick.html" +>HTML Quick Reference Guide</a> + +</ul> + +<li><a +href="http://ds.internic.net/rfc/rfc1945.txt" +>HTTP 1.0 Specs</a> +| <a href="http://www.w3.org/pub/WWW/Protocols/" +>HTTP 1.1 Specs</a> + +<li><a +href="http://www.w3.org/pub/WWW/TheProject.html" +>The World Wide Web Consortium (W3C)</a> + +<li>[ + <a href="http://www.altavista.digital.com/">Alta Vista</a> | + <a href="http://www.yahoo.com/">Yahoo!</a> | + <a href="http://www.lycos.com/">Lycos</a> | + <a href="http://guide.Infoseek.com/">Infoseek Guide</a> | + <a href="http://guaraldi.cs.colostate.edu:2000/">Savvy Search</a> ] +</ul> + +</body> +</html> diff --git a/lynx_help/lynx_url_support.html b/lynx_help/lynx_url_support.html new file mode 100644 index 00000000..8c0ed4f6 --- /dev/null +++ b/lynx_help/lynx_url_support.html @@ -0,0 +1,493 @@ +<!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> +<HTML> +<HEAD> +<TITLE>URL Schemes Supported in Lynx</TITLE> +<LINK rev=made href="mailto:lynx-dev@sig.net"> +</HEAD> + +<BODY> +<BANNER> +<em>[</em><a href="#http">http, https</a> <em>|</em> +<a href="#telnet">telnet, tn3270, rlogin</a> <em>|</em> +<a href="#gopher">gopher</a> <em>|</em> +<a href="#file">file</a> <em>|</em> +<a href="#ftp">ftp</a> <em>|</em> +<a href="#wais">wais</a> <em>|</em> +<a href="#news">news, nntp, snews</a> <em>|</em> +<a href="#mailto">mailto</a> <em>|</em> +<a href="#finger">finger</a> <em>|</em> +<a href="#cso">cso</a> <em>|</em> +<a href="#exec">lynxexec, lynxprog</a> <em>|</em> +<a href="#cgi">lynxcgi</a><em>|</em> +<a href="#internal">internal</a><em>]</em> +</BANNER> + +<H1><em>URL Schemes Supported in Lynx</em></H1> + +Lynx handles a number of URL types, that are enumerated below. For +more details about URLs (Uniform Resource Locators) see <em>RFC1738</em>: +<ul plain> +<li><a href="http://www.w3.org/pub/WWW/Addressing/rfc1738.txt" +>http://www.w3.org/pub/WWW/Addressing/rfc1738.txt</a> +<li><a href="ftp://ds.internic.net/rfc/rfc1738.txt" +>ftp://ds.internic.net/rfc/rfc1738.txt</a> +</ul> + +<p>Lynx resolves partial or relative URLs in documents with respect to +the BASE if one was specified, otherwise with respect to the document's +absolute URL, using the rules described in <em>RFC1808</em>: +<ul plain> +<li><a href="http://www.w3.org/pub/WWW/Addressing/rfc1808.txt" +>http://www.w3.org/pub/WWW/Addressing/rfc1808.txt</a> +<li><a href="ftp://ds.internic.net/rfc/rfc1808.txt" +>ftp://ds.internic.net/rfc/rfc1808.txt</a> +</ul> + +<p>When entering a URL on the command line to be used as the +<em>startfile</em>, or at the prompt for a '<em>g</em>'oto entry, a +partial host field can be used and the scheme field can be omitted if +the scheme and fully qualified domain name can be constructed internally +by using the URL_DOMAIN_PREFIXES and URL_DOMAIN_SUFFIXES definitions in +the Lynx configuration file. See the explanation of those definitions +and their use in your <em>lynx.cfg</em>. For example, <em>wfbr</em> will +be treated as <em>http://www.wfbr.edu/</em>, and <em>wfbr/dir/lynx</em> +will be treated as <em>http://www.wfbr.edu/dir/lynx</em>, but +<em>gopher.wfbr.edu/11/_fileserv/_lynx</em> will be treated as +<em>gopher://gopher.wfbr.edu/11/_fileserv/_lynx</em>. For files or +directories on the local host, a tilde (<em>~</em>) is expanded to +the path of the account's login directory, e.g., <em>~/foo</em> will +be expanded to <em>file://localhost/your/login/directory/foo</em>. +The tilde expansion is done homologously on Unix and VMS. On VMS, +Lynx also will expand any file or directory spec recognizable to +DCL into a valid URL, e.g., <em>[]</em> will be expanded to +<em>file://localhost/current/default/directory</em>. These expansions +are <em>SOLELY</em> for <em>startfile</em> or '<em>g</em>'oto entries! +Any partial or relative URLs within HTML documents are resolved +according to the rules specified in RFC1808. +<HR WIDTH="100%"> + +<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> +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 +search or the content of a FORM with METHOD="GET". The <em>#fragment</em> +field if present indicates a location in the document to seek for display, +based on a NAME-ed anchor or an ID attribute within the document, and is +technically an instruction rather than part of the URL. Lynx will treat +ID attributes as NAME-ed anchors for all tags in the BODY of a document +which can correspond to positions in the rendering of the document. + +<p>The https URL has the same format, but the default port is +<em>:443</em>. Patches for support of https URLs and the CONNECT +procedure are available for qualified recipients via links in the +<a href="http://www.nyu.edu/pages/wsn/subir/lynx.html">Lynx Enhanced +Pages</a>. US Export laws and associated red tape pose severe +impediments to inclusion of this support in the general distributions +of freeware WWW clients such as Lynx. Sorry. +<HR WIDTH="100%"> + +<H2><a name="telnet" +>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> + +<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 +to <em>:23</em> when omitted in the URL. + +<p>A <em>tn3270</em> or <em>rlogin</em> URL is specified equivalently, +and similarly spawns a tn3270 or rlogin session. The actual behavior +is dependent on the TCP-IP software installed on the local and target +hosts. + +<p>It is unwise to include the <em>:password</em> field except for +URLs which point to anonymous or other public access accounts, and +for most TCP-IP software you will be prompted for a password whether +or not one was included in the URL. +<HR WIDTH="100%"> + +<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> +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 +in RFC1738. Typically, the gopher-path consists of a <em>gophertype</em> +indicating the file or service type (e.g., <em>0</em> or <em>I</em> for +plain text or an image, respectively, <em>7</em> for a search, or <em>1</em> +for a directory), followed by a platform-specific <em>selector</em>. Any +reserved characters in the selector should be hex escaped (<em>%hh</em>), +including slashes, although hex escaping of slashes is not required by Lynx +in gopher URLs. + +<p>Lynx does not overtly support the gopher+ protocol, and does not +represent itself as gopher+ capable when communicating with gopher +servers. Lynx might transmit any (hex-escaped-tab-separated) extended +gopher+ fields in a URL if an author included them in a document, but is +likely to mishandle what the gopher server returns in such cases, and would +not generate and transmit them itself. For pre-formed URLs to submit gopher +searches, it may be better to use a <em>?</em> rather than hex-escaped tab +(<em>%09</em>) as the separator for the <em>searchpart</em> in the +<em>selector</em>, e.g.:<BR> +<em>gopher://gopher.wfbr.edu/77/_shell/search.shell%20/_shell/walker?lynx*</em> +Lynx will handle the <em>%09</em> if you use that instead of <em>?</em>, +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> +will become:<BR> +<tab indent="12"><em>http://www.wfbr.edu/</em><BR> +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 +to facilitate the offering of links to MIME-capable http servers in the +listings returned by gopher servers, but should be considered Lynxisms +and UMN Gopherisms. +<HR WIDTH="100%"> + +<H2><a name="file">The <em>file</em> URL:</a></H2> + +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> +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> +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> +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 +<em>startfile</em> using any spec acceptable to DCL, and then +use the <em>showinfo</em> command (<em>=</em>) to see the file +URL which Lynx created for it. +<HR WIDTH="100%"> + +<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> + +<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 +<em>:password</em>, Lynx will prompt you for the password. This is +recommended, as otherwise the URL will have it completely unencrypted. +Do not include the <em>@</em> if neither <em>username</em> nor +<em>:password</em> is included. For anonymous ftp, Lynx uses your +<em>personal_mail_address</em> (user@host) as the <em>:password</em> +if it has been defined via the '<em>o</em>'ptions menu. Otherwise, +Lynx uses the dummy password <em>WWWUser</em>. + +<p>The <em>;type=</em> parameter can be used with value <em>D</em>, +<em>I</em>, or <em>A</em> to force handling of the URL as, respectively, +a directory listing, binary file, or ASCII file. The Lynx ftp gateway +normally determines this itself, but the parameter can be used if the +internal procedure draws an incorrect inference about the nature of +the ftp URL. + +<p>The <em>/path</em> is treated according to RFC1738 for VMS +and VM/CMS ftp servers. The lead slash (<em>/</em>) is treated purely +as a separator, not as a designator for the root, and the <em>path</em> +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> +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> + +<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 +handled equivalently to that in file URLs. The distinction is +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> +<HR WIDTH="100%"> + +<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> +where <em>:port</em> defaults to <em>:210</em> + +<p>Direct wais support is built into Lynx for VMS, and can be compiled +into Lynx on Unix. If direct wais support is not available, Lynx uses +the W3C wais gateway. + +<p>If only a <em>database</em> is indicated in the URL, Lynx returns +an ISINDEX cover page for searching that <em>database</em>, and will +submit your search with the <em>wais_query</em> appended. Lynx will +convert the server's reply into a hit list with URLs that include the +<em>wais_type</em> and <em>wais_path</em> for retrieving items from +the hit list. +<HR WIDTH="100%"> + +<H2><a name="news" +>The <em>news</em>, <em>nntp</em>, and <em>snews</em> URLs:</a></H2> + +The news and nntp URLs are handled by Lynx as specified in RFC1738, but +for compatibility with other clients, Lynx allows inclusion of host and +port fields in news URLs, which properly should be used <em>only</em> in +nntp URLs. If not included in news URLs, Lynx will use the nntp server +pointed to by the NNTPSERVER environment variable or configuration symbol +(see lynx.cfg), with default port <em>:119</em>. A host field must be +included in nntp URLs, and the port field is optional with the same default. +Patches for support of snews URLs are available to qualified recipients via +links in the <a +href="http://www.nyu.edu/pages/wsn/subir/lynx.html" +>Lynx Enhanced Pages</a> but cannot be included in the general +distribution (sorry, see <a href="#http">http and https</a>). +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> +(snews same as nntp, but the default port is <em>:563</em>) + +<p>The <em>messageID</em> is the message's unique identifier, consisting +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> +(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. + +<p>For news URLs, Lynx allows you both to <em>reply</em> to the author +of a message via email, and, if news posting has been enabled, to send +a <em>followup</em> message to the newsgroup. Only email replies to the +author are permitted via nntp URLs. + +<p>Lynx converts any strings in news messages which appear to be a URL +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> +(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 +news messages. +<HR WIDTH="100%"> + +<H2><a name="mailto">The <em>mailto</em> URL:</a></H2> + +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> + +<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, +has always supported a series of user@host addresses as a comma-separated +list, and still does. For compatibility with Explorer, Lynx also accepts +a semi-colon-separated list. + +<p>For compatibility with Netscape, Lynx parses any +<em>?subject=The%20Subject</em> appended to the URL, trims the URL +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> + +<p><tab indent="12"><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> + +<p>Note that a TITLE attribute for FORM has been proposed but not included +in any HTML specifications or drafts, and should be considered a Lynxism +until/unless it is. Some clients use a SUBJECT attribute for this purpose +in FORM tags, and Lynx recognizes that as a synonym for TITLE. + +<p>If <em>ENCTYPE="text/plain"</em> is specified for a FORM with a mailto +ACTION, Lynx will not hex escape the name=value pairs, 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> +if the latter was indicated. + +<p>Note that when mailing FORM content Lynx wraps any lines longer than 78 +characters, to avoid buffer overflows in mail software and to ensure reliable +transmission across gateways. If the ENCTYPE was not <em>text/plain</em>, +any script which decodes the mailed content should ignore the physical +newlines and recognize only hex escaped newline characters as intended +to be present in the decoded content. +<HR WIDTH="100%"> + +<H2><a name="finger">The <em>finger</em> URL:</a></H2> + +Lynx has full support for the finger protocol, but a format for finger +URLs has not yet been adopted by the IETF. The formats supported by Lynx +therefore include every possibility not inconsistent with RFC1738, +including: + +<pre> + finger://host finger://@host + finger://host/ finger://@host/ + finger://host/%2fw finger://@host/w + finger://host/w finger://host/w/ + finger://host/username[@host] finger://username@host + finger://host/username[@host]/ finger://username@host/ + finger://host/w/username[@host] finger://username@host/w + finger://host/%2fw%20username[@host] finger://host/username[@host]/w + finger://host/w/username +</pre> + +<p>Activating a finger URL will send a request to the finger server via +port 79 on the host specified. You can include <em>:79</em> in the URL, +but no other value is allowed. The <em>/w</em> or <em>/%2fw</em> is used +to request a full report for finger servers which support it, and is not +case sensitive (i.e., can be <em>/W</em> or <em>/%2fW</em>). Any strings +in the report which appear to be a URL with a supported scheme will be +converted into a link for accessing that URL. + +<p>An alternative way to access finger servers is via gopher URLs with +port 79 and the plain text (<em>0</em>) <em>gophertype</em> specified:<BR> +<em>gopher://host:79/0</em><BR> +Lynx will handle such URLs equivalently to overt finger URLs, including +creation of links for any strings which appear to be supported URLs. +<HR WIDTH="100%"> + +<H2><a name="cso">The <em>cso</em> URL:</a></H2> + +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> + +<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> + +<p>Lynx will parse the stream returned by the server for the above +URLs and create a FORM for submitting additional requests (searches) +to the server. Any strings in the reports returned for these requests +(searches) which appear to be a URL with a supported scheme will be +converted into a link for accessing that URL. +<HR WIDTH="100%"> + +<H2><a name="exec">The <em>lynxexec</em> and <em>lynxprog</em> URLs:</a></H2> + +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> +(Note, however, that restrictions on acceptable commands or utilities +may be imposed by the system administrator.) + +<p>You optionally can include <em>//localhost/</em> in the URL, between the +scheme field and the command, but that is always implied. The lynxexec +and lynxprog URLs differ only in that with lynxexec you are prompted to +enter <em>RETURN</em> before Lynx clears the screen and restores the +previously displayed document, so that you can read any screen output +generated by the spawned command, whereas no such pause is imposed upon exit +from the utility invoked via lynxprog. + +<p>These are Lynxisms and should be used only in local documents intended +solely for Lynx. +<HR WIDTH="100%"> + +<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. +The output of the script must be text/html and is rendered and displayed +by Lynx. (Note that restrictions on acceptable paths can be imposed +by the system administrator.) + +<p>This is a Lynxism and should be used only in local documents intended +solely for Lynx. + +<p>On VMS, you are advised to use the threaded OSU http server, available +from <a href="ftp://osu.edu" +>ftp://osu.edu</a> as freeware, if your site does not already have an http +server. It can be installed as a purely local script server, and is far +more efficient and comprehensive than any code which might be incorporated +within Lynx. +<HR WIDTH="100%"> + +<H2><a name="internal">The <em>LYNXfoo</em> internal URLs:</a></H2> + +Lynx uses a variety of internal URL schemes as structured stream +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> +(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> +But within Lynx, use the '<em>K</em>' keystroke command. +</BODY> +</HTML> |