readline_3.ps

在非GUI环境下

(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 295.2 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 F1(completion\255ignor)108
307.2 Q(e\255case \(Off\))-.18 E F0(If set to)144 319.2 Q F1(On)2.5 E F0
2.5(,r)C(eadline performs \214lename matching and completion in a case\
\255insensiti)-2.5 E .3 -.15(ve f)-.25 H(ashion.).05 E F1
(completion\255query\255items \(100\))108 331.2 Q F0 .53
(This determines when the user is queried about vie)144 343.2 R .529
(wing the number of possible completions gen-)-.25 F .56(erated by the)
144 355.2 R F1(possible\255completions)3.06 E F0 3.06(command. It)3.06 F
.561(may be set to an)3.061 F 3.061(yi)-.15 G(nte)-3.061 E .561(ger v)
-.15 F .561(alue greater than or)-.25 F .783(equal to zero.)144 367.2 R
.783(If the number of possible completions is greater than or equal to \
the v)5.783 F .782(alue of this)-.25 F -.25(va)144 379.2 S .237
(riable, the user is ask).25 F .237(ed whether or not he wishes to vie)
-.1 F 2.737(wt)-.25 G .237(hem; otherwise the)-2.737 F 2.737(ya)-.15 G
.237(re simply listed)-2.737 F(on the terminal.)144 391.2 Q F1(con)108
403.2 Q -.1(ve)-.4 G(rt\255meta \(On\)).1 E F0 .613(If set to)144 415.2
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 eighth bit an\
d pre\214xing it with an escape character \(in ef)144 427.2 R 1.316
(fect, using escape as the)-.25 F F2(meta pr)144 439.2 Q(e\214x)-.37 E
F0(\).)A F1(disable\255completion \(Off\))108 451.2 Q F0 .038(If set to)
144 463.2 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 475.2 Q 2.5(yh)-.15 G(ad been mapped to)-2.5 E F1(self-insert)2.5 E
F0(.)A F1(editing\255mode \(emacs\))108 487.2 Q F0 .215
(Controls whether readline be)144 499.2 R .215(gins with a set of k)-.15
F .515 -.15(ey b)-.1 H .216(indings similar to emacs or vi.).15 F F1
(editing\255mode)5.216 E F0(can be set to either)144 511.2 Q F1(emacs)
2.5 E F0(or)2.5 E F1(vi)2.5 E F0(.)A F1(enable\255k)108 523.2 Q
(eypad \(Off\))-.1 E F0 .893(When set to)144 535.2 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 .892(Some sys-)5.893 F
(tems need this to enable the arro)144 547.2 Q 2.5(wk)-.25 G -.15(ey)
-2.6 G(s.).15 E F1(expand\255tilde \(Off\))108 559.2 Q F0(If set to)144
571.2 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-pr)108 583.2 Q(eser)-.18 E -.1(ve)-.1 G(-point).1 E F0
1.492(If set to)144 595.2 R F1(on)3.992 E F0 3.992(,t)C 1.493(he histor\
y code attempts to place point at the same location on each history lin\
e)-3.992 F(retri)144 607.2 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(horizontal\255scr)108 619.2 Q(oll\255mode \(Off\))-.18 E
F0 .449(When set to)144 631.2 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 643.2 R(w)-.25 E(line.)144 655.2 Q F1(input\255meta \(Off\))
108 667.2 Q F0 .367(If set to)144 679.2 R F1(On)2.867 E F0 2.867(,r)C
.367(eadline will enable eight-bit input \(that is, it will not clear t\
he eighth bit in the char)-2.867 F(-)-.2 E .956(acters it reads\), re)
144 691.2 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 703.2 Q
(ym for this v)-.15 E(ariable.)-.25 E(GNU Readline 5.0)72 768 Q
(2004 January 28)126.24 E(3)195.95 E 0 Cg EP
%%Page: 4 4
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10
/Times-Bold@0 SF(isear)108 84 Q(ch\255terminators \(`)-.18 E
(`C\255[ C\255J')-.63 E('\))-.63 E F0 .439(The string of characters tha\
t should terminate an incremental search without subsequently e)144 96 R
-.15(xe)-.15 G(cut-).15 E .934(ing the character as a command.)144 108 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 10
/Times-Italic@0 SF(ESC)3.435 E F0(and)144 120 Q F2(C\255J)2.5 E F0
(will terminate an incremental search.)2.5 E F1 -.1(ke)108 132 S
(ymap \(emacs\)).1 E F0 2.323(Set the current readline k)144 144 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 .808
(emacs-meta, emacs-ctlx, vi, vi-mo)144 156 R(ve)-.1 E 3.308(,v)-.1 G
(i-command)-3.308 E F0 3.308(,a)C(nd)-3.308 E F2(vi-insert)3.308 E F0(.)
.68 E F2(vi)5.808 E F0 .808(is equi)3.308 F -.25(va)-.25 G .809(lent to)
.25 F F2(vi-command)3.309 E F0(;)A F2(emacs)144 168 Q F0 .697(is equi)
3.197 F -.25(va)-.25 G .697(lent to).25 F F2(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 F2(emacs)3.197 E F0 5.697(.T).27 G .697(he v)-5.697 F
.697(alue of)-.25 F F1(editing\255mode)3.196 E F0(also af)144 180 Q
(fects the def)-.25 E(ault k)-.1 E -.15(ey)-.1 G(map.).15 E F1
(mark\255dir)108 192 Q(ectories \(On\))-.18 E F0(If set to)144 204 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
216 Q F0(If set to)144 228 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 240 Q(ed\255dir)-.1 E(ectories \(Off\))
-.18 E F0 .175(If set to)144 252 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 264
Q(alue of)-.25 E F1(mark\255dir)2.5 E(ectories)-.18 E F0(\).)A F1
(match\255hidden\255\214les \(On\))108 276 Q F0 .193(This v)144 288 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 1.023
(\214les\) when performing \214lename completion, unless the leading `.)
144 300 R 3.523('i)-.7 G 3.523(ss)-3.523 G 1.024
(upplied by the user in the)-3.523 F(\214lename to be completed.)144 312
Q F1(output\255meta \(Off\))108 324 Q F0 .507(If set to)144 336 R F1(On)
3.007 E F0 3.007(,r)C .507(eadline will display characters with the eig\
hth bit set directly rather than as a meta-)-3.007 F(pre\214x)144 348 Q
(ed escape sequence.)-.15 E F1(page\255completions \(On\))108 360 Q F0
.808(If set to)144 372 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 384 Q F1
(print\255completions\255horizontally \(Off\))108 396 Q F0 1.319
(If set to)144 408 R F1(On)3.819 E F0 3.819(,r)C 1.318(eadline will dis\
play completions with matches sorted horizontally in alphabetical)-3.819
F(order)144 420 Q 2.5(,r)-.4 G(ather than do)-2.5 E(wn the screen.)-.25
E F1(sho)108 432 Q(w\255all\255if\255ambiguous \(Off\))-.1 E F0 .477
(This alters the def)144 444 R .477(ault beha)-.1 F .477
(vior of the completion functions.)-.2 F .478(If set to)5.478 F F1(on)
2.978 E F0 2.978(,w)C .478(ords which ha)-3.078 F .778 -.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 456 R(bell.)144 468 Q F1
(sho)108 480 Q(w\255all\255if\255unmodi\214ed \(Off\))-.1 E F0 5.345
(This alters the def)144 492 R 5.345(ault beha)-.1 F 5.345
(vior of the completion functions in a f)-.2 F 5.346(ashion similar to)
-.1 F F1(sho)144 504 Q(w\255all\255if\255ambiguous)-.1 E F0 6.923(.I)C
4.423(fs)-6.923 G 1.923(et to)-4.423 F F1(on)4.423 E F0 4.423(,w)C 1.923
(ords which ha)-4.523 F 2.222 -.15(ve m)-.2 H 1.922
(ore than one possible completion).15 F 1.039(without an)144 516 R 3.539
(yp)-.15 G 1.039
(ossible partial completion \(the possible completions don')-3.539 F
3.539(ts)-.18 G 1.04(hare a common pre\214x\))-3.539 F(cause the matche\
s to be listed immediately instead of ringing the bell.)144 528 Q F1
(visible\255stats \(Off\))108 540 Q F0 .847(If set to)144 552 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 564 Q F1(Conditional Constructs)
87 580.8 Q F0 .05(Readline implements a f)108 592.8 R .05(acility simil\
ar in spirit to the conditional compilation features of the C preproces\
sor)-.1 F .097(which allo)108 604.8 R .097(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 .096
(There are four parser)5.096 F(directi)108 616.8 Q -.15(ve)-.25 G 2.5
(su).15 G(sed.)-2.5 E F1($if)108 633.6 Q F0(The)24.89 E F1($if)2.962 E
F0 .462(construct allo)2.962 F .463(ws bindings to be made based on the\
 editing mode, the terminal being used,)-.25 F .478
(or the application using readline.)144 645.6 R .477(The te)5.477 F .477
(xt of the test e)-.15 F .477
(xtends to the end of the line; no characters)-.15 F
(are required to isolate it.)144 657.6 Q F1(mode)144 674.4 Q F0(The)
12.67 E F1(mode=)3.711 E F0 1.211(form of the)3.711 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 686.4 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 .029(set bindings in the)180 698.4 R F2(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 710.4
Q(GNU Readline 5.0)72 768 Q(2004 January 28)126.24 E(4)195.95 E 0 Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 342.2(READLINE\(3\) READLINE\(3\))72 48 R/F1 10
/Times-Bold@0 SF(term)144 84 Q F0(The)15.46 E F1(term=)3.197 E F0 .696
(form may be used to include terminal-speci\214c k)3.197 F .996 -.15
(ey b)-.1 H .696(indings, perhaps to bind).15 F .654(the k)180 96 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 108 Q F1(=)3.004 E F0
.504(is tested ag)3.004 F .503(ainst the full name of the terminal and \
the portion of the terminal name)-.05 F(before the \214rst)180 120 Q F1
<ad>2.5 E F0 5(.T)C(his allo)-5 E(ws)-.25 E/F2 10/Times-Italic@0 SF(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(application)144
136.8 Q F0(The)180 148.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
160.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 .5(particular v)180
172.8 R 3(alue. This)-.25 F .501(could be used to bind k)3 F .801 -.15
(ey s)-.1 H .501(equences to functions useful for a spe-).15 F .397
(ci\214c program.)180 184.8 R -.15(Fo)5.397 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 .396(equence that quotes the).15 F(current or pre)180 196.8
Q(vious w)-.25 E(ord in Bash:)-.1 E F1($if)180 220.8 Q F0(Bash)2.5 E 2.5
(#Q)180 232.8 S(uote the current or pre)-2.5 E(vious w)-.25 E(ord)-.1 E
("\\C-xq": "\\eb\\"\\ef\\"")180 244.8 Q F1($endif)180 256.8 Q($endif)108
273.6 Q F0(This command, as seen in the pre)9.33 E(vious e)-.25 E
(xample, terminates an)-.15 E F1($if)2.5 E F0(command.)2.5 E F1($else)
108 290.4 Q F0(Commands in this branch of the)15.45 E 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 307.2 Q F0 .356
(This directi)144 319.2 R .656 -.15(ve t)-.25 H(ak).15 E .356
(es a single \214lename as an ar)-.1 F .357
(gument and reads commands and bindings from that)-.18 F 2.5(\214le. F)
144 331.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 355.2 Q F2(/etc/inputr)5.833 E(c)-.37 E/F3 10.95
/Times-Bold@0 SF(SEARCHING)72 372 Q F0 1.004(Readline pro)108 384 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 396 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 .697
(Incremental searches be)108 412.8 R .697
(gin before the user has \214nished typing the search string.)-.15 F
.698(As each character of the)5.698 F .113
(search string is typed, readline displays the ne)108 424.8 R .112
(xt entry from the history matching the string typed so f)-.15 F(ar)-.1
E 5.112(.A)-.55 G(n)-5.112 E .544
(incremental search requires only as man)108 436.8 R 3.044(yc)-.15 G
.544(haracters as needed to \214nd the desired history entry)-3.044 F
5.545(.T)-.65 G 3.045(os)-6.345 G(earch)-3.045 E(backw)108 448.8 Q .181
(ard in the history for a particular string, type)-.1 F F1(C\255r)2.681
E F0 5.181(.T)C(yping)-5.981 E F1(C\255s)2.68 E F0 .18(searches forw)
2.68 F .18(ard through the history)-.1 F(.)-.65 E .354
(The characters present in the v)108 460.8 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
472.8 R .6(If that v)5.6 F .6(ariable has not been assigned a v)-.25 F
.6(alue the)-.25 F F2(Escape)3.1 E F0(and)3.1 E F1(C\255J)3.1 E F0 .6
(characters will terminate an)3.1 F .122(incremental search.)108 484.8 R
F1(C\255G)5.122 E F0 .122
(will abort an incremental search and restore the original line.)2.622 F
.123(When the search is)5.123 F(terminated, the history entry containin\
g the search string becomes the current line.)108 496.8 Q 2.407 -.8
(To \214)108 513.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
.806(This will search back-)5.806 F -.1(wa)108 525.6 S 1.308(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.309(ther k).15 F -.15(ey)-.1 G .317
(sequence bound to a readline command will terminate the search and e)