about summary refs log tree commit diff stats
path: root/lynx_help/keystrokes/bashlike_edit_help.html
diff options
context:
space:
mode:
Diffstat (limited to 'lynx_help/keystrokes/bashlike_edit_help.html')
-rw-r--r--lynx_help/keystrokes/bashlike_edit_help.html145
1 files changed, 80 insertions, 65 deletions
diff --git a/lynx_help/keystrokes/bashlike_edit_help.html b/lynx_help/keystrokes/bashlike_edit_help.html
index bb175990..b62e6cb3 100644
--- a/lynx_help/keystrokes/bashlike_edit_help.html
+++ b/lynx_help/keystrokes/bashlike_edit_help.html
@@ -1,4 +1,4 @@
-<!-- $LynxId: bashlike_edit_help.html,v 1.9 2013/05/22 00:25:19 tom Exp $ -->
+<!-- $LynxId: bashlike_edit_help.html,v 1.10 2014/01/08 00:50:05 tom Exp $ -->
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">
 
 <html>
@@ -14,45 +14,47 @@
   "alt_edit_help.html">
   <meta http-equiv="Content-Type" content=
   "text/html; charset=us-ascii">
-</head>
+  <meta name="description" content=
+  "Describes the bash-like line editor bindings for Lynx. This is one of the alternate bindings normally compiled-in">
+  </head>
 
 <body>
-  <h1>BASH-LIKE BINDING</h1>
+  <h2>Overview</h2>
 
-  <p>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. 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.</p>
+  <p>Lynx invokes a built-in <a href="edit_help.html">Line
+  Editor</a> for entering strings in response to prompts, in forms,
+  and for email messages if an external editor 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.</p>
 
   <p>Note: setting emacs/vi keys ON has no direct effect on
   line-editor bindings.</p>
 
-  <p>This is the <em>Bash-like Binding</em> keymap.</p>
+  <p>This summarizes the <em>Bash-like Binding</em> keymap.</p>
 
   <h2>Basic commands</h2>
   <pre>
      ENTER  Input complete        -  Enter, RETURN
-     TAB    Completion [2]/ Next  -  TAB, Do
+     TAB    Completion / Next     -  TAB, Do (<em>see note 2</em>)
      ABORT  Cancel / Undo Change  -  C-g, C-_
      ERASE  Erase the line        -  M-k, C-x k
 
      BACK   Cursor back     char  -  Left-Arrow,  C-b
      FORW   Cursor forward  char  -  Right-Arrow, C-f
      BACKW  Cursor back     word  -  M-b, C-r
-     FORWW  Cursor forward  word  -  M-f, C-s [5]
+     FORWW  Cursor forward  word  -  M-f, C-s (<em>see note 5</em>)
      BOL    Go to begin of  line  -  C-a, Home, Find
-     EOL    Go to end   of  line  -  C-e [4], End,  Select
+     EOL    Go to end   of  line  -  C-e, End,  Select (<em>see note 4</em>)
 
      DELP   Delete prev     char  -  C-h, Backspace, Rubout
-     DELN   Delete next [1] char  -  C-d, Delete, Remove
-     DELPW  Delete prev     word  -  C-w [3], M-Backspace, M-Delete (?)
+     DELN   Delete next     char  -  C-d, Delete, Remove (<em>see note 1</em>)
+     DELPW  Delete prev     word  -  C-w, M-Backspace, M-Delete (?) (<em>see note 3</em>)
      DELNW  Delete next     word  -  M-d
      DELBL  Delete to beg of line -  C-u
-     DELEL  Delete to end of line -  C-k [4]
+     DELEL  Delete to end of line -  C-k (<em>see note 4</em>)
 
      UPPER  Upper case the line   -  M-u
      LOWER  Lower case the line   -  M-l
@@ -63,11 +65,13 @@
 <a name="TASpecial" id=
 "TASpecial">Special commands for use in textarea fields</a> [FORM]:
 
-     PASS!  Textarea external edit  - C-e C-e [4], C-x e
+     PASS!  Textarea external edit  - C-e C-e, C-x e (<em>see note 4</em>)
      PASS!  Insert file in textarea - C-x i
      PASS!  Grow textarea           - C-x g
 </pre>
 
+  <h2>Try it yourself</h2>
+
   <p>Here is a little textarea for practice:</p>
 
   <form action="">
@@ -79,18 +83,18 @@ then submitted.  You can move around here and delete
 or add text as you like, using the Line-Editor keys.
 </textarea><input type="reset" value="[reset content]"></p>
   </form>
-  <pre>
 
-Advanced emacs-like commands:
+  <h2>Advanced emacs-like commands</h2>
+  <pre>
 
     TPOS    Transpose characters                   -  C-t
     SETMARK Set mark at current position in line   -  C-@
     XPMARK  Exchange current position with mark    -  C-x C-x
-    KILLREG Kill region between mark and position  -  C-x C-w [3]
+    KILLREG Kill region between mark and position  -  C-x C-w (<em>see note 3</em>)
     YANK    Insert text last killed (with KILLREG) -  C-y
 </pre>
 
-  <h2>Notes</h2>
+  <h2>Comments on special keys</h2>
 
   <p><samp><dfn>C-</dfn><strong>key</strong> means
   Control+<strong><kbd>key</kbd></strong>.
@@ -121,58 +125,69 @@ Advanced emacs-like commands:
     can also be typed as C-x <strong><kbd>key</kbd></strong>, and
     vice versa.</li>
   </ul>
-  <pre>
-[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] For entering strings in response to prompts (that is, when not editing
-    form text fields), some keys have different actions: TAB tries to
-    complete input based on previous response; Up-Arrow and Down-Arrow
-    may offer previous response and next response, respectively, from
-    recall buffer for some prompts.
-[3] C-w can only be used for editing functions if its default KEYMAP
-    to REFRESH is changed.  This can be done in the lynx.cfg file,
-    for example with the line "KEYMAP:^W:DO_NOTHING".  This also applies
-    for other keys: as long as the key's action is mapped to REFRESH,
-    either with an explicit KEYMAP in lynx.cfg or by default, the
-    key's Line Editor binding is disabled.
-[4] These keys invoke special behavior when pressed twice in a row:
-    C-e C-e calls the external editor for changing the text in a
-    textarea (if available).  C-k C-k will move to the next link,
+
+  <h2>Notes</h2>
+
+  <ol>
+    <li>"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.</li>
+
+    <li>For entering strings in response to prompts (that is, when
+    not editing form text fields), some keys have different
+    actions: TAB tries to complete input based on previous
+    response; Up-Arrow and Down-Arrow may offer previous response
+    and next response, respectively, from recall buffer for some
+    prompts.</li>
+
+    <li>C-w can only be used for editing functions if its default
+    KEYMAP to REFRESH is changed. This can be done in the lynx.cfg
+    file, for example with the line "KEYMAP:^W:DO_NOTHING". This
+    also applies for other keys: as long as the key's action is
+    mapped to REFRESH, either with an explicit KEYMAP in lynx.cfg
+    or by default, the key's Line Editor binding is disabled.</li>
+
+    <li>These keys invoke special behavior when pressed twice in a
+    row: C-e C-e calls the external editor for changing the text in
+    a textarea (if available). C-k C-k will move to the next link,
     so that all lines in a textarea can be conveniently cleared by
-    repeating C-k.
-[5] Key is likely unavailable for Lynx, because it is interpreted by
-    operating system, comm program, or curses library, or swallowed
-    as part of escape sequence recognition.  Binding is provided for
-    the benefit of those where this doesn't apply.
-[FORM] In form text fields, only.  Ignored by Line Editor elsewhere.
-
-More notes
-
-   When a text input field, including a textarea line, is selected,
-   the Line Editor functions get a first grab at the keys entered.
-   If a key has no function defined in the Line Editor binding, it
-   can either be ignored, or passed on for normal key command handling,
-   where modifiers like C-x or Meta currently have no effect (see the
-   <a href=
-"LYNXKEYMAP:">Key Map Page</a> accessible with the key <kbd>K</kbd> for current information).
-</pre>
+    repeating C-k.</li>
+
+    <li>Key is likely unavailable for Lynx, because it is
+    interpreted by operating system, comm program, or curses
+    library, or swallowed as part of escape sequence recognition.
+    Binding is provided for the benefit of those where this doesn't
+    apply.</li>
+
+    <li>where <strong>[FORM]</strong> is marked, indicates that the
+    binding is effective only in form text fields. It is ignored by
+    Line Editor elsewhere.</li>
+  </ol>
+
+  <p>When a text input field, including a textarea line, is
+  selected, the Line Editor functions get a first grab at the keys
+  entered. If a key has no function defined in the Line Editor
+  binding, it can either be ignored, or passed on for normal key
+  command handling, where modifiers like C-x or Meta currently have
+  no effect (see the <a href="LYNXKEYMAP:">Key Map Page</a>
+  accessible with the key <kbd>K</kbd> for current
+  information).</p>
 
   <h2>Additional details on other keys, for the curious (very much
   subject to change)</h2>
   <pre>
 Normal key action when used in form fields, subject to remapping
 with KEYMAP: [FORM (except Up-Arrow, Down-Arrow)]
-            C-l [3], C-o, C-z [5], C-\ [5], C-] [5]
+            C-l (<em>see note 3</em>) C-o, C-z [5], C-\ [5], C-] [5] (<em>see note 5</em>)
             C-n [emacskey], C-p [emacskey]
-            Up-Arrow [2], Down-Arrow [2]
+            Up-Arrow, Down-Arrow (<em>see note 2</em>)
             Page-Up, Page-Down, F1, Back-Tab
 
 Normal key command with Meta modifier ignored when used in form fields,
 subject to remapping with KEYMAP: [FORM (except Up-Arrow, Down-Arrow)]
-            M-C-l [3], M-C-o [!], M-C-z [5], M-C-\ [5], M-C-] [5]
+            M-C-l (<em>see note 3</em>) M-C-o [!], M-C-z [5], M-C-\ [5], M-C-] [5] (<em>see note 5</em>)
             M-C-u, M-/, M-n
-            M-Up-Arrow [2][!], M-Down-Arrow [2][!]
+            M-Up-Arrow [!], M-Down-Arrow [!] (<em>see note 2</em>)
             M-Page-Up [!], M-Page-Down [!], M-Home, M-End
 
 Passed as specific command:
@@ -216,12 +231,12 @@ Modifier ignored, and duplicates function of other key(s):
 
 Key completely ignored:
             C-q, Insert
-            M-C-q, M-C-s [5], M-C-t, M-C-v, M-ESC
+            M-C-q, M-C-s [5], M-C-t, M-C-v, M-ESC (<em>see note 5</em>)
             M-C-@, M-C-_, M-Remove, M-Insert [!]
 
 Meta + other (mostly, printable character) keys:
-              Modifier ignored, or sequence swallowed (see [5]).
-            M-@, M-E...M-Z [5], M-\, M-^, M-_ attempt to interpret
+              Modifier ignored, or sequence swallowed (<em>see note 5</em>).
+            M-@, M-E...M-Z, M-\, M-^, M-_ attempt to interpret
               as 7-bit escape representation for character in 8-bit
               control (C1) range if appropriate according to
               Display Character Set.