2000-04-18 H.J. Lu <hjl@gnu.org>
[deliverable/binutils-gdb.git] / readline / doc / readline.0
index c925d529cb5c2276d1bd3c6a0e9fa4dda99cde9e..970d8c6d0c765f7c12f31bf3623ca6bf35419ebb 100644 (file)
@@ -8,6 +8,7 @@ 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<s\bst\btd\bdi\bio\bo.\b.h\bh>\b>
        #\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>
 
@@ -57,11 +58,10 @@ N\bNO\bOT\bTA\bAT\bTI\bIO\bON\bN
        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
+GNU                        1998 Dec 31                          1
 
 
 
@@ -70,6 +70,7 @@ GNU                        1998 Feb 19                          1
 READLINE(3)                                           READLINE(3)
 
 
+       deleted is saved for possible future retrieval  (_\by_\ba_\bn_\bk_\bi_\bn_\bg).
        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
@@ -126,8 +127,7 @@ I\bIN\bNI\bIT\bTI\bIA\bAL\bLI\bIZ\bZA\bAT\bTI\bIO\bON\bN F\bFI\bIL\bLE\bE
 
 
 
-
-GNU                        1998 Feb 19                          2
+GNU                        1998 Dec 31                          2
 
 
 
@@ -193,7 +193,7 @@ READLINE(3)                                           READLINE(3)
 
 
 
-GNU                        1998 Feb 19                          3
+GNU                        1998 Dec 31                          3
 
 
 
@@ -259,7 +259,7 @@ READLINE(3)                                           READLINE(3)
 
 
 
-GNU                        1998 Feb 19                          4
+GNU                        1998 Dec 31                          4
 
 
 
@@ -274,6 +274,18 @@ READLINE(3)                                           READLINE(3)
               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.
+       i\bin\bnp\bpu\but\bt-\b-m\bme\bet\bta\ba (\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.  The name m\bme\bet\bta\ba-\b-f\bfl\bla\bag\bg is a
+              synonym for this variable.
+       i\bis\bse\bea\bar\brc\bch\bh-\b-t\bte\ber\brm\bmi\bin\bna\bat\bto\bor\brs\bs (\b(`\b``\b`C\bC-\b-[\b[C\bC-\b-J\bJ'\b''\b')\b)
+              The string of characters that should  terminate  an
+              incremental  search  without subsequently executing
+              the character as a command.  If this  variable  has
+              not  been given a value, the characters _\bE_\bS_\bC and _\bC_\b-_\bJ
+              will terminate an incremental search.
        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,
@@ -288,44 +300,32 @@ READLINE(3)                                           READLINE(3)
        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-
+              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
+              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.
+              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
+              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
+       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
 
 
 
-GNU                        1998 Feb 19                          5
+GNU                        1998 Dec 31                          5
 
 
 
@@ -334,21 +334,28 @@ GNU                        1998 Feb 19                          5
 READLINE(3)                                           READLINE(3)
 
 
+       performed  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
               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
+              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_\bkeymaps only if  readline  is  starting
+                     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_\b 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
+                     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.
@@ -357,12 +364,12 @@ READLINE(3)                                           READLINE(3)
                      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_\b _\bn_\ba_\bm_\be,  and  an initialization file can
-                     test for a particular value.  This could  be
+                     _\bt_\bi_\bo_\b_\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
+                     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
@@ -373,25 +380,18 @@ READLINE(3)                                           READLINE(3)
        $\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
+       $\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
+              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
+GNU                        1998 Dec 31                          6
 
 
 
@@ -400,36 +400,44 @@ GNU                        1998 Feb 19                          6
 READLINE(3)                                           READLINE(3)
 
 
-       _\bi_\bn_\bc_\br_\be_\bm_\be_\bn_\bt_\ba_\bl.
+              $\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-_\bi_\bn_\bc_\br_\be_\bm_\be_\bn_\b-
+       _\bt_\ba_\bl.
 
-       Incremental  searches  begin  before the user has finished
+       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
+       history  matching the string typed so far.  An incremental
+       search requires only as many characters as needed to  find
+       the  desired history entry.  The characters present in the
+       value of the _\bi_\bs_\be_\ba_\br_\bc_\bh_\b-_\bt_\be_\br_\bm_\bi_\bn_\ba_\bt_\bo_\br_\bs variable are used to ter-
+       minate  an  incremental  search.  If that variable has not
+       been assigned a value the Escape and Control-J  characters
+       will  terminate  an  incremental  search.   Control-G will
+       abort an incremental search and restore the original line.
+       When  the search is terminated, the history entry contain-
+       ing the search string becomes the current line.   To  find
+       other matching entries in the history list, type Control-S
+       or Control-R as appropriate.  This will search backward or
+       forward  in  the  history  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 exe-
+       cute that command.  For instance, a _\bn_\be_\bw_\bl_\bi_\bn_\be will terminate
+       the search and accept the line, thereby executing the com-
+       mand 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
+       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-
+       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.
 
@@ -443,21 +451,13 @@ E\bED\bDI\bIT\bTI\bIN\bNG\bG C\bCO\bOM\bMM\bMA\bAN\bND\bDS\bS
        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
+              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
+GNU                        1998 Dec 31                          7
 
 
 
@@ -466,64 +466,64 @@ GNU                        1998 Feb 19                          7
 READLINE(3)                                           READLINE(3)
 
 
+       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.
        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
+              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,
+              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-
+              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
+              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
+              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.
+              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
+              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
+              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
+              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
+              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
+              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
+GNU                        1998 Dec 31                          8
 
 
 
@@ -532,24 +532,37 @@ GNU                        1998 Feb 19                          8
 READLINE(3)                                           READLINE(3)
 
 
+       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.
        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).
+              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
+              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
+              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
+              a numeric argument, save the deleted  text  on  the
               kill ring.
+       f\bfo\bor\brw\bwa\bar\brd\bd-\b-b\bba\bac\bck\bkw\bwa\bar\brd\bd-\b-d\bde\bel\ble\bet\bte\be-\b-c\bch\bha\bar\br
+              Delete  the  character under the cursor, unless the
+              cursor is at the end of the line, in which case the
+              character   behind   the  cursor  is  deleted.   By
+              default, this is not bound to a key.
        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
@@ -572,6 +585,19 @@ READLINE(3)                                           READLINE(3)
               Uppercase the current (or following) word.  With  a
               negative argument, uppercase the previous word, but
               do not move point.
+
+
+
+
+GNU                        1998 Dec 31                          9
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
        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
@@ -585,19 +611,6 @@ READLINE(3)                                           READLINE(3)
        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)
@@ -639,6 +652,18 @@ READLINE(3)                                           READLINE(3)
               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.
 
+
+
+
+GNU                        1998 Dec 31                         10
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
    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-
@@ -651,20 +676,8 @@ READLINE(3)                                           READLINE(3)
               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
+              special  case,  if this command is immediately fol-
+              lowed 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
@@ -705,30 +718,36 @@ READLINE(3)                                           READLINE(3)
               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 Dec 31                         11
 
 
-GNU                        1998 Feb 19                         11
 
 
 
+READLINE(3)                                           READLINE(3)
 
 
-READLINE(3)                                           READLINE(3)
+       d\bde\bel\ble\bet\bte\be-\b-c\bch\bha\bar\br-\b-o\bor\br-\b-l\bli\bis\bst\bt
+              Deletes  the  character  under the cursor if not at
+              the beginning or end  of  the  line  (like  d\bde\bel\ble\bet\bte\be-\b-
+              c\bch\bha\bar\br).   If at the end of the line, behaves identi-
+              cally to  p\bpo\bos\bss\bsi\bib\bbl\ble\be-\b-c\bco\bom\bmp\bpl\ble\bet\bti\bio\bon\bns\bs.   This  command  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.
 
    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)
@@ -753,7 +772,7 @@ READLINE(3)                                           READLINE(3)
               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)
+       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
@@ -765,6 +784,18 @@ READLINE(3)                                           READLINE(3)
               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
+
+
+
+GNU                        1998 Dec 31                         12
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
               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)
@@ -783,20 +814,8 @@ READLINE(3)                                           READLINE(3)
               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
+              Print all of the settable variables and their  val-
+              ues  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.
@@ -830,6 +849,19 @@ D\bDE\bEF\bFA\bAU\bUL\bLT\bT K\bKE\bEY\bY B\bBI\bIN\bND\bDI\bIN\bNG\bGS\bS
        the  bell  (subject to the setting of the b\bbe\bel\bll\bl-\b-s\bst\bty\byl\ble\be vari-
        able).
 
+
+
+
+
+GNU                        1998 Dec 31                         13
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
    E\bEm\bma\bac\bcs\bs M\bMo\bod\bde\be
              Emacs Standard bindings
 
@@ -850,18 +882,6 @@ D\bDE\bEF\bFA\bAU\bUL\bLT\bT K\bKE\bEY\bY B\bBI\bIN\bND\bDI\bIN\bNG\bGS\bS
              "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
@@ -896,6 +916,18 @@ READLINE(3)                                           READLINE(3)
              "M-1"  digit-argument
              "M-2"  digit-argument
              "M-3"  digit-argument
+
+
+
+GNU                        1998 Dec 31                         14
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
              "M-4"  digit-argument
              "M-5"  digit-argument
              "M-6"  digit-argument
@@ -916,18 +948,6 @@ READLINE(3)                                           READLINE(3)
              "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
@@ -962,6 +982,18 @@ READLINE(3)                                           READLINE(3)
              "C-W"  unix-word-rubout
              "C-Y"  yank
              "C-["  vi-movement-mode
+
+
+
+GNU                        1998 Dec 31                         15
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
              "C-_"  undo
              " " to "~"  self-insert
              "C-?"  backward-delete-char
@@ -982,18 +1014,6 @@ READLINE(3)                                           READLINE(3)
              "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
@@ -1028,6 +1048,18 @@ READLINE(3)                                           READLINE(3)
              "S"  vi-subst
              "T"  vi-char-search
              "U"  revert-line
+
+
+
+GNU                        1998 Dec 31                         16
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
              "W"  vi-next-word
              "X"  backward-delete-char
              "Y"  vi-yank-to
@@ -1048,18 +1080,6 @@ READLINE(3)                                           READLINE(3)
              "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
@@ -1094,6 +1114,18 @@ B\bBU\bUG\bG R\bRE\bEP\bPO\bOR\bRT\bTS\bS
        library that you have.
 
        Once  you have determined that a bug actually exists, mail
+
+
+
+GNU                        1998 Dec 31                         17
+
+
+
+
+
+READLINE(3)                                           READLINE(3)
+
+
        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-
@@ -1117,6 +1149,40 @@ B\bBU\bUG\bGS\bS
 
 
 
-GNU                        1998 Feb 19                         17
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+GNU                        1998 Dec 31                         18
 
 
This page took 0.048876 seconds and 4 git commands to generate.