about summary refs log tree commit diff stats
path: root/lynx_help/Lynx_users_guide.html
diff options
context:
space:
mode:
authorThomas E. Dickey <dickey@invisible-island.net>2009-04-26 15:48:40 -0400
committerThomas E. Dickey <dickey@invisible-island.net>2009-04-26 15:48:40 -0400
commit645962231e3b52eae75845c6a599048b1cbae34a (patch)
tree71562ab03750595fceb9b4db2bb5fd371476d00b /lynx_help/Lynx_users_guide.html
parent7b0f5c3465fd2b45c4eeab192e09261f9569a930 (diff)
downloadlynx-snapshots-645962231e3b52eae75845c6a599048b1cbae34a.tar.gz
snapshot of project "lynx", label v2-8-7pre_1b
Diffstat (limited to 'lynx_help/Lynx_users_guide.html')
-rw-r--r--lynx_help/Lynx_users_guide.html187
1 files changed, 129 insertions, 58 deletions
diff --git a/lynx_help/Lynx_users_guide.html b/lynx_help/Lynx_users_guide.html
index a02f063d..660687d5 100644
--- a/lynx_help/Lynx_users_guide.html
+++ b/lynx_help/Lynx_users_guide.html
@@ -1,5 +1,5 @@
 <!DOCTYPE html PUBLIC "-//IETF//DTD HTML 3.0//EN">
-<!-- $LynxId: Lynx_users_guide.html,v 1.96 2008/07/06 13:59:08 tom Exp $ -->
+<!-- $LynxId: Lynx_users_guide.html,v 1.102 2009/04/26 15:35:26 tom Exp $ -->
 <html>
 <head>
 <title>Lynx Users Guide v2.8.6</title>
@@ -550,16 +550,19 @@ HREF="keystrokes/option_help.html">HELP!</A>
   FTP sort criteria                : [By Name]
   Local directory sort criteria    : [Mixed style......]
   Local directory sort order       : [By name..........]
-  Show transfer rate               : [Show KiB/sec, ETA]
   Show dot files                   : [ON.]
   Execution links                  : [FOR LOCAL FILES ONLY]
+  Pause when showing message (!)   : [ON_]
+  Show transfer rate               : [Show progressbar___]
 
   Special Files and Screens
   Multi-bookmarks                  : [ADVANCED]
   Review/edit Bookmarks files      : Goto multi-bookmark menu
+  Auto Session (!)                 : [OFF]
+  Session file (!)                 : ___________________________________________
   Visited Pages                    : [As Visit Tree..........]
 
-  Check your lynx.cfg here
+  View the file lynx.cfg
 
          Accept Changes - Reset Changes Left Arrow cancels changes
 
@@ -634,35 +637,42 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
             Lynx will treat documents as if they were encoded accordingly.
             This option active when 'Raw 8-bit or CJK Mode' is OFF.
 
+   <dt>Auto Session
+        <dt>Lynx can save and restore useful information about
+            your browsing history.
+            Use this setting to enable or disable the feature.
+
    <dt>Bookmark file
         <dd>When multi-bookmarks is OFF, this is the filename and location
             of your default personal bookmark file.  Enter '<em>B</em>' to
             modify the filename and/or location via the <a
             href="keystrokes/edit_help.html">Line Editor</a>.
             Bookmark files allow frequently traveled links to be stored in
-            personal easy to access files.  Using the '<em>a</em>'dd bookmark
+            personal easy to access files.
+         <p>Using the '<em>a</em>'dd bookmark
             link command (see <a href="#Bookmarks">Lynx bookmarks</a>) you may save
             any link that does not have associated POST content into a
             bookmark file.  All bookmark files must be in or under your
             account's home directory.  If the location specified does not
             begin with a dot-slash (./), its presence will still be assumed,
-            and referenced to the home directory.  When multi-bookmarks is
+            and referenced to the home directory.
+         <p>When multi-bookmarks is
             STANDARD or ADVANCED, entering '<em>B</em>' will invoke a menu
             of up to 26 bookmark files (associated with the letters of the
             English alphabet), for editing their filenames and locations
-            (<em>filepath</em>), and descriptions.  Lynx will create bookmark
+            (<em>filepath</em>), and descriptions.
+         <p>Lynx will create bookmark
             files, if they don't already exist, when you first '<em>a</em>'dd
             a bookmark link to them.  However, if you've specified a
             subdirectory (e.g., ./BM/lynx_bookmarks.html), that subdirectory
             must already exist.  Note that on VMS you should use the URL
             syntax for the filepath (e.g., <em>not</em>
             [.BM]lynx_bookmarks.html).
-            For Win32, see [???].
 
-   <dt>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>Cookies
+        <dd>This option allows you to tell how to handle cookies:
+            <em>ignore</em>,
+            prompt (<em>ask user</em>) or <em>accept all</em>.
 
    <dt>Display Character set
         <dd>This option allows you to set up the default character set for
@@ -692,13 +702,51 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
 
          <p>Note: this has no direct effect on the line-editor's key bindings.
 
+   <dt>Execution links<br>
+       This deals with execution of local scripts or links:
+        <dd>Local execution is activated when Lynx is first set up.
+            If it has not been activated you will not see this option
+            in the <em>Options Menu</em>.
+        <dd>When a local execution script is encountered Lynx  checks the
+            users options to see whether the script can be executed. Users
+            have the following options:
+          <dl>
+             <dt> Always off
+                 <dd>Local execution scripts will never be executed
+             <dt>For Local files only
+                 <dd>Local execution scripts will only be executed if the
+                     script to be executed resides on the local machine,
+                     and is referenced by a URL that begins with
+                     <em>file://localhost</em>
+             <dt>Always on
+                 <dd>All local execution scripts will be executed
+          </dl>
+
+        <dd>If the users options permit the script to be executed Lynx will
+            spawn a shell and run the script.  If the script cannot be
+            executed Lynx will show the script within the Lynx window and
+            inform the user that the script is not allowed to be executed
+            and will ask the user to check his/her options.
+            [<A HREF="#ToC-InteractiveOptions">ToC</A>]
+
    <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>Keypad as arrows, numbered links, numbered fields, or numbered links and form fields
+   <dt>HTML error recovery
+        <dd>Select the
+            <A HREF="keystrokes/option_help.html#tagsoup">recovery mode</A>
+            used by Lynx.
+
+   <dt>Invalid-Cookie Prompting
+        <dd>This allows you to tell how to handle invalid cookies:
+            <em>prompt normally</em> to prompt for each cookie,
+            <em>force yes-response</em> to reply "yes" to each prompt,
+            <em>force no-response</em> to reply "no" to each prompt.
+
+   <dt>Keypad mode
         <dd>This option gives the choice among navigating with the arrow
             keys, or having every link numbered so that the links may be
             selected or made current by numbers as well as using the arrow
@@ -717,8 +765,8 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
             been compiled in.  Otherwise, Lynx uses the <a
             href="keystrokes/edit_help.html">Default Binding</a>.
 
-   <dt>List directory style
-        <dd>Applies to Directory Editing.  Files and directories can be
+   <dt>Local directory sort criteria
+        <dd>This applies to directory editing.  Files and directories can be
             presented in the following ways:
           <dl>
              <dt>Mixed style
@@ -730,9 +778,10 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
              <dt>Files first
                 <dd>Files and directories are separated into two alphabetical
                     lists.  Files are listed first.
-          <p>
-          The Options Form also allows you to sort by the file attributes,
-          using the <em>Local directory sort order</em>:
+          </dl>
+
+   <dt>Local directory sort order<dd>
+          The Options Form also allows you to sort by the file attributes.
           <dl>
              <dt>By name
                 <dd>by filename (the default)
@@ -749,33 +798,6 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
              <dt>By group
                 <dd>by file owner's group-id
           </dl>
-          </dl>
-
-   <dt>Local execution scripts or links
-        <dd>Local execution is activated when Lynx is first set up.
-            If it has not been activated you will not see this option
-            in the <em>Options Menu</em>.
-        <dd>When a local execution script is encountered Lynx  checks the
-            users options to see whether the script can be executed. Users
-            have the following options:
-          <dl>
-             <dt> Always off
-                 <dd>Local execution scripts will never be executed
-             <dt>For Local files only
-                 <dd>Local execution scripts will only be executed if the
-                     script to be executed resides on the local machine,
-                     and is referenced by a URL that begins with
-                     <em>file://localhost</em>
-             <dt>Always on
-                 <dd>All local execution scripts will be executed
-          </dl>
-
-        <dd>If the users options permit the script to be executed Lynx will
-            spawn a shell and run the script.  If the script cannot be
-            executed Lynx will show the script within the Lynx window and
-            inform the user that the script is not allowed to be executed
-            and will ask the user to check his/her options.
-            [<A HREF="#ToC-InteractiveOptions">ToC</A>]
 
    <dt>Multi-bookmarks
         <dd>Lynx supports a default bookmark file, and up to 26 total
@@ -802,6 +824,11 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
             Lynx will use your $USER environment variable, or "WWWuser"
             if even the environment variable is unset.
 
+   <dt>Pause when showing message
+        <dd>If set to "off", this overrides the INFOSECS setting in lynx.cfg,
+            to eliminate pauses when displaying informational messages,
+            like the "-nopause" command line option.
+
    <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
@@ -822,7 +849,7 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
             MULTIPLE attribute specified, the OPTIONs always are rendered
             as a list of checkboxes.
 
-   <dt>Preferred Document Language
+   <dt>Preferred document language
         <dd>The language you prefer if multi-language files are available
             from servers.  Use RFC 1766 abbreviations, e.g., en for English,
             fr for French, etc.  Can be a comma-separated list, which may
@@ -832,7 +859,7 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
             understand it, for example:
             da,&nbsp;en-gb;q=0.8,&nbsp;en;q=0.7
 
-   <dt>Preferred Document Charset
+   <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,
@@ -843,14 +870,14 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
             HTTP protocol, for servers which understand it, for example:
             iso-8859-5,&nbsp;utf-8;q=0.8
 
-   <dt>Preferred Encoding
+   <dt>Preferred encoding
         <dd>When doing a GET, lynx tells what types of compressed data it can
             decompress (the "Accept-Encoding:" string).  This is determined by
             compiled-in support for decompression or external decompression
             programs.  Use this option to select none, one or all of the
             supported decompression types.
 
-   <dt>Preferred Media Type
+   <dt>Preferred media type
         <dd>When doing a GET, lynx lists the MIME types which it knows how
             to present (the "Accept:" string).  Depending on your system
             configuration, the mime.types or other data given by the
@@ -893,7 +920,11 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
             command, normally mapped to '<em>@</em>', and at startup via the
             <em>-raw</em> switch.
 
-   <dt>Show color.
+   <dt>Session file
+        <dd>Define the file name where lynx will store user sessions.
+            This setting is used only when <em>Auto Session</em> is enabled.
+
+   <dt>Show color
         <dd>This option will be present if color support is available.
             If set to ON or ALWAYS, color mode will be forced on if possible.
             If (n)curses color support is available but cannot be used for
@@ -928,14 +959,7 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
             for any reason the startup color mode is incorrect for your
             terminal, set it appropriately on or off via this 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>Show cursor for current link or option.
+   <dt>Show cursor
         <dd>Lynx normally hides the cursor by positioning it to the right
             and if possible the very bottom of the screen, so that the
             current link or OPTION is indicated solely by its highlighting
@@ -951,6 +975,48 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
         <dd>If display/creation of hidden (dot) files/directories is
             enabled, you can turn the feature on or off via this setting.
 
+   <dt>Show images
+        <dd>This allows you to select the way in which Lynx shows image links.
+            These are the available selections:
+            <ul>
+            <li><em>ignore</em> to suppress the links altogether,
+            <li><em>as labels</em> to show the descriptive text for the link
+            <li><em>as links</em>, which allows you to use an external viewer
+            </ul>
+
+   <dt>Show scrollbar
+        <dd>This allows you to enable (show) or disable (hide) the scrollbar
+            on the right-margin of the display.
+            This feature is available with ncurses or slang libraries.
+
+   <dt>Show transfer rate
+        <dd>This allows you to select the way in which Lynx shows
+            its progress in downloading large pages.
+            It displays its progress in the status line.
+            These are the available selections:
+            <ul>
+            <li>Do not show rate
+            <li>Local directory sort order
+            <li>Show dot files
+            <li>Execution links
+            <li>Pause when showing message
+            <li>Show transfer rate
+            </ul>
+
+   <dt>SSL Prompting
+        <dd>This allows you to tell how to handle errors detected in SSL
+            connections
+            <em>prompt normally</em> to prompt for each cookie,
+            <em>force yes-response</em> to reply "yes" to each prompt,
+            <em>force no-response</em> to reply "no" to each prompt.
+
+   <dt>Type of Search
+        <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>Use locale-based character set
         <dd>This option allows you to request lynx to obtain a MIME name
             from the operating system which corresponds to your locale
@@ -964,7 +1030,7 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
         <dd>This allows you to change whether Lynx uses passive ftp
             connections.
 
-   <dt>User Agent
+   <dt>User Agent header
         <dd>The header string which Lynx sends to HTTP servers to indicate the
             User-Agent is displayed here.  Changes may be disallowed via
             the <em>-restrictions</em> switch.  Otherwise, the header can be
@@ -1028,6 +1094,11 @@ return to Lynx or the '<em>&gt;</em>' command to save the options to a
           <dt>By Last Visit
           <dt>By Last Visit Reversed
         </dl>
+
+   <dt>X Display
+        <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.
 </dl>
 
 <h2 ID="Mail"><A NAME="Mail"><em>Comments and mailto: links</em></A></h2>