import gdb-19990422 snapshot
authorStan Shebs <shebs@codesourcery.com>
Tue, 27 Apr 1999 01:30:31 +0000 (01:30 +0000)
committerStan Shebs <shebs@codesourcery.com>
Tue, 27 Apr 1999 01:30:31 +0000 (01:30 +0000)
readline/doc/readline.0 [new file with mode: 0644]

diff --git a/readline/doc/readline.0 b/readline/doc/readline.0
new file mode 100644 (file)
index 0000000..c925d52
--- /dev/null
@@ -0,0 +1,1122 @@
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+N\bNA\bAM\bME\bE
+       readline - get a line from a user with editing
+
+S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
+       #\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<r\bre\bea\bad\bdl\bli\bin\bne\be.\b.h\bh>\b>
+       #\b#i\bin\bnc\bcl\blu\bud\bde\be <\b<h\bhi\bis\bst\bto\bor\bry\by.\b.h\bh>\b>
+
+       c\bch\bha\bar\br *\b*r\bre\bea\bad\bdl\bli\bin\bne\be (\b(p\bpr\bro\bom\bmp\bpt\bt)\b)
+       c\bch\bha\bar\br *\b*p\bpr\bro\bom\bmp\bpt\bt;\b;
+
+C\bCO\bOP\bPY\bYR\bRI\bIG\bGH\bHT\bT
+       Readline  is Copyright (C) 1989, 1991, 1993, 1995, 1996 by
+       the Free Software Foundation, Inc.
+
+D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
+       r\bre\bea\bad\bdl\bli\bin\bne\be will read a line from the terminal and return it,
+       using p\bpr\bro\bom\bmp\bpt\bt as a prompt.  If p\bpr\bro\bom\bmp\bpt\bt is null, no prompt is
+       issued.  The line returned is allocated with _\bm_\ba_\bl_\bl_\bo_\bc(3), so
+       the  caller must free it when finished.  The line returned
+       has the final newline removed, so only  the  text  of  the
+       line remains.
+
+       r\bre\bea\bad\bdl\bli\bin\bne\be  offers  editing  capabilities  while the user is
+       entering the line.  By default, the line editing  commands
+       are  similar  to  those of emacs.  A vi-style line editing
+       interface is also available.
+
+R\bRE\bET\bTU\bUR\bRN\bN V\bVA\bAL\bLU\bUE\bE
+       r\bre\bea\bad\bdl\bli\bin\bne\be returns the text of the line read.  A blank  line
+       returns  the  empty  string.   If E\bEO\bOF\bF is encountered while
+       reading a line, and the line is empty, N\bNU\bUL\bLL\bL  is  returned.
+       If  an E\bEO\bOF\bF is read with a non-empty line, it is treated as
+       a newline.
+
+N\bNO\bOT\bTA\bAT\bTI\bIO\bON\bN
+       An emacs-style notation  is  used  to  denote  keystrokes.
+       Control  keys  are  denoted by C-_\bk_\be_\by, e.g., C-n means Con-
+       trol-N.  Similarly, _\bm_\be_\bt_\ba keys are denoted by M-_\bk_\be_\by, so M-x
+       means Meta-X.  (On keyboards without a _\bm_\be_\bt_\ba key, M-_\bx means
+       ESC _\bx, i.e., press the Escape key then the  _\bx  key.   This
+       makes  ESC  the  _\bm_\be_\bt_\ba _\bp_\br_\be_\bf_\bi_\bx.  The combination M-C-_\bx means
+       ESC-Control-_\bx, or press the Escape key then hold the  Con-
+       trol key while pressing the _\bx key.)
+
+       Readline  commands  may  be given numeric _\ba_\br_\bg_\bu_\bm_\be_\bn_\bt_\bs, which
+       normally act as a repeat count.  Sometimes, however, it is
+       the  sign  of the argument that is significant.  Passing a
+       negative argument to a command that acts  in  the  forward
+       direction  (e.g., k\bki\bil\bll\bl-\b-l\bli\bin\bne\be) causes that command to act in
+       a backward direction.  Commands whose behavior with  argu-
+       ments deviates from this are noted.
+
+       When  a  command  is  described  as _\bk_\bi_\bl_\bl_\bi_\bn_\bg text, the text
+       deleted is saved for possible future retrieval  (_\by_\ba_\bn_\bk_\bi_\bn_\bg).
+
+
+
+GNU                        1998 Feb 19                          1
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+       The  killed  text  is  saved  in a _\bk_\bi_\bl_\bl _\br_\bi_\bn_\bg.  Consecutive
+       kills cause the text to  be  accumulated  into  one  unit,
+       which  can  be  yanked all at once.  Commands which do not
+       kill text separate the chunks of text on the kill ring.
+
+I\bIN\bNI\bIT\bTI\bIA\bAL\bLI\bIZ\bZA\bAT\bTI\bIO\bON\bN F\bFI\bIL\bLE\bE
+       Readline is customized by putting commands in an  initial-
+       ization file (the _\bi_\bn_\bp_\bu_\bt_\br_\bc file).  The name of this file is
+       taken from the value of the I\bIN\bNP\bPU\bUT\bTR\bRC\bC environment  variable.
+       If  that  variable  is  unset,  the default is _\b~_\b/_\b._\bi_\bn_\bp_\bu_\bt_\br_\bc.
+       When a program which uses the readline library starts  up,
+       the  init file is read, and the key bindings and variables
+       are set.  There are only a few basic constructs allowed in
+       the  readline  init file.  Blank lines are ignored.  Lines
+       beginning with a #\b# are comments.  Lines beginning with a $\b$
+       indicate  conditional  constructs.  Other lines denote key
+       bindings and variable settings.  Each program  using  this
+       library may add its own commands and bindings.
+
+       For example, placing
+
+              M-Control-u: universal-argument
+       or
+              C-Meta-u: universal-argument
+       into  the  _\bi_\bn_\bp_\bu_\bt_\br_\bc  would  make M-C-u execute the readline
+       command _\bu_\bn_\bi_\bv_\be_\br_\bs_\ba_\bl_\b-_\ba_\br_\bg_\bu_\bm_\be_\bn_\bt.
+
+       The following  symbolic  character  names  are  recognized
+       while processing key bindings: _\bR_\bU_\bB_\bO_\bU_\bT, _\bD_\bE_\bL, _\bE_\bS_\bC, _\bL_\bF_\bD, _\bN_\bE_\bW_\b-
+       _\bL_\bI_\bN_\bE, _\bR_\bE_\bT, _\bR_\bE_\bT_\bU_\bR_\bN, _\bS_\bP_\bC, _\bS_\bP_\bA_\bC_\bE, and _\bT_\bA_\bB.   In  addition  to
+       command  names,  readline  allows  keys  to  be bound to a
+       string that is inserted when the key is pressed (a _\bm_\ba_\bc_\br_\bo).
+
+
+   K\bKe\bey\by B\bBi\bin\bnd\bdi\bin\bng\bgs\bs
+       The  syntax  for  controlling  key bindings in the _\bi_\bn_\bp_\bu_\bt_\br_\bc
+       file is simple.  All that is required is the name  of  the
+       command or the text of a macro and a key sequence to which
+       it should be bound. The name may be specified  in  one  of
+       two  ways:  as a symbolic key name, possibly with _\bM_\be_\bt_\ba_\b- or
+       _\bC_\bo_\bn_\bt_\br_\bo_\bl_\b- prefixes, or as a key sequence.  When  using  the
+       form  k\bke\bey\byn\bna\bam\bme\be:_\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\b-_\bn_\ba_\bm_\be  or _\bm_\ba_\bc_\br_\bo, _\bk_\be_\by_\bn_\ba_\bm_\be is the name
+       of a key spelled out in English.  For example:
+
+              Control-u: universal-argument
+              Meta-Rubout: backward-kill-word
+              Control-o: ">&output"
+
+       In the above example, _\bC_\b-_\bu is bound to the function u\bun\bni\biv\bve\ber\br-\b-
+       s\bsa\bal\bl-\b-a\bar\brg\bgu\bum\bme\ben\bnt\bt,   _\bM_\b-_\bD_\bE_\bL  is  bound  to  the  function  b\bba\bac\bck\bk-\b-
+       w\bwa\bar\brd\bd-\b-k\bki\bil\bll\bl-\b-w\bwo\bor\brd\bd,  and  _\bC_\b-_\bo  is  bound  to  run  the   macro
+       expressed  on  the right hand side (that is, to insert the
+       text _\b>_\b&_\bo_\bu_\bt_\bp_\bu_\bt into the line).
+
+
+
+
+GNU                        1998 Feb 19                          2
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+       In the second form, "\b"k\bke\bey\bys\bse\beq\bq"\b":_\bf_\bu_\bn_\bc_\bt_\bi_\bo_\bn_\b-_\bn_\ba_\bm_\be or _\bm_\ba_\bc_\br_\bo,  k\bke\bey\by-\b-
+       s\bse\beq\bq differs from k\bke\bey\byn\bna\bam\bme\be above in that strings denoting an
+       entire key  sequence  may  be  specified  by  placing  the
+       sequence  within  double quotes.  Some GNU Emacs style key
+       escapes can be used, as in the following example.
+
+              "\C-u": universal-argument
+              "\C-x\C-r": re-read-init-file
+              "\e[11~": "Function Key 1"
+
+       In this example, _\bC_\b-_\bu is again bound to the  function  u\bun\bni\bi-\b-
+       v\bve\ber\brs\bsa\bal\bl-\b-a\bar\brg\bgu\bum\bme\ben\bnt\bt.    _\bC_\b-_\bx  _\bC_\b-_\br  is  bound  to  the  function
+       r\bre\be-\b-r\bre\bea\bad\bd-\b-i\bin\bni\bit\bt-\b-f\bfi\bil\ble\be, and _\bE_\bS_\bC _\b[ _\b1 _\b1 _\b~ is bound to insert  the
+       text  F\bFu\bun\bnc\bct\bti\bio\bon\bn  K\bKe\bey\by  1\b1.   The  full set of GNU Emacs style
+       escape sequences is
+              \\b\C\bC-\b-    control prefix
+              \\b\M\bM-\b-    meta prefix
+              \\b\e\be     an escape character
+              \\b\\\b\     backslash
+              \\b\"\b"     literal "
+              \\b\'\b'     literal '
+
+       In addition to the GNU Emacs  style  escape  sequences,  a
+       second set of backslash escapes is available:
+              \\b\a\ba     alert (bell)
+              \\b\b\bb     backspace
+              \\b\d\bd     delete
+              \\b\f\bf     form feed
+              \\b\n\bn     newline
+              \\b\r\br     carriage return
+              \\b\t\bt     horizontal tab
+              \\b\v\bv     vertical tab
+              \\b\_\bn_\bn_\bn   the  character whose ASCII code is the octal
+                     value _\bn_\bn_\bn (one to three digits)
+              \\b\x\bx_\bn_\bn_\bn  the character whose ASCII code is  the  hex-
+                     adecimal value _\bn_\bn_\bn (one to three digits)
+
+       When entering the text of a macro, single or double quotes
+       should be used to indicate a macro  definition.   Unquoted
+       text is assumed to be a function name.  In the macro body,
+       the backslash escapes described above are expanded.  Back-
+       slash  will  quote  any other character in the macro text,
+       including " and '.
+
+       B\bBa\bas\bsh\bh allows the current readline key bindings to  be  dis-
+       played  or  modified  with  the b\bbi\bin\bnd\bd builtin command.  The
+       editing mode may be switched  during  interactive  use  by
+       using  the  -\b-o\bo  option  to the s\bse\bet\bt builtin command.  Other
+       programs using this library  provide  similar  mechanisms.
+       The  _\bi_\bn_\bp_\bu_\bt_\br_\bc  file  may be edited and re-read if a program
+       does not provide any other means to incorporate new  bind-
+       ings.
+
+
+
+
+
+GNU                        1998 Feb 19                          3
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+   V\bVa\bar\bri\bia\bab\bbl\ble\bes\bs
+       Readline  has  variables  that can be used to further cus-
+       tomize its behavior.  A variable may be set in the _\bi_\bn_\bp_\bu_\bt_\br_\bc
+       file with a statement of the form
+
+              s\bse\bet\bt _\bv_\ba_\br_\bi_\ba_\bb_\bl_\be_\b-_\bn_\ba_\bm_\be _\bv_\ba_\bl_\bu_\be
+
+       Except where noted, readline variables can take the values
+       O\bOn\bn or O\bOf\bff\bf.  The variables and their default values are:
+
+       b\bbe\bel\bll\bl-\b-s\bst\bty\byl\ble\be (\b(a\bau\bud\bdi\bib\bbl\ble\be)\b)
+              Controls what happens when readline wants  to  ring
+              the  terminal bell.  If set to n\bno\bon\bne\be, readline never
+              rings the bell.  If set to v\bvi\bis\bsi\bib\bbl\ble\be, readline uses a
+              visible  bell if one is available.  If set to a\bau\bud\bdi\bi-\b-
+              b\bbl\ble\be, readline attempts to ring the terminal's bell.
+       c\bco\bom\bmm\bme\ben\bnt\bt-\b-b\bbe\beg\bgi\bin\bn (\b(`\b``\b`#\b#'\b''\b')\b)
+              The  string  that  is  inserted in v\bvi\bi mode when the
+              i\bin\bns\bse\ber\brt\bt-\b-c\bco\bom\bmm\bme\ben\bnt\bt command is executed.   This  command
+              is  bound  to M\bM-\b-#\b# in emacs mode and to #\b# in vi com-
+              mand mode.
+       c\bco\bom\bmp\bpl\ble\bet\bti\bio\bon\bn-\b-i\big\bgn\bno\bor\bre\be-\b-c\bca\bas\bse\be (\b(O\bOf\bff\bf)\b)
+              If set to O\bOn\bn, readline performs  filename  matching
+              and completion in a case-insensitive fashion.
+       c\bco\bom\bmp\bpl\ble\bet\bti\bio\bon\bn-\b-q\bqu\bue\ber\bry\by-\b-i\bit\bte\bem\bms\bs (\b(1\b10\b00\b0)\b)
+              This  determines  when  the  user  is queried about
+              viewing the number of possible  completions  gener-
+              ated  by  the p\bpo\bos\bss\bsi\bib\bbl\ble\be-\b-c\bco\bom\bmp\bpl\ble\bet\bti\bio\bon\bns\bs command.  It may
+              be set to any integer value greater than  or  equal
+              to  zero.  If the number of possible completions is
+              greater than or equal to the value  of  this  vari-
+              able, the user is asked whether or not he wishes to
+              view them; otherwise they are simply listed on  the
+              terminal.
+       c\bco\bon\bnv\bve\ber\brt\bt-\b-m\bme\bet\bta\ba (\b(O\bOn\bn)\b)
+              If set to O\bOn\bn, readline will convert characters with
+              the eighth bit set to  an  ASCII  key  sequence  by
+              stripping  the  eighth bit and prepending an escape
+              character (in effect, using escape as the _\bm_\be_\bt_\ba _\bp_\br_\be_\b-
+              _\bf_\bi_\bx).
+       d\bdi\bis\bsa\bab\bbl\ble\be-\b-c\bco\bom\bmp\bpl\ble\bet\bti\bio\bon\bn (\b(O\bOf\bff\bf)\b)
+              If  set  to  O\bOn\bn, readline will inhibit word comple-
+              tion.  Completion characters will be inserted  into
+              the line as if they had been mapped to s\bse\bel\blf\bf-\b-i\bin\bns\bse\ber\brt\bt.
+       e\bed\bdi\bit\bti\bin\bng\bg-\b-m\bmo\bod\bde\be (\b(e\bem\bma\bac\bcs\bs)\b)
+              Controls whether readline begins with a set of  key
+              bindings  similar to _\be_\bm_\ba_\bc_\bs or _\bv_\bi.  e\bed\bdi\bit\bti\bin\bng\bg-\b-m\bmo\bod\bde\be can
+              be set to either e\bem\bma\bac\bcs\bs or v\bvi\bi.
+       e\ben\bna\bab\bbl\ble\be-\b-k\bke\bey\byp\bpa\bad\bd (\b(O\bOf\bff\bf)\b)
+              When set to O\bOn\bn, readline will  try  to  enable  the
+              application keypad when it is called.  Some systems
+              need this to enable the arrow keys.
+       e\bex\bxp\bpa\ban\bnd\bd-\b-t\bti\bil\bld\bde\be (\b(O\bOf\bff\bf)\b)
+              If set to o\bon\bn, tilde  expansion  is  performed  when
+
+
+
+GNU                        1998 Feb 19                          4
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+              readline attempts word completion.
+       h\bho\bor\bri\biz\bzo\bon\bnt\bta\bal\bl-\b-s\bsc\bcr\bro\bol\bll\bl-\b-m\bmo\bod\bde\be (\b(O\bOf\bff\bf)\b)
+              When  set  to  O\bOn\bn, makes readline use a single line
+              for display, scrolling the input horizontally on  a
+              single  screen line when it becomes longer than the
+              screen width rather than wrapping to a new line.
+       k\bke\bey\bym\bma\bap\bp (\b(e\bem\bma\bac\bcs\bs)\b)
+              Set the current readline keymap.  The set of  legal
+              keymap  names is _\be_\bm_\ba_\bc_\bs_\b, _\be_\bm_\ba_\bc_\bs_\b-_\bs_\bt_\ba_\bn_\bd_\ba_\br_\bd_\b, _\be_\bm_\ba_\bc_\bs_\b-_\bm_\be_\bt_\ba_\b,
+              _\be_\bm_\ba_\bc_\bs_\b-_\bc_\bt_\bl_\bx_\b, _\bv_\bi_\b, _\bv_\bi_\b-_\bm_\bo_\bv_\be_\b, _\bv_\bi_\b-_\bc_\bo_\bm_\bm_\ba_\bn_\bd, and _\bv_\bi_\b-_\bi_\bn_\bs_\be_\br_\bt.
+              _\bv_\bi is equivalent to _\bv_\bi_\b-_\bc_\bo_\bm_\bm_\ba_\bn_\bd; _\be_\bm_\ba_\bc_\bs is equivalent
+              to _\be_\bm_\ba_\bc_\bs_\b-_\bs_\bt_\ba_\bn_\bd_\ba_\br_\bd.  The default value is _\be_\bm_\ba_\bc_\bs; the
+              value  of  e\bed\bdi\bit\bti\bin\bng\bg-\b-m\bmo\bod\bde\be  also  affects  the default
+              keymap.
+       m\bma\bar\brk\bk-\b-d\bdi\bir\bre\bec\bct\bto\bor\bri\bie\bes\bs (\b(O\bOn\bn)\b)
+              If set to O\bOn\bn, complete<d  directory  names  have  a
+              slash appended.
+       m\bma\bar\brk\bk-\b-m\bmo\bod\bdi\bif\bfi\bie\bed\bd-\b-l\bli\bin\bne\bes\bs (\b(O\bOf\bff\bf)\b)
+              If set to O\bOn\bn, history lines that have been modified
+              are displayed with a preceding asterisk (*\b*).
+       m\bme\bet\bta\ba-\b-f\bfl\bla\bag\bg (\b(O\bOf\bff\bf)\b)
+              If set to O\bOn\bn, readline will enable eight-bit  input
+              (that  is,  it will not strip the high bit from the
+              characters it reads), regardless of what the termi-
+              nal claims it can support.
+       o\bou\but\btp\bpu\but\bt-\b-m\bme\bet\bta\ba (\b(O\bOf\bff\bf)\b)
+              If set to O\bOn\bn, readline will display characters with
+              the eighth bit set directly rather than as a  meta-
+              prefixed escape sequence.
+       p\bpr\bri\bin\bnt\bt-\b-c\bco\bom\bmp\bpl\ble\bet\bti\bio\bon\bns\bs-\b-h\bho\bor\bri\biz\bzo\bon\bnt\bta\bal\bll\bly\by (\b(O\bOf\bff\bf)\b)
+              If  set  to  O\bOn\bn,  readline will display completions
+              with matches sorted  horizontally  in  alphabetical
+              order, rather than down the screen.
+       s\bsh\bho\bow\bw-\b-a\bal\bll\bl-\b-i\bif\bf-\b-a\bam\bmb\bbi\big\bgu\buo\bou\bus\bs (\b(O\bOf\bff\bf)\b)
+              This  alters the default behavior of the completion
+              functions.  If set to o\bon\bn,  words  which  have  more
+              than  one  possible completion cause the matches to
+              be listed immediately instead of ringing the  bell.
+       v\bvi\bis\bsi\bib\bbl\ble\be-\b-s\bst\bta\bat\bts\bs (\b(O\bOf\bff\bf)\b)
+              If set to O\bOn\bn, a character denoting a file's type as
+              reported by s\bst\bta\bat\bt(2) is  appended  to  the  filename
+              when listing possible completions.
+
+   C\bCo\bon\bnd\bdi\bit\bti\bio\bon\bna\bal\bl C\bCo\bon\bns\bst\btr\bru\buc\bct\bts\bs
+       Readline  implements  a  facility similar in spirit to the
+       conditional compilation features  of  the  C  preprocessor
+       which allows key bindings and variable settings to be per-
+       formed as the result of  tests.   There  are  four  parser
+       directives used.
+
+       $\b$i\bif\bf    The  $\b$i\bif\bf construct allows bindings to be made based
+              on the editing mode, the terminal  being  used,  or
+              the  application  using  readline.  The text of the
+              test extends to the end of the line; no  characters
+
+
+
+GNU                        1998 Feb 19                          5
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+              are required to isolate it.
+
+              m\bmo\bod\bde\be   The  m\bmo\bod\bde\be=\b= form of the $\b$i\bif\bf directive is used
+                     to test whether readline is in emacs  or  vi
+                     mode.   This may be used in conjunction with
+                     the s\bse\bet\bt k\bke\bey\bym\bma\bap\bp command, for instance, to set
+                     bindings  in  the  _\be_\bm_\ba_\bc_\bs_\b-_\bs_\bt_\ba_\bn_\bd_\ba_\br_\bd and _\be_\bm_\ba_\bc_\bs_\b-
+                     _\bc_\bt_\bl_\bx keymaps only if  readline  is  starting
+                     out in emacs mode.
+
+              t\bte\ber\brm\bm   The t\bte\ber\brm\bm=\b= form may be used to include termi-
+                     nal-specific key bindings, perhaps  to  bind
+                     the  key  sequences output by the terminal's
+                     function keys.  The word on the  right  side
+                     of  the =\b= is tested against the full name of
+                     the terminal and the portion of the terminal
+                     name before the first -\b-.  This allows _\bs_\bu_\bn to
+                     match both _\bs_\bu_\bn and _\bs_\bu_\bn_\b-_\bc_\bm_\bd, for instance.
+
+              a\bap\bpp\bpl\bli\bic\bca\bat\bti\bio\bon\bn
+                     The a\bap\bpp\bpl\bli\bic\bca\bat\bti\bio\bon\bn construct is used to include
+                     application-specific settings.  Each program
+                     using the readline library sets the _\ba_\bp_\bp_\bl_\bi_\bc_\ba_\b-
+                     _\bt_\bi_\bo_\bn  _\bn_\ba_\bm_\be,  and  an initialization file can
+                     test for a particular value.  This could  be
+                     used to bind key sequences to functions use-
+                     ful for a specific program.   For  instance,
+                     the  following  command  adds a key sequence
+                     that quotes the current or previous word  in
+                     Bash:
+
+                     $\b$i\bif\bf bash
+                     # Quote the current or previous word
+                     "\C-xq": "\eb\"\ef\""
+                     $\b$e\ben\bnd\bdi\bif\bf
+
+       $\b$e\ben\bnd\bdi\bif\bf This command, as seen in the previous example, ter-
+              minates an $\b$i\bif\bf command.
+
+       $\b$e\bel\bls\bse\be  Commands in this branch of the  $\b$i\bif\bf  directive  are
+              executed if the test fails.
+
+       $\b$i\bin\bnc\bcl\blu\bud\bde\be
+              This  directive takes a single filename as an argu-
+              ment and reads  commands  and  bindings  from  that
+              file.   For  example, the following directive would
+              read _\b/_\be_\bt_\bc_\b/_\bi_\bn_\bp_\bu_\bt_\br_\bc:
+
+              $\b$i\bin\bnc\bcl\blu\bud\bde\be  _\b/_\be_\bt_\bc_\b/_\bi_\bn_\bp_\bu_\bt_\br_\bc
+
+S\bSE\bEA\bAR\bRC\bCH\bHI\bIN\bNG\bG
+       Readline provides commands for searching through the  com-
+       mand  history  for  lines  containing  a specified string.
+       There  are  two  search  modes:   _\bi_\bn_\bc_\br_\be_\bm_\be_\bn_\bt_\ba_\bl   and   _\bn_\bo_\bn_\b-
+
+
+
+GNU                        1998 Feb 19                          6
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+       _\bi_\bn_\bc_\br_\be_\bm_\be_\bn_\bt_\ba_\bl.
+
+       Incremental  searches  begin  before the user has finished
+       typing the search string.  As each character of the search
+       string is typed, readline displays the next entry from the
+       history matching the string typed so far.  An  incremental
+       search  requires only as many characters as needed to find
+       the desired history entry.  The Escape character  is  used
+       to  terminate  an incremental search.  Control-J will also
+       terminate the search.  Control-G will abort an incremental
+       search  and restore the original line.  When the search is
+       terminated, the history entry containing the search string
+       becomes  the current line.  To find other matching entries
+       in the history list, type Control-S or Control-R as appro-
+       priate.   This will search backward or forward in the his-
+       tory for the next line matching the search string typed so
+       far.   Any  other key sequence bound to a readline command
+       will terminate the search and execute that  command.   For
+       instance,  a  _\bn_\be_\bw_\bl_\bi_\bn_\be will terminate the search and accept
+       the line, thereby executing the command from  the  history
+       list.
+
+       Non-incremental  searches  read  the  entire search string
+       before starting to search for matching history lines.  The
+       search  string  may be typed by the user or be part of the
+       contents of the current line.
+
+E\bED\bDI\bIT\bTI\bIN\bNG\bG C\bCO\bOM\bMM\bMA\bAN\bND\bDS\bS
+       The following is a list of the names of the  commands  and
+       the  default  key sequences to which they are bound.  Com-
+       mand  names  without  an  accompanying  key  sequence  are
+       unbound by default.
+
+   C\bCo\bom\bmm\bma\ban\bnd\bds\bs f\bfo\bor\br M\bMo\bov\bvi\bin\bng\bg
+       b\bbe\beg\bgi\bin\bnn\bni\bin\bng\bg-\b-o\bof\bf-\b-l\bli\bin\bne\be (\b(C\bC-\b-a\ba)\b)
+              Move to the start of the current line.
+       e\ben\bnd\bd-\b-o\bof\bf-\b-l\bli\bin\bne\be (\b(C\bC-\b-e\be)\b)
+              Move to the end of the line.
+       f\bfo\bor\brw\bwa\bar\brd\bd-\b-c\bch\bha\bar\br (\b(C\bC-\b-f\bf)\b)
+              Move forward a character.
+       b\bba\bac\bck\bkw\bwa\bar\brd\bd-\b-c\bch\bha\bar\br (\b(C\bC-\b-b\bb)\b)
+              Move back a character.
+       f\bfo\bor\brw\bwa\bar\brd\bd-\b-w\bwo\bor\brd\bd (\b(M\bM-\b-f\bf)\b)
+              Move  forward  to  the end of the next word.  Words
+              are composed of  alphanumeric  characters  (letters
+              and digits).
+       b\bba\bac\bck\bkw\bwa\bar\brd\bd-\b-w\bwo\bor\brd\bd (\b(M\bM-\b-b\bb)\b)
+              Move  back  to  the start of this, or the previous,
+              word.  Words are composed of  alphanumeric  charac-
+              ters (letters and digits).
+       c\bcl\ble\bea\bar\br-\b-s\bsc\bcr\bre\bee\ben\bn (\b(C\bC-\b-l\bl)\b)
+              Clear  the  screen  leaving the current line at the
+              top of the screen.  With an argument,  refresh  the
+              current line without clearing the screen.
+
+
+
+GNU                        1998 Feb 19                          7
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+       r\bre\bed\bdr\bra\baw\bw-\b-c\bcu\bur\brr\bre\ben\bnt\bt-\b-l\bli\bin\bne\be
+              Refresh the current line.
+
+   C\bCo\bom\bmm\bma\ban\bnd\bds\bs f\bfo\bor\br M\bMa\ban\bni\bip\bpu\bul\bla\bat\bti\bin\bng\bg t\bth\bhe\be H\bHi\bis\bst\bto\bor\bry\by
+       a\bac\bcc\bce\bep\bpt\bt-\b-l\bli\bin\bne\be (\b(N\bNe\bew\bwl\bli\bin\bne\be,\b, R\bRe\bet\btu\bur\brn\bn)\b)
+              Accept  the line regardless of where the cursor is.
+              If this line is non-empty, add it  to  the  history
+              list.  If the line is a modified history line, then
+              restore the history line to its original state.
+       p\bpr\bre\bev\bvi\bio\bou\bus\bs-\b-h\bhi\bis\bst\bto\bor\bry\by (\b(C\bC-\b-p\bp)\b)
+              Fetch the previous command from the  history  list,
+              moving back in the list.
+       n\bne\bex\bxt\bt-\b-h\bhi\bis\bst\bto\bor\bry\by (\b(C\bC-\b-n\bn)\b)
+              Fetch  the next command from the history list, mov-
+              ing forward in the list.
+       b\bbe\beg\bgi\bin\bnn\bni\bin\bng\bg-\b-o\bof\bf-\b-h\bhi\bis\bst\bto\bor\bry\by (\b(M\bM-\b-<\b<)\b)
+              Move to the first line in the history.
+       e\ben\bnd\bd-\b-o\bof\bf-\b-h\bhi\bis\bst\bto\bor\bry\by (\b(M\bM-\b->\b>)\b)
+              Move to the end of the  input  history,  i.e.,  the
+              line currently being entered.
+       r\bre\bev\bve\ber\brs\bse\be-\b-s\bse\bea\bar\brc\bch\bh-\b-h\bhi\bis\bst\bto\bor\bry\by (\b(C\bC-\b-r\br)\b)
+              Search  backward  starting  at the current line and
+              moving `up' through the history as necessary.  This
+              is an incremental search.
+       f\bfo\bor\brw\bwa\bar\brd\bd-\b-s\bse\bea\bar\brc\bch\bh-\b-h\bhi\bis\bst\bto\bor\bry\by (\b(C\bC-\b-s\bs)\b)
+              Search  forward  starting  at  the current line and
+              moving `down' through  the  history  as  necessary.
+              This is an incremental search.
+       n\bno\bon\bn-\b-i\bin\bnc\bcr\bre\bem\bme\ben\bnt\bta\bal\bl-\b-r\bre\bev\bve\ber\brs\bse\be-\b-s\bse\bea\bar\brc\bch\bh-\b-h\bhi\bis\bst\bto\bor\bry\by (\b(M\bM-\b-p\bp)\b)
+              Search backward through the history starting at the
+              current line using a non-incremental search  for  a
+              string supplied by the user.
+       n\bno\bon\bn-\b-i\bin\bnc\bcr\bre\bem\bme\ben\bnt\bta\bal\bl-\b-f\bfo\bor\brw\bwa\bar\brd\bd-\b-s\bse\bea\bar\brc\bch\bh-\b-h\bhi\bis\bst\bto\bor\bry\by (\b(M\bM-\b-n\bn)\b)
+              Search  forward  through  the  history using a non-
+              incremental search for a  string  supplied  by  the
+              user.
+       h\bhi\bis\bst\bto\bor\bry\by-\b-s\bse\bea\bar\brc\bch\bh-\b-f\bfo\bor\brw\bwa\bar\brd\bd
+              Search  forward  through the history for the string
+              of characters between the start of the current line
+              and  the current cursor position (the _\bp_\bo_\bi_\bn_\bt).  This
+              is a non-incremental search.
+       h\bhi\bis\bst\bto\bor\bry\by-\b-s\bse\bea\bar\brc\bch\bh-\b-b\bba\bac\bck\bkw\bwa\bar\brd\bd
+              Search backward through the history for the  string
+              of characters between the start of the current line
+              and the point.  This is a non-incremental search.
+       y\bya\ban\bnk\bk-\b-n\bnt\bth\bh-\b-a\bar\brg\bg (\b(M\bM-\b-C\bC-\b-y\by)\b)
+              Insert the first argument to the  previous  command
+              (usually  the  second word on the previous line) at
+              point (the current cursor position).  With an argu-
+              ment  _\bn, insert the _\bnth word from the previous com-
+              mand (the words in the previous command begin  with
+              word  0).  A negative argument inserts the _\bnth word
+              from the end of the previous command.
+
+
+
+
+GNU                        1998 Feb 19                          8
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+       y\bya\ban\bnk\bk-\b-l\bla\bas\bst\bt-\b-a\bar\brg\bg (\b(M\bM-\b-.\b.,\b, M\bM-\b-_\b_)\b)
+              Insert the last argument to  the  previous  command
+              (the  last  word  of  the  previous history entry).
+              With an argument, behave exactly like y\bya\ban\bnk\bk-\b-n\bnt\bth\bh-\b-a\bar\brg\bg.
+              Successive calls to y\bya\ban\bnk\bk-\b-l\bla\bas\bst\bt-\b-a\bar\brg\bg move back through
+              the history list, inserting the  last  argument  of
+              each line in turn.
+
+   C\bCo\bom\bmm\bma\ban\bnd\bds\bs f\bfo\bor\br C\bCh\bha\ban\bng\bgi\bin\bng\bg T\bTe\bex\bxt\bt
+       d\bde\bel\ble\bet\bte\be-\b-c\bch\bha\bar\br (\b(C\bC-\b-d\bd)\b)
+              Delete the character under the cursor.  If point is
+              at the beginning of the line, there are no  charac-
+              ters  in the line, and the last character typed was
+              not bound to B\bBd\bde\bel\ble\bet\bte\be-\b-c\bch\bha\bar\br, then return E\bEO\bOF\bF.
+       b\bba\bac\bck\bkw\bwa\bar\brd\bd-\b-d\bde\bel\ble\bet\bte\be-\b-c\bch\bha\bar\br (\b(R\bRu\bub\bbo\bou\but\bt)\b)
+              Delete the character behind the cursor.  When given
+              a  numeric  argument,  save the deleted text on the
+              kill ring.
+       q\bqu\buo\bot\bte\bed\bd-\b-i\bin\bns\bse\ber\brt\bt (\b(C\bC-\b-q\bq,\b, C\bC-\b-v\bv)\b)
+              Add the next character that you type  to  the  line
+              verbatim.   This  is  how to insert characters like
+              C\bC-\b-q\bq, for example.
+       t\bta\bab\bb-\b-i\bin\bns\bse\ber\brt\bt (\b(M\bM-\b-T\bTA\bAB\bB)\b)
+              Insert a tab character.
+       s\bse\bel\blf\bf-\b-i\bin\bns\bse\ber\brt\bt (\b(a\ba,\b, b\bb,\b, A\bA,\b, 1\b1,\b, !\b!,\b, .\b..\b..\b.)\b)
+              Insert the character typed.
+       t\btr\bra\ban\bns\bsp\bpo\bos\bse\be-\b-c\bch\bha\bar\brs\bs (\b(C\bC-\b-t\bt)\b)
+              Drag the character before point  forward  over  the
+              character  at  point.  Point moves forward as well.
+              If point is at the end of the line, then  transpose
+              the  two  characters  before point.  Negative argu-
+              ments don't work.
+       t\btr\bra\ban\bns\bsp\bpo\bos\bse\be-\b-w\bwo\bor\brd\bds\bs (\b(M\bM-\b-t\bt)\b)
+              Drag the word behind the cursor past  the  word  in
+              front  of  the  cursor  moving the cursor over that
+              word as well.
+       u\bup\bpc\bca\bas\bse\be-\b-w\bwo\bor\brd\bd (\b(M\bM-\b-u\bu)\b)
+              Uppercase the current (or following) word.  With  a
+              negative argument, uppercase the previous word, but
+              do not move point.
+       d\bdo\bow\bwn\bnc\bca\bas\bse\be-\b-w\bwo\bor\brd\bd (\b(M\bM-\b-l\bl)\b)
+              Lowercase the current (or following) word.  With  a
+              negative argument, lowercase the previous word, but
+              do not move point.
+       c\bca\bap\bpi\bit\bta\bal\bli\biz\bze\be-\b-w\bwo\bor\brd\bd (\b(M\bM-\b-c\bc)\b)
+              Capitalize the current (or following) word.  With a
+              negative  argument,  capitalize  the previous word,
+              but do not move point.
+
+   K\bKi\bil\bll\bli\bin\bng\bg a\ban\bnd\bd Y\bYa\ban\bnk\bki\bin\bng\bg
+       k\bki\bil\bll\bl-\b-l\bli\bin\bne\be (\b(C\bC-\b-k\bk)\b)
+              Kill the text from the current cursor  position  to
+              the end of the line.
+
+
+
+
+GNU                        1998 Feb 19                          9
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+       b\bba\bac\bck\bkw\bwa\bar\brd\bd-\b-k\bki\bil\bll\bl-\b-l\bli\bin\bne\be (\b(C\bC-\b-x\bx R\bRu\bub\bbo\bou\but\bt)\b)
+              Kill backward to the beginning of the line.
+       u\bun\bni\bix\bx-\b-l\bli\bin\bne\be-\b-d\bdi\bis\bsc\bca\bar\brd\bd (\b(C\bC-\b-u\bu)\b)
+              Kill  backward  from  point to the beginning of the
+              line.  The killed text is saved on the kill-ring.
+       k\bki\bil\bll\bl-\b-w\bwh\bho\bol\ble\be-\b-l\bli\bin\bne\be
+              Kill all characters on the current line, no  matter
+              where the cursor is.
+       k\bki\bil\bll\bl-\b-w\bwo\bor\brd\bd (\b(M\bM-\b-d\bd)\b)
+              Kill  from  the  cursor  to  the end of the current
+              word, or if between words, to the end of  the  next
+              word.   Word  boundaries are the same as those used
+              by f\bfo\bor\brw\bwa\bar\brd\bd-\b-w\bwo\bor\brd\bd.
+       b\bba\bac\bck\bkw\bwa\bar\brd\bd-\b-k\bki\bil\bll\bl-\b-w\bwo\bor\brd\bd (\b(M\bM-\b-R\bRu\bub\bbo\bou\but\bt)\b)
+              Kill the word behind the cursor.   Word  boundaries
+              are the same as those used by b\bba\bac\bck\bkw\bwa\bar\brd\bd-\b-w\bwo\bor\brd\bd.
+       u\bun\bni\bix\bx-\b-w\bwo\bor\brd\bd-\b-r\bru\bub\bbo\bou\but\bt (\b(C\bC-\b-w\bw)\b)
+              Kill  the word behind the cursor, using white space
+              as a word boundary.  The word boundaries  are  dif-
+              ferent from b\bba\bac\bck\bkw\bwa\bar\brd\bd-\b-k\bki\bil\bll\bl-\b-w\bwo\bor\brd\bd.
+       d\bde\bel\ble\bet\bte\be-\b-h\bho\bor\bri\biz\bzo\bon\bnt\bta\bal\bl-\b-s\bsp\bpa\bac\bce\be (\b(M\bM-\b-\\b\)\b)
+              Delete all spaces and tabs around point.
+       k\bki\bil\bll\bl-\b-r\bre\beg\bgi\bio\bon\bn
+              Kill  the  text  between  the point and _\bm_\ba_\br_\bk (saved
+              cursor position).  This text is referred to as  the
+              _\br_\be_\bg_\bi_\bo_\bn.
+       c\bco\bop\bpy\by-\b-r\bre\beg\bgi\bio\bon\bn-\b-a\bas\bs-\b-k\bki\bil\bll\bl
+              Copy the text in the region to the kill buffer.
+       c\bco\bop\bpy\by-\b-b\bba\bac\bck\bkw\bwa\bar\brd\bd-\b-w\bwo\bor\brd\bd
+              Copy the word before point to the kill buffer.  The
+              word boundaries are the same as b\bba\bac\bck\bkw\bwa\bar\brd\bd-\b-w\bwo\bor\brd\bd.
+       c\bco\bop\bpy\by-\b-f\bfo\bor\brw\bwa\bar\brd\bd-\b-w\bwo\bor\brd\bd
+              Copy the word following point to the  kill  buffer.
+              The word boundaries are the same as f\bfo\bor\brw\bwa\bar\brd\bd-\b-w\bwo\bor\brd\bd.
+       y\bya\ban\bnk\bk (\b(C\bC-\b-y\by)\b)
+              Yank  the  top  of the kill ring into the buffer at
+              the cursor.
+       y\bya\ban\bnk\bk-\b-p\bpo\bop\bp (\b(M\bM-\b-y\by)\b)
+              Rotate the kill ring, and yank the new  top.   Only
+              works following y\bya\ban\bnk\bk or y\bya\ban\bnk\bk-\b-p\bpo\bop\bp.
+
+   N\bNu\bum\bme\ber\bri\bic\bc A\bAr\brg\bgu\bum\bme\ben\bnt\bts\bs
+       d\bdi\big\bgi\bit\bt-\b-a\bar\brg\bgu\bum\bme\ben\bnt\bt (\b(M\bM-\b-0\b0,\b, M\bM-\b-1\b1,\b, .\b..\b..\b.,\b, M\bM-\b--\b-)\b)
+              Add  this  digit to the argument already accumulat-
+              ing, or start a new argument.  M-- starts  a  nega-
+              tive argument.
+       u\bun\bni\biv\bve\ber\brs\bsa\bal\bl-\b-a\bar\brg\bgu\bum\bme\ben\bnt\bt
+              This  is  another  way  to specify an argument.  If
+              this command is followed by  one  or  more  digits,
+              optionally  with a leading minus sign, those digits
+              define the argument.  If the command is followed by
+              digits, executing u\bun\bni\biv\bve\ber\brs\bsa\bal\bl-\b-a\bar\brg\bgu\bum\bme\ben\bnt\bt again ends the
+              numeric argument, but is otherwise ignored.   As  a
+              special   case,  if  this  command  is  immediately
+
+
+
+GNU                        1998 Feb 19                         10
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+              followed by a character that is neither a digit  or
+              minus sign, the argument count for the next command
+              is multiplied by four.  The argument count is  ini-
+              tially  one,  so  executing this function the first
+              time makes the argument count four, a  second  time
+              makes the argument count sixteen, and so on.
+
+   C\bCo\bom\bmp\bpl\ble\bet\bti\bin\bng\bg
+       c\bco\bom\bmp\bpl\ble\bet\bte\be (\b(T\bTA\bAB\bB)\b)
+              Attempt  to  perform  completion on the text before
+              point.  The actual completion performed is applica-
+              tion-specific.   B\bBa\bas\bsh\bh,  for instance, attempts com-
+              pletion treating the text as  a  variable  (if  the
+              text  begins  with $\b$), username (if the text begins
+              with ~\b~), hostname (if the text begins with  @\b@),  or
+              command  (including aliases and functions) in turn.
+              If none of these produces a match, filename comple-
+              tion  is attempted.  G\bGd\bdb\bb, on the other hand, allows
+              completion of program functions and variables,  and
+              only  attempts  filename  completion  under certain
+              circumstances.
+       p\bpo\bos\bss\bsi\bib\bbl\ble\be-\b-c\bco\bom\bmp\bpl\ble\bet\bti\bio\bon\bns\bs (\b(M\bM-\b-?\b?)\b)
+              List the possible completions of  the  text  before
+              point.
+       i\bin\bns\bse\ber\brt\bt-\b-c\bco\bom\bmp\bpl\ble\bet\bti\bio\bon\bns\bs (\b(M\bM-\b-*\b*)\b)
+              Insert  all  completions  of  the text before point
+              that would have been generated by  p\bpo\bos\bss\bsi\bib\bbl\ble\be-\b-c\bco\bom\bmp\bpl\ble\be-\b-
+              t\bti\bio\bon\bns\bs.
+       m\bme\ben\bnu\bu-\b-c\bco\bom\bmp\bpl\ble\bet\bte\be
+              Similar  to  c\bco\bom\bmp\bpl\ble\bet\bte\be,  but replaces the word to be
+              completed with a single match from the list of pos-
+              sible completions.  Repeated execution of m\bme\ben\bnu\bu-\b-c\bco\bom\bm-\b-
+              p\bpl\ble\bet\bte\be steps through the list  of  possible  comple-
+              tions, inserting each match in turn.  At the end of
+              the list of completions, the bell is rung  and  the
+              original  text is restored.  An argument of _\bn moves
+              _\bn positions forward in the list of matches; a nega-
+              tive  argument may be used to move backward through
+              the list.  This command is intended to be bound  to
+              T\bTA\bAB\bB, but is unbound by default.
+
+   K\bKe\bey\byb\bbo\boa\bar\brd\bd M\bMa\bac\bcr\bro\bos\bs
+       s\bst\bta\bar\brt\bt-\b-k\bkb\bbd\bd-\b-m\bma\bac\bcr\bro\bo (\b(C\bC-\b-x\bx (\b()\b)
+              Begin  saving the characters typed into the current
+              keyboard macro.
+       e\ben\bnd\bd-\b-k\bkb\bbd\bd-\b-m\bma\bac\bcr\bro\bo (\b(C\bC-\b-x\bx )\b))\b)
+              Stop saving the characters typed into  the  current
+              keyboard macro and store the definition.
+       c\bca\bal\bll\bl-\b-l\bla\bas\bst\bt-\b-k\bkb\bbd\bd-\b-m\bma\bac\bcr\bro\bo (\b(C\bC-\b-x\bx e\be)\b)
+              Re-execute the last keyboard macro defined, by mak-
+              ing the characters in the macro appear as if  typed
+              at the keyboard.
+
+
+
+
+
+GNU                        1998 Feb 19                         11
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+   M\bMi\bis\bsc\bce\bel\bll\bla\ban\bne\beo\bou\bus\bs
+       r\bre\be-\b-r\bre\bea\bad\bd-\b-i\bin\bni\bit\bt-\b-f\bfi\bil\ble\be (\b(C\bC-\b-x\bx C\bC-\b-r\br)\b)
+              Read  in  the  contents  of  the  _\bi_\bn_\bp_\bu_\bt_\br_\bc file, and
+              incorporate any bindings  or  variable  assignments
+              found there.
+       a\bab\bbo\bor\brt\bt (\b(C\bC-\b-g\bg)\b)
+              Abort the current editing command and ring the ter-
+              minal's   bell   (subject   to   the   setting   of
+              b\bbe\bel\bll\bl-\b-s\bst\bty\byl\ble\be).
+       d\bdo\bo-\b-u\bup\bpp\bpe\ber\brc\bca\bas\bse\be-\b-v\bve\ber\brs\bsi\bio\bon\bn (\b(M\bM-\b-a\ba,\b, M\bM-\b-b\bb,\b, M\bM-\b-_\bx,\b, .\b..\b..\b.)\b)
+              If  the  metafied character _\bx is lowercase, run the
+              command that is bound to the  corresponding  upper-
+              case character.
+       p\bpr\bre\bef\bfi\bix\bx-\b-m\bme\bet\bta\ba (\b(E\bES\bSC\bC)\b)
+              Metafy  the next character typed.  E\bES\bSC\bC f\bf is equiva-
+              lent to M\bMe\bet\bta\ba-\b-f\bf.
+       u\bun\bnd\bdo\bo (\b(C\bC-\b-_\b_,\b, C\bC-\b-x\bx C\bC-\b-u\bu)\b)
+              Incremental undo, separately  remembered  for  each
+              line.
+       r\bre\bev\bve\ber\brt\bt-\b-l\bli\bin\bne\be (\b(M\bM-\b-r\br)\b)
+              Undo  all  changes made to this line.  This is like
+              executing the u\bun\bnd\bdo\bo command enough times  to  return
+              the line to its initial state.
+       t\bti\bil\bld\bde\be-\b-e\bex\bxp\bpa\ban\bnd\bd (\b(M\bM-\b-~\b~)\b)
+              Perform tilde expansion on the current word.
+       s\bse\bet\bt-\b-m\bma\bar\brk\bk (\b(C\bC-\b-@\b@,\b, M\bM-\b-<\b<s\bsp\bpa\bac\bce\be>\b>)\b)
+              Set  the  mark  to the current point.  If a numeric
+              argument is supplied, the mark is set to that posi-
+              tion.
+       e\bex\bxc\bch\bha\ban\bng\bge\be-\b-p\bpo\boi\bin\bnt\bt-\b-a\ban\bnd\bd-\b-m\bma\bar\brk\bk (\b(C\bC-\b-x\bx C\bC-\b-x\bx)\b)
+              Swap  the  point with the mark.  The current cursor
+              position is set to the saved position, and the  old
+              cursor position is saved as the mark.
+       c\bch\bha\bar\bra\bac\bct\bte\ber\br-\b-s\bse\bea\bar\brc\bch\bh (\b(C\bC-\b-]\b])\b)
+              A  character is read and point is moved to the next
+              occurrence of that  character.   A  negative  count
+              searches for previous occurrences.
+       c\bch\bha\bar\bra\bac\bct\bte\ber\br-\b-s\bse\bea\bar\brc\bch\bh-\b-b\bba\bac\bck\bkw\bwa\bar\brd\bd (\b(M\bM-\b-C\bC-\b-]\b])\b)
+              A  character is read and point is moved to the pre-
+              vious occurrence of  that  character.   A  negative
+              count searches for subsequent occurrences.
+       i\bin\bns\bse\ber\brt\bt-\b-c\bco\bom\bmm\bme\ben\bnt\bt (\b(M\bM-\b-#\b#)\b)
+              The value of the readline c\bco\bom\bmm\bme\ben\bnt\bt-\b-b\bbe\beg\bgi\bin\bn variable is
+              inserted at the beginning of the current line,  and
+              the  line  is  accepted  as  if  a newline had been
+              typed.  This makes the current line  a  shell  com-
+              ment.
+       d\bdu\bum\bmp\bp-\b-f\bfu\bun\bnc\bct\bti\bio\bon\bns\bs
+              Print  all  of the functions and their key bindings
+              to the readline output stream.  If a numeric  argu-
+              ment is supplied, the output is formatted in such a
+              way that it can be made part of an _\bi_\bn_\bp_\bu_\bt_\br_\bc file.
+       d\bdu\bum\bmp\bp-\b-v\bva\bar\bri\bia\bab\bbl\ble\bes\bs
+              Print all  of  the  settable  variables  and  their
+
+
+
+GNU                        1998 Feb 19                         12
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+              values to the readline output stream.  If a numeric
+              argument is supplied, the output  is  formatted  in
+              such  a  way that it can be made part of an _\bi_\bn_\bp_\bu_\bt_\br_\bc
+              file.
+       d\bdu\bum\bmp\bp-\b-m\bma\bac\bcr\bro\bos\bs
+              Print all of the readline key  sequences  bound  to
+              macros  and  the  strings they ouput.  If a numeric
+              argument is supplied, the output  is  formatted  in
+              such  a  way that it can be made part of an _\bi_\bn_\bp_\bu_\bt_\br_\bc
+              file.
+       e\bem\bma\bac\bcs\bs-\b-e\bed\bdi\bit\bti\bin\bng\bg-\b-m\bmo\bod\bde\be (\b(C\bC-\b-e\be)\b)
+              When in v\bvi\bi editing mode, this causes  a  switch  to
+              e\bem\bma\bac\bcs\bs editing mode.
+       v\bvi\bi-\b-e\bed\bdi\bit\bti\bin\bng\bg-\b-m\bmo\bod\bde\be (\b(M\bM-\b-C\bC-\b-j\bj)\b)
+              When in e\bem\bma\bac\bcs\bs editing mode, this causes a switch to
+              v\bvi\bi editing mode.
+
+D\bDE\bEF\bFA\bAU\bUL\bLT\bT K\bKE\bEY\bY B\bBI\bIN\bND\bDI\bIN\bNG\bGS\bS
+       The following is a list of the default emacs and vi  bind-
+       ings.   Characters  with  the  8th  bit set are written as
+       M-<character>, and are referred to as _\bm_\be_\bt_\ba_\bf_\bi_\be_\bd characters.
+       The  printable  ASCII characters not mentioned in the list
+       of emacs standard bindings are bound  to  the  _\bs_\be_\bl_\bf_\b-_\bi_\bn_\bs_\be_\br_\bt
+       function,  which just inserts the given character into the
+       input line.  In vi  insertion  mode,  all  characters  not
+       specifically  mentioned are bound to _\bs_\be_\bl_\bf_\b-_\bi_\bn_\bs_\be_\br_\bt.  Charac-
+       ters assigned to signal generation by _\bs_\bt_\bt_\by(1) or the  ter-
+       minal  driver,  such  as C-Z or C-C, retain that function.
+       Upper and lower case _\bm_\be_\bt_\ba_\bf_\bi_\be_\bd characters are bound to  the
+       same  function in the emacs mode meta keymap.  The remain-
+       ing characters are unbound, which causes readline to  ring
+       the  bell  (subject to the setting of the b\bbe\bel\bll\bl-\b-s\bst\bty\byl\ble\be vari-
+       able).
+
+   E\bEm\bma\bac\bcs\bs M\bMo\bod\bde\be
+             Emacs Standard bindings
+
+             "C-@"  set-mark
+             "C-A"  beginning-of-line
+             "C-B"  backward-char
+             "C-D"  delete-char
+             "C-E"  end-of-line
+             "C-F"  forward-char
+             "C-G"  abort
+             "C-H"  backward-delete-char
+             "C-I"  complete
+             "C-J"  accept-line
+             "C-K"  kill-line
+             "C-L"  clear-screen
+             "C-M"  accept-line
+             "C-N"  next-history
+             "C-P"  previous-history
+             "C-Q"  quoted-insert
+             "C-R"  reverse-search-history
+
+
+
+GNU                        1998 Feb 19                         13
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+             "C-S"  forward-search-history
+             "C-T"  transpose-chars
+             "C-U"  unix-line-discard
+             "C-V"  quoted-insert
+             "C-W"  unix-word-rubout
+             "C-Y"  yank
+             "C-]"  character-search
+             "C-_"  undo
+             " " to "/"  self-insert
+             "0"  to "9"  self-insert
+             ":"  to "~"  self-insert
+             "C-?"  backward-delete-char
+
+             Emacs Meta bindings
+
+             "M-C-G"  abort
+             "M-C-H"  backward-kill-word
+             "M-C-I"  tab-insert
+             "M-C-J"  vi-editing-mode
+             "M-C-M"  vi-editing-mode
+             "M-C-R"  revert-line
+             "M-C-Y"  yank-nth-arg
+             "M-C-["  complete
+             "M-C-]"  character-search-backward
+             "M-space"  set-mark
+             "M-#"  insert-comment
+             "M-&"  tilde-expand
+             "M-*"  insert-completions
+             "M--"  digit-argument
+             "M-."  yank-last-arg
+             "M-0"  digit-argument
+             "M-1"  digit-argument
+             "M-2"  digit-argument
+             "M-3"  digit-argument
+             "M-4"  digit-argument
+             "M-5"  digit-argument
+             "M-6"  digit-argument
+             "M-7"  digit-argument
+             "M-8"  digit-argument
+             "M-9"  digit-argument
+             "M-<"  beginning-of-history
+             "M-="  possible-completions
+             "M->"  end-of-history
+             "M-?"  possible-completions
+             "M-B"  backward-word
+             "M-C"  capitalize-word
+             "M-D"  kill-word
+             "M-F"  forward-word
+             "M-L"  downcase-word
+             "M-N"  non-incremental-forward-search-history
+             "M-P"  non-incremental-reverse-search-history
+             "M-R"  revert-line
+             "M-T"  transpose-words
+             "M-U"  upcase-word
+
+
+
+GNU                        1998 Feb 19                         14
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+             "M-Y"  yank-pop
+             "M-\"  delete-horizontal-space
+             "M-~"  tilde-expand
+             "M-C-?"  backward-delete-word
+             "M-_"  yank-last-arg
+
+             Emacs Control-X bindings
+
+             "C-XC-G"  abort
+             "C-XC-R"  re-read-init-file
+             "C-XC-U"  undo
+             "C-XC-X"  exchange-point-and-mark
+             "C-X("  start-kbd-macro
+             "C-X)"  end-kbd-macro
+             "C-XE"  call-last-kbd-macro
+             "C-XC-?"  backward-kill-line
+
+
+   V\bVI\bI M\bMo\bod\bde\be b\bbi\bin\bnd\bdi\bin\bng\bgs\bs
+             VI Insert Mode functions
+
+             "C-D"  vi-eof-maybe
+             "C-H"  backward-delete-char
+             "C-I"  complete
+             "C-J"  accept-line
+             "C-M"  accept-line
+             "C-R"  reverse-search-history
+             "C-S"  forward-search-history
+             "C-T"  transpose-chars
+             "C-U"  unix-line-discard
+             "C-V"  quoted-insert
+             "C-W"  unix-word-rubout
+             "C-Y"  yank
+             "C-["  vi-movement-mode
+             "C-_"  undo
+             " " to "~"  self-insert
+             "C-?"  backward-delete-char
+
+             VI Command Mode functions
+
+             "C-D"  vi-eof-maybe
+             "C-E"  emacs-editing-mode
+             "C-G"  abort
+             "C-H"  backward-char
+             "C-J"  accept-line
+             "C-K"  kill-line
+             "C-L"  clear-screen
+             "C-M"  accept-line
+             "C-N"  next-history
+             "C-P"  previous-history
+             "C-Q"  quoted-insert
+             "C-R"  reverse-search-history
+             "C-S"  forward-search-history
+             "C-T"  transpose-chars
+
+
+
+GNU                        1998 Feb 19                         15
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+             "C-U"  unix-line-discard
+             "C-V"  quoted-insert
+             "C-W"  unix-word-rubout
+             "C-Y"  yank
+             " "  forward-char
+             "#"  insert-comment
+             "$"  end-of-line
+             "%"  vi-match
+             "&"  vi-tilde-expand
+             "*"  vi-complete
+             "+"  next-history
+             ","  vi-char-search
+             "-"  previous-history
+             "."  vi-redo
+             "/"  vi-search
+             "0"  beginning-of-line
+             "1" to "9"  vi-arg-digit
+             ";"  vi-char-search
+             "="  vi-complete
+             "?"  vi-search
+             "A"  vi-append-eol
+             "B"  vi-prev-word
+             "C"  vi-change-to
+             "D"  vi-delete-to
+             "E"  vi-end-word
+             "F"  vi-char-search
+             "G"  vi-fetch-history
+             "I"  vi-insert-beg
+             "N"  vi-search-again
+             "P"  vi-put
+             "R"  vi-replace
+             "S"  vi-subst
+             "T"  vi-char-search
+             "U"  revert-line
+             "W"  vi-next-word
+             "X"  backward-delete-char
+             "Y"  vi-yank-to
+             "\"  vi-complete
+             "^"  vi-first-print
+             "_"  vi-yank-arg
+             "`"  vi-goto-mark
+             "a"  vi-append-mode
+             "b"  vi-prev-word
+             "c"  vi-change-to
+             "d"  vi-delete-to
+             "e"  vi-end-word
+             "f"  vi-char-search
+             "h"  backward-char
+             "i"  vi-insertion-mode
+             "j"  next-history
+             "k"  prev-history
+             "l"  forward-char
+             "m"  vi-set-mark
+             "n"  vi-search-again
+
+
+
+GNU                        1998 Feb 19                         16
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
+             "p"  vi-put
+             "r"  vi-change-char
+             "s"  vi-subst
+             "t"  vi-char-search
+             "u"  undo
+             "w"  vi-next-word
+             "x"  vi-delete
+             "y"  vi-yank-to
+             "|"  vi-column
+             "~"  vi-change-case
+
+S\bSE\bEE\bE A\bAL\bLS\bSO\bO
+       _\bT_\bh_\be _\bG_\bn_\bu _\bR_\be_\ba_\bd_\bl_\bi_\bn_\be _\bL_\bi_\bb_\br_\ba_\br_\by, Brian Fox and Chet Ramey
+       _\bT_\bh_\be _\bG_\bn_\bu _\bH_\bi_\bs_\bt_\bo_\br_\by _\bL_\bi_\bb_\br_\ba_\br_\by, Brian Fox and Chet Ramey
+       _\bb_\ba_\bs_\bh(1)
+
+F\bFI\bIL\bLE\bES\bS
+       _\b~_\b/_\b._\bi_\bn_\bp_\bu_\bt_\br_\bc
+              Individual r\bre\bea\bad\bdl\bli\bin\bne\be initialization file
+
+A\bAU\bUT\bTH\bHO\bOR\bRS\bS
+       Brian Fox, Free Software Foundation (primary author)
+       bfox@ai.MIT.Edu
+
+       Chet Ramey, Case Western Reserve University
+       chet@ins.CWRU.Edu
+
+B\bBU\bUG\bG R\bRE\bEP\bPO\bOR\bRT\bTS\bS
+       If you find a bug in r\bre\bea\bad\bdl\bli\bin\bne\be,\b, you should report it.   But
+       first,  you  should make sure that it really is a bug, and
+       that it appears in the  latest  version  of  the  r\bre\bea\bad\bdl\bli\bin\bne\be
+       library that you have.
+
+       Once  you have determined that a bug actually exists, mail
+       a bug report to _\bb_\bu_\bg_\b-_\br_\be_\ba_\bd_\bl_\bi_\bn_\be@_\bg_\bn_\bu_\b._\bo_\br_\bg.  If you have a  fix,
+       you  are  welcome  to  mail that as well!  Suggestions and
+       `philosophical' bug reports may  be  mailed  to  _\bb_\bu_\bg_\b-_\br_\be_\ba_\bd_\b-
+       _\bl_\bi_\bn_\be@_\bg_\bn_\bu_\b._\bo_\br_\bg   or   posted   to   the   Usenet   newsgroup
+       g\bgn\bnu\bu.\b.b\bba\bas\bsh\bh.\b.b\bbu\bug\bg.
+
+       Comments and  bug  reports  concerning  this  manual  page
+       should be directed to _\bc_\bh_\be_\bt_\b@_\bi_\bn_\bs_\b._\bC_\bW_\bR_\bU_\b._\bE_\bd_\bu.
+
+B\bBU\bUG\bGS\bS
+       It's too big and too slow.
+
+
+
+
+
+
+
+
+
+
+
+
+GNU                        1998 Feb 19                         17
+
+