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>
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
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
-
-GNU 1998 Feb 19 2
+GNU 1998 Dec 31 2
-GNU 1998 Feb 19 3
+GNU 1998 Dec 31 3
-GNU 1998 Feb 19 4
+GNU 1998 Dec 31 4
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,
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
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_\bx keymaps 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_\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
+ 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.
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
+ _\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
+ 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
$\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
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.
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
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
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
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
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)
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-
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
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)
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
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)
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.
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
"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
"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
"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
"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
"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
"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
"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
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-
-GNU 1998 Feb 19 17
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+GNU 1998 Dec 31 18