diff options
| author | Thomas E. Dickey <dickey@invisible-island.net> | 1998-10-04 16:57:56 -0400 |
|---|---|---|
| committer | Thomas E. Dickey <dickey@invisible-island.net> | 1998-10-04 16:57:56 -0400 |
| commit | 5d4274cacfd5304314b484a46475d3df53bdfb6d (patch) | |
| tree | d30b16b0c308b6fc2af8fe97f689095e6a8f8293 /lynx_help/keystrokes | |
| parent | 24efd81edda1e797719e0f4eb231604d9b273dad (diff) | |
| download | lynx-snapshots-5d4274cacfd5304314b484a46475d3df53bdfb6d.tar.gz | |
snapshot of project "lynx", label v2-8-1pre_7
Diffstat (limited to 'lynx_help/keystrokes')
| -rw-r--r-- | lynx_help/keystrokes/option_help.html | 589 |
1 files changed, 306 insertions, 283 deletions
diff --git a/lynx_help/keystrokes/option_help.html b/lynx_help/keystrokes/option_help.html index 69d7c8c9..63862ca2 100644 --- a/lynx_help/keystrokes/option_help.html +++ b/lynx_help/keystrokes/option_help.html @@ -5,288 +5,311 @@ <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. - - Multi-bookmarks - When OFF, the default bookmark file is used - for the 'v'iew bookmarks and 'a'dd bookmark - link commands. If set to STANDARD, a menu - of available bookmarks always is invoked - when you seek to view a bookmark file or add - a link, and you select the bookmark file by - its letter token in that menu. If set to - ADVANCED, you instead are prompted for the - letter of the desired bookmark file, but can - enter '=' to invoke the STANDARD selection - menu, or RETURN for the default bookmark file. - - Bookmark file - If non-empty and multi-bookmarks is OFF, it - specifies your default '<A HREF="bookmark_help.html">Bookmark file</A>'. - If multi-bookmarks is STANDARD or ADVANCED, - entering 'B' will invoke a menu in which you - can specify the filepaths and descriptions - of up to 26 bookmark files. The filepaths - must be from your home directory, and begin - with dot-slash (./) if subdirectories are - included (e.g, ./BM/lynx_bookmarks.html). - Lynx will create bookmark files when you - first 'a'dd a link, but any subdirectories - in the filepath must already exist. - - FTP sort criteria - This option allows you to specify how files - will be sorted within FTP listings. The - current options include "By Filename", - "By Size", "By Type", and "By Date". - - 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. Your 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 - - Preferred Document - The language you prefer if multi-language files - Language are available from servers. Use RFC 1766 tags, - e.g., en for English, fr for French, etc. Can be - a comma-separated list, which may be interpreted - by servers as descending order of preferences. - You can also make your order of preference explicit - by using q factors as defined by the HTTP protocol, - for servers which understand it, for example: - <kbd>da, en-gb;q=0.8, en;q=0.7</kbd> - - 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, which may be interpreted - by servers as descending order of preferences. - You can also make your order of preference explicit - by using q factors as defined by the HTTP protocol, - for servers which understand it, for example: - <kbd>iso-8859-5, utf-8;q=0.8</kbd> - - Display Character - This option allows you to set up the default - set character set for your specific terminal. The - display character set provides a mapping from the - character encodings of viewed documents and from - HTML entities into viewable characters. It should - be set according to your terminal's character set - so that characters other than 7-bit ASCII can be - displayed correctly, using approximations if - necessary. You must have the selected character set - installed on your terminal. (Since Lynx now supports - a wide range of platforms it may be useful to note - that cpXXX codepages are used within IBM PC - computers, and windows-xxxx within native MS-Windows - applications). - - Raw 8-bit or CJK - This option set automatically but can be toggled - mode manually in certain special cases: - it toggles whether 8-bit characters are assumed to - correspond with the display character set and - therefore are processed without translation via the - chartrans conversion tables. ON by default when the - display character set is one of the Asian (CJK) - sets and the 8-bit characters are Kanji multibytes. - OFF for the other display character sets, but can - be turned ON when the document's charset is unknown - (e.g., is not ISO-8859-1 and no charset parameter - was specified in a reply header from an HTTP server - to indicate what it is) but you have no better idea - than viewing it as from display character set (see - also 'assumed document character set' for best - choice). Should be OFF when an Asian (CJK) set is - selected but the document is ISO-8859-1 or another - 'assumed document character set'. The setting also - can be toggled via the RAW_TOGGLE command, normally - mapped to '@', and at startup via the -raw switch. - - Assumed document - This option changes the handling of documents - character set which do not explicitly specify a charset. - Normally Lynx assumes that 8-bit characters in - those documents are encoded according to iso-8859-1 - (the official default for the HTTP protocol). - Unfortunately, many non-English web pages "forget" - to include proper charset info; this option helps - you to browse those broken pages if you know by - some means what the charset is. When the value - given here or by an -assume_charset command line - flag is in effect, Lynx will treat documents as if - they were encoded accordingly. This option active - when 'Raw 8-bit or CJK Mode' is OFF. - - Show color - This option will be present if color support is - available. If set to ON or ALWAYS, color mode will - be forced on if possible. If (n)curses color - support is available but cannot be used for the - current terminal type, selecting ON is rejected - with a message. If set to OFF or NEVER, color mode - will be turned off. - ALWAYS and NEVER are not offered in anonymous - accounts. If saved to a '.lynxrc' file in - non-anonymous accounts, ALWAYS will cause Lynx to - set color mode on at startup if supported. If Lynx - is built with the slang library, this is equivalent - to having included the -color command line switch - or having the COLORTERM environment variable - set. If color support is provided by curses or - ncurses, this is equivalent to the default behavior - of using color when the terminal type supports it. - If (n)curses color support is available but cannot - be used for the current terminal type, the - preference can still be saved but will have no - effect. - A saved value of NEVER will cause Lynx to assume a - monochrome terminal at startup. It is similar to - the -nocolor switch, but (when the slang library is - used) can be overridden with the -color switch. - If the setting is OFF or ON when the current - options are saved to a '.lynxrc' file, the default - startup behavior is retained, such that color mode - will be turned on at startup only if the terminal - info indicates that you have a color-capable - terminal, or (when the slang library is used) if - forced on via the -color switch or COLORTERM - variable. This default behavior always is used in - anonymous accounts, or if the 'option'_save - restriction is set explicitly. If for any reason - the startup color mode is incorrect for your - terminal, set it appropriately on or off via this - option. - - 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). - - Show dot files - If display/creation of hidden (dot) - files/directories is enabled, you can turn - the feature on or off via this setting. - - Popups for select - Lynx normally uses a popup window for the - fields OPTIONs in form SELECT fields when the field - does not have the MULTIPLE attribute specified, - and thus only one OPTION can be selected. The - use of popup windows can be disabled by changing - this setting to OFF, in which case the OPTIONs - will be rendered as a list of radio buttons. - Note that if the SELECT field does have the - MULTIPLE attribute specified, the OPTIONs always - are rendered as a list of checkboxes. - - Show cursor for - Lynx normally hides the cursor by positioning it - current link or to the right and if possible the very bottom of - option the screen, so that the current link or OPTION - is indicated solely by its highlighting or color. - If show cursor is set to ON, the cursor will be - positioned at the left of the current link or - OPTION. This is helpful when Lynx is being used - with a speech or braille interface. It also is - useful for sighted users when the terminal cannot - distinguish the character attributes used to - distinguish the current link or OPTION from the - others in the screen display. - - 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. - - User Mode - Novice - Shows two extra lines of help at the bottom - of the screen for beginners - Intermediate (normal mode) - The "normal" statusline messages appear. - Advanced - The URL is shown on the statusline. - - Verbose Images - Controls whether or not Lynx replaces the [LINK], - [INLINE] and [IMAGE] comments (for images without - ALT) with filenames of these images. This is - extremely useful because now we can determine - immediately what images are just decorations - (button.gif, line.gif) and what images are - important. - - 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.8.1 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 User-Agent 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 'ALWAYS ON', Lynx will locally execute - links commands contained inside of any links. This - can be HIGHLY DANGEROUS so it is recommended - that they remain 'ALWAYS OFF' or 'FOR LOCAL - FILES ONLY' unless otherwise set by your system - administrator. This option may not be available - on most versions of Lynx. - -</PRE> +<h1>OPTIONS SCREEN HELP</h1> + +The Options Screen allows you to set and modify many Lynx features.<BR> +Note: some options appear on the screen only if they have been +compiled in or chosen in `lynx.cfg':<P> + +<UL> +<LI>Personal Preferences +<UL> +<LI>-- Cookies : no help given -- +<LI><A HREF="#ED">Editor</A> +<LI><A HREF="#EM">Emacs keys</A> +<LI><A HREF="#KM">Keypad mode</A> +<LI><A HREF="#PM">Personal Mail Address</A> +<LI><A HREF="#PU">Pop-ups for select fields</A> +<LI><A HREF="#ST">Searching type</A> +<LI><A HREF="#SC">Show color</A> +<LI><A HREF="#CL">Show cursor for current link or option</A> +<LI><A HREF="#UM">User Mode</A> +<LI><A HREF="#VB">Verbose Images</A> +<LI><A HREF="#VI">VI keys</A> +<LI><A HREF="#DV">X DISPLAY variable</A></UL> +<LI>Bookmark Options +<UL> +<LI><A HREF="#MB">Multi-bookmarks</A> +<LI><A HREF="#BF">Bookmark file</A></UL> +<LI>Character Set Options +<UL> +<LI><A HREF="#AD">Assumed document character set</A> +<LI><A HREF="#DC">Display Character set</A> +<LI><A HREF="#JK">Raw 8-bit or CJK mode</A></UL> +<LI>File Management Options +<UL> +<LI><A HREF="#FT">FTP sort criteria</A> +<LI><A HREF="#LD">Local directory sort criteria</A> +<LI><A HREF="#DF">Show dot files</A> +</UL> +<LI>Headers transferred to remote server +<UL> +<LI><A HREF="#PC">Preferred Document Charset</A> +<LI><A HREF="#PL">Preferred Document Language</A> +<LI><A HREF="#UA">User Agent</A> +</UL> +<LI>-- not in Options Form -- +<UL> +<LI><A HREF="#LE">Line edit style</A> +<LI><A HREF="#LL">Local execution links</A></UL> +</UL> + +<H1><A NAME="ED">Editor</A></H1> + +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. + +<H1><A NAME="EM">Emacs keys</A></H1> + +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). + +<H1><A NAME="KM">Keypad mode</A></H1> + +This 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. You can also number form fields. + +<H1><A NAME="PM">Personal Mail Address</A></H1> + +You may set your mail address here so that when mailing messages +to other people or mailing files to yourself, your email address can be +automatically filled in. Your email address will also be sent +to HTTP servers in a `from:' field. + +<H1><A NAME="PU">Pop-ups for select fields</A></H1> + +Lynx normally uses a pop-up window for the OPTIONs in form SELECT fields +when the field does not have the MULTIPLE attribute specified, and thus +only one OPTION can be selected. The use of pop-up windows can be disabled +by changing this setting to OFF, in which case the OPTIONs will be rendered +as a list of radio buttons. Note that if the SELECT field does have +the MULTIPLE attribute specified, the OPTIONs always are rendered +as a list of checkboxes. + +<H1><A NAME="ST">Searching type</A></H1> + +If set to 'case sensitive', user searches invoked by '/' will be +case-sensitive substring searches. Default is 'Case Insensitive'. + +<H1><A NAME="SC">Show color</A></H1> + +This will be present if color support is available. +<ul> +<li>If set to ON or ALWAYS, +color mode will be forced on if possible. If (n)curses color support +is available but cannot be used for the current terminal type, selecting ON +is rejected with a message. +<li>If set to OFF or NEVER, color mode will be +turned off. +<li>ALWAYS and NEVER are not offered in anonymous accounts. +If saved to a '.lynxrc' file in non-anonymous accounts, ALWAYS will cause Lynx +to set color mode on at startup if supported. +</ul> +If Lynx is built with slang, +this is equivalent to having included the -color command line switch +or having the COLORTERM environment variable set. If color support is +provided by curses or ncurses, this is equivalent to the default behavior +of using color when the terminal type supports it. If (n)curses color support +is available but cannot be used for the current terminal type, the preference +can still be saved but will have no effect. + +<p>A saved value of NEVER will +cause Lynx to assume a monochrome terminal at start-up. It is similar +to the -nocolor switch, but (when the slang library is used) can be overridden +with the -color switch. If the setting is OFF or ON when the current options +are saved to a '.lynxrc' file, the default start-up behavior is retained, +such that color mode will be turned on at startup only if the terminal info +indicates that you have a color-capable terminal, or (when slang is used) +if forced on via the -color switch or COLORTERM variable. This default +behavior always is used in anonymous accounts, or if the 'option'_save +restriction is set explicitly. If for any reason the start-up color mode +is incorrect for your terminal, set it appropriately on or off via this option. + +<H1><A NAME="CL">Show cursor for current link or option</A></H1> + +Lynx normally hides the cursor by positioning it to the right and if possible +the very bottom of the screen, so that the current link or OPTION is indicated +solely by its highlighting or color. If show cursor is set to ON, the cursor +will be positioned at the left of the current link or OPTION. This is helpful +when Lynx is being used with a speech or braille interface. It is also useful +for sighted users when the terminal cannot distinguish the character attributes +used to distinguish the current link or OPTION from the others in the display. + +<H1><A NAME="UM">User Mode</A></H1> + +<dl> +<dt><EM>Novice</EM>: Shows 2 extra lines of help at the bottom of the screen +for beginners. +<dt><EM>Intermediate (normal)</EM>: Normal status-line messages appear. +<dt><EM>Advanced</EM>: The URL is shown on the status line. +</dl> + +<H1><A NAME="VB">Verbose Images</A></H1> + +Controls whether or not Lynx replaces the [LINK], INLINE] and [IMAGE] comments +(for images without ALT) with filenames of these images. This is extremely +useful because now we can determine immediately which images are decorations +(button.gif, line.gif) and which are important. + +<H1><A NAME="VI">VI keys</A></H1> + +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. +<p>The uppercase H, J, K, and L keys remain mapped to their configured bindings +(normally HELP, JUMP, KEYMAP and LIST, respectively). + +<H1><A NAME="DV">X DISPLAY variable</A></H1> + +If non-empty, it specifies your <A HREF="xterm_help.html">X terminal</A> +display address. + +<H1><A NAME="MB">Multi-bookmarks</A></H1> + +Manage multiple bookmark files: +<ul> +<li>When OFF, the default bookmark file is used for the 'v'iew-bookmarks +and 'a'dd-bookmark link commands. +<li>If set to STANDARD, a menu of available +bookmarks is always invoked when you seek to view a bookmark file +or add a link, and you select the bookmark file by its letter token +in that menu. +<li>If set to ADVANCED, you are instead prompted for the letter +of the desired bookmark file, but can enter '=' to invoke the STANDARD +selection menu, or RETURN for the default bookmark file. +</ul> + +<H1><A NAME="BF">Bookmark file</A></H1> + +Manage the default bookmark file: +<ul> +<li>If non-empty and multi-bookmarks is OFF, +it specifies your default '<A HREF="bookmark_help.html">Bookmark file</A>'. +<li>If multi-bookmarks is STANDARD or ADVANCED, +entering 'B' will invoke a menu in which you can specify +filepaths and descriptions of up to 26 bookmark files. +</ul> +The filepaths must be from your home directory and begin with './' +if subdirectories are included (e.g., './BM/lynx_bookmarks.html'). +<P> +Lynx will create bookmark files when you first 'a'dd a link, +but any subdirectories in the filepath must already exist. + +<H1><A NAME="AD">Assumed document character set</A></H1> + +This changes the handling of documents which do not explicitly specify +a charset. Normally Lynx assumes that 8-bit characters in those documents +are encoded according to iso-8859-1 (the official default for HTTP protocol). +Unfortunately, many non-English web pages forget to include proper charset +info; this option helps you browse those broken pages if you know somehow +what the charset is. When the value given here or by an -assume_charset +command-line flag is in effect, Lynx will treat documents as if they were +encoded accordingly. Option is active when 'Raw 8-bit or CJK Mode' is OFF. + +<H1><A NAME="DC">Display Character set</A></H1> + +This allows you to set up the default character set for your specific terminal. +The display character set provides a mapping from the character encodings +of viewed documents and from HTML entities into viewable characters. +It should be set according to your terminal's character set +so that characters other than 7-bit ASCII can be displayed correctly, +using approximations if necessary. You must have the selected character set +installed on your terminal. Since Lynx now supports a wide range of platforms +it may be useful to note that cpXXX codepages are used within IBM PC computers, +and windows-xxxx within native MS-Windows applications. + +<H1><A NAME="JK">Raw 8-bit or CJK mode</A></H1> + +This is set automatically, but can be toggled manually in certain cases: +it toggles whether 8-bit characters are assumed to correspond with the display +character set and therefore are processed without translation +via the chartrans conversion tables. ON by default when the display +character set is one of the Asian (CJK) sets and the 8-bit characters +are Kanji multibytes. OFF for the other display character sets, +but can be turned ON when the document's charset is unknown +(e.g., is not ISO-8859-1 and no charset parameter was specified +in a reply header from an HTTP server to indicate what it is), +but you have no better idea than viewing it as from display character set +(see 'assumed document character set' for best choice). Should be OFF +when an Asian (CJK) set is selected but the document is ISO-8859-1 +or another 'assumed document character set'. The setting can also be toggled +via the RAW_TOGGLE command, normally mapped to '@', and at startup +via the -raw switch. + +<H1><A NAME="FT">FTP sort criteria</A></H1> + +This allows you to specify how files will be sorted within FTP listings. +The current options include +`By Filename', `By Size', `By Type', `By Date'. + +<H1><A NAME="LD">List directory style</A></H1> + +Applies to Directory Editing. +Files and directories can be presented in the following ways: +<dl> +<dt><EM>Mixed style</EM>: Files and directories are listed together +in alphabetical order. +<dt><EM>Directories first</EM>: Files and directories are separated +into 2 alphabetical lists: directories are listed first. +<dt><EM>Files first</EM>: Files and directories are separated +into 2 alphabetical lists: files are listed first. +</dl> + +<H1><A NAME="DF">Show dot files</A></H1> + +If display/creation of hidden (dot) files/directories is enabled, +you can turn the feature on or off via this setting. + +<H1><A NAME="PC">Preferred Document Charset</A></H1> + +The character set you prefer if sets in addition to ISO-8859-1 and US-ASCII +are available from servers. Use MIME notation (e.g., ISO-8859-2) +and do not include ISO-8859-1 or US-ASCII, since those values are always +assumed by default. Can be a comma-separated list, which may be interpreted +by servers as descending order of preferences; you can make your order +of preference explicit by using `q factors' as defined by the HTTP protocol, +for servers which understand it: e.g., <kbd>iso-8859-5, utf-8;q=0.8</kbd>. + +<H1><A NAME="PL">Preferred Document Language</A></H1> + +The language you prefer if multi-language files are available from servers. +Use RFC 1766 tags, e.g., `en' English, `fr' French. Can be a comma-separated +list, and you can use `q factors' (see previous help item): +e.g., <kbd>da, en-gb;q=0.8, en;q=0.7</kbd> . + +<H1><A NAME="UA">User Agent</A></H1> + +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 e.g., L_y_n_x/2.8.1 +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 Options Menu. +Changes of the header are not saved in the .lynxrc file. +<P> +NOTE Netscape Communications Corp. has claimed that false transmissions +of `Mozilla' as the User-Agent 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'. + +<H1><A NAME="LE">Line edit style</A></H1> + +This 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>. + +<H1><A NAME="LL">Local execution links</A></H1> + +If set to 'ALWAYS ON', Lynx will locally execute commands contained +inside any links. This can be HIGHLY DANGEROUS, so it is recommended +that they remain 'ALWAYS OFF' or 'FOR LOCAL FILES ONLY'. + </BODY> </HTML> + |