diff options
Diffstat (limited to 'doc/readline_3.ps')
| -rw-r--r-- | doc/readline_3.ps | 351 |
1 files changed, 177 insertions, 174 deletions
diff --git a/doc/readline_3.ps b/doc/readline_3.ps index f54406d..d44470b 100644 --- a/doc/readline_3.ps +++ b/doc/readline_3.ps @@ -1,11 +1,11 @@ %!PS-Adobe-3.0 -%%Creator: groff version 1.22.3 -%%CreationDate: Wed Apr 17 09:02:35 2019 +%%Creator: groff version 1.22.4 +%%CreationDate: Wed Nov 20 09:49:30 2019 %%DocumentNeededResources: font Times-Roman %%+ font Times-Bold %%+ font Times-Italic %%+ font Courier -%%DocumentSuppliedResources: procset grops 1.22 3 +%%DocumentSuppliedResources: procset grops 1.22 4 %%Pages: 17 %%PageOrder: Ascend %%DocumentMedia: Default 612 792 0 () () @@ -15,7 +15,7 @@ %%PageMedia: Default %%EndDefaults %%BeginProlog -%%BeginResource: procset grops 1.22 3 +%%BeginResource: procset grops 1.22 4 %!PS-Adobe-3.0 Resource-ProcSet /setpacking where{ pop @@ -251,9 +251,9 @@ BP -.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 .42 -(the empty string, no prompt is issued.)108 247.2 R .421 -(The line returned is allocated with)5.42 F F3(malloc)2.921 E F0 .421 +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 @@ -294,10 +294,10 @@ 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 .62(Readline commands may be gi)108 463.2 R -.15(ve)-.25 G -3.119(nn).15 G(umeric)-3.119 E F3(ar)3.119 E(guments)-.37 E F0 3.119(,w) -.27 G .619(hich normally act as a repeat count.)-3.119 F(Sometimes,) -5.619 E(ho)108 475.2 Q(we)-.25 E -.15(ve)-.25 G 1.418 -.4(r, i).15 H +(\)).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 @@ -320,15 +320,15 @@ G .48(ress the Escape k)-2.98 F .78 -.15(ey t)-.1 H .48 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 1.442(is tak)108 592.8 R 1.443 -(en from the v)-.1 F 1.443(alue of the)-.25 F F2(INPUTRC)3.943 E F0(en) -3.943 E 1.443(vironment v)-.4 F 3.943(ariable. If)-.25 F 1.443(that v) -3.943 F 1.443(ariable is unset, the def)-.25 F 1.443(ault is)-.1 F F3 -(~/.inputr)108 604.8 Q(c)-.37 E F0 5.058(.I).31 G 2.558(ft)-5.058 G .058 -(hat \214le)-2.558 F .058(does not e)5.058 F .058 -(xist or cannot be read, the ultimate def)-.15 F .058(ault is)-.1 F F3 -(/etc/inputr)2.557 E(c)-.37 E F0 5.057(.W).31 G .057(hen a program) --5.057 F 1.158(which uses the readline library starts up, the init \214\ +(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 @@ -354,15 +354,15 @@ BP (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.5 E(sal\255ar)-.1 E(gument) --.37 E F0(.).68 E 2.795(The follo)108 100.8 R 2.795 +(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 -3.095 -.15(ey b)-.1 H(indings:).15 E F1(DEL)5.295 E F0(,).53 E F1(ESC) -5.295 E F0(,).72 E F1(ESCAPE)108 112.8 Q F0(,).73 E F1(LFD)2.5 E F0(,) -.28 E F1(NEWLINE)2.5 E F0(,).73 E F1(RET)2.5 E F0(,)1.27 E F1(RETURN)2.5 -E F0(,)1.1 E F1 -.4(RU)2.5 G(BOUT).4 E F0(,)1.27 E F1(SP)2.5 E -.3(AC) --.9 G(E).3 E F0(,).73 E F1(SPC)2.5 E F0 2.5(,a).72 G(nd)-2.5 E F1 -.5 -(TA)2.5 G(B).5 E F0(.).27 E .209 +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) @@ -373,14 +373,14 @@ F -.15(ey)-.1 G 2.709(st).15 G 2.709(ob)-2.709 G 2.709(eb)-2.709 G .209 (\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 .853(\214ed in one of tw)108 -194.4 R 3.353(ow)-.1 G .853(ays: as a symbolic k)-3.453 F 1.153 -.15 -(ey n)-.1 H .853(ame, possibly with).15 F F1(Meta\255)3.353 E F0(or) -3.353 E F1(Contr)3.353 E(ol\255)-.45 E F0(pre\214x)3.353 E .853 -(es, or as a k)-.15 F -.15(ey)-.1 G 2.919(sequence. The)108 206.4 R .419 -(name and k)2.919 F .719 -.15(ey s)-.1 H .419 -(equence are separated by a colon.).15 F .419 -(There can be no whitespace between the)5.419 F(name and the colon.)108 +.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 @@ -392,10 +392,10 @@ G(rsal\255ar).15 E(gument)-.18 E(Meta\255Rubout: backw)144 283.2 Q 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.835(,a)C(nd)-3.835 E F1(C\255o)3.675 E F0 1.336 -(is bound to run the macro e)4.016 F 1.336 -(xpressed on the right hand side \(that is, to)-.15 F(insert the te)108 -336 Q(xt)-.15 E/F3 10/Courier@0 SF 6(>o)2.5 G(utput)-6 E F0 +(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 @@ -622,25 +622,25 @@ G(s.).15 E F1(enable\255meta\255k)108 420 Q(ey \(On\))-.1 E F0 .64 (expand\255tilde \(Off\))108 456 Q F0(If set to)144 468 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 480 Q(eser)-.18 E -.1 -(ve)-.1 G(\255point \(Off\)).1 E F0 1.338(If set to)144 492 R F1(On) -3.838 E F0 3.838(,t)C 1.338(he history code attempts to place point at \ -the same location on each history line)-3.838 F(retrie)144 504 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 516 Q F0 .949 -(Set the maximum number of history entries sa)144 528 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 540 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 +(ve)-.1 G(\255point \(Off\)).1 E F0 .552(If set to)144 492 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 504 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 516 Q F0 .949(Set the maximum number of history entries sa)144 528 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 540 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 552 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 1.97(attempt is made to set)144 564 R F2(history\255size) -4.47 E F0 1.97(to a non-numeric v)4.47 F 1.97 -(alue, the maximum number of history)-.25 F(entries will be set to 500.) -144 576 Q F1(horizontal\255scr)108 588 Q(oll\255mode \(Off\))-.18 E F0 -.449(When set to)144 600 R F1(On)2.949 E F0 2.949(,m)C(ak)-2.949 E .448 +(If an)5.355 F .82(attempt is made to set)144 564 R F2(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 576 Q F1(horizontal\255scr)108 588 Q +(oll\255mode \(Off\))-.18 E F0 .449(When set to)144 600 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\ @@ -672,31 +672,32 @@ BP (ke)108 96 S(ymap \(emacs\)).1 E F0 2.323(Set the current readline k)144 108 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 F1 -2.324(emacs, emacs-standar)4.823 F(d,)-.37 E .809 -(emacs-meta, emacs-ctlx, vi, vi-mo)144 120 R(ve)-.1 E 3.308(,v)-.1 G -(i-command)-3.308 E F0 3.308(,a)C(nd)-3.308 E F1(vi-insert)3.308 E F0(.) -.68 E F1(vi)5.808 E F0 .808(is equi)3.308 F -.25(va)-.25 G .808(lent to) -.25 F F1(vi-command)3.308 E F0(;)A F1(emacs)144 132 Q F0 .697(is equi) -3.196 F -.25(va)-.25 G .697(lent to).25 F F1(emacs-standar)3.197 E(d) --.37 E F0 5.697(.T)C .697(he def)-5.697 F .697(ault v)-.1 F .697 -(alue is)-.25 F F1(emacs)3.197 E F0 5.697(.T).27 G .697(he v)-5.697 F -.697(alue of)-.25 F F2(editing\255mode)3.197 E F0(also af)144 144 Q +2.324(emacs, emacs-standar)4.823 F(d,)-.37 E .782 +(emacs-meta, emacs-ctlx, vi, vi-mo)144 120 R(ve)-.1 E 3.282(,v)-.1 G +(i-command)-3.282 E F0 3.282(,a)C(nd)-3.282 E F1(vi-insert)3.572 E F0(.) +.68 E F1(vi)5.782 E F0 .782(is equi)3.282 F -.25(va)-.25 G .781(lent to) +.25 F F1(vi-command)3.281 E F0(;)A F1(emacs)144 132 Q F0 .682(is equi) +3.182 F -.25(va)-.25 G .682(lent to).25 F F1(emacs-standar)3.182 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 F1(emacs)3.372 E F0 5.683(.T).27 G .683(he v)-5.683 F +.683(alue of)-.25 F F2(editing\255mode)3.183 E F0(also af)144 144 Q (fects the def)-.25 E(ault k)-.1 E -.15(ey)-.1 G(map.).15 E F2 -.1(ke) 108 156 S(yseq\255timeout \(500\)).1 E F0 .368(Speci\214es the duration) 144 168 R F1 -.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 .667 -.15(ey s) --.1 H(equence).15 E 1.356(\(one that can form a complete k)144 180 R -1.656 -.15(ey s)-.1 H 1.356(equence using the input read so f).15 F(ar) --.1 E 3.856(,o)-.4 G 3.856(rc)-3.856 G 1.356(an tak)-3.856 F 3.856(ea) --.1 G(dditional)-3.856 E .32(input to complete a longer k)144 192 R .62 --.15(ey s)-.1 H 2.82(equence\). If).15 F .32(no input is recei)2.82 F --.15(ve)-.25 G 2.82(dw).15 G .32(ithin the timeout,)-2.82 F F1 -.37(re) -2.82 G(adline).37 E F0(will)2.82 E .906(use the shorter b)144 204 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 .907 -(alue of)-.25 F .05(1000 means that)144 216 R F1 -.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 +-.1 H(equence).15 E .524(\(one that can form a complete k)144 180 R .824 +-.15(ey s)-.1 H .524(equence using the input read so f).15 F(ar)-.1 E +3.025(,o)-.4 G 3.025(rc)-3.025 G .525(an tak)-3.025 F 3.025(ea)-.1 G +.525(dditional in-)-3.025 F .807(put to complete a longer k)144 192 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 .806(ithin the timeout,)-3.306 F +F1 -.37(re)3.306 G(adline).37 E F0(will)3.306 E .906(use the shorter b) +144 204 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 .907(alue of)-.25 F +.05(1000 means that)144 216 R F1 -.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 228 R(alue,)-.25 E F1 -.37(re)2.551 G(adline).37 E F0 .051(will w)2.551 F .051 (ait until another k)-.1 F .352 -.15(ey i)-.1 H 2.552(sp).15 G(ressed) @@ -737,12 +738,13 @@ ta-)-3.007 F(pre\214x)144 444 Q .884(ed escape sequence.)-.15 F .884 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 492 Q F2 -(print\255completions\255horizontally \(Off\))108 504 Q F0 1.318 -(If set to)144 516 R F2(On)3.818 E F0 3.818(,r)C 1.319(eadline will dis\ -play completions with matches sorted horizontally in alphabetical)-3.818 -F(order)144 528 Q 2.5(,r)-.4 G(ather than do)-2.5 E(wn the screen.)-.25 -E F2 -2.29 -.18(re v)108 540 T(ert\255all\255at\255newline \(Off\)).08 E -F0 .699(If set to)144 552 R F2(On)3.199 E F0 3.199(,r)C .699 +(print\255completions\255horizontally \(Off\))108 504 Q F0 .227 +(If set to)144 516 R F2(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 528 Q 2.5(,r)-.4 G(ather than do)-2.5 E +(wn the screen.)-.25 E F2 -2.29 -.18(re v)108 540 T +(ert\255all\255at\255newline \(Off\)).08 E F0 .699(If set to)144 552 R +F2(On)3.199 E F0 3.199(,r)C .699 (eadline will undo all changes to history lines before returning when) -3.199 F F2(accept\255line)3.198 E F0(is)3.198 E -.15(exe)144 564 S 2.686(cuted. By).15 F(def)2.686 E .186 @@ -795,30 +797,30 @@ 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 168 R .775 -.15(ve a)-.25 H .475(nd in command mode.).15 F .475(The v) -5.475 F(alue)-.25 E 1.235(is e)144 180 R 1.235(xpanded lik)-.15 F 3.735 -(eak)-.1 G 1.535 -.15(ey b)-3.835 H 1.236 -(inding, so the standard set of meta- and control pre\214x).15 F 1.236 -(es and backslash)-.15 F .315(escape sequences is a)144 192 R -.25(va) --.2 G 2.815(ilable. Use).25 F .314(the \\1 and \\2 escapes to be)2.815 F -.314(gin and end sequences of non-print-)-.15 F(ing characters, which c\ -an be used to embed a terminal control sequence into the mode string.) -144 204 Q F1(vi\255ins\255mode\255string \(\(ins\)\))108 216 Q F0 .517 +5.475 F(alue)-.25 E .33(is e)144 180 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 192 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 +204 Q F1(vi\255ins\255mode\255string \(\(ins\)\))108 216 Q F0 .517 (If the)144 228 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 240 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 252 S 1.929(panded lik).15 F -4.429(eak)-.1 G 2.229 -.15(ey b)-4.529 H 1.929 -(inding, so the standard set of meta- and control pre\214x).15 F 1.93 -(es and backslash)-.15 F .315(escape sequences is a)144 264 R -.25(va) --.2 G 2.815(ilable. Use).25 F .314(the \\1 and \\2 escapes to be)2.815 F -.314(gin and end sequences of non-print-)-.15 F(ing characters, which c\ -an be used to embed a terminal control sequence into the mode string.) -144 276 Q F1(visible\255stats \(Off\))108 288 Q F0 .846(If set to)144 -300 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 +5.186 F .186(alue is)-.25 F -.15(ex)144 252 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 264 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 +276 Q F1(visible\255stats \(Off\))108 288 Q F0 .846(If set to)144 300 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 312 Q F1(Conditional Constructs) 87 328.8 Q F0 .05(Readline implements a f)108 340.8 R .05(acility simil\ ar in spirit to the conditional compilation features of the C preproces\ @@ -851,29 +853,29 @@ Q F1(term)144 475.2 Q F0(The)180 475.2 Q F1(term=)3.196 E F0 .696 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 511.2 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.5 E F0 -2.5(,f).77 G(or instance.)-2.5 E F1 -.1(ve)144 528 S(rsion).1 E F0(The) -180 540 Q F1 -.1(ve)3.109 G(rsion).1 E F0 .608 +(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 528 S(rsion).1 E F0 +(The)180 540 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 552 Q F1 -.1 -(ve)3.928 G(rsion).1 E F0 -.15(ex)3.928 G 1.428 -(pands to the current readline v).15 F 3.928(ersion. The)-.15 F 1.429 -(set of comparison operators)3.929 F(includes)180 564 Q F1(=)2.606 E F0 -2.606(,\()C(and)-2.606 E F1(==)2.606 E F0(\),)A F1(!=)2.606 E F0(,)A F1 -(<=)2.606 E F0(,)A F1(>=)2.606 E F0(,)A F1(<)2.606 E F0 2.606(,a)C(nd) --2.606 E F1(>)2.606 E F0 5.106(.T)C .106(he v)-5.106 F .106 -(ersion number supplied on the right side)-.15 F 1.471 -(of the operator consists of a major v)180 576 R 1.471(ersion number) --.15 F 3.972(,a)-.4 G 3.972(no)-3.972 G 1.472 -(ptional decimal point, and an)-3.972 F .767(optional minor v)180 588 R -.767(ersion \(e.g.,)-.15 F F1(7.1)3.267 E F0 .766(\). If the minor v)B -.766(ersion is omitted, it is assumed to be)-.15 F F1(0)3.266 E F0(.)A -1.755(The operator may be separated from the string)180 600 R F1 -.1(ve) -4.255 G(rsion).1 E F0 1.756(and from the v)4.256 F 1.756(ersion number) --.15 F(ar)180 612 Q(gument by whitespace.)-.18 E F1(application)144 -628.8 Q F0(The)180 640.8 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 +(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 564 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 576 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 588 +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 600 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 612 Q F1 +(application)144 628.8 Q F0(The)180 640.8 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 652.8 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 664.8 R 3.001(alue. This)-.25 F .501(could be used to bind k)3.001 F @@ -919,7 +921,7 @@ F .13(Both string and boolean v)5.129 F .13(ariables may be)-.25 F 1.003(vides commands for searching through the command history for line\ s containing a speci\214ed)-.15 F 2.5(string. There)108 312 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.5 E(emental)-.37 E F0(.).51 E .698 +3.01 E F2(non-incr)2.86 E(emental)-.37 E F0(.).51 E .698 (Incremental searches be)108 328.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 @@ -945,20 +947,21 @@ g the search string becomes the current line.)108 412.8 Q 2.406 -.8 (To \214)108 429.6 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 441.6 S 1.309(rd or forw) -.1 F 1.309(ard in the history for the ne)-.1 F 1.309 -(xt line matching the search string typed so f)-.15 F(ar)-.1 E 6.309(.A) --.55 G 1.609 -.15(ny o)-6.309 H 1.308(ther k).15 F -.15(ey)-.1 G .317 -(sequence bound to a readline command will terminate the search and e) -108 453.6 R -.15(xe)-.15 G .318(cute that command.).15 F -.15(Fo)5.318 G -2.818(ri).15 G(nstance,)-2.818 E 3.481(an)108 465.6 S -.25(ew)-3.481 G -.981(line will terminate the search and accept the line, thereby e).25 F --.15(xe)-.15 G .98(cuting the command from the history).15 F 3.061 -(list. A)108 477.6 R(mo)3.061 E -.15(ve)-.15 G .562 -(ment command will terminate the search, mak).15 F 3.062(et)-.1 G .562 -(he last line found the current line, and be)-3.062 F(gin)-.15 E -(editing.)108 489.6 Q .567(Non-incremental searches read the entire sea\ -rch string before starting to search for matching history lines.)108 +.807(This will search back-)5.806 F -.1(wa)108 441.6 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 +453.6 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 465.6 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 477.6 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 489.6 Q .567(Non-incremental searches read the entire s\ +earch string before starting to search for matching history lines.)108 506.4 R(The search string may be typed by the user or be part of the co\ ntents of the current line.)108 518.4 Q F3(EDITING COMMANDS)72 535.2 Q F0 1.391(The follo)108 547.2 R 1.391 @@ -1093,10 +1096,10 @@ of characters between the start of the current line)-.1 F .319 5.318 F(search.)144 168 Q F1(yank\255nth\255ar)108 180 Q 2.5(g\()-.1 G <4dad43ad7929>-2.5 E F0 .622(Insert the \214rst ar)144 192 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 .795(at point.)144 -204 R -.4(Wi)5.795 G .794(th an ar).4 F(gument)-.18 E F2(n)3.294 E F0 -3.294(,i).24 G .794(nsert the)-3.294 F F2(n)3.294 E F0 .794(th w)B .794 -(ord from the pre)-.1 F .794(vious command \(the w)-.25 F .794 +F .622(ord on the pre)-.1 F .622(vious line\))-.25 F .773(at point.)144 +204 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 216 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 @@ -1116,12 +1119,12 @@ 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 288 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 -1.397(to the \214rst call\) of each line in turn.)144 300 R(An)6.396 E -3.896(yn)-.15 G 1.396(umeric ar)-3.896 F 1.396 -(gument supplied to these successi)-.18 F 1.696 -.15(ve c)-.25 H(alls) -.15 E .491(determines the direction to mo)144 312 R .791 -.15(ve t)-.15 -H .491(hrough the history).15 F 5.492(.A)-.65 G(ne)-2.5 E -.05(ga)-.15 G -(ti).05 E .792 -.15(ve a)-.25 H -.18(rg).15 G .492 +.416(to the \214rst call\) of each line in turn.)144 300 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 312 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 324 R 2.994(ard\). The)-.1 F .494(history e)2.994 F .494(xpansion f)-.15 F .494 @@ -1160,11 +1163,11 @@ Q F0 2.5(,f)C(or e)-2.5 E(xample.)-.15 E F1(tab\255insert \(M-T)108 (transpose\255chars \(C\255t\))108 604.8 Q F0 .321 (Drag the character before point forw)144 616.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 1.182 +(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 -628.8 R 3.682(oc)-.1 G 1.182(haracters before point.)-3.682 F(Ne)6.182 E --.05(ga)-.15 G(ti).05 E -.15(ve)-.25 G(ar)144 640.8 Q(guments ha)-.18 E -.3 -.15(ve n)-.2 H 2.5(oe).15 G -.25(ff)-2.5 G(ect.).25 E F1 +628.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 640.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 652.8 Q(ords \(M\255t\))-.1 E F0 .023(Drag the w)144 664.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) @@ -1241,12 +1244,12 @@ F 5.365(.T)-.65 G .365(he killed te)-5.365 F .365(xt is sa)-.15 F -.15 (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 484.8 Q F0 (Delete all spaces and tabs around point.)144 496.8 Q F1(kill\255r)108 -508.8 Q(egion)-.18 E F0 1.13(Kill the te)144 520.8 R 1.13 -(xt between the point and)-.15 F F2(mark)3.63 E F0(\(sa)3.63 E -.15(ve) --.2 G 3.63(dc).15 G 1.13(ursor position\).)-3.63 F 1.13(This te)6.13 F -1.13(xt is referred to as the)-.15 F F2 -.37(re)144 532.8 S(gion)-.03 E -F0(.)A F1(copy\255r)108 544.8 Q(egion\255as\255kill)-.18 E F0(Cop)144 -556.8 Q 2.5(yt)-.1 G(he te)-2.5 E(xt in the re)-.15 E +508.8 Q(egion)-.18 E F0 .301(Kill the te)144 520.8 R .301 +(xt between the point and)-.15 F F2(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 532.8 Q F0(.)A F1(copy\255r)108 544.8 Q(egion\255as\255kill) +-.18 E F0(Cop)144 556.8 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 568.8 Q(ord)-.1 E F0(Cop)144 580.8 Q 4.801 (yt)-.1 G 2.301(he w)-4.801 F 2.301(ord before point to the kill b)-.1 F @@ -1296,12 +1299,12 @@ BP (cuting this function the \214rst time mak).15 F .378(es the ar)-.1 F .378(gument count)-.18 F(four)144 168 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 184.8 Q(complete \(T)108 196.8 Q(AB\))-.9 E F0 1.908 -(Attempt to perform completion on the te)144 208.8 R 1.908 -(xt before point.)-.15 F 1.909(The actual completion performed is)6.909 -F(application-speci\214c.)144 220.8 Q F1(Bash)5.518 E F0 3.018(,f)C .518 -(or instance, attempts completion treating the te)-3.018 F .517 -(xt as a v)-.15 F .517(ariable \(if the)-.25 F(te)144 232.8 Q .656 +(Completing)87 184.8 Q(complete \(T)108 196.8 Q(AB\))-.9 E F0 .681 +(Attempt to perform completion on the te)144 208.8 R .681 +(xt before point.)-.15 F .682(The actual completion performed is ap-) +5.682 F(plication-speci\214c.)144 220.8 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 232.8 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 @@ -1396,11 +1399,11 @@ F(meta\214ed lo)144 108 Q(wercase character)-.25 E 5(.T)-.55 G(he beha) (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 144 Q F0 (Incremental undo, separately remembered for each line.)144 156 Q F1 --2.29 -.18(re v)108 168 T(ert\255line \(M\255r\)).08 E F0 1.095 -(Undo all changes made to this line.)144 180 R 1.095(This is lik)6.095 F -3.595(ee)-.1 G -.15(xe)-3.745 G 1.095(cuting the).15 F F1(undo)3.595 E -F0 1.095(command enough times to)3.595 F -(return the line to its initial state.)144 192 Q F1 +-2.29 -.18(re v)108 168 T(ert\255line \(M\255r\)).08 E F0 .231 +(Undo all changes made to this line.)144 180 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 192 Q F1 (tilde\255expand \(M\255&\))108 204 Q F0(Perform tilde e)144 216 Q (xpansion on the current w)-.15 E(ord.)-.1 E F1 (set\255mark \(C\255@, M\255<space>\))108 228 Q F0 @@ -1497,10 +1500,10 @@ BP (function, which just inserts the gi)3.615 F -.15(ve)-.25 G(n).15 E .945 (character into the input line.)108 96 R .945(In vi insertion mode, all\ characters not speci\214cally mentioned are bound to)5.945 F F1 -(self\255insert)108 108 Q F0 5.359(.C)C .359 -(haracters assigned to signal generation by)-5.359 F/F2 10 -/Times-Italic@0 SF(stty)2.859 E F0 .359(\(1\) or the terminal dri).32 F --.15(ve)-.25 G 1.159 -.4(r, s).15 H .358(uch as C-Z or C-C,).4 F .187 +(self\255insert)108 108 Q F0 5.338(.C)C .338 +(haracters assigned to signal generation by)-5.338 F/F2 10 +/Times-Italic@0 SF(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 120 R .187(Upper and lo)5.187 F .188(wer cas\ e meta\214ed characters are bound to the same function in the emacs)-.25 F .305(mode meta k)108 132 R -.15(ey)-.1 G 2.805(map. The).15 F .305(re\ |