path: root/doc/readline_3.ps

%!PS-Adobe-3.0
%%Creator: groff version 1.22.4
%%CreationDate: Tue Sep 20 10:17:06 2022
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%+ font Courier
%%DocumentSuppliedResources: procset grops 1.22 4
%%Pages: 17
%%PageOrder: Ascend
%%DocumentMedia: Default 612 792 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.22 4
%!PS-Adobe-3.0 Resource-ProcSet
/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
/MANUAL{
statusdict begin/manualfeed true store end
}bind def
/PLG{
gsave newpath clippath pathbbox grestore
exch pop add exch pop
}bind def
/BP{
/level0 save def
1 setlinecap
1 setlinejoin
DEFS/BPhook known{DEFS begin BPhook end}if
72 RES div dup scale
LS{
90 rotate
}{
0 PL translate
}ifelse
1 -1 scale
}bind def
/EP{
level0 restore
showpage
}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
/Fr{
setrgbcolor fill
}bind def
/setcmykcolor where{
pop
/Fk{
setcmykcolor fill
}bind def
}if
/Fg{
setgray fill
}bind def
/FL/fill load def
/LW/setlinewidth load def
/Cr/setrgbcolor load def
/setcmykcolor where{
pop
/Ck/setcmykcolor load def
}if
/Cg/setgray load def
/RE{
findfont
dup maxlength 1 index/FontName known not{1 add}if dict begin
{
1 index/FID ne
2 index/UniqueID ne
and
{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
/setpagedevice{}def
mark
}bind def
/PEND{
cleartomark
countdictstack CNT sub{end}repeat
level1 restore
}bind def
end def
/setpacking where{
pop
setpacking
}if
%%EndResource
%%EndProlog
%%BeginSetup
%%BeginFeature: *PageSize Default
<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
%%IncludeResource: font Courier
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/Euro/.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
/Courier@0 ENC0/Courier RE/Times-Italic@0 ENC0/Times-Italic RE
/Times-Bold@0 ENC0/Times-Bold RE/Times-Roman@0 ENC0/Times-Roman RE
%%EndSetup
%%Page: 1 1
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10.95/Times-Bold@0 SF
-.219(NA)72 84 S(ME).219 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 <stdio.h>)108 124.8 Q
(#include <r)108 136.8 Q(eadline/r)-.18 E(eadline.h>)-.18 E(#include <r)
108 148.8 Q(eadline/history)-.18 E(.h>)-.7 E/F3 10/Times-Italic@0 SF
-.15(ch)108 165.6 S(ar *).15 E F2 -.18(re)108 177.6 S(adline).18 E F0
(\()2.5 E F3(const c)A(har *pr)-.15 E(ompt)-.45 E F0(\);)A F1(COPYRIGHT)
72 194.4 Q F0(Readline is Cop)108 206.4 Q
(yright \251 1989\2552020 Free Softw)-.1 E(are F)-.1 E(oundation, Inc.)
-.15 E F1(DESCRIPTION)72 223.2 Q F2 -.18(re)108 235.2 S(adline).18 E F0
.088(will read a line from the terminal and return it, using)2.588 F F2
(pr)2.587 E(ompt)-.18 E F0 .087(as a prompt.)2.587 F(If)5.087 E F2(pr)
2.587 E(ompt)-.18 E F0(is)2.587 E F2(NULL)2.587 E F0(or)2.587 E .399
(the empty string, no prompt is issued.)108 247.2 R .399
(The line returned is allocated with)5.399 F F3(malloc)3.28 E F0 .4
(\(3\); the caller must free it).31 F(when \214nished.)108 259.2 Q
(The line returned has the \214nal ne)5 E(wline remo)-.25 E -.15(ve)-.15
G(d, so only the te).15 E(xt of the line remains.)-.15 E F2 -.18(re)108
276 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 288 Q 2.5(Av)5 G
(i\255style line editing interf)-2.5 E(ace is also a)-.1 E -.25(va)-.2 G
(ilable.).25 E .272
(This manual page describes only the most basic use of)108 304.8 R F2
-.18(re)2.772 G(adline).18 E F0 5.272(.M)C .272
(uch more functionality is a)-5.272 F -.25(va)-.2 G .272(ilable; see).25
F F3(The GNU Readline Libr)108 316.8 Q(ary)-.15 E F0(and)2.5 E F3
(The GNU History Libr)2.5 E(ary)-.15 E F0(for additional information.)
2.5 E F1(RETURN V)72 333.6 Q(ALUE)-1.478 E F2 -.18(re)108 345.6 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.)-3.589
F(If)6.089 E F2(EOF)3.589 E F0 1.089(is encountered)3.589 F .283
(while reading a line, and the line is empty)108 357.6 R(,)-.65 E F2
(NULL)2.783 E F0 .283(is returned.)2.783 F .283(If an)5.283 F F2(EOF)
2.783 E F0 .283(is read with a non\255empty line, it)2.783 F
(is treated as a ne)108 369.6 Q(wline.)-.25 E F1(NO)72 386.4 Q -.986(TA)
-.438 G(TION)-.054 E F0 .077
(An Emacs-style notation is used to denote k)108 398.4 R -.15(ey)-.1 G
(strok).15 E 2.576(es. Control)-.1 F -.1(ke)2.576 G .076
(ys are denoted by C\255)-.05 F F3 -.1(ke)C(y)-.2 E F0 2.576(,e)C .076
(.g., C\255n means)-2.576 F 2.582(Control\255N. Similarly)108 410.4 R(,)
-.65 E F3(meta)2.962 E F0 -.1(ke)2.842 G .082(ys are denoted by M\255)
-.05 F F3 -.1(ke)C(y)-.2 E F0 2.583(,s)C 2.583(oM)-2.583 G .083
(\255x means Meta\255X.)-2.583 F .083(\(On k)5.083 F -.15(ey)-.1 G .083
(boards without a).15 F F3(meta)108.38 422.4 Q F0 -.1(ke)3.472 G 2.012
-.65(y, M)-.05 H<ad>.65 E F3(x)A F0 .712(means ESC)3.212 F F3(x)3.212 E
F0 3.212(,i)C .712(.e., press the Escape k)-3.212 F 1.011 -.15(ey t)-.1
H .711(hen the).15 F F3(x)3.981 E F0 -.1(ke)3.741 G 4.511 -.65(y. T)-.05
H .711(his mak).65 F .711(es ESC the)-.1 F F3 .711(meta pr)3.211 F
(e\214x)-.37 E F0(.)A .48(The combination M\255C\255)108 434.4 R F3(x)A
F0 .48(means ESC\255Control\255)2.98 F F3(x)A F0 2.98(,o)C 2.98(rp)-2.98
G .48(ress the Escape k)-2.98 F .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 446.4 Q F3(x)3.27 E F0 -.1(ke)3.03 G -.65(y.)-.05 G
(\)).65 E .596(Readline commands may be gi)108 463.2 R -.15(ve)-.25 G
3.096(nn).15 G(umeric)-3.096 E F3(ar)3.426 E(guments)-.37 E F0 3.096(,w)
.27 G .596(hich normally act as a repeat count.)-3.096 F(Sometimes,)
5.595 E(ho)108 475.2 Q(we)-.25 E -.15(ve)-.25 G 1.418 -.4(r, i).15 H
3.118(ti).4 G 3.119(st)-3.118 G .619(he sign of the ar)-3.119 F .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 487.2 R 1.018
(ard direction \(e.g.,)-.1 F F2(kill\255line)3.518 E F0 3.518(\)c)C
1.018(auses that command to act in a backw)-3.518 F 1.018
(ard direction.)-.1 F(Com-)6.018 E(mands whose beha)108 499.2 Q
(vior with ar)-.2 E(guments de)-.18 E(viates from this are noted belo)
-.25 E -.65(w.)-.25 G .811(When a command is described as)108 516 R F3
(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)-3.311 F -.25(va)-.25 G 3.312(l\().25 G F3
(yank-)-3.312 E(ing)108 528 Q F0 2.529(\). The)B .029(killed te)2.529 F
.029(xt is sa)-.15 F -.15(ve)-.2 G 2.529(di).15 G 2.529(na)-2.529 G F3
.029(kill ring)B F0 5.029(.C)C(onsecuti)-5.029 E .329 -.15(ve k)-.25 H
.029(ills cause the te).15 F .029(xt to be accumulated into one unit,)
-.15 F .567(which can be yank)108 540 R .567(ed all at once.)-.1 F .567
(Commands which do not kill te)5.567 F .567
(xt separate the chunks of te)-.15 F .567(xt on the kill)-.15 F(ring.)
108 552 Q F1(INITIALIZA)72 568.8 Q(TION FILE)-1.04 E F0 .091(Readline i\
s customized by putting commands in an initialization \214le \(the)108
580.8 R F3(inputr)2.591 E(c)-.37 E F0 2.591(\214le\). The)2.591 F .091
(name of this \214le)2.591 F .156(is tak)108 592.8 R .156(en from the v)
-.1 F .156(alue of the)-.25 F F2(INPUTRC)2.656 E F0(en)2.656 E .156
(vironment v)-.4 F 2.656(ariable. If)-.25 F .156(that v)2.656 F .156
(ariable is unset, the def)-.25 F .157(ault is)-.1 F F3(~/.in-)2.157 E
(putr)108 604.8 Q(c)-.37 E F0 5.905(.I).31 G 3.405(ft)-5.905 G .905
(hat \214le)-3.405 F .905(does not e)5.905 F .904
(xist or cannot be read, the ultimate def)-.15 F .904(ault is)-.1 F F3
(/etc/inputr)4.554 E(c)-.37 E F0 5.904(.W).31 G .904(hen a program)
-5.904 F 1.158(which uses the readline library starts up, the init \214\
le is read, and the k)108 616.8 R 1.459 -.15(ey b)-.1 H 1.159
(indings and v).15 F 1.159(ariables are set.)-.25 F .029
(There are only a fe)108 628.8 R 2.529(wb)-.25 G .029
(asic constructs allo)-2.529 F .028(wed in the readline init \214le.)
-.25 F .028(Blank lines are ignored.)5.028 F .028(Lines be)5.028 F(gin-)
-.15 E .553(ning with a)108 640.8 R F2(#)3.053 E F0 .554(are comments.)
3.053 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 .554(Other lines denote)
5.554 F -.1(ke)108 652.8 S 2.987(yb)-.05 G .487(indings and v)-2.987 F
.487(ariable settings.)-.25 F .487
(Each program using this library may add its o)5.487 F .486
(wn commands and bind-)-.25 F(ings.)108 664.8 Q -.15(Fo)108 681.6 S 2.5
(re).15 G(xample, placing)-2.65 E(M\255Control\255u: uni)144 698.4 Q
-.15(ve)-.25 G(rsal\255ar).15 E(gument)-.18 E(or)108 710.4 Q
(C\255Meta\255u: uni)144 722.4 Q -.15(ve)-.25 G(rsal\255ar).15 E(gument)
-.18 E(GNU Readline 8.2)72 768 Q(2022 September 19)120.405 E(1)190.115 E
0 Cg EP
%%Page: 2 2
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E(into the)108 84 Q/F1 10
/Times-Italic@0 SF(inputr)2.51 E(c)-.37 E F0 -.1(wo)2.81 G(uld mak).1 E
2.5(eM)-.1 G(\255C\255u e)-2.5 E -.15(xe)-.15 G
(cute the readline command).15 E F1(univer)2.58 E(sal\255ar)-.1 E
(gument)-.37 E F0(.).68 E 1.153(The follo)108 100.8 R 1.154
(wing symbolic character names are recognized while processing k)-.25 F
1.454 -.15(ey b)-.1 H(indings:).15 E F1(DEL)4.234 E F0(,).53 E F1(ESC)
4.164 E F0(,).72 E F1(ES-)4.164 E(CAPE)108 112.8 Q F0(,).73 E F1(LFD)
3.08 E F0(,).28 E F1(NEWLINE)3.2 E F0(,).73 E F1(RET)3.13 E F0(,)1.27 E
F1(RETURN)3.13 E F0(,)1.1 E F1 -.4(RU)2.5 G(BOUT).4 E F0(,)1.27 E F1(SP)
2.83 E -.3(AC)-.9 G(E).3 E F0(,).73 E F1(SPC)2.83 E F0 2.5(,a).72 G(nd)
-2.5 E F1 -.5(TA)2.5 G(B).5 E F0(.).27 E .209
(In addition to command names, readline allo)108 129.6 R .209(ws k)-.25
F -.15(ey)-.1 G 2.709(st).15 G 2.709(ob)-2.709 G 2.709(eb)-2.709 G .209
(ound to a string that is inserted when the k)-2.709 F .509 -.15(ey i)
-.1 H(s).15 E(pressed \(a)108 141.6 Q F1(macr)2.5 E(o)-.45 E F0(\).)A/F2
10/Times-Bold@0 SF -.25(Ke)87 158.4 S 2.5(yB).25 G(indings)-2.5 E F0
.366(The syntax for controlling k)108 170.4 R .666 -.15(ey b)-.1 H .366
(indings in the).15 F F1(inputr)2.876 E(c)-.37 E F0 .366
(\214le is simple.)3.176 F .366(All that is required is the name of the)
5.366 F .264(command or the te)108 182.4 R .264(xt of a macro and a k)
-.15 F .564 -.15(ey s)-.1 H .264(equence to which it should be bound.)
.15 F .263(The name may be speci-)5.264 F .138(\214ed in one of tw)108
194.4 R 2.638(ow)-.1 G .138(ays: as a symbolic k)-2.738 F .438 -.15
(ey n)-.1 H .138(ame, possibly with).15 F F1(Meta\255)2.638 E F0(or)
2.638 E F1(Contr)2.638 E(ol\255)-.45 E F0(pre\214x)2.638 E .138
(es, or as a k)-.15 F .439 -.15(ey s)-.1 H(e-).15 E 3.409(quence. The)
108 206.4 R .909(name and k)3.409 F 1.209 -.15(ey s)-.1 H .909
(equence are separated by a colon.).15 F .909
(There can be no whitespace between the)5.909 F(name and the colon.)108
218.4 Q .361(When using the form)108 235.2 R F2 -.1(ke)2.861 G(yname).1
E F0(:)A F1(function-name).833 E F0(or)2.861 E F1(macr)2.861 E(o)-.45 E
F0(,)A F1 -.1(ke)2.861 G(yname)-.2 E F0 .362(is the name of a k)3.042 F
.662 -.15(ey s)-.1 H .362(pelled out in Eng-).15 F 2.5(lish. F)108 247.2
R(or e)-.15 E(xample:)-.15 E(Control\255u: uni)144 271.2 Q -.15(ve)-.25
G(rsal\255ar).15 E(gument)-.18 E(Meta\255Rubout: backw)144 283.2 Q
(ard\255kill\255w)-.1 E(ord)-.1 E(Control\255o: "> output")144 295.2 Q
.148(In the abo)108 312 R .448 -.15(ve ex)-.15 H(ample,).15 E F1(C\255u)
2.488 E F0 .148(is bound to the function)2.898 F F2(uni)2.647 E -.1(ve)
-.1 G(rsal\255ar).1 E(gument)-.1 E F0(,)A F1(M-DEL)3.327 E F0 .147
(is bound to the function)3.177 F F2(backward\255kill\255w)108 324 Q
(ord)-.1 E F0 3.005(,a)C(nd)-3.005 E F1(C\255o)2.845 E F0 .505
(is bound to run the macro e)3.185 F .506
(xpressed on the right hand side \(that is, to in-)-.15 F(sert the te)
108 336 Q(xt)-.15 E/F3 10/Courier@0 SF 6(>o)2.5 G(utput)-6 E F0
(into the line\).)2.5 E .056(In the second form,)108 352.8 R F2("k)2.556
E(eyseq")-.1 E F0(:)A F1(function\255name).833 E F0(or)2.556 E F1(macr)
2.556 E(o)-.45 E F0(,)A F2 -.1(ke)2.556 G(yseq).1 E F0(dif)2.555 E .055
(fers from)-.25 F F2 -.1(ke)2.555 G(yname).1 E F0(abo)2.555 E .355 -.15
(ve i)-.15 H 2.555(nt).15 G .055(hat strings)-2.555 F 1.284
(denoting an entire k)108 364.8 R 1.584 -.15(ey s)-.1 H 1.284(equence m\
ay be speci\214ed by placing the sequence within double quotes.).15 F
(Some)6.284 E .386(GNU Emacs style k)108 376.8 R .686 -.15(ey e)-.1 H
.385(scapes can be used, as in the follo).15 F .385(wing e)-.25 F .385
(xample, b)-.15 F .385(ut the symbolic character names)-.2 F
(are not recognized.)108 388.8 Q("\\C\255u": uni)144 412.8 Q -.15(ve)
-.25 G(rsal\255ar).15 E(gument)-.18 E
("\\C\255x\\C\255r": re\255read\255init\255\214le)144 424.8 Q
("\\e[11~": "Function K)144 436.8 Q .3 -.15(ey 1)-.25 H(").15 E .198
(In this e)108 453.6 R(xample,)-.15 E F1(C-u)2.538 E F0 .199(is ag)2.949
F .199(ain bound to the function)-.05 F F2(uni)2.699 E -.1(ve)-.1 G
(rsal\255ar).1 E(gument)-.1 E F0(.)A F1 .199(C-x C-r)5.039 F F0 .199
(is bound to the function)3.429 F F2 -.18(re)108 465.6 S<ad72>.18 E
(ead\255init\255\214le)-.18 E F0 2.5(,a)C(nd)-2.5 E F1(ESC [ 1 1 ~)3.01
E F0(is bound to insert the te)3.94 E(xt)-.15 E F3(Function Key 1)2.5 E
F0(.)A(The full set of GNU Emacs style escape sequences a)108 482.4 Q
-.25(va)-.2 G(ilable when specifying k).25 E .3 -.15(ey s)-.1 H
(equences is).15 E F2<5c43ad>144 494.4 Q F0(control pre\214x)180 494.4 Q
F2<5c4dad>144 506.4 Q F0(meta pre\214x)180 506.4 Q F2(\\e)144 518.4 Q F0
(an escape character)180 518.4 Q F2(\\\\)144 530.4 Q F0(backslash)180
530.4 Q F2(\\")144 542.4 Q F0(literal ", a double quote)180 542.4 Q F2
(\\')144 554.4 Q F0(literal ', a single quote)180 554.4 Q(In addition t\
o the GNU Emacs style escape sequences, a second set of backslash escap\
es is a)108 571.2 Q -.25(va)-.2 G(ilable:).25 E F2(\\a)144 583.2 Q F0
(alert \(bell\))180 583.2 Q F2(\\b)144 595.2 Q F0(backspace)180 595.2 Q
F2(\\d)144 607.2 Q F0(delete)180 607.2 Q F2(\\f)144 619.2 Q F0
(form feed)180 619.2 Q F2(\\n)144 631.2 Q F0(ne)180 631.2 Q(wline)-.25 E
F2(\\r)144 643.2 Q F0(carriage return)180 643.2 Q F2(\\t)144 655.2 Q F0
(horizontal tab)180 655.2 Q F2(\\v)144 667.2 Q F0 -.15(ve)180 667.2 S
(rtical tab).15 E F2(\\)144 679.2 Q F1(nnn)A F0
(the eight-bit character whose v)180 679.2 Q(alue is the octal v)-.25 E
(alue)-.25 E F1(nnn)2.5 E F0(\(one to three digits\))2.5 E F2(\\x)144
691.2 Q F1(HH)A F0(the eight-bit character whose v)180 691.2 Q
(alue is the he)-.25 E(xadecimal v)-.15 E(alue)-.25 E F1(HH)2.5 E F0
(\(one or tw)2.5 E 2.5(oh)-.1 G .3 -.15(ex d)-2.5 H(igits\)).15 E .74
(When entering the te)108 708 R .74(xt of a macro, single or double quo\
tes should be used to indicate a macro de\214nition.)-.15 F .089
(Unquoted te)108 720 R .089(xt is assumed to be a function name.)-.15 F
.09(In the macro body)5.089 F 2.59(,t)-.65 G .09
(he backslash escapes described abo)-2.59 F -.15(ve)-.15 G
(GNU Readline 8.2)72 768 Q(2022 September 19)120.405 E(2)190.115 E 0 Cg
EP
%%Page: 3 3
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E(are e)108 84 Q 2.5
(xpanded. Backslash)-.15 F(will quote an)2.5 E 2.5(yo)-.15 G
(ther character in the macro te)-2.5 E(xt, including " and '.)-.15 E/F1
10/Times-Bold@0 SF(Bash)108 100.8 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 112.8 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.076(mand. Other)108 124.8 R .576
(programs using this library pro)3.076 F .575(vide similar mechanisms.)
-.15 F(The)5.575 E/F2 10/Times-Italic@0 SF(inputr)3.085 E(c)-.37 E F0
.575(\214le may be edited and)3.385 F(re-read if a program does not pro)
108 136.8 Q(vide an)-.15 E 2.5(yo)-.15 G(ther means to incorporate ne)
-2.5 E 2.5(wb)-.25 G(indings.)-2.5 E F1 -.92(Va)87 153.6 S(riables).92 E
F0 .043(Readline has v)108 165.6 R .043
(ariables that can be used to further customize its beha)-.25 F(vior)-.2
E 5.043(.A)-.55 G -.25(va)-2.5 G .043(riable may be set in the).25 F F2
(inpu-)2.554 E(tr)108 177.6 Q(c)-.37 E F0
(\214le with a statement of the form)2.81 E F1(set)144 194.4 Q F2
(variable\255name value)2.5 E F0 .79(Except where noted, readline v)108
211.2 R .79(ariables can tak)-.25 F 3.29(et)-.1 G .79(he v)-3.29 F
(alues)-.25 E F1(On)3.29 E F0(or)3.29 E F1(Off)3.29 E F0 .79
(\(without re)3.29 F -.05(ga)-.15 G .79(rd to case\).).05 F(Unrecog-)
5.79 E .448(nized v)108 223.2 R .448(ariable names are ignored.)-.25 F
.448(When a v)5.448 F .448(ariable v)-.25 F .448
(alue is read, empty or null v)-.25 F .449(alues, "on" \(case-insensi-)
-.25 F(ti)108 235.2 Q -.15(ve)-.25 G .468(\), and "1" are equi).15 F
-.25(va)-.25 G .468(lent to).25 F F1(On)2.968 E F0 5.468(.A)C .468
(ll other v)-5.468 F .468(alues are equi)-.25 F -.25(va)-.25 G .468
(lent to).25 F F1(Off)2.968 E F0 5.468(.T)C .467(he v)-5.468 F .467
(ariables and their def)-.25 F(ault)-.1 E -.25(va)108 247.2 S(lues are:)
.25 E F1(acti)108 264 Q -.1(ve)-.1 G<ad72>.1 E(egion\255start\255color)
-.18 E F0 2.729(As)144 276 S .229(tring v)-2.729 F .229
(ariable that controls the te)-.25 F .229
(xt color and background when displaying the te)-.15 F .23
(xt in the acti)-.15 F -.15(ve)-.25 G(re)144 288 Q 1.527
(gion \(see the description of)-.15 F F1(enable\255acti)4.026 E -.1(ve)
-.1 G<ad72>.1 E(egion)-.18 E F0(belo)4.026 E 4.026(w\). This)-.25 F
1.526(string must not tak)4.026 F 4.026(eu)-.1 G 4.026(pa)-4.026 G -.15
(ny)-4.026 G(ph)144 300 Q .283
(ysical character positions on the display)-.05 F 2.783(,s)-.65 G 2.784
(oi)-2.783 G 2.784(ts)-2.784 G .284
(hould consist only of terminal escape sequences.)-2.784 F .45
(It is output to the terminal before displaying the te)144 312 R .45
(xt in the acti)-.15 F .75 -.15(ve r)-.25 H -.15(eg).15 G 2.95
(ion. This).15 F -.25(va)2.95 G .45(riable is reset to).25 F .378
(the def)144 324 R .378(ault v)-.1 F .378(alue whene)-.25 F -.15(ve)-.25
G 2.878(rt).15 G .379(he terminal type changes.)-2.878 F .379(The def)
5.379 F .379(ault v)-.1 F .379(alue is the string that puts the)-.25 F
.655(terminal in standout mode, as obtained from the terminal')144 336 R
3.154(st)-.55 G .654(erminfo description.)-3.154 F 3.154(As)5.654 G .654
(ample v)-3.154 F(alue)-.25 E(might be)144 348 Q/F3 10/Courier@0 SF
("\\e[01;33m")2.5 E F0(.)A F1(acti)108 360 Q -.1(ve)-.1 G<ad72>.1 E
(egion\255end\255color)-.18 E F0 3.908(As)144 372 S 1.408(tring v)-3.908
F 1.408(ariable that "undoes" the ef)-.25 F 1.408(fects of)-.25 F F1
(acti)3.908 E -.1(ve)-.1 G<ad72>.1 E(egion\255start\255color)-.18 E F0
1.409(and restores "normal")3.908 F .216
(terminal display appearance after displaying te)144 384 R .216
(xt in the acti)-.15 F .516 -.15(ve r)-.25 H -.15(eg).15 G 2.716
(ion. This).15 F .216(string must not tak)2.716 F 2.716(eu)-.1 G(p)
-2.716 E(an)144 396 Q 3.737(yp)-.15 G -.05(hy)-3.737 G 1.237
(sical character positions on the display).05 F 3.737(,s)-.65 G 3.737
(oi)-3.737 G 3.737(ts)-3.737 G 1.238
(hould consist only of terminal escape se-)-3.737 F 2.928(quences. It)
144 408 R .428(is output to the terminal after displaying the te)2.928 F
.427(xt in the acti)-.15 F .727 -.15(ve r)-.25 H -.15(eg).15 G 2.927
(ion. This).15 F -.25(va)2.927 G .427(riable is).25 F .518
(reset to the def)144 420 R .518(ault v)-.1 F .518(alue whene)-.25 F
-.15(ve)-.25 G 3.018(rt).15 G .518(he terminal type changes.)-3.018 F
.518(The def)5.518 F .518(ault v)-.1 F .518(alue is the string that)-.25
F .252(restores the terminal from standout mode, as obtained from the t\
erminal')144 432 R 2.751(st)-.55 G .251(erminfo description.)-2.751 F(A)
5.251 E(sample v)144 444 Q(alue might be)-.25 E F3("\\e[0m)2.5 E F0(".)A
F1(bell\255style \(audible\))108 456 Q F0 .01
(Controls what happens when readline w)144 468 R .011
(ants to ring the terminal bell.)-.1 F .011(If set to)5.011 F F1(none)
2.511 E F0 2.511(,r)C .011(eadline ne)-2.511 F -.15(ve)-.25 G(r).15 E
.94(rings the bell.)144 480 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)-3.44 F -.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 492 Q 2.5(sb)-.55 G(ell.)
-2.5 E F1(bind\255tty\255special\255chars \(On\))108 504 Q F0 .333
(If set to)144 516 R F1(On)2.833 E F0 .334(\(the def)2.833 F .334
(ault\), readline attempts to bind the control characters)-.1 F .334
(treated specially by the)7.834 F -.1(ke)144 528 S(rnel').1 E 2.5(st)
-.55 G(erminal dri)-2.5 E -.15(ve)-.25 G 2.5(rt).15 G 2.5(ot)-2.5 G
(heir readline equi)-2.5 E -.25(va)-.25 G(lents.).25 E F1
(blink\255matching\255par)108 540 Q(en \(Off\))-.18 E F0 .21(If set to)
144 552 R F1(On)2.71 E F0 2.71(,r)C .21
(eadline attempts to brie\215y mo)-2.71 F .51 -.15(ve t)-.15 H .21
(he cursor to an opening parenthesis when a closing).15 F
(parenthesis is inserted.)144 564 Q F1(color)108 576 Q
(ed\255completion\255pr)-.18 E(e\214x \(Off\))-.18 E F0 .515(If set to)
144 588 R F1(On)3.015 E F0 3.015(,w)C .515(hen listing completions, rea\
dline displays the common pre\214x of the set of possible)-3.015 F 2.936
(completions using a dif)144 600 R 2.936(ferent color)-.25 F 7.936(.T)
-.55 G 2.936(he color de\214nitions are tak)-7.936 F 2.935
(en from the v)-.1 F 2.935(alue of the)-.25 F F1(LS_COLORS)144 612 Q F0
(en)3.076 E .577(vironment v)-.4 F 3.077(ariable. If)-.25 F .577
(there is a color de\214nition in)3.077 F F1($LS_COLORS)3.077 E F0 .577
(for the cus-)3.077 F .135(tom suf)144 624 R .135(\214x "readline-color\
ed-completion-pre\214x", readline uses this color for the common pre\
\214x in-)-.25 F(stead of its def)144 636 Q(ault.)-.1 E F1(color)108 648
Q(ed\255stats \(Off\))-.18 E F0 1.579(If set to)144 660 R F1(On)4.079 E
F0 4.079(,r)C 1.579(eadline displays possible completions using dif)
-4.079 F 1.58(ferent colors to indicate their \214le)-.25 F 2.5
(type. The)144 672 R(color de\214nitions are tak)2.5 E(en from the v)-.1
E(alue of the)-.25 E F1(LS_COLORS)2.5 E F0(en)2.5 E(vironment v)-.4 E
(ariable.)-.25 E F1(comment\255begin \(`)108 684 Q(`#')-.63 E('\))-.63 E
F0 .062(The string that is inserted in)144 696 R F1(vi)2.562 E F0 .062
(mode when the)2.562 F F1(insert\255comment)2.562 E F0 .062
(command is e)2.562 F -.15(xe)-.15 G 2.562(cuted. This).15 F(com-)2.562
E(mand is bound to)144 708 Q F1(M\255#)2.5 E F0(in emacs mode and to)2.5
E F1(#)2.5 E F0(in vi command mode.)2.5 E(GNU Readline 8.2)72 768 Q
(2022 September 19)120.405 E(3)190.115 E 0 Cg EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(completion\255display\255width \(\2551\))108 84 Q F0 1.453(The number \
of screen columns used to display possible matches when performing comp\
letion.)144 96 R .194(The v)144 108 R .193(alue is ignored if it is les\
s than 0 or greater than the terminal screen width.)-.25 F 2.693(Av)
5.193 G .193(alue of 0 will)-2.943 F
(cause matches to be displayed one per line.)144 120 Q(The def)5 E
(ault v)-.1 E(alue is \2551.)-.25 E F1(completion\255ignor)108 132 Q
(e\255case \(Off\))-.18 E F0(If set to)144 144 Q F1(On)2.5 E F0 2.5(,r)C
(eadline performs \214lename matching and completion in a case\255insen\
siti)-2.5 E .3 -.15(ve f)-.25 H(ashion.).05 E F1
(completion\255map\255case \(Off\))108 156 Q F0 .093(If set to)144 168 R
F1(On)2.593 E F0 2.593(,a)C(nd)-2.593 E F1(completion\255ignor)2.593 E
(e\255case)-.18 E F0 .093(is enabled, readline treats h)2.593 F .093
(yphens \()-.05 F/F2 10/Times-Italic@0 SF<ad>A F0 2.593(\)a)C .094
(nd underscores)-2.593 F(\()144 180 Q F2(_)A F0 2.5(\)a)C 2.5(se)-2.5 G
(qui)-2.5 E -.25(va)-.25 G(lent when performing case\255insensiti).25 E
.3 -.15(ve \214)-.25 H(lename matching and completion.).15 E F1
(completion\255pr)108 192 Q(e\214x\255display\255length \(0\))-.18 E F0
.829(The length in characters of the common pre\214x of a list of possi\
ble completions that is displayed)144 204 R 1.274
(without modi\214cation.)144 216 R 1.274(When set to a v)6.274 F 1.274
(alue greater than zero, common pre\214x)-.25 F 1.275
(es longer than this)-.15 F -.25(va)144 228 S(lue are replaced with an \
ellipsis when displaying possible completions.).25 E F1
(completion\255query\255items \(100\))108 240 Q F0 .53
(This determines when the user is queried about vie)144 252 R .529
(wing the number of possible completions gen-)-.25 F .56(erated by the)
144 264 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)-3.061 E .561(ger v)
-.15 F .561(alue greater than or)-.25 F .783(equal to zero.)144 276 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 288 S .367
(riable, readline will ask whether or not the user wishes to vie).25 F
2.868(wt)-.25 G .368(hem; otherwise the)-2.868 F 2.868(ya)-.15 G .368
(re simply)-2.868 F(listed on the terminal.)144 300 Q 2.5(An)5 G -2.25
-.15(eg a)-2.5 H(ti).15 E .3 -.15(ve v)-.25 H
(alue causes readline to ne)-.1 E -.15(ve)-.25 G 2.5(ra).15 G(sk.)-2.5 E
F1(con)108 312 Q -.1(ve)-.4 G(rt\255meta \(On\)).1 E F0 .613(If set to)
144 324 R F1(On)3.113 E F0 3.113(,r)C .613(eadline will con)-3.113 F
-.15(ve)-.4 G .613(rt characters with the eighth bit set to an ASCII k)
.15 F .912 -.15(ey s)-.1 H .612(equence by).15 F 1.315(stripping the ei\
ghth bit and pre\214xing it with an escape character \(in ef)144 336 R
1.316(fect, using escape as the)-.25 F F2 .503(meta pr)144 348 R(e\214x)
-.37 E F0 3.003(\). The)B(def)3.003 E .503(ault is)-.1 F F2(On)3.003 E
F0 3.003(,b)C .503(ut readline will set it to)-3.203 F F2(Of)3.003 E(f)
-.18 E F0 .502(if the locale contains eight-bit char)3.003 F(-)-.2 E
3.049(acters. This)144 360 R -.25(va)3.049 G .549
(riable is dependent on the).25 F F1(LC_CTYPE)3.049 E F0 .549
(locale cate)3.049 F(gory)-.15 E 3.049(,a)-.65 G .55
(nd may change if the lo-)-3.049 F(cale is changed.)144 372 Q F1
(disable\255completion \(Off\))108 384 Q F0 .038(If set to)144 396 R F1
(On)2.538 E F0 2.538(,r)C .038(eadline will inhibit w)-2.538 F .038
(ord completion.)-.1 F .038
(Completion characters will be inserted into the)5.038 F(line as if the)
144 408 Q 2.5(yh)-.15 G(ad been mapped to)-2.5 E F1(self-insert)2.5 E F0
(.)A F1(echo\255contr)108 420 Q(ol\255characters \(On\))-.18 E F0 1.21
(When set to)144 432 R F1(On)3.71 E F0 3.71(,o)C 3.71(no)-3.71 G 1.211
(perating systems that indicate the)-3.71 F 3.711(ys)-.15 G 1.211
(upport it, readline echoes a character)-3.711 F
(corresponding to a signal generated from the k)144 444 Q -.15(ey)-.1 G
(board.).15 E F1(editing\255mode \(emacs\))108 456 Q F0 .142
(Controls whether readline be)144 468 R .141(gins with a set of k)-.15 F
.441 -.15(ey b)-.1 H .141(indings similar to).15 F F2(Emacs)2.641 E F0
(or)2.641 E F2(vi)2.641 E F0(.)A F1(editing\255mode)5.141 E F0
(can be set to either)144 480 Q F1(emacs)2.5 E F0(or)2.5 E F1(vi)2.5 E
F0(.)A F1(emacs\255mode\255string \(@\))108 492 Q F0 .517(If the)144 504
R F2(show\255mode\255in\255pr)3.017 E(ompt)-.45 E F0 -.25(va)3.017 G
.518(riable is enabled, this string is displayed immediately before the)
.25 F .622
(last line of the primary prompt when emacs editing mode is acti)144 516
R -.15(ve)-.25 G 5.622(.T).15 G .622(he v)-5.622 F .621(alue is e)-.25 F
.621(xpanded lik)-.15 F 3.121(ea)-.1 G -.1(ke)144 528 S 3.339(yb)-.05 G
.839(inding, so the standard set of meta- and control pre\214x)-3.339 F
.84(es and backslash escape sequences is)-.15 F -.2(av)144 540 S 2.798
(ailable. Use)-.05 F .298(the \\1 and \\2 escapes to be)2.798 F .298
(gin and end sequences of non-printing characters, which)-.15 F
(can be used to embed a terminal control sequence into the mode string.)
144 552 Q F1(enable\255acti)108 564 Q -.1(ve)-.1 G<ad72>.1 E
(egion \(On\))-.18 E F0(The)144 576 Q F2(point)3.245 E F0 .746
(is the current cursor position, and)3.245 F F2(mark)3.246 E F0 .746
(refers to a sa)3.246 F -.15(ve)-.2 G 3.246(dc).15 G .746
(ursor position.)-3.246 F .746(The te)5.746 F .746(xt be-)-.15 F .344
(tween the point and mark is referred to as the)144 588 R F2 -.37(re)
2.844 G(gion)-.03 E F0 5.344(.W)C .344(hen this v)-5.344 F .344
(ariable is set to)-.25 F F2(On)2.844 E F0 2.844(,r)C .344(eadline al-)
-2.844 F(lo)144 600 Q .098(ws certain commands to designate the re)-.25
F .098(gion as)-.15 F F2(active)2.598 E F0 5.098(.W)C .098(hen the re)
-5.098 F .098(gion is acti)-.15 F -.15(ve)-.25 G 2.598(,r).15 G .098
(eadline high-)-2.598 F .971(lights the te)144 612 R .971(xt in the re)
-.15 F .971(gion using the v)-.15 F .971(alue of the)-.25 F F1(acti)3.47
E -.1(ve)-.1 G<ad72>.1 E(egion\255start\255color)-.18 E F0 3.47(,w)C .97
(hich def)-3.47 F .97(aults to)-.1 F .484
(the string that enables the terminal')144 624 R 2.985(ss)-.55 G .485
(tandout mode.)-2.985 F .485(The acti)5.485 F .785 -.15(ve r)-.25 H -.15
(eg).15 G .485(ion sho).15 F .485(ws the te)-.25 F .485(xt inserted by)
-.15 F(brack)144 636 Q(eted-paste and an)-.1 E 2.5(ym)-.15 G(atching te)
-2.5 E(xt found by incremental and non-incremental history searches.)
-.15 E F1(enable\255brack)108 648 Q(eted\255paste \(On\))-.1 E F0 .841
(When set to)144 660 R F1(On)3.341 E F0 3.341(,r)C .841(eadline con\214\
gures the terminal to insert each paste into the editing b)-3.341 F(uf)
-.2 E .84(fer as a)-.25 F .799(single string of characters, instead of \
treating each character as if it had been read from the k)144 672 R -.15
(ey)-.1 G(-).15 E 3.159(board. This)144 684 R(pre)3.159 E -.15(ve)-.25 G
.659(nts readline from e).15 F -.15(xe)-.15 G .659(cuting an).15 F 3.158
(ye)-.15 G .658(diting commands bound to k)-3.158 F .958 -.15(ey s)-.1 H
.658(equences ap-).15 F(pearing in the pasted te)144 696 Q(xt.)-.15 E
(GNU Readline 8.2)72 768 Q(2022 September 19)120.405 E(4)190.115 E 0 Cg
EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(enable\255k)108 84 Q(eypad \(Off\))-.1 E F0 .892(When set to)144 96 R
F1(On)3.393 E F0 3.393(,r)C .893
(eadline will try to enable the application k)-3.393 F -.15(ey)-.1 G
.893(pad when it is called.).15 F .893(Some sys-)5.893 F
(tems need this to enable the arro)144 108 Q 2.5(wk)-.25 G -.15(ey)-2.6
G(s.).15 E F1(enable\255meta\255k)108 120 Q(ey \(On\))-.1 E F0 .64
(When set to)144 132 R F1(On)3.14 E F0 3.14(,r)C .64
(eadline will try to enable an)-3.14 F 3.14(ym)-.15 G .64
(eta modi\214er k)-3.14 F .94 -.15(ey t)-.1 H .64
(he terminal claims to support).15 F(when it is called.)144 144 Q
(On man)5 E 2.5(yt)-.15 G(erminals, the meta k)-2.5 E .3 -.15(ey i)-.1 H
2.5(su).15 G(sed to send eight-bit characters.)-2.5 E F1
(expand\255tilde \(Off\))108 156 Q F0(If set to)144 168 Q F1(On)2.5 E F0
2.5(,t)C(ilde e)-2.5 E(xpansion is performed when readline attempts w)
-.15 E(ord completion.)-.1 E F1(history\255pr)108 180 Q(eser)-.18 E -.1
(ve)-.1 G(\255point \(Off\)).1 E F0 .552(If set to)144 192 R F1(On)3.052
E F0 3.052(,t)C .552(he history code attempts to place point at the sam\
e location on each history line re-)-3.052 F(trie)144 204 Q -.15(ve)-.25
G 2.5(dw).15 G(ith)-2.5 E F1(pr)2.5 E -.15(ev)-.18 G(ious-history).15 E
F0(or)2.5 E F1(next-history)2.5 E F0(.)A F1(history\255size \(unset\))
108 216 Q F0 .949(Set the maximum number of history entries sa)144 228 R
-.15(ve)-.2 G 3.448(di).15 G 3.448(nt)-3.448 G .948(he history list.)
-3.448 F .948(If set to zero, an)5.948 F 3.448(ye)-.15 G(xisting)-3.598
E .482(history entries are deleted and no ne)144 240 R 2.982(we)-.25 G
.483(ntries are sa)-2.982 F -.15(ve)-.2 G 2.983(d. If).15 F .483
(set to a v)2.983 F .483(alue less than zero, the num-)-.25 F .356
(ber of history entries is not limited.)144 252 R .356(By def)5.356 F
.355(ault, the number of history entries is not limited.)-.1 F .355
(If an)5.355 F .82(attempt is made to set)144 264 R/F2 10/Times-Italic@0
SF(history\255size)3.32 E F0 .821(to a non-numeric v)3.321 F .821
(alue, the maximum number of history en-)-.25 F
(tries will be set to 500.)144 276 Q F1(horizontal\255scr)108 288 Q
(oll\255mode \(Off\))-.18 E F0 .449(When set to)144 300 R F1(On)2.949 E
F0 2.949(,m)C(ak)-2.949 E .448
(es readline use a single line for display)-.1 F 2.948(,s)-.65 G .448
(crolling the input horizontally on a)-2.948 F 1.194(single screen line\
 when it becomes longer than the screen width rather than wrapping to a\
 ne)144 312 R(w)-.25 E 2.5(line. This)144 324 R
(setting is automatically enabled for terminals of height 1.)2.5 E F1
(input\255meta \(Off\))108 336 Q F0 .367(If set to)144 348 R F1(On)2.867
E F0 2.867(,r)C .367(eadline will enable eight-bit input \(that is, it \
will not clear the eighth bit in the char)-2.867 F(-)-.2 E .956
(acters it reads\), re)144 360 R -.05(ga)-.15 G .956
(rdless of what the terminal claims it can support.).05 F .957(The name)
5.956 F F1(meta\255\215ag)3.457 E F0 .957(is a)3.457 F(synon)144 372 Q
.77(ym for this v)-.15 F 3.27(ariable. The)-.25 F(def)3.27 E .77
(ault is)-.1 F F2(Of)3.27 E(f)-.18 E F0 3.27(,b)C .77
(ut readline will set it to)-3.47 F F2(On)3.27 E F0 .77
(if the locale contains)3.27 F 1.866(eight-bit characters.)144 384 R
1.866(This v)6.866 F 1.867(ariable is dependent on the)-.25 F F1
(LC_CTYPE)4.367 E F0 1.867(locale cate)4.367 F(gory)-.15 E 4.367(,a)-.65
G 1.867(nd may)-4.367 F(change if the locale is changed.)144 396 Q F1
(isear)108 408 Q(ch\255terminators \(`)-.18 E(`C\255[ C\255J')-.63 E
('\))-.63 E F0 .439(The string of characters that should terminate an i\
ncremental search without subsequently e)144 420 R -.15(xe)-.15 G(cut-)
.15 E .934(ing the character as a command.)144 432 R .935(If this v)
5.935 F .935(ariable has not been gi)-.25 F -.15(ve)-.25 G 3.435(nav).15
G .935(alue, the characters)-3.685 F F2(ESC)3.435 E F0(and)144 444 Q F2
(C\255J)2.5 E F0(will terminate an incremental search.)2.5 E F1 -.1(ke)
108 456 S(ymap \(emacs\)).1 E F0 2.323(Set the current readline k)144
468 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)-4.923 G 2.323(map names is).15 F F2
2.323(emacs, emacs-standar)4.823 F(d,)-.37 E .781
(emacs-meta, emacs-ctlx, vi, vi-mo)144 480 R(ve)-.1 E 3.282(,v)-.1 G
(i-command)-3.282 E F0 3.282(,a)C(nd)-3.282 E F2(vi-insert)3.572 E F0(.)
.68 E F2(vi)5.782 E F0 .782(is equi)3.282 F -.25(va)-.25 G .782(lent to)
.25 F F2(vi-command)3.282 E F0(;)A F2(emacs)144 492 Q F0 .683(is equi)
3.183 F -.25(va)-.25 G .683(lent to).25 F F2(emacs-standar)3.183 E(d)
-.37 E F0 5.682(.T)C .682(he def)-5.682 F .682(ault v)-.1 F .682
(alue is)-.25 F F2(emacs)3.372 E F0 5.682(.T).27 G .682(he v)-5.682 F
.682(alue of)-.25 F F1(editing\255mode)3.182 E F0(also af)144 504 Q
(fects the def)-.25 E(ault k)-.1 E -.15(ey)-.1 G(map.).15 E F1 -.1(ke)
108 516 S(yseq\255timeout \(500\)).1 E F0 .367(Speci\214es the duration)
144 528 R F2 -.37(re)2.867 G(adline).37 E F0 .367(will w)2.867 F .367
(ait for a character when reading an ambiguous k)-.1 F .668 -.15(ey s)
-.1 H(equence).15 E .525(\(one that can form a complete k)144 540 R .825
-.15(ey s)-.1 H .524(equence using the input read so f).15 F(ar)-.1 E
3.024(,o)-.4 G 3.024(rc)-3.024 G .524(an tak)-3.024 F 3.024(ea)-.1 G
.524(dditional in-)-3.024 F .806(put to complete a longer k)144 552 R
1.106 -.15(ey s)-.1 H 3.306(equence\). If).15 F .806(no input is recei)
3.306 F -.15(ve)-.25 G 3.306(dw).15 G .807(ithin the timeout,)-3.306 F
F2 -.37(re)3.307 G(adline).37 E F0(will)3.307 E .907(use the shorter b)
144 564 R .907(ut complete k)-.2 F 1.207 -.15(ey s)-.1 H 3.407
(equence. The).15 F -.25(va)3.407 G .907
(lue is speci\214ed in milliseconds, so a v).25 F .906(alue of)-.25 F
.05(1000 means that)144 576 R F2 -.37(re)2.55 G(adline).37 E F0 .05
(will w)2.55 F .05(ait one second for additional input.)-.1 F .05
(If this v)5.05 F .05(ariable is set to a v)-.25 F(alue)-.25 E .051
(less than or equal to zero, or to a non-numeric v)144 588 R(alue,)-.25
E F2 -.37(re)2.551 G(adline).37 E F0 .051(will w)2.551 F .051
(ait until another k)-.1 F .351 -.15(ey i)-.1 H 2.551(sp).15 G(ressed)
-2.551 E(to decide which k)144 600 Q .3 -.15(ey s)-.1 H
(equence to complete.).15 E F1(mark\255dir)108 612 Q(ectories \(On\))
-.18 E F0(If set to)144 624 Q F1(On)2.5 E F0 2.5(,c)C
(ompleted directory names ha)-2.5 E .3 -.15(ve a s)-.2 H(lash appended.)
.15 E F1(mark\255modi\214ed\255lines \(Off\))108 636 Q F0(If set to)144
648 Q F1(On)2.5 E F0 2.5(,h)C(istory lines that ha)-2.5 E .3 -.15(ve b)
-.2 H(een modi\214ed are displayed with a preceding asterisk \().15 E F1
(*)A F0(\).)A F1(mark\255symlink)108 660 Q(ed\255dir)-.1 E
(ectories \(Off\))-.18 E F0 .175(If set to)144 672 R F1(On)2.675 E F0
2.675(,c)C .175
(ompleted names which are symbolic links to directories ha)-2.675 F .475
-.15(ve a s)-.2 H .175(lash appended \(sub-).15 F(ject to the v)144 684
Q(alue of)-.25 E F1(mark\255dir)2.5 E(ectories)-.18 E F0(\).)A F1
(match\255hidden\255\214les \(On\))108 696 Q F0 .193(This v)144 708 R
.193(ariable, when set to)-.25 F F1(On)2.693 E F0 2.693(,c)C .192
(auses readline to match \214les whose names be)-2.693 F .192
(gin with a `.)-.15 F 2.692('\()-.7 G(hidden)-2.692 E .456
(\214les\) when performing \214lename completion.)144 720 R .456
(If set to)5.456 F F1(Off)2.956 E F0 2.956(,t)C .456(he leading `.)
-2.956 F 2.956('m)-.7 G .457(ust be supplied by the)-2.956 F
(GNU Readline 8.2)72 768 Q(2022 September 19)120.405 E(5)190.115 E 0 Cg
EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E
(user in the \214lename to be completed.)144 84 Q/F1 10/Times-Bold@0 SF
(menu\255complete\255display\255pr)108 96 Q(e\214x \(Off\))-.18 E F0
1.586(If set to)144 108 R F1(On)4.086 E F0 4.086(,m)C 1.585(enu complet\
ion displays the common pre\214x of the list of possible completions)
-4.086 F(\(which may be empty\) before c)144 120 Q
(ycling through the list.)-.15 E F1(output\255meta \(Off\))108 132 Q F0
.506(If set to)144 144 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 me\
ta-)-3.006 F(pre\214x)144 156 Q .885(ed escape sequence.)-.15 F .884
(The def)5.884 F .884(ault is)-.1 F/F2 10/Times-Italic@0 SF(Of)3.384 E
(f)-.18 E F0 3.384(,b)C .884(ut readline will set it to)-3.584 F F2(On)
3.384 E F0 .884(if the locale contains)3.384 F 1.866
(eight-bit characters.)144 168 R 1.866(This v)6.866 F 1.867
(ariable is dependent on the)-.25 F F1(LC_CTYPE)4.367 E F0 1.867
(locale cate)4.367 F(gory)-.15 E 4.367(,a)-.65 G 1.867(nd may)-4.367 F
(change if the locale is changed.)144 180 Q F1
(page\255completions \(On\))108 192 Q F0 .809(If set to)144 204 R F1(On)
3.308 E F0 3.308(,r)C .808(eadline uses an internal)-3.308 F F2(mor)
3.308 E(e)-.37 E F0(-lik)A 3.308(ep)-.1 G .808
(ager to display a screenful of possible comple-)-3.308 F
(tions at a time.)144 216 Q F1
(print\255completions\255horizontally \(Off\))108 228 Q F0 .227
(If set to)144 240 R F1(On)2.727 E F0 2.727(,r)C .227(eadline will disp\
lay completions with matches sorted horizontally in alphabetical or)
-2.727 F(-)-.2 E(der)144 252 Q 2.5(,r)-.4 G(ather than do)-2.5 E
(wn the screen.)-.25 E F1 -2.29 -.18(re v)108 264 T
(ert\255all\255at\255newline \(Off\)).08 E F0 .699(If set to)144 276 R
F1(On)3.199 E F0 3.199(,r)C .699
(eadline will undo all changes to history lines before returning when)
-3.199 F F1(accept\255line)3.198 E F0(is)3.198 E -.15(exe)144 288 S
2.686(cuted. By).15 F(def)2.686 E .186
(ault, history lines may be modi\214ed and retain indi)-.1 F .186
(vidual undo lists across calls to)-.25 F F1 -.18(re)144 300 S(adline)
.18 E F0(.)A F1(sho)108 312 Q(w\255all\255if\255ambiguous \(Off\))-.1 E
F0 .304(This alters the def)144 324 R .304(ault beha)-.1 F .304
(vior of the completion functions.)-.2 F .304(If set to)5.304 F F1(On)
2.804 E F0 2.803(,w)C .303(ords which ha)-2.903 F .603 -.15(ve m)-.2 H
(ore).15 E 1.264(than one possible completion cause the matches to be l\
isted immediately instead of ringing the)144 336 R(bell.)144 348 Q F1
(sho)108 360 Q(w\255all\255if\255unmodi\214ed \(Off\))-.1 E F0 5.346
(This alters the def)144 372 R 5.346(ault beha)-.1 F 5.345
(vior of the completion functions in a f)-.2 F 5.345(ashion similar to)
-.1 F F1(sho)144 384 Q(w\255all\255if\255ambiguous)-.1 E F0 6.69(.I)C
4.19(fs)-6.69 G 1.691(et to)-4.19 F F1(On)4.191 E F0 4.191(,w)C 1.691
(ords which ha)-4.291 F 1.991 -.15(ve m)-.2 H 1.691
(ore than one possible completion).15 F 1.04(without an)144 396 R 3.54
(yp)-.15 G 1.039
(ossible partial completion \(the possible completions don')-3.54 F
3.539(ts)-.18 G 1.039(hare a common pre\214x\))-3.539 F(cause the match\
es to be listed immediately instead of ringing the bell.)144 408 Q F1
(sho)108 420 Q(w\255mode\255in\255pr)-.1 E(ompt \(Off\))-.18 E F0 1.021
(If set to)144 432 R F1(On)3.521 E F0 3.521(,a)C 1.022
(dd a string to the be)-3.521 F 1.022
(ginning of the prompt indicating the editing mode: emacs, vi)-.15 F
(command, or vi insertion.)144 444 Q(The mode strings are user)5 E
(-settable \(e.g.,)-.2 E F2(emacs\255mode\255string)2.5 E F0(\).)A F1
(skip\255completed\255text \(Off\))108 456 Q F0 .095(If set to)144 468 R
F1(On)2.595 E F0 2.595(,t)C .095(his alters the def)-2.595 F .095
(ault completion beha)-.1 F .094
(vior when inserting a single match into the line.)-.2 F(It')144 480 Q
2.545(so)-.55 G .045(nly acti)-2.545 F .345 -.15(ve w)-.25 H .046
(hen performing completion in the middle of a w).15 F 2.546(ord. If)-.1
F .046(enabled, readline does not)2.546 F 1.394(insert characters from \
the completion that match characters after point in the w)144 492 R
1.394(ord being com-)-.1 F(pleted, so portions of the w)144 504 Q
(ord follo)-.1 E(wing the cursor are not duplicated.)-.25 E F1
(vi\255cmd\255mode\255string \(\(cmd\)\))108 516 Q F0 .517(If the)144
528 R F2(show\255mode\255in\255pr)3.017 E(ompt)-.45 E F0 -.25(va)3.017 G
.518(riable is enabled, this string is displayed immediately before the)
.25 F .475(last line of the primary prompt when vi editing mode is acti)
144 540 R .775 -.15(ve a)-.25 H .475(nd in command mode.).15 F .475
(The v)5.475 F(alue)-.25 E .33(is e)144 552 R .33(xpanded lik)-.15 F
2.83(eak)-.1 G .63 -.15(ey b)-2.93 H .33
(inding, so the standard set of meta- and control pre\214x).15 F .33
(es and backslash es-)-.15 F .245(cape sequences is a)144 564 R -.25(va)
-.2 G 2.745(ilable. Use).25 F .244(the \\1 and \\2 escapes to be)2.745 F
.244(gin and end sequences of non-printing)-.15 F(characters, which can\
 be used to embed a terminal control sequence into the mode string.)144
576 Q F1(vi\255ins\255mode\255string \(\(ins\)\))108 588 Q F0 .517
(If the)144 600 R F2(show\255mode\255in\255pr)3.017 E(ompt)-.45 E F0
-.25(va)3.017 G .518
(riable is enabled, this string is displayed immediately before the).25
F .186(last line of the primary prompt when vi editing mode is acti)144
612 R .486 -.15(ve a)-.25 H .186(nd in insertion mode.).15 F .186(The v)
5.186 F .186(alue is)-.25 F -.15(ex)144 624 S .923(panded lik).15 F
3.423(eak)-.1 G 1.223 -.15(ey b)-3.523 H .924
(inding, so the standard set of meta- and control pre\214x).15 F .924
(es and backslash es-)-.15 F .245(cape sequences is a)144 636 R -.25(va)
-.2 G 2.745(ilable. Use).25 F .244(the \\1 and \\2 escapes to be)2.745 F
.244(gin and end sequences of non-printing)-.15 F(characters, which can\
 be used to embed a terminal control sequence into the mode string.)144
648 Q F1(visible\255stats \(Off\))108 660 Q F0 .846(If set to)144 672 R
F1(On)3.346 E F0 3.346(,ac)C .846(haracter denoting a \214le')-3.346 F
3.346(st)-.55 G .846(ype as reported by)-3.346 F F2(stat)3.346 E F0 .846
(\(2\) is appended to the \214lename)B
(when listing possible completions.)144 684 Q F1(Conditional Constructs)
87 700.8 Q F0 .05(Readline implements a f)108 712.8 R .05(acility simil\
ar in spirit to the conditional compilation features of the C preproces\
sor)-.1 F .096(which allo)108 724.8 R .096(ws k)-.25 F .396 -.15(ey b)
-.1 H .096(indings and v).15 F .096
(ariable settings to be performed as the result of tests.)-.25 F .097
(There are four parser)5.096 F(GNU Readline 8.2)72 768 Q
(2022 September 19)120.405 E(6)190.115 E 0 Cg EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E(directi)108 84 Q -.15
(ve)-.25 G 2.5(su).15 G(sed.)-2.5 E/F1 10/Times-Bold@0 SF($if)108 100.8
Q F0(The)144 100.8 Q F1($if)2.963 E F0 .463(construct allo)2.963 F .462
(ws bindings to be made based on the editing mode, the terminal being u\
sed,)-.25 F .961(or the application using readline.)144 112.8 R .961
(The te)5.961 F .961(xt of the test, after an)-.15 F 3.462(yc)-.15 G
.962(omparison operator)-3.462 F 3.462(,e)-.4 G .962(xtends to)-3.612 F
(the end of the line; unless otherwise noted, no characters are require\
d to isolate it.)144 124.8 Q F1(mode)144 141.6 Q F0(The)180 141.6 Q F1
(mode=)3.712 E F0 1.212(form of the)3.712 F F1($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)-3.711 F 3.065
(mode. This)180 153.6 R .565(may be used in conjunction with the)3.065 F
F1 .565(set k)3.065 F(eymap)-.1 E F0 .565(command, for instance, to)
3.065 F .03(set bindings in the)180 165.6 R/F2 10/Times-Italic@0 SF
(emacs-standar)2.529 E(d)-.37 E F0(and)2.529 E F2(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 177.6 Q F1(term)144 194.4 Q F0(The)180 194.4 Q F1
(term=)3.196 E F0 .696
(form may be used to include terminal-speci\214c k)3.196 F .996 -.15
(ey b)-.1 H .697(indings, perhaps to bind).15 F .654(the k)180 206.4 R
.954 -.15(ey s)-.1 H .654(equences output by the terminal').15 F 3.154
(sf)-.55 G .654(unction k)-3.154 F -.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 218.4 Q F1(=)3.003
E F0 .503(is tested ag)3.003 F .504(ainst the full name of the terminal\
 and the portion of the terminal name)-.05 F(before the \214rst)180
230.4 Q F1<ad>2.5 E F0 5(.T)C(his allo)-5 E(ws)-.25 E F2(sun)2.84 E F0
(to match both)2.74 E F2(sun)2.84 E F0(and)2.74 E F2(sun\255cmd)2.84 E
F0 2.5(,f).77 G(or instance.)-2.5 E F1 -.1(ve)144 247.2 S(rsion).1 E F0
(The)180 259.2 Q F1 -.1(ve)3.109 G(rsion).1 E F0 .608
(test may be used to perform comparisons ag)3.109 F .608
(ainst speci\214c readline v)-.05 F(ersions.)-.15 E(The)180 271.2 Q F1
-.1(ve)2.771 G(rsion).1 E F0 -.15(ex)2.771 G .271
(pands to the current readline v).15 F 2.772(ersion. The)-.15 F .272
(set of comparison operators in-)2.772 F(cludes)180 283.2 Q F1(=)3.064 E
F0 3.064(,\()C(and)-3.064 E F1(==)3.064 E F0(\),)A F1(!=)3.064 E F0(,)A
F1(<=)3.064 E F0(,)A F1(>=)3.064 E F0(,)A F1(<)3.064 E F0 3.064(,a)C(nd)
-3.064 E F1(>)3.064 E F0 5.563(.T)C .563(he v)-5.563 F .563
(ersion number supplied on the right side)-.15 F .318
(of the operator consists of a major v)180 295.2 R .318(ersion number)
-.15 F 2.818(,a)-.4 G 2.818(no)-2.818 G .318
(ptional decimal point, and an op-)-2.818 F .101(tional minor v)180
307.2 R .101(ersion \(e.g.,)-.15 F F1(7.1)2.601 E F0 .101
(\). If the minor v)B .1(ersion is omitted, it is assumed to be)-.15 F
F1(0)2.6 E F0 5.1(.T)C(he)-5.1 E .06
(operator may be separated from the string)180 319.2 R F1 -.1(ve)2.56 G
(rsion).1 E F0 .06(and from the v)2.56 F .06(ersion number ar)-.15 F
(gument)-.18 E(by whitespace.)180 331.2 Q F1(application)144 348 Q F0
(The)180 360 Q F1(application)3.003 E F0 .503
(construct is used to include application-speci\214c settings.)3.003 F
.503(Each program)5.503 F .114(using the readline library sets the)180
372 R F2 .114(application name)2.614 F F0 2.614(,a)C .114
(nd an initialization \214le can test for a)-2.614 F .501(particular v)
180 384 R 3.001(alue. This)-.25 F .501(could be used to bind k)3.001 F
.801 -.15(ey s)-.1 H .5(equences to functions useful for a spe-).15 F
.396(ci\214c program.)180 396 R -.15(Fo)5.396 G 2.896(ri).15 G .396
(nstance, the follo)-2.896 F .396(wing command adds a k)-.25 F .696 -.15
(ey s)-.1 H .397(equence that quotes the).15 F(current or pre)180 408 Q
(vious w)-.25 E(ord in)-.1 E F1(bash)2.5 E F0(:)A F1($if)180 432 Q F0
(Bash)2.5 E 2.5(#Q)180 444 S(uote the current or pre)-2.5 E(vious w)-.25
E(ord)-.1 E("\\C-xq": "\\eb\\"\\ef\\"")180 456 Q F1($endif)180 468 Q F2
(variable)144 484.8 Q F0(The)180 496.8 Q F2(variable)3.777 E F0 1.277
(construct pro)3.777 F 1.276(vides simple equality tests for readline v)
-.15 F 1.276(ariables and v)-.25 F(alues.)-.25 E .079
(The permitted comparison operators are)180 508.8 R F2(=)2.579 E F0(,)A
F2(==)2.579 E F0 2.579(,a)C(nd)-2.579 E F2(!=)2.579 E F0 5.079(.T)C .079
(he v)-5.079 F .08(ariable name must be sepa-)-.25 F .98(rated from the\
 comparison operator by whitespace; the operator may be separated from)
180 520.8 R .129(the v)180 532.8 R .129
(alue on the right hand side by whitespace.)-.25 F .13
(Both string and boolean v)5.129 F .13(ariables may be)-.25 F
(tested. Boolean v)180 544.8 Q(ariables must be tested ag)-.25 E
(ainst the v)-.05 E(alues)-.25 E F2(on)2.5 E F0(and)2.5 E F2(of)2.5 E(f)
-.18 E F0(.)A F1($endif)108 561.6 Q F0(This command, as seen in the pre)
144 561.6 Q(vious e)-.25 E(xample, terminates an)-.15 E F1($if)2.5 E F0
(command.)2.5 E F1($else)108 578.4 Q F0(Commands in this branch of the)
144 578.4 Q F1($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 F1($include)108
595.2 Q F0 .357(This directi)144 607.2 R .657 -.15(ve t)-.25 H(ak).15 E
.357(es a single \214lename as an ar)-.1 F .356
(gument and reads commands and bindings from that)-.18 F 2.5(\214le. F)
144 619.2 R(or e)-.15 E(xample, the follo)-.15 E(wing directi)-.25 E .3
-.15(ve w)-.25 H(ould read).05 E F2(/etc/inputr)2.5 E(c)-.37 E F0(:)A F1
($include)144 643.2 Q F2(/etc/inputr)5.833 E(c)-.37 E/F3 10.95
/Times-Bold@0 SF(SEARCHING)72 660 Q F0 1.003(Readline pro)108 672 R
1.003(vides commands for searching through the command history for line\
s containing a speci\214ed)-.15 F 2.5(string. There)108 684 R(are tw)2.5
E 2.5(os)-.1 G(earch modes:)-2.5 E F2(incr)2.51 E(emental)-.37 E F0(and)
3.01 E F2(non-incr)2.86 E(emental)-.37 E F0(.).51 E .698
(Incremental searches be)108 700.8 R .698
(gin before the user has \214nished typing the search string.)-.15 F
.697(As each character of the)5.697 F .112
(search string is typed, readline displays the ne)108 712.8 R .112
(xt entry from the history matching the string typed so f)-.15 F(ar)-.1
E 5.113(.A)-.55 G(n)-5.113 E .545
(incremental search requires only as man)108 724.8 R 3.045(yc)-.15 G
.544(haracters as needed to \214nd the desired history entry)-3.045 F
5.544(.T)-.65 G 3.044(os)-6.344 G(earch)-3.044 E(GNU Readline 8.2)72 768
Q(2022 September 19)120.405 E(7)190.115 E 0 Cg EP
%%Page: 8 8
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E(backw)108 84 Q .18
(ard in the history for a particular string, type)-.1 F/F1 10
/Times-Bold@0 SF(C\255r)2.681 E F0 5.181(.T)C(yping)-5.981 E F1(C\255s)
2.681 E F0 .181(searches forw)2.681 F .181(ard through the history)-.1 F
(.)-.65 E .354(The characters present in the v)108 96 R .354
(alue of the)-.25 F F1(isear)2.854 E(ch-terminators)-.18 E F0 -.25(va)
2.854 G .354(riable are used to terminate an incremen-).25 F .6
(tal search.)108 108 R .6(If that v)5.6 F .6
(ariable has not been assigned a v)-.25 F .6(alue the)-.25 F/F2 10
/Times-Italic@0 SF(Escape)3.1 E F0(and)3.1 E F1(C\255J)3.1 E F0 .6
(characters will terminate an)3.1 F .123(incremental search.)108 120 R
F1(C\255G)5.123 E F0 .123
(will abort an incremental search and restore the original line.)2.623 F
.122(When the search is)5.122 F(terminated, the history entry containin\
g the search string becomes the current line.)108 132 Q 2.406 -.8
(To \214)108 148.8 T .806
(nd other matching entries in the history list, type).8 F F1(C\255s)
3.306 E F0(or)3.306 E F1(C\255r)3.306 E F0 .806(as appropriate.)3.306 F
.807(This will search back-)5.806 F -.1(wa)108 160.8 S .536(rd or forw)
.1 F .536(ard in the history for the ne)-.1 F .535
(xt line matching the search string typed so f)-.15 F(ar)-.1 E 5.535(.A)
-.55 G .835 -.15(ny o)-5.535 H .535(ther k).15 F .835 -.15(ey s)-.1 H
(e-).15 E .384
(quence bound to a readline command will terminate the search and e)108
172.8 R -.15(xe)-.15 G .385(cute that command.).15 F -.15(Fo)5.385 G
2.885(ri).15 G .385(nstance, a)-2.885 F(ne)108 184.8 Q .338
(wline will terminate the search and accept the line, thereby e)-.25 F
-.15(xe)-.15 G .337(cuting the command from the history list.).15 F
2.997(Am)108 196.8 S -.15(ove)-2.997 G .497
(ment command will terminate the search, mak).15 F 2.997(et)-.1 G .497
(he last line found the current line, and be)-2.997 F .498(gin edit-)
-.15 F(ing.)108 208.8 Q .567(Non-incremental searches read the entire s\
earch string before starting to search for matching history lines.)108
225.6 R(The search string may be typed by the user or be part of the co\
ntents of the current line.)108 237.6 Q/F3 10.95/Times-Bold@0 SF
(EDITING COMMANDS)72 254.4 Q F0 1.391(The follo)108 266.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)-3.892 E 2.5(bound. Command)108 278.4 R
(names without an accompan)2.5 E(ying k)-.15 E .3 -.15(ey s)-.1 H
(equence are unbound by def).15 E(ault.)-.1 E .055(In the follo)108
295.2 R .055(wing descriptions,)-.25 F F2(point)2.555 E F0 .055
(refers to the current cursor position, and)2.555 F F2(mark)2.555 E F0
.054(refers to a cursor position)2.554 F(sa)108 307.2 Q -.15(ve)-.2 G
2.5(db).15 G 2.5(yt)-2.5 G(he)-2.5 E F1(set\255mark)2.5 E F0 2.5
(command. The)2.5 F(te)2.5 E
(xt between the point and mark is referred to as the)-.15 E F2 -.37(re)
2.5 G(gion)-.03 E F0(.)A F1(Commands f)87 324 Q(or Mo)-.25 E(ving)-.1 E
(beginning\255of\255line \(C\255a\))108 336 Q F0(Mo)144 348 Q .3 -.15
(ve t)-.15 H 2.5(ot).15 G(he start of the current line.)-2.5 E F1
(end\255of\255line \(C\255e\))108 360 Q F0(Mo)144 372 Q .3 -.15(ve t)
-.15 H 2.5(ot).15 G(he end of the line.)-2.5 E F1 -.25(fo)108 384 S
(rward\255char \(C\255f\)).25 E F0(Mo)144 396 Q .3 -.15(ve f)-.15 H(orw)
.15 E(ard a character)-.1 E(.)-.55 E F1(backward\255char \(C\255b\))108
408 Q F0(Mo)144 420 Q .3 -.15(ve b)-.15 H(ack a character).15 E(.)-.55 E
F1 -.25(fo)108 432 S(rward\255w).25 E(ord \(M\255f\))-.1 E F0(Mo)144 444
Q .822 -.15(ve f)-.15 H(orw).15 E .522(ard to the end of the ne)-.1 F
.523(xt w)-.15 F 3.023(ord. W)-.1 F .523
(ords are composed of alphanumeric characters \(let-)-.8 F
(ters and digits\).)144 456 Q F1(backward\255w)108 468 Q(ord \(M\255b\))
-.1 E F0(Mo)144 480 Q 1.71 -.15(ve b)-.15 H 1.41
(ack to the start of the current or pre).15 F 1.41(vious w)-.25 F 3.91
(ord. W)-.1 F 1.41(ords are composed of alphanumeric)-.8 F
(characters \(letters and digits\).)144 492 Q F1(pr)108 504 Q -.15(ev)
-.18 G(ious\255scr).15 E(een\255line)-.18 E F0 .89(Attempt to mo)144 516
R 1.19 -.15(ve p)-.15 H .89(oint to the same ph).15 F .891
(ysical screen column on the pre)-.05 F .891(vious ph)-.25 F .891
(ysical screen line.)-.05 F 1.056(This will not ha)144 528 R 1.356 -.15
(ve t)-.2 H 1.056(he desired ef).15 F 1.056
(fect if the current readline line does not tak)-.25 F 3.555(eu)-.1 G
3.555(pm)-3.555 G 1.055(ore than one)-3.555 F(ph)144 540 Q(ysical line \
or if point is not greater than the length of the prompt plus the scree\
n width.)-.05 E F1(next\255scr)108 552 Q(een\255line)-.18 E F0 .637
(Attempt to mo)144 564 R .937 -.15(ve p)-.15 H .637(oint to the same ph)
.15 F .638(ysical screen column on the ne)-.05 F .638(xt ph)-.15 F .638
(ysical screen line. This)-.05 F .195(will not ha)144 576 R .495 -.15
(ve t)-.2 H .195(he desired ef).15 F .194
(fect if the current readline line does not tak)-.25 F 2.694(eu)-.1 G
2.694(pm)-2.694 G .194(ore than one ph)-2.694 F(ysical)-.05 E .164(line\
 or if the length of the current readline line is not greater than the \
length of the prompt plus the)144 588 R(screen width.)144 600 Q F1
(clear\255display \(M\255C\255l\))108 612 Q F0 1.499
(Clear the screen and, if possible, the terminal')144 624 R 3.999(ss)
-.55 G 1.498(crollback b)-3.999 F(uf)-.2 E(fer)-.25 E 3.998(,t)-.4 G
1.498(hen redra)-3.998 F 3.998(wt)-.15 G 1.498(he current line,)-3.998 F
(lea)144 636 Q(ving the current line at the top of the screen.)-.2 E F1
(clear\255scr)108 648 Q(een \(C\255l\))-.18 E F0 1.36
(Clear the screen, then redra)144 660 R 3.86(wt)-.15 G 1.36
(he current line, lea)-3.86 F 1.36
(ving the current line at the top of the screen.)-.2 F -.4(Wi)144 672 S
(th an ar).4 E
(gument, refresh the current line without clearing the screen.)-.18 E F1
-.18(re)108 684 S(draw\255curr).18 E(ent\255line)-.18 E F0
(Refresh the current line.)144 696 Q(GNU Readline 8.2)72 768 Q
(2022 September 19)120.405 E(8)190.115 E 0 Cg EP
%%Page: 9 9
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(Commands f)87 84 Q(or Manipulating the History)-.25 E
(accept\255line \(Newline, Retur)108 96 Q(n\))-.15 E F0 .365
(Accept the line re)144 108 R -.05(ga)-.15 G .364
(rdless of where the cursor is.).05 F .364(If this line is non-empty)
5.364 F 2.864(,i)-.65 G 2.864(tm)-2.864 G .364(ay be added to the)-2.864
F .74(history list for future recall with)144 120 R F1(add_history\(\))
3.24 E F0 5.741(.I)C 3.241(ft)-5.741 G .741
(he line is a modi\214ed history line, the history)-3.241 F
(line is restored to its original state.)144 132 Q F1(pr)108 144 Q -.15
(ev)-.18 G(ious\255history \(C\255p\)).15 E F0(Fetch the pre)144 156 Q
(vious command from the history list, mo)-.25 E(ving back in the list.)
-.15 E F1(next\255history \(C\255n\))108 168 Q F0(Fetch the ne)144 180 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 192
Q F0(Mo)144 204 Q .3 -.15(ve t)-.15 H 2.5(ot).15 G
(he \214rst line in the history)-2.5 E(.)-.65 E F1
(end\255of\255history \(M\255>\))108 216 Q F0(Mo)144 228 Q .3 -.15(ve t)
-.15 H 2.5(ot).15 G(he end of the input history)-2.5 E 2.5(,i)-.65 G
(.e., the line currently being entered.)-2.5 E F1
(operate\255and\255get\255next \(C\255o\))108 240 Q F0 .733(Accept the \
current line for return to the calling application as if a ne)144 252 R
.733(wline had been entered, and)-.25 F .367(fetch the ne)144 264 R .367
(xt line relati)-.15 F .667 -.15(ve t)-.25 H 2.867(ot).15 G .367
(he current line from the history for editing.)-2.867 F 2.867(An)5.367 G
.367(umeric ar)-2.867 F .368(gument, if)-.18 F(supplied, speci\214es th\
e history entry to use instead of the current line.)144 276 Q F1
(fetch\255history)108 288 Q F0 -.4(Wi)144 300 S .257(th a numeric ar).4
F .257(gument, fetch that entry from the history list and mak)-.18 F
2.756(ei)-.1 G 2.756(tt)-2.756 G .256(he current line.)-2.756 F -.4(Wi)
5.256 G(th-).4 E(out an ar)144 312 Q(gument, mo)-.18 E .3 -.15(ve b)-.15
H(ack to the \214rst entry in the history list.).15 E F1 -2.29 -.18
(re v)108 324 T(erse\255sear).08 E(ch\255history \(C\255r\))-.18 E F0
1.47(Search backw)144 336 R 1.471
(ard starting at the current line and mo)-.1 F 1.471
(ving `up' through the history as necessary)-.15 F(.)-.65 E
(This is an incremental search.)144 348 Q F1 -.25(fo)108 360 S
(rward\255sear).25 E(ch\255history \(C\255s\))-.18 E F0 1.132
(Search forw)144 372 R 1.132(ard starting at the current line and mo)-.1
F 1.131(ving `do)-.15 F 1.131(wn' through the history as necessary)-.25
F(.)-.65 E(This is an incremental search.)144 384 Q F1(non\255incr)108
396 Q(emental\255r)-.18 E -2.3 -.15(ev e)-.18 H(rse\255sear).15 E
(ch\255history \(M\255p\))-.18 E F0 .164(Search backw)144 408 R .164(ar\
d through the history starting at the current line using a non-incremen\
tal search for)-.1 F 2.5(as)144 420 S(tring supplied by the user)-2.5 E
(.)-.55 E F1(non\255incr)108 432 Q(emental\255f)-.18 E(orward\255sear)
-.25 E(ch\255history \(M\255n\))-.18 E F0 1.354(Search forw)144 444 R
1.354(ard through the history using a non-incremental search for a stri\
ng supplied by the)-.1 F(user)144 456 Q(.)-.55 E F1(history\255sear)108
468 Q(ch\255backward)-.18 E F0 .95(Search backw)144 480 R .951(ard thro\
ugh the history for the string of characters between the start of the c\
urrent)-.1 F .12(line and the current cursor position \(the)144 492 R/F2
10/Times-Italic@0 SF(point)2.62 E F0 2.62(\). The)B .12
(search string must match at the be)2.62 F .12(ginning of a)-.15 F
(history line.)144 504 Q(This is a non-incremental search.)5 E F1
(history\255sear)108 516 Q(ch\255f)-.18 E(orward)-.25 E F0 .248
(Search forw)144 528 R .249(ard through the history for the string of c\
haracters between the start of the current line)-.1 F .036
(and the point.)144 540 R .036(The search string must match at the be)
5.036 F .035(ginning of a history line.)-.15 F .035
(This is a non-incre-)5.035 F(mental search.)144 552 Q F1
(history\255substring\255sear)108 564 Q(ch\255backward)-.18 E F0 .95
(Search backw)144 576 R .951(ard through the history for the string of \
characters between the start of the current)-.1 F .007
(line and the current cursor position \(the)144 588 R F2(point)2.507 E
F0 2.507(\). The)B .007(search string may match an)2.507 F .006
(ywhere in a history)-.15 F 2.5(line. This)144 600 R
(is a non-incremental search.)2.5 E F1(history\255substring\255sear)108
612 Q(ch\255f)-.18 E(orward)-.25 E F0 .248(Search forw)144 624 R .249(a\
rd through the history for the string of characters between the start o\
f the current line)-.1 F .319(and the point.)144 636 R .319
(The search string may match an)5.319 F .319(ywhere in a history line.)
-.15 F .318(This is a non-incremental)5.318 F(search.)144 648 Q F1
(yank\255nth\255ar)108 660 Q 2.5(g\()-.1 G<4dad43ad7929>-2.5 E F0 .622
(Insert the \214rst ar)144 672 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 .773(at point.)144 684 R -.4(Wi)5.773 G .773
(th an ar).4 F(gument)-.18 E F2(n)3.633 E F0 3.273(,i).24 G .773
(nsert the)-3.273 F F2(n)3.273 E F0 .773(th w)B .773(ord from the pre)
-.1 F .773(vious command \(the w)-.25 F .773(ords in the)-.1 F(pre)144
696 Q .291(vious command be)-.25 F .291(gin with w)-.15 F .291(ord 0\).)
-.1 F 2.791(An)5.291 G -2.25 -.15(eg a)-2.791 H(ti).15 E .591 -.15(ve a)
-.25 H -.18(rg).15 G .291(ument inserts the).18 F F2(n)2.791 E F0 .291
(th w)B .292(ord from the end of)-.1 F .282(the pre)144 708 R .282
(vious command.)-.25 F .282(Once the ar)5.282 F(gument)-.18 E F2(n)2.781
E F0 .281(is computed, the ar)2.781 F .281(gument is e)-.18 F .281
(xtracted as if the "!)-.15 F F2(n)A F0(")A(history e)144 720 Q
(xpansion had been speci\214ed.)-.15 E(GNU Readline 8.2)72 768 Q
(2022 September 19)120.405 E(9)190.115 E 0 Cg EP
%%Page: 10 10
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(yank\255last\255ar)108 84 Q 2.5(g\()-.1 G -1.667(M\255. ,)-2.5 F -1.667
(M\255_ \))2.5 F F0 1.307(Insert the last ar)144 96 R 1.307
(gument to the pre)-.18 F 1.307(vious command \(the last w)-.25 F 1.308
(ord of the pre)-.1 F 1.308(vious history entry\).)-.25 F -.4(Wi)144 108
S .204(th a numeric ar).4 F .204(gument, beha)-.18 F .504 -.15(ve ex)-.2
H .204(actly lik).15 F(e)-.1 E F1(yank\255nth\255ar)2.704 E(g)-.1 E F0
5.203(.S)C(uccessi)-5.203 E .503 -.15(ve c)-.25 H .203(alls to).15 F F1
(yank\255last\255ar)2.703 E(g)-.1 E F0(mo)144 120 Q .806 -.15(ve b)-.15
H .507(ack through the history list, inserting the last w).15 F .507
(ord \(or the w)-.1 F .507(ord speci\214ed by the ar)-.1 F(gument)-.18 E
.416(to the \214rst call\) of each line in turn.)144 132 R(An)5.416 E
2.916(yn)-.15 G .416(umeric ar)-2.916 F .416
(gument supplied to these successi)-.18 F .715 -.15(ve c)-.25 H .415
(alls de-).15 F 1.217(termines the direction to mo)144 144 R 1.518 -.15
(ve t)-.15 H 1.218(hrough the history).15 F 6.218(.A)-.65 G(ne)-2.5 E
-.05(ga)-.15 G(ti).05 E 1.518 -.15(ve a)-.25 H -.18(rg).15 G 1.218
(ument switches the direction).18 F .494
(through the history \(back or forw)144 156 R 2.994(ard\). The)-.1 F
.494(history e)2.994 F .494(xpansion f)-.15 F .494
(acilities are used to e)-.1 F .494(xtract the last)-.15 F(ar)144 168 Q
(gument, as if the "!$" history e)-.18 E(xpansion had been speci\214ed.)
-.15 E F1(Commands f)87 184.8 Q(or Changing T)-.25 E(ext)-.92 E/F2 10
/Times-Italic@0 SF(end\255of\255\214le)108 196.8 Q F1
(\(usually C\255d\))2.5 E F0 .798
(The character indicating end-of-\214le as set, for e)144 208.8 R .799
(xample, by)-.15 F/F3 10/Courier@0 SF(stty)3.299 E F0 5.799(.I)C 3.299
(ft)-5.799 G .799(his character is read when)-3.299 F .167
(there are no characters on the line, and point is at the be)144 220.8 R
.167(ginning of the line, readline interprets it as)-.15 F
(the end of input and returns)144 232.8 Q/F4 9/Times-Bold@0 SF(EOF)2.5 E
/F5 9/Times-Roman@0 SF(.)A F1(delete\255char \(C\255d\))108 244.8 Q F0
.441(Delete the character at point.)144 256.8 R .442
(If this function is bound to the same character as the tty)5.441 F F1
(EOF)2.942 E F0(char)2.942 E(-)-.2 E(acter)144 268.8 Q 2.5(,a)-.4 G(s)
-2.5 E F1(C\255d)2.5 E F0(commonly is, see abo)2.5 E .3 -.15(ve f)-.15 H
(or the ef).15 E(fects.)-.25 E F1(backward\255delete\255char \(Rubout\))
108 280.8 Q F0 .553(Delete the character behind the cursor)144 292.8 R
5.553(.W)-.55 G .553(hen gi)-5.553 F -.15(ve)-.25 G 3.053(nan).15 G .553
(umeric ar)-3.053 F .552(gument, sa)-.18 F .852 -.15(ve t)-.2 H .552
(he deleted te).15 F .552(xt on)-.15 F(the kill ring.)144 304.8 Q F1
-.25(fo)108 316.8 S(rward\255backward\255delete\255char).25 E F0 .473
(Delete the character under the cursor)144 328.8 R 2.973(,u)-.4 G .474
(nless the cursor is at the end of the line, in which case the)-2.973 F
(character behind the cursor is deleted.)144 340.8 Q F1
(quoted\255insert \(C\255q, C\255v\))108 352.8 Q F0 1.229(Add the ne)144
364.8 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.728(wt)-.25 G 3.728(oi)
-3.728 G 1.228(nsert characters lik)-3.728 F(e)-.1 E F1(C\255q)144 376.8
Q F0 2.5(,f)C(or e)-2.5 E(xample.)-.15 E F1(tab\255insert \(M-T)108
388.8 Q(AB\))-.9 E F0(Insert a tab character)144 400.8 Q(.)-.55 E F1
(self\255insert \(a, b, A, 1, !, ...\))108 412.8 Q F0
(Insert the character typed.)144 424.8 Q F1
(transpose\255chars \(C\255t\))108 436.8 Q F0 .321
(Drag the character before point forw)144 448.8 R .321(ard o)-.1 F -.15
(ve)-.15 G 2.821(rt).15 G .321(he character at point, mo)-2.821 F .322
(ving point forw)-.15 F .322(ard as well.)-.1 F .372
(If point is at the end of the line, then this transposes the tw)144
460.8 R 2.872(oc)-.1 G .372(haracters before point.)-2.872 F(Ne)5.372 E
-.05(ga)-.15 G(ti).05 E .672 -.15(ve a)-.25 H -.2(r-).15 G(guments ha)
144 472.8 Q .3 -.15(ve n)-.2 H 2.5(oe).15 G -.25(ff)-2.5 G(ect.).25 E F1
(transpose\255w)108 484.8 Q(ords \(M\255t\))-.1 E F0 .023(Drag the w)144
496.8 R .023(ord before point past the w)-.1 F .023(ord after point, mo)
-.1 F .023(ving point o)-.15 F -.15(ve)-.15 G 2.524(rt).15 G .024(hat w)
-2.524 F .024(ord as well.)-.1 F .024(If point)5.024 F
(is at the end of the line, this transposes the last tw)144 508.8 Q 2.5
(ow)-.1 G(ords on the line.)-2.6 E F1(upcase\255w)108 520.8 Q
(ord \(M\255u\))-.1 E F0 1.699(Uppercase the current \(or follo)144
532.8 R 1.698(wing\) w)-.25 F 4.198(ord. W)-.1 F 1.698(ith a ne)-.4 F
-.05(ga)-.15 G(ti).05 E 1.998 -.15(ve a)-.25 H -.18(rg).15 G 1.698
(ument, uppercase the pre).18 F(vious)-.25 E -.1(wo)144 544.8 S(rd, b).1
E(ut do not mo)-.2 E .3 -.15(ve p)-.15 H(oint.).15 E F1(do)108 556.8 Q
(wncase\255w)-.1 E(ord \(M\255l\))-.1 E F0(Lo)144 568.8 Q 1.647
(wercase the current \(or follo)-.25 F 1.647(wing\) w)-.25 F 4.147
(ord. W)-.1 F 1.648(ith a ne)-.4 F -.05(ga)-.15 G(ti).05 E 1.948 -.15
(ve a)-.25 H -.18(rg).15 G 1.648(ument, lo).18 F 1.648(wercase the pre)
-.25 F(vious)-.25 E -.1(wo)144 580.8 S(rd, b).1 E(ut do not mo)-.2 E .3
-.15(ve p)-.15 H(oint.).15 E F1(capitalize\255w)108 592.8 Q
(ord \(M\255c\))-.1 E F0 1.975(Capitalize the current \(or follo)144
604.8 R 1.974(wing\) w)-.25 F 4.474(ord. W)-.1 F 1.974(ith a ne)-.4 F
-.05(ga)-.15 G(ti).05 E 2.274 -.15(ve a)-.25 H -.18(rg).15 G 1.974
(ument, capitalize the pre).18 F(vious)-.25 E -.1(wo)144 616.8 S(rd, b)
.1 E(ut do not mo)-.2 E .3 -.15(ve p)-.15 H(oint.).15 E F1 -.1(ove)108
628.8 S(rwrite\255mode).1 E F0 -.8(To)144 640.8 S .437(ggle o).8 F -.15
(ve)-.15 G .437(rwrite mode.).15 F -.4(Wi)5.437 G .437(th an e).4 F .437
(xplicit positi)-.15 F .738 -.15(ve n)-.25 H .438(umeric ar).15 F .438
(gument, switches to o)-.18 F -.15(ve)-.15 G .438(rwrite mode.).15 F -.4
(Wi)144 652.8 S .781(th an e).4 F .781(xplicit non-positi)-.15 F 1.081
-.15(ve n)-.25 H .781(umeric ar).15 F .781
(gument, switches to insert mode.)-.18 F .78(This command af)5.781 F
(fects)-.25 E(only)144 664.8 Q F1(emacs)4.394 E F0(mode;)4.394 E F1(vi)
4.394 E F0 1.894(mode does o)4.394 F -.15(ve)-.15 G 1.894(rwrite dif).15
F(ferently)-.25 E 6.894(.E)-.65 G 1.894(ach call to)-6.894 F F2 -.37(re)
4.395 G(adline\(\)).37 E F0 1.895(starts in insert)4.395 F 3.969
(mode. In)144 676.8 R -.15(ove)3.969 G 1.469
(rwrite mode, characters bound to).15 F F1(self\255insert)3.969 E F0
1.468(replace the te)3.969 F 1.468(xt at point rather than)-.15 F .957
(pushing the te)144 688.8 R .957(xt to the right.)-.15 F .958
(Characters bound to)5.957 F F1(backward\255delete\255char)3.458 E F0
.958(replace the character)3.458 F(before point with a space.)144 700.8
Q(By def)5 E(ault, this command is unbound.)-.1 E(GNU Readline 8.2)72
768 Q(2022 September 19)120.405 E(10)185.115 E 0 Cg EP
%%Page: 11 11
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(Killing and Y)87 84 Q(anking)-.85 E(kill\255line \(C\255k\))108 96 Q F0
(Kill the te)144 108 Q(xt from point to the end of the line.)-.15 E F1
(backward\255kill\255line \(C\255x Rubout\))108 120 Q F0(Kill backw)144
132 Q(ard to the be)-.1 E(ginning of the line.)-.15 E F1
(unix\255line\255discard \(C\255u\))108 144 Q F0(Kill backw)144 156 Q
(ard from point to the be)-.1 E(ginning of the line.)-.15 E
(The killed te)5 E(xt is sa)-.15 E -.15(ve)-.2 G 2.5(do).15 G 2.5(nt)
-2.5 G(he kill-ring.)-2.5 E F1(kill\255whole\255line)108 168 Q F0
(Kill all characters on the current line, no matter where point is.)144
180 Q F1(kill\255w)108 192 Q(ord \(M\255d\))-.1 E F0 1.308
(Kill from point the end of the current w)144 204 R 1.308
(ord, or if between w)-.1 F 1.308(ords, to the end of the ne)-.1 F 1.307
(xt w)-.15 F(ord.)-.1 E -.8(Wo)144 216 S
(rd 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 228 Q
(ord \(M\255Rubout\))-.1 E F0(Kill the w)144 240 Q(ord behind point.)-.1
E -.8(Wo)5 G(rd boundaries are the same as those used by).8 E F1
(backward\255w)2.5 E(ord)-.1 E F0(.)A F1(unix\255w)108 252 Q
(ord\255rubout \(C\255w\))-.1 E F0 .364(Kill the w)144 264 R .364
(ord behind point, using white space as a w)-.1 F .365(ord boundary)-.1
F 5.365(.T)-.65 G .365(he killed te)-5.365 F .365(xt is sa)-.15 F -.15
(ve)-.2 G 2.865(do).15 G 2.865(nt)-2.865 G(he)-2.865 E(kill-ring.)144
276 Q F1(unix\255\214lename\255rubout)108 288 Q F0 .167(Kill the w)144
300 R .166
(ord behind point, using white space and the slash character as the w)
-.1 F .166(ord boundaries.)-.1 F(The)5.166 E(killed te)144 312 Q
(xt is sa)-.15 E -.15(ve)-.2 G 2.5(do).15 G 2.5(nt)-2.5 G(he kill-ring.)
-2.5 E F1(delete\255horizontal\255space \(M\255\\\))108 324 Q F0
(Delete all spaces and tabs around point.)144 336 Q F1(kill\255r)108 348
Q(egion)-.18 E F0 .301(Kill the te)144 360 R .301
(xt between the point and)-.15 F/F2 10/Times-Italic@0 SF(mark)2.801 E F0
(\(sa)2.801 E -.15(ve)-.2 G 2.801(dc).15 G .301(ursor position\).)-2.801
F .301(This te)5.301 F .301(xt is referred to as the)-.15 F F2 -.37(re)
2.802 G(-).37 E(gion)144 372 Q F0(.)A F1(copy\255r)108 384 Q
(egion\255as\255kill)-.18 E F0(Cop)144 396 Q 2.5(yt)-.1 G(he te)-2.5 E
(xt in the re)-.15 E(gion to the kill b)-.15 E(uf)-.2 E(fer)-.25 E(.)
-.55 E F1(copy\255backward\255w)108 408 Q(ord)-.1 E F0(Cop)144 420 Q
4.801(yt)-.1 G 2.301(he w)-4.801 F 2.301(ord before point to the kill b)
-.1 F(uf)-.2 E(fer)-.25 E 7.301(.T)-.55 G 2.301(he w)-7.301 F 2.3
(ord boundaries are the same as)-.1 F F1(back-)4.8 E(ward\255w)144 432 Q
(ord)-.1 E F0(.)A F1(copy\255f)108 444 Q(orward\255w)-.25 E(ord)-.1 E F0
(Cop)144 456 Q 4.507(yt)-.1 G 2.007(he w)-4.507 F 2.007(ord follo)-.1 F
2.007(wing point to the kill b)-.25 F(uf)-.2 E(fer)-.25 E 7.008(.T)-.55
G 2.008(he w)-7.008 F 2.008(ord boundaries are the same as)-.1 F F1 -.25
(fo)4.508 G -.37(r-).25 G(ward\255w)144 468 Q(ord)-.1 E F0(.)A F1
(yank \(C\255y\))108 480 Q F0 -1(Ya)144 492 S
(nk the top of the kill ring into the b)1 E(uf)-.2 E(fer at point.)-.25
E F1(yank\255pop \(M\255y\))108 504 Q F0
(Rotate the kill ring, and yank the ne)144 516 Q 2.5(wt)-.25 G 2.5
(op. Only)-2.5 F -.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 532.8 Q
(guments)-.1 E(digit\255ar)108 544.8 Q
(gument \(M\2550, M\2551, ..., M\255\255\))-.1 E F0 .367
(Add this digit to the ar)144 556.8 R .367
(gument already accumulating, or start a ne)-.18 F 2.867(wa)-.25 G -.18
(rg)-2.867 G 2.867(ument. M\255\255).18 F .366(starts a ne)2.867 F -.05
(ga)-.15 G(-).05 E(ti)144 568.8 Q .3 -.15(ve a)-.25 H -.18(rg).15 G
(ument.).18 E F1(uni)108 580.8 Q -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1
E F0 .778(This is another w)144 592.8 R .779(ay to specify an ar)-.1 F
3.279(gument. If)-.18 F .779(this command is follo)3.279 F .779
(wed by one or more digits,)-.25 F 1.376
(optionally with a leading minus sign, those digits de\214ne the ar)144
604.8 R 3.876(gument. If)-.18 F 1.376(the command is fol-)3.876 F(lo)144
616.8 Q 1.17(wed by digits, e)-.25 F -.15(xe)-.15 G(cuting).15 E F1(uni)
3.67 E -.1(ve)-.1 G(rsal\255ar).1 E(gument)-.1 E F0(ag)3.67 E 1.17
(ain ends the numeric ar)-.05 F 1.17(gument, b)-.18 F 1.17(ut is other)
-.2 F(-)-.2 E .899(wise ignored.)144 628.8 R .898
(As a special case, if this command is immediately follo)5.899 F .898
(wed by a character that is)-.25 F .243
(neither a digit or minus sign, the ar)144 640.8 R .243
(gument count for the ne)-.18 F .243(xt command is multiplied by four)
-.15 F 5.243(.T)-.55 G(he)-5.243 E(ar)144 652.8 Q .378
(gument count is initially one, so e)-.18 F -.15(xe)-.15 G .378
(cuting this function the \214rst time mak).15 F .378(es the ar)-.1 F
.378(gument count)-.18 F(four)144 664.8 Q 2.5(,as)-.4 G(econd time mak)
-2.5 E(es the ar)-.1 E(gument count sixteen, and so on.)-.18 E F1
(Completing)87 681.6 Q(complete \(T)108 693.6 Q(AB\))-.9 E F0 .681
(Attempt to perform completion on the te)144 705.6 R .681
(xt before point.)-.15 F .682(The actual completion performed is ap-)
5.682 F(plication-speci\214c.)144 717.6 Q F1(Bash)6.244 E F0 3.744(,f)C
1.244(or instance, attempts completion treating the te)-3.744 F 1.244
(xt as a v)-.15 F 1.243(ariable \(if the)-.25 F(te)144 729.6 Q .656
(xt be)-.15 F .656(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.157 E F0 .657(\), or)B(GNU Readline 8.2)72 768
Q(2022 September 19)120.405 E(11)185.115 E 0 Cg EP
%%Page: 12 12
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E .93
(command \(including aliases and functions\) in turn.)144 84 R .929
(If none of these produces a match, \214lename)5.929 F 1.273
(completion is attempted.)144 96 R/F1 10/Times-Bold@0 SF(Gdb)6.273 E F0
3.773(,o)C 3.773(nt)-3.773 G 1.273(he other hand, allo)-3.773 F 1.273
(ws completion of program functions and)-.25 F -.25(va)144 108 S(riable\
s, and only attempts \214lename completion under certain circumstances.)
.25 E F1(possible\255completions \(M\255?\))108 120 Q F0 .262
(List the possible completions of the te)144 132 R .262
(xt before point.)-.15 F .261
(When displaying completions, readline sets)5.261 F 1.002
(the number of columns used for display to the v)144 144 R 1.002
(alue of)-.25 F F1(completion-display-width)3.502 E F0 3.502(,t)C 1.003
(he v)-3.502 F 1.003(alue of)-.25 F(the en)144 156 Q(vironment v)-.4 E
(ariable)-.25 E/F2 9/Times-Bold@0 SF(COLUMNS)2.5 E/F3 9/Times-Roman@0 SF
(,)A F0(or the screen width, in that order)2.25 E(.)-.55 E F1
(insert\255completions \(M\255*\))108 168 Q F0 .783
(Insert all completions of the te)144 180 R .783(xt before point that w)
-.15 F .783(ould ha)-.1 F 1.083 -.15(ve b)-.2 H .783(een generated by)
.15 F F1(possible\255com-)3.282 E(pletions)144 192 Q F0(.)A F1
(menu\255complete)108 204 Q F0 .928(Similar to)144 216 R F1(complete)
3.428 E F0 3.428(,b)C .929(ut replaces the w)-3.628 F .929
(ord to be completed with a single match from the list of)-.1 F 1.194
(possible completions.)144 228 R 1.194(Repeated e)6.194 F -.15(xe)-.15 G
1.194(cution of).15 F F1(menu\255complete)3.694 E F0 1.193
(steps through the list of possible)3.694 F .828
(completions, inserting each match in turn.)144 240 R .828
(At the end of the list of completions, the bell is rung)5.828 F .727
(\(subject to the setting of)144 252 R F1(bell\255style)3.227 E F0 3.227
(\)a)C .727(nd the original te)-3.227 F .727(xt is restored.)-.15 F .727
(An ar)5.727 F .727(gument of)-.18 F/F4 10/Times-Italic@0 SF(n)3.227 E
F0(mo)3.227 E -.15(ve)-.15 G(s).15 E F4(n)3.227 E F0 1.73
(positions forw)144 264 R 1.73(ard in the list of matches; a ne)-.1 F
-.05(ga)-.15 G(ti).05 E 2.03 -.15(ve a)-.25 H -.18(rg).15 G 1.73
(ument may be used to mo).18 F 2.03 -.15(ve b)-.15 H(ackw).15 E(ard)-.1
E(through the list.)144 276 Q(This command is intended to be bound to)5
E F1 -.9(TA)2.5 G(B).9 E F0 2.5(,b)C(ut is unbound by def)-2.7 E(ault.)
-.1 E F1(menu\255complete\255backward)108 288 Q F0 .82(Identical to)144
300 R F1(menu\255complete)3.32 E F0 3.32(,b)C .82(ut mo)-3.52 F -.15(ve)
-.15 G 3.32(sb).15 G(ackw)-3.32 E .82
(ard through the list of possible completions, as if)-.1 F F1
(menu\255complete)144 312 Q F0(had been gi)2.5 E -.15(ve)-.25 G 2.5(nan)
.15 G -2.25 -.15(eg a)-2.5 H(ti).15 E .3 -.15(ve a)-.25 H -.18(rg).15 G
2.5(ument. This).18 F(command is unbound by def)2.5 E(ault.)-.1 E F1
(delete\255char\255or\255list)108 324 Q F0 .373
(Deletes the character under the cursor if not at the be)144 336 R .374
(ginning or end of the line \(lik)-.15 F(e)-.1 E F1(delete-char)2.874 E
F0(\).)A(If at the end of the line, beha)144 348 Q -.15(ve)-.2 G 2.5(si)
.15 G(dentically to)-2.5 E F1(possible-completions)2.5 E F0(.)A F1 -.25
(Ke)87 364.8 S(yboard Macr).25 E(os)-.18 E(start\255kbd\255macr)108
376.8 Q 2.5(o\()-.18 G(C\255x \()-2.5 E(\)).833 E F0(Be)144 388.8 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 400.8 Q 2.5(o\()
-.18 G(C\255x \))-2.5 E(\)).833 E F0(Stop sa)144 412.8 Q
(ving the characters typed into the current k)-.2 E -.15(ey)-.1 G
(board macro and store the de\214nition.).15 E F1
(call\255last\255kbd\255macr)108 424.8 Q 2.5(o\()-.18 G(C\255x e\))-2.5
E F0(Re-e)144 436.8 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 app\
ear as if).15 F(typed at the k)144 448.8 Q -.15(ey)-.1 G(board.).15 E F1
(print\255last\255kbd\255macr)108 460.8 Q 2.5(o\()-.18 G(\))-2.5 E F0
(Print the last k)144 472.8 Q -.15(ey)-.1 G
(board macro de\214ned in a format suitable for the).15 E F4(inputr)2.5
E(c)-.37 E F0(\214le.)2.5 E F1(Miscellaneous)87 489.6 Q -.18(re)108
501.6 S<ad72>.18 E(ead\255init\255\214le \(C\255x C\255r\))-.18 E F0
1.776(Read in the contents of the)144 513.6 R F4(inputr)4.276 E(c)-.37 E
F0 1.777(\214le, and incorporate an)4.276 F 4.277(yb)-.15 G 1.777
(indings or v)-4.277 F 1.777(ariable assignments)-.25 F(found there.)144
525.6 Q F1(abort \(C\255g\))108 537.6 Q F0 3.249
(Abort the current editing command and ring the terminal')144 549.6 R
5.748(sb)-.55 G 3.248(ell \(subject to the setting of)-5.748 F F1
(bell\255style)144 561.6 Q F0(\).)A F1(do\255lo)108 573.6 Q(wer)-.1 E
(case\255v)-.18 E(ersion \(M\255A, M\255B, M\255)-.1 E F4(x)A F1 2.5(,.)
C(..\))-2.5 E F0 1.738(If the meta\214ed character)144 585.6 R F4(x)
4.238 E F0 1.739
(is uppercase, run the command that is bound to the corresponding)4.238
F(meta\214ed lo)144 597.6 Q(wercase character)-.25 E 5(.T)-.55 G
(he beha)-5 E(vior is unde\214ned if)-.2 E F4(x)2.5 E F0(is already lo)
2.5 E(wercase.)-.25 E F1(pr)108 609.6 Q(e\214x\255meta \(ESC\))-.18 E F0
(Metafy the ne)144 621.6 Q(xt character typed.)-.15 E F2(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 633.6 Q F0
(Incremental undo, separately remembered for each line.)144 645.6 Q F1
-2.29 -.18(re v)108 657.6 T(ert\255line \(M\255r\)).08 E F0 .231
(Undo all changes made to this line.)144 669.6 R .231(This is lik)5.231
F 2.731(ee)-.1 G -.15(xe)-2.881 G .23(cuting the).15 F F1(undo)2.73 E F0
.23(command enough times to re-)2.73 F
(turn the line to its initial state.)144 681.6 Q F1
(tilde\255expand \(M\255&\))108 693.6 Q F0(Perform tilde e)144 705.6 Q
(xpansion on the current w)-.15 E(ord.)-.1 E(GNU Readline 8.2)72 768 Q
(2022 September 19)120.405 E(12)185.115 E 0 Cg EP
%%Page: 13 13
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E/F1 10/Times-Bold@0 SF
(set\255mark \(C\255@, M\255<space>\))108 84 Q F0
(Set the mark to the point.)144 96 Q(If a numeric ar)5 E
(gument is supplied, the mark is set to that position.)-.18 E F1
(exchange\255point\255and\255mark \(C\255x C\255x\))108 108 Q F0(Sw)144
120 Q .282(ap the point with the mark.)-.1 F .283
(The current cursor position is set to the sa)5.283 F -.15(ve)-.2 G
2.783(dp).15 G .283(osition, and the old)-2.783 F(cursor position is sa)
144 132 Q -.15(ve)-.2 G 2.5(da).15 G 2.5(st)-2.5 G(he mark.)-2.5 E F1
(character\255sear)108 144 Q(ch \(C\255]\))-.18 E F0 3.112(Ac)144 156 S
.612(haracter is read and point is mo)-3.112 F -.15(ve)-.15 G 3.112(dt)
.15 G 3.112(ot)-3.112 G .612(he ne)-3.112 F .612
(xt occurrence of that character)-.15 F 5.611(.A)-.55 G(ne)-2.5 E -.05
(ga)-.15 G(ti).05 E .911 -.15(ve a)-.25 H -.18(rg).15 G(u-).18 E
(ment searches for pre)144 168 Q(vious occurrences.)-.25 E F1
(character\255sear)108 180 Q(ch\255backward \(M\255C\255]\))-.18 E F0
2.694(Ac)144 192 S .194(haracter is read and point is mo)-2.694 F -.15
(ve)-.15 G 2.694(dt).15 G 2.694(ot)-2.694 G .194(he pre)-2.694 F .194
(vious occurrence of that character)-.25 F 5.194(.A)-.55 G(ne)-2.499 E
-.05(ga)-.15 G(ti).05 E .495 -.15(ve a)-.25 H -.2(r-).15 G
(gument searches for subsequent occurrences.)144 204 Q F1
(skip\255csi\255sequence)108 216 Q F0 1.827
(Read enough characters to consume a multi-k)144 228 R 2.126 -.15(ey s)
-.1 H 1.826(equence such as those de\214ned for k).15 F -.15(ey)-.1 G
4.326(sl).15 G(ik)-4.326 E(e)-.1 E .79(Home and End.)144 240 R .791
(Such sequences be)5.79 F .791
(gin with a Control Sequence Indicator \(CSI\), usually ESC\255[.)-.15 F
.332(If this sequence is bound to "\\[", k)144 252 R -.15(ey)-.1 G 2.831
(sp).15 G .331(roducing such sequences will ha)-2.831 F .631 -.15(ve n)
-.2 H 2.831(oe).15 G -.25(ff)-2.831 G .331(ect unless e).25 F(xplic-)
-.15 E .026(itly bound to a readline command, instead of inserting stra\
y characters into the editing b)144 264 R(uf)-.2 E(fer)-.25 E 5.026(.T)
-.55 G(his)-5.026 E(is unbound by def)144 276 Q(ault, b)-.1 E
(ut usually bound to ESC\255[.)-.2 E F1(insert\255comment \(M\255#\))108
288 Q F0 -.4(Wi)144 300 S .481(thout a numeric ar).4 F .481
(gument, the v)-.18 F .481(alue of the readline)-.25 F F1
(comment\255begin)2.981 E F0 -.25(va)2.981 G .48
(riable is inserted at the).25 F(be)144 312 Q .244
(ginning of the current line.)-.15 F .245(If a numeric ar)5.244 F .245
(gument is supplied, this command acts as a toggle: if)-.18 F .322
(the characters at the be)144 324 R .321
(ginning of the line do not match the v)-.15 F .321(alue of)-.25 F F1
(comment\255begin)2.821 E F0 2.821(,t)C .321(he v)-2.821 F .321(alue is)
-.25 F 1.013(inserted, otherwise the characters in)144 336 R F1
(comment-begin)3.514 E F0 1.014(are deleted from the be)3.514 F 1.014
(ginning of the line.)-.15 F 1.469
(In either case, the line is accepted as if a ne)144 348 R 1.468
(wline had been typed.)-.25 F 1.468(The def)6.468 F 1.468(ault v)-.1 F
1.468(alue of)-.25 F F1(com-)3.968 E(ment\255begin)144 360 Q F0(mak)
2.982 E .483(es the current line a shell comment.)-.1 F .483
(If a numeric ar)5.483 F .483(gument causes the comment)-.18 F
(character to be remo)144 372 Q -.15(ve)-.15 G(d, the line will be e).15
E -.15(xe)-.15 G(cuted by the shell.).15 E F1(dump\255functions)108 384
Q F0 .627(Print all of the functions and their k)144 396 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 408 Q
(ay that it can be made part of an)-.1 E/F2 10/Times-Italic@0 SF(inputr)
2.5 E(c)-.37 E F0(\214le.)2.5 E F1(dump\255v)108 420 Q(ariables)-.1 E F0
.283(Print all of the settable v)144 432 R .283(ariables and their v)
-.25 F .283(alues to the readline output stream.)-.25 F .283
(If a numeric ar)5.283 F(gu-)-.18 E
(ment is supplied, the output is formatted in such a w)144 444 Q
(ay that it can be made part of an)-.1 E F2(inputr)2.5 E(c)-.37 E F0
(\214le.)2.5 E F1(dump\255macr)108 456 Q(os)-.18 E F0 .593
(Print all of the readline k)144 468 R .893 -.15(ey s)-.1 H .592
(equences bound to macros and the strings the).15 F 3.092(yo)-.15 G
3.092(utput. If)-3.092 F 3.092(an)3.092 G(umeric)-3.092 E(ar)144 480 Q
.528(gument is supplied, the output is formatted in such a w)-.18 F .528
(ay that it can be made part of an)-.1 F F2(inputr)3.028 E(c)-.37 E F0
(\214le.)144 492 Q F1(emacs\255editing\255mode \(C\255e\))108 504 Q F0
(When in)144 516 Q F1(vi)2.5 E F0(command 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 528 Q F0(When in)144 540 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/F3 10.95/Times-Bold@0 SF(DEF)72 556.8 Q -.548(AU)
-.986 G 2.014 -1.007(LT K).548 H(EY BINDINGS)1.007 E F0 .065(The follo)
108 568.8 R .065(wing is a list of the def)-.25 F .065
(ault emacs and vi bindings.)-.1 F .064
(Characters with the eighth bit set are written as)5.064 F .527
(M\255<character>, and are referred to as)108 580.8 R F2(meta\214ed)
3.407 E F0 3.027(characters. The)3.797 F .527
(printable ASCII characters not mentioned)3.027 F 1.116
(in the list of emacs standard bindings are bound to the)108 592.8 R F1
(self\255insert)3.615 E F0 1.115(function, which just inserts the gi)
3.615 F -.15(ve)-.25 G(n).15 E .945(character into the input line.)108
604.8 R .945(In vi insertion mode, all characters not speci\214cally me\
ntioned are bound to)5.945 F F1(self\255insert)108 616.8 Q F0 5.338(.C)C
.338(haracters assigned to signal generation by)-5.338 F F2(stty)3.178 E
F0 .337(\(1\) or the terminal dri).32 F -.15(ve)-.25 G 1.137 -.4(r, s)
.15 H .337(uch as C-Z or C-C,).4 F .187(retain that function.)108 628.8
R .187(Upper and lo)5.187 F .188(wer case meta\214ed characters are bou\
nd to the same function in the emacs)-.25 F .305(mode meta k)108 640.8 R
-.15(ey)-.1 G 2.805(map. The).15 F .305(remaining characters are unboun\
d, which causes readline to ring the bell \(subject)2.805 F
(to the setting of the)108 652.8 Q F1(bell\255style)2.5 E F0 -.25(va)2.5
G(riable\).).25 E F1(Emacs Mode)87 669.6 Q F0(Emacs Standard bindings)
151.2 681.6 Q 2.5("C-@" set-mark)151.2 705.6 R 2.5("C-A" be)151.2 717.6
R(ginning-of-line)-.15 E 2.5("C-B" backw)151.2 729.6 R(ard-char)-.1 E
(GNU Readline 8.2)72 768 Q(2022 September 19)120.405 E(13)185.115 E 0 Cg
EP
%%Page: 14 14
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("C-D" delete-char)
151.2 84 R 2.5("C-E" end-of-line)151.2 96 R 2.5("C-F" forw)151.2 108 R
(ard-char)-.1 E 2.5("C-G" abort)151.2 120 R 2.5("C-H" backw)151.2 132 R
(ard-delete-char)-.1 E 2.5("C-I" complete)151.2 144 R 2.5
("C-J" accept-line)151.2 156 R 2.5("C-K" kill-line)151.2 168 R 2.5
("C-L" clear)151.2 180 R(-screen)-.2 E 2.5("C-M" accept-line)151.2 192 R
2.5("C-N" ne)151.2 204 R(xt-history)-.15 E 2.5("C-P" pre)151.2 216 R
(vious-history)-.25 E 2.5("C-Q" quoted-insert)151.2 228 R 2.5("C-R" re)
151.2 240 R -.15(ve)-.25 G(rse-search-history).15 E 2.5("C-S" forw)151.2
252 R(ard-search-history)-.1 E 2.5("C-T" transpose-chars)151.2 264 R 2.5
("C-U" unix-line-discard)151.2 276 R 2.5("C-V" quoted-insert)151.2 288 R
2.5("C-W" unix-w)151.2 300 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 312 R
2.5("C-]" character)151.2 324 R(-search)-.2 E 2.5("C-_" undo)151.2 336 R
3.333("")151.2 348 S(to "/")-.833 E(self-insert)5 E 2.5("0" to)151.2 360
R 2.5("9" self-insert)2.5 F 2.5(":" to)151.2 372 R 2.5("~" self-insert)
2.5 F 2.5("C-?" backw)151.2 384 R(ard-delete-char)-.1 E
(Emacs Meta bindings)151.2 400.8 Q 2.5("M-C-G" abort)151.2 424.8 R 2.5
("M-C-H" backw)151.2 436.8 R(ard-kill-w)-.1 E(ord)-.1 E 2.5
("M-C-I" tab-insert)151.2 448.8 R 2.5("M-C-J" vi-editing-mode)151.2
460.8 R 2.5("M-C-L" clear)151.2 472.8 R(-display)-.2 E 2.5
("M-C-M" vi-editing-mode)151.2 484.8 R 2.5("M-C-R" re)151.2 496.8 R -.15
(ve)-.25 G(rt-line).15 E 2.5("M-C-Y" yank-nth-ar)151.2 508.8 R(g)-.18 E
2.5("M-C-[" complete)151.2 520.8 R 2.5("M-C-]" character)151.2 532.8 R
(-search-backw)-.2 E(ard)-.1 E 2.5("M-space" set-mark)151.2 544.8 R 2.5
("M-#" insert-comment)151.2 556.8 R 2.5("M-&" tilde-e)151.2 568.8 R
(xpand)-.15 E 2.5("M-*" insert-completions)151.2 580.8 R 2.5
("M--" digit-ar)151.2 592.8 R(gument)-.18 E 2.5("M-." yank-last-ar)151.2
604.8 R(g)-.18 E 2.5("M-0" digit-ar)151.2 616.8 R(gument)-.18 E 2.5
("M-1" digit-ar)151.2 628.8 R(gument)-.18 E 2.5("M-2" digit-ar)151.2
640.8 R(gument)-.18 E 2.5("M-3" digit-ar)151.2 652.8 R(gument)-.18 E 2.5
("M-4" digit-ar)151.2 664.8 R(gument)-.18 E 2.5("M-5" digit-ar)151.2
676.8 R(gument)-.18 E 2.5("M-6" digit-ar)151.2 688.8 R(gument)-.18 E 2.5
("M-7" digit-ar)151.2 700.8 R(gument)-.18 E 2.5("M-8" digit-ar)151.2
712.8 R(gument)-.18 E 2.5("M-9" digit-ar)151.2 724.8 R(gument)-.18 E
(GNU Readline 8.2)72 768 Q(2022 September 19)120.405 E(14)185.115 E 0 Cg
EP
%%Page: 15 15
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("M-<" be)151.2 84 R
(ginning-of-history)-.15 E 2.5("M-=" possible-completions)151.2 96 R 2.5
("M->" end-of-history)151.2 108 R 2.5("M-?" possible-completions)151.2
120 R 2.5("M-B" backw)151.2 132 R(ard-w)-.1 E(ord)-.1 E 2.5
("M-C" capitalize-w)151.2 144 R(ord)-.1 E 2.5("M-D" kill-w)151.2 156 R
(ord)-.1 E 2.5("M-F" forw)151.2 168 R(ard-w)-.1 E(ord)-.1 E 2.5
("M-L" do)151.2 180 R(wncase-w)-.25 E(ord)-.1 E 2.5
("M-N" non-incremental-forw)151.2 192 R(ard-search-history)-.1 E 2.5
("M-P" non-incremental-re)151.2 204 R -.15(ve)-.25 G(rse-search-history)
.15 E 2.5("M-R" re)151.2 216 R -.15(ve)-.25 G(rt-line).15 E 2.5
("M-T" transpose-w)151.2 228 R(ords)-.1 E 2.5("M-U" upcase-w)151.2 240 R
(ord)-.1 E 2.5("M-Y" yank-pop)151.2 252 R 2.5
("M-\\" delete-horizontal-space)151.2 264 R 2.5("M-~" tilde-e)151.2 276
R(xpand)-.15 E 2.5("M-C-?" backw)151.2 288 R(ard-kill-w)-.1 E(ord)-.1 E
2.5("M-_" yank-last-ar)151.2 300 R(g)-.18 E(Emacs Control-X bindings)
151.2 316.8 Q 2.5("C-XC-G" abort)151.2 340.8 R 2.5
("C-XC-R" re-read-init-\214le)151.2 352.8 R 2.5("C-XC-U" undo)151.2
364.8 R 2.5("C-XC-X" e)151.2 376.8 R(xchange-point-and-mark)-.15 E 2.5
("C-X\(" start-kbd-macro)151.2 388.8 R 2.5("C-X\)" end-kbd-macro)151.2
400.8 R 2.5("C-XE" call-last-kbd-macro)151.2 412.8 R 2.5("C-XC-?" backw)
151.2 424.8 R(ard-kill-line)-.1 E/F1 10/Times-Bold@0 SF
(VI Mode bindings)87 453.6 Q F0(VI Insert Mode functions)151.2 465.6 Q
2.5("C-D" vi-eof-maybe)151.2 489.6 R 2.5("C-H" backw)151.2 501.6 R
(ard-delete-char)-.1 E 2.5("C-I" complete)151.2 513.6 R 2.5
("C-J" accept-line)151.2 525.6 R 2.5("C-M" accept-line)151.2 537.6 R 2.5
("C-R" re)151.2 549.6 R -.15(ve)-.25 G(rse-search-history).15 E 2.5
("C-S" forw)151.2 561.6 R(ard-search-history)-.1 E 2.5
("C-T" transpose-chars)151.2 573.6 R 2.5("C-U" unix-line-discard)151.2
585.6 R 2.5("C-V" quoted-insert)151.2 597.6 R 2.5("C-W" unix-w)151.2
609.6 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 621.6 R 2.5("C-[" vi-mo)
151.2 633.6 R -.15(ve)-.15 G(ment-mode).15 E 2.5("C-_" undo)151.2 645.6
R 3.333("")151.2 657.6 S(to "~")-.833 E(self-insert)5 E 2.5("C-?" backw)
151.2 669.6 R(ard-delete-char)-.1 E(VI Command Mode functions)151.2
686.4 Q 2.5("C-D" vi-eof-maybe)151.2 710.4 R 2.5
("C-E" emacs-editing-mode)151.2 722.4 R(GNU Readline 8.2)72 768 Q
(2022 September 19)120.405 E(15)185.115 E 0 Cg EP
%%Page: 16 16
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("C-G" abort)151.2 84
R 2.5("C-H" backw)151.2 96 R(ard-char)-.1 E 2.5("C-J" accept-line)151.2
108 R 2.5("C-K" kill-line)151.2 120 R 2.5("C-L" clear)151.2 132 R
(-screen)-.2 E 2.5("C-M" accept-line)151.2 144 R 2.5("C-N" ne)151.2 156
R(xt-history)-.15 E 2.5("C-P" pre)151.2 168 R(vious-history)-.25 E 2.5
("C-Q" quoted-insert)151.2 180 R 2.5("C-R" re)151.2 192 R -.15(ve)-.25 G
(rse-search-history).15 E 2.5("C-S" forw)151.2 204 R(ard-search-history)
-.1 E 2.5("C-T" transpose-chars)151.2 216 R 2.5("C-U" unix-line-discard)
151.2 228 R 2.5("C-V" quoted-insert)151.2 240 R 2.5("C-W" unix-w)151.2
252 R(ord-rubout)-.1 E 2.5("C-Y" yank)151.2 264 R 2.5("C-_" vi-undo)
151.2 276 R -4.166 3.333("" f)151.2 288 T(orw)-3.333 E(ard-char)-.1 E
2.5("#" insert-comment)151.2 300 R 2.5("$" end-of-line)151.2 312 R 2.5
("%" vi-match)151.2 324 R 2.5("&" vi-tilde-e)151.2 336 R(xpand)-.15 E
2.5("*" vi-complete)151.2 348 R 2.5("+" ne)151.2 360 R(xt-history)-.15 E
2.5("," vi-char)151.2 372 R(-search)-.2 E 2.5("-" pre)151.2 384 R
(vious-history)-.25 E 2.5("." vi-redo)151.2 396 R 2.5("/" vi-search)
151.2 408 R 2.5("0" be)151.2 420 R(ginning-of-line)-.15 E("1" to "9")
151.2 432 Q(vi-ar)5 E(g-digit)-.18 E 2.5(";" vi-char)151.2 444 R
(-search)-.2 E 2.5("=" vi-complete)151.2 456 R 2.5("?" vi-search)151.2
468 R 2.5("A" vi-append-eol)151.2 480 R 2.5("B" vi-pre)151.2 492 R(v-w)
-.25 E(ord)-.1 E 2.5("C" vi-change-to)151.2 504 R 2.5("D" vi-delete-to)
151.2 516 R 2.5("E" vi-end-w)151.2 528 R(ord)-.1 E 2.5("F" vi-char)151.2
540 R(-search)-.2 E 2.5("G" vi-fetch-history)151.2 552 R 2.5
("I" vi-insert-be)151.2 564 R(g)-.15 E 2.5("N" vi-search-ag)151.2 576 R
(ain)-.05 E 2.5("P" vi-put)151.2 588 R 2.5("R" vi-replace)151.2 600 R
2.5("S" vi-subst)151.2 612 R 2.5("T" vi-char)151.2 624 R(-search)-.2 E
2.5("U" re)151.2 636 R -.15(ve)-.25 G(rt-line).15 E 2.5("W" vi-ne)151.2
648 R(xt-w)-.15 E(ord)-.1 E 2.5("X" backw)151.2 660 R(ard-delete-char)
-.1 E 2.5("Y" vi-yank-to)151.2 672 R 2.5("\\" vi-complete)151.2 684 R
2.5("^" vi-\214rst-print)151.2 696 R 2.5("_" vi-yank-ar)151.2 708 R(g)
-.18 E 2.5("`" vi-goto-mark)151.2 720 R(GNU Readline 8.2)72 768 Q
(2022 September 19)120.405 E(16)185.115 E 0 Cg EP
%%Page: 17 17
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 117.355(READLINE\(3\) Library)72 48 R
(Functions Manual)2.5 E(READLINE\(3\))119.855 E 2.5("a" vi-append-mode)
151.2 84 R 2.5("b" vi-pre)151.2 96 R(v-w)-.25 E(ord)-.1 E 2.5
("c" vi-change-to)151.2 108 R 2.5("d" vi-delete-to)151.2 120 R 2.5
("e" vi-end-w)151.2 132 R(ord)-.1 E 2.5("f" vi-char)151.2 144 R(-search)
-.2 E 2.5("h" backw)151.2 156 R(ard-char)-.1 E 2.5
("i" vi-insertion-mode)151.2 168 R 2.5("j" ne)151.2 180 R(xt-history)
-.15 E 2.5("k" pre)151.2 192 R(v-history)-.25 E 2.5("l" forw)151.2 204 R
(ard-char)-.1 E 2.5("m" vi-set-mark)151.2 216 R 2.5("n" vi-search-ag)
151.2 228 R(ain)-.05 E 2.5("p" vi-put)151.2 240 R 2.5
("r" vi-change-char)151.2 252 R 2.5("s" vi-subst)151.2 264 R 2.5
("t" vi-char)151.2 276 R(-search)-.2 E 2.5("u" vi-undo)151.2 288 R 2.5
("w" vi-ne)151.2 300 R(xt-w)-.15 E(ord)-.1 E 2.5("x" vi-delete)151.2 312
R 2.5("y" vi-yank-to)151.2 324 R 2.5("|" vi-column)151.2 336 R 2.5
("~" vi-change-case)151.2 348 R/F1 10.95/Times-Bold@0 SF(SEE ALSO)72
364.8 Q/F2 10/Times-Italic@0 SF(The Gnu Readline Libr)108 376.8 Q(ary)
-.15 E F0 2.5(,B)C(rian F)-2.5 E(ox and Chet Rame)-.15 E(y)-.15 E F2
(The Gnu History Libr)108 388.8 Q(ary)-.15 E F0 2.5(,B)C(rian F)-2.5 E
(ox and Chet Rame)-.15 E(y)-.15 E F2(bash)108 400.8 Q F0(\(1\))A F1
(FILES)72 417.6 Q F2(~/.inputr)109.666 429.6 Q(c)-.37 E F0(Indi)144
441.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 -.548(AU)72 458.4 S(THORS).548 E F0
(Brian F)108 470.4 Q(ox, Free Softw)-.15 E(are F)-.1 E(oundation)-.15 E
(bfox@gnu.or)108 482.4 Q(g)-.18 E(Chet Rame)108 499.2 Q 1.3 -.65(y, C)
-.15 H(ase W).65 E(estern Reserv)-.8 E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve)
-.25 G(rsity).15 E(chet.rame)108 511.2 Q(y@case.edu)-.15 E F1 -.11(BU)72
528 S 2.738(GR).11 G(EPOR)-2.738 E(TS)-.438 E F0 .69(If you \214nd a b)
108 540 R .69(ug in)-.2 F F3 -.18(re)3.19 G(adline,).18 E F0 .69
(you should report it.)3.19 F .691(But \214rst, you should mak)5.69 F
3.191(es)-.1 G .691(ure that it really is a b)-3.191 F(ug,)-.2 E
(and that it appears in the latest v)108 552 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 .705(Once you ha)108 568.8 R 1.005 -.15(ve d)-.2 H .705
(etermined that a b).15 F .704(ug actually e)-.2 F .704(xists, mail a b)
-.15 F .704(ug report to)-.2 F F2 -.2(bu)3.204 G(g\255r).2 E(eadline)
-.37 E F0(@)A F2(gnu.or)A(g)-.37 E F0 5.704(.I)C 3.204(fy)-5.704 G(ou)
-3.204 E(ha)108 580.8 Q 1.809 -.15(ve a \214)-.2 H 1.509
(x, you are welcome to mail that as well!).15 F 1.51
(Suggestions and `philosophical' b)6.51 F 1.51(ug reports may be)-.2 F
(mailed to)108 592.8 Q F2 -.2(bu)2.5 G(g-r).2 E(eadline)-.37 E F0(@)A F2
(gnu.or)A(g)-.37 E F0(or posted to the Usenet ne)2.5 E(wsgroup)-.25 E F3
(gnu.bash.b)2.5 E(ug)-.2 E F0(.)A(Comments and b)108 609.6 Q
(ug reports concerning this manual page should be directed to)-.2 E F2
-.15(ch)2.5 G(et.r).15 E(ame)-.15 E(y@case)-.3 E(.edu)-.15 E F0(.).25 E
F1 -.11(BU)72 626.4 S(GS).11 E F0(It')108 638.4 Q 2.5(st)-.55 G
(oo big and too slo)-2.5 E -.65(w.)-.25 G(GNU Readline 8.2)72 768 Q
(2022 September 19)120.405 E(17)185.115 E 0 Cg EP
%%Trailer
end
%%EOF