path: root/documentation/readline.ps

%!PS-Adobe-3.0
%%Creator: groff version 1.08
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%DocumentSuppliedResources: procset grops 1.08 0
%%Pages: 12
%%PageOrder: Ascend
%%Orientation: Portrait
%%EndComments
%%BeginProlog
%%BeginResource: procset grops 1.08 0
/setpacking where{
pop
currentpacking
true setpacking
}if
/grops 120 dict dup begin
/SC 32 def
/A/show load def
/B{0 SC 3 -1 roll widthshow}bind def
/C{0 exch ashow}bind def
/D{0 exch 0 SC 5 2 roll awidthshow}bind def
/E{0 rmoveto show}bind def
/F{0 rmoveto 0 SC 3 -1 roll widthshow}bind def
/G{0 rmoveto 0 exch ashow}bind def
/H{0 rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/I{0 exch rmoveto show}bind def
/J{0 exch rmoveto 0 SC 3 -1 roll widthshow}bind def
/K{0 exch rmoveto 0 exch ashow}bind def
/L{0 exch rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/M{rmoveto show}bind def
/N{rmoveto 0 SC 3 -1 roll widthshow}bind def
/O{rmoveto 0 exch ashow}bind def
/P{rmoveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/Q{moveto show}bind def
/R{moveto 0 SC 3 -1 roll widthshow}bind def
/S{moveto 0 exch ashow}bind def
/T{moveto 0 exch 0 SC 5 2 roll awidthshow}bind def
/SF{
findfont exch
[exch dup 0 exch 0 exch neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/MF{
findfont
[5 2 roll
0 3 1 roll 
neg 0 0]makefont
dup setfont
[exch/setfont cvx]cvx bind def
}bind def
/level0 0 def
/RES 0 def
/PL 0 def
/LS 0 def
/PLG{
gsave newpath clippath pathbbox grestore
exch pop add exch pop
}bind def
/BP{
/level0 save def
1 setlinecap
1 setlinejoin
72 RES div dup scale
LS{
90 rotate
}{
0 PL translate
}ifelse
1 -1 scale
}bind def
/EP{
level0 restore
showpage
}bind def
/DA{
newpath arcn stroke
}bind def
/SN{
transform
.25 sub exch .25 sub exch
round .25 add exch round .25 add exch
itransform
}bind def
/DL{
SN
moveto
SN
lineto stroke
}bind def
/DC{
newpath 0 360 arc closepath
}bind def
/TM matrix def
/DE{
TM currentmatrix pop
translate scale newpath 0 0 .5 0 360 arc closepath
TM setmatrix
}bind def
/RC/rcurveto load def
/RL/rlineto load def
/ST/stroke load def
/MT/moveto load def
/CL/closepath load def
/FL{
currentgray exch setgray fill setgray
}bind def
/BL/fill load def
/LW/setlinewidth load def
/RE{
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne{def}{pop pop}ifelse
}forall
/Encoding exch def
dup/FontName exch def
currentdict end definefont pop
}bind def
/DEFS 0 def
/EBEGIN{
moveto
DEFS begin
}bind def
/EEND/end load def
/CNT 0 def
/level1 0 def
/PBEGIN{
/level1 save def
translate
div 3 1 roll div exch scale
neg exch neg exch translate
0 setgray
0 setlinecap
1 setlinewidth
0 setlinejoin
10 setmiterlimit
[]0 setdash
/setstrokeadjust where{
pop
false setstrokeadjust
}if
/setoverprint where{
pop
false setoverprint
}if
newpath
/CNT countdictstack def
userdict begin
/showpage{}def
}bind def
/PEND{
clear
countdictstack CNT sub{end}repeat
level1 restore
}bind def
end def
/setpacking where{
pop
setpacking
}if
%%EndResource
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72 def/PL
792 def/LS false def/ENC0[/asciicircum/asciitilde/Scaron/Zcaron/scaron/zcaron
/Ydieresis/trademark/quotesingle/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef
/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/.notdef/space
/exclam/quotedbl/numbersign/dollar/percent/ampersand/quoteright/parenleft
/parenright/asterisk/plus/comma/hyphen/period/slash/zero/one/two/three/four
/five/six/seven/eight/nine/colon/semicolon/less/equal/greater/question/at/A/B/C
/D/E/F/G/H/I/J/K/L/M/N/O/P/Q/R/S/T/U/V/W/X/Y/Z/bracketleft/backslash
/bracketright/circumflex/underscore/quoteleft/a/b/c/d/e/f/g/h/i/j/k/l/m/n/o/p/q
/r/s/t/u/v/w/x/y/z/braceleft/bar/braceright/tilde/.notdef/quotesinglbase
/guillemotleft/guillemotright/bullet/florin/fraction/perthousand/dagger
/daggerdbl/endash/emdash/ff/fi/fl/ffi/ffl/dotlessi/dotlessj/grave/hungarumlaut
/dotaccent/breve/caron/ring/ogonek/quotedblleft/quotedblright/oe/lslash
/quotedblbase/OE/Lslash/.notdef/exclamdown/cent/sterling/currency/yen/brokenbar
/section/dieresis/copyright/ordfeminine/guilsinglleft/logicalnot/minus
/registered/macron/degree/plusminus/twosuperior/threesuperior/acute/mu
/paragraph/periodcentered/cedilla/onesuperior/ordmasculine/guilsinglright
/onequarter/onehalf/threequarters/questiondown/Agrave/Aacute/Acircumflex/Atilde
/Adieresis/Aring/AE/Ccedilla/Egrave/Eacute/Ecircumflex/Edieresis/Igrave/Iacute
/Icircumflex/Idieresis/Eth/Ntilde/Ograve/Oacute/Ocircumflex/Otilde/Odieresis
/multiply/Oslash/Ugrave/Uacute/Ucircumflex/Udieresis/Yacute/Thorn/germandbls
/agrave/aacute/acircumflex/atilde/adieresis/aring/ae/ccedilla/egrave/eacute
/ecircumflex/edieresis/igrave/iacute/icircumflex/idieresis/eth/ntilde/ograve
/oacute/ocircumflex/otilde/odieresis/divide/oslash/ugrave/uacute/ucircumflex
/udieresis/yacute/thorn/ydieresis]def/Times-Italic@0 ENC0/Times-Italic RE
/Times-Bold@0 ENC0/Times-Bold RE/Times-Roman@0 ENC0/Times-Roman RE
%%EndProlog
%%Page: 1 1
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 9
/Times-Bold@0 SF -.18(NA)72 84 S(ME).18 E F0
(readline \255 get a line from a user with editing)108 96 Q F1(SYNOPSIS)72
112.8 Q/F2 10/Times-Bold@0 SF(#include <r)108 124.8 Q(eadline.h>)-.18 E
(#include <history)108 136.8 Q(.h>)-.7 E(typedef int Function \(\);)108 153.6 Q
(char *r)108 170.4 Q(eadline \(pr)-.18 E(ompt\))-.18 E(char *pr)108 182.4 Q
(ompt;)-.18 E(int rl_add_defun \(name, function, k)108 199.2 Q(ey\))-.1 E
(char *name;)108 211.2 Q(Function *function;)108 223.2 Q(int k)108 235.2 Q(ey;)
-.1 E(int rl_bind_k)108 252 Q(ey \(k)-.1 E(ey)-.1 E 2.5(,f)-.55 G(unction\))
202.26 252 Q(int k)108 264 Q(ey;)-.1 E(Function *function;)108 276 Q
(int rl_unbind_k)108 292.8 Q(ey \(k)-.1 E(ey\))-.1 E(int k)108 304.8 Q(ey;)-.1
E(int rl_bind_k)108 321.6 Q(ey_in_map \(k)-.1 E(ey)-.1 E 2.5(,f)-.55 G
(unction, k)239.49 321.6 Q(eymap\))-.1 E(int k)108 333.6 Q(ey;)-.1 E
(Function *function;)108 345.6 Q -.25(Ke)108 357.6 S(ymap k).25 E(eymap;)-.1 E
(int rl_unbind_k)108 374.4 Q(ey_in_map \(k)-.1 E(ey)-.1 E 2.5(,k)-.55 G
(eymap\))252.74 374.4 Q(int k)108 386.4 Q(ey;)-.1 E -.25(Ke)108 398.4 S(ymap k)
.25 E(eymap;)-.1 E(int rl_macr)108 415.2 Q(o_bind \(k)-.18 E(eyseq, macr)-.1 E
(o, k)-.18 E(eymap\))-.1 E(char *k)108 427.2 Q(eyseq, *macr)-.1 E(o;)-.18 E
-.25(Ke)108 439.2 S(ymap k).25 E(eymap;)-.1 E(int rl_v)108 456 Q
(ariable_bind \(v)-.1 E(ariable, v)-.1 E(alue\))-.1 E(char *v)108 468 Q
(ariable, *v)-.1 E(alue;)-.1 E(int rl_parse_and_bind \(line\))108 484.8 Q
(char *line;)108 496.8 Q(int rl_translate_k)108 513.6 Q(eyseq \(k)-.1 E
(eyseq, array)-.1 E 2.5(,l)-.55 G(en\))276.68 513.6 Q(char *k)108 525.6 Q
(eyseq, *array;)-.1 E(int *len;)108 537.6 Q
(Function *rl_named_function \(command\))108 554.4 Q(char *command;)108 566.4 Q
(Function *rl_function_of_k)108 583.2 Q(eyseq \(k)-.1 E(eyseq, k)-.1 E
(eymap, type\))-.1 E(char *k)108 595.2 Q(eyseq;)-.1 E -.25(Ke)108 607.2 S
(ymap k).25 E(eymap;)-.1 E(int *type;)108 619.2 Q(char **rl_in)108 636 Q -.1
(vo)-.4 G(king_k).1 E(eyseqs \(function\))-.1 E(Function *function;)108 648 Q
(char **rl_in)108 664.8 Q -.1(vo)-.4 G(king_k).1 E(eyseqs_in_map \(function, k)
-.1 E(eymap\))-.1 E(Function *function;)108 676.8 Q -.25(Ke)108 688.8 S(ymap k)
.25 E(eymap;)-.1 E -.1(vo)108 705.6 S(id rl_function_dumper \(r).1 E(eadable\))
-.18 E(int r)108 717.6 Q(eadable;)-.18 E F0 184.005(GNU 1994)72 768 R(July 26)
2.5 E(1)535 768 Q EP
%%Page: 2 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10
/Times-Bold@0 SF(char **rl_funmap_names \(\))108 84 Q/F2 9/Times-Bold@0 SF
(COPYRIGHT)72 100.8 Q F0(Readline is Cop)108 112.8 Q
(yright \251 1989, 1991 by the Free Softw)-.1 E(are F)-.1 E(oundation, Inc.)
-.15 E F2(DESCRIPTION)72 129.6 Q F1 -.18(re)108 141.6 S(adline).18 E F0 .49
(will read a line from the terminal and return it, using)2.99 F F1(pr)2.99 E
(ompt)-.18 E F0 .49(as a prompt.)2.99 F(If)5.49 E F1(pr)2.99 E(ompt)-.18 E F0
.49(is null, no)2.99 F 1.066(prompt is issued.)108 153.6 R 1.066
(The line returned is allocated with)6.066 F/F3 10/Times-Italic@0 SF(malloc)
3.566 E F0 1.067(\(3\), so the caller must free it when \214nished.).31 F
(The line returned has the \214nal ne)108 165.6 Q(wline remo)-.25 E -.15(ve)
-.15 G(d, so only the te).15 E(xt of the line remains.)-.15 E F1 -.18(re)108
182.4 S(adline).18 E F0(of)3.79 E 1.29
(fers editing capabilities while the user is entering the line.)-.25 F 1.289
(By def)6.289 F 1.289(ault, the line editing com-)-.1 F
(mands are similar to those of emacs.)108 194.4 Q 2.5(Av)5 G
(i\255style line editing interf)273.53 194.4 Q(ace is also a)-.1 E -.25(va)-.2
G(ilable.).25 E 6.74(In the follo)108 211.2 R 6.74(wing descriptions,)-.25 F F1
-.1(ke)9.24 G(ymap).1 E F0 6.74(can be one of)9.24 F F3(emacs_k)9.24 E -.3(ey)
-.1 G 6.74(map, emacs_meta_k).3 F -.3(ey)-.1 G(map,).3 E(emacs_ctlx_k)108 223.2
Q -.3(ey)-.1 G(map, vi_insertion_k).3 E -.3(ey)-.1 G(map, or vi_mo).3 E
(vement_k)-.1 E -.3(ey)-.1 G(map).3 E F0(.)A F1(rl_add_defun)108 240 Q F0(mak)
3.356 E(es)-.1 E F1(name)3.356 E F0 .856
(appear as a bindable readline command, and mak)3.356 F(es)-.1 E F1(function)
3.355 E F0 .855(be the function)3.355 F(called when that command is in)108 252
Q -.2(vo)-.4 G -.1(ke).2 G 2.5(d. If).1 F F1 -.1(ke)2.5 G(y).1 E F0
(is not \2551, it is bound to)2.5 E F1(function)2.5 E F0(in the current k)2.5 E
-.15(ey)-.1 G(map.).15 E F1(rl_bind_k)108 268.8 Q(ey)-.1 E F0(causes)2.5 E F1
-.1(ke)2.5 G(y).1 E F0(to in)2.5 E -.2(vo)-.4 G -.1(ke).2 G F1(function)2.6 E
F0 5(.T)C(he binding is made in the current k)296.55 268.8 Q -.15(ey)-.1 G
(map.).15 E F1(rl_unbind_k)108 285.6 Q(ey)-.1 E F0(remo)2.5 E -.15(ve)-.15 G
2.5(st).15 G(he binding for)212.06 285.6 Q F1 -.1(ke)2.5 G(y).1 E F0
(in the current k)2.5 E -.15(ey)-.1 G(map.).15 E F1(rl_bind_k)108 302.4 Q
(ey_in_map)-.1 E F0(mak)2.5 E(es the)-.1 E F1 -.1(ke)2.5 G(y).1 E F0(entry in)
2.5 E F1 -.1(ke)2.5 G(ymap).1 E F0(in)2.5 E -.2(vo)-.4 G -.1(ke).2 G F1
(function)2.6 E F0(.)A F1(rl_unbind_k)108 319.2 Q(ey_in_map)-.1 E F0(remo)2.5 E
-.15(ve)-.15 G 2.5(st).15 G(he binding for)249.29 319.2 Q F1 -.1(ke)2.5 G(y).1
E F0(in k)2.5 E -.15(ey)-.1 G(map).15 E F1 -.1(ke)2.5 G(ymap).1 E F0(.)A F1
(rl_macr)108 336 Q(o_bind)-.18 E F0(mak)2.5 E(es)-.1 E F1 -.1(ke)2.5 G(yseq).1
E F0(insert the string)2.5 E F1(macr)2.5 E(o)-.18 E F0 5(.T)C
(he binding is performed in)338.81 336 Q F1 -.1(ke)2.5 G(ymap).1 E F0(.)A F1
(rl_v)108 352.8 Q(ariable_bind)-.1 E F0(sets the v)2.5 E
(alue of the readline v)-.25 E(ariable)-.25 E F1 -.1(va)2.5 G(riable).1 E F0
(to)2.5 E F1 -.1(va)2.5 G(lue).1 E F0(.)A F1(rl_parse_and_bind)108 369.6 Q F0
(tak)2.806 E .307(es as an ar)-.1 F .307
(gument a line of the same form as the readline startup \214le \(see)-.18 F F2
(INITIAL-)2.807 E(IZA)108 381.6 Q(TION FILE)-.855 E F0(belo)2.25 E(w\) and e)
-.25 E -.15(xe)-.15 G(cutes the commands therein.).15 E F1(rl_translate_k)108
398.4 Q(eyseq)-.1 E F0(con)2.975 E -.15(ve)-.4 G(rts).15 E F1 -.1(ke)2.975 G
(yseq).1 E F0 .475(into a ne)2.975 F 2.975(ws)-.25 G .475
(tring, storing the result in)312.05 398.4 R F1(array)2.975 E F0 5.475(.T)C
.475(his translates control)456.28 398.4 R .337(and meta pre\214x)108 410.4 R
.337(es and the readline character escape sequences \(see)-.15 F F2 -.225(Ke)
2.837 G 2.587(yB).225 G(indings)404.423 410.4 Q F0(belo)2.588 E 2.838(w\). The)
-.25 F .338(length of the)2.838 F(translated sequence is returned in)108 422.4
Q F1(*len)2.5 E F0(.)A F1(rl_named_function)108 439.2 Q F0 2.974
(returns the function that is e)5.474 F -.15(xe)-.15 G 2.973
(cuted when the readline command).15 F F1(command)5.473 E F0(is)5.473 E(in)108
451.2 Q -.2(vo)-.4 G -.1(ke).2 G(d.).1 E F1(rl_function_of_k)108 468 Q(eyseq)
-.1 E F0 .801(returns the function that is e)3.301 F -.15(xe)-.15 G .801
(cuted when).15 F F1 -.1(ke)3.301 G(yseq).1 E F0 .801(is read and)3.301 F F1
-.1(ke)3.302 G(ymap).1 E F0 .802(is the cur)3.302 F(-)-.2 E .267(rent k)108 480
R -.15(ey)-.1 G(map.).15 E F1(type)5.267 E F0 .267
(is set to indicate whether the return v)2.767 F .266
(alue corresponds to a function, macro, or auxiliary)-.25 F -.1(ke)108 492 S
(ymap.)-.05 E F1(rl_in)108 508.8 Q -.1(vo)-.4 G(king_k).1 E(eyseqs)-.1 E F0
(returns all of the k)2.5 E .3 -.15(ey s)-.1 H(equences in the current k).15 E
-.15(ey)-.1 G(map that in).15 E -.2(vo)-.4 G -.1(ke).2 G F1(function)2.6 E F0
(.)A F1(rl_in)108 525.6 Q -.1(vo)-.4 G(king_k).1 E(eyseqs_in_map)-.1 E F0
(returns all of the k)2.5 E .3 -.15(ey s)-.1 H(equences in).15 E F1 -.1(ke)2.5
G(ymap).1 E F0(that in)2.5 E -.2(vo)-.4 G -.1(ke).2 G F1(function)2.6 E F0(.)A
F1(rl_function_dumper)108 542.4 Q F0 .117(prints all of the readline functions\
 and their bindings to the readline output stream.)2.617 F(If)5.118 E F1 -.18
(re)108 554.4 S(adable).18 E F0(is non\255zero, the output is formattted so th\
at it can be read back in to restore the bindings.)2.5 E F1(rl_funmap_names)108
571.2 Q F0(returns an array of all kno)2.5 E
(wn readline bindable function names.)-.25 E(The array is sorted.)5 E F2
(RETURN V)72 588 Q(ALUE)-1.215 E F1 -.18(re)108 600 S(adline).18 E F0 1.09
(returns the te)3.59 F 1.09(xt of the line read.)-.15 F 3.589(Ab)6.09 G 1.089
(lank line returns the empty string.)299.949 600 R(If)6.089 E F1(EOF)3.589 E F0
1.089(is encountered)3.589 F .283(while reading a line, and the line is empty)
108 612 R(,)-.65 E F1(NULL)2.783 E F0 .283(is returned.)2.783 F .283(If an)
5.283 F F1(EOF)2.783 E F0 .283(is read with a non\255empty line, it)2.783 F
(is treated as a ne)108 624 Q(wline.)-.25 E(Unless otherwise stated, the other\
 functions return 0 on success and non\255zero on f)108 640.8 Q(ailure.)-.1 E
F2(NO)72 657.6 Q -.81(TA)-.36 G(TION)-.045 E F0 .037
(An emacs\255style notation is used to denote k)108 669.6 R -.15(ey)-.1 G
(strok).15 E 2.536(es. Control)-.1 F -.1(ke)2.536 G .036
(ys are denoted by C\255)-.05 F F3 -.1(ke)C(y)-.2 E F0 2.536(,e)C .036
(.g., C\255n means)479.568 669.6 R 2.625(Control\255N. Similarly)108 681.6 R(,)
-.65 E F3(meta)2.625 E F0 -.1(ke)2.625 G .125(ys are denoted by M\255)-.05 F F3
-.1(ke)C(y)-.2 E F0 2.625(,s)C 2.625(oM)341.73 681.6 S .125
(\255x means Meta\255X.)358.245 681.6 R .126(\(On k)5.126 F -.15(ey)-.1 G .126
(boards without a).15 F F3(meta)108 693.6 Q F0 -.1(ke)3.309 G 2.109 -.65(y, M)
-.05 H<ad>.65 E F3(x)A F0 .809(means ESC)3.309 F F3(x)3.309 E F0 3.309(,i)C
.809(.e., press the Escape k)235.914 693.6 R 1.108 -.15(ey t)-.1 H .808
(hen the).15 F F3(x)3.308 E F0 -.1(ke)3.308 G 4.608 -.65(y. T)-.05 H .808
(his mak).65 F .808(es ESC the)-.1 F F3 .808(meta pr)3.308 F(e\214x)-.37 E F0
(.)A .48(The combination M\255C\255)108 705.6 R F3(x)A F0 .48
(means ESC\255Control\255)2.98 F F3(x)A F0 2.98(,o)C 2.98(rp)317.4 705.6 S .48
(ress the Escape k)328.71 705.6 R .78 -.15(ey t)-.1 H .48
(hen hold the Control k).15 F .78 -.15(ey w)-.1 H(hile).15 E(pressing the)108
717.6 Q F3(x)2.5 E F0 -.1(ke)2.5 G -.65(y.)-.05 G(\)).65 E 184.005(GNU 1994)72
768 R(July 26)2.5 E(2)535 768 Q EP
%%Page: 3 3
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R .62
(Readline commands may be gi)108 84 R -.15(ve)-.25 G 3.119(nn).15 G(umeric)
255.959 84 Q/F1 10/Times-Italic@0 SF(ar)3.119 E(guments)-.37 E F0 3.119(,w).27
G .619(hich normally act as a repeat count.)341.807 84 R(Sometimes,)5.619 E(ho)
108 96 Q(we)-.25 E -.15(ve)-.25 G 1.418 -.4(r, i).15 H 3.118(ti).4 G 3.119(st)
158.456 96 S .619(he sign of the ar)168.245 96 R .619
(gument that is signi\214cant.)-.18 F -.15(Pa)5.619 G .619(ssing a ne).15 F
-.05(ga)-.15 G(ti).05 E .919 -.15(ve a)-.25 H -.18(rg).15 G .619
(ument to a command that).18 F 1.019(acts in the forw)108 108 R 1.018
(ard direction \(e.g.,)-.1 F/F2 10/Times-Bold@0 SF(kill\255line)3.518 E F0
3.518(\)c)C 1.018(auses that command to act in a backw)298.478 108 R 1.018
(ard direction.)-.1 F(Com-)6.018 E(mands whose beha)108 120 Q(vior with ar)-.2
E(guments de)-.18 E(viates from this are noted.)-.25 E .811
(When a command is described as)108 136.8 R F1(killing)3.311 E F0(te)3.311 E
.811(xt, the te)-.15 F .811(xt deleted is sa)-.15 F -.15(ve)-.2 G 3.311(df).15
G .812(or possible future retrie)403.403 136.8 R -.25(va)-.25 G 3.312(l\().25 G
F1(yank-)517.79 136.8 Q(ing)108 148.8 Q F0 3.439(\). The)B .939(killed te)3.439
F .939(xt is sa)-.15 F -.15(ve)-.2 G 3.439(di).15 G 3.438(na)234.794 148.8 S F1
(kill\255ring)A F0 5.938(.C)C(onsecuti)302.418 148.8 Q 1.238 -.15(ve k)-.25 H
.938(ills cause the te).15 F .938(xt to be accumulated into one)-.15 F .331
(unit, which can be yank)108 160.8 R .331(ed all at once.)-.1 F .331
(Commands which do not kill te)5.331 F .331(xt separate the chunks of te)-.15 F
.331(xt on the)-.15 F(kill\255ring.)108 172.8 Q/F3 9/Times-Bold@0 SF
(INITIALIZA)72 189.6 Q(TION FILE)-.855 E F0 .827
(Readline is customized by putting commands in an initialization \214le.)108
201.6 R .827(The name of this \214le is tak)5.827 F .827(en from)-.1 F 1.041
(the v)108 213.6 R 1.041(alue of the)-.25 F F2(INPUTRC)3.541 E F0 -.25(va)3.542
G 3.542(riable. If).25 F 1.042(that v)3.542 F 1.042(ariable is unset, the def)
-.25 F 1.042(ault is)-.1 F F1(~/.inputr)3.542 E(c)-.37 E F0 6.042(.W).31 G
1.042(hen a program)480.156 213.6 R 1.159
(which uses the readline library starts up, the init \214le is read, and the k)
108 225.6 R 1.458 -.15(ey b)-.1 H 1.158(indings and v).15 F 1.158
(ariables are set.)-.25 F .028(There are only a fe)108 237.6 R 2.528(wb)-.25 G
.028(asic constructs allo)198.13 237.6 R .028(wed in the readline init \214le.)
-.25 F .029(Blank lines are ignored.)5.029 F .029(Lines be)5.029 F(gin-)-.15 E
.554(ning with a)108 249.6 R F2(#)3.054 E F0 .554(are comments.)3.054 F .554
(Lines be)5.554 F .554(ginning with a)-.15 F F2($)3.054 E F0 .554
(indicate conditional constructs.)3.054 F .553(Other lines denote)5.553 F -.1
(ke)108 261.6 S 2.986(yb)-.05 G .486(indings and v)130.176 261.6 R .487
(ariable settings.)-.25 F .487(Each program using this library may add its o)
5.487 F .487(wn commands and bind-)-.25 F(ings.)108 273.6 Q -.15(Fo)108 290.4 S
2.5(re).15 G(xample, placing)128.53 290.4 Q(M\255Control\255u: uni)144 307.2 Q
-.15(ve)-.25 G(rsal\255ar).15 E(gument)-.18 E(or)108 319.2 Q
(C\255Meta\255u: uni)144 331.2 Q -.15(ve)-.25 G(rsal\255ar).15 E(gument)-.18 E
(into the)108 343.2 Q F1(~/.inputr)4.166 E(c)-.37 E F0 -.1(wo)4.166 G(uld mak)
.1 E 2.5(eM)-.1 G(\255C\255u e)244.092 343.2 Q -.15(xe)-.15 G
(cute the readline command).15 E F1(univer)2.5 E(sal\255ar)-.1 E(gument)-.37 E
F0(.).68 E .978(The follo)108 360 R .978
(wing symbolic character names are recognized while processing k)-.25 F 1.277
-.15(ey b)-.1 H(indings:).15 E F1 -.4(RU)3.477 G(BOUT).4 E F0(,)1.27 E F1(DEL)
3.477 E F0(,).53 E F1(ESC)108 372 Q F0(,).72 E F1(LFD)2.984 E F0(,).28 E F1
(NEWLINE)2.984 E F0(,).73 E F1(RET)2.984 E F0(,)1.27 E F1(RETURN)2.984 E F0(,)
1.1 E F1(SPC)2.984 E F0(,).72 E F1(SP)2.984 E -.3(AC)-.9 G(E).3 E F0 2.984(,a)
.73 G(nd)337.968 372 Q F1 -.5(TA)2.984 G(B).5 E F0 5.484(.I).27 G 2.984(na)
379.816 372 S .485(ddition to command names, readline)392.24 372 R(allo)108 384
Q(ws k)-.25 E -.15(ey)-.1 G 2.5(st).15 G 2.5(ob)159.72 384 S 2.5(eb)172.22 384
S(ound to a string that is inserted when the k)184.16 384 Q .3 -.15(ey i)-.1 H
2.5(sp).15 G(ressed \(a)379.73 384 Q F1(macr)2.5 E(o)-.45 E F0(\).)A F2 -.25
(Ke)87 405.6 S 2.5(yB).25 G(indings)113.14 405.6 Q F0 .724
(The syntax for controlling k)108 417.6 R 1.024 -.15(ey b)-.1 H .724
(indings in the).15 F F1(~/.inputr)3.224 E(c)-.37 E F0 .724(\214le is simple.)
3.224 F .723(All that is required is the name of)5.724 F .938
(the command or the te)108 429.6 R .938(xt of a macro and a k)-.15 F 1.238 -.15
(ey s)-.1 H .938(equence to which it should be bound. The name may be).15 F
.695(speci\214ed in one of tw)108 441.6 R 3.195(ow)-.1 G .695
(ays: as a symbolic k)212.095 441.6 R .995 -.15(ey n)-.1 H .695
(ame, possibly with).15 F F1(Meta\255)3.195 E F0(or)3.195 E F1(Contr)3.194 E
(ol\255)-.45 E F0(pre\214x)3.194 E .694(es, or as a)-.15 F -.1(ke)108 453.6 S
4.143(ys)-.05 G 4.143(equence. When)130.223 453.6 R 1.643(using the form)4.143
F F2 -.1(ke)4.143 G(yname).1 E F0(:)A F1(function-name)A F0(or)4.143 E F1(macr)
4.143 E(o)-.45 E F0(,)A F1 -.1(ke)4.143 G(yname)-.2 E F0 1.644
(is the name of a k)4.143 F -.15(ey)-.1 G(spelled out in English.)108 465.6 Q
-.15(Fo)5 G 2.5(re).15 G(xample:)222.98 465.6 Q(Control\255u: uni)144 489.6 Q
-.15(ve)-.25 G(rsal\255ar).15 E(gument)-.18 E(Meta\255Rubout: backw)144 501.6 Q
(ard\255kill\255w)-.1 E(ord)-.1 E(Control\255o: ">&output")144 513.6 Q .229
(In the abo)108 530.4 R .529 -.15(ve ex)-.15 H(ample,).15 E F1(C\255u)2.729 E
F0 .229(is bound to the function)2.729 F F2(uni)2.729 E -.1(ve)-.1 G
(rsal\255ar).1 E(gument)-.1 E F0(,)A F1(M-DEL)2.729 E F0 .228
(is bound to the function)2.729 F F2(backward\255kill\255w)108 542.4 Q(ord)-.1
E F0 3.837(,a)C(nd)208.977 542.4 Q F1(C\255o)3.837 E F0 1.337
(is bound to run the macro e)3.837 F 1.337
(xpressed on the right hand side \(that is, to)-.15 F(insert the te)108 554.4 Q
(xt)-.15 E F1(>&output)2.5 E F0(into the line\).)2.5 E .115
(In the second form,)108 571.2 R F2("k)2.615 E(eyseq")-.1 E F0(:)A F1
(function\255name)A F0(or)2.615 E F1(macr)2.615 E(o)-.45 E F0(,)A F2 -.1(ke)
2.615 G(yseq).1 E F0(dif)2.615 E .115(fers from)-.25 F F2 -.1(ke)2.615 G(yname)
.1 E F0(abo)2.615 E .415 -.15(ve i)-.15 H 2.615(nt).15 G .115(hat strings)
498.495 571.2 R 1.284(denoting an entire k)108 583.2 R 1.584 -.15(ey s)-.1 H
1.284(equence may be speci\214ed by placing the sequence within double quotes.)
.15 F(Some)6.284 E(GNU Emacs style k)108 595.2 Q .3 -.15(ey e)-.1 H
(scapes can be used, as in the follo).15 E(wing e)-.25 E(xample.)-.15 E
("\\C\255u": uni)144 619.2 Q -.15(ve)-.25 G(rsal\255ar).15 E(gument)-.18 E
("\\C\255x\\C\255r": re\255read\255init\255\214le)144 631.2 Q
("\\e[11~": "Function K)144 643.2 Q .3 -.15(ey 1)-.25 H(").15 E .238(In this e)
108 660 R(xample,)-.15 E F1(C-u)2.738 E F0 .238(is ag)2.738 F .238
(ain bound to the function)-.05 F F2(uni)2.738 E -.1(ve)-.1 G(rsal\255ar).1 E
(gument)-.1 E F0(.)A F1 .237(C-x C-r)5.238 F F0 .237(is bound to the function)
2.737 F F2 -.18(re)108 672 S<ad72>.18 E(ead\255init\255\214le)-.18 E F0 3.909
(,a)C(nd)191.139 672 Q F1 1.409(ESC [ 1 1 ~)3.909 F F0 1.409
(is bound to insert the te)3.909 F(xt)-.15 E F2 1.41(Function K)3.91 F 1.41
(ey 1)-.25 F F0 6.41(.T)C 1.41(he full set of escape)454.94 672 R(sequences is)
108 684 Q F2(\\C-)144 700.8 Q F0(control pre\214x)180 700.8 Q F2(\\M-)144 717.6
Q F0(meta pre\214x)180 717.6 Q 184.005(GNU 1994)72 768 R(July 26)2.5 E(3)535
768 Q EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10
/Times-Bold@0 SF(\\e)144 84 Q F0(an escape character)180 84 Q F1(\\\\)144 100.8
Q F0(backslash)180 100.8 Q F1(\\")144 117.6 Q F0(literal ")180 117.6 Q F1(\\')
144 134.4 Q F0(literal ')180 134.4 Q .74(When entering the te)108 151.2 R .74(\
xt of a macro, single or double quotes should be used to indicate a macro de\
\214nition.)-.15 F 1.226(Unquoted te)108 163.2 R 1.226
(xt is assumed to be a function name.)-.15 F 1.227(Backslash will quote an)
6.226 F 3.727(yc)-.15 G 1.227(haracter in the macro te)430.552 163.2 R(xt,)-.15
E(including " and '.)108 175.2 Q F1(Bash)108 192 Q F0(allo)2.93 E .43
(ws the current readline k)-.25 F .73 -.15(ey b)-.1 H .429
(indings to be displayed or modi\214ed with the).15 F F1(bind)2.929 E F0 -.2
(bu)2.929 G .429(iltin command.).2 F 1.095
(The editing mode may be switched during interacti)108 204 R 1.395 -.15(ve u)
-.25 H 1.095(se by using the).15 F F1<ad6f>3.595 E F0 1.095(option to the)3.595
F F1(set)3.595 E F0 -.2(bu)3.595 G 1.095(iltin com-).2 F 3.097(mand. Other)108
216 R .597(programs using this library pro)3.097 F .597
(vide similar mechanisms.)-.15 F(The)5.597 E/F2 10/Times-Italic@0 SF(inputr)
3.097 E(c)-.37 E F0 .596(\214le may be edited and)3.096 F
(re\255read if a program does not pro)108 228 Q(vide an)-.15 E 2.5(yo)-.15 G
(ther means to incorporate ne)283.85 228 Q 2.5(wb)-.25 G(indings.)412.18 228 Q
F1 -.92(Va)87 244.8 S(riables).92 E F0 .043(Readline has v)108 256.8 R .044
(ariables that can be used to further customize its beha)-.25 F(vior)-.2 E
5.044(.A)-.55 G -.25(va)413.896 256.8 S .044(riable may be set in the).25 F F2
(inpu-)2.544 E(tr)108 268.8 Q(c)-.37 E F0(\214le with a statement of the form)
2.5 E F1(set)144 285.6 Q F2(variable\255name value)2.5 E F0 .489
(Except where noted, readline v)108 302.4 R .489(ariables can tak)-.25 F 2.989
(et)-.1 G .489(he v)307.123 302.4 R(alues)-.25 E F1(On)2.989 E F0(or)2.989 E F1
(Off)2.989 E F0 5.489(.T)C .489(he v)404.028 302.4 R .488
(ariables and their def)-.25 F .488(ault v)-.1 F(al-)-.25 E(ues are:)108 314.4
Q F1(horizontal\255scr)108 331.2 Q(oll\255mode \(Off\))-.18 E F0 .448
(When set to)144 343.2 R F1(On)2.948 E F0 2.948(,m)C(ak)222.182 343.2 Q .448
(es readline use a single line for display)-.1 F 2.948(,s)-.65 G .449
(crolling the input horizontally on a)398.596 343.2 R 1.194(single screen line\
 when it becomes longer than the screen width rather than wrapping to a ne)144
355.2 R(w)-.25 E(line.)144 367.2 Q F1(editing\255mode \(emacs\))108 379.2 Q F0
.252(Controls whether readline be)144 391.2 R .253(gins with a set of k)-.15 F
.553 -.15(ey b)-.1 H .253(indings similar to).15 F F2(emacs)2.753 E F0(or)2.753
E F2(vi)2.753 E F0(.)A F1(editing\255mode)5.253 E F0(can be set to either)144
403.2 Q F1(emacs)2.5 E F0(or)2.5 E F1(vi)2.5 E F0(.)A F1
(mark\255modi\214ed\255lines \(Off\))108 415.2 Q F0(If set to)144 427.2 Q F1
(On)2.5 E F0 2.5(,h)C(istory lines that ha)200.39 427.2 Q .3 -.15(ve b)-.2 H
(een modi\214ed are displayed with a preceding asterisk \().15 E F1(*)A F0(\).)
A F1(bell\255style \(audible\))108 439.2 Q F0 .011
(Controls what happens when readline w)144 451.2 R .011
(ants to ring the terminal bell.)-.1 F .01(If set to)5.01 F F1(none)2.51 E F0
2.51(,r)C .01(eadline ne)486.8 451.2 R -.15(ve)-.25 G(r).15 E .94
(rings the bell.)144 463.2 R .94(If set to)5.94 F F1(visible)3.44 E F0 3.44(,r)
C .94(eadline uses a visible bell if one is a)278.91 463.2 R -.25(va)-.2 G 3.44
(ilable. If).25 F .94(set to)3.44 F F1(audible)3.44 E F0(,)A
(readline attempts to ring the terminal')144 475.2 Q 2.5(sb)-.55 G(ell.)306.21
475.2 Q F1(comment\255begin \(`)108 487.2 Q(`#')-.63 E('\))-.63 E F0
(The string that is inserted in)144 499.2 Q F1(vi)2.5 E F0(mode when the)2.5 E
F1(vi\255comment)2.5 E F0(command is e)2.5 E -.15(xe)-.15 G(cuted.).15 E F1
(meta\255\215ag \(Off\))108 511.2 Q F0 .228(If set to)144 523.2 R F1(On)2.728 E
F0 2.728(,r)C .227(eadline will enable eight-bit input \(that is, it will not \
strip the high bit from the char)199.632 523.2 R(-)-.2 E(acters it reads\), re)
144 535.2 Q -.05(ga)-.15 G(rdless of what the terminal claims it can support.)
.05 E F1(con)108 547.2 Q -.1(ve)-.4 G(rt\255meta \(On\)).1 E F0 .612(If set to)
144 559.2 R F1(On)3.112 E F0 3.112(,r)C .613(eadline will con)201.168 559.2 R
-.15(ve)-.4 G .613(rt characters with the eighth bit set to an ASCII k).15 F
.913 -.15(ey s)-.1 H .613(equence by).15 F 1.238
(stripping the eighth bit and prepending an escape character \(in ef)144 571.2
R 1.238(fect, using escape as the)-.25 F F2(meta)3.738 E(pr)144 583.2 Q(e\214x)
-.37 E F0(\).)A F1(output\255meta \(Off\))108 595.2 Q F0 .506(If set to)144
607.2 R F1(On)3.006 E F0 3.006(,r)C .507(eadline will display characters with \
the eighth bit set directly rather than as a meta-)200.744 607.2 R(pre\214x)144
619.2 Q(ed escape sequence.)-.15 E F1(completion\255query\255items \(100\))108
631.2 Q F0 .53(This determines when the user is queried about vie)144 643.2 R
.529(wing the number of possible completions gen-)-.25 F .56(erated by the)144
655.2 R F1(possible\255completions)3.06 E F0 3.06(command. It)3.06 F .561
(may be set to an)3.061 F 3.061(yi)-.15 G(nte)428.196 655.2 Q .561(ger v)-.15 F
.561(alue greater than or)-.25 F .783(equal to zero.)144 667.2 R .783
(If the number of possible completions is greater than or equal to the v)5.783
F .782(alue of this)-.25 F -.25(va)144 679.2 S .237(riable, the user is ask).25
F .237(ed whether or not he wishes to vie)-.1 F 2.737(wt)-.25 G .237
(hem; otherwise the)389.254 679.2 R 2.737(ya)-.15 G .237(re simply listed)
477.855 679.2 R(on the terminal.)144 691.2 Q F1 -.1(ke)108 703.2 S
(ymap \(emacs\)).1 E F0 2.323(Set the current readline k)144 715.2 R -.15(ey)
-.1 G 4.823(map. The).15 F 2.323(set of le)4.823 F -.05(ga)-.15 G 4.823(lk).05
G -.15(ey)368.478 715.2 S 2.323(map names is).15 F F2 2.323
(emacs, emacs-standar)4.823 F(d,)-.37 E .808(emacs-meta, emacs-ctlx, vi, vi-mo)
144 727.2 R(ve)-.1 E 3.308(,v)-.1 G(i-command)300.862 727.2 Q F0 3.308(,a)C(nd)
356.1 727.2 Q F2(vi-insert)3.308 E F0(.).68 E F2(vi)5.808 E F0 .808(is equi)
3.308 F -.25(va)-.25 G .809(lent to).25 F F2(vi-command)3.309 E F0(;)A 184.005
(GNU 1994)72 768 R(July 26)2.5 E(4)535 768 Q EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10
/Times-Italic@0 SF(emacs)144 84 Q F0 1.124(is equi)3.624 F -.25(va)-.25 G 1.124
(lent to).25 F F1(emacs-standar)3.624 E(d)-.37 E F0 6.124(.T)C 1.124(he def)
317.34 84 R 1.124(ault v)-.1 F 1.124(alue is)-.25 F F1(emacs)3.624 E F0 3.624
(;t).27 G 1.124(he v)431.47 84 R 1.123(alue of)-.25 F/F2 10/Times-Bold@0 SF
(editing\255mode)3.623 E F0(also af)144 96 Q(fects the def)-.25 E(ault k)-.1 E
-.15(ey)-.1 G(map.).15 E F2(sho)108 108 Q(w\255all\255if\255ambiguous \(Off\))
-.1 E F0 .477(This alters the def)144 120 R .477(ault beha)-.1 F .477
(vior of the completion functions.)-.2 F .478(If set to)5.478 F F2(on)2.978 E
F0 2.978(,w)C .478(ords which ha)450.326 120 R .778 -.15(ve m)-.2 H(ore).15 E
1.264(than one possible completion cause the matches to be listed immediately \
instead of ringing the)144 132 R(bell.)144 144 Q F2(expand\255tilde \(Off\))108
156 Q F0(If set to)144 168 Q F2(on)2.5 E F0 2.5(,t)C(ilde e)195.39 168 Q
(xpansion is performed when readline attempts w)-.15 E(ord completion.)-.1 E F2
(Conditional Constructs)87 184.8 Q F0 .05(Readline implements a f)108 196.8 R
.05(acility similar in spirit to the conditional compilation features of the C\
 preprocessor)-.1 F 1.49(which allo)108 208.8 R 1.49(ws k)-.25 F 1.79 -.15
(ey b)-.1 H 1.49(indings and v).15 F 1.49
(ariable settings to be performed as the result of tests.)-.25 F 1.49
(There are three)6.49 F(parser directi)108 220.8 Q -.15(ve)-.25 G 2.5(su).15 G
(sed.)180.91 220.8 Q F2($if)108 237.6 Q F0(The)144 237.6 Q F2($if)2.962 E F0
.462(construct allo)2.962 F .463
(ws bindings to be made based on the editing mode, the terminal being used,)
-.25 F .478(or the application using readline.)144 249.6 R .477(The te)5.477 F
.477(xt of the test e)-.15 F .477(xtends to the end of the line; no characters)
-.15 F(are required to isolate it.)144 261.6 Q F2(mode)144 278.4 Q F0(The)180
278.4 Q F2(mode=)3.711 E F0 1.211(form of the)3.711 F F2($if)3.711 E F0
(directi)3.711 E 1.511 -.15(ve i)-.25 H 3.711(su).15 G 1.211
(sed to test whether readline is in emacs or vi)351.628 278.4 R 3.065
(mode. This)180 290.4 R .565(may be used in conjunction with the)3.065 F F2
.565(set k)3.065 F(eymap)-.1 E F0 .565(command, for instance, to)3.065 F .029
(set bindings in the)180 302.4 R F1(emacs-standar)2.529 E(d)-.37 E F0(and)2.529
E F1(emacs-ctlx)2.529 E F0 -.1(ke)2.529 G .029
(ymaps only if readline is starting out)-.05 F(in emacs mode.)180 314.4 Q F2
(term)144 331.2 Q F0(The)180 331.2 Q F2(term=)3.197 E F0 .696
(form may be used to include terminal-speci\214c k)3.197 F .996 -.15(ey b)-.1 H
.696(indings, perhaps to bind).15 F .654(the k)180 343.2 R .954 -.15(ey s)-.1 H
.654(equences output by the terminal').15 F 3.154(sf)-.55 G .654(unction k)
360.138 343.2 R -.15(ey)-.1 G 3.154(s. The).15 F -.1(wo)3.154 G .654
(rd on the right side of).1 F(the)180 355.2 Q F2(=)3.004 E F0 .504
(is tested ag)3.004 F .503
(ainst the full name of the terminal and the portion of the terminal name)-.05
F(before the \214rst)180 367.2 Q F2<ad>2.5 E F0 5(.T)C(his allo)260.13 367.2 Q
(ws)-.25 E F1(sun)2.5 E F0(to match both)2.5 E F1(sun)2.5 E F0(and)2.5 E F1
(sun\255cmd)2.5 E F0 2.5(,f).77 G(or instance.)456.28 367.2 Q F2(application)
144 384 Q F0(The)180 396 Q F2(application)2.772 E F0 .272
(construct is used to include application\255speci\214c settings.)2.772 F .272
(Each program)5.272 F .114(using the readline library sets the)180 408 R F1
.114(application name)2.614 F F0 2.614(,a)C .114
(nd an initialization \214le can test for a)395.052 408 R .5(particular v)180
420 R 3(alue. This)-.25 F .501(could be used to bind k)3 F .801 -.15(ey s)-.1 H
.501(equences to functions useful for a spe-).15 F .397(ci\214c program.)180
432 R -.15(Fo)5.397 G 2.896(ri).15 G .396(nstance, the follo)261.31 432 R .396
(wing command adds a k)-.25 F .696 -.15(ey s)-.1 H .396
(equence that quotes the).15 F(current or pre)180 444 Q(vious w)-.25 E
(ord in Bash:)-.1 E F2($if)180 456 Q F0(bash)2.5 E 2.5(#Q)180 468 S
(uote the current or pre)194.72 468 Q(vious w)-.25 E(ord)-.1 E
("\\C-xq": "\\eb\\"\\ef\\"")180 480 Q F2($endif)180 492 Q($endif)108 508.8 Q F0
(This command, as you sa)9.33 E 2.5(wi)-.15 G 2.5(nt)257.73 508.8 S(he pre)
268.01 508.8 Q(vious e)-.25 E(xample, terminates an)-.15 E F2($if)2.5 E F0
(command.)2.5 E F2($else)108 525.6 Q F0(Commands in this branch of the)144
525.6 Q F2($if)2.5 E F0(directi)2.5 E .3 -.15(ve a)-.25 H(re e).15 E -.15(xe)
-.15 G(cuted if the test f).15 E(ails.)-.1 E/F3 9/Times-Bold@0 SF
(EDITING COMMANDS)72 542.4 Q F0 1.391(The follo)108 554.4 R 1.391
(wing is a list of the names of the commands and the def)-.25 F 1.391(ault k)
-.1 F 1.691 -.15(ey s)-.1 H 1.391(equences to which the).15 F 3.892(ya)-.15 G
(re)532.23 554.4 Q(bound.)108 566.4 Q F2(Commands f)87 583.2 Q(or Mo)-.25 E
(ving)-.1 E(beginning\255of\255line \(C\255a\))108 595.2 Q F0(Mo)144 607.2 Q .3
-.15(ve t)-.15 H 2.5(ot).15 G(he start of the current line.)182.59 607.2 Q F2
(end\255of\255line \(C\255e\))108 619.2 Q F0(Mo)144 631.2 Q .3 -.15(ve t)-.15 H
2.5(ot).15 G(he end of the line.)182.59 631.2 Q F2 -.25(fo)108 643.2 S
(rward\255char \(C\255f\)).25 E F0(Mo)144 655.2 Q .3 -.15(ve f)-.15 H(orw).15 E
(ard a character)-.1 E(.)-.55 E F2(backward\255char \(C\255b\))108 667.2 Q F0
(Mo)144 679.2 Q .3 -.15(ve b)-.15 H(ack a character).15 E(.)-.55 E F2 -.25(fo)
108 691.2 S(rward\255w).25 E(ord \(M\255f\))-.1 E F0(Mo)144 703.2 Q .823 -.15
(ve f)-.15 H(orw).15 E .523(ard to the end of the ne)-.1 F .523(xt w)-.15 F
3.023(ord. W)-.1 F .522(ords are composed of alphanumeric characters \(let-)-.8
F(ters and digits\).)144 715.2 Q 184.005(GNU 1994)72 768 R(July 26)2.5 E(5)535
768 Q EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10
/Times-Bold@0 SF(backward\255w)108 84 Q(ord \(M\255b\))-.1 E F0(Mo)144 96 Q
.748 -.15(ve b)-.15 H .449(ack to the start of this, or the pre).15 F .449
(vious, w)-.25 F 2.949(ord. W)-.1 F .449
(ords are composed of alphanumeric char)-.8 F(-)-.2 E
(acters \(letters and digits\).)144 108 Q F1(clear\255scr)108 120 Q
(een \(C\255l\))-.18 E F0 .993(Clear the screen lea)144 132 R .993
(ving the current line at the top of the screen.)-.2 F -.4(Wi)5.993 G .993
(th an ar).4 F .993(gument, refresh the)-.18 F
(current line without clearing the screen.)144 144 Q F1 -.18(re)108 156 S
(draw\255curr).18 E(ent\255line)-.18 E F0(Refresh the current line.)144 168 Q
(By def)5 E(ault, this is unbound.)-.1 E F1(Commands f)87 184.8 Q
(or Manipulating the History)-.25 E(accept\255line \(Newline, Retur)108 196.8 Q
(n\))-.15 E F0 .857(Accept the line re)144 208.8 R -.05(ga)-.15 G .857
(rdless of where the cursor is.).05 F .857(If this line is non\255empty)5.857 F
3.357(,a)-.65 G .858(dd it to the history)463.228 208.8 R(list. If the line is\
 a modi\214ed history line, then restore the history line to its original stat\
e.)144 220.8 Q F1(pr)108 232.8 Q -.15(ev)-.18 G(ious\255history \(C\255p\)).15
E F0(Fetch the pre)144 244.8 Q(vious command from the history list, mo)-.25 E
(ving back in the list.)-.15 E F1(next\255history \(C\255n\))108 256.8 Q F0
(Fetch the ne)144 268.8 Q(xt command from the history list, mo)-.15 E
(ving forw)-.15 E(ard in the list.)-.1 E F1
(beginning\255of\255history \(M\255<\))108 280.8 Q F0(Mo)144 292.8 Q .3 -.15
(ve t)-.15 H 2.5(ot).15 G(he \214rst line in the history)182.59 292.8 Q(.)-.65
E F1(end\255of\255history \(M\255>\))108 304.8 Q F0(Mo)144 316.8 Q .3 -.15
(ve t)-.15 H 2.5(ot).15 G(he end of the input history)182.59 316.8 Q 2.5(,i)
-.65 G(.e., the line currently being entered.)294.99 316.8 Q F1 -2.29 -.18
(re v)108 328.8 T(erse\255sear).08 E(ch\255history \(C\255r\))-.18 E F0 1.471
(Search backw)144 340.8 R 1.471(ard starting at the current line and mo)-.1 F
1.47(ving `up' through the history as necessary)-.15 F(.)-.65 E
(This is an incremental search.)144 352.8 Q F1 -.25(fo)108 364.8 S
(rward\255sear).25 E(ch\255history \(C\255s\))-.18 E F0 1.131(Search forw)144
376.8 R 1.131(ard starting at the current line and mo)-.1 F 1.132(ving `do)-.15
F 1.132(wn' through the history as necessary)-.25 F(.)-.65 E
(This is an incremental search.)144 388.8 Q F1(non\255incr)108 400.8 Q
(emental\255r)-.18 E -2.3 -.15(ev e)-.18 H(rse\255sear).15 E
(ch\255history \(M\255p\))-.18 E F0 1.089(Search backw)144 412.8 R 1.088(ard t\
hrough the history starting at the current line using a non\255incremental sea\
rch)-.1 F(for a string supplied by the user)144 424.8 Q(.)-.55 E F1
(non\255incr)108 436.8 Q(emental\255f)-.18 E(orward\255sear)-.25 E
(ch\255history \(M\255n\))-.18 E F0 1.188(Search forw)144 448.8 R 1.189(ard th\
rough the history using a non\255incremental search for a string supplied by t\
he)-.1 F(user)144 460.8 Q(.)-.55 E F1(history\255sear)108 472.8 Q(ch\255f)-.18
E(orward)-.25 E F0 .249(Search forw)144 484.8 R .249(ard through the history f\
or the string of characters between the start of the current line)-.1 F
(and the current point.)144 496.8 Q(This is a non-incremental search.)5 E
(By def)5 E(ault, this command is unbound.)-.1 E F1(history\255sear)108 508.8 Q
(ch\255backward)-.18 E F0 .95(Search backw)144 520.8 R .951(ard through the hi\
story for the string of characters between the start of the current)-.1 F 2.721
(line and the current point.)144 532.8 R 2.721
(This is a non-incremental search.)7.721 F 2.72(By def)7.721 F 2.72
(ault, this command is)-.1 F(unbound.)144 544.8 Q F1(yank\255nth\255ar)108
556.8 Q 2.5(g\()-.1 G<4dad43ad7929>175.14 556.8 Q F0 .622
(Insert the \214rst ar)144 568.8 R .622(gument to the pre)-.18 F .622
(vious command \(usually the second w)-.25 F .622(ord on the pre)-.1 F .622
(vious line\))-.25 F .682(at point \(the current cursor position\).)144 580.8 R
-.4(Wi)5.682 G .682(th an ar).4 F(gument)-.18 E/F2 10/Times-Italic@0 SF(n)3.182
E F0 3.182(,i).24 G .682(nsert the)390.17 580.8 R F2(n)3.182 E F0 .682(th w)B
.681(ord from the pre)-.1 F(vious)-.25 E .729(command \(the w)144 592.8 R .729
(ords in the pre)-.1 F .729(vious command be)-.25 F .729(gin with w)-.15 F .729
(ord 0\).)-.1 F 3.23(An)5.73 G -2.25 -.15(eg a)441.56 592.8 T(ti).15 E 1.03
-.15(ve a)-.25 H -.18(rg).15 G .73(ument inserts).18 F(the)144 604.8 Q F2(n)2.5
E F0(th w)A(ord from the end of the pre)-.1 E(vious command.)-.25 E F1
(yank\255last\255ar)108 616.8 Q 2.5(g\()-.1 G -1.667(M\255. ,)175.69 616.8 R
-1.667(M\255_ \))2.5 F F0 1.077(Insert the last ar)144 628.8 R 1.077
(gument to the pre)-.18 F 1.077(vious command \(the last w)-.25 F 1.077
(ord on the pre)-.1 F 1.077(vious line\).)-.25 F -.4(Wi)6.076 G 1.076(th an).4
F(ar)144 640.8 Q(gument, beha)-.18 E .3 -.15(ve ex)-.2 H(actly lik).15 E(e)-.1
E F1(yank-nth-ar)2.5 E(g)-.1 E F0(.)A F1(Commands f)87 657.6 Q(or Changing T)
-.25 E(ext)-.92 E(delete\255char \(C\255d\))108 669.6 Q F0 .486
(Delete the character under the cursor)144 681.6 R 5.486(.I)-.55 G 2.987(fp)
304.636 681.6 S .487(oint is at the be)315.953 681.6 R .487
(ginning of the line, there are no charac-)-.15 F
(ters in the line, and the last character typed w)144 693.6 Q(as not)-.1 E F1
(C\255d)2.5 E F0 2.5(,t)C(hen return)377.34 693.6 Q/F3 9/Times-Bold@0 SF(EOF)
2.5 E/F4 9/Times-Roman@0 SF(.)A F1(backward\255delete\255char \(Rubout\))108
705.6 Q F0 .553(Delete the character behind the cursor)144 717.6 R 5.553(.W)
-.55 G .553(hen gi)315.598 717.6 R -.15(ve)-.25 G 3.053(nan).15 G .553
(umeric ar)370.457 717.6 R .552(gument, sa)-.18 F .852 -.15(ve t)-.2 H .552
(he deleted te).15 F .552(xt on)-.15 F(the kill\255ring.)144 729.6 Q 184.005
(GNU 1994)72 768 R(July 26)2.5 E(6)535 768 Q EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10
/Times-Bold@0 SF(quoted\255insert \(C\255q, C\255v\))108 84 Q F0 1.228
(Add the ne)144 96 R 1.228(xt character that you type to the line v)-.15 F
3.728(erbatim. This)-.15 F 1.228(is ho)3.728 F 3.729(wt)-.25 G 3.729(oi)446.163
96 S 1.229(nsert characters lik)457.672 96 R(e)-.1 E F1(C\255q)144 108 Q F0 2.5
(,f)C(or e)170.81 108 Q(xample.)-.15 E F1(tab\255insert \(M-T)108 120 Q(AB\))
-.9 E F0(Insert a tab character)144 132 Q(.)-.55 E F1
(self\255insert \(a, b, A, 1, !, ...\))108 144 Q F0
(Insert the character typed.)144 156 Q F1(transpose\255chars \(C\255t\))108 168
Q F0 .424(Drag the character before point forw)144 180 R .424(ard o)-.1 F -.15
(ve)-.15 G 2.924(rt).15 G .424(he character at point.)331.218 180 R .424
(Point mo)5.424 F -.15(ve)-.15 G 2.924(sf).15 G(orw)477.882 180 Q .424
(ard as well.)-.1 F 1.03
(If point is at the end of the line, then transpose the tw)144 192 R 3.531(oc)
-.1 G 1.031(haracters before point.)382.266 192 R(Ne)6.031 E -.05(ga)-.15 G(ti)
.05 E 1.331 -.15(ve a)-.25 H -.18(rg).15 G(u-).18 E(ments don')144 204 Q 2.5
(tw)-.18 G(ork.)200.94 204 Q F1(transpose\255w)108 216 Q(ords \(M\255t\))-.1 E
F0 .683(Drag the w)144 228 R .682(ord behind the cursor past the w)-.1 F .682
(ord in front of the cursor mo)-.1 F .682(ving the cursor o)-.15 F -.15(ve)-.15
G 3.182(rt).15 G(hat)527.78 228 Q -.1(wo)144 240 S(rd as well.).1 E F1
(upcase\255w)108 252 Q(ord \(M\255u\))-.1 E F0 .702
(Uppercase the current \(or follo)144 264 R .702(wing\) w)-.25 F 3.202(ord. W)
-.1 F .702(ith a ne)-.4 F -.05(ga)-.15 G(ti).05 E 1.002 -.15(ve a)-.25 H -.18
(rg).15 G .702(ument, do the pre).18 F .703(vious w)-.25 F .703(ord, b)-.1 F
(ut)-.2 E(do not mo)144 276 Q .3 -.15(ve p)-.15 H(oint.).15 E F1(do)108 288 Q
(wncase\255w)-.1 E(ord \(M\255l\))-.1 E F0(Lo)144 300 Q .641
(wercase the current \(or follo)-.25 F .641(wing\) w)-.25 F 3.141(ord. W)-.1 F
.641(ith a ne)-.4 F -.05(ga)-.15 G(ti).05 E .941 -.15(ve a)-.25 H -.18(rg).15 G
.64(ument, do the pre).18 F .64(vious w)-.25 F .64(ord, b)-.1 F(ut)-.2 E
(do not mo)144 312 Q .3 -.15(ve p)-.15 H(oint.).15 E F1(capitalize\255w)108 324
Q(ord \(M\255c\))-.1 E F0 .82(Capitalize the current \(or follo)144 336 R .82
(wing\) w)-.25 F 3.32(ord. W)-.1 F .82(ith a ne)-.4 F -.05(ga)-.15 G(ti).05 E
1.12 -.15(ve a)-.25 H -.18(rg).15 G .82(ument, do the pre).18 F .82(vious w)
-.25 F .82(ord, b)-.1 F(ut)-.2 E(do not mo)144 348 Q .3 -.15(ve p)-.15 H(oint.)
.15 E F1(Killing and Y)87 364.8 Q(anking)-.85 E(kill\255line \(C\255k\))108
376.8 Q F0(Kill the te)144 388.8 Q
(xt from the current cursor position to the end of the line.)-.15 E F1
(backward\255kill\255line \(C\255x Rubout\))108 400.8 Q F0(Kill backw)144 412.8
Q(ard to the be)-.1 E(ginning of the line.)-.15 E F1
(unix\255line\255discard \(C\255u\))108 424.8 Q F0(Kill backw)144 436.8 Q
(ard from point to the be)-.1 E(ginning of the line.)-.15 E F1
(kill\255whole\255line)108 448.8 Q F0
(Kill all characters on the current line, no matter where the cursor is.)144
460.8 Q(By def)5 E(ault, this is unbound.)-.1 E F1(kill\255w)108 472.8 Q
(ord \(M\255d\))-.1 E F0 1.044
(Kill from the cursor to the end of the current w)144 484.8 R 1.043
(ord, or if between w)-.1 F 1.043(ords, to the end of the ne)-.1 F(xt)-.15 E
-.1(wo)144 496.8 S 2.5(rd. W).1 F(ord boundaries are the same as those used by)
-.8 E F1 -.25(fo)2.5 G(rward\255w).25 E(ord)-.1 E F0(.)A F1
(backward\255kill\255w)108 508.8 Q(ord \(M\255Rubout\))-.1 E F0 3.26
(Kill the w)144 520.8 R 3.26(ord behind the cursor)-.1 F 8.26(.W)-.55 G 3.26
(ord boundaries are the same as those used by)304.31 520.8 R F1(back-)5.76 E
(ward\255w)144 532.8 Q(ord)-.1 E F0(.)A F1(unix\255w)108 544.8 Q
(ord\255rubout \(C\255w\))-.1 E F0 .482(Kill the w)144 556.8 R .482
(ord behind the cursor)-.1 F 2.982(,u)-.4 G .482(sing white space as a w)
281.652 556.8 R .482(ord boundary)-.1 F 5.482(.T)-.65 G .482(he w)445.076 556.8
R .481(ord boundaries are)-.1 F(dif)144 568.8 Q(ferent from)-.25 E F1
(backward\255kill\255w)2.5 E(ord)-.1 E F0(.)A F1(delete\255horizontal\255space)
108 580.8 Q F0(Delete all spaces and tabs around point.)144 592.8 Q(By def)5 E
(ault, this is unbound.)-.1 E F1(yank \(C\255y\))108 604.8 Q F0 -1(Ya)144 616.8
S(nk the top of the kill ring into the b)1 E(uf)-.2 E(fer at the cursor)-.25 E
(.)-.55 E F1(yank\255pop \(M\255y\))108 628.8 Q F0
(Rotate the kill\255ring, and yank the ne)144 640.8 Q 2.5(wt)-.25 G 2.5
(op. Only)302.71 640.8 R -.1(wo)2.5 G(rks follo).1 E(wing)-.25 E F1(yank)2.5 E
F0(or)2.5 E F1(yank\255pop)2.5 E F0(.)A F1(Numeric Ar)87 657.6 Q(guments)-.1 E
(digit\255ar)108 669.6 Q(gument \(M\2550, M\2551, ..., M\255\255\))-.1 E F0
.641(Add this digit to the ar)144 681.6 R .641
(gument already accumulating, or start a ne)-.18 F 3.141(wa)-.25 G -.18(rg)
425.942 681.6 S 3.142(ument. M\255\255).18 F .642(starts a ne)3.142 F(g-)-.15 E
(ati)144 693.6 Q .3 -.15(ve a)-.25 H -.18(rg).15 G(ument.).18 E F1(uni)108
705.6 Q -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1 E F0 .783(Each time this is e)
144 717.6 R -.15(xe)-.15 G .783(cuted, the ar).15 F .782
(gument count is multiplied by four)-.18 F 5.782(.T)-.55 G .782(he ar)437.062
717.6 R .782(gument count is ini-)-.18 F .175(tially one, so e)144 729.6 R -.15
(xe)-.15 G .175(cuting this function the \214rst time mak).15 F .176(es the ar)
-.1 F .176(gument count four)-.18 F 5.176(.B)-.55 G 2.676(yd)485.028 729.6 S
(ef)497.704 729.6 Q .176(ault, this)-.1 F 184.005(GNU 1994)72 768 R(July 26)2.5
E(7)535 768 Q EP
%%Page: 8 8
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R
(is not bound to a k)144 84 Q -.15(ey)-.1 G(.)-.5 E/F1 10/Times-Bold@0 SF
(Completing)87 100.8 Q(complete \(T)108 112.8 Q(AB\))-.9 E F0 1.909
(Attempt to perform completion on the te)144 124.8 R 1.908(xt before point.)
-.15 F 1.908(The actual completion performed is)6.908 F
(application-speci\214c.)144 136.8 Q F1(Bash)5.517 E F0 3.017(,f)C .518
(or instance, attempts completion treating the te)260.304 136.8 R .518
(xt as a v)-.15 F .518(ariable \(if the)-.25 F(te)144 148.8 Q .657(xt be)-.15 F
.657(gins with)-.15 F F1($)3.156 E F0 .656(\), username \(if the te)B .656
(xt be)-.15 F .656(gins with)-.15 F F1(~)3.156 E F0 .656
(\), hostname \(if the te)B .656(xt be)-.15 F .656(gins with)-.15 F F1(@)3.156
E F0 .656(\), or)B .929(command \(including aliases and functions\) in turn.)
144 160.8 R .93(If none of these produces a match, \214lename)5.929 F 1.274
(completion is attempted.)144 172.8 R F1(Gdb)6.273 E F0 3.773(,o)C 3.773(nt)
281.603 172.8 S 1.273(he other hand, allo)293.156 172.8 R 1.273
(ws completion of program functions and)-.25 F -.25(va)144 184.8 S
(riables, and only attempts \214lename completion under certain circumstances.)
.25 E F1(possible\255completions \(M-?\))108 196.8 Q F0
(List the possible completions of the te)144 208.8 Q(xt before point.)-.15 E F1
(insert\255completions)108 220.8 Q F0 3.372(Insert all completions of the te)
144 232.8 R 3.372(xt before point that w)-.15 F 3.372(ould ha)-.1 F 3.672 -.15
(ve b)-.2 H 3.372(een generated by).15 F F1(possi-)5.873 E(ble\255completions)
144 244.8 Q F0 5(.B)C 2.5(yd)227.76 244.8 S(ef)240.26 244.8 Q
(ault, this is not bound to a k)-.1 E -.15(ey)-.1 G(.)-.5 E F1 -.25(Ke)87 261.6
S(yboard Macr).25 E(os)-.18 E(start\255kbd\255macr)108 273.6 Q 2.5(o\()-.18 G
(C-x \()188.93 273.6 Q(\)).833 E F0(Be)144 285.6 Q(gin sa)-.15 E
(ving the characters typed into the current k)-.2 E -.15(ey)-.1 G(board macro.)
.15 E F1(end\255kbd\255macr)108 297.6 Q 2.5(o\()-.18 G(C-x \))184.5 297.6 Q(\))
.833 E F0(Stop sa)144 309.6 Q(ving the characters typed into the current k)-.2
E -.15(ey)-.1 G(board macro and sa).15 E .3 -.15(ve t)-.2 H(he de\214nition.)
.15 E F1(call\255last\255kbd\255macr)108 321.6 Q 2.5(o\()-.18 G(C-x e\))204.64
321.6 Q F0(Re-e)144 333.6 Q -.15(xe)-.15 G 1(cute the last k).15 F -.15(ey)-.1
G .999
(board macro de\214ned, by making the characters in the macro appear as if).15
F(typed at the k)144 345.6 Q -.15(ey)-.1 G(board.).15 E F1(Miscellaneous)87
362.4 Q -.18(re)108 374.4 S(-r).18 E(ead-init-\214le \(C\255x C\255r\))-.18 E
F0 .54(Read in the contents of your init \214le, and incorporate an)144 386.4 R
3.041(yb)-.15 G .541(indings or v)385.876 386.4 R .541
(ariable assignments found)-.25 F(there.)144 398.4 Q F1(abort \(C\255g\))108
410.4 Q F0 3.249(Abort the current editing command and ring the terminal')144
422.4 R 5.748(sb)-.55 G 3.248(ell \(subject to the setting of)414.6 422.4 R F1
(bell\255style)144 434.4 Q F0(\).)A F1(do\255upper)108 446.4 Q(case\255v)-.18 E
(ersion \(M\255a, M\255b, ...\))-.1 E F0
(Run the command that is bound to the corresponding uppercase character)144
458.4 Q(.)-.55 E F1(pr)108 470.4 Q(e\214x\255meta \(ESC\))-.18 E F0
(Metafy the ne)144 482.4 Q(xt character typed.)-.15 E/F2 9/Times-Bold@0 SF(ESC)
5 E F1(f)2.25 E F0(is equi)2.5 E -.25(va)-.25 G(lent to).25 E F1(Meta\255f)2.5
E F0(.)A F1(undo \(C\255_, C\255x C\255u\))108 494.4 Q F0
(Incremental undo, separately remembered for each line.)144 506.4 Q F1 -2.29
-.18(re v)108 518.4 T(ert\255line \(M\255r\)).08 E F0 .244
(Undo all changes made to this line.)144 530.4 R .245(This is lik)5.245 F 2.745
(et)-.1 G .245(yping the)341.895 530.4 R F1(undo)2.745 E F0 .245
(command enough times to return)2.745 F(the line to its initial state.)144
542.4 Q F1(tilde\255expand \(M\255~\))108 554.4 Q F0(Perform tilde e)144 566.4
Q(xpansion on the current w)-.15 E(ord.)-.1 E F1(dump\255functions)108 578.4 Q
F0 .627(Print all of the functions and their k)144 590.4 R .927 -.15(ey b)-.1 H
.626(indings to the readline output stream.).15 F .626(If a numeric ar)5.626 F
(gu-)-.18 E(ment is supplied, the output is formatted in such a w)144 602.4 Q
(ay that it can be made part of an)-.1 E/F3 10/Times-Italic@0 SF(inputr)2.5 E
(c)-.37 E F0(\214le.)2.5 E F1(emacs\255editing\255mode \(C\255e\))108 614.4 Q
F0(When in)144 626.4 Q F1(vi)2.5 E F0(editing mode, this causes a switch to)2.5
E F1(emacs)2.5 E F0(editing mode.)2.5 E F1
(vi\255editing\255mode \(M\255C\255j\))108 638.4 Q F0(When in)144 650.4 Q F1
(emacs)2.5 E F0(editing mode, this causes a switch to)2.5 E F1(vi)2.5 E F0
(editing mode.)2.5 E F2(DEF)72 667.2 Q -.45(AU)-.81 G 1.656 -.828(LT K).45 H
(EY BINDINGS).828 E F0 .675(The follo)108 679.2 R .675
(wing is a list of the def)-.25 F .675(ault emacs and vi bindings.)-.1 F .676
(Characters with the 8th bit set are written as)5.676 F .002
(M-<character>, and are referred to as)108 691.2 R F3(meta\214ed)2.502 E F0
2.502(characters. The)2.502 F .002(printable ASCII characters not mentioned in)
2.502 F .444(the list of emacs standard bindings are bound to the)108 703.2 R
F3(self\255insert)2.945 E F0 .445(function, which just inserts the gi)2.945 F
-.15(ve)-.25 G 2.945(nc).15 G(har)524.1 703.2 Q(-)-.2 E 2.021
(acter into the input line.)108 715.2 R 2.02(In vi insertion mode, all charact\
ers not speci\214cally mentioned are bound to)7.021 F F3(self\255insert)108
727.2 Q F0 5.388(.C).68 G .388(haracters assigned to signal generation by)
166.658 727.2 R F3(stty)2.889 E F0 .389(\(1\) or the terminal dri).32 F -.15
(ve)-.25 G 1.189 -.4(r, s).15 H .389(uch as C-Z or C-C,).4 F 184.005(GNU 1994)
72 768 R(July 26)2.5 E(8)535 768 Q EP
%%Page: 9 9
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R .221
(retain that function.)108 84 R .221(Upper and lo)5.221 F .221(wer case)-.25 F
/F1 10/Times-Italic@0 SF(meta\214ed)2.721 E F0 .22
(characters are bound to the same function in the emacs)2.721 F .304
(mode meta k)108 96 R -.15(ey)-.1 G 2.804(map. The).15 F .305(remaining charac\
ters are unbound, which causes readline to ring the bell \(subject)2.804 F
(to the setting of the)108 108 Q/F2 10/Times-Bold@0 SF(bell\255style)2.5 E F0
-.25(va)2.5 G(riable\).).25 E F2(Emacs Mode)87 124.8 Q F0
(Emacs Standard bindings)151.2 136.8 Q 152.12("C-A" ->)151.2 160.8 R(be)5 E
(ginning-of-line)-.15 E 152.67("C-B" ->)151.2 172.8 R(backw)5 E(ard-char)-.1 E
152.12("C-D" ->)151.2 184.8 R(delete-char)5 E 153.23("C-E" ->)151.2 196.8 R
(end-of-line)5 E 153.78("C-F" ->)151.2 208.8 R(forw)5 E(ard-char)-.1 E 152.12
("C-G" ->)151.2 220.8 R(abort)5 E 152.12("C-H" ->)151.2 232.8 R(backw)5 E
(ard-delete-char)-.1 E 156.01("C-I" ->)151.2 244.8 R(complete)5 E 155.45
("C-J" ->)151.2 256.8 R(accept-line)5 E 152.12("C-K" ->)151.2 268.8 R
(kill-line)5 E 153.23("C-L" ->)151.2 280.8 R(clear)5 E(-screen)-.2 E 150.45
("C-M" ->)151.2 292.8 R(accept-line)5 E 152.12("C-N" ->)151.2 304.8 R(ne)5 E
(xt-history)-.15 E 153.78("C-P" ->)151.2 316.8 R(pre)5 E(vious-history)-.25 E
152.12("C-Q" ->)151.2 328.8 R(quoted-insert)5 E 152.67("C-R" ->)151.2 340.8 R
(re)5 E -.15(ve)-.25 G(rse-search-history).15 E 153.78("C-S" ->)151.2 352.8 R
(forw)5 E(ard-search-history)-.1 E 153.23("C-T" ->)151.2 364.8 R
(transpose-chars)5 E 152.12("C-U" ->)151.2 376.8 R(unix-line-discard)5 E 152.12
("C-V" ->)151.2 388.8 R(quoted-insert)5 E 149.9("C-W" ->)151.2 400.8 R(unix-w)5
E(ord-rubout)-.1 E 152.12("C-Y" ->)151.2 412.8 R(yank)5 E 154.34("C-_" ->)151.2
424.8 R(undo)5 E 3.333("")151.2 436.8 S(to "/")-.833 E 2.5(-> self-insert)331.2
436.8 R 2.5("0" to)151.2 448.8 R 135.9("9" ->)2.5 F(self-insert)5 E 2.5(":" to)
151.2 460.8 R 139.79("~" ->)2.5 F(self-insert)5 E 154.9("C-?" ->)151.2 472.8 R
(backw)5 E(ard-delete-char)-.1 E(Emacs Meta bindings)151.2 489.6 Q 139.9
("M-C-H" ->)151.2 513.6 R(backw)5 E(ard-kill-w)-.1 E(ord)-.1 E 143.79
("M-C-I" ->)151.2 525.6 R(tab-insert)5 E 143.23("M-C-J" ->)151.2 537.6 R
(vi-editing-mode)5 E 138.23("M-C-M" ->)151.2 549.6 R(vi-editing-mode)5 E 140.45
("M-C-R" ->)151.2 561.6 R(re)5 E -.15(ve)-.25 G(rt-line).15 E 139.9("M-C-Y" ->)
151.2 573.6 R(yank-nth-ar)5 E(g)-.18 E 143.79("M-C-[" ->)151.2 585.6 R
(complete)5 E 149.34("M-&" ->)151.2 597.6 R(tilde-e)5 E(xpand)-.15 E 153.79
("M--" ->)151.2 609.6 R(digit-ar)5 E(gument)-.18 E 152.12("M-0" ->)151.2 621.6
R(digit-ar)5 E(gument)-.18 E 152.12("M-1" ->)151.2 633.6 R(digit-ar)5 E(gument)
-.18 E 152.12("M-2" ->)151.2 645.6 R(digit-ar)5 E(gument)-.18 E 152.12
("M-3" ->)151.2 657.6 R(digit-ar)5 E(gument)-.18 E 152.12("M-4" ->)151.2 669.6
R(digit-ar)5 E(gument)-.18 E 152.12("M-5" ->)151.2 681.6 R(digit-ar)5 E(gument)
-.18 E 152.12("M-6" ->)151.2 693.6 R(digit-ar)5 E(gument)-.18 E 152.12
("M-7" ->)151.2 705.6 R(digit-ar)5 E(gument)-.18 E 152.12("M-8" ->)151.2 717.6
R(digit-ar)5 E(gument)-.18 E 152.12("M-9" ->)151.2 729.6 R(digit-ar)5 E(gument)
-.18 E 184.005(GNU 1994)72 768 R(July 26)2.5 E(9)535 768 Q EP
%%Page: 10 10
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R 151.48
("M-<" ->)151.2 84 R(be)5 E(ginning-of-history)-.15 E 151.48("M->" ->)151.2 96
R(end-of-history)5 E 152.68("M-?" ->)151.2 108 R(possible-completions)5 E
150.45("M-B" ->)151.2 120 R(backw)5 E(ard-w)-.1 E(ord)-.1 E 150.45("M-C" ->)
151.2 132 R(capitalize-w)5 E(ord)-.1 E 149.9("M-D" ->)151.2 144 R(kill-w)5 E
(ord)-.1 E 151.56("M-F" ->)151.2 156 R(forw)5 E(ard-w)-.1 E(ord)-.1 E 151.01
("M-L" ->)151.2 168 R(do)5 E(wncase-w)-.25 E(ord)-.1 E 149.9("M-N" ->)151.2 180
R(non-incremental-forw)5 E(ard-search-history)-.1 E 149.9("M-O" ->)151.2 192 R
(arro)5 E(w-k)-.25 E -.15(ey)-.1 G(-pre\214x).15 E 151.56("M-P" ->)151.2 204 R
(non-incremental-re)5 E -.15(ve)-.25 G(rse-search-history).15 E 150.45
("M-R" ->)151.2 216 R(re)5 E -.15(ve)-.25 G(rt-line).15 E 151.01("M-T" ->)151.2
228 R(transpose-w)5 E(ords)-.1 E 149.9("M-U" ->)151.2 240 R(upcase-w)5 E(ord)
-.1 E 149.9("M-Y" ->)151.2 252 R(yank-pop)5 E 139.9("M-C-Y" ->)151.2 264 R
(yank-nth-ar)5 E(g)-.18 E 142.68("M-C-?" ->)151.2 276 R(backw)5 E(ard-delete-w)
-.1 E(ord)-.1 E(Emacs Control-X bindings)151.2 292.8 Q 134.9("C-XC-G" ->)151.2
316.8 R(abort)5 E 135.45("C-XC-R" ->)151.2 328.8 R(re-read-init-\214le)5 E
134.9("C-XC-U" ->)151.2 340.8 R(undo)5 E 148.79("C-X\(" ->)151.2 352.8 R
(start-kbd-macro)5 E 148.79("C-X\)" ->)151.2 364.8 R(end-kbd-macro)5 E 147.68
("C-Xe" ->)151.2 376.8 R(call-last-kbd-macro)5 E 137.68("C-XC-?" ->)151.2 388.8
R(backw)5 E(ard-kill-line)-.1 E/F1 10/Times-Bold@0 SF(VI Mode bindings)87 417.6
Q F0(VI Insert Mode functions)151.2 429.6 Q 152.12("C-D" ->)151.2 453.6 R
(vi-eof-maybe)5 E 152.12("C-H" ->)151.2 465.6 R(backw)5 E(ard-delete-char)-.1 E
156.01("C-I" ->)151.2 477.6 R(complete)5 E 155.45("C-J" ->)151.2 489.6 R
(accept-line)5 E 152.12("C-K" ->)151.2 501.6 R(kill-line)5 E 153.23("C-L" ->)
151.2 513.6 R(clear)5 E(-screen)-.2 E 150.45("C-M" ->)151.2 525.6 R
(accept-line)5 E 152.12("C-N" ->)151.2 537.6 R(ne)5 E(xt-history)-.15 E 153.78
("C-P" ->)151.2 549.6 R(pre)5 E(vious-history)-.25 E 152.12("C-Q" ->)151.2
561.6 R(quoted-insert)5 E 152.67("C-R" ->)151.2 573.6 R(re)5 E -.15(ve)-.25 G
(rse-search-history).15 E 153.78("C-S" ->)151.2 585.6 R(forw)5 E
(ard-search-history)-.1 E 153.23("C-T" ->)151.2 597.6 R(transpose-chars)5 E
152.12("C-U" ->)151.2 609.6 R(unix-line-discard)5 E 152.12("C-V" ->)151.2 621.6
R(quoted-insert)5 E 149.9("C-W" ->)151.2 633.6 R(unix-w)5 E(ord-rubout)-.1 E
152.12("C-Y" ->)151.2 645.6 R(yank)5 E 156.01("C-[" ->)151.2 657.6 R(vi-mo)5 E
-.15(ve)-.15 G(ment-mode).15 E 3.333("")151.2 669.6 S(to "~")-.833 E 2.5
(-> self-insert)331.2 669.6 R 154.9("C-?" ->)151.2 681.6 R(backw)5 E
(ard-delete-char)-.1 E(VI Command Mode functions)151.2 698.4 Q 152.12("C-D" ->)
151.2 722.4 R(vi-eof-maybe)5 E 184.005(GNU 1994)72 768 R(July 26)2.5 E(10)530
768 Q EP
%%Page: 11 11
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R 153.23
("C-E" ->)151.2 84 R(emacs-editing-mode)5 E 152.12("C-G" ->)151.2 96 R(abort)5
E 152.12("C-H" ->)151.2 108 R(backw)5 E(ard-char)-.1 E 155.45("C-J" ->)151.2
120 R(accept-line)5 E 152.12("C-K" ->)151.2 132 R(kill-line)5 E 153.23
("C-L" ->)151.2 144 R(clear)5 E(-screen)-.2 E 150.45("C-M" ->)151.2 156 R
(accept-line)5 E 152.12("C-N" ->)151.2 168 R(ne)5 E(xt-history)-.15 E 153.78
("C-P" ->)151.2 180 R(pre)5 E(vious-history)-.25 E 152.12("C-Q" ->)151.2 192 R
(quoted-insert)5 E 152.67("C-R" ->)151.2 204 R(re)5 E -.15(ve)-.25 G
(rse-search-history).15 E 153.78("C-S" ->)151.2 216 R(forw)5 E
(ard-search-history)-.1 E 153.23("C-T" ->)151.2 228 R(transpose-chars)5 E
152.12("C-U" ->)151.2 240 R(unix-line-discard)5 E 152.12("C-V" ->)151.2 252 R
(quoted-insert)5 E 149.9("C-W" ->)151.2 264 R(unix-w)5 E(ord-rubout)-.1 E
152.12("C-Y" ->)151.2 276 R(yank)5 E 156.01("C-[" ->)151.2 288 R(abort)5 E
159.341 3.333("" -)151.2 300 T 5(>f)334.53 300 S(orw)348.5 300 Q(ard-char)-.1 E
164.34("#" ->)151.2 312 R(vi-comment)5 E 164.34("$" ->)151.2 324 R(end-of-line)
5 E 161.01("%" ->)151.2 336 R(vi-match)5 E 161.56("&" ->)151.2 348 R
(vi-tilde-e)5 E(xpand)-.15 E 164.34("*" ->)151.2 360 R(vi-complete)5 E 163.7
("+" ->)151.2 372 R(do)5 E(wn-history)-.25 E 166.84("," ->)151.2 384 R(vi-char)
5 E(-search)-.2 E 166.01("-" ->)151.2 396 R(pre)5 E(vious-history)-.25 E 166.84
("." ->)151.2 408 R(vi-redo)5 E 166.56("/" ->)151.2 420 R(vi-search)5 E 164.34
("0" ->)151.2 432 R(be)5 E(ginning-of-line)-.15 E("1" to "9")151.2 444 Q 2.5
(-> vi-ar)331.2 444 R(g-digit)-.18 E 166.56(";" ->)151.2 456 R(vi-char)5 E
(-search)-.2 E 163.7("=" ->)151.2 468 R(vi-complete)5 E 164.9("?" ->)151.2 480
R(vi-search)5 E 160.13("@" ->)151.2 492 R(is unde\214ned)5 E 162.12("A" ->)
151.2 504 R(vi-append-eol)5 E 162.67("B" ->)151.2 516 R(vi-pre)5 E(v-w)-.25 E
(ord)-.1 E 162.67("C" ->)151.2 528 R(vi-change-to)5 E 162.12("D" ->)151.2 540 R
(vi-delete-to)5 E 163.23("E" ->)151.2 552 R(vi-end-w)5 E(ord)-.1 E 163.78
("F" ->)151.2 564 R(vi-char)5 E(-search)-.2 E 166.01("I" ->)151.2 576 R
(vi-insert-be)5 E(g)-.15 E 162.12("N" ->)151.2 588 R(vi-search-ag)5 E(ain)-.05
E 163.78("P" ->)151.2 600 R(vi-put)5 E 162.67("R" ->)151.2 612 R(vi-replace)5 E
163.78("S" ->)151.2 624 R(vi-subst)5 E 163.23("T" ->)151.2 636 R(vi-char)5 E
(-search)-.2 E 162.12("U" ->)151.2 648 R(re)5 E -.15(ve)-.25 G(rt-line).15 E
159.9("W" ->)151.2 660 R(vi-ne)5 E(xt-w)-.15 E(ord)-.1 E 162.12("X" ->)151.2
672 R(backw)5 E(ard-delete-char)-.1 E 162.12("Y" ->)151.2 684 R(vi-yank-to)5 E
166.56("\\" ->)151.2 696 R(vi-complete)5 E 166.01("^" ->)151.2 708 R
(vi-\214rst-print)5 E 164.34("_" ->)151.2 720 R(vi-yank-ar)5 E(g)-.18 E 184.005
(GNU 1994)72 768 R(July 26)2.5 E(11)530 768 Q EP
%%Page: 12 12
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R 164.9("a" ->)
151.2 84 R(vi-append-mode)5 E 164.34("b" ->)151.2 96 R(vi-pre)5 E(v-w)-.25 E
(ord)-.1 E 164.9("c" ->)151.2 108 R(vi-change-to)5 E 164.34("d" ->)151.2 120 R
(vi-delete-to)5 E 164.9("e" ->)151.2 132 R(vi-end-w)5 E(ord)-.1 E 166.01
("f" ->)151.2 144 R(vi-char)5 E(-search)-.2 E 164.34("h" ->)151.2 156 R(backw)5
E(ard-char)-.1 E 166.56("i" ->)151.2 168 R(vi-insertion-mode)5 E 166.56("j" ->)
151.2 180 R(ne)5 E(xt-history)-.15 E 164.34("k" ->)151.2 192 R(pre)5 E
(v-history)-.25 E 166.56("l" ->)151.2 204 R(forw)5 E(ard-char)-.1 E 164.34
("n" ->)151.2 216 R(vi-search-ag)5 E(ain)-.05 E 166.01("r" ->)151.2 228 R
(vi-change-char)5 E 165.45("s" ->)151.2 240 R(vi-subst)5 E 166.56("t" ->)151.2
252 R(vi-char)5 E(-search)-.2 E 164.34("u" ->)151.2 264 R(undo)5 E 162.12
("w" ->)151.2 276 R(vi-ne)5 E(xt-w)-.15 E(ord)-.1 E 164.34("x" ->)151.2 288 R
(vi-delete)5 E 164.34("y" ->)151.2 300 R(vi-yank-to)5 E 167.34("|" ->)151.2 312
R(vi-column)5 E 166.01("~" ->)151.2 324 R(vi-change-case)5 E/F1 9/Times-Bold@0
SF(SEE ALSO)72 340.8 Q/F2 10/Times-Italic@0 SF(The Gnu Readline Libr)108 352.8
Q(ary)-.15 E F0 2.5(,B)C(rian F)225.35 352.8 Q(ox and Chet Rame)-.15 E(y)-.15 E
F2(The Gnu History Libr)108 364.8 Q(ary)-.15 E F0 2.5(,B)C(rian F)219.8 364.8 Q
(ox and Chet Rame)-.15 E(y)-.15 E F2(bash)108 376.8 Q F0(\(1\))A F1(FILES)72
393.6 Q F2(~/.inputr)109.666 405.6 Q(c)-.37 E F0(Indi)144 417.6 Q(vidual)-.25 E
/F3 10/Times-Bold@0 SF -.18(re)2.5 G(adline).18 E F0(initialization \214le)2.5
E F1 -.45(AU)72 434.4 S(THORS).45 E F0(Brian F)144 446.4 Q(ox, Free Softw)-.15
E(are F)-.1 E(oundation \(primary author\))-.15 E(bfox@ai.MIT)144 458.4 Q(.Edu)
-.74 E(Chet Rame)144 475.2 Q 1.3 -.65(y, C)-.15 H(ase W).65 E(estern Reserv)-.8
E 2.5(eU)-.15 G(ni)296.66 475.2 Q -.15(ve)-.25 G(rsity).15 E(chet@ins.CWR)144
487.2 Q(U.Edu)-.4 E F1 -.09(BU)72 504 S 2.25(GR).09 G(EPOR)100.161 504 Q(TS)
-.36 E F0 .691(If you \214nd a b)108 516 R .691(ug in)-.2 F F3 -.18(re)3.191 G
(adline,).18 E F0 .691(you should report it.)3.191 F .69
(But \214rst, you should mak)5.69 F 3.19(es)-.1 G .69
(ure that it really is a b)436.35 516 R(ug,)-.2 E
(and that it appears in the latest v)108 528 Q(ersion of the)-.15 E F3 -.18(re)
2.5 G(adline).18 E F0(library that you ha)2.5 E -.15(ve)-.2 G(.).15 E 10.782
(Once you ha)108 544.8 R 11.082 -.15(ve d)-.2 H 10.782(etermined that a b).15 F
10.782(ug actually e)-.2 F 10.783(xists, mail a b)-.15 F 10.783(ug report to)
-.2 F F2(bash\255maintainer)108 556.8 Q(s)-.1 E F0(@)A F2(pr)A(ep.ai.MIT)-.37 E
(.Edu)-.74 E F0 5.169(.I)C 2.669(fy)267.359 556.8 S .169(ou ha)278.358 556.8 R
.469 -.15(ve a \214)-.2 H .168(x, you are welcome to mail that as well!).15 F
(Suggestions)5.168 E 2(and `philosophical' b)108 568.8 R 2.001
(ug reports may be mailed to)-.2 F F2 -.2(bu)4.501 G(g-bash).2 E F0(@)A F2(pr)A
(ep.ai.MIT)-.37 E(.Edu)-.74 E F0 2.001(or posted to the Usenet)4.501 F(ne)108
580.8 Q(wsgroup)-.25 E F3(gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108
597.6 Q(ug reports concerning this manual page should be directed to)-.2 E F2
-.15(ch)2.5 G(et@ins.CWR).15 E -.25(U.)-.4 G(Edu).25 E F0(.).25 E F1 -.09(BU)72
614.4 S(GS).09 E F0(It')108 626.4 Q 2.5(st)-.55 G(oo big and too slo)126.06
626.4 Q -.65(w.)-.25 G 184.005(GNU 1994)72 768 R(July 26)2.5 E(12)530 768 Q EP
%%Trailer
end
%%EOF