diff options
Diffstat (limited to 'lynx_help')
| -rw-r--r-- | lynx_help/Lynx_users_guide.html | 296 | ||||
| -rw-r--r-- | lynx_help/keystrokes/alt_edit_help.html | 21 | ||||
| -rw-r--r-- | lynx_help/keystrokes/bashlike_edit_help.html | 8 | ||||
| -rw-r--r-- | lynx_help/keystrokes/bookmark_help.html | 4 | ||||
| -rw-r--r-- | lynx_help/keystrokes/dired_help.html | 26 | ||||
| -rw-r--r-- | lynx_help/keystrokes/edit_help.html | 20 | ||||
| -rw-r--r-- | lynx_help/keystrokes/keystroke_help.html | 15 | ||||
| -rw-r--r-- | lynx_help/keystrokes/option_help.html | 21 | ||||
| -rw-r--r-- | lynx_help/keystrokes/other_help.html | 14 | ||||
| -rw-r--r-- | lynx_help/keystrokes/print_help.html | 3 | ||||
| -rw-r--r-- | lynx_help/lynx_url_support.html | 36 |
11 files changed, 305 insertions, 159 deletions
diff --git a/lynx_help/Lynx_users_guide.html b/lynx_help/Lynx_users_guide.html index 64ac7eb7..3d780441 100644 --- a/lynx_help/Lynx_users_guide.html +++ b/lynx_help/Lynx_users_guide.html @@ -81,6 +81,9 @@ through the help files. and their key bindings is available by pressing the '<em>K</em>' key (or the '<em>k</em>' key if vi-like key movement is not on). [<A HREF="#ToC-Help">ToC</A>] +<p> +If you want to recall recent status-line messages, you can do so +by entering the `g' command, followed by `LYNXMESSAGES:'. <h2 ID="Local"><A NAME="Local"><em>Viewing local files with Lynx</em></A></h2> @@ -111,8 +114,7 @@ all be used to display an arbitrary ASCII text or HTML file: 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.) +will be displayed, depending on settings e.g., in <em>lynx.cfg</em>. <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 @@ -293,10 +295,8 @@ LIST and ADDRLIST keystroke commands, normally mapped to '<em>l</em>' and the current document, and they can be selected via those lists. <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=URL</em> switch, and therefore depends on how the Lynx -program you are using was configured. +offered contains many useful links, but can be changed in <em>lynx.cfg</em> +or on the command line using the <em>-index=URL</em> switch. <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 @@ -479,13 +479,14 @@ to the net.bio.net WAIS server. [<A HREF="#ToC-Search">ToC</A>] <h2 ID="InteractiveOptions"><A NAME="InteractiveOptions"><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 Options Menu allows you to change options which are -useful at runtime. Most of these are read/saved from your .lynxrc file. -Other options are stored in the <A HREF="#lynx.cfg">lynx.cfg</A> file. - -<p>Lynx supports two styles of options menu. The new style shown below is an HTML -file generated at runtime: - +key. It allows you to change options at runtime, if you need to. +Most changes are read from & saved to your .lynxrc file; those which are not +are marked (!) in the form-based menu (as below). Many other options +are stored in the <A HREF="#lynx.cfg">lynx.cfg</A> file. + +<p>Lynx supports two styles of Options Menu, key-based & form-based. +The form-based menu shown below is an HTML file generated at runtime, +in which the user fills in choices as in any ordinary HTML form. <pre> Options Menu (Lynx Version 2.8.2pre.6) @@ -494,9 +495,10 @@ file generated at runtime: HREF="keystrokes/option_help.html">HELP!</A> Save options to disk: [_] + (options marked with (!) will not be saved) Personal Preferences - Cookies : [ask user..] + Cookies (!) : [ask user..] Editor : __________________________________________ Emacs keys : [OFF] Keypad mode : [Numbers act as arrows.............] @@ -508,14 +510,14 @@ HREF="keystrokes/option_help.html">HELP!</A> VI keys : [OFF] Visited Pages : [As Visit Tree..........] Display character set : [Western (ISO-8859-1)...........] - X Display : __________________________________________ + X Display (!) : __________________________________________ Document Layout - Assumed document character set : [iso-8859-1......] - Raw 8-bit : [ON.] - HTML error recovery : [strict (SortaSGML mode)] + Assumed document character set(!): [iso-8859-1......] + Raw 8-bit (!) : [ON.] + HTML error recovery (!) : [strict (SortaSGML mode)] Popups for select fields : [ON.] - Show images : [as labels] + Show images (!) : [as labels] Verbose images : [show filename] Bookmark Options @@ -529,19 +531,19 @@ HREF="keystrokes/option_help.html">HELP!</A> Headers transferred to remote server Preferred document character set : _________________________________ Preferred document language : _________________________________ - User-Agent header : __________________________________________ + User-Agent header (!) : __________________________________________ Check your lynx.cfg here Accept Changes - Reset Changes Left Arrow cancels changes </pre> - -<p>The old style of options menu is a fixed form. Normally this will be -compiled into Lynx, and is accessed by setting FORMS_OPTIONS true in your -<A HREF="#lynx.cfg">lynx.cfg</A> file. - +<p>The key-based menu depends on key-strokes to identify options +which the user wants to change. It is compiled into Lynx +and is accessed by setting FORMS_OPTIONS to TRUE in +<A HREF="#lynx.cfg">lynx.cfg</A>. <pre> + Options Menu (Lynx Version 2.8.2pre.6) (E)ditor : emacs @@ -597,7 +599,7 @@ return to Lynx or the '<em>></em>' command to save the options to a <dt>Editor <dd>The editor to be invoked when editing browsable files, when sending mail or comments, when preparing a news article for - posting, and for external TEXTAREA editing. The full pathname + posting, and for external TEXTAREA editing. The full pathname of the editor command should be specified when possible. <dt>DISPLAY variable @@ -785,7 +787,7 @@ return to Lynx or the '<em>></em>' command to save the options to a <p>Note: this has no direct effect on the line-editor's key bindings. <dt>Visited Pages - <dd>Enable several different views of the visited links: + <dd>Enable several different views of the visited links: <dl> <dt>By First Visit <dt>By First Visit Reversed @@ -902,7 +904,7 @@ return to Lynx or the '<em>></em>' command to save the options to a or "L_y_n_x". <dt>Local execution scripts or links - <dd>Local execution can be activated by the system administrator. + <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 @@ -1005,11 +1007,13 @@ received the article supports posting from your site, a link that says <h2 ID="Bookmarks"><A NAME="Bookmarks"><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 +Bookmarks are entries in your <em>bookmark file</em>, which record +the URL of a document you may want to return to easily, with a name +of your choice to identify the document. To use bookmarks +you must first have specified a name for your bookmark file +in <A HREF="#lynx.cfg">lynx.cfg</A> or via the <em>Options Menu</em>. +<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: <blockquote> @@ -1103,8 +1107,7 @@ on your local system. The commands available in DIRED mode are <dd>Type '<em>c</em>' to create a new file. New file will be empty. <dt><code>D)ownload</code> -<dd>Type '<em>d</em>' to download selection using one of the options defined - by your system administrator. +<dd>Type '<em>d</em>' to download using one of the pre-defined options. <dt><code>E)dit</code> <dd>Type '<em>e</em>' to spawn the editor defined in <em>Options Menu</em> @@ -1129,8 +1132,9 @@ on your local system. The commands available in DIRED mode are 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. +<dd>Type '<em>u</em>' to upload a file to the present directory. + An uploading method must have been pre-defined in + <A HREF="#lynx.cfg">lynx.cfg</A> . </dl> [<A HREF="#ToC-DirEd">ToC</A>] @@ -1306,13 +1310,11 @@ commands. before the interrupt, it will be displayed. <dt><em>numbers</em> <dd>Lynx offers other, advanced navigation features when numbers - are used to invoke the <a - href="keystrokes/follow_help.html" - >Follow link (or goto link or page) number:</a> or<br> - <a - href="keystrokes/follow_help.html#select-option" - >Select option (or page) number:</a><br> - prompts. + are used to invoke the + <a href="keystrokes/follow_help.html">Follow Link + (or goto link or page) number:</a> + or <a href="keystrokes/follow_help.html#select-option">Select + Pop-up Option Number:</a> prompts. [<A HREF="#ToC-MiscKeys">ToC</A>] </dl> @@ -1375,77 +1377,135 @@ options from a list, and fields for entering text. href="#submit">submit</a> the form if the text entry field is the only non-hidden field in the form. + If <A NAME="tna">"Textfields Need Activation"</A> mode is turned on + (with the <kbd>-tna</kbd> command-line option), + then text entry fields do not become active immediately upon being + selected, as normally. Keystrokes have their normal command meaning + unless the Line Editor gets activated with <em>Return</em> or <em>Right + Arrow</em>. This mode can be used to avoid "getting stuck" in input + fields, especially by users who rarely fill out forms. + + <DIV ID="CtrlVNote"> + <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="keystrokes/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; or prefix your + keystroke with <em>^V</em> to temporarily escape from line editing. + <p> + Some flavors of UNIX, shells & terminal settings require + that you enter <em>^V^Ve</em> in order to start the external editor, + as they also use <em>^V</em> as default command-line quote key + (called `lnext' in stty man pages and `stty -a' output); + to avoid this, you can put `stty lnext undef' in your .cshrc + file (or .profile or .bashrc, depending on what shell you use), + or invoke Lynx with a wrapper script, e.g.<p> + + <code> + #!/bin/sh<br> + stty lnext undef<br> + $HOME/bin/lynx "$@"<br> + stty lnext ^V<br> + exit</code><p> + + NB when NOT in the Line Editor, <em>^V</em> is by default bound + to the command + to switch between SortaSGML and TagSoup HTML parsing + (i.e., SWITCH_DTD). + To avoid confusion, either of these separate functions could be changed + (mapped away) with a KEYMAP directive in <em>lynx.cfg</em>. For + example,<br> + KEYMAP:^V:DO_NOTHING<br> + KEYMAP:#:SWITCH_DTD<br> + would map SWITCH_DTD away from <em>^V</em> to <em>#</em>, while leaving + its default Line Editor function as a command escape in place. On the + other hand,<br> + KEYMAP:^V::NOP:1<br> + KEYMAP:^_::LKCMD:1<br> + would move <em>^V</em>'s Line Editor binding as command escape to + <em>^_</em> for the first Line Edit style, letting <em>^V</em> still + act as SWITCH_DTD + outside of text input fields. + </DIV> + <dt>TEXTAREA Fields -<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 +<dd>TEXTAREA fields are for most purposes 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 + or next line of the overall message, as for INPUT fields. The <em>TAB</em> key will move you down beyond the bottom of the TEXTAREA - field. + field, and <em>Back Tab</em> (if available, e.g., as Shift-Tab, and + correctly mapped in the terminal description) will move backward to + a link or field before the TEXTAREA. <dt>Editing TEXTAREA Fields and Special TEXTAREA Functions <dd>TEXTAREA fields can be edited using an external editor. The statusline should tell you when this is possible and what key to use, it might for example say -<PRE> <strong>(Textarea) Enter text. </strong>[...] <strong>(^Ve for editor).</strong></PRE> +<PRE> <strong + >(Textarea) Enter text. </strong>[ ..... ]<strong> (^Xe for editor).</strong></PRE> An external editor has to be defined, for example in the <a href="#InteractiveOptions">Options Menu</a>, before you can start using this function. - <p>To map a key so that it will invoke external TEXTAREA editing, you - can either configure Lynx to use the <a - href="keystrokes/bashlike_edit_help.html">Bash-like Line-Editor - Bindings</a>, or add KEYMAP bindings to your <em>lynx.cfg</em> file, - e.g.<br> + <p>A key to invoke external TEXTAREA editing is normally provided + by the <a href="keystrokes/edit_help.html">Line-Editor Key</a> Bindings. + A KEYMAP directive in <em>lynx.cfg</em> can also be used to + make a different key invoke external editing; it will then normally + be necessary to prefix that key with <em>^V</em> to "escape" from + line-editing. Two variants exist,<br> KEYMAP:e:EDITTEXTAREA<br> or<br> KEYMAP:e:DWIMEDIT<br> (the first is only functional for TEXTAREA editing, while the second allows to use the same key for normal <a href="#FileEdit">file - editing</A>).</p> + editing</a> <em>as long as both functions don't conflict</em>). + <p>Please see the <a href="#CtrlVNote">note above</a> for details + about <em>^V</em> behavior.</p> You can also use two other special TEXTAREA functions. Again, these are already bound to key sequences in the <a - href="keystrokes/bashlike_edit_help.html#TASpecial">Bash-like Bindings</a>. - You can invoke them independently of the line edit style + href="keystrokes/edit_help.html#TASpecial">Line-Editor + Bindings</a>, by default <em>^Xg</em> and <em>^Xi</em>. + You can use different keys by adding KEYMAP bindings to your <em>lynx.cfg</em> file, e.g.<p> KEYMAP:$:GROWTEXTAREA<br> KEYMAP:#:INSERTFILE<p> - With these bindings -- you can choose other keys -- ,<br> - (in a TEXTAREA only) <em>^V$</em> adds 5 lines to the TEXTAREA - and <em>^V#</em> prompts for the name of an existing file + With these bindings, + (in a TEXTAREA only) <em>^V$</em> would add 5 lines to the TEXTAREA + and <em>^V#</em> would prompt for the name of an existing file to be inserted into the TEXTAREA (above the cursorline). - An automatic variation is normally compiled in, + An automatic variation of GROWTEXTAREA is normally compiled in, so that hitting <em>Enter</em> with the cursor on the last line adds a new line to the TEXTAREA, with the cursor on it.<p> - Some flavors of UNIX, shells & terminal settings require - that you enter <em>^V^Ve</em> in order to start the external editor, - as they also use <em>^V</em> as default command-line quote key - (called `lnext' in stty man pages and `stty -a' output); - to avoid this, you can put `stty lnext undef' in your .cshrc - file (or .profile or .bashrc, depending on what shell you use), - or invoke Lynx with a wrapper script, e.g.<p> - - <code> - #!/bin/sh<br> - stty lnext undef<br> - $HOME/bin/lynx "$@"<br> - stty lnext ^V<br> - exit</code><p> - - NB when NOT in the Line Editor, <em>^V</em> is by default bound - to the command - to switch between SortaSGML and TagSoup HTML parsing - (i.e., SWITCH_DTD ). - + If you have some single keys (or control keys) to spare that you + do not need for their normal purposes, you can dedicated those keys + to invoke the special functions (without requiring a prefix key). + For example, to use + the <em>^E</em> key for the DWIMEDIT action, and + the <em>Insert</em> key for the INSERTFILE action, + use<br> + KEYMAP:^E:DWIMEDIT:PASS<br> + KEYMAP:0x10C:INSERTFILE:PASS<br> + (see lynx.cfg for other keystroke codes to use). + + <p>Note that the default bindings that use <em>^X</em> as a prefix key + <em>may</em> also work by substituting the <kbd>Escape</kbd> key + for ^X. If your keyboard has a modifier (Meta) key that gets + transmitted as an ESC prefix, for example <kbd>Alt</kbd>, you can + then even use <em>Alt-e</em> instead of <em>^Xe</em>, <em>Alt-g</em> + instead of <em>^Xg</em>, and so on. But this does not work reliably + everywhere (it depends on the way Lynx is compiled, including which + libraries are used, and behavior of the connection and terminal type). </dl> In general, you can move around the form using the standard Lynx navigation @@ -1453,14 +1513,6 @@ 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, 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="keystrokes/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; or prefix your -keystroke with <em>^V</em> to temporarily escape from line editing. - - <p>To <A name="submit"><em>submit</em></a> the form press <em>right-arrow</em> or <em>Return</em> when positioned on the form's submit button. If you've submitted the form previously during the Lynx @@ -1621,19 +1673,19 @@ There are 3 choices in <em>lynx.cfg</em>, with 2 corresponding keys: MAKE_PSEUDO_ALTS_FOR_INLINES [ INLINE_TOGGLE VERBOSE_IMAGES no corresponding key </pre><p> -You can also use the Options Menu, as outlined below: +You can also use the <em>Options Menu</em>, as outlined below: <pre> - key lynx.cfg FM LM .lynxrc variable in source + key lynx.cfg FM KM .lynxrc variable in source * MAKE_LINKS_ Y N N clickable_images [ MAKE_PSEUDO_ Y N N pseudo_inline_alts VERBOSE_ Y Y Y verbose_img -FM = new Form Menu ; LM = old List Menu ; +FM = Form-based Menu ; KM = Key-based Menu ; in .lynxrc , VERBOSE_IMAGES is called `verbose_images': the other two cannot be saved between sessions. </pre><p> -In the Forms Menu, the 3-way `Show images' selection +In the Form-based Menu, the 3-way `Show images' selection combines the effects of the `*' & `[' keys, as follows: <pre> Ignore clickable_images = FALSE, pseudo_inline_alts = FALSE @@ -1663,6 +1715,50 @@ formatted content, or, if the <em>table</em> includes markup not allowed for PRE content, construct the <em>table</em> using <a href="#Tabs">HTML Tabs</a>. An example <em>table</em> using <em>TAB</em> elements is included in the test subdirectory of the Lynx distribution. + +<DIV ID="TRST"> +<p>Starting with version 2.8.3, Lynx renders some tables in tabular +form. This tabular representation for <em>simple</em> tables +(<dfn>TRST</dfn>) does not attempt to implement full support for any table +model. Limitations are: +<ul> + <li>All data constituting a table row generally has to fit within the + display width without inserting line breaks. + <li>Cell contents have to be simple. In general, only inline markup is + acceptable, no <code><P></code>, <code><BR></code> etc. + (although <code><BR></code> may + be ignored at the beginning of the first cell or at the end of the + last cell of a row). + <li>When tables are nested, only the innermost level is a candidate + for tabular representation. + <li>Most attributes are ignored, including borders, <code>WIDTH</code>, + vertical alignment. +</ul> +Horizontal alignments (<code>LEFT</code>, <code>CENTER</code>, +<code>RIGHT</code>), <code>COLSPAN</code>, and <code>ROWSPAN</code> are +interpreted according to HTML 4.01. (<code>ROWSPAN</code> can only reserve +empty space in subsequent rows, because of the limitations above.) When +TRST fails because a table is not "simple" enough, the representation falls +back to the minimal handling described earlier. +Many (but, unfortunately, by no means all) tables that represent inherently +tabular material will thus be shown with correct tabular formatting. +Where table markup is used only for layout purposes (containing whole blocks +of text and list within table cells) and not essential for understanding +the textual contents, it remains basically ignored. Some more information +on details is available in the file <kbd>README.TRST</kbd> of the source +distribution. +</DIV> + +<p>For tabular display of more complex tables, Lynx users can make use of +external scripts or programs. The normal Lynx distribution currently does +not provide such scripts, but they can be written locally or downloaded +from several sources. It is suggested to use one of Lynx's facilities for +invoking external programs (see <kbd>DOWNLOADER</kbd>, <kbd>PRINTER</kbd>, +<kbd>EXTERNAL</kbd>, <kbd>TRUSTED_LYNXCGI</kbd> in <A +HREF="#lynx.cfg">lynx.cfg</A> and <A HREF="lynx_url_support.html#cgi"><code +>lynxcgi:</code></A> in <em>Supported URLs</em> for information on various +ways for setting this up). + [<A HREF="#ToC-Tables">ToC</A>] <h2 ID="Tabs"><A NAME="Tabs"><em>Lynx and HTML Tabs</em></a></h2> @@ -2339,7 +2435,7 @@ where <dt><code>-number_links</code> <dd>force numbering of links. <dt><code>-partial</code> - <dd>toggles displaying of partial pages while downloading. + <dd>toggles displaying of partial pages while loading. <dt><code>-pauth=ID:PW</code> <dd>set authorization ID and password for a protected proxy server at startup. Be sure to protect any script files @@ -2562,6 +2658,9 @@ where keystroke command. If use of a Lynx Trace Log is turned off, any trace output will go to the standard error stream. + <dt><code>-tna</code> + <dd>turns on <A HREF="#tna">"Textfields Need Activation"</A> + mode. <dt><code>-trace</code> <dd>turns on Lynx trace mode. If a Lynx Trace Log (<em>Lynx.trace</em> in the home directory) has @@ -2654,10 +2753,11 @@ You may visit an index of options: <a href="http://www.hippo.ru/%7Ehvv/lynxcfg_toc.html">by category</a> or <a href="http://www.hippo.ru/%7Ehvv/lynxcfg_toc.html#alphatoc">by alphabet</a>. -<p>To see the current lynx.cfg state you may press <em>'o'</em> key -for <em>Options Menu</em> and follow <em>check your lynx.cfg</em> link -near the bottom; alternatively, you may also press <em>'='</em> key -for <em>Lynx Information Page</em> and follow a link from there near the top. +<p>To view your current configuration derived from lynx.cfg and any +included configuration files, press <em>'g'</em> and type in +'<em>lynxcfg:</em>'. If you are using the forms-based <em>Options +Menu</em>, you may press <em>'o'</em> for the Options Menu and follow +the '<em>Check your lynx.cfg</em>' link near the bottom. <p>However, for those who have a restricted account many Lynx features may be disabled by the system administrator, you probably will not see diff --git a/lynx_help/keystrokes/alt_edit_help.html b/lynx_help/keystrokes/alt_edit_help.html index 8b2e65a9..2f114526 100644 --- a/lynx_help/keystrokes/alt_edit_help.html +++ b/lynx_help/keystrokes/alt_edit_help.html @@ -11,8 +11,8 @@ 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 additional alternative key -bindings by configuring with --enable-alt-bindings or by adding them in +has not been defined. Additional alternative key-bindings can be offered +by configuring with --enable-alt-bindings or by adding them in LYEditmap.c before compiling Lynx. If available, they may be selected via the 'o'ptions menu, or by editing lineedit_mode in the '.lynxrc' file. @@ -38,7 +38,6 @@ the '.lynxrc' file. DELN Delete next [1] char - Ctrl-D DELPW Delete prev word - Ctrl-R DELNW Delete next word - Ctrl-T - DELBL Delete to beg of line - Ctrl-X DELEL Delete to end of line - Ctrl-K UPPER Upper case the line - Ctrl-^ @@ -46,13 +45,23 @@ the '.lynxrc' file. LKCMD Invoke cmd prompt - Ctrl-V (in form text fields, only) [2] +<A NAME="TASpecial">Special commands for use only in textarea fields</A>[3]: + + Textarea external edit - Ctrl-X e + Insert file in textarea - Ctrl-X i + Grow textarea - Ctrl-X g + [1] "next" means the character "under" a box or underline style cursor; it means "to the immediate right of" an I-beam (between characters) type cursor. -[2] Follow Ctrl-V with the key "e" bound to the DWIMEDIT function, - or with some other key bound to EDITTEXTAREA or DWIMEDIT, - to edit the form's textarea field using an external editor. +[2] Follow Ctrl-V with any recognized key command, to "escape" from a text + input field. + +[3] For other key combinations using Ctrl-X as a prefix key, see the + Help page for the <a rel="Sibling" title="Bash-Like Binding" + href="bashlike_edit_help.html" + >Bash-Like</a> Binding. </pre> </body> </html> diff --git a/lynx_help/keystrokes/bashlike_edit_help.html b/lynx_help/keystrokes/bashlike_edit_help.html index e0d63157..a12e8eb5 100644 --- a/lynx_help/keystrokes/bashlike_edit_help.html +++ b/lynx_help/keystrokes/bashlike_edit_help.html @@ -11,8 +11,8 @@ 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 several sets of key -bindings by configuring with --enable-alt-bindings or by adding them in +has not been defined. Several sets of key-bindings can be offered +by configuring with --enable-alt-bindings or by adding them in LYEditmap.c before compiling Lynx. If available, they may be selected via the 'o'ptions menu, or by editing lineedit_mode in the '.lynxrc' file. @@ -161,7 +161,9 @@ Passed as specific command: M-e EDITTEXTAREA C-e C-e M-g GROWTEXTAREA (none, C-v $ suggested?) M-i INSERTFILE (none, C-v # suggested?) - M-F1 DWIMHELP (none, F1 suggested) + M-< HOME M-Home + M-> END M-End + M-F1 DWIMHELP F1 M-Find WHEREIS C-v / M-Select NEXT C-v n diff --git a/lynx_help/keystrokes/bookmark_help.html b/lynx_help/keystrokes/bookmark_help.html index de08f394..da1e6cfe 100644 --- a/lynx_help/keystrokes/bookmark_help.html +++ b/lynx_help/keystrokes/bookmark_help.html @@ -15,7 +15,7 @@ the current document or the currently highlighted link to your default enabled. The remove feature, invoked by pressing an '<em>r</em>' when a <em>Bookmark file</em> is being displayed, will remove the currently highlighted link. You may set and modify the paths and names of your -<em>Bookmark files</em>, and enable or disable multiple bookmarks, in -the <A HREF="option_help.html">options screen.</A> +<em>Bookmark files</em> and enable or disable multiple bookmarks +in the <A HREF="option_help.html">Options Menu</A>. </BODY> </HTML> diff --git a/lynx_help/keystrokes/dired_help.html b/lynx_help/keystrokes/dired_help.html index 3cb11d7e..31385348 100644 --- a/lynx_help/keystrokes/dired_help.html +++ b/lynx_help/keystrokes/dired_help.html @@ -11,17 +11,11 @@ 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. @@ -40,12 +34,20 @@ remapped to do the following functions: a file. U)pload - Upload a file to the current directory using - one of the options listed in the upload - options screen. + one of the options listed in the upload screen. +</pre> +Some other keys useful in Dired mode: +<pre> + 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 Menu</a> + and load selection for editing. </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. +<em>Note:</em> Dired mode must be activated at compile time. +Otherwise, the above commands will not be available +and Lynx will treat a directory listing as an HTML file. </body> </html> diff --git a/lynx_help/keystrokes/edit_help.html b/lynx_help/keystrokes/edit_help.html index e4148fca..681756b1 100644 --- a/lynx_help/keystrokes/edit_help.html +++ b/lynx_help/keystrokes/edit_help.html @@ -9,7 +9,7 @@ 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 alternative key bindings +has not been defined. Alternative key bindings can be offered by configuring with --enable-alt-bindings or by adding them in LYEditmap.c before compiling Lynx. If available, they may be selected via the 'o'ptions menu, or by editing lineedit_mode in the @@ -27,7 +27,7 @@ are the <A HREF="alt_edit_help.html">Alternative Binding</A> keymap and the ENTER Input complete - RETURN TAB Input complete - TAB, Do ABORT Input cancelled - Ctrl-G, Ctrl-O, (Ctrl-C on some systems) - ERASE Erase the line - Ctrl-U, Ctrl-X + ERASE Erase the line - Ctrl-U BACK Cursor back char - Left-Arrow FORW Cursor forward char - Right-Arrow @@ -48,13 +48,23 @@ are the <A HREF="alt_edit_help.html">Alternative Binding</A> keymap and the LKCMD Invoke cmd prompt - Ctrl-V (in form text fields, only) [2] SWMAP Switch input keymap - Ctrl-^ (if compiled in) +<A NAME="TASpecial">Special commands for use only in textarea fields</A>[3]: + + Textarea external edit - Ctrl-X e + Insert file in textarea - Ctrl-X i + Grow textarea - Ctrl-X g + [1] "next" means the character "under" a box or underline style cursor; it means "to the immediate right of" an I-beam (between characters) type cursor. -[2] Follow Ctrl-V with the key "e" bound to the DWIMEDIT function, - or with some other key bound to EDITTEXTAREA or DWIMEDIT, - to edit the form's textarea field using an external editor. +[2] Follow Ctrl-V with any recognized key command, to "escape" from a text + input field. + +[3] For other key combinations using Ctrl-X as a prefix key, see the + Help page for the <a rel="Sibling" title="Bash-Like Binding" + href="bashlike_edit_help.html" + >Bash-Like</a> Binding. </pre> </body> </html> diff --git a/lynx_help/keystrokes/keystroke_help.html b/lynx_help/keystrokes/keystroke_help.html index 64a71010..db9861d0 100644 --- a/lynx_help/keystrokes/keystroke_help.html +++ b/lynx_help/keystrokes/keystroke_help.html @@ -11,7 +11,7 @@ >MOVEMENT</A>: Down arrow - Highlight next topic Up arrow - Highlight previous topic Right arrow, - Jump to highlighted topic - Return, Enter (follow selected link) + Return, Enter - Follow selected link Left arrow - Return to previous topic <A HREF="scrolling_help.html" @@ -29,7 +29,7 @@ ( - 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 + <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 @@ -83,12 +83,19 @@ ] - Send a HEAD request for the current doc or link " - Toggle valid or "soft" double-quote parsing CTRL-R - Reload current file and refresh the screen - CTRL-V - Switch to <A HREF="option_help.html#tagsoup" - >alternative parsing</A> of HTML documents CTRL-L - Refresh the screen + + CTRL-V - Outside of a text input line or field, + switch to <A HREF="option_help.html#tagsoup" + >alternative parsing</A> of HTML. + - In a form text input field, + CTRL-V prompts for a key command (allows + <A HREF="../Lynx_users_guide.html#CtrlVNote" + >escaping</A> from the field). CTRL-U - Erase input line (<a href="edit_help.html" >more input line commands</a>) CTRL-G - Cancel input or transfer + CTRL-T - Toggle trace mode on and off ; - View the Lynx Trace Log for the current session CTRL-K - Invoke the <A HREF="cookie_help.html" diff --git a/lynx_help/keystrokes/option_help.html b/lynx_help/keystrokes/option_help.html index 947dcfcc..a5b50e04 100644 --- a/lynx_help/keystrokes/option_help.html +++ b/lynx_help/keystrokes/option_help.html @@ -1,15 +1,15 @@ <!DOCTYPE html public "-//IETF//DTD HTML 3.0//EN"> <HTML> <HEAD> -<TITLE>Options Screen Help</TITLE> +<TITLE>Form-based Options Menu : Help</TITLE> <LINK rev="made" href="mailto:lynx-dev@sig.net"> </HEAD> <BODY> -<h1>OPTIONS SCREEN HELP</h1> +<h1>FORM-BASED OPTIONS MENU : HELP</h1> -The Options Screen allows you to set and modify many Lynx features.<BR> +The Options Menu 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> +compiled in or chosen in `lynx.cfg': <UL> <LI>Personal Preferences @@ -90,8 +90,7 @@ with the arrow keys. You can also number form fields. <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 -<A HREF="alt_edit_help.html">Alternate Bindings</A>. +if <A HREF="alt_edit_help.html">Alternate Bindings</A> have been installed. Otherwise, Lynx uses the <A HREF="edit_help.html">Default Binding</A>. <H1><A NAME="PM">Personal Mail Address</A></H1> @@ -251,24 +250,24 @@ from lynx.cfg or command line switch. <H1><A NAME="SI">Show Images</A></H1> -This option combines the effects of the `*' & `[' keys as follows: -<p><pre> +This option combines the effects of the `*' & `[' keys as follows: +<pre> <em>ignore</em> all images which lack an ALT= text string, <em>show labels</em>, e.g. [INLINE] -- see `Verbose Images' below -- , <em>use links</em> for every image, enabling downloading. </pre><p> This option setting cannot be saved between sessions. See <A HREF="../Lynx_users_guide.html#Images">Users Guide</A> -& <em>lynx.cfg</em> for more details. +& <em>lynx.cfg</em> for more details. <H1><A NAME="VB">Verbose Images</A></H1> This allows you to replace [LINK], [INLINE] and [IMAGE] -- for images without ALT -- with filenames: this can be helpful by revealing which images are important -& which are merely decoration, e.g. <em>button.gif</em>, <em>line.gif</em>. +& which are merely decoration, e.g. <em>button.gif</em>, <em>line.gif</em>. See <A HREF="../Lynx_users_guide.html#Images">Users Guide</A> -& <em>lynx.cfg</em> for more details. +& <em>lynx.cfg</em> for more details. <H1><A NAME="VI">VI keys</A></H1> diff --git a/lynx_help/keystrokes/other_help.html b/lynx_help/keystrokes/other_help.html index 8ad98ead..62e32755 100644 --- a/lynx_help/keystrokes/other_help.html +++ b/lynx_help/keystrokes/other_help.html @@ -36,14 +36,12 @@ ? 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. + i - Shows an index of files or subjects, + which may be changed in <em>lynx.cfg</em>. + + j - Allows you to enter a short name to goto an URL, + if a jumps file has been defined. Press "?" + and ENTER to see the list of defined jump commands. k - Shows a list of key mappings. Keys remapped in "lynx.cfg" show up in this list. diff --git a/lynx_help/keystrokes/print_help.html b/lynx_help/keystrokes/print_help.html index 153caa74..a5f9a89f 100644 --- a/lynx_help/keystrokes/print_help.html +++ b/lynx_help/keystrokes/print_help.html @@ -30,8 +30,7 @@ may be available: valid e-mail address. <dt>Custom print options: -<dd>Any number of custom print options may be available, as defined - by your system administrator. +<dd>Any number of custom print options may be defined in <em>lynx.cfg</em>. </dl> </BODY> </HTML> diff --git a/lynx_help/lynx_url_support.html b/lynx_help/lynx_url_support.html index 47bd0679..ec0fe551 100644 --- a/lynx_help/lynx_url_support.html +++ b/lynx_help/lynx_url_support.html @@ -594,22 +594,42 @@ within Lynx. <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: +Lynx uses a variety of private URL schemes form communication among its +internal modules. They start with uppercase letters <code>LYNX</code> +by convention, although, as input, URL schemes are recognized in a +case-insensitive manner. +<p> +As you discover what they are, and are tempted to use them externally in +documents, you should <em>resist</em> that temptation: +<UL><LI>There already is too much browser-specific markup around... +<LI>The schemes, or their meanings, may change between Lynx versions. +<LI>Even if a scheme stays the same, some aspect of its behavior may + be modified without notice, or the context in which it is allows + may change. +<LI>If it doesn't work as expected when used outside of the intended + purpose, don't expect anyone to "fix" it. +</UL> + +<p>For example, tempting though it might be, do not use these: <pre> <em>Return to your <A HREF="LYNXHIST:0">Startfile</A></em> <em>Review your <A HREF="LYNXKEYMAP:">Keymap</A></em> </pre> -(Yes, they'll work. No, they won't do any harm. But...) +(No, they won't do any harm. Yes, they work. But don't rely on it.) -<p>If you <em>must</em> try one, the second is OK from the command line:<BR> +<p>If you must try one, the second is OK from the command line:<BR> <pre> <em>lynx LYNXKEYMAP:</em> </pre> But within Lynx, use the '<em>K</em>' keystroke command. +Sometimes it may be convenient to use an internal scheme with +'<em>g</em>'oto, as in: +<pre> + <em>g LYNXMESSAGES:</em> + <em>g LYNXCOMPILEOPTS:</em> + <em>g LYNXCFG:</em> +</pre> +But again, there usually is a way in which those special pages are +meant to be reached that is more convenient. </BODY> </HTML> |