diff options
Diffstat (limited to 'doc/readline.ps')
| -rw-r--r-- | doc/readline.ps | 5470 |
1 files changed, 2782 insertions, 2688 deletions
diff --git a/doc/readline.ps b/doc/readline.ps index 011e8cb..7a77778 100644 --- a/doc/readline.ps +++ b/doc/readline.ps @@ -1,7 +1,7 @@ %!PS-Adobe-2.0 -%%Creator: dvips(k) 2022.1 (TeX Live 2022) Copyright 2022 Radical Eye Software +%%Creator: dvips(k) 2023.1 (TeX Live 2023) Copyright 2023 Radical Eye Software %%Title: readline.dvi -%%CreationDate: Tue Sep 20 14:17:05 2022 +%%CreationDate: Fri Apr 5 13:11:47 2024 %%Pages: 86 %%PageOrder: Ascend %%BoundingBox: 0 0 612 792 @@ -12,7 +12,7 @@ %DVIPSWebPage: (www.radicaleye.com) %DVIPSCommandLine: dvips -D 600 -t letter -o readline.ps readline.dvi %DVIPSParameters: dpi=600 -%DVIPSSource: TeX output 2022.09.20:1017 +%DVIPSSource: TeX output 2024.04.05:0911 %%BeginProcSet: tex.pro 0 0 %! /TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S @@ -6683,16 +6683,16 @@ ifelse %%EndSetup %%Page: 1 1 TeXDict begin 1 0 bop 150 1318 a Fu(GNU)65 b(Readline)g(Library)p -150 1418 3600 34 v 1873 1515 a Ft(Edition)30 b(8.2,)i(for)e -Fs(Readline)e(Library)h Ft(V)-8 b(ersion)31 b(8.2.)3118 -1623 y(Septem)m(b)s(er)f(2022)150 4927 y Fr(Chet)45 b(Ramey)-11 +150 1418 3600 34 v 1873 1515 a Ft(Edition)30 b(8.3,)i(for)e +Fs(Readline)e(Library)h Ft(V)-8 b(ersion)31 b(8.3.)3218 +1623 y(Jan)m(uary)f(2024)150 4927 y Fr(Chet)45 b(Ramey)-11 b(,)46 b(Case)g(W)-11 b(estern)46 b(Reserv)l(e)g(Univ)l(ersit)l(y)150 5068 y(Brian)f(F)-11 b(o)l(x,)45 b(F)-11 b(ree)45 b(Soft)l(w)l(are)h(F) -11 b(oundation)p 150 5141 3600 17 v eop end %%Page: 2 2 -TeXDict begin 2 1 bop 150 4413 a Ft(This)21 b(man)m(ual)g(describ)s(es) -g(the)g(GNU)h(Readline)g(Library)f(\(v)m(ersion)h(8.2,)i(19)e(Septem)m -(b)s(er)f(2022\),)26 b(a)21 b(library)150 4523 y(whic)m(h)39 +TeXDict begin 2 1 bop 150 4413 a Ft(This)28 b(man)m(ual)i(describ)s(es) +f(the)g(GNU)h(Readline)g(Library)e(\(v)m(ersion)i(8.3,)h(19)f(Jan)m +(uary)f(2024\),)j(a)d(library)150 4523 y(whic)m(h)39 b(aids)g(in)g(the)g(consistency)h(of)g(user)e(in)m(terface)j(across)f (discrete)g(programs)e(whic)m(h)h(pro)m(vide)h(a)150 4633 y(command)30 b(line)h(in)m(terface.)150 4767 y(Cop)m(yrigh)m(t)602 @@ -6806,11 +6806,11 @@ f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f (:)h(:)f(:)24 b Ft(29)275 3914 y(2.4)92 b(Readline)31 b(Con)m(v)m(enience)g(F)-8 b(unctions)22 b Fn(:)16 b(:)g(:)f(:)h(:)f(:) g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f -(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)35 b Ft(34)399 4023 y(2.4.1)93 +(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)35 b Ft(35)399 4023 y(2.4.1)93 b(Naming)31 b(a)g(F)-8 b(unction)21 b Fn(:)16 b(:)f(:)h(:)f(:)h(:)f(:)g (:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:) h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)34 -b Ft(34)399 4133 y(2.4.2)93 b(Selecting)32 b(a)e(Keymap)9 +b Ft(35)399 4133 y(2.4.2)93 b(Selecting)32 b(a)e(Keymap)9 b Fn(:)16 b(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f (:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:) f(:)h(:)f(:)g(:)h(:)22 b Ft(35)399 4242 y(2.4.3)93 b(Binding)30 @@ -6830,7 +6830,7 @@ h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)23 b Ft(40)399 4681 y(2.4.7)93 b(Mo)s(difying)30 b(T)-8 b(ext)16 b Fn(:)g(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f (:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:) -g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:)28 b Ft(41)399 +g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:)28 b Ft(42)399 4790 y(2.4.8)93 b(Character)31 b(Input)22 b Fn(:)13 b(:)j(:)f(:)h(:)f (:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:) f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f @@ -6841,7 +6841,7 @@ g(:)h(:)f(:)h(:)f(:)g(:)30 b Ft(43)399 5010 y(2.4.10)93 b(Utilit)m(y)33 b(F)-8 b(unctions)24 b Fn(:)15 b(:)h(:)f(:)g(:)h(:)f(:) h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g (:)h(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)36 -b Ft(43)399 5119 y(2.4.11)93 b(Miscellaneous)33 b(F)-8 +b Ft(44)399 5119 y(2.4.11)93 b(Miscellaneous)33 b(F)-8 b(unctions)23 b Fn(:)16 b(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f (:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:) f(:)h(:)f(:)36 b Ft(45)399 5229 y(2.4.12)93 b(Alternate)32 @@ -6851,7 +6851,7 @@ g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)38 b Ft(46)399 5338 y(2.4.13)93 b(A)31 b(Readline)g(Example)12 b Fn(:)j(:)h(:)f(:)g(:)h(:)f (:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:) g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)25 -b Ft(46)p eop end +b Ft(47)p eop end %%Page: -2 4 TeXDict begin -2 3 bop 3699 -116 a Ft(ii)399 83 y(2.4.14)93 b(Alternate)32 b(In)m(terface)g(Example)18 b Fn(:)e(:)f(:)h(:)f(:)g(:)h @@ -6859,24 +6859,24 @@ b(Alternate)32 b(In)m(terface)g(Example)18 b Fn(:)e(:)f(:)h(:)f(:)g(:)h f(:)g(:)h(:)f(:)h(:)31 b Ft(48)275 193 y(2.5)92 b(Readline)31 b(Signal)f(Handling)18 b Fn(:)e(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:)f(:)g(:)h (:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:) -f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)31 b Ft(50)275 302 +f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)31 b Ft(51)275 302 y(2.6)92 b(Custom)29 b(Completers)e Fn(:)16 b(:)f(:)h(:)f(:)g(:)h(:)f (:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:) h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g -(:)40 b Ft(53)399 412 y(2.6.1)93 b(Ho)m(w)31 b(Completing)g(W)-8 +(:)40 b Ft(54)399 412 y(2.6.1)93 b(Ho)m(w)31 b(Completing)g(W)-8 b(orks)11 b Fn(:)16 b(:)g(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f (:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:) -g(:)h(:)f(:)h(:)24 b Ft(53)399 521 y(2.6.2)93 b(Completion)31 +g(:)h(:)f(:)h(:)24 b Ft(54)399 521 y(2.6.2)93 b(Completion)31 b(F)-8 b(unctions)28 b Fn(:)15 b(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:) f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f -(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)40 b Ft(54)399 631 y(2.6.3)93 +(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)40 b Ft(55)399 631 y(2.6.3)93 b(Completion)31 b(V)-8 b(ariables)18 b Fn(:)e(:)g(:)f(:)g(:)h(:)f(:)h (:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:) f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)31 b -Ft(55)399 741 y(2.6.4)93 b(A)30 b(Short)g(Completion)h(Example)15 +Ft(56)399 741 y(2.6.4)93 b(A)30 b(Short)g(Completion)h(Example)15 b Fn(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:) h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)28 b -Ft(60)150 991 y Fr(App)t(endix)44 b(A)119 b(GNU)39 b(F)-11 +Ft(61)150 991 y Fr(App)t(endix)44 b(A)119 b(GNU)39 b(F)-11 b(ree)38 b(Do)t(cumen)l(tation)i(License)25 b Fo(:)20 b(:)32 b Fr(70)150 1269 y(Concept)45 b(Index)36 b Fo(:)19 b(:)h(:)f(:)h(:)f(:)h(:)f(:)h(:)f(:)g(:)h(:)f(:)h(:)f(:)h(:)f(:)h(:)f @@ -7144,9 +7144,9 @@ b(A)29 b(mo)m(v)m(emen)m(t)j(command)d(will)150 628 y(terminate)i(the)g (line,)h(and)f(b)s(egin)g(editing.)275 777 y(Readline)35 b(remem)m(b)s(ers)f(the)h(last)h(incremen)m(tal)g(searc)m(h)f(string.) 54 b(If)34 b(t)m(w)m(o)j Fl(C-r)p Ft(s)c(are)i(t)m(yp)s(ed)g(without) -150 886 y(an)m(y)i(in)m(terv)m(ening)g(c)m(haracters)h(de\014ning)e(a)h -(new)f(searc)m(h)h(string,)h(an)m(y)f(remem)m(b)s(ered)e(searc)m(h)i -(string)g(is)150 996 y(used.)275 1145 y(Non-incremen)m(tal)48 +150 886 y(an)m(y)42 b(in)m(terv)m(ening)i(c)m(haracters)f(de\014ning)f +(a)g(new)g(searc)m(h)g(string,)k(Readline)c(uses)g(an)m(y)h(remem)m(b)s +(ered)150 996 y(searc)m(h)31 b(string.)275 1145 y(Non-incremen)m(tal)48 b(searc)m(hes)g(read)e(the)h(en)m(tire)h(searc)m(h)f(string)g(b)s (efore)f(starting)h(to)h(searc)m(h)f(for)150 1255 y(matc)m(hing)d (history)e(lines.)78 b(The)42 b(searc)m(h)h(string)g(ma)m(y)g(b)s(e)f @@ -7255,627 +7255,638 @@ Fs(visible)p Ft(',)32 b(Readline)i(uses)f(a)g(visible)g(b)s(ell)g(if)g (attempts)g(to)h(ring)e(the)g(terminal's)1110 3389 y(b)s(ell.)630 3565 y Fs(bind-tty-special-chars)1110 3674 y Ft(If)e(set)g(to)h(`)p Fs(on)p Ft(')f(\(the)g(default\),)i(Readline)f(attempts)g(to)g(bind)d -(the)i(con)m(trol)1110 3784 y(c)m(haracters)30 b(treated)g(sp)s -(ecially)g(b)m(y)f(the)g(k)m(ernel's)h(terminal)f(driv)m(er)g(to)h -(their)1110 3893 y(Readline)h(equiv)-5 b(alen)m(ts.)630 -4069 y Fs(blink-matching-paren)1110 4178 y Ft(If)36 b(set)g(to)h(`)p -Fs(on)p Ft(',)h(Readline)f(attempts)g(to)g(brie\015y)e(mo)m(v)m(e)j -(the)f(cursor)e(to)i(an)1110 4288 y(op)s(ening)k(paren)m(thesis)h(when) -f(a)h(closing)h(paren)m(thesis)e(is)h(inserted.)74 b(The)1110 -4398 y(default)31 b(is)f(`)p Fs(off)p Ft('.)630 4573 -y Fs(colored-completion-prefi)o(x)1110 4682 y Ft(If)f(set)h(to)g(`)p -Fs(on)p Ft(',)g(when)e(listing)i(completions,)h(Readline)f(displa)m(ys) -g(the)f(com-)1110 4792 y(mon)c(pre\014x)f(of)i(the)f(set)h(of)g(p)s -(ossible)f(completions)h(using)f(a)h(di\013eren)m(t)g(color.)1110 -4902 y(The)f(color)h(de\014nitions)f(are)h(tak)m(en)g(from)f(the)g(v)-5 -b(alue)26 b(of)g(the)f Fs(LS_COLORS)e Ft(en-)1110 5011 +(the)i(con)m(trol)1110 3784 y(c)m(haracters)28 b(that)g(are)f(treated)g +(sp)s(ecially)h(b)m(y)f(the)g(k)m(ernel's)g(terminal)g(driv)m(er)1110 +3893 y(to)33 b(their)f(Readline)h(equiv)-5 b(alen)m(ts.)47 +b(These)32 b(o)m(v)m(erride)h(the)f(default)g(Readline)1110 +4003 y(bindings)h(describ)s(ed)g(here.)51 b(T)m(yp)s(e)34 +b(`)p Fs(stty)29 b(-a)p Ft(')34 b(at)h(a)f(Bash)g(prompt)g(to)g(see) +1110 4113 y(y)m(our)h(curren)m(t)g(terminal)h(settings,)i(including)d +(the)h(sp)s(ecial)f(con)m(trol)i(c)m(har-)1110 4222 y(acters)31 +b(\(usually)g Fs(cchars)p Ft(\).)630 4398 y Fs(blink-matching-paren) +1110 4507 y Ft(If)36 b(set)g(to)h(`)p Fs(on)p Ft(',)h(Readline)f +(attempts)g(to)g(brie\015y)e(mo)m(v)m(e)j(the)f(cursor)e(to)i(an)1110 +4617 y(op)s(ening)k(paren)m(thesis)h(when)f(a)h(closing)h(paren)m +(thesis)e(is)h(inserted.)74 b(The)1110 4726 y(default)31 +b(is)f(`)p Fs(off)p Ft('.)630 4902 y Fs(colored-completion-prefi)o(x) +1110 5011 y Ft(If)f(set)h(to)g(`)p Fs(on)p Ft(',)g(when)e(listing)i +(completions,)h(Readline)f(displa)m(ys)g(the)f(com-)1110 +5121 y(mon)c(pre\014x)f(of)i(the)f(set)h(of)g(p)s(ossible)f +(completions)h(using)f(a)h(di\013eren)m(t)g(color.)1110 +5230 y(The)f(color)h(de\014nitions)f(are)h(tak)m(en)g(from)f(the)g(v)-5 +b(alue)26 b(of)g(the)f Fs(LS_COLORS)e Ft(en-)1110 5340 y(vironmen)m(t)34 b(v)-5 b(ariable.)50 b(If)33 b(there)h(is)g(a)f -(color)i(de\014nition)e(in)g Fs(LS_COLORS)e Ft(for)1110 -5121 y(the)22 b(custom)g(su\016x)f(`)p Fs(readline-colored-complet)o -(ion)o(-pre)o(fix)p Ft(',)c(Read-)1110 5230 y(line)24 -b(uses)e(this)i(color)g(for)f(the)h(common)f(pre\014x)f(instead)i(of)f -(its)h(default.)38 b(The)1110 5340 y(default)31 b(is)f(`)p -Fs(off)p Ft('.)p eop end +(color)i(de\014nition)e(in)g Fs(LS_COLORS)e Ft(for)p +eop end %%Page: 6 10 TeXDict begin 6 9 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2153 b(6)630 299 y Fs(colored-stats)1110 -408 y Ft(If)26 b(set)h(to)g(`)p Fs(on)p Ft(',)h(Readline)f(displa)m(ys) -g(p)s(ossible)f(completions)h(using)f(di\013eren)m(t)1110 -518 y(colors)40 b(to)g(indicate)g(their)f(\014le)h(t)m(yp)s(e.)67 -b(The)38 b(color)j(de\014nitions)d(are)i(tak)m(en)1110 -628 y(from)24 b(the)h(v)-5 b(alue)25 b(of)g(the)g Fs(LS_COLORS)d -Ft(en)m(vironmen)m(t)j(v)-5 b(ariable.)40 b(The)24 b(default)1110 -737 y(is)30 b(`)p Fs(off)p Ft('.)630 925 y Fs(comment-begin)1110 -1035 y Ft(The)62 b(string)g(to)h(insert)f(at)h(the)g(b)s(eginning)e(of) -h(the)h(line)f(when)g(the)1110 1144 y Fs(insert-comment)26 -b Ft(command)31 b(is)f(executed.)42 b(The)30 b(default)g(v)-5 -b(alue)31 b(is)f Fs("#")p Ft(.)630 1332 y Fs(completion-display-width) -1110 1442 y Ft(The)41 b(n)m(um)m(b)s(er)f(of)i(screen)g(columns)f(used) -g(to)h(displa)m(y)g(p)s(ossible)f(matc)m(hes)1110 1551 -y(when)28 b(p)s(erforming)g(completion.)41 b(The)29 b(v)-5 -b(alue)29 b(is)g(ignored)g(if)g(it)h(is)f(less)g(than)1110 -1661 y(0)e(or)f(greater)h(than)f(the)g(terminal)h(screen)f(width.)39 -b(A)26 b(v)-5 b(alue)27 b(of)f(0)h(will)f(cause)1110 -1771 y(matc)m(hes)32 b(to)f(b)s(e)e(displa)m(y)m(ed)i(one)g(p)s(er)e -(line.)41 b(The)30 b(default)h(v)-5 b(alue)31 b(is)f(-1.)630 -1958 y Fs(completion-ignore-case)1110 2068 y Ft(If)d(set)h(to)g(`)p +b(Command)29 b(Line)i(Editing)2153 b(6)1110 299 y(the)22 +b(custom)g(su\016x)f(`)p Fs(readline-colored-complet)o(ion)o(-pre)o +(fix)p Ft(',)c(Read-)1110 408 y(line)24 b(uses)e(this)i(color)g(for)f +(the)h(common)f(pre\014x)f(instead)i(of)f(its)h(default.)38 +b(The)1110 518 y(default)31 b(is)f(`)p Fs(off)p Ft('.)630 +682 y Fs(colored-stats)1110 792 y Ft(If)c(set)h(to)g(`)p +Fs(on)p Ft(',)h(Readline)f(displa)m(ys)g(p)s(ossible)f(completions)h +(using)f(di\013eren)m(t)1110 902 y(colors)40 b(to)g(indicate)g(their)f +(\014le)h(t)m(yp)s(e.)67 b(The)38 b(color)j(de\014nitions)d(are)i(tak)m +(en)1110 1011 y(from)24 b(the)h(v)-5 b(alue)25 b(of)g(the)g +Fs(LS_COLORS)d Ft(en)m(vironmen)m(t)j(v)-5 b(ariable.)40 +b(The)24 b(default)1110 1121 y(is)30 b(`)p Fs(off)p Ft('.)630 +1285 y Fs(comment-begin)1110 1395 y Ft(The)62 b(string)g(to)h(insert)f +(at)h(the)g(b)s(eginning)e(of)h(the)h(line)f(when)g(the)1110 +1504 y Fs(insert-comment)26 b Ft(command)31 b(is)f(executed.)42 +b(The)30 b(default)g(v)-5 b(alue)31 b(is)f Fs("#")p Ft(.)630 +1669 y Fs(completion-display-width)1110 1778 y Ft(The)41 +b(n)m(um)m(b)s(er)f(of)i(screen)g(columns)f(used)g(to)h(displa)m(y)g(p) +s(ossible)f(matc)m(hes)1110 1888 y(when)28 b(p)s(erforming)g +(completion.)41 b(The)29 b(v)-5 b(alue)29 b(is)g(ignored)g(if)g(it)h +(is)f(less)g(than)1110 1998 y(0)e(or)f(greater)h(than)f(the)g(terminal) +h(screen)f(width.)39 b(A)26 b(v)-5 b(alue)27 b(of)f(0)h(will)f(cause) +1110 2107 y(matc)m(hes)32 b(to)f(b)s(e)e(displa)m(y)m(ed)i(one)g(p)s +(er)e(line.)41 b(The)30 b(default)h(v)-5 b(alue)31 b(is)f(-1.)630 +2271 y Fs(completion-ignore-case)1110 2381 y Ft(If)d(set)h(to)g(`)p Fs(on)p Ft(',)g(Readline)g(p)s(erforms)e(\014lename)h(matc)m(hing)i -(and)e(completion)1110 2178 y(in)j(a)h(case-insensitiv)m(e)i(fashion.) +(and)e(completion)1110 2491 y(in)j(a)h(case-insensitiv)m(e)i(fashion.) 40 b(The)30 b(default)h(v)-5 b(alue)30 b(is)h(`)p Fs(off)p -Ft('.)630 2365 y Fs(completion-map-case)1110 2475 y Ft(If)22 +Ft('.)630 2655 y Fs(completion-map-case)1110 2765 y Ft(If)22 b(set)g(to)h(`)p Fs(on)p Ft(',)h(and)e Fj(completion-ignore-case)31 -b Ft(is)22 b(enabled,)i(Readline)f(treats)1110 2585 y(h)m(yphens)29 +b Ft(is)22 b(enabled,)i(Readline)f(treats)1110 2874 y(h)m(yphens)29 b(\(`)p Fs(-)p Ft('\))j(and)e(underscores)g(\(`)p Fs(_)p Ft('\))i(as)f(equiv)-5 b(alen)m(t)32 b(when)e(p)s(erforming)1110 -2694 y(case-insensitiv)m(e)47 b(\014lename)e(matc)m(hing)g(and)f -(completion.)85 b(The)44 b(default)1110 2804 y(v)-5 b(alue)31 -b(is)f(`)p Fs(off)p Ft('.)630 2992 y Fs(completion-prefix-displa)o -(y-le)o(ngth)1110 3101 y Ft(The)h(length)g(in)g(c)m(haracters)i(of)f +2984 y(case-insensitiv)m(e)47 b(\014lename)e(matc)m(hing)g(and)f +(completion.)85 b(The)44 b(default)1110 3093 y(v)-5 b(alue)31 +b(is)f(`)p Fs(off)p Ft('.)630 3258 y Fs(completion-prefix-displa)o +(y-le)o(ngth)1110 3367 y Ft(The)h(length)g(in)g(c)m(haracters)i(of)f (the)f(common)h(pre\014x)e(of)h(a)h(list)g(of)f(p)s(ossible)1110 -3211 y(completions)g(that)f(is)g(displa)m(y)m(ed)g(without)g(mo)s -(di\014cation.)41 b(When)29 b(set)h(to)h(a)1110 3320 +3477 y(completions)g(that)f(is)g(displa)m(y)m(ed)g(without)g(mo)s +(di\014cation.)41 b(When)29 b(set)h(to)h(a)1110 3587 y(v)-5 b(alue)26 b(greater)h(than)e(zero,)j(common)e(pre\014xes)e -(longer)j(than)e(this)g(v)-5 b(alue)27 b(are)1110 3430 +(longer)j(than)e(this)g(v)-5 b(alue)27 b(are)1110 3696 y(replaced)k(with)f(an)g(ellipsis)h(when)e(displa)m(ying)i(p)s(ossible) -f(completions.)630 3618 y Fs(completion-query-items)1110 -3727 y Ft(The)c(n)m(um)m(b)s(er)f(of)h(p)s(ossible)g(completions)h -(that)g(determines)f(when)f(the)i(user)1110 3837 y(is)43 +f(completions.)630 3861 y Fs(completion-query-items)1110 +3970 y Ft(The)c(n)m(um)m(b)s(er)f(of)h(p)s(ossible)g(completions)h +(that)g(determines)f(when)f(the)i(user)1110 4080 y(is)43 b(ask)m(ed)g(whether)f(the)g(list)h(of)g(p)s(ossibilities)g(should)f(b) -s(e)g(displa)m(y)m(ed.)77 b(If)1110 3947 y(the)29 b(n)m(um)m(b)s(er)f +s(e)g(displa)m(y)m(ed.)77 b(If)1110 4189 y(the)29 b(n)m(um)m(b)s(er)f (of)h(p)s(ossible)g(completions)h(is)f(greater)h(than)f(or)g(equal)g -(to)h(this)1110 4056 y(v)-5 b(alue,)45 b(Readline)e(will)f(ask)g +(to)h(this)1110 4299 y(v)-5 b(alue,)45 b(Readline)e(will)f(ask)g (whether)f(or)h(not)g(the)g(user)f(wishes)g(to)i(view)1110 -4166 y(them;)33 b(otherwise,)f(they)g(are)g(simply)g(listed.)45 +4408 y(them;)33 b(otherwise,)f(they)g(are)g(simply)g(listed.)45 b(This)31 b(v)-5 b(ariable)33 b(m)m(ust)e(b)s(e)g(set)1110 -4275 y(to)43 b(an)e(in)m(teger)j(v)-5 b(alue)42 b(greater)h(than)f(or)g +4518 y(to)43 b(an)e(in)m(teger)j(v)-5 b(alue)42 b(greater)h(than)f(or)g (equal)g(to)h(zero.)76 b(A)42 b(zero)g(v)-5 b(alue)1110 -4385 y(means)40 b(Readline)h(should)f(nev)m(er)g(ask;)46 +4628 y(means)40 b(Readline)h(should)f(nev)m(er)g(ask;)46 b(negativ)m(e)d(v)-5 b(alues)41 b(are)f(treated)i(as)1110 -4495 y(zero.)g(The)29 b(default)i(limit)g(is)g Fs(100)p -Ft(.)630 4682 y Fs(convert-meta)1110 4792 y Ft(If)22 +4737 y(zero.)g(The)29 b(default)i(limit)g(is)g Fs(100)p +Ft(.)630 4902 y Fs(convert-meta)1110 5011 y Ft(If)22 b(set)g(to)h(`)p Fs(on)p Ft(',)h(Readline)f(will)f(con)m(v)m(ert)i(c)m (haracters)f(with)f(the)g(eigh)m(th)h(bit)f(set)1110 -4902 y(to)33 b(an)e Fm(asci)r(i)h Ft(k)m(ey)h(sequence)f(b)m(y)g +5121 y(to)33 b(an)e Fm(asci)r(i)h Ft(k)m(ey)h(sequence)f(b)m(y)g (stripping)f(the)h(eigh)m(th)h(bit)f(and)f(pre\014xing)1110 -5011 y(an)24 b Fs(ESC)g Ft(c)m(haracter,)j(con)m(v)m(erting)f(them)f -(to)g(a)g(meta-pre\014xed)f(k)m(ey)h(sequence.)1110 5121 +5230 y(an)24 b Fs(ESC)g Ft(c)m(haracter,)j(con)m(v)m(erting)f(them)f +(to)g(a)g(meta-pre\014xed)f(k)m(ey)h(sequence.)1110 5340 y(The)i(default)h(v)-5 b(alue)28 b(is)f(`)p Fs(on)p Ft(',)i(but)d(will) i(b)s(e)f(set)h(to)g(`)p Fs(off)p Ft(')g(if)f(the)h(lo)s(cale)h(is)f -(one)1110 5230 y(that)21 b(con)m(tains)h(eigh)m(t-bit)h(c)m(haracters.) -39 b(This)20 b(v)-5 b(ariable)21 b(is)g(dep)s(enden)m(t)f(on)h(the)1110 -5340 y Fs(LC_CTYPE)26 b Ft(lo)s(cale)31 b(category)-8 -b(,)31 b(and)d(ma)m(y)h(c)m(hange)h(if)e(the)h(lo)s(cale)h(is)f(c)m -(hanged.)p eop end +(one)p eop end %%Page: 7 11 TeXDict begin 7 10 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2153 b(7)630 299 y Fs(disable-completion) -1110 408 y Ft(If)36 b(set)h(to)h(`)p Fs(On)p Ft(',)g(Readline)f(will)g -(inhibit)f(w)m(ord)h(completion.)60 b(Completion)1110 -518 y(c)m(haracters)28 b(will)e(b)s(e)f(inserted)h(in)m(to)h(the)g -(line)f(as)g(if)g(they)h(had)e(b)s(een)g(mapp)s(ed)1110 -628 y(to)31 b Fs(self-insert)p Ft(.)38 b(The)30 b(default)g(is)h(`)p -Fs(off)p Ft('.)630 774 y Fs(echo-control-characters)1110 -883 y Ft(When)f(set)h(to)g(`)p Fs(on)p Ft(',)f(on)g(op)s(erating)h -(systems)f(that)h(indicate)g(they)g(supp)s(ort)1110 993 -y(it,)e(Readline)g(ec)m(ho)s(es)g(a)f(c)m(haracter)i(corresp)s(onding)d -(to)i(a)f(signal)h(generated)1110 1103 y(from)h(the)g(k)m(eyb)s(oard.) -41 b(The)30 b(default)g(is)h(`)p Fs(on)p Ft('.)630 1249 -y Fs(editing-mode)1110 1358 y Ft(The)d Fs(editing-mode)e -Ft(v)-5 b(ariable)29 b(con)m(trols)h(whic)m(h)e(default)h(set)h(of)e(k) -m(ey)i(bind-)1110 1468 y(ings)25 b(is)g(used.)38 b(By)26 -b(default,)g(Readline)g(starts)f(up)f(in)h(Emacs)g(editing)h(mo)s(de,) -1110 1577 y(where)j(the)g(k)m(eystrok)m(es)i(are)e(most)h(similar)f(to) -h(Emacs.)40 b(This)29 b(v)-5 b(ariable)30 b(can)1110 -1687 y(b)s(e)g(set)h(to)g(either)g(`)p Fs(emacs)p Ft(')e(or)h(`)p -Fs(vi)p Ft('.)630 1833 y Fs(emacs-mode-string)1110 1943 -y Ft(If)j(the)h Fj(sho)m(w-mo)s(de-in-prompt)h Ft(v)-5 -b(ariable)35 b(is)e(enabled,)i(this)f(string)f(is)h(dis-)1110 -2052 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the)g(last)h(line)f -(of)h(the)f(primary)f(prompt)g(when)1110 2162 y(emacs)g(editing)h(mo)s -(de)e(is)h(activ)m(e.)40 b(The)21 b(v)-5 b(alue)22 b(is)g(expanded)f -(lik)m(e)h(a)h(k)m(ey)f(bind-)1110 2271 y(ing,)27 b(so)f(the)f -(standard)g(set)h(of)f(meta-)i(and)e(con)m(trol)i(pre\014xes)d(and)h -(bac)m(kslash)1110 2381 y(escap)s(e)f(sequences)h(is)e(a)m(v)-5 -b(ailable.)41 b(Use)25 b(the)f(`)p Fs(\\1)p Ft(')f(and)h(`)p -Fs(\\2)p Ft(')g(escap)s(es)g(to)g(b)s(egin)1110 2491 -y(and)37 b(end)g(sequences)h(of)f(non-prin)m(ting)h(c)m(haracters,)j -(whic)m(h)c(can)h(b)s(e)f(used)1110 2600 y(to)h(em)m(b)s(ed)f(a)g -(terminal)h(con)m(trol)h(sequence)f(in)m(to)g(the)f(mo)s(de)g(string.) -61 b(The)1110 2710 y(default)31 b(is)f(`)p Fs(@)p Ft('.)630 -2856 y Fs(enable-active-region)1110 2966 y Ft(The)46 +b(Command)29 b(Line)i(Editing)2153 b(7)1110 299 y(that)21 +b(con)m(tains)h(eigh)m(t-bit)h(c)m(haracters.)39 b(This)20 +b(v)-5 b(ariable)21 b(is)g(dep)s(enden)m(t)f(on)h(the)1110 +408 y Fs(LC_CTYPE)26 b Ft(lo)s(cale)31 b(category)-8 +b(,)31 b(and)d(ma)m(y)h(c)m(hange)h(if)e(the)h(lo)s(cale)h(is)f(c)m +(hanged.)630 591 y Fs(disable-completion)1110 701 y Ft(If)36 +b(set)h(to)h(`)p Fs(On)p Ft(',)g(Readline)f(will)g(inhibit)f(w)m(ord)h +(completion.)60 b(Completion)1110 810 y(c)m(haracters)28 +b(will)e(b)s(e)f(inserted)h(in)m(to)h(the)g(line)f(as)g(if)g(they)h +(had)e(b)s(een)g(mapp)s(ed)1110 920 y(to)31 b Fs(self-insert)p +Ft(.)38 b(The)30 b(default)g(is)h(`)p Fs(off)p Ft('.)630 +1103 y Fs(echo-control-characters)1110 1212 y Ft(When)f(set)h(to)g(`)p +Fs(on)p Ft(',)f(on)g(op)s(erating)h(systems)f(that)h(indicate)g(they)g +(supp)s(ort)1110 1322 y(it,)e(Readline)g(ec)m(ho)s(es)g(a)f(c)m +(haracter)i(corresp)s(onding)d(to)i(a)f(signal)h(generated)1110 +1431 y(from)h(the)g(k)m(eyb)s(oard.)41 b(The)30 b(default)g(is)h(`)p +Fs(on)p Ft('.)630 1614 y Fs(editing-mode)1110 1724 y +Ft(The)d Fs(editing-mode)e Ft(v)-5 b(ariable)29 b(con)m(trols)h(whic)m +(h)e(default)h(set)h(of)e(k)m(ey)i(bind-)1110 1833 y(ings)25 +b(is)g(used.)38 b(By)26 b(default,)g(Readline)g(starts)f(up)f(in)h +(Emacs)g(editing)h(mo)s(de,)1110 1943 y(where)j(the)g(k)m(eystrok)m(es) +i(are)e(most)h(similar)f(to)h(Emacs.)40 b(This)29 b(v)-5 +b(ariable)30 b(can)1110 2052 y(b)s(e)g(set)h(to)g(either)g(`)p +Fs(emacs)p Ft(')e(or)h(`)p Fs(vi)p Ft('.)630 2235 y Fs +(emacs-mode-string)1110 2345 y Ft(If)j(the)h Fj(sho)m(w-mo)s +(de-in-prompt)h Ft(v)-5 b(ariable)35 b(is)e(enabled,)i(this)f(string)f +(is)h(dis-)1110 2454 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the) +g(last)h(line)f(of)h(the)f(primary)f(prompt)g(when)1110 +2564 y(emacs)g(editing)h(mo)s(de)e(is)h(activ)m(e.)40 +b(The)21 b(v)-5 b(alue)22 b(is)g(expanded)f(lik)m(e)h(a)h(k)m(ey)f +(bind-)1110 2673 y(ing,)27 b(so)f(the)f(standard)g(set)h(of)f(meta-)i +(and)e(con)m(trol)i(pre\014xes)d(and)h(bac)m(kslash)1110 +2783 y(escap)s(e)f(sequences)h(is)e(a)m(v)-5 b(ailable.)41 +b(Use)25 b(the)f(`)p Fs(\\1)p Ft(')f(and)h(`)p Fs(\\2)p +Ft(')g(escap)s(es)g(to)g(b)s(egin)1110 2892 y(and)37 +b(end)g(sequences)h(of)f(non-prin)m(ting)h(c)m(haracters,)j(whic)m(h)c +(can)h(b)s(e)f(used)1110 3002 y(to)h(em)m(b)s(ed)f(a)g(terminal)h(con)m +(trol)h(sequence)f(in)m(to)g(the)f(mo)s(de)g(string.)61 +b(The)1110 3112 y(default)31 b(is)f(`)p Fs(@)p Ft('.)630 +3294 y Fs(enable-active-region)1110 3404 y Ft(The)46 b Fj(p)s(oin)m(t)j Ft(is)e(the)g(curren)m(t)f(cursor)g(p)s(osition,)52 -b(and)46 b Fj(mark)52 b Ft(refers)46 b(to)i(a)1110 3075 +b(and)46 b Fj(mark)52 b Ft(refers)46 b(to)i(a)1110 3513 y(sa)m(v)m(ed)37 b(cursor)f(p)s(osition)g(\(see)i(Section)f(1.4.1)h -([Commands)d(F)-8 b(or)37 b(Mo)m(ving],)1110 3185 y(page)25 +([Commands)d(F)-8 b(or)37 b(Mo)m(ving],)1110 3623 y(page)25 b(17\).)40 b(The)24 b(text)h(b)s(et)m(w)m(een)g(the)g(p)s(oin)m(t)f -(and)g(mark)g(is)g(referred)g(to)h(as)g(the)1110 3294 +(and)g(mark)g(is)g(referred)g(to)h(as)g(the)1110 3733 y Fj(region)p Ft(.)62 b(When)37 b(this)g(v)-5 b(ariable)38 b(is)f(set)h(to)g(`)p Fs(On)p Ft(',)h(Readline)f(allo)m(ws)g(certain) -1110 3404 y(commands)f(to)h(designate)h(the)e(region)h(as)g +1110 3842 y(commands)f(to)h(designate)h(the)e(region)h(as)g Fj(activ)m(e)p Ft(.)64 b(When)37 b(the)h(region)g(is)1110 -3513 y(activ)m(e,)43 b(Readline)38 b(highligh)m(ts)h(the)g(text)g(in)e -(the)i(region)g(using)e(the)h(v)-5 b(alue)1110 3623 y(of)35 +3952 y(activ)m(e,)43 b(Readline)38 b(highligh)m(ts)h(the)g(text)g(in)e +(the)i(region)g(using)e(the)h(v)-5 b(alue)1110 4061 y(of)35 b(the)g Fs(active-region-start-color)p Ft(,)30 b(whic)m(h)35 -b(defaults)g(to)h(the)f(string)1110 3733 y(that)23 b(enables)f(the)g +b(defaults)g(to)h(the)f(string)1110 4171 y(that)23 b(enables)f(the)g (terminal's)h(standout)e(mo)s(de.)38 b(The)21 b(activ)m(e)k(region)d -(sho)m(ws)1110 3842 y(the)32 b(text)h(inserted)f(b)m(y)g(brac)m(k)m +(sho)m(ws)1110 4281 y(the)32 b(text)h(inserted)f(b)m(y)g(brac)m(k)m (eted-paste)i(and)e(an)m(y)g(matc)m(hing)h(text)g(found)1110 -3952 y(b)m(y)f(incremen)m(tal)i(and)e(non-incremen)m(tal)i(history)e -(searc)m(hes.)48 b(The)32 b(default)1110 4061 y(is)e(`)p -Fs(On)p Ft('.)630 4208 y Fs(enable-bracketed-paste)1110 -4317 y Ft(When)36 b(set)h(to)g(`)p Fs(On)p Ft(',)h(Readline)f +4390 y(b)m(y)f(incremen)m(tal)i(and)e(non-incremen)m(tal)i(history)e +(searc)m(hes.)48 b(The)32 b(default)1110 4500 y(is)e(`)p +Fs(On)p Ft('.)630 4682 y Fs(enable-bracketed-paste)1110 +4792 y Ft(When)36 b(set)h(to)g(`)p Fs(On)p Ft(',)h(Readline)f (con\014gures)f(the)h(terminal)f(to)i(insert)e(eac)m(h)1110 -4427 y(paste)27 b(in)m(to)g(the)f(editing)h(bu\013er)e(as)h(a)h(single) -g(string)f(of)g(c)m(haracters,)j(instead)1110 4536 y(of)d(treating)i +4902 y(paste)27 b(in)m(to)g(the)f(editing)h(bu\013er)e(as)h(a)h(single) +g(string)f(of)g(c)m(haracters,)j(instead)1110 5011 y(of)d(treating)i (eac)m(h)g(c)m(haracter)f(as)g(if)f(it)h(had)f(b)s(een)f(read)i(from)e -(the)i(k)m(eyb)s(oard.)1110 4646 y(This)36 b(is)h(called)h(putting)f +(the)i(k)m(eyb)s(oard.)1110 5121 y(This)36 b(is)h(called)h(putting)f (the)h(terminal)f(in)m(to)h Fj(brac)m(k)m(eted)h(paste)e(mo)s(de)5 -b Ft(;)40 b(it)1110 4756 y(prev)m(en)m(ts)30 b(Readline)h(from)e +b Ft(;)40 b(it)1110 5230 y(prev)m(en)m(ts)30 b(Readline)h(from)e (executing)i(an)m(y)f(editing)h(commands)e(b)s(ound)f(to)1110 -4865 y(k)m(ey)j(sequences)g(app)s(earing)f(in)g(the)g(pasted)h(text.)42 -b(The)29 b(default)i(is)f(`)p Fs(On)p Ft('.)630 5011 -y Fs(enable-keypad)1110 5121 y Ft(When)23 b(set)h(to)g(`)p -Fs(on)p Ft(',)h(Readline)f(will)g(try)f(to)h(enable)g(the)f -(application)i(k)m(eypad)1110 5230 y(when)h(it)h(is)f(called.)41 -b(Some)27 b(systems)f(need)h(this)f(to)h(enable)g(the)g(arro)m(w)g(k)m -(eys.)1110 5340 y(The)j(default)g(is)h(`)p Fs(off)p Ft('.)p -eop end +5340 y(k)m(ey)j(sequences)g(app)s(earing)f(in)g(the)g(pasted)h(text.)42 +b(The)29 b(default)i(is)f(`)p Fs(On)p Ft('.)p eop end %%Page: 8 12 TeXDict begin 8 11 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2153 b(8)630 299 y Fs(enable-meta-key) -1110 408 y Ft(When)40 b(set)g(to)g(`)p Fs(on)p Ft(',)j(Readline)d(will) -g(try)g(to)g(enable)g(an)m(y)g(meta)h(mo)s(di\014er)1110 -518 y(k)m(ey)i(the)e(terminal)i(claims)f(to)h(supp)s(ort)d(when)h(it)h -(is)g(called.)76 b(On)41 b(man)m(y)1110 628 y(terminals,)c(the)e(meta)h -(k)m(ey)g(is)f(used)g(to)h(send)e(eigh)m(t-bit)j(c)m(haracters.)56 -b(The)1110 737 y(default)31 b(is)f(`)p Fs(on)p Ft('.)630 -894 y Fs(expand-tilde)1110 1003 y Ft(If)d(set)h(to)h(`)p +b(Command)29 b(Line)i(Editing)2153 b(8)630 299 y Fs(enable-keypad)1110 +408 y Ft(When)23 b(set)h(to)g(`)p Fs(on)p Ft(',)h(Readline)f(will)g +(try)f(to)h(enable)g(the)f(application)i(k)m(eypad)1110 +518 y(when)h(it)h(is)f(called.)41 b(Some)27 b(systems)f(need)h(this)f +(to)h(enable)g(the)g(arro)m(w)g(k)m(eys.)1110 628 y(The)j(default)g(is) +h(`)p Fs(off)p Ft('.)630 784 y Fs(enable-meta-key)1110 +894 y Ft(When)40 b(set)g(to)g(`)p Fs(on)p Ft(',)j(Readline)d(will)g +(try)g(to)g(enable)g(an)m(y)g(meta)h(mo)s(di\014er)1110 +1003 y(k)m(ey)i(the)e(terminal)i(claims)f(to)h(supp)s(ort)d(when)h(it)h +(is)g(called.)76 b(On)41 b(man)m(y)1110 1113 y(terminals,)c(the)e(meta) +h(k)m(ey)g(is)f(used)g(to)h(send)e(eigh)m(t-bit)j(c)m(haracters.)56 +b(The)1110 1223 y(default)31 b(is)f(`)p Fs(on)p Ft('.)630 +1379 y Fs(expand-tilde)1110 1489 y Ft(If)d(set)h(to)h(`)p Fs(on)p Ft(',)f(tilde)g(expansion)g(is)f(p)s(erformed)f(when)h -(Readline)h(attempts)1110 1113 y(w)m(ord)i(completion.)42 -b(The)30 b(default)g(is)h(`)p Fs(off)p Ft('.)630 1270 -y Fs(history-preserve-point)1110 1379 y Ft(If)41 b(set)h(to)h(`)p +(Readline)h(attempts)1110 1598 y(w)m(ord)i(completion.)42 +b(The)30 b(default)g(is)h(`)p Fs(off)p Ft('.)630 1755 +y Fs(history-preserve-point)1110 1864 y Ft(If)41 b(set)h(to)h(`)p Fs(on)p Ft(',)i(the)c(history)h(co)s(de)g(attempts)h(to)f(place)h(the)f -(p)s(oin)m(t)f(\(the)1110 1489 y(curren)m(t)35 b(cursor)g(p)s +(p)s(oin)m(t)f(\(the)1110 1974 y(curren)m(t)35 b(cursor)g(p)s (osition\))g(at)h(the)g(same)f(lo)s(cation)i(on)e(eac)m(h)h(history)g -(line)1110 1598 y(retriev)m(ed)h(with)f Fs(previous-history)c +(line)1110 2084 y(retriev)m(ed)h(with)f Fs(previous-history)c Ft(or)37 b Fs(next-history)p Ft(.)55 b(The)36 b(default)1110 -1708 y(is)30 b(`)p Fs(off)p Ft('.)630 1864 y Fs(history-size)1110 -1974 y Ft(Set)39 b(the)g(maxim)m(um)g(n)m(um)m(b)s(er)f(of)h(history)g -(en)m(tries)h(sa)m(v)m(ed)g(in)f(the)g(history)1110 2084 +2193 y(is)30 b(`)p Fs(off)p Ft('.)630 2350 y Fs(history-size)1110 +2459 y Ft(Set)39 b(the)g(maxim)m(um)g(n)m(um)m(b)s(er)f(of)h(history)g +(en)m(tries)h(sa)m(v)m(ed)g(in)f(the)g(history)1110 2569 y(list.)51 b(If)34 b(set)g(to)h(zero,)g(an)m(y)f(existing)h(history)f -(en)m(tries)g(are)g(deleted)h(and)e(no)1110 2193 y(new)e(en)m(tries)i +(en)m(tries)g(are)g(deleted)h(and)e(no)1110 2679 y(new)e(en)m(tries)i (are)f(sa)m(v)m(ed.)46 b(If)31 b(set)h(to)h(a)f(v)-5 b(alue)32 b(less)g(than)f(zero,)i(the)f(n)m(um)m(b)s(er)1110 -2303 y(of)f(history)f(en)m(tries)h(is)g(not)g(limited.)42 +2788 y(of)f(history)f(en)m(tries)h(is)g(not)g(limited.)42 b(By)30 b(default,)h(the)g(n)m(um)m(b)s(er)e(of)i(history)1110 -2412 y(en)m(tries)j(is)f(not)g(limited.)49 b(If)32 b(an)h(attempt)h(is) -f(made)g(to)h(set)f Fj(history-size)39 b Ft(to)1110 2522 +2898 y(en)m(tries)j(is)f(not)g(limited.)49 b(If)32 b(an)h(attempt)h(is) +f(made)g(to)h(set)f Fj(history-size)39 b Ft(to)1110 3007 y(a)34 b(non-n)m(umeric)f(v)-5 b(alue,)34 b(the)g(maxim)m(um)f(n)m(um)m -(b)s(er)f(of)h(history)h(en)m(tries)g(will)1110 2632 -y(b)s(e)c(set)h(to)g(500.)630 2788 y Fs(horizontal-scroll-mode)1110 -2898 y Ft(This)k(v)-5 b(ariable)37 b(can)f(b)s(e)f(set)h(to)h(either)f +(b)s(er)f(of)h(history)h(en)m(tries)g(will)1110 3117 +y(b)s(e)c(set)h(to)g(500.)630 3273 y Fs(horizontal-scroll-mode)1110 +3383 y Ft(This)k(v)-5 b(ariable)37 b(can)f(b)s(e)f(set)h(to)h(either)f (`)p Fs(on)p Ft(')g(or)g(`)p Fs(off)p Ft('.)57 b(Setting)36 -b(it)g(to)h(`)p Fs(on)p Ft(')1110 3007 y(means)26 b(that)h(the)f(text)h +b(it)g(to)h(`)p Fs(on)p Ft(')1110 3493 y(means)26 b(that)h(the)f(text)h (of)g(the)f(lines)g(b)s(eing)g(edited)h(will)f(scroll)h(horizon)m -(tally)1110 3117 y(on)32 b(a)g(single)g(screen)g(line)g(when)e(they)i -(are)g(longer)h(than)e(the)h(width)f(of)h(the)1110 3226 +(tally)1110 3602 y(on)32 b(a)g(single)g(screen)g(line)g(when)e(they)i +(are)g(longer)h(than)e(the)h(width)f(of)h(the)1110 3712 y(screen,)c(instead)g(of)f(wrapping)f(on)m(to)i(a)g(new)e(screen)i -(line.)40 b(This)26 b(v)-5 b(ariable)28 b(is)1110 3336 +(line.)40 b(This)26 b(v)-5 b(ariable)28 b(is)1110 3821 y(automatically)k(set)e(to)g(`)p Fs(on)p Ft(')f(for)g(terminals)g(of)h -(heigh)m(t)g(1.)41 b(By)29 b(default,)h(this)1110 3446 +(heigh)m(t)g(1.)41 b(By)29 b(default,)h(this)1110 3931 y(v)-5 b(ariable)31 b(is)g(set)f(to)i(`)p Fs(off)p Ft('.)630 -3602 y Fs(input-meta)1110 3712 y Ft(If)f(set)g(to)h(`)p +4088 y Fs(input-meta)1110 4197 y Ft(If)f(set)g(to)h(`)p Fs(on)p Ft(',)g(Readline)g(will)f(enable)h(eigh)m(t-bit)h(input)d(\(it) -i(will)f(not)h(clear)1110 3821 y(the)40 b(eigh)m(th)g(bit)g(in)f(the)h +i(will)f(not)h(clear)1110 4307 y(the)40 b(eigh)m(th)g(bit)g(in)f(the)h (c)m(haracters)h(it)f(reads\),)j(regardless)c(of)h(what)g(the)1110 -3931 y(terminal)k(claims)h(it)f(can)g(supp)s(ort.)79 +4416 y(terminal)k(claims)h(it)f(can)g(supp)s(ort.)79 b(The)44 b(default)g(v)-5 b(alue)44 b(is)g(`)p Fs(off)p -Ft(',)j(but)1110 4041 y(Readline)24 b(will)h(set)f(it)g(to)h(`)p +Ft(',)j(but)1110 4526 y(Readline)24 b(will)h(set)f(it)g(to)h(`)p Fs(on)p Ft(')e(if)h(the)g(lo)s(cale)i(con)m(tains)f(eigh)m(t-bit)g(c)m -(haracters.)1110 4150 y(The)k(name)g Fs(meta-flag)e Ft(is)i(a)h(synon)m +(haracters.)1110 4635 y(The)k(name)g Fs(meta-flag)e Ft(is)i(a)h(synon)m (ym)f(for)g(this)g(v)-5 b(ariable.)42 b(This)28 b(v)-5 -b(ariable)1110 4260 y(is)35 b(dep)s(enden)m(t)f(on)h(the)g +b(ariable)1110 4745 y(is)35 b(dep)s(enden)m(t)f(on)h(the)g Fs(LC_CTYPE)e Ft(lo)s(cale)k(category)-8 b(,)39 b(and)34 -b(ma)m(y)i(c)m(hange)g(if)1110 4369 y(the)31 b(lo)s(cale)h(is)e(c)m -(hanged.)630 4526 y Fs(isearch-terminators)1110 4635 +b(ma)m(y)i(c)m(hange)g(if)1110 4855 y(the)31 b(lo)s(cale)h(is)e(c)m +(hanged.)630 5011 y Fs(isearch-terminators)1110 5121 y Ft(The)51 b(string)h(of)g(c)m(haracters)h(that)f(should)e(terminate)j -(an)f(incremen)m(tal)1110 4745 y(searc)m(h)25 b(without)g(subsequen)m +(an)f(incremen)m(tal)1110 5230 y(searc)m(h)25 b(without)g(subsequen)m (tly)g(executing)h(the)f(c)m(haracter)h(as)f(a)g(command)1110 -4855 y(\(see)45 b(Section)h(1.2.5)g([Searc)m(hing],)j(page)d(3\).)84 -b(If)44 b(this)g(v)-5 b(ariable)45 b(has)g(not)1110 4964 -y(b)s(een)35 b(giv)m(en)h(a)g(v)-5 b(alue,)37 b(the)f(c)m(haracters)h +5340 y(\(see)45 b(Section)h(1.2.5)g([Searc)m(hing],)j(page)d(3\).)84 +b(If)44 b(this)g(v)-5 b(ariable)45 b(has)g(not)p eop +end +%%Page: 9 13 +TeXDict begin 9 12 bop 150 -116 a Ft(Chapter)30 b(1:)41 +b(Command)29 b(Line)i(Editing)2153 b(9)1110 299 y(b)s(een)35 +b(giv)m(en)h(a)g(v)-5 b(alue,)37 b(the)f(c)m(haracters)h Fs(ESC)d Ft(and)h Fl(C-J)g Ft(will)h(terminate)g(an)1110 -5074 y(incremen)m(tal)c(searc)m(h.)630 5230 y Fs(keymap)192 +408 y(incremen)m(tal)c(searc)m(h.)630 596 y Fs(keymap)192 b Ft(Sets)64 b(Readline's)i(idea)f(of)f(the)h(curren)m(t)f(k)m(eymap)h -(for)f(k)m(ey)h(binding)1110 5340 y(commands.)71 b(Built-in)41 +(for)f(k)m(ey)h(binding)1110 706 y(commands.)71 b(Built-in)41 b Fs(keymap)e Ft(names)h(are)h Fs(emacs)p Ft(,)h Fs(emacs-standard)p -Ft(,)p eop end -%%Page: 9 13 -TeXDict begin 9 12 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2153 b(9)1110 299 y Fs(emacs-meta)p -Ft(,)99 b Fs(emacs-ctlx)p Ft(,)f Fs(vi)p Ft(,)j Fs(vi-move)p -Ft(,)f Fs(vi-command)p Ft(,)f(and)1110 408 y Fs(vi-insert)p -Ft(.)81 b Fs(vi)44 b Ft(is)h(equiv)-5 b(alen)m(t)46 b(to)g -Fs(vi-command)c Ft(\()p Fs(vi-move)h Ft(is)i(also)h(a)1110 -518 y(synon)m(ym\);)41 b Fs(emacs)c Ft(is)h(equiv)-5 -b(alen)m(t)39 b(to)f Fs(emacs-standard)p Ft(.)59 b(Applications)1110 -628 y(ma)m(y)32 b(add)e(additional)i(names.)43 b(The)30 -b(default)h(v)-5 b(alue)32 b(is)f Fs(emacs)p Ft(.)41 -b(The)30 b(v)-5 b(alue)1110 737 y(of)31 b(the)f Fs(editing-mode)d -Ft(v)-5 b(ariable)31 b(also)h(a\013ects)f(the)g(default)g(k)m(eymap.) -630 909 y Fs(keyseq-timeout)1110 1019 y Ft(Sp)s(eci\014es)25 -b(the)g(duration)g(Readline)h(will)g(w)m(ait)g(for)g(a)f(c)m(haracter)i -(when)e(read-)1110 1129 y(ing)30 b(an)g(am)m(biguous)g(k)m(ey)h -(sequence)f(\(one)g(that)h(can)f(form)g(a)g(complete)h(k)m(ey)1110 -1238 y(sequence)j(using)e(the)i(input)e(read)h(so)g(far,)h(or)g(can)f -(tak)m(e)i(additional)f(input)1110 1348 y(to)g(complete)g(a)f(longer)h -(k)m(ey)f(sequence\).)49 b(If)33 b(no)f(input)g(is)h(receiv)m(ed)h -(within)1110 1457 y(the)43 b(timeout,)48 b(Readline)43 -b(will)g(use)g(the)g(shorter)g(but)f(complete)j(k)m(ey)e(se-)1110 -1567 y(quence.)c(Readline)26 b(uses)f(this)h(v)-5 b(alue)26 -b(to)g(determine)g(whether)f(or)g(not)h(input)1110 1677 -y(is)31 b(a)m(v)-5 b(ailable)33 b(on)d(the)h(curren)m(t)f(input)g -(source)h(\()p Fs(rl_instream)d Ft(b)m(y)i(default\).)1110 -1786 y(The)25 b(v)-5 b(alue)26 b(is)f(sp)s(eci\014ed)f(in)h +Ft(,)1110 816 y Fs(emacs-meta)p Ft(,)99 b Fs(emacs-ctlx)p +Ft(,)f Fs(vi)p Ft(,)j Fs(vi-move)p Ft(,)f Fs(vi-command)p +Ft(,)f(and)1110 925 y Fs(vi-insert)p Ft(.)81 b Fs(vi)44 +b Ft(is)h(equiv)-5 b(alen)m(t)46 b(to)g Fs(vi-command)c +Ft(\()p Fs(vi-move)h Ft(is)i(also)h(a)1110 1035 y(synon)m(ym\);)41 +b Fs(emacs)c Ft(is)h(equiv)-5 b(alen)m(t)39 b(to)f Fs(emacs-standard)p +Ft(.)59 b(Applications)1110 1144 y(ma)m(y)32 b(add)e(additional)i +(names.)43 b(The)30 b(default)h(v)-5 b(alue)32 b(is)f +Fs(emacs)p Ft(.)41 b(The)30 b(v)-5 b(alue)1110 1254 y(of)31 +b(the)f Fs(editing-mode)d Ft(v)-5 b(ariable)31 b(also)h(a\013ects)f +(the)g(default)g(k)m(eymap.)630 1442 y Fs(keyseq-timeout)1110 +1551 y Ft(Sp)s(eci\014es)25 b(the)g(duration)g(Readline)h(will)g(w)m +(ait)g(for)g(a)f(c)m(haracter)i(when)e(read-)1110 1661 +y(ing)30 b(an)g(am)m(biguous)g(k)m(ey)h(sequence)f(\(one)g(that)h(can)f +(form)g(a)g(complete)h(k)m(ey)1110 1771 y(sequence)j(using)e(the)i +(input)e(read)h(so)g(far,)h(or)g(can)f(tak)m(e)i(additional)f(input) +1110 1880 y(to)g(complete)g(a)f(longer)h(k)m(ey)f(sequence\).)49 +b(If)33 b(no)f(input)g(is)h(receiv)m(ed)h(within)1110 +1990 y(the)43 b(timeout,)48 b(Readline)43 b(will)g(use)g(the)g(shorter) +g(but)f(complete)j(k)m(ey)e(se-)1110 2099 y(quence.)c(Readline)26 +b(uses)f(this)h(v)-5 b(alue)26 b(to)g(determine)g(whether)f(or)g(not)h +(input)1110 2209 y(is)31 b(a)m(v)-5 b(ailable)33 b(on)d(the)h(curren)m +(t)f(input)g(source)h(\()p Fs(rl_instream)d Ft(b)m(y)i(default\).)1110 +2318 y(The)25 b(v)-5 b(alue)26 b(is)f(sp)s(eci\014ed)f(in)h (milliseconds,)j(so)d(a)h(v)-5 b(alue)26 b(of)f(1000)i(means)e(that) -1110 1896 y(Readline)e(will)g(w)m(ait)g(one)g(second)f(for)g +1110 2428 y(Readline)e(will)g(w)m(ait)g(one)g(second)f(for)g (additional)i(input.)37 b(If)22 b(this)g(v)-5 b(ariable)23 -b(is)1110 2005 y(set)28 b(to)h(a)f(v)-5 b(alue)29 b(less)f(than)g(or)f +b(is)1110 2538 y(set)28 b(to)h(a)f(v)-5 b(alue)29 b(less)f(than)g(or)f (equal)i(to)f(zero,)i(or)e(to)g(a)h(non-n)m(umeric)e(v)-5 -b(alue,)1110 2115 y(Readline)30 b(will)f(w)m(ait)i(un)m(til)e(another)h +b(alue,)1110 2647 y(Readline)30 b(will)f(w)m(ait)i(un)m(til)e(another)h (k)m(ey)g(is)f(pressed)g(to)h(decide)f(whic)m(h)g(k)m(ey)1110 -2225 y(sequence)i(to)g(complete.)42 b(The)30 b(default)g(v)-5 -b(alue)31 b(is)g Fs(500)p Ft(.)630 2397 y Fs(mark-directories)1110 -2506 y Ft(If)38 b(set)g(to)h(`)p Fs(on)p Ft(',)i(completed)e(directory) +2757 y(sequence)i(to)g(complete.)42 b(The)30 b(default)g(v)-5 +b(alue)31 b(is)g Fs(500)p Ft(.)630 2945 y Fs(mark-directories)1110 +3054 y Ft(If)38 b(set)g(to)h(`)p Fs(on)p Ft(',)i(completed)e(directory) f(names)g(ha)m(v)m(e)i(a)e(slash)g(app)s(ended.)1110 -2616 y(The)30 b(default)g(is)h(`)p Fs(on)p Ft('.)630 -2788 y Fs(mark-modified-lines)1110 2898 y Ft(This)k(v)-5 +3164 y(The)30 b(default)g(is)h(`)p Fs(on)p Ft('.)630 +3352 y Fs(mark-modified-lines)1110 3461 y Ft(This)k(v)-5 b(ariable,)38 b(when)d(set)h(to)h(`)p Fs(on)p Ft(',)g(causes)g -(Readline)f(to)h(displa)m(y)f(an)f(as-)1110 3007 y(terisk)f(\(`)p +(Readline)f(to)h(displa)m(y)f(an)f(as-)1110 3571 y(terisk)f(\(`)p Fs(*)p Ft('\))h(at)f(the)g(start)g(of)g(history)g(lines)g(whic)m(h)f -(ha)m(v)m(e)i(b)s(een)e(mo)s(di\014ed.)1110 3117 y(This)d(v)-5 +(ha)m(v)m(e)i(b)s(een)e(mo)s(di\014ed.)1110 3680 y(This)d(v)-5 b(ariable)31 b(is)f(`)p Fs(off)p Ft(')g(b)m(y)g(default.)630 -3289 y Fs(mark-symlinked-directori)o(es)1110 3399 y Ft(If)59 +3868 y Fs(mark-symlinked-directori)o(es)1110 3978 y Ft(If)59 b(set)h(to)g(`)p Fs(on)p Ft(',)67 b(completed)60 b(names)f(whic)m(h)g -(are)h(sym)m(b)s(olic)g(links)f(to)1110 3508 y(directories)71 +(are)h(sym)m(b)s(olic)g(links)f(to)1110 4088 y(directories)71 b(ha)m(v)m(e)f(a)g(slash)f(app)s(ended)f(\(sub)5 b(ject)70 -b(to)g(the)g(v)-5 b(alue)70 b(of)1110 3618 y Fs(mark-directories)p +b(to)g(the)g(v)-5 b(alue)70 b(of)1110 4197 y Fs(mark-directories)p Ft(\).)37 b(The)30 b(default)g(is)g(`)p Fs(off)p Ft('.)630 -3790 y Fs(match-hidden-files)1110 3900 y Ft(This)21 b(v)-5 -b(ariable,)25 b(when)d(set)g(to)h(`)p Fs(on)p Ft(',)h(causes)f -(Readline)g(to)g(matc)m(h)g(\014les)f(whose)1110 4009 +4385 y Fs(match-hidden-files)1110 4495 y Ft(This)24 b(v)-5 +b(ariable,)26 b(when)e(set)h(to)g(`)p Fs(on)p Ft(',)g(forces)g +(Readline)g(to)g(matc)m(h)h(\014les)e(whose)1110 4604 y(names)44 b(b)s(egin)g(with)g(a)g(`)p Fs(.)p Ft(')g(\(hidden)f -(\014les\))i(when)e(p)s(erforming)g(\014lename)1110 4119 -y(completion.)75 b(If)41 b(set)g(to)h(`)p Fs(off)p Ft(',)i(the)e -(leading)g(`)p Fs(.)p Ft(')f(m)m(ust)g(b)s(e)g(supplied)f(b)m(y)1110 -4228 y(the)34 b(user)g(in)g(the)g(\014lename)g(to)h(b)s(e)f(completed.) -53 b(This)33 b(v)-5 b(ariable)35 b(is)f(`)p Fs(on)p Ft(')g(b)m(y)1110 -4338 y(default.)630 4510 y Fs(menu-complete-display-pr)o(efix)1110 -4620 y Ft(If)f(set)h(to)g(`)p Fs(on)p Ft(',)h(men)m(u)e(completion)i +(\014les\))i(when)e(p)s(erforming)g(\014lename)1110 4714 +y(completion.)f(If)28 b(set)i(to)g(`)p Fs(off)p Ft(',)f(the)g(user)f(m) +m(ust)h(include)g(the)g(leading)h(`)p Fs(.)p Ft(')f(in)1110 +4823 y(the)i(\014lename)f(to)h(b)s(e)f(completed.)42 +b(This)29 b(v)-5 b(ariable)31 b(is)g(`)p Fs(on)p Ft(')f(b)m(y)g +(default.)630 5011 y Fs(menu-complete-display-pr)o(efix)1110 +5121 y Ft(If)j(set)h(to)g(`)p Fs(on)p Ft(',)h(men)m(u)e(completion)i (displa)m(ys)e(the)h(common)g(pre\014x)e(of)i(the)1110 -4729 y(list)k(of)g(p)s(ossible)f(completions)i(\(whic)m(h)e(ma)m(y)h(b) -s(e)f(empt)m(y\))i(b)s(efore)e(cycling)1110 4839 y(through)30 +5230 y(list)k(of)g(p)s(ossible)f(completions)i(\(whic)m(h)e(ma)m(y)h(b) +s(e)f(empt)m(y\))i(b)s(efore)e(cycling)1110 5340 y(through)30 b(the)g(list.)42 b(The)29 b(default)i(is)f(`)p Fs(off)p -Ft('.)630 5011 y Fs(output-meta)1110 5121 y Ft(If)35 -b(set)h(to)g(`)p Fs(on)p Ft(',)h(Readline)f(will)g(displa)m(y)f(c)m -(haracters)i(with)e(the)h(eigh)m(th)g(bit)1110 5230 y(set)h(directly)g -(rather)f(than)g(as)h(a)g(meta-pre\014xed)f(escap)s(e)h(sequence.)59 -b(The)1110 5340 y(default)26 b(is)f(`)p Fs(off)p Ft(',)i(but)e -(Readline)h(will)g(set)g(it)g(to)h(`)p Fs(on)p Ft(')e(if)h(the)f(lo)s -(cale)j(con)m(tains)p eop end +Ft('.)p eop end %%Page: 10 14 TeXDict begin 10 13 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(10)1110 299 y(eigh)m(t-bit)38 -b(c)m(haracters.)61 b(This)36 b(v)-5 b(ariable)37 b(is)g(dep)s(enden)m -(t)e(on)h(the)h Fs(LC_CTYPE)1110 408 y Ft(lo)s(cale)32 -b(category)-8 b(,)33 b(and)d(ma)m(y)h(c)m(hange)g(if)g(the)f(lo)s(cale) -i(is)f(c)m(hanged.)630 581 y Fs(page-completions)1110 -690 y Ft(If)i(set)i(to)f(`)p Fs(on)p Ft(',)h(Readline)g(uses)e(an)h(in) -m(ternal)h Fs(more)p Ft(-lik)m(e)f(pager)g(to)h(displa)m(y)1110 -800 y(a)e(screenful)f(of)g(p)s(ossible)g(completions)i(at)f(a)g(time.) -47 b(This)31 b(v)-5 b(ariable)34 b(is)e(`)p Fs(on)p Ft(')1110 -909 y(b)m(y)e(default.)630 1082 y Fs(print-completions-horizo)o(ntal)o -(ly)1110 1191 y Ft(If)23 b(set)i(to)g(`)p Fs(on)p Ft(',)g(Readline)g -(will)f(displa)m(y)g(completions)h(with)f(matc)m(hes)h(sorted)1110 -1301 y(horizon)m(tally)45 b(in)e(alphab)s(etical)i(order,)i(rather)c -(than)g(do)m(wn)g(the)h(screen.)1110 1410 y(The)30 b(default)g(is)h(`)p -Fs(off)p Ft('.)630 1583 y Fs(revert-all-at-newline)1110 -1692 y Ft(If)e(set)h(to)g(`)p Fs(on)p Ft(',)g(Readline)g(will)g(undo)f -(all)h(c)m(hanges)h(to)f(history)g(lines)f(b)s(efore)1110 -1802 y(returning)f(when)f Fs(accept-line)f Ft(is)j(executed.)41 -b(By)29 b(default,)g(history)g(lines)1110 1911 y(ma)m(y)42 +b(Command)29 b(Line)i(Editing)2107 b(10)630 299 y Fs(output-meta)1110 +408 y Ft(If)35 b(set)h(to)g(`)p Fs(on)p Ft(',)h(Readline)f(will)g +(displa)m(y)f(c)m(haracters)i(with)e(the)h(eigh)m(th)g(bit)1110 +518 y(set)h(directly)g(rather)f(than)g(as)h(a)g(meta-pre\014xed)f +(escap)s(e)h(sequence.)59 b(The)1110 628 y(default)26 +b(is)f(`)p Fs(off)p Ft(',)i(but)e(Readline)h(will)g(set)g(it)g(to)h(`)p +Fs(on)p Ft(')e(if)h(the)f(lo)s(cale)j(con)m(tains)1110 +737 y(eigh)m(t-bit)38 b(c)m(haracters.)61 b(This)36 b(v)-5 +b(ariable)37 b(is)g(dep)s(enden)m(t)e(on)h(the)h Fs(LC_CTYPE)1110 +847 y Ft(lo)s(cale)32 b(category)-8 b(,)33 b(and)d(ma)m(y)h(c)m(hange)g +(if)g(the)f(lo)s(cale)i(is)f(c)m(hanged.)630 998 y Fs(page-completions) +1110 1107 y Ft(If)i(set)i(to)f(`)p Fs(on)p Ft(',)h(Readline)g(uses)e +(an)h(in)m(ternal)h Fs(more)p Ft(-lik)m(e)f(pager)g(to)h(displa)m(y) +1110 1217 y(a)e(screenful)f(of)g(p)s(ossible)g(completions)i(at)f(a)g +(time.)47 b(This)31 b(v)-5 b(ariable)34 b(is)e(`)p Fs(on)p +Ft(')1110 1326 y(b)m(y)e(default.)630 1477 y Fs +(print-completions-horizo)o(ntal)o(ly)1110 1587 y Ft(If)23 +b(set)i(to)g(`)p Fs(on)p Ft(',)g(Readline)g(will)f(displa)m(y)g +(completions)h(with)f(matc)m(hes)h(sorted)1110 1696 y(horizon)m(tally) +45 b(in)e(alphab)s(etical)i(order,)i(rather)c(than)g(do)m(wn)g(the)h +(screen.)1110 1806 y(The)30 b(default)g(is)h(`)p Fs(off)p +Ft('.)630 1956 y Fs(revert-all-at-newline)1110 2066 y +Ft(If)e(set)h(to)g(`)p Fs(on)p Ft(',)g(Readline)g(will)g(undo)f(all)h +(c)m(hanges)h(to)f(history)g(lines)f(b)s(efore)1110 2176 +y(returning)f(when)f Fs(accept-line)f Ft(is)j(executed.)41 +b(By)29 b(default,)g(history)g(lines)1110 2285 y(ma)m(y)42 b(b)s(e)g(mo)s(di\014ed)e(and)h(retain)i(individual)e(undo)g(lists)h -(across)g(calls)h(to)1110 2021 y Fs(readline\(\))p Ft(.)38 -b(The)30 b(default)g(is)h(`)p Fs(off)p Ft('.)630 2193 -y Fs(show-all-if-ambiguous)1110 2303 y Ft(This)e(alters)i(the)f +(across)g(calls)h(to)1110 2395 y Fs(readline\(\))p Ft(.)38 +b(The)30 b(default)g(is)h(`)p Fs(off)p Ft('.)630 2545 +y Fs(search-ignore-case)1110 2655 y Ft(If)j(set)g(to)h(`)p +Fs(on)p Ft(',)h(Readline)e(p)s(erforms)f(incremen)m(tal)i(and)f +(non-incremen)m(tal)1110 2765 y(history)27 b(list)g(searc)m(hes)h(in)f +(a)g(case-insensitiv)m(e)j(fashion.)39 b(The)26 b(default)h(v)-5 +b(alue)1110 2874 y(is)30 b(`)p Fs(off)p Ft('.)630 3025 +y Fs(show-all-if-ambiguous)1110 3134 y Ft(This)f(alters)i(the)f (default)g(b)s(eha)m(vior)g(of)g(the)h(completion)g(functions.)40 -b(If)29 b(set)1110 2412 y(to)f(`)p Fs(on)p Ft(',)g(w)m(ords)f(whic)m(h) +b(If)29 b(set)1110 3244 y(to)f(`)p Fs(on)p Ft(',)g(w)m(ords)f(whic)m(h) g(ha)m(v)m(e)i(more)f(than)f(one)h(p)s(ossible)f(completion)h(cause) -1110 2522 y(the)39 b(matc)m(hes)h(to)g(b)s(e)e(listed)h(immediately)i -(instead)e(of)g(ringing)g(the)g(b)s(ell.)1110 2632 y(The)30 +1110 3354 y(the)39 b(matc)m(hes)h(to)g(b)s(e)e(listed)h(immediately)i +(instead)e(of)g(ringing)g(the)g(b)s(ell.)1110 3463 y(The)30 b(default)g(v)-5 b(alue)31 b(is)g(`)p Fs(off)p Ft('.)630 -2804 y Fs(show-all-if-unmodified)1110 2913 y Ft(This)38 +3614 y Fs(show-all-if-unmodified)1110 3724 y Ft(This)38 b(alters)h(the)g(default)g(b)s(eha)m(vior)g(of)f(the)h(completion)h -(functions)e(in)h(a)1110 3023 y(fashion)25 b(similar)h(to)g +(functions)e(in)h(a)1110 3833 y(fashion)25 b(similar)h(to)g Fj(sho)m(w-all-if-am)m(biguous)p Ft(.)41 b(If)25 b(set)h(to)h(`)p -Fs(on)p Ft(',)f(w)m(ords)f(whic)m(h)1110 3133 y(ha)m(v)m(e)32 +Fs(on)p Ft(',)f(w)m(ords)f(whic)m(h)1110 3943 y(ha)m(v)m(e)32 b(more)f(than)f(one)i(p)s(ossible)e(completion)i(without)f(an)m(y)g(p)s -(ossible)f(par-)1110 3242 y(tial)43 b(completion)h(\(the)f(p)s(ossible) -f(completions)h(don't)f(share)g(a)h(common)1110 3352 +(ossible)f(par-)1110 4052 y(tial)43 b(completion)h(\(the)f(p)s(ossible) +f(completions)h(don't)f(share)g(a)h(common)1110 4162 y(pre\014x\))30 b(cause)g(the)h(matc)m(hes)g(to)g(b)s(e)f(listed)g -(immediately)i(instead)e(of)h(ring-)1110 3461 y(ing)g(the)f(b)s(ell.)41 +(immediately)i(instead)e(of)h(ring-)1110 4271 y(ing)g(the)f(b)s(ell.)41 b(The)30 b(default)g(v)-5 b(alue)31 b(is)f(`)p Fs(off)p -Ft('.)630 3634 y Fs(show-mode-in-prompt)1110 3743 y Ft(If)24 +Ft('.)630 4422 y Fs(show-mode-in-prompt)1110 4532 y Ft(If)24 b(set)h(to)g(`)p Fs(on)p Ft(',)g(add)f(a)h(string)f(to)h(the)f(b)s -(eginning)g(of)g(the)h(prompt)e(indicating)1110 3853 +(eginning)g(of)g(the)h(prompt)e(indicating)1110 4641 y(the)33 b(editing)h(mo)s(de:)46 b(emacs,)35 b(vi)e(command,)h(or)f(vi) -h(insertion.)49 b(The)32 b(mo)s(de)1110 3962 y(strings)45 +h(insertion.)49 b(The)32 b(mo)s(de)1110 4751 y(strings)45 b(are)h(user-settable)g(\(e.g.,)51 b Fj(emacs-mo)s(de-string)8 -b Ft(\).)87 b(The)45 b(default)1110 4072 y(v)-5 b(alue)31 -b(is)f(`)p Fs(off)p Ft('.)630 4244 y Fs(skip-completed-text)1110 -4354 y Ft(If)i(set)i(to)f(`)p Fs(on)p Ft(',)h(this)f(alters)g(the)g +b Ft(\).)87 b(The)45 b(default)1110 4861 y(v)-5 b(alue)31 +b(is)f(`)p Fs(off)p Ft('.)630 5011 y Fs(skip-completed-text)1110 +5121 y Ft(If)i(set)i(to)f(`)p Fs(on)p Ft(',)h(this)f(alters)g(the)g (default)g(completion)h(b)s(eha)m(vior)f(when)f(in-)1110 -4463 y(serting)d(a)h(single)g(matc)m(h)f(in)m(to)h(the)g(line.)40 +5230 y(serting)d(a)h(single)g(matc)m(h)f(in)m(to)h(the)g(line.)40 b(It's)30 b(only)f(activ)m(e)i(when)d(p)s(erform-)1110 -4573 y(ing)k(completion)i(in)e(the)g(middle)g(of)g(a)h(w)m(ord.)46 -b(If)32 b(enabled,)g(Readline)h(do)s(es)1110 4682 y(not)41 +5340 y(ing)k(completion)i(in)e(the)g(middle)g(of)g(a)h(w)m(ord.)46 +b(If)32 b(enabled,)g(Readline)h(do)s(es)p eop end +%%Page: 11 15 +TeXDict begin 11 14 bop 150 -116 a Ft(Chapter)30 b(1:)41 +b(Command)29 b(Line)i(Editing)2107 b(11)1110 299 y(not)41 b(insert)f(c)m(haracters)i(from)e(the)h(completion)h(that)f(matc)m(h)g -(c)m(haracters)1110 4792 y(after)c(p)s(oin)m(t)g(in)g(the)g(w)m(ord)f -(b)s(eing)g(completed,)k(so)d(p)s(ortions)f(of)h(the)g(w)m(ord)1110 -4902 y(follo)m(wing)c(the)f(cursor)f(are)h(not)g(duplicated.)45 +(c)m(haracters)1110 408 y(after)c(p)s(oin)m(t)g(in)g(the)g(w)m(ord)f(b) +s(eing)g(completed,)k(so)d(p)s(ortions)f(of)h(the)g(w)m(ord)1110 +518 y(follo)m(wing)c(the)f(cursor)f(are)h(not)g(duplicated.)45 b(F)-8 b(or)32 b(instance,)h(if)f(this)f(is)h(en-)1110 -5011 y(abled,)43 b(attempting)f(completion)g(when)d(the)i(cursor)f(is)g -(after)h(the)g(`)p Fs(e)p Ft(')f(in)1110 5121 y(`)p Fs(Makefile)p +628 y(abled,)43 b(attempting)f(completion)g(when)d(the)i(cursor)f(is)g +(after)h(the)g(`)p Fs(e)p Ft(')f(in)1110 737 y(`)p Fs(Makefile)p Ft(')c(will)i(result)f(in)g(`)p Fs(Makefile)p Ft(')f(rather)h(than)h(`) -p Fs(Makefilefile)p Ft(',)1110 5230 y(assuming)d(there)g(is)h(a)f +p Fs(Makefilefile)p Ft(',)1110 847 y(assuming)d(there)g(is)h(a)f (single)h(p)s(ossible)f(completion.)56 b(The)35 b(default)g(v)-5 -b(alue)1110 5340 y(is)30 b(`)p Fs(off)p Ft('.)p eop end -%%Page: 11 15 -TeXDict begin 11 14 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(11)630 299 y Fs -(vi-cmd-mode-string)1110 408 y Ft(If)33 b(the)h Fj(sho)m(w-mo)s +b(alue)1110 956 y(is)30 b(`)p Fs(off)p Ft('.)630 1117 +y Fs(vi-cmd-mode-string)1110 1226 y Ft(If)j(the)h Fj(sho)m(w-mo)s (de-in-prompt)h Ft(v)-5 b(ariable)35 b(is)e(enabled,)i(this)f(string)f -(is)h(dis-)1110 518 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the)g -(last)h(line)f(of)h(the)f(primary)f(prompt)g(when)1110 -628 y(vi)32 b(editing)h(mo)s(de)f(is)g(activ)m(e)j(and)c(in)h(command)g -(mo)s(de.)46 b(The)31 b(v)-5 b(alue)33 b(is)f(ex-)1110 -737 y(panded)26 b(lik)m(e)i(a)f(k)m(ey)h(binding,)e(so)i(the)f +(is)h(dis-)1110 1336 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the) +g(last)h(line)f(of)h(the)f(primary)f(prompt)g(when)1110 +1445 y(vi)32 b(editing)h(mo)s(de)f(is)g(activ)m(e)j(and)c(in)h(command) +g(mo)s(de.)46 b(The)31 b(v)-5 b(alue)33 b(is)f(ex-)1110 +1555 y(panded)26 b(lik)m(e)i(a)f(k)m(ey)h(binding,)e(so)i(the)f (standard)f(set)h(of)g(meta-)h(and)e(con)m(trol)1110 -847 y(pre\014xes)34 b(and)g(bac)m(kslash)i(escap)s(e)g(sequences)f(is)g -(a)m(v)-5 b(ailable.)57 b(Use)35 b(the)g(`)p Fs(\\1)p -Ft(')1110 956 y(and)23 b(`)p Fs(\\2)p Ft(')h(escap)s(es)h(to)f(b)s +1665 y(pre\014xes)34 b(and)g(bac)m(kslash)i(escap)s(e)g(sequences)f(is) +g(a)m(v)-5 b(ailable.)57 b(Use)35 b(the)g(`)p Fs(\\1)p +Ft(')1110 1774 y(and)23 b(`)p Fs(\\2)p Ft(')h(escap)s(es)h(to)f(b)s (egin)g(and)f(end)g(sequences)i(of)f(non-prin)m(ting)f(c)m(harac-)1110 -1066 y(ters,)31 b(whic)m(h)g(can)g(b)s(e)f(used)g(to)h(em)m(b)s(ed)f(a) -h(terminal)h(con)m(trol)g(sequence)f(in)m(to)1110 1176 +1884 y(ters,)31 b(whic)m(h)g(can)g(b)s(e)f(used)g(to)h(em)m(b)s(ed)f(a) +h(terminal)h(con)m(trol)g(sequence)f(in)m(to)1110 1993 y(the)g(mo)s(de)f(string.)40 b(The)30 b(default)h(is)f(`)p -Fs(\(cmd\))p Ft('.)630 1340 y Fs(vi-ins-mode-string)1110 -1450 y Ft(If)j(the)h Fj(sho)m(w-mo)s(de-in-prompt)h Ft(v)-5 +Fs(\(cmd\))p Ft('.)630 2153 y Fs(vi-ins-mode-string)1110 +2263 y Ft(If)j(the)h Fj(sho)m(w-mo)s(de-in-prompt)h Ft(v)-5 b(ariable)35 b(is)e(enabled,)i(this)f(string)f(is)h(dis-)1110 -1559 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the)g(last)h(line)f -(of)h(the)f(primary)f(prompt)g(when)1110 1669 y(vi)35 +2373 y(pla)m(y)m(ed)24 b(immediately)g(b)s(efore)f(the)g(last)h(line)f +(of)h(the)f(primary)f(prompt)g(when)1110 2482 y(vi)35 b(editing)h(mo)s(de)e(is)i(activ)m(e)h(and)d(in)h(insertion)g(mo)s(de.) -54 b(The)35 b(v)-5 b(alue)35 b(is)g(ex-)1110 1778 y(panded)26 +54 b(The)35 b(v)-5 b(alue)35 b(is)g(ex-)1110 2592 y(panded)26 b(lik)m(e)i(a)f(k)m(ey)h(binding,)e(so)i(the)f(standard)f(set)h(of)g -(meta-)h(and)e(con)m(trol)1110 1888 y(pre\014xes)34 b(and)g(bac)m +(meta-)h(and)e(con)m(trol)1110 2701 y(pre\014xes)34 b(and)g(bac)m (kslash)i(escap)s(e)g(sequences)f(is)g(a)m(v)-5 b(ailable.)57 -b(Use)35 b(the)g(`)p Fs(\\1)p Ft(')1110 1998 y(and)23 +b(Use)35 b(the)g(`)p Fs(\\1)p Ft(')1110 2811 y(and)23 b(`)p Fs(\\2)p Ft(')h(escap)s(es)h(to)f(b)s(egin)g(and)f(end)g -(sequences)i(of)f(non-prin)m(ting)f(c)m(harac-)1110 2107 +(sequences)i(of)f(non-prin)m(ting)f(c)m(harac-)1110 2921 y(ters,)31 b(whic)m(h)g(can)g(b)s(e)f(used)g(to)h(em)m(b)s(ed)f(a)h -(terminal)h(con)m(trol)g(sequence)f(in)m(to)1110 2217 +(terminal)h(con)m(trol)g(sequence)f(in)m(to)1110 3030 y(the)g(mo)s(de)f(string.)40 b(The)30 b(default)h(is)f(`)p -Fs(\(ins\))p Ft('.)630 2381 y Fs(visible-stats)1110 2491 +Fs(\(ins\))p Ft('.)630 3190 y Fs(visible-stats)1110 3300 y Ft(If)h(set)i(to)f(`)p Fs(on)p Ft(',)h(a)f(c)m(haracter)i(denoting)e (a)g(\014le's)g(t)m(yp)s(e)g(is)g(app)s(ended)e(to)j(the)1110 -2600 y(\014lename)e(when)e(listing)i(p)s(ossible)f(completions.)42 -b(The)30 b(default)g(is)h(`)p Fs(off)p Ft('.)150 2765 -y(Key)f(Bindings)630 2874 y(The)41 b(syn)m(tax)i(for)f(con)m(trolling)h +3410 y(\014lename)e(when)e(listing)i(p)s(ossible)f(completions.)42 +b(The)30 b(default)g(is)h(`)p Fs(off)p Ft('.)150 3570 +y(Key)f(Bindings)630 3679 y(The)41 b(syn)m(tax)i(for)f(con)m(trolling)h (k)m(ey)g(bindings)e(in)h(the)g(init)g(\014le)g(is)g(simple.)75 -b(First)43 b(y)m(ou)630 2984 y(need)27 b(to)i(\014nd)d(the)i(name)f(of) +b(First)43 b(y)m(ou)630 3789 y(need)27 b(to)i(\014nd)d(the)i(name)f(of) h(the)g(command)f(that)i(y)m(ou)f(w)m(an)m(t)g(to)g(c)m(hange.)41 -b(The)27 b(follo)m(wing)630 3093 y(sections)37 b(con)m(tain)g(tables)g +b(The)27 b(follo)m(wing)630 3898 y(sections)37 b(con)m(tain)g(tables)g (of)f(the)g(command)f(name,)j(the)e(default)g(k)m(eybinding,)h(if)f(an) -m(y)-8 b(,)630 3203 y(and)30 b(a)h(short)f(description)g(of)h(what)f -(the)g(command)h(do)s(es.)630 3340 y(Once)36 b(y)m(ou)g(kno)m(w)g(the)g +m(y)-8 b(,)630 4008 y(and)30 b(a)h(short)f(description)g(of)h(what)f +(the)g(command)h(do)s(es.)630 4143 y(Once)36 b(y)m(ou)g(kno)m(w)g(the)g (name)g(of)g(the)g(command,)h(simply)f(place)h(on)e(a)i(line)f(in)g -(the)g(init)630 3450 y(\014le)e(the)g(name)f(of)h(the)g(k)m(ey)g(y)m +(the)g(init)630 4253 y(\014le)e(the)g(name)f(of)h(the)g(k)m(ey)g(y)m (ou)g(wish)f(to)h(bind)f(the)h(command)f(to,)i(a)f(colon,)i(and)d(then) -630 3559 y(the)f(name)h(of)f(the)g(command.)46 b(There)32 +630 4362 y(the)f(name)h(of)f(the)g(command.)46 b(There)32 b(can)g(b)s(e)g(no)g(space)g(b)s(et)m(w)m(een)h(the)f(k)m(ey)h(name)g -(and)630 3669 y(the)41 b(colon)h({)f(that)g(will)g(b)s(e)g(in)m +(and)630 4472 y(the)41 b(colon)h({)f(that)g(will)g(b)s(e)g(in)m (terpreted)g(as)g(part)f(of)h(the)g(k)m(ey)h(name.)72 -b(The)40 b(name)h(of)630 3778 y(the)35 b(k)m(ey)g(can)g(b)s(e)f +b(The)40 b(name)h(of)630 4581 y(the)35 b(k)m(ey)g(can)g(b)s(e)f (expressed)f(in)i(di\013eren)m(t)g(w)m(a)m(ys,)h(dep)s(ending)d(on)h -(what)h(y)m(ou)g(\014nd)e(most)630 3888 y(comfortable.)630 -4025 y(In)g(addition)h(to)g(command)g(names,)g(Readline)g(allo)m(ws)h +(what)h(y)m(ou)g(\014nd)e(most)630 4691 y(comfortable.)630 +4826 y(In)g(addition)h(to)g(command)g(names,)g(Readline)g(allo)m(ws)h (k)m(eys)g(to)f(b)s(e)f(b)s(ound)f(to)i(a)g(string)630 -4134 y(that)d(is)f(inserted)h(when)e(the)i(k)m(ey)g(is)f(pressed)g(\(a) -h Fj(macro)5 b Ft(\).)630 4299 y Fj(k)m(eyname)g Ft(:)42 -b Fj(function-name)35 b Ft(or)c Fj(macro)1110 4408 y(k)m(eyname)k +4935 y(that)d(is)f(inserted)h(when)e(the)i(k)m(ey)g(is)f(pressed)g(\(a) +h Fj(macro)5 b Ft(\).)630 5096 y Fj(k)m(eyname)g Ft(:)42 +b Fj(function-name)35 b Ft(or)c Fj(macro)1110 5205 y(k)m(eyname)k Ft(is)29 b(the)f(name)h(of)g(a)g(k)m(ey)h(sp)s(elled)e(out)h(in)g -(English.)39 b(F)-8 b(or)30 b(example:)1350 4545 y Fs(Control-u:)45 -b(universal-argument)1350 4655 y(Meta-Rubout:)f(backward-kill-word)1350 -4765 y(Control-o:)h(">)i(output")1110 4902 y Ft(In)94 -b(the)g(example)h(ab)s(o)m(v)m(e,)112 b Fl(C-u)94 b Ft(is)g(b)s(ound)f -(to)i(the)f(function)1110 5011 y Fs(universal-argument)p -Ft(,)124 b Fl(M-DEL)107 b Ft(is)i(b)s(ound)e(to)j(the)f(function)1110 -5121 y Fs(backward-kill-word)p Ft(,)75 b(and)69 b Fl(C-o)g -Ft(is)h(b)s(ound)e(to)j(run)d(the)i(macro)1110 5230 y(expressed)45 -b(on)h(the)g(righ)m(t)g(hand)e(side)i(\(that)h(is,)i(to)e(insert)e(the) -h(text)h(`)p Fs(>)1110 5340 y(output)p Ft(')29 b(in)m(to)i(the)g -(line\).)p eop end +(English.)39 b(F)-8 b(or)30 b(example:)1350 5340 y Fs(Control-u:)45 +b(universal-argument)p eop end %%Page: 12 16 TeXDict begin 12 15 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(12)1110 299 y(A)62 -b(n)m(um)m(b)s(er)e(of)i(sym)m(b)s(olic)h(c)m(haracter)g(names)f(are)g -(recognized)h(while)1110 408 y(pro)s(cessing)40 b(this)f(k)m(ey)i -(binding)e(syn)m(tax:)60 b Fj(DEL)p Ft(,)42 b Fj(ESC)p -Ft(,)g Fj(ESCAPE)p Ft(,)f Fj(LFD)p Ft(,)1110 518 y Fj(NEWLINE)p -Ft(,)31 b Fj(RET)p Ft(,)f Fj(RETURN)p Ft(,)g Fj(R)m(UBOUT)p -Ft(,)h Fj(SP)-8 b(A)m(CE)p Ft(,)31 b Fj(SPC)p Ft(,)e(and)h -Fj(T)-8 b(AB)p Ft(.)630 677 y Fs(")p Fj(k)m(eyseq)r Fs(")p -Ft(:)41 b Fj(function-name)36 b Ft(or)30 b Fj(macro)1110 -787 y(k)m(eyseq)k Ft(di\013ers)d(from)f Fj(k)m(eyname)37 -b Ft(ab)s(o)m(v)m(e)32 b(in)f(that)h(strings)f(denoting)g(an)g(en-)1110 -896 y(tire)j(k)m(ey)h(sequence)f(can)g(b)s(e)f(sp)s(eci\014ed,)h(b)m(y) -f(placing)i(the)f(k)m(ey)g(sequence)g(in)1110 1006 y(double)29 -b(quotes.)41 b(Some)29 b Fm(gnu)h Ft(Emacs)f(st)m(yle)i(k)m(ey)f(escap) -s(es)g(can)g(b)s(e)f(used,)g(as)1110 1115 y(in)k(the)h(follo)m(wing)i -(example,)f(but)e(the)h(sp)s(ecial)h(c)m(haracter)g(names)f(are)g(not) -1110 1225 y(recognized.)1350 1359 y Fs("\\C-u":)46 b -(universal-argument)1350 1469 y("\\C-x\\C-r":)f(re-read-init-file)1350 -1578 y("\\e[11~":)g("Function)h(Key)g(1")1110 1713 y -Ft(In)64 b(the)g(ab)s(o)m(v)m(e)i(example,)74 b Fl(C-u)64 -b Ft(is)g(again)i(b)s(ound)c(to)k(the)e(function)1110 -1822 y Fs(universal-argument)39 b Ft(\(just)k(as)h(it)g(w)m(as)g(in)g -(the)f(\014rst)g(example\),)49 b(`)p Fl(C-x)1110 1932 +b(Command)29 b(Line)i(Editing)2107 b(12)1350 299 y Fs(Meta-Rubout:)44 +b(backward-kill-word)1350 408 y(Control-o:)h(">)i(output")1110 +544 y Ft(In)94 b(the)g(example)h(ab)s(o)m(v)m(e,)112 +b Fl(C-u)94 b Ft(is)g(b)s(ound)f(to)i(the)f(function)1110 +653 y Fs(universal-argument)p Ft(,)124 b Fl(M-DEL)107 +b Ft(is)i(b)s(ound)e(to)j(the)f(function)1110 763 y Fs +(backward-kill-word)p Ft(,)75 b(and)69 b Fl(C-o)g Ft(is)h(b)s(ound)e +(to)j(run)d(the)i(macro)1110 873 y(expressed)45 b(on)h(the)g(righ)m(t)g +(hand)e(side)i(\(that)h(is,)i(to)e(insert)e(the)h(text)h(`)p +Fs(>)1110 982 y(output)p Ft(')29 b(in)m(to)i(the)g(line\).)1110 +1118 y(A)62 b(n)m(um)m(b)s(er)e(of)i(sym)m(b)s(olic)h(c)m(haracter)g +(names)f(are)g(recognized)h(while)1110 1227 y(pro)s(cessing)40 +b(this)f(k)m(ey)i(binding)e(syn)m(tax:)60 b Fj(DEL)p +Ft(,)42 b Fj(ESC)p Ft(,)g Fj(ESCAPE)p Ft(,)f Fj(LFD)p +Ft(,)1110 1337 y Fj(NEWLINE)p Ft(,)31 b Fj(RET)p Ft(,)f +Fj(RETURN)p Ft(,)g Fj(R)m(UBOUT)p Ft(,)h Fj(SP)-8 b(A)m(CE)p +Ft(,)31 b Fj(SPC)p Ft(,)e(and)h Fj(T)-8 b(AB)p Ft(.)630 +1498 y Fs(")p Fj(k)m(eyseq)r Fs(")p Ft(:)41 b Fj(function-name)36 +b Ft(or)30 b Fj(macro)1110 1608 y(k)m(eyseq)k Ft(di\013ers)d(from)f +Fj(k)m(eyname)37 b Ft(ab)s(o)m(v)m(e)32 b(in)f(that)h(strings)f +(denoting)g(an)g(en-)1110 1717 y(tire)j(k)m(ey)h(sequence)f(can)g(b)s +(e)f(sp)s(eci\014ed,)h(b)m(y)f(placing)i(the)f(k)m(ey)g(sequence)g(in) +1110 1827 y(double)29 b(quotes.)41 b(Some)29 b Fm(gnu)h +Ft(Emacs)f(st)m(yle)i(k)m(ey)f(escap)s(es)g(can)g(b)s(e)f(used,)g(as) +1110 1936 y(in)k(the)h(follo)m(wing)i(example,)f(but)e(the)h(sp)s +(ecial)h(c)m(haracter)g(names)f(are)g(not)1110 2046 y(recognized.)1350 +2181 y Fs("\\C-u":)46 b(universal-argument)1350 2291 +y("\\C-x\\C-r":)f(re-read-init-file)1350 2400 y("\\e[11~":)g("Function) +h(Key)g(1")1110 2536 y Ft(In)64 b(the)g(ab)s(o)m(v)m(e)i(example,)74 +b Fl(C-u)64 b Ft(is)g(again)i(b)s(ound)c(to)k(the)e(function)1110 +2645 y Fs(universal-argument)39 b Ft(\(just)k(as)h(it)g(w)m(as)g(in)g +(the)f(\014rst)g(example\),)49 b(`)p Fl(C-x)1110 2755 y(C-r)p Ft(')30 b(is)g(b)s(ound)e(to)j(the)g(function)f Fs(re-read-init-file)p Ft(,)c(and)j(`)p Fs(ESC)h([)g(1)g(1)1110 -2041 y(~)p Ft(')g(is)h(b)s(ound)d(to)j(insert)f(the)h(text)g(`)p -Fs(Function)e(Key)g(1)p Ft('.)630 2200 y(The)g(follo)m(wing)i +2865 y(~)p Ft(')g(is)h(b)s(ound)d(to)j(insert)f(the)h(text)g(`)p +Fs(Function)e(Key)g(1)p Ft('.)630 3026 y(The)g(follo)m(wing)i Fm(gnu)f Ft(Emacs)g(st)m(yle)h(escap)s(e)f(sequences)g(are)g(a)m(v)-5 -b(ailable)32 b(when)d(sp)s(ecifying)630 2310 y(k)m(ey)i(sequences:)630 -2469 y Fl(\\C-)336 b Ft(con)m(trol)32 b(pre\014x)630 -2628 y Fl(\\M-)336 b Ft(meta)31 b(pre\014x)630 2787 y +b(ailable)32 b(when)d(sp)s(ecifying)630 3135 y(k)m(ey)i(sequences:)630 +3296 y Fl(\\C-)336 b Ft(con)m(trol)32 b(pre\014x)630 +3458 y Fl(\\M-)336 b Ft(meta)31 b(pre\014x)630 3619 y Fl(\\e)384 b Ft(an)30 b(escap)s(e)h(c)m(haracter)630 -2945 y Fl(\\\\)384 b Ft(bac)m(kslash)630 3104 y Fl(\\)p +3780 y Fl(\\\\)384 b Ft(bac)m(kslash)630 3941 y Fl(\\)p Fs(")g(")p Ft(,)30 b(a)h(double)f(quotation)i(mark)630 -3263 y Fl(\\')384 b Fs(')p Ft(,)30 b(a)h(single)g(quote)g(or)f(ap)s -(ostrophe)630 3422 y(In)d(addition)h(to)g(the)g Fm(gnu)f +4102 y Fl(\\')384 b Fs(')p Ft(,)30 b(a)h(single)g(quote)g(or)f(ap)s +(ostrophe)630 4263 y(In)d(addition)h(to)g(the)g Fm(gnu)f Ft(Emacs)h(st)m(yle)h(escap)s(e)f(sequences,)h(a)f(second)f(set)h(of)g -(bac)m(kslash)630 3532 y(escap)s(es)j(is)f(a)m(v)-5 b(ailable:)630 -3691 y Fs(\\a)384 b Ft(alert)31 b(\(b)s(ell\))630 3850 -y Fs(\\b)384 b Ft(bac)m(kspace)630 4008 y Fs(\\d)g Ft(delete)630 -4167 y Fs(\\f)g Ft(form)30 b(feed)630 4326 y Fs(\\n)384 -b Ft(newline)630 4485 y Fs(\\r)g Ft(carriage)32 b(return)630 -4644 y Fs(\\t)384 b Ft(horizon)m(tal)32 b(tab)630 4803 -y Fs(\\v)384 b Ft(v)m(ertical)32 b(tab)630 4962 y Fs(\\)p -Fl(nnn)288 b Ft(the)35 b(eigh)m(t-bit)h(c)m(haracter)g(whose)e(v)-5 -b(alue)35 b(is)g(the)f(o)s(ctal)i(v)-5 b(alue)35 b Fj(nnn)e -Ft(\(one)i(to)1110 5071 y(three)c(digits\))630 5230 y -Fs(\\x)p Fl(HH)288 b Ft(the)38 b(eigh)m(t-bit)i(c)m(haracter)g(whose)e -(v)-5 b(alue)39 b(is)f(the)h(hexadecimal)g(v)-5 b(alue)39 -b Fj(HH)1110 5340 y Ft(\(one)31 b(or)f(t)m(w)m(o)i(hex)e(digits\))p +(bac)m(kslash)630 4373 y(escap)s(es)j(is)f(a)m(v)-5 b(ailable:)630 +4534 y Fs(\\a)384 b Ft(alert)31 b(\(b)s(ell\))630 4695 +y Fs(\\b)384 b Ft(bac)m(kspace)630 4856 y Fs(\\d)g Ft(delete)630 +5018 y Fs(\\f)g Ft(form)30 b(feed)630 5179 y Fs(\\n)384 +b Ft(newline)630 5340 y Fs(\\r)g Ft(carriage)32 b(return)p eop end %%Page: 13 17 TeXDict begin 13 16 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(13)630 299 y(When)37 -b(en)m(tering)h(the)g(text)g(of)g(a)g(macro,)i(single)e(or)f(double)g -(quotes)h(m)m(ust)f(b)s(e)g(used)f(to)630 408 y(indicate)23 -b(a)e(macro)h(de\014nition.)38 b(Unquoted)21 b(text)i(is)e(assumed)g -(to)h(b)s(e)f(a)h(function)f(name.)38 b(In)630 518 y(the)22 -b(macro)f(b)s(o)s(dy)-8 b(,)23 b(the)e(bac)m(kslash)h(escap)s(es)g -(describ)s(ed)e(ab)s(o)m(v)m(e)j(are)e(expanded.)37 b(Bac)m(kslash)630 -628 y(will)j(quote)h(an)m(y)f(other)g(c)m(haracter)i(in)d(the)i(macro)f -(text,)k(including)39 b(`)p Fs(")p Ft(')h(and)g(`)p Fs(')p -Ft('.)69 b(F)-8 b(or)630 737 y(example,)28 b(the)e(follo)m(wing)h -(binding)d(will)i(mak)m(e)h(`)p Fl(C-x)j Fs(\\)p Ft(')c(insert)f(a)h -(single)h(`)p Fs(\\)p Ft(')f(in)m(to)g(the)g(line:)870 -873 y Fs("\\C-x\\\\":)45 b("\\\\")150 1073 y Fi(1.3.2)63 -b(Conditional)41 b(Init)g(Constructs)150 1220 y Ft(Readline)c(implemen) -m(ts)g(a)h(facilit)m(y)g(similar)f(in)g(spirit)f(to)i(the)f -(conditional)h(compilation)g(features)f(of)150 1330 y(the)31 -b(C)f(prepro)s(cessor)g(whic)m(h)g(allo)m(ws)i(k)m(ey)g(bindings)d(and) -h(v)-5 b(ariable)32 b(settings)f(to)h(b)s(e)e(p)s(erformed)f(as)i(the) -150 1440 y(result)f(of)h(tests.)41 b(There)30 b(are)h(four)f(parser)f -(directiv)m(es)j(used.)150 1601 y Fs($if)336 b Ft(The)31 -b Fs($if)f Ft(construct)i(allo)m(ws)h(bindings)d(to)i(b)s(e)e(made)i -(based)f(on)g(the)g(editing)h(mo)s(de,)g(the)630 1711 -y(terminal)37 b(b)s(eing)f(used,)h(or)f(the)h(application)g(using)f -(Readline.)59 b(The)36 b(text)h(of)f(the)h(test,)630 -1821 y(after)30 b(an)m(y)g(comparison)g(op)s(erator,)g(extends)f(to)h -(the)g(end)f(of)h(the)f(line;)i(unless)e(otherwise)630 -1930 y(noted,)i(no)f(c)m(haracters)i(are)f(required)e(to)i(isolate)i -(it.)630 2091 y Fs(mode)288 b Ft(The)30 b Fs(mode=)e +b(Command)29 b(Line)i(Editing)2107 b(13)630 299 y Fs(\\t)384 +b Ft(horizon)m(tal)32 b(tab)630 456 y Fs(\\v)384 b Ft(v)m(ertical)32 +b(tab)630 612 y Fs(\\)p Fl(nnn)288 b Ft(the)35 b(eigh)m(t-bit)h(c)m +(haracter)g(whose)e(v)-5 b(alue)35 b(is)g(the)f(o)s(ctal)i(v)-5 +b(alue)35 b Fj(nnn)e Ft(\(one)i(to)1110 722 y(three)c(digits\))630 +878 y Fs(\\x)p Fl(HH)288 b Ft(the)38 b(eigh)m(t-bit)i(c)m(haracter)g +(whose)e(v)-5 b(alue)39 b(is)f(the)h(hexadecimal)g(v)-5 +b(alue)39 b Fj(HH)1110 988 y Ft(\(one)31 b(or)f(t)m(w)m(o)i(hex)e +(digits\))630 1145 y(When)37 b(en)m(tering)h(the)g(text)g(of)g(a)g +(macro,)i(single)e(or)f(double)g(quotes)h(m)m(ust)f(b)s(e)g(used)f(to) +630 1254 y(indicate)23 b(a)e(macro)h(de\014nition.)38 +b(Unquoted)21 b(text)i(is)e(assumed)g(to)h(b)s(e)f(a)h(function)f +(name.)38 b(In)630 1364 y(the)22 b(macro)f(b)s(o)s(dy)-8 +b(,)23 b(the)e(bac)m(kslash)h(escap)s(es)g(describ)s(ed)e(ab)s(o)m(v)m +(e)j(are)e(expanded.)37 b(Bac)m(kslash)630 1473 y(will)j(quote)h(an)m +(y)f(other)g(c)m(haracter)i(in)d(the)i(macro)f(text,)k(including)39 +b(`)p Fs(")p Ft(')h(and)g(`)p Fs(')p Ft('.)69 b(F)-8 +b(or)630 1583 y(example,)28 b(the)e(follo)m(wing)h(binding)d(will)i +(mak)m(e)h(`)p Fl(C-x)j Fs(\\)p Ft(')c(insert)f(a)h(single)h(`)p +Fs(\\)p Ft(')f(in)m(to)g(the)g(line:)870 1716 y Fs("\\C-x\\\\":)45 +b("\\\\")150 1913 y Fi(1.3.2)63 b(Conditional)41 b(Init)g(Constructs) +150 2060 y Ft(Readline)c(implemen)m(ts)g(a)h(facilit)m(y)g(similar)f +(in)g(spirit)f(to)i(the)f(conditional)h(compilation)g(features)f(of)150 +2169 y(the)31 b(C)f(prepro)s(cessor)g(whic)m(h)g(allo)m(ws)i(k)m(ey)g +(bindings)d(and)h(v)-5 b(ariable)32 b(settings)f(to)h(b)s(e)e(p)s +(erformed)f(as)i(the)150 2279 y(result)f(of)h(tests.)41 +b(There)30 b(are)h(four)f(parser)f(directiv)m(es)j(used.)150 +2435 y Fs($if)336 b Ft(The)31 b Fs($if)f Ft(construct)i(allo)m(ws)h +(bindings)d(to)i(b)s(e)e(made)i(based)f(on)g(the)g(editing)h(mo)s(de,)g +(the)630 2545 y(terminal)37 b(b)s(eing)f(used,)h(or)f(the)h +(application)g(using)f(Readline.)59 b(The)36 b(text)h(of)f(the)h(test,) +630 2655 y(after)30 b(an)m(y)g(comparison)g(op)s(erator,)g(extends)f +(to)h(the)g(end)f(of)h(the)f(line;)i(unless)e(otherwise)630 +2764 y(noted,)i(no)f(c)m(haracters)i(are)f(required)e(to)i(isolate)i +(it.)630 2921 y Fs(mode)288 b Ft(The)30 b Fs(mode=)e Ft(form)i(of)g(the)h Fs($if)e Ft(directiv)m(e)j(is)e(used)f(to)i(test)g -(whether)e(Read-)1110 2201 y(line)44 b(is)f(in)g Fs(emacs)f +(whether)e(Read-)1110 3031 y(line)44 b(is)f(in)g Fs(emacs)f Ft(or)h Fs(vi)g Ft(mo)s(de.)79 b(This)42 b(ma)m(y)i(b)s(e)e(used)h(in)g -(conjunction)1110 2311 y(with)c(the)h(`)p Fs(set)29 b(keymap)p +(conjunction)1110 3140 y(with)c(the)h(`)p Fs(set)29 b(keymap)p Ft(')38 b(command,)k(for)d(instance,)j(to)e(set)g(bindings)e(in)1110 -2420 y(the)32 b Fs(emacs-standard)c Ft(and)j Fs(emacs-ctlx)d -Ft(k)m(eymaps)k(only)g(if)g(Readline)g(is)1110 2530 y(starting)f(out)g -(in)f Fs(emacs)f Ft(mo)s(de.)630 2691 y Fs(term)288 b +3250 y(the)32 b Fs(emacs-standard)c Ft(and)j Fs(emacs-ctlx)d +Ft(k)m(eymaps)k(only)g(if)g(Readline)g(is)1110 3359 y(starting)f(out)g +(in)f Fs(emacs)f Ft(mo)s(de.)630 3516 y Fs(term)288 b Ft(The)26 b Fs(term=)g Ft(form)g(ma)m(y)i(b)s(e)e(used)g(to)i(include)f -(terminal-sp)s(eci\014c)g(k)m(ey)h(bind-)1110 2800 y(ings,)38 +(terminal-sp)s(eci\014c)g(k)m(ey)h(bind-)1110 3626 y(ings,)38 b(p)s(erhaps)c(to)j(bind)e(the)h(k)m(ey)h(sequences)f(output)g(b)m(y)g -(the)g(terminal's)1110 2910 y(function)24 b(k)m(eys.)39 +(the)g(terminal's)1110 3735 y(function)24 b(k)m(eys.)39 b(The)23 b(w)m(ord)h(on)f(the)i(righ)m(t)f(side)g(of)g(the)g(`)p -Fs(=)p Ft(')g(is)g(tested)h(against)1110 3020 y(b)s(oth)k(the)h(full)g +Fs(=)p Ft(')g(is)g(tested)h(against)1110 3845 y(b)s(oth)k(the)h(full)g (name)g(of)g(the)g(terminal)h(and)e(the)i(p)s(ortion)e(of)h(the)g -(terminal)1110 3129 y(name)k(b)s(efore)f(the)g(\014rst)g(`)p +(terminal)1110 3954 y(name)k(b)s(efore)f(the)g(\014rst)g(`)p Fs(-)p Ft('.)50 b(This)33 b(allo)m(ws)i Fs(sun)e Ft(to)h(matc)m(h)g(b)s -(oth)f Fs(sun)g Ft(and)1110 3239 y Fs(sun-cmd)p Ft(,)c(for)h(instance.) -630 3400 y Fs(version)144 b Ft(The)44 b Fs(version)f +(oth)f Fs(sun)g Ft(and)1110 4064 y Fs(sun-cmd)p Ft(,)c(for)h(instance.) +630 4221 y Fs(version)144 b Ft(The)44 b Fs(version)f Ft(test)i(ma)m(y)h(b)s(e)e(used)f(to)j(p)s(erform)d(comparisons)i -(against)1110 3509 y(sp)s(eci\014c)c(Readline)i(v)m(ersions.)74 +(against)1110 4330 y(sp)s(eci\014c)c(Readline)i(v)m(ersions.)74 b(The)42 b Fs(version)d Ft(expands)i(to)h(the)g(curren)m(t)1110 -3619 y(Readline)25 b(v)m(ersion.)39 b(The)23 b(set)h(of)g(comparison)h +4440 y(Readline)25 b(v)m(ersion.)39 b(The)23 b(set)h(of)g(comparison)h (op)s(erators)f(includes)f(`)p Fs(=)p Ft(')h(\(and)1110 -3729 y(`)p Fs(==)p Ft('\),)33 b(`)p Fs(!=)p Ft(',)f(`)p +4549 y(`)p Fs(==)p Ft('\),)33 b(`)p Fs(!=)p Ft(',)f(`)p Fs(<=)p Ft(',)h(`)p Fs(>=)p Ft(',)f(`)p Fs(<)p Ft(',)h(and)e(`)p Fs(>)p Ft('.)46 b(The)31 b(v)m(ersion)i(n)m(um)m(b)s(er)d(supplied)h -(on)1110 3838 y(the)j(righ)m(t)h(side)f(of)g(the)g(op)s(erator)g +(on)1110 4659 y(the)j(righ)m(t)h(side)f(of)g(the)g(op)s(erator)g (consists)h(of)f(a)g(ma)5 b(jor)35 b(v)m(ersion)f(n)m(um)m(b)s(er,)1110 -3948 y(an)45 b(optional)i(decimal)f(p)s(oin)m(t,)k(and)44 -b(an)i(optional)g(minor)f(v)m(ersion)h(\(e.g.,)1110 4057 +4768 y(an)45 b(optional)i(decimal)f(p)s(oin)m(t,)k(and)44 +b(an)i(optional)g(minor)f(v)m(ersion)h(\(e.g.,)1110 4878 y(`)p Fs(7.1)p Ft('\).)40 b(If)27 b(the)h(minor)f(v)m(ersion)h(is)g (omitted,)h(it)f(is)g(assumed)f(to)h(b)s(e)f(`)p Fs(0)p -Ft('.)40 b(The)1110 4167 y(op)s(erator)34 b(ma)m(y)g(b)s(e)f(separated) +Ft('.)40 b(The)1110 4988 y(op)s(erator)34 b(ma)m(y)g(b)s(e)f(separated) g(from)g(the)h(string)f Fs(version)f Ft(and)h(from)g(the)1110 -4276 y(v)m(ersion)39 b(n)m(um)m(b)s(er)f(argumen)m(t)h(b)m(y)f +5097 y(v)m(ersion)39 b(n)m(um)m(b)s(er)f(argumen)m(t)h(b)m(y)f (whitespace.)67 b(The)38 b(follo)m(wing)i(example)1110 -4386 y(sets)31 b(a)g(v)-5 b(ariable)31 b(if)f(the)h(Readline)g(v)m +5207 y(sets)31 b(a)g(v)-5 b(ariable)31 b(if)f(the)h(Readline)g(v)m (ersion)f(b)s(eing)g(used)g(is)g(7.0)i(or)e(new)m(er:)1350 -4521 y Fs($if)47 b(version)f(>=)h(7.0)1350 4631 y(set)g -(show-mode-in-prompt)42 b(on)1350 4741 y($endif)630 4902 -y(application)1110 5011 y Ft(The)21 b Fj(application)j +5340 y Fs($if)47 b(version)f(>=)h(7.0)p eop end +%%Page: 14 18 +TeXDict begin 14 17 bop 150 -116 a Ft(Chapter)30 b(1:)41 +b(Command)29 b(Line)i(Editing)2107 b(14)1350 299 y Fs(set)47 +b(show-mode-in-prompt)42 b(on)1350 408 y($endif)630 568 +y(application)1110 677 y Ft(The)21 b Fj(application)j Ft(construct)e(is)g(used)f(to)i(include)f(application-sp)s(eci\014c)h -(set-)1110 5121 y(tings.)39 b(Eac)m(h)26 b(program)e(using)g(the)h +(set-)1110 787 y(tings.)39 b(Eac)m(h)26 b(program)e(using)g(the)h (Readline)g(library)g(sets)g(the)g Fj(application)1110 -5230 y(name)p Ft(,)g(and)e(y)m(ou)g(can)h(test)g(for)f(a)g(particular)h +897 y(name)p Ft(,)g(and)e(y)m(ou)g(can)h(test)g(for)f(a)g(particular)h (v)-5 b(alue.)39 b(This)22 b(could)h(b)s(e)g(used)f(to)1110 -5340 y(bind)32 b(k)m(ey)h(sequences)g(to)h(functions)e(useful)g(for)h -(a)g(sp)s(eci\014c)f(program.)48 b(F)-8 b(or)p eop end -%%Page: 14 18 -TeXDict begin 14 17 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(14)1110 299 y(instance,)35 -b(the)e(follo)m(wing)h(command)f(adds)f(a)i(k)m(ey)f(sequence)h(that)f -(quotes)1110 408 y(the)e(curren)m(t)f(or)g(previous)g(w)m(ord)g(in)g -(Bash:)1350 543 y Fs($if)47 b(Bash)1350 653 y(#)g(Quote)g(the)g -(current)f(or)h(previous)e(word)1350 762 y("\\C-xq":)h -("\\eb\\"\\ef\\"")1350 872 y($endif)630 1031 y(variable)96 -b Ft(The)33 b Fj(v)-5 b(ariable)39 b Ft(construct)33 -b(pro)m(vides)g(simple)g(equalit)m(y)i(tests)e(for)g(Readline)1110 -1141 y(v)-5 b(ariables)32 b(and)f(v)-5 b(alues.)45 b(The)32 -b(p)s(ermitted)f(comparison)h(op)s(erators)f(are)i(`)p -Fs(=)p Ft(',)1110 1250 y(`)p Fs(==)p Ft(',)49 b(and)44 +1006 y(bind)32 b(k)m(ey)h(sequences)g(to)h(functions)e(useful)g(for)h +(a)g(sp)s(eci\014c)f(program.)48 b(F)-8 b(or)1110 1116 +y(instance,)35 b(the)e(follo)m(wing)h(command)f(adds)f(a)i(k)m(ey)f +(sequence)h(that)f(quotes)1110 1225 y(the)e(curren)m(t)f(or)g(previous) +g(w)m(ord)g(in)g(Bash:)1350 1360 y Fs($if)47 b(Bash)1350 +1469 y(#)g(Quote)g(the)g(current)f(or)h(previous)e(word)1350 +1579 y("\\C-xq":)h("\\eb\\"\\ef\\"")1350 1689 y($endif)630 +1848 y(variable)96 b Ft(The)33 b Fj(v)-5 b(ariable)39 +b Ft(construct)33 b(pro)m(vides)g(simple)g(equalit)m(y)i(tests)e(for)g +(Readline)1110 1958 y(v)-5 b(ariables)32 b(and)f(v)-5 +b(alues.)45 b(The)32 b(p)s(ermitted)f(comparison)h(op)s(erators)f(are)i +(`)p Fs(=)p Ft(',)1110 2067 y(`)p Fs(==)p Ft(',)49 b(and)44 b(`)p Fs(!=)p Ft('.)85 b(The)44 b(v)-5 b(ariable)46 b(name)f(m)m(ust)g -(b)s(e)g(separated)g(from)g(the)1110 1360 y(comparison)25 +(b)s(e)g(separated)g(from)g(the)1110 2177 y(comparison)25 b(op)s(erator)g(b)m(y)g(whitespace;)j(the)d(op)s(erator)g(ma)m(y)g(b)s -(e)f(separated)1110 1469 y(from)33 b(the)h(v)-5 b(alue)35 +(e)f(separated)1110 2286 y(from)33 b(the)h(v)-5 b(alue)35 b(on)f(the)g(righ)m(t)g(hand)f(side)h(b)m(y)f(whitespace.)52 -b(Both)35 b(string)1110 1579 y(and)i(b)s(o)s(olean)g(v)-5 +b(Both)35 b(string)1110 2396 y(and)i(b)s(o)s(olean)g(v)-5 b(ariables)38 b(ma)m(y)h(b)s(e)d(tested.)63 b(Bo)s(olean)39 -b(v)-5 b(ariables)38 b(m)m(ust)g(b)s(e)1110 1689 y(tested)46 +b(v)-5 b(ariables)38 b(m)m(ust)g(b)s(e)1110 2506 y(tested)46 b(against)g(the)f(v)-5 b(alues)46 b Fj(on)f Ft(and)f Fj(o\013)p Ft(.)85 b(The)45 b(follo)m(wing)h(example)g(is)1110 -1798 y(equiv)-5 b(alen)m(t)32 b(to)f(the)f Fs(mode=emacs)e -Ft(test)j(describ)s(ed)f(ab)s(o)m(v)m(e:)1350 1933 y -Fs($if)47 b(editing-mode)d(==)k(emacs)1350 2042 y(set)f -(show-mode-in-prompt)42 b(on)1350 2152 y($endif)150 2311 +2615 y(equiv)-5 b(alen)m(t)32 b(to)f(the)f Fs(mode=emacs)e +Ft(test)j(describ)s(ed)f(ab)s(o)m(v)m(e:)1350 2750 y +Fs($if)47 b(editing-mode)d(==)k(emacs)1350 2859 y(set)f +(show-mode-in-prompt)42 b(on)1350 2969 y($endif)150 3128 y($endif)192 b Ft(This)29 b(command,)i(as)f(seen)h(in)f(the)g(previous) g(example,)h(terminates)g(an)g Fs($if)e Ft(command.)150 -2471 y Fs($else)240 b Ft(Commands)29 b(in)h(this)h(branc)m(h)e(of)i +3288 y Fs($else)240 b Ft(Commands)29 b(in)h(this)h(branc)m(h)e(of)i (the)f Fs($if)g Ft(directiv)m(e)i(are)f(executed)g(if)f(the)h(test)g -(fails.)150 2630 y Fs($include)96 b Ft(This)43 b(directiv)m(e)i(tak)m +(fails.)150 3447 y Fs($include)96 b Ft(This)43 b(directiv)m(e)i(tak)m (es)g(a)e(single)i(\014lename)e(as)h(an)f(argumen)m(t)h(and)f(reads)g -(commands)630 2740 y(and)38 b(bindings)f(from)h(that)i(\014le.)65 +(commands)630 3557 y(and)38 b(bindings)f(from)h(that)i(\014le.)65 b(F)-8 b(or)39 b(example,)j(the)d(follo)m(wing)h(directiv)m(e)g(reads)e -(from)630 2849 y Fs(/etc/inputrc)p Ft(:)870 2984 y Fs($include)46 -b(/etc/inputrc)150 3183 y Fi(1.3.3)63 b(Sample)41 b(Init)g(File)150 -3330 y Ft(Here)27 b(is)f(an)h(example)g(of)f(an)h Fj(inputrc)k +(from)630 3666 y Fs(/etc/inputrc)p Ft(:)870 3801 y Fs($include)46 +b(/etc/inputrc)150 4000 y Fi(1.3.3)63 b(Sample)41 b(Init)g(File)150 +4147 y Ft(Here)27 b(is)f(an)h(example)g(of)f(an)h Fj(inputrc)k Ft(\014le.)39 b(This)26 b(illustrates)h(k)m(ey)h(binding,)e(v)-5 -b(ariable)27 b(assignmen)m(t,)i(and)150 3440 y(conditional)j(syn)m +b(ariable)27 b(assignmen)m(t,)i(and)150 4257 y(conditional)j(syn)m (tax.)p eop end %%Page: 15 19 TeXDict begin 15 18 bop 150 -116 a Ft(Chapter)30 b(1:)41 @@ -8208,304 +8219,305 @@ b(Command)29 b(Line)i(Editing)2107 b(21)150 299 y Fs(capitalize-word)26 b(\(M-c\))630 408 y Ft(Capitalize)d(the)f(curren)m(t)f(\(or)g(follo)m (wing\))i(w)m(ord.)38 b(With)21 b(a)h(negativ)m(e)h(argumen)m(t,)h (capitalize)630 518 y(the)31 b(previous)e(w)m(ord,)i(but)e(do)i(not)f -(mo)m(v)m(e)i(the)f(cursor.)150 678 y Fs(overwrite-mode)26 -b(\(\))630 788 y Ft(T)-8 b(oggle)35 b(o)m(v)m(erwrite)g(mo)s(de.)48 +(mo)m(v)m(e)i(the)f(cursor.)150 683 y Fs(overwrite-mode)26 +b(\(\))630 792 y Ft(T)-8 b(oggle)35 b(o)m(v)m(erwrite)g(mo)s(de.)48 b(With)33 b(an)g(explicit)h(p)s(ositiv)m(e)g(n)m(umeric)f(argumen)m(t,) -h(switc)m(hes)630 897 y(to)22 b(o)m(v)m(erwrite)i(mo)s(de.)37 +h(switc)m(hes)630 902 y(to)22 b(o)m(v)m(erwrite)i(mo)s(de.)37 b(With)22 b(an)g(explicit)h(non-p)s(ositiv)m(e)f(n)m(umeric)g(argumen)m -(t,)i(switc)m(hes)e(to)630 1007 y(insert)30 b(mo)s(de.)41 +(t,)i(switc)m(hes)e(to)630 1012 y(insert)30 b(mo)s(de.)41 b(This)30 b(command)h(a\013ects)h(only)e Fs(emacs)f Ft(mo)s(de;)i -Fs(vi)f Ft(mo)s(de)g(do)s(es)g(o)m(v)m(erwrite)630 1116 +Fs(vi)f Ft(mo)s(de)g(do)s(es)g(o)m(v)m(erwrite)630 1121 y(di\013eren)m(tly)-8 b(.)42 b(Eac)m(h)31 b(call)h(to)f Fs(readline\(\))c Ft(starts)k(in)f(insert)g(mo)s(de.)630 -1251 y(In)52 b(o)m(v)m(erwrite)h(mo)s(de,)58 b(c)m(haracters)c(b)s +1258 y(In)52 b(o)m(v)m(erwrite)h(mo)s(de,)58 b(c)m(haracters)c(b)s (ound)c(to)j Fs(self-insert)c Ft(replace)k(the)g(text)g(at)630 -1361 y(p)s(oin)m(t)59 b(rather)f(than)h(pushing)e(the)i(text)g(to)h +1368 y(p)s(oin)m(t)59 b(rather)f(than)h(pushing)e(the)i(text)g(to)h (the)f(righ)m(t.)126 b(Characters)59 b(b)s(ound)d(to)630 -1470 y Fs(backward-delete-char)25 b Ft(replace)31 b(the)g(c)m(haracter) -h(b)s(efore)e(p)s(oin)m(t)g(with)g(a)h(space.)630 1605 +1478 y Fs(backward-delete-char)25 b Ft(replace)31 b(the)g(c)m(haracter) +h(b)s(efore)e(p)s(oin)m(t)g(with)g(a)h(space.)630 1615 y(By)g(default,)f(this)h(command)f(is)g(un)m(b)s(ound.)150 -1805 y Fi(1.4.4)63 b(Killing)42 b(And)e(Y)-10 b(anking)150 -1977 y Fs(kill-line)28 b(\(C-k\))630 2087 y Ft(Kill)k(the)f(text)i +1819 y Fi(1.4.4)63 b(Killing)42 b(And)e(Y)-10 b(anking)150 +1994 y Fs(kill-line)28 b(\(C-k\))630 2104 y Ft(Kill)k(the)f(text)i (from)d(p)s(oin)m(t)i(to)g(the)f(end)g(of)g(the)h(line.)44 b(With)31 b(a)h(negativ)m(e)i(n)m(umeric)d(argu-)630 -2197 y(men)m(t,)g(kill)g(bac)m(kw)m(ard)g(from)f(the)g(cursor)g(to)h +2213 y(men)m(t,)g(kill)g(bac)m(kw)m(ard)g(from)f(the)g(cursor)g(to)h (the)g(b)s(eginning)e(of)i(the)g(curren)m(t)f(line.)150 -2357 y Fs(backward-kill-line)25 b(\(C-x)30 b(Rubout\))630 -2466 y Ft(Kill)40 b(bac)m(kw)m(ard)h(from)e(the)h(cursor)g(to)g(the)g +2378 y Fs(backward-kill-line)25 b(\(C-x)30 b(Rubout\))630 +2487 y Ft(Kill)40 b(bac)m(kw)m(ard)h(from)e(the)h(cursor)g(to)g(the)g (b)s(eginning)g(of)g(the)g(curren)m(t)f(line.)70 b(With)41 -b(a)630 2576 y(negativ)m(e)47 b(n)m(umeric)e(argumen)m(t,)50 +b(a)630 2597 y(negativ)m(e)47 b(n)m(umeric)e(argumen)m(t,)50 b(kill)c(forw)m(ard)e(from)h(the)g(cursor)g(to)h(the)f(end)f(of)i(the) -630 2685 y(curren)m(t)30 b(line.)150 2845 y Fs(unix-line-discard)c -(\(C-u\))630 2955 y Ft(Kill)31 b(bac)m(kw)m(ard)g(from)e(the)i(cursor)f +630 2707 y(curren)m(t)30 b(line.)150 2871 y Fs(unix-line-discard)c +(\(C-u\))630 2981 y Ft(Kill)31 b(bac)m(kw)m(ard)g(from)e(the)i(cursor)f (to)h(the)f(b)s(eginning)g(of)h(the)f(curren)m(t)g(line.)150 -3115 y Fs(kill-whole-line)c(\(\))630 3225 y Ft(Kill)37 +3146 y Fs(kill-whole-line)c(\(\))630 3255 y Ft(Kill)37 b(all)g(c)m(haracters)h(on)f(the)f(curren)m(t)h(line,)h(no)f(matter)g (where)f(p)s(oin)m(t)h(is.)59 b(By)36 b(default,)630 -3334 y(this)30 b(is)h(un)m(b)s(ound.)150 3494 y Fs(kill-word)d(\(M-d\)) -630 3604 y Ft(Kill)i(from)f(p)s(oin)m(t)g(to)h(the)g(end)e(of)i(the)f +3365 y(this)30 b(is)h(un)m(b)s(ound.)150 3530 y Fs(kill-word)d(\(M-d\)) +630 3639 y Ft(Kill)i(from)f(p)s(oin)m(t)g(to)h(the)g(end)e(of)i(the)f (curren)m(t)h(w)m(ord,)f(or)g(if)h(b)s(et)m(w)m(een)g(w)m(ords,)f(to)h -(the)g(end)630 3713 y(of)h(the)f(next)h(w)m(ord.)40 b(W)-8 +(the)g(end)630 3749 y(of)h(the)f(next)h(w)m(ord.)40 b(W)-8 b(ord)31 b(b)s(oundaries)e(are)h(the)h(same)g(as)f Fs(forward-word)p -Ft(.)150 3874 y Fs(backward-kill-word)25 b(\(M-DEL\))630 -3983 y Ft(Kill)k(the)g(w)m(ord)g(b)s(ehind)e(p)s(oin)m(t.)40 +Ft(.)150 3914 y Fs(backward-kill-word)25 b(\(M-DEL\))630 +4023 y Ft(Kill)k(the)g(w)m(ord)g(b)s(ehind)e(p)s(oin)m(t.)40 b(W)-8 b(ord)29 b(b)s(oundaries)f(are)h(the)g(same)g(as)g -Fs(backward-word)p Ft(.)150 4143 y Fs(shell-transpose-words)c -(\(M-C-t\))630 4253 y Ft(Drag)33 b(the)g(w)m(ord)f(b)s(efore)g(p)s(oin) -m(t)g(past)g(the)h(w)m(ord)f(after)g(p)s(oin)m(t,)i(mo)m(ving)f(p)s -(oin)m(t)f(past)g(that)630 4362 y(w)m(ord)c(as)h(w)m(ell.)41 -b(If)27 b(the)i(insertion)f(p)s(oin)m(t)h(is)f(at)h(the)g(end)e(of)i -(the)f(line,)i(this)e(transp)s(oses)g(the)630 4472 y(last)j(t)m(w)m(o)h -(w)m(ords)d(on)i(the)f(line.)41 b(W)-8 b(ord)31 b(b)s(oundaries)e(are)h -(the)h(same)f(as)h Fs(shell-forward-)630 4582 y(word)e -Ft(and)h Fs(shell-backward-word)p Ft(.)150 4742 y Fs(unix-word-rubout)c -(\(C-w\))630 4851 y Ft(Kill)32 b(the)g(w)m(ord)f(b)s(ehind)f(p)s(oin)m -(t,)i(using)f(white)h(space)g(as)g(a)g(w)m(ord)f(b)s(oundary)-8 -b(.)43 b(The)31 b(killed)630 4961 y(text)g(is)g(sa)m(v)m(ed)g(on)g(the) -f(kill-ring.)150 5121 y Fs(unix-filename-rubout)25 b(\(\))630 -5230 y Ft(Kill)37 b(the)f(w)m(ord)g(b)s(ehind)f(p)s(oin)m(t,)j(using)e +Fs(backward-word)p Ft(.)150 4188 y Fs(unix-word-rubout)d(\(C-w\))630 +4298 y Ft(Kill)32 b(the)g(w)m(ord)f(b)s(ehind)f(p)s(oin)m(t,)i(using)f +(white)h(space)g(as)g(a)g(w)m(ord)f(b)s(oundary)-8 b(.)43 +b(The)31 b(killed)630 4407 y(text)g(is)g(sa)m(v)m(ed)g(on)g(the)f +(kill-ring.)150 4572 y Fs(unix-filename-rubout)25 b(\(\))630 +4682 y Ft(Kill)37 b(the)f(w)m(ord)g(b)s(ehind)f(p)s(oin)m(t,)j(using)e (white)g(space)h(and)f(the)g(slash)g(c)m(haracter)i(as)f(the)630 -5340 y(w)m(ord)30 b(b)s(oundaries.)39 b(The)30 b(killed)h(text)g(is)g -(sa)m(v)m(ed)g(on)g(the)f(kill-ring.)p eop end +4791 y(w)m(ord)30 b(b)s(oundaries.)39 b(The)30 b(killed)h(text)g(is)g +(sa)m(v)m(ed)g(on)g(the)f(kill-ring.)150 4956 y Fs +(delete-horizontal-space)24 b(\(\))630 5066 y Ft(Delete)33 +b(all)e(spaces)g(and)e(tabs)i(around)e(p)s(oin)m(t.)41 +b(By)31 b(default,)f(this)h(is)f(un)m(b)s(ound.)150 5230 +y Fs(kill-region)d(\(\))630 5340 y Ft(Kill)k(the)f(text)i(in)e(the)g +(curren)m(t)h(region.)41 b(By)31 b(default,)f(this)h(command)f(is)g(un) +m(b)s(ound.)p eop end %%Page: 22 26 TeXDict begin 22 25 bop 150 -116 a Ft(Chapter)30 b(1:)41 b(Command)29 b(Line)i(Editing)2107 b(22)150 299 y Fs -(delete-horizontal-space)24 b(\(\))630 408 y Ft(Delete)33 -b(all)e(spaces)g(and)e(tabs)i(around)e(p)s(oin)m(t.)41 -b(By)31 b(default,)f(this)h(is)f(un)m(b)s(ound.)150 564 -y Fs(kill-region)d(\(\))630 673 y Ft(Kill)k(the)f(text)i(in)e(the)g -(curren)m(t)h(region.)41 b(By)31 b(default,)f(this)h(command)f(is)g(un) -m(b)s(ound.)150 829 y Fs(copy-region-as-kill)25 b(\(\))630 -938 y Ft(Cop)m(y)34 b(the)g(text)h(in)f(the)g(region)g(to)h(the)f(kill) -h(bu\013er,)f(so)g(it)h(can)f(b)s(e)f(y)m(ank)m(ed)i(righ)m(t)f(a)m(w)m -(a)m(y)-8 b(.)630 1048 y(By)31 b(default,)f(this)h(command)f(is)g(un)m -(b)s(ound.)150 1203 y Fs(copy-backward-word)25 b(\(\))630 -1313 y Ft(Cop)m(y)38 b(the)h(w)m(ord)f(b)s(efore)g(p)s(oin)m(t)g(to)i -(the)e(kill)h(bu\013er.)64 b(The)38 b(w)m(ord)g(b)s(oundaries)f(are)i -(the)630 1422 y(same)31 b(as)f Fs(backward-word)p Ft(.)38 -b(By)30 b(default,)h(this)f(command)g(is)h(un)m(b)s(ound.)150 -1578 y Fs(copy-forward-word)26 b(\(\))630 1687 y Ft(Cop)m(y)31 +(copy-region-as-kill)25 b(\(\))630 408 y Ft(Cop)m(y)34 +b(the)g(text)h(in)f(the)g(region)g(to)h(the)f(kill)h(bu\013er,)f(so)g +(it)h(can)f(b)s(e)f(y)m(ank)m(ed)i(righ)m(t)f(a)m(w)m(a)m(y)-8 +b(.)630 518 y(By)31 b(default,)f(this)h(command)f(is)g(un)m(b)s(ound.) +150 689 y Fs(copy-backward-word)25 b(\(\))630 799 y Ft(Cop)m(y)38 +b(the)h(w)m(ord)f(b)s(efore)g(p)s(oin)m(t)g(to)i(the)e(kill)h +(bu\013er.)64 b(The)38 b(w)m(ord)g(b)s(oundaries)f(are)i(the)630 +908 y(same)31 b(as)f Fs(backward-word)p Ft(.)38 b(By)30 +b(default,)h(this)f(command)g(is)h(un)m(b)s(ound.)150 +1079 y Fs(copy-forward-word)26 b(\(\))630 1189 y Ft(Cop)m(y)31 b(the)g(w)m(ord)g(follo)m(wing)h(p)s(oin)m(t)f(to)h(the)f(kill)h (bu\013er.)42 b(The)30 b(w)m(ord)h(b)s(oundaries)e(are)j(the)630 -1797 y(same)f(as)f Fs(forward-word)p Ft(.)38 b(By)30 +1298 y(same)f(as)f Fs(forward-word)p Ft(.)38 b(By)30 b(default,)h(this)g(command)f(is)g(un)m(b)s(ound.)150 -1952 y Fs(yank)f(\(C-y\))630 2062 y Ft(Y)-8 b(ank)31 +1469 y Fs(yank)f(\(C-y\))630 1579 y Ft(Y)-8 b(ank)31 b(the)f(top)h(of)g(the)f(kill)h(ring)f(in)m(to)i(the)e(bu\013er)g(at)h -(p)s(oin)m(t.)150 2217 y Fs(yank-pop)d(\(M-y\))630 2327 +(p)s(oin)m(t.)150 1749 y Fs(yank-pop)d(\(M-y\))630 1859 y Ft(Rotate)36 b(the)f(kill-ring,)i(and)d(y)m(ank)h(the)f(new)g(top.)54 b(Y)-8 b(ou)35 b(can)g(only)f(do)h(this)f(if)h(the)g(prior)630 -2436 y(command)30 b(is)h Fs(yank)e Ft(or)h Fs(yank-pop)p -Ft(.)150 2631 y Fi(1.4.5)63 b(Sp)s(ecifying)42 b(Numeric)f(Argumen)m -(ts)150 2801 y Fs(digit-argument)26 b(\()p Fl(M-0)p Fs(,)j -Fl(M-1)p Fs(,)h(...)f Fl(M--)p Fs(\))630 2911 y Ft(Add)d(this)h(digit)g +1969 y(command)30 b(is)h Fs(yank)e Ft(or)h Fs(yank-pop)p +Ft(.)150 2179 y Fi(1.4.5)63 b(Sp)s(ecifying)42 b(Numeric)f(Argumen)m +(ts)150 2357 y Fs(digit-argument)26 b(\()p Fl(M-0)p Fs(,)j +Fl(M-1)p Fs(,)h(...)f Fl(M--)p Fs(\))630 2467 y Ft(Add)d(this)h(digit)g (to)h(the)f(argumen)m(t)g(already)h(accum)m(ulating,)h(or)e(start)h(a)f -(new)f(argumen)m(t.)630 3020 y Fl(M--)j Ft(starts)i(a)g(negativ)m(e)i -(argumen)m(t.)150 3176 y Fs(universal-argument)25 b(\(\))630 -3285 y Ft(This)g(is)g(another)h(w)m(a)m(y)g(to)h(sp)s(ecify)e(an)g +(new)f(argumen)m(t.)630 2576 y Fl(M--)j Ft(starts)i(a)g(negativ)m(e)i +(argumen)m(t.)150 2747 y Fs(universal-argument)25 b(\(\))630 +2857 y Ft(This)g(is)g(another)h(w)m(a)m(y)g(to)h(sp)s(ecify)e(an)g (argumen)m(t.)40 b(If)25 b(this)g(command)h(is)f(follo)m(w)m(ed)i(b)m -(y)f(one)630 3395 y(or)k(more)f(digits,)i(optionally)g(with)e(a)h +(y)f(one)630 2966 y(or)k(more)f(digits,)i(optionally)g(with)e(a)h (leading)h(min)m(us)e(sign,)h(those)g(digits)g(de\014ne)f(the)h(ar-)630 -3505 y(gumen)m(t.)41 b(If)28 b(the)i(command)f(is)g(follo)m(w)m(ed)h(b) +3076 y(gumen)m(t.)41 b(If)28 b(the)i(command)f(is)g(follo)m(w)m(ed)h(b) m(y)f(digits,)i(executing)f Fs(universal-argument)630 -3614 y Ft(again)j(ends)e(the)h(n)m(umeric)f(argumen)m(t,)i(but)e(is)h +3185 y Ft(again)j(ends)e(the)h(n)m(umeric)f(argumen)m(t,)i(but)e(is)h (otherwise)g(ignored.)45 b(As)32 b(a)g(sp)s(ecial)h(case,)630 -3724 y(if)g(this)g(command)f(is)h(immediately)h(follo)m(w)m(ed)h(b)m(y) +3295 y(if)g(this)g(command)f(is)h(immediately)h(follo)m(w)m(ed)h(b)m(y) d(a)h(c)m(haracter)i(that)e(is)g(neither)g(a)g(digit)630 -3833 y(nor)41 b(min)m(us)f(sign,)k(the)e(argumen)m(t)f(coun)m(t)h(for)f +3404 y(nor)41 b(min)m(us)f(sign,)k(the)e(argumen)m(t)f(coun)m(t)h(for)f (the)h(next)f(command)g(is)g(m)m(ultiplied)h(b)m(y)630 -3943 y(four.)54 b(The)35 b(argumen)m(t)g(coun)m(t)h(is)f(initially)h +3514 y(four.)54 b(The)35 b(argumen)m(t)g(coun)m(t)h(is)f(initially)h (one,)h(so)e(executing)i(this)e(function)f(the)i(\014rst)630 -4053 y(time)29 b(mak)m(es)h(the)e(argumen)m(t)i(coun)m(t)f(four,)f(a)h +3624 y(time)29 b(mak)m(es)h(the)e(argumen)m(t)i(coun)m(t)f(four,)f(a)h (second)g(time)g(mak)m(es)h(the)e(argumen)m(t)h(coun)m(t)630 -4162 y(sixteen,)i(and)f(so)h(on.)40 b(By)31 b(default,)g(this)f(is)g -(not)h(b)s(ound)d(to)k(a)e(k)m(ey)-8 b(.)150 4357 y Fi(1.4.6)63 +3733 y(sixteen,)i(and)f(so)h(on.)40 b(By)31 b(default,)g(this)f(is)g +(not)h(b)s(ound)d(to)k(a)e(k)m(ey)-8 b(.)150 3944 y Fi(1.4.6)63 b(Letting)40 b(Readline)h(T)m(yp)s(e)g(F)-10 b(or)42 -b(Y)-10 b(ou)150 4527 y Fs(complete)28 b(\(TAB\))630 -4637 y Ft(A)m(ttempt)c(to)f(p)s(erform)e(completion)j(on)f(the)g(text)g +b(Y)-10 b(ou)150 4122 y Fs(complete)28 b(\(TAB\))630 +4231 y Ft(A)m(ttempt)c(to)f(p)s(erform)e(completion)j(on)f(the)g(text)g (b)s(efore)f(p)s(oin)m(t.)39 b(The)22 b(actual)i(completion)630 -4746 y(p)s(erformed)29 b(is)h(application-sp)s(eci\014c.)42 +4341 y(p)s(erformed)29 b(is)h(application-sp)s(eci\014c.)42 b(The)30 b(default)h(is)f(\014lename)h(completion.)150 -4902 y Fs(possible-completions)25 b(\(M-?\))630 5011 +4512 y Fs(possible-completions)25 b(\(M-?\))630 4621 y Ft(List)35 b(the)g(p)s(ossible)f(completions)i(of)e(the)h(text)h(b)s (efore)e(p)s(oin)m(t.)54 b(When)34 b(displa)m(ying)h(com-)630 -5121 y(pletions,)f(Readline)f(sets)f(the)h(n)m(um)m(b)s(er)e(of)i +4731 y(pletions,)f(Readline)f(sets)f(the)h(n)m(um)m(b)s(er)e(of)i (columns)f(used)f(for)i(displa)m(y)f(to)h(the)g(v)-5 -b(alue)33 b(of)630 5230 y Fs(completion-display-width)o +b(alue)33 b(of)630 4840 y Fs(completion-display-width)o Ft(,)g(the)j(v)-5 b(alue)37 b(of)g(the)f(en)m(vironmen)m(t)h(v)-5 -b(ariable)38 b Fs(COLUMNS)p Ft(,)630 5340 y(or)30 b(the)h(screen)f -(width,)g(in)g(that)h(order.)p eop end +b(ariable)38 b Fs(COLUMNS)p Ft(,)630 4950 y(or)30 b(the)h(screen)f +(width,)g(in)g(that)h(order.)150 5121 y Fs(insert-completions)25 +b(\(M-*\))630 5230 y Ft(Insert)30 b(all)h(completions)h(of)f(the)g +(text)g(b)s(efore)f(p)s(oin)m(t)h(that)g(w)m(ould)f(ha)m(v)m(e)i(b)s +(een)e(generated)630 5340 y(b)m(y)g Fs(possible-completions)p +Ft(.)p eop end %%Page: 23 27 TeXDict begin 23 26 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(23)150 299 y Fs -(insert-completions)25 b(\(M-*\))630 408 y Ft(Insert)30 -b(all)h(completions)h(of)f(the)g(text)g(b)s(efore)f(p)s(oin)m(t)h(that) -g(w)m(ould)f(ha)m(v)m(e)i(b)s(een)e(generated)630 518 -y(b)m(y)g Fs(possible-completions)p Ft(.)150 673 y Fs(menu-complete)d -(\(\))630 783 y Ft(Similar)d(to)g Fs(complete)p Ft(,)f(but)h(replaces)g -(the)g(w)m(ord)g(to)g(b)s(e)f(completed)i(with)e(a)i(single)f(matc)m(h) -630 893 y(from)37 b(the)h(list)h(of)f(p)s(ossible)f(completions.)64 +b(Command)29 b(Line)i(Editing)2107 b(23)150 299 y Fs(menu-complete)27 +b(\(\))630 408 y Ft(Similar)d(to)g Fs(complete)p Ft(,)f(but)h(replaces) +g(the)g(w)m(ord)g(to)g(b)s(e)f(completed)i(with)e(a)i(single)f(matc)m +(h)630 518 y(from)37 b(the)h(list)h(of)f(p)s(ossible)f(completions.)64 b(Rep)s(eated)39 b(execution)g(of)f Fs(menu-complete)630 -1002 y Ft(steps)i(through)g(the)g(list)h(of)f(p)s(ossible)g +628 y Ft(steps)i(through)g(the)g(list)h(of)f(p)s(ossible)g (completions,)k(inserting)c(eac)m(h)i(matc)m(h)f(in)f(turn.)630 -1112 y(A)m(t)e(the)f(end)f(of)h(the)g(list)g(of)g(completions,)i(the)e +737 y(A)m(t)e(the)f(end)f(of)h(the)g(list)g(of)g(completions,)i(the)e (b)s(ell)g(is)g(rung)f(\(sub)5 b(ject)36 b(to)i(the)f(setting)630 -1221 y(of)f Fs(bell-style)p Ft(\))e(and)h(the)h(original)i(text)f(is)f +847 y(of)f Fs(bell-style)p Ft(\))e(and)h(the)h(original)i(text)f(is)f (restored.)57 b(An)36 b(argumen)m(t)h(of)f Fj(n)f Ft(mo)m(v)m(es)i -Fj(n)630 1331 y Ft(p)s(ositions)e(forw)m(ard)f(in)g(the)h(list)h(of)e +Fj(n)630 956 y Ft(p)s(ositions)e(forw)m(ard)f(in)g(the)h(list)h(of)e (matc)m(hes;)39 b(a)c(negativ)m(e)i(argumen)m(t)e(ma)m(y)g(b)s(e)f -(used)g(to)630 1441 y(mo)m(v)m(e)40 b(bac)m(kw)m(ard)e(through)g(the)g +(used)g(to)630 1066 y(mo)m(v)m(e)40 b(bac)m(kw)m(ard)e(through)g(the)g (list.)65 b(This)38 b(command)g(is)g(in)m(tended)g(to)h(b)s(e)f(b)s -(ound)e(to)630 1550 y Fs(TAB)p Ft(,)30 b(but)f(is)i(un)m(b)s(ound)d(b)m -(y)i(default.)150 1705 y Fs(menu-complete-backward)24 -b(\(\))630 1815 y Ft(Iden)m(tical)36 b(to)g Fs(menu-complete)p +(ound)e(to)630 1176 y Fs(TAB)p Ft(,)30 b(but)f(is)i(un)m(b)s(ound)d(b)m +(y)i(default.)150 1331 y Fs(menu-complete-backward)24 +b(\(\))630 1441 y Ft(Iden)m(tical)36 b(to)g Fs(menu-complete)p Ft(,)d(but)h(mo)m(v)m(es)j(bac)m(kw)m(ard)e(through)f(the)i(list)f(of)g -(p)s(ossible)630 1925 y(completions,)d(as)e(if)h Fs(menu-complete)26 +(p)s(ossible)630 1550 y(completions,)d(as)e(if)h Fs(menu-complete)26 b Ft(had)k(b)s(een)g(giv)m(en)h(a)g(negativ)m(e)i(argumen)m(t.)150 -2080 y Fs(delete-char-or-list)25 b(\(\))630 2190 y Ft(Deletes)41 +1705 y Fs(delete-char-or-list)25 b(\(\))630 1815 y Ft(Deletes)41 b(the)e(c)m(haracter)h(under)e(the)h(cursor)f(if)h(not)g(at)g(the)h(b)s -(eginning)e(or)h(end)f(of)h(the)630 2299 y(line)50 b(\(lik)m(e)h +(eginning)e(or)h(end)f(of)h(the)630 1925 y(line)50 b(\(lik)m(e)h Fs(delete-char)p Ft(\).)96 b(If)49 b(at)h(the)g(end)f(of)h(the)f(line,) -55 b(b)s(eha)m(v)m(es)c(iden)m(tically)g(to)630 2409 +55 b(b)s(eha)m(v)m(es)c(iden)m(tically)g(to)630 2034 y Fs(possible-completions)p Ft(.)35 b(This)30 b(command)g(is)g(un)m(b)s -(ound)e(b)m(y)i(default.)150 2604 y Fi(1.4.7)63 b(Keyb)s(oard)41 -b(Macros)150 2774 y Fs(start-kbd-macro)26 b(\(C-x)j(\(\))630 -2883 y Ft(Begin)i(sa)m(ving)h(the)e(c)m(haracters)i(t)m(yp)s(ed)e(in)m +(ound)e(b)m(y)i(default.)150 2229 y Fi(1.4.7)63 b(Keyb)s(oard)41 +b(Macros)150 2399 y Fs(start-kbd-macro)26 b(\(C-x)j(\(\))630 +2509 y Ft(Begin)i(sa)m(ving)h(the)e(c)m(haracters)i(t)m(yp)s(ed)e(in)m (to)h(the)g(curren)m(t)f(k)m(eyb)s(oard)g(macro.)150 -3039 y Fs(end-kbd-macro)d(\(C-x)i(\)\))630 3148 y Ft(Stop)e(sa)m(ving)h +2664 y Fs(end-kbd-macro)d(\(C-x)i(\)\))630 2774 y Ft(Stop)e(sa)m(ving)h (the)g(c)m(haracters)g(t)m(yp)s(ed)f(in)m(to)i(the)e(curren)m(t)g(k)m -(eyb)s(oard)g(macro)h(and)f(sa)m(v)m(e)i(the)630 3258 -y(de\014nition.)150 3413 y Fs(call-last-kbd-macro)c(\(C-x)k(e\))630 -3523 y Ft(Re-execute)37 b(the)e(last)h(k)m(eyb)s(oard)f(macro)h +(eyb)s(oard)g(macro)h(and)f(sa)m(v)m(e)i(the)630 2883 +y(de\014nition.)150 3039 y Fs(call-last-kbd-macro)c(\(C-x)k(e\))630 +3148 y Ft(Re-execute)37 b(the)e(last)h(k)m(eyb)s(oard)f(macro)h (de\014ned,)f(b)m(y)h(making)f(the)g(c)m(haracters)i(in)e(the)630 -3632 y(macro)c(app)s(ear)f(as)g(if)h(t)m(yp)s(ed)f(at)h(the)f(k)m(eyb)s -(oard.)150 3788 y Fs(print-last-kbd-macro)25 b(\(\))630 -3897 y Ft(Prin)m(t)30 b(the)g(last)h(k)m(eyb)s(oard)f(macro)h +3258 y(macro)c(app)s(ear)f(as)g(if)h(t)m(yp)s(ed)f(at)h(the)f(k)m(eyb)s +(oard.)150 3413 y Fs(print-last-kbd-macro)25 b(\(\))630 +3523 y Ft(Prin)m(t)30 b(the)g(last)h(k)m(eyb)s(oard)f(macro)h (de\014ned)e(in)h(a)g(format)h(suitable)g(for)f(the)g -Fj(inputrc)35 b Ft(\014le.)150 4092 y Fi(1.4.8)63 b(Some)41 -b(Miscellaneous)i(Commands)150 4262 y Fs(re-read-init-file)26 -b(\(C-x)j(C-r\))630 4372 y Ft(Read)22 b(in)g(the)g(con)m(ten)m(ts)h(of) +Fj(inputrc)35 b Ft(\014le.)150 3718 y Fi(1.4.8)63 b(Some)41 +b(Miscellaneous)i(Commands)150 3888 y Fs(re-read-init-file)26 +b(\(C-x)j(C-r\))630 3997 y Ft(Read)22 b(in)g(the)g(con)m(ten)m(ts)h(of) f(the)g Fj(inputrc)27 b Ft(\014le,)d(and)d(incorp)s(orate)h(an)m(y)h -(bindings)d(or)i(v)-5 b(ariable)630 4481 y(assignmen)m(ts)31 -b(found)e(there.)150 4637 y Fs(abort)g(\(C-g\))630 4746 +(bindings)d(or)i(v)-5 b(ariable)630 4107 y(assignmen)m(ts)31 +b(found)e(there.)150 4262 y Fs(abort)g(\(C-g\))630 4372 y Ft(Ab)s(ort)d(the)h(curren)m(t)f(editing)h(command)f(and)g(ring)h (the)f(terminal's)h(b)s(ell)g(\(sub)5 b(ject)26 b(to)i(the)630 -4856 y(setting)j(of)g Fs(bell-style)p Ft(\).)150 5011 +4481 y(setting)j(of)g Fs(bell-style)p Ft(\).)150 4637 y Fs(do-lowercase-version)25 b(\(M-A,)k(M-B,)g(M-)p Fl(x)p -Fs(,)g(...)o(\))630 5121 y Ft(If)35 b(the)g(meta\014ed)g(c)m(haracter)i +Fs(,)g(...)o(\))630 4746 y Ft(If)35 b(the)g(meta\014ed)g(c)m(haracter)i Fj(x)k Ft(is)35 b(upp)s(er)e(case,)k(run)d(the)h(command)g(that)g(is)g -(b)s(ound)e(to)630 5230 y(the)g(corresp)s(onding)f(meta\014ed)h(lo)m(w) +(b)s(ound)e(to)630 4856 y(the)g(corresp)s(onding)f(meta\014ed)h(lo)m(w) m(er)i(case)f(c)m(haracter.)50 b(The)32 b(b)s(eha)m(vior)h(is)g -(unde\014ned)e(if)630 5340 y Fj(x)37 b Ft(is)30 b(already)h(lo)m(w)m -(er)h(case.)p eop end +(unde\014ned)e(if)630 4965 y Fj(x)37 b Ft(is)30 b(already)h(lo)m(w)m +(er)h(case.)150 5121 y Fs(prefix-meta)27 b(\(ESC\))630 +5230 y Ft(Metafy)39 b(the)e(next)h(c)m(haracter)h(t)m(yp)s(ed.)62 +b(This)37 b(is)g(for)h(k)m(eyb)s(oards)f(without)g(a)h(meta)g(k)m(ey)-8 +b(.)630 5340 y(T)m(yping)30 b(`)p Fs(ESC)g(f)p Ft(')g(is)h(equiv)-5 +b(alen)m(t)31 b(to)g(t)m(yping)g Fl(M-f)p Ft(.)p eop +end %%Page: 24 28 TeXDict begin 24 27 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(24)150 299 y Fs(prefix-meta)27 -b(\(ESC\))630 408 y Ft(Metafy)39 b(the)e(next)h(c)m(haracter)h(t)m(yp)s -(ed.)62 b(This)37 b(is)g(for)h(k)m(eyb)s(oards)f(without)g(a)h(meta)g -(k)m(ey)-8 b(.)630 518 y(T)m(yping)30 b(`)p Fs(ESC)g(f)p -Ft(')g(is)h(equiv)-5 b(alen)m(t)31 b(to)g(t)m(yping)g -Fl(M-f)p Ft(.)150 704 y Fs(undo)e(\(C-_)g(or)h(C-x)g(C-u\))630 -814 y Ft(Incremen)m(tal)h(undo,)f(separately)h(remem)m(b)s(ered)f(for)g -(eac)m(h)i(line.)150 1000 y Fs(revert-line)27 b(\(M-r\))630 -1110 y Ft(Undo)33 b(all)h(c)m(hanges)g(made)f(to)h(this)f(line.)49 -b(This)32 b(is)h(lik)m(e)i(executing)f(the)f Fs(undo)f -Ft(command)630 1219 y(enough)e(times)h(to)g(get)h(bac)m(k)f(to)g(the)f -(b)s(eginning.)150 1406 y Fs(tilde-expand)d(\(M-~\))630 -1515 y Ft(P)m(erform)j(tilde)h(expansion)g(on)f(the)g(curren)m(t)h(w)m -(ord.)150 1702 y Fs(set-mark)d(\(C-@\))630 1811 y Ft(Set)33 -b(the)g(mark)f(to)i(the)f(p)s(oin)m(t.)48 b(If)32 b(a)h(n)m(umeric)g -(argumen)m(t)g(is)g(supplied,)f(the)h(mark)g(is)f(set)630 -1921 y(to)f(that)g(p)s(osition.)150 2107 y Fs(exchange-point-and-mark) -24 b(\(C-x)29 b(C-x\))630 2217 y Ft(Sw)m(ap)i(the)g(p)s(oin)m(t)g(with) -g(the)g(mark.)43 b(The)31 b(curren)m(t)g(cursor)f(p)s(osition)i(is)f -(set)h(to)f(the)h(sa)m(v)m(ed)630 2326 y(p)s(osition,)f(and)e(the)i -(old)g(cursor)e(p)s(osition)i(is)f(sa)m(v)m(ed)i(as)e(the)h(mark.)150 -2513 y Fs(character-search)26 b(\(C-]\))630 2622 y Ft(A)f(c)m(haracter) -h(is)f(read)g(and)f(p)s(oin)m(t)h(is)g(mo)m(v)m(ed)h(to)g(the)f(next)g -(o)s(ccurrence)g(of)g(that)g(c)m(haracter.)630 2732 y(A)30 +b(Command)29 b(Line)i(Editing)2107 b(24)150 299 y Fs(undo)29 +b(\(C-_)g(or)h(C-x)g(C-u\))630 408 y Ft(Incremen)m(tal)h(undo,)f +(separately)h(remem)m(b)s(ered)f(for)g(eac)m(h)i(line.)150 +584 y Fs(revert-line)27 b(\(M-r\))630 693 y Ft(Undo)33 +b(all)h(c)m(hanges)g(made)f(to)h(this)f(line.)49 b(This)32 +b(is)h(lik)m(e)i(executing)f(the)f Fs(undo)f Ft(command)630 +803 y(enough)e(times)h(to)g(get)h(bac)m(k)f(to)g(the)f(b)s(eginning.) +150 978 y Fs(tilde-expand)d(\(M-~\))630 1088 y Ft(P)m(erform)j(tilde)h +(expansion)g(on)f(the)g(curren)m(t)h(w)m(ord.)150 1263 +y Fs(set-mark)d(\(C-@\))630 1373 y Ft(Set)33 b(the)g(mark)f(to)i(the)f +(p)s(oin)m(t.)48 b(If)32 b(a)h(n)m(umeric)g(argumen)m(t)g(is)g +(supplied,)f(the)h(mark)g(is)f(set)630 1482 y(to)f(that)g(p)s(osition.) +150 1658 y Fs(exchange-point-and-mark)24 b(\(C-x)29 b(C-x\))630 +1767 y Ft(Sw)m(ap)i(the)g(p)s(oin)m(t)g(with)g(the)g(mark.)43 +b(The)31 b(curren)m(t)g(cursor)f(p)s(osition)i(is)f(set)h(to)f(the)h +(sa)m(v)m(ed)630 1877 y(p)s(osition,)f(and)e(the)i(old)g(cursor)e(p)s +(osition)i(is)f(sa)m(v)m(ed)i(as)e(the)h(mark.)150 2052 +y Fs(character-search)26 b(\(C-]\))630 2162 y Ft(A)f(c)m(haracter)h(is) +f(read)g(and)f(p)s(oin)m(t)h(is)g(mo)m(v)m(ed)h(to)g(the)f(next)g(o)s +(ccurrence)g(of)g(that)g(c)m(haracter.)630 2271 y(A)30 b(negativ)m(e)j(argumen)m(t)e(searc)m(hes)g(for)f(previous)g(o)s -(ccurrences.)150 2918 y Fs(character-search-backwar)o(d)24 -b(\(M-C-]\))630 3028 y Ft(A)45 b(c)m(haracter)h(is)f(read)g(and)f(p)s +(ccurrences.)150 2447 y Fs(character-search-backwar)o(d)24 +b(\(M-C-]\))630 2556 y Ft(A)45 b(c)m(haracter)h(is)f(read)g(and)f(p)s (oin)m(t)h(is)g(mo)m(v)m(ed)h(to)f(the)g(previous)f(o)s(ccurrence)h(of) -g(that)630 3137 y(c)m(haracter.)d(A)31 b(negativ)m(e)h(argumen)m(t)f +g(that)630 2666 y(c)m(haracter.)d(A)31 b(negativ)m(e)h(argumen)m(t)f (searc)m(hes)g(for)g(subsequen)m(t)e(o)s(ccurrences.)150 -3324 y Fs(skip-csi-sequence)d(\(\))630 3433 y Ft(Read)i(enough)f(c)m +2841 y Fs(skip-csi-sequence)d(\(\))630 2951 y Ft(Read)i(enough)f(c)m (haracters)h(to)g(consume)f(a)h(m)m(ulti-k)m(ey)h(sequence)f(suc)m(h)f -(as)g(those)h(de\014ned)630 3543 y(for)37 b(k)m(eys)h(lik)m(e)g(Home)g +(as)g(those)h(de\014ned)630 3061 y(for)37 b(k)m(eys)h(lik)m(e)g(Home)g (and)f(End.)60 b(Suc)m(h)37 b(sequences)g(b)s(egin)g(with)g(a)h(Con)m -(trol)g(Sequence)630 3652 y(Indicator)f(\(CSI\),)f(usually)h(ESC-[.)59 +(trol)g(Sequence)630 3170 y(Indicator)f(\(CSI\),)f(usually)h(ESC-[.)59 b(If)36 b(this)g(sequence)h(is)g(b)s(ound)d(to)k Fs("\\)p -Ft(e[)p Fs(")p Ft(,)g(k)m(eys)f(pro-)630 3762 y(ducing)29 +Ft(e[)p Fs(")p Ft(,)g(k)m(eys)f(pro-)630 3280 y(ducing)29 b(suc)m(h)g(sequences)g(will)h(ha)m(v)m(e)h(no)e(e\013ect)i(unless)d -(explicitly)j(b)s(ound)d(to)i(a)f(Readline)630 3871 y(command,)j +(explicitly)j(b)s(ound)d(to)i(a)f(Readline)630 3389 y(command,)j (instead)g(of)g(inserting)g(stra)m(y)h(c)m(haracters)g(in)m(to)g(the)f -(editing)h(bu\013er.)44 b(This)31 b(is)630 3981 y(un)m(b)s(ound)d(b)m +(editing)h(bu\013er.)44 b(This)31 b(is)630 3499 y(un)m(b)s(ound)d(b)m (y)i(default,)h(but)f(usually)g(b)s(ound)e(to)j(ESC-[.)150 -4167 y Fs(insert-comment)26 b(\(M-#\))630 4277 y Ft(Without)36 +3674 y Fs(insert-comment)26 b(\(M-#\))630 3784 y Ft(Without)36 b(a)g(n)m(umeric)g(argumen)m(t,)h(the)f(v)-5 b(alue)36 b(of)g(the)g Fs(comment-begin)c Ft(v)-5 b(ariable)36 -b(is)g(in-)630 4387 y(serted)c(at)g(the)g(b)s(eginning)f(of)h(the)f +b(is)g(in-)630 3893 y(serted)c(at)g(the)g(b)s(eginning)f(of)h(the)f (curren)m(t)h(line.)45 b(If)31 b(a)h(n)m(umeric)f(argumen)m(t)h(is)g -(supplied,)630 4496 y(this)k(command)h(acts)g(as)g(a)g(toggle:)55 +(supplied,)630 4003 y(this)k(command)h(acts)g(as)g(a)g(toggle:)55 b(if)37 b(the)f(c)m(haracters)i(at)g(the)e(b)s(eginning)g(of)h(the)g -(line)630 4606 y(do)30 b(not)h(matc)m(h)h(the)f(v)-5 +(line)630 4113 y(do)30 b(not)h(matc)m(h)h(the)f(v)-5 b(alue)31 b(of)f Fs(comment-begin)p Ft(,)e(the)i(v)-5 -b(alue)31 b(is)g(inserted,)g(otherwise)g(the)630 4715 +b(alue)31 b(is)g(inserted,)g(otherwise)g(the)630 4222 y(c)m(haracters)42 b(in)d Fs(comment-begin)e Ft(are)j(deleted)h(from)f -(the)g(b)s(eginning)g(of)g(the)g(line.)71 b(In)630 4825 +(the)g(b)s(eginning)g(of)g(the)g(line.)71 b(In)630 4332 y(either)31 b(case,)h(the)e(line)h(is)f(accepted)i(as)f(if)f(a)h -(newline)f(had)g(b)s(een)f(t)m(yp)s(ed.)150 5011 y Fs(dump-functions)d -(\(\))630 5121 y Ft(Prin)m(t)g(all)i(of)e(the)h(functions)f(and)g +(newline)f(had)g(b)s(een)f(t)m(yp)s(ed.)150 4507 y Fs(dump-functions)d +(\(\))630 4617 y Ft(Prin)m(t)g(all)i(of)e(the)h(functions)f(and)g (their)g(k)m(ey)h(bindings)e(to)j(the)e(Readline)h(output)f(stream.)630 -5230 y(If)31 b(a)h(n)m(umeric)g(argumen)m(t)g(is)g(supplied,)f(the)h +4726 y(If)31 b(a)h(n)m(umeric)g(argumen)m(t)g(is)g(supplied,)f(the)h (output)f(is)h(formatted)g(in)f(suc)m(h)h(a)g(w)m(a)m(y)g(that)630 -5340 y(it)f(can)g(b)s(e)e(made)i(part)f(of)g(an)h Fj(inputrc)k +4836 y(it)f(can)g(b)s(e)e(made)i(part)f(of)g(an)h Fj(inputrc)k Ft(\014le.)41 b(This)29 b(command)h(is)h(un)m(b)s(ound)c(b)m(y)k -(default.)p eop end -%%Page: 25 29 -TeXDict begin 25 28 bop 150 -116 a Ft(Chapter)30 b(1:)41 -b(Command)29 b(Line)i(Editing)2107 b(25)150 299 y Fs(dump-variables)26 -b(\(\))630 408 y Ft(Prin)m(t)21 b(all)h(of)g(the)f(settable)i(v)-5 +(default.)150 5011 y Fs(dump-variables)26 b(\(\))630 +5121 y Ft(Prin)m(t)21 b(all)h(of)g(the)f(settable)i(v)-5 b(ariables)22 b(and)f(their)g(v)-5 b(alues)22 b(to)g(the)f(Readline)h -(output)f(stream.)630 518 y(If)31 b(a)h(n)m(umeric)g(argumen)m(t)g(is)g -(supplied,)f(the)h(output)f(is)h(formatted)g(in)f(suc)m(h)h(a)g(w)m(a)m -(y)g(that)630 628 y(it)f(can)g(b)s(e)e(made)i(part)f(of)g(an)h +(output)f(stream.)630 5230 y(If)31 b(a)h(n)m(umeric)g(argumen)m(t)g(is) +g(supplied,)f(the)h(output)f(is)h(formatted)g(in)f(suc)m(h)h(a)g(w)m(a) +m(y)g(that)630 5340 y(it)f(can)g(b)s(e)e(made)i(part)f(of)g(an)h Fj(inputrc)k Ft(\014le.)41 b(This)29 b(command)h(is)h(un)m(b)s(ound)c -(b)m(y)k(default.)150 787 y Fs(dump-macros)c(\(\))630 -897 y Ft(Prin)m(t)34 b(all)g(of)g(the)g(Readline)g(k)m(ey)h(sequences)f -(b)s(ound)e(to)i(macros)g(and)f(the)h(strings)g(they)630 -1006 y(output.)53 b(If)35 b(a)g(n)m(umeric)f(argumen)m(t)i(is)e +(b)m(y)k(default.)p eop end +%%Page: 25 29 +TeXDict begin 25 28 bop 150 -116 a Ft(Chapter)30 b(1:)41 +b(Command)29 b(Line)i(Editing)2107 b(25)150 299 y Fs(dump-macros)27 +b(\(\))630 408 y Ft(Prin)m(t)34 b(all)g(of)g(the)g(Readline)g(k)m(ey)h +(sequences)f(b)s(ound)e(to)i(macros)g(and)f(the)h(strings)g(they)630 +518 y(output.)53 b(If)35 b(a)g(n)m(umeric)f(argumen)m(t)i(is)e (supplied,)h(the)g(output)g(is)f(formatted)i(in)e(suc)m(h)h(a)630 -1116 y(w)m(a)m(y)c(that)g(it)f(can)g(b)s(e)g(made)g(part)f(of)i(an)e +628 y(w)m(a)m(y)c(that)g(it)f(can)g(b)s(e)g(made)g(part)f(of)i(an)e Fj(inputrc)35 b Ft(\014le.)41 b(This)29 b(command)h(is)g(un)m(b)s(ound) -d(b)m(y)630 1225 y(default.)150 1385 y Fs(emacs-editing-mode)e(\(C-e\)) -630 1494 y Ft(When)30 b(in)g Fs(vi)g Ft(command)g(mo)s(de,)g(this)h +d(b)m(y)630 737 y(default.)150 897 y Fs(emacs-editing-mode)e(\(C-e\)) +630 1006 y Ft(When)30 b(in)g Fs(vi)g Ft(command)g(mo)s(de,)g(this)h (causes)f(a)h(switc)m(h)g(to)g Fs(emacs)e Ft(editing)i(mo)s(de.)150 -1654 y Fs(vi-editing-mode)26 b(\(M-C-j\))630 1763 y Ft(When)k(in)g +1166 y Fs(vi-editing-mode)26 b(\(M-C-j\))630 1275 y Ft(When)k(in)g Fs(emacs)f Ft(editing)i(mo)s(de,)f(this)h(causes)f(a)h(switc)m(h)g(to)g -Fs(vi)f Ft(editing)h(mo)s(de.)150 2004 y Fr(1.5)68 b(Readline)47 -b(vi)e(Mo)t(de)150 2164 y Ft(While)32 b(the)g(Readline)g(library)f(do)s -(es)g(not)h(ha)m(v)m(e)h(a)f(full)f(set)h(of)g Fs(vi)f -Ft(editing)h(functions,)f(it)h(do)s(es)g(con)m(tain)150 -2273 y(enough)i(to)h(allo)m(w)g(simple)f(editing)h(of)f(the)g(line.)52 -b(The)34 b(Readline)g Fs(vi)g Ft(mo)s(de)f(b)s(eha)m(v)m(es)i(as)f(sp)s -(eci\014ed)f(in)150 2383 y(the)e Fm(posix)e Ft(standard.)275 -2517 y(In)f(order)g(to)i(switc)m(h)g(in)m(teractiv)m(ely)i(b)s(et)m(w)m -(een)d Fs(emacs)f Ft(and)g Fs(vi)h Ft(editing)g(mo)s(des,)g(use)g(the)g -(command)150 2627 y Fl(M-C-j)36 b Ft(\(b)s(ound)h(to)h -(emacs-editing-mo)s(de)i(when)d(in)g Fs(vi)h Ft(mo)s(de)f(and)g(to)i -(vi-editing-mo)s(de)g(in)e Fs(emacs)150 2736 y Ft(mo)s(de\).)k(The)30 -b(Readline)h(default)f(is)g Fs(emacs)f Ft(mo)s(de.)275 -2871 y(When)g(y)m(ou)i(en)m(ter)f(a)h(line)f(in)g Fs(vi)f -Ft(mo)s(de,)h(y)m(ou)h(are)f(already)h(placed)f(in)g(`insertion')g(mo)s -(de,)g(as)h(if)f(y)m(ou)150 2980 y(had)f(t)m(yp)s(ed)g(an)g(`)p -Fs(i)p Ft('.)41 b(Pressing)29 b Fs(ESC)f Ft(switc)m(hes)i(y)m(ou)g(in)m -(to)h(`command')e(mo)s(de,)h(where)e(y)m(ou)i(can)g(edit)g(the)150 -3090 y(text)35 b(of)f(the)g(line)g(with)f(the)h(standard)f -Fs(vi)g Ft(mo)m(v)m(emen)m(t)j(k)m(eys,)g(mo)m(v)m(e)f(to)f(previous)g -(history)f(lines)h(with)150 3200 y(`)p Fs(k)p Ft(')d(and)e(subsequen)m -(t)h(lines)h(with)f(`)p Fs(j)p Ft(',)g(and)g(so)h(forth.)p -eop end +Fs(vi)f Ft(editing)h(mo)s(de.)150 1435 y Fs(execute-named-command)25 +b(\(M-x\))630 1544 y Ft(Read)j(a)g(bindable)f(readline)h(command)g +(name)g(from)f(the)h(input)f(and)g(execute)j(the)e(func-)630 +1654 y(tion)e(to)h(whic)m(h)f(it's)g(b)s(ound,)f(as)h(if)g(the)g(k)m +(ey)h(sequence)f(to)h(whic)m(h)e(it)i(w)m(as)f(b)s(ound)e(app)s(eared) +630 1763 y(in)37 b(the)h(input.)61 b(If)37 b(this)h(function)f(is)g +(supplied)g(with)g(a)h(n)m(umeric)f(argumen)m(t,)j(it)e(passes)630 +1873 y(that)31 b(argumen)m(t)g(to)g(the)f(function)h(it)f(executes.)150 +2114 y Fr(1.5)68 b(Readline)47 b(vi)e(Mo)t(de)150 2273 +y Ft(While)32 b(the)g(Readline)g(library)f(do)s(es)g(not)h(ha)m(v)m(e)h +(a)f(full)f(set)h(of)g Fs(vi)f Ft(editing)h(functions,)f(it)h(do)s(es)g +(con)m(tain)150 2383 y(enough)i(to)h(allo)m(w)g(simple)f(editing)h(of)f +(the)g(line.)52 b(The)34 b(Readline)g Fs(vi)g Ft(mo)s(de)f(b)s(eha)m(v) +m(es)i(as)f(sp)s(eci\014ed)f(in)150 2492 y(the)e Fm(posix)e +Ft(standard.)275 2627 y(In)f(order)g(to)i(switc)m(h)g(in)m(teractiv)m +(ely)i(b)s(et)m(w)m(een)d Fs(emacs)f Ft(and)g Fs(vi)h +Ft(editing)g(mo)s(des,)g(use)g(the)g(command)150 2736 +y Fl(M-C-j)36 b Ft(\(b)s(ound)h(to)h(emacs-editing-mo)s(de)i(when)d(in) +g Fs(vi)h Ft(mo)s(de)f(and)g(to)i(vi-editing-mo)s(de)g(in)e +Fs(emacs)150 2846 y Ft(mo)s(de\).)k(The)30 b(Readline)h(default)f(is)g +Fs(emacs)f Ft(mo)s(de.)275 2980 y(When)g(y)m(ou)i(en)m(ter)f(a)h(line)f +(in)g Fs(vi)f Ft(mo)s(de,)h(y)m(ou)h(are)f(already)h(placed)f(in)g +(`insertion')g(mo)s(de,)g(as)h(if)f(y)m(ou)150 3090 y(had)f(t)m(yp)s +(ed)g(an)g(`)p Fs(i)p Ft('.)41 b(Pressing)29 b Fs(ESC)f +Ft(switc)m(hes)i(y)m(ou)g(in)m(to)h(`command')e(mo)s(de,)h(where)e(y)m +(ou)i(can)g(edit)g(the)150 3200 y(text)35 b(of)f(the)g(line)g(with)f +(the)h(standard)f Fs(vi)g Ft(mo)m(v)m(emen)m(t)j(k)m(eys,)g(mo)m(v)m(e) +f(to)f(previous)g(history)f(lines)h(with)150 3309 y(`)p +Fs(k)p Ft(')d(and)e(subsequen)m(t)h(lines)h(with)f(`)p +Fs(j)p Ft(',)g(and)g(so)h(forth.)p eop end %%Page: 26 30 TeXDict begin 26 29 bop 3659 -116 a Ft(26)150 299 y Fp(2)80 b(Programming)54 b(with)f(GNU)h(Readline)150 543 y Ft(This)24 @@ -8527,173 +8539,180 @@ b(the)f(default)h(b)s(eha)m(viour)f(of)h(Readline)g(is)g(su\016cien)m Fs(gets\(\))e Ft(or)150 1605 y Fs(fgets\(\))p Ft(.)275 1743 y(The)f(function)g Fs(readline\(\))e Ft(prin)m(ts)i(a)g(prompt)g Fj(prompt)i Ft(and)e(then)g(reads)g(and)g(returns)f(a)i(single)150 -1852 y(line)g(of)g(text)h(from)e(the)h(user.)47 b(If)32 -b Fj(prompt)i Ft(is)e Fs(NULL)g Ft(or)h(the)f(empt)m(y)i(string,)f(no)g -(prompt)e(is)i(displa)m(y)m(ed.)150 1962 y(The)k(line)g -Fs(readline)e Ft(returns)h(is)h(allo)s(cated)i(with)e -Fs(malloc\(\))p Ft(;)h(the)f(caller)i(should)d Fs(free\(\))f -Ft(the)j(line)150 2072 y(when)29 b(it)i(has)f(\014nished)f(with)h(it.) -42 b(The)29 b(declaration)j(for)f Fs(readline)d Ft(in)i(ANSI)g(C)g(is) -390 2209 y Fs(char)47 b(*readline)e(\(const)h(char)h(*)p -Fl(prompt)p Fs(\);)150 2347 y Ft(So,)31 b(one)f(migh)m(t)h(sa)m(y)390 -2485 y Fs(char)47 b(*line)f(=)h(readline)f(\("Enter)g(a)h(line:)g("\);) -150 2623 y Ft(in)23 b(order)f(to)h(read)g(a)g(line)h(of)f(text)h(from)e +1852 y(line)c(of)h(text)g(from)e(the)i(user.)39 b(Since)29 +b(it's)h(p)s(ossible)f(to)g(en)m(ter)h(c)m(haracters)h(in)m(to)f(the)f +(line)g(while)g(quoting)150 1962 y(them)42 b(to)g(disable)g(an)m(y)g +(Readline)g(editing)h(function)e(they)h(migh)m(t)h(normally)f(ha)m(v)m +(e,)k(this)41 b(line)h(ma)m(y)150 2072 y(include)35 b(em)m(b)s(edded)f +(newlines)h(and)f(other)h(sp)s(ecial)h(c)m(haracters.)56 +b(If)35 b Fj(prompt)h Ft(is)f Fs(NULL)f Ft(or)h(the)h(empt)m(y)150 +2181 y(string,)31 b(no)g(prompt)f(is)h(displa)m(y)m(ed.)43 +b(The)31 b(line)g Fs(readline)e Ft(returns)h(is)h(allo)s(cated)i(with)d +Fs(malloc\(\))p Ft(;)g(the)150 2291 y(caller)g(should)f +Fs(free\(\))e Ft(the)i(line)h(when)e(it)i(has)f(\014nished)e(with)i +(it.)41 b(The)29 b(declaration)h(for)f Fs(readline)e +Ft(in)150 2400 y(ANSI)j(C)g(is)390 2538 y Fs(char)47 +b(*readline)e(\(const)h(char)h(*)p Fl(prompt)p Fs(\);)150 +2676 y Ft(So,)31 b(one)f(migh)m(t)h(sa)m(y)390 2814 y +Fs(char)47 b(*line)f(=)h(readline)f(\("Enter)g(a)h(line:)g("\);)150 +2951 y Ft(in)23 b(order)f(to)h(read)g(a)g(line)h(of)f(text)h(from)e (the)h(user.)38 b(The)22 b(line)h(returned)f(has)g(the)h(\014nal)g -(newline)g(remo)m(v)m(ed,)150 2732 y(so)31 b(only)f(the)h(text)g -(remains.)275 2870 y(If)40 b Fs(readline)e Ft(encoun)m(ters)j(an)f +(newline)g(remo)m(v)m(ed,)150 3061 y(so)31 b(only)f(the)h(text)g +(remains.)275 3199 y(If)40 b Fs(readline)e Ft(encoun)m(ters)j(an)f Fs(EOF)f Ft(while)i(reading)f(the)h(line,)j(and)39 b(the)i(line)g(is)f -(empt)m(y)h(at)g(that)150 2979 y(p)s(oin)m(t,)30 b(then)f +(empt)m(y)h(at)g(that)150 3308 y(p)s(oin)m(t,)30 b(then)f Fs(\(char)g(*\)NULL)e Ft(is)j(returned.)39 b(Otherwise,)30 b(the)f(line)h(is)f(ended)g(just)g(as)g(if)h(a)f(newline)h(had)150 -3089 y(b)s(een)g(t)m(yp)s(ed.)275 3227 y(Readline)22 +3418 y(b)s(een)g(t)m(yp)s(ed.)275 3556 y(Readline)22 b(p)s(erforms)e(some)j(expansion)e(on)h(the)g Fj(prompt)h Ft(b)s(efore)f(it)g(is)g(displa)m(y)m(ed)h(on)f(the)g(screen.)38 -b(See)150 3336 y(the)27 b(description)g(of)h Fs(rl_expand_prompt)22 +b(See)150 3665 y(the)27 b(description)g(of)h Fs(rl_expand_prompt)22 b Ft(\(see)28 b(Section)g(2.4.6)h([Redispla)m(y],)g(page)f(40\))g(for)f -(additional)150 3446 y(details,)41 b(esp)s(ecially)f(if)e +(additional)150 3775 y(details,)41 b(esp)s(ecially)f(if)e Fj(prompt)i Ft(will)e(con)m(tain)i(c)m(haracters)f(that)g(do)f(not)h -(consume)f(ph)m(ysical)h(screen)150 3556 y(space)31 b(when)e(displa)m -(y)m(ed.)275 3693 y(If)d(y)m(ou)h(w)m(an)m(t)h(the)f(user)g(to)g(b)s(e) +(consume)f(ph)m(ysical)h(screen)150 3884 y(space)31 b(when)e(displa)m +(y)m(ed.)275 4022 y(If)d(y)m(ou)h(w)m(an)m(t)h(the)f(user)g(to)g(b)s(e) g(able)g(to)h(get)g(at)g(the)f(line)g(later,)i(\(with)e -Fs(C-p)f Ft(for)h(example\),)i(y)m(ou)e(m)m(ust)150 3803 +Fs(C-p)f Ft(for)h(example\),)i(y)m(ou)e(m)m(ust)150 4132 y(call)32 b Fs(add_history\(\))26 b Ft(to)32 b(sa)m(v)m(e)f(the)g(line) g(a)m(w)m(a)m(y)h(in)e(a)h Fj(history)38 b Ft(list)31 -b(of)g(suc)m(h)f(lines.)390 3941 y Fs(add_history)45 -b(\(line\);)150 4078 y Ft(F)-8 b(or)31 b(full)f(details)i(on)e(the)g +b(of)g(suc)m(h)f(lines.)390 4269 y Fs(add_history)45 +b(\(line\);)150 4407 y Ft(F)-8 b(or)31 b(full)f(details)i(on)e(the)g (GNU)h(History)g(Library)-8 b(,)31 b(see)g(the)f(asso)s(ciated)i(man)m -(ual.)275 4216 y(It)f(is)g(preferable)g(to)i(a)m(v)m(oid)f(sa)m(ving)h +(ual.)275 4545 y(It)f(is)g(preferable)g(to)i(a)m(v)m(oid)f(sa)m(ving)h (empt)m(y)e(lines)h(on)f(the)h(history)f(list,)h(since)g(users)e -(rarely)i(ha)m(v)m(e)h(a)150 4326 y(burning)28 b(need)h(to)i(reuse)e(a) +(rarely)i(ha)m(v)m(e)h(a)150 4654 y(burning)28 b(need)h(to)i(reuse)e(a) h(blank)g(line.)40 b(Here)31 b(is)e(a)h(function)g(whic)m(h)f(usefully) -g(replaces)i(the)f(standard)150 4435 y Fs(gets\(\))f +g(replaces)i(the)f(standard)150 4764 y Fs(gets\(\))f Ft(library)h(function,)g(and)g(has)g(the)g(adv)-5 b(an)m(tage)33 b(of)d(no)g(static)i(bu\013er)e(to)h(o)m(v)m(er\015o)m(w:)390 -4573 y Fs(/*)47 b(A)h(static)e(variable)f(for)i(holding)f(the)h(line.)f -(*/)390 4682 y(static)g(char)h(*line_read)e(=)i(\(char)g(*\)NULL;)390 -4902 y(/*)g(Read)g(a)g(string,)f(and)h(return)f(a)i(pointer)d(to)j(it.) -533 5011 y(Returns)e(NULL)h(on)g(EOF.)f(*/)390 5121 y(char)h(*)390 -5230 y(rl_gets)f(\(\))390 5340 y({)p eop end +4902 y Fs(/*)47 b(A)h(static)e(variable)f(for)i(holding)f(the)h(line.)f +(*/)390 5011 y(static)g(char)h(*line_read)e(=)i(\(char)g(*\)NULL;)390 +5230 y(/*)g(Read)g(a)g(string,)f(and)h(return)f(a)i(pointer)d(to)j(it.) +533 5340 y(Returns)e(NULL)h(on)g(EOF.)f(*/)p eop end %%Page: 27 31 TeXDict begin 27 30 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(27)485 -299 y Fs(/*)48 b(If)f(the)g(buffer)f(has)h(already)f(been)g(allocated,) -629 408 y(return)g(the)h(memory)f(to)h(the)g(free)f(pool.)h(*/)485 -518 y(if)h(\(line_read\))581 628 y({)676 737 y(free)f(\(line_read\);) -676 847 y(line_read)f(=)h(\(char)f(*\)NULL;)581 956 y(})485 -1176 y(/*)i(Get)f(a)g(line)g(from)f(the)h(user.)g(*/)485 -1285 y(line_read)f(=)h(readline)f(\(""\);)485 1504 y(/*)i(If)f(the)g -(line)f(has)h(any)g(text)g(in)g(it,)629 1614 y(save)f(it)h(on)h(the)f -(history.)e(*/)485 1724 y(if)j(\(line_read)d(&&)i(*line_read\))581 -1833 y(add_history)e(\(line_read\);)485 2052 y(return)i(\(line_read\);) -390 2162 y(})275 2303 y Ft(This)27 b(function)h(giv)m(es)h(the)f(user)g +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(27)390 +299 y Fs(char)47 b(*)390 408 y(rl_gets)f(\(\))390 518 +y({)485 628 y(/*)i(If)f(the)g(buffer)f(has)h(already)f(been)g +(allocated,)629 737 y(return)g(the)h(memory)f(to)h(the)g(free)f(pool.)h +(*/)485 847 y(if)h(\(line_read\))581 956 y({)676 1066 +y(free)f(\(line_read\);)676 1176 y(line_read)f(=)h(\(char)f(*\)NULL;) +581 1285 y(})485 1504 y(/*)i(Get)f(a)g(line)g(from)f(the)h(user.)g(*/) +485 1614 y(line_read)f(=)h(readline)f(\(""\);)485 1833 +y(/*)i(If)f(the)g(line)f(has)h(any)g(text)g(in)g(it,)629 +1943 y(save)f(it)h(on)h(the)f(history.)e(*/)485 2052 +y(if)j(\(line_read)d(&&)i(*line_read\))581 2162 y(add_history)e +(\(line_read\);)485 2381 y(return)i(\(line_read\);)390 +2491 y(})275 2622 y Ft(This)27 b(function)h(giv)m(es)h(the)f(user)g (the)g(default)g(b)s(eha)m(viour)g(of)g Fs(TAB)g Ft(completion:)40 -b(completion)30 b(on)e(\014le)150 2412 y(names.)41 b(If)31 +b(completion)30 b(on)e(\014le)150 2732 y(names.)41 b(If)31 b(y)m(ou)g(do)f(not)h(w)m(an)m(t)g(Readline)h(to)f(complete)h(on)f (\014lenames,)g(y)m(ou)g(can)f(c)m(hange)i(the)f(binding)150 -2522 y(of)g(the)f Fs(TAB)g Ft(k)m(ey)h(with)f Fs(rl_bind_key\(\))p -Ft(.)390 2662 y Fs(int)47 b(rl_bind_key)e(\(int)h Fl(key)p +2841 y(of)g(the)f Fs(TAB)g Ft(k)m(ey)h(with)f Fs(rl_bind_key\(\))p +Ft(.)390 2973 y Fs(int)47 b(rl_bind_key)e(\(int)h Fl(key)p Fs(,)h(rl_command_func_t)c(*)p Fl(function)p Fs(\);)275 -2803 y(rl_bind_key\(\))29 b Ft(tak)m(es)35 b(t)m(w)m(o)g(argumen)m(ts:) +3104 y(rl_bind_key\(\))29 b Ft(tak)m(es)35 b(t)m(w)m(o)g(argumen)m(ts:) 47 b Fj(k)m(ey)c Ft(is)33 b(the)h(c)m(haracter)h(that)f(y)m(ou)g(w)m -(an)m(t)g(to)g(bind,)g(and)150 2912 y Fj(function)39 +(an)m(t)g(to)g(bind,)g(and)150 3214 y Fj(function)39 b Ft(is)f(the)h(address)f(of)h(the)g(function)g(to)g(call)i(when)c Fj(k)m(ey)48 b Ft(is)39 b(pressed.)65 b(Binding)38 b -Fs(TAB)g Ft(to)i Fs(rl_)150 3022 y(insert\(\))c Ft(mak)m(es)k +Fs(TAB)g Ft(to)i Fs(rl_)150 3324 y(insert\(\))c Ft(mak)m(es)k Fs(TAB)e Ft(insert)g(itself.)67 b Fs(rl_bind_key\(\))35 b Ft(returns)j(non-zero)h(if)g Fj(k)m(ey)47 b Ft(is)39 -b(not)g(a)g(v)-5 b(alid)150 3132 y(ASCI)s(I)29 b(c)m(haracter)j(co)s -(de)e(\(b)s(et)m(w)m(een)i(0)f(and)e(255\).)275 3272 +b(not)g(a)g(v)-5 b(alid)150 3433 y(ASCI)s(I)29 b(c)m(haracter)j(co)s +(de)e(\(b)s(et)m(w)m(een)i(0)f(and)e(255\).)275 3565 y(Th)m(us,)g(to)i(disable)g(the)f(default)h Fs(TAB)e Ft(b)s(eha)m(vior,)i(the)g(follo)m(wing)g(su\016ces:)390 -3413 y Fs(rl_bind_key)45 b(\('\\t',)h(rl_insert\);)275 -3554 y Ft(This)25 b(co)s(de)i(should)e(b)s(e)h(executed)h(once)g(at)g +3696 y Fs(rl_bind_key)45 b(\('\\t',)h(rl_insert\);)275 +3828 y Ft(This)25 b(co)s(de)i(should)e(b)s(e)h(executed)h(once)g(at)g (the)g(start)g(of)f(y)m(our)h(program;)g(y)m(ou)g(migh)m(t)g(write)g(a) -g(func-)150 3663 y(tion)33 b(called)h Fs(initialize_readline\(\))27 +g(func-)150 3937 y(tion)33 b(called)h Fs(initialize_readline\(\))27 b Ft(whic)m(h)33 b(p)s(erforms)e(this)h(and)h(other)g(desired)f -(initializations,)150 3773 y(suc)m(h)e(as)h(installing)g(custom)g +(initializations,)150 4047 y(suc)m(h)e(as)h(installing)g(custom)g (completers)g(\(see)g(Section)h(2.6)f([Custom)f(Completers],)h(page)g -(53\).)150 4023 y Fr(2.2)68 b(Custom)45 b(F)-11 b(unctions)150 -4182 y Ft(Readline)28 b(pro)m(vides)f(man)m(y)g(functions)g(for)g +(54\).)150 4282 y Fr(2.2)68 b(Custom)45 b(F)-11 b(unctions)150 +4441 y Ft(Readline)28 b(pro)m(vides)f(man)m(y)g(functions)g(for)g (manipulating)h(the)f(text)h(of)g(the)f(line,)i(but)d(it)i(isn't)f(p)s -(ossible)150 4292 y(to)37 b(an)m(ticipate)i(the)e(needs)f(of)h(all)g +(ossible)150 4551 y(to)37 b(an)m(ticipate)i(the)e(needs)f(of)h(all)g (programs.)59 b(This)36 b(section)h(describ)s(es)f(the)h(v)-5 -b(arious)36 b(functions)h(and)150 4401 y(v)-5 b(ariables)27 +b(arious)36 b(functions)h(and)150 4660 y(v)-5 b(ariables)27 b(de\014ned)e(within)g(the)h(Readline)h(library)f(whic)m(h)g(allo)m(w)h -(a)g(user)e(program)h(to)h(add)e(customized)150 4511 -y(functionalit)m(y)32 b(to)f(Readline.)275 4651 y(Before)37 +(a)g(user)e(program)h(to)h(add)e(customized)150 4770 +y(functionalit)m(y)32 b(to)f(Readline.)275 4902 y(Before)37 b(declaring)g(an)m(y)g(functions)f(that)h(customize)h(Readline's)f(b)s -(eha)m(vior,)h(or)f(using)f(an)m(y)h(func-)150 4761 y(tionalit)m(y)48 +(eha)m(vior,)h(or)f(using)f(an)m(y)h(func-)150 5011 y(tionalit)m(y)48 b(Readline)e(pro)m(vides)f(in)g(other)h(co)s(de,)k(an)45 b(application)i(writer)e(should)g(include)g(the)h(\014le)150 -4871 y Fs(<readline/readline.h>)28 b Ft(in)33 b(an)m(y)h(\014le)f(that) +5121 y Fs(<readline/readline.h>)28 b Ft(in)33 b(an)m(y)h(\014le)f(that) h(uses)f(Readline's)h(features.)51 b(Since)33 b(some)h(of)g(the)f -(de\014-)150 4980 y(nitions)e(in)g Fs(readline.h)d Ft(use)j(the)h +(de\014-)150 5230 y(nitions)e(in)g Fs(readline.h)d Ft(use)j(the)h Fs(stdio)d Ft(library)-8 b(,)32 b(the)f(\014le)h Fs(<stdio.h>)c -Ft(should)i(b)s(e)h(included)f(b)s(efore)150 5090 y Fs(readline.h)p -Ft(.)275 5230 y Fs(readline.h)d Ft(de\014nes)j(a)h(C)f(prepro)s(cessor) -g(v)-5 b(ariable)31 b(that)g(should)f(b)s(e)g(treated)h(as)g(an)g(in)m -(teger,)h Fs(RL_)150 5340 y(READLINE_VERSION)p Ft(,)20 -b(whic)m(h)h(ma)m(y)i(b)s(e)f(used)f(to)i(conditionally)h(compile)f -(application)g(co)s(de)f(dep)s(ending)p eop end +Ft(should)i(b)s(e)h(included)f(b)s(efore)150 5340 y Fs(readline.h)p +Ft(.)p eop end %%Page: 28 32 TeXDict begin 28 31 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(28)150 -299 y(on)35 b(the)g(installed)h(Readline)f(v)m(ersion.)56 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(28)275 +299 y Fs(readline.h)27 b Ft(de\014nes)j(a)h(C)f(prepro)s(cessor)g(v)-5 +b(ariable)31 b(that)g(should)f(b)s(e)g(treated)h(as)g(an)g(in)m(teger,) +h Fs(RL_)150 408 y(READLINE_VERSION)p Ft(,)20 b(whic)m(h)h(ma)m(y)i(b)s +(e)f(used)f(to)i(conditionally)h(compile)f(application)g(co)s(de)f(dep) +s(ending)150 518 y(on)35 b(the)g(installed)h(Readline)f(v)m(ersion.)56 b(The)34 b(v)-5 b(alue)35 b(is)h(a)f(hexadecimal)h(enco)s(ding)f(of)g -(the)h(ma)5 b(jor)35 b(and)150 408 y(minor)f(v)m(ersion)g(n)m(um)m(b)s +(the)h(ma)5 b(jor)35 b(and)150 628 y(minor)f(v)m(ersion)g(n)m(um)m(b)s (ers)f(of)h(the)h(library)-8 b(,)35 b(of)f(the)h(form)e(0x)p Fj(MMmm)p Ft(.)53 b Fj(MM)45 b Ft(is)34 b(the)g(t)m(w)m(o-digit)j(ma)5 -b(jor)150 518 y(v)m(ersion)29 b(n)m(um)m(b)s(er;)g Fj(mm)f +b(jor)150 737 y(v)m(ersion)29 b(n)m(um)m(b)s(er;)g Fj(mm)f Ft(is)h(the)g(t)m(w)m(o-digit)j(minor)c(v)m(ersion)i(n)m(um)m(b)s(er.) 38 b(F)-8 b(or)30 b(Readline)g(4.2,)g(for)f(example,)150 -628 y(the)i(v)-5 b(alue)30 b(of)h Fs(RL_READLINE_VERSION)25 -b Ft(w)m(ould)30 b(b)s(e)g Fs(0x0402)p Ft(.)150 837 y -Fi(2.2.1)63 b(Readline)40 b(T)m(yp)s(edefs)150 984 y -Ft(F)-8 b(or)31 b(readabilit)m(y)-8 b(,)33 b(w)m(e)d(declare)i(a)f(n)m -(um)m(b)s(er)e(of)h(new)g(ob)5 b(ject)31 b(t)m(yp)s(es,)g(all)g(p)s -(oin)m(ters)f(to)i(functions.)275 1128 y(The)j(reason)h(for)f +847 y(the)i(v)-5 b(alue)30 b(of)h Fs(RL_READLINE_VERSION)25 +b Ft(w)m(ould)30 b(b)s(e)g Fs(0x0402)p Ft(.)150 1034 +y Fi(2.2.1)63 b(Readline)40 b(T)m(yp)s(edefs)150 1181 +y Ft(F)-8 b(or)31 b(readabilit)m(y)-8 b(,)33 b(w)m(e)d(declare)i(a)f(n) +m(um)m(b)s(er)e(of)h(new)g(ob)5 b(ject)31 b(t)m(yp)s(es,)g(all)g(p)s +(oin)m(ters)f(to)i(functions.)275 1310 y(The)j(reason)h(for)f (declaring)h(these)h(new)e(t)m(yp)s(es)g(is)h(to)h(mak)m(e)f(it)g -(easier)h(to)f(write)g(co)s(de)g(describing)150 1238 +(easier)h(to)f(write)g(co)s(de)g(describing)150 1419 y(p)s(oin)m(ters)30 b(to)h(C)f(functions)g(with)g(appropriately)h (protot)m(yp)s(ed)f(argumen)m(ts)h(and)f(return)f(v)-5 -b(alues.)275 1382 y(F)d(or)37 b(instance,)j(sa)m(y)d(w)m(e)g(w)m(an)m +b(alues.)275 1548 y(F)d(or)37 b(instance,)j(sa)m(y)d(w)m(e)g(w)m(an)m (t)h(to)g(declare)f(a)h(v)-5 b(ariable)37 b Fj(func)42 b Ft(as)37 b(a)g(p)s(oin)m(ter)g(to)g(a)h(function)e(whic)m(h)150 -1492 y(tak)m(es)27 b(t)m(w)m(o)g Fs(int)e Ft(argumen)m(ts)h(and)f +1657 y(tak)m(es)27 b(t)m(w)m(o)g Fs(int)e Ft(argumen)m(ts)h(and)f (returns)f(an)i Fs(int)f Ft(\(this)h(is)f(the)h(t)m(yp)s(e)g(of)g(all)h -(of)e(the)h(Readline)h(bindable)150 1601 y(functions\).)41 +(of)e(the)h(Readline)h(bindable)150 1767 y(functions\).)41 b(Instead)30 b(of)g(the)h(classic)h(C)e(declaration)275 -1746 y Fs(int)f(\(*func\)\(\);)150 1890 y Ft(or)h(the)h(ANSI-C)f(st)m -(yle)i(declaration)275 2035 y Fs(int)d(\(*func\)\(int,)e(int\);)150 -2179 y Ft(w)m(e)k(ma)m(y)g(write)275 2324 y Fs(rl_command_func_t)25 -b(*func;)275 2468 y Ft(The)k(full)h(list)i(of)e(function)g(p)s(oin)m -(ter)g(t)m(yp)s(es)h(a)m(v)-5 b(ailable)33 b(is)150 2643 +1895 y Fs(int)f(\(*func\)\(\);)150 2024 y Ft(or)h(the)h(ANSI-C)f(st)m +(yle)i(declaration)275 2152 y Fs(int)d(\(*func\)\(int,)e(int\);)150 +2281 y Ft(w)m(e)k(ma)m(y)g(write)275 2409 y Fs(rl_command_func_t)25 +b(*func;)275 2538 y Ft(The)k(full)h(list)i(of)e(function)g(p)s(oin)m +(ter)g(t)m(yp)s(es)h(a)m(v)-5 b(ailable)33 b(is)150 2685 y Fs(typedef)28 b(int)i(rl_command_func_t)c(\(int,)i(int\);)150 -2752 y(typedef)g(char)i(*rl_compentry_func_t)24 b(\(const)29 -b(char)g(*,)h(int\);)150 2862 y(typedef)e(char)i +2795 y(typedef)g(char)i(*rl_compentry_func_t)24 b(\(const)29 +b(char)g(*,)h(int\);)150 2905 y(typedef)e(char)i (**rl_completion_func_t)24 b(\(const)29 b(char)g(*,)h(int,)f(int\);)150 -2971 y(typedef)f(char)i(*rl_quote_func_t)c(\(char)i(*,)i(int,)f(char)h -(*\);)150 3081 y(typedef)e(char)i(*rl_dequote_func_t)25 -b(\(char)k(*,)h(int\);)150 3191 y(typedef)e(int)i(rl_compignore_func_t) -25 b(\(char)k(**\);)150 3300 y(typedef)f(void)i(rl_compdisp_func_t)25 -b(\(char)k(**,)g(int,)h(int\);)150 3410 y(typedef)e(int)i -(rl_hook_func_t)c(\(void\);)150 3519 y(typedef)i(int)i(rl_getc_func_t)c -(\(FILE)j(*\);)150 3629 y(typedef)f(int)i(rl_linebuf_func_t)c(\(char)i -(*,)i(int\);)150 3738 y(typedef)e(int)i(rl_intfunc_t)d(\(int\);)150 -3848 y(#define)h(rl_ivoidfunc_t)f(rl_hook_func_t)150 -3958 y(typedef)h(int)i(rl_icpfunc_t)d(\(char)i(*\);)150 -4067 y(typedef)f(int)i(rl_icppfunc_t)d(\(char)i(**\);)150 -4177 y(typedef)f(void)i(rl_voidfunc_t)c(\(void\);)150 -4286 y(typedef)i(void)i(rl_vintfunc_t)c(\(int\);)150 -4396 y(typedef)i(void)i(rl_vcpfunc_t)d(\(char)i(*\);)150 -4506 y(typedef)f(void)i(rl_vcppfunc_t)c(\(char)j(**\);)150 -4685 y Fi(2.2.2)63 b(W)-10 b(riting)41 b(a)f(New)h(F)-10 -b(unction)150 4832 y Ft(In)30 b(order)h(to)h(write)f(new)g(functions)f +3014 y(typedef)f(char)i(*rl_quote_func_t)c(\(char)i(*,)i(int,)f(char)h +(*\);)150 3124 y(typedef)e(char)i(*rl_dequote_func_t)25 +b(\(char)k(*,)h(int\);)150 3233 y(typedef)e(int)i(rl_compignore_func_t) +25 b(\(char)k(**\);)150 3343 y(typedef)f(void)i(rl_compdisp_func_t)25 +b(\(char)k(**,)g(int,)h(int\);)150 3453 y(typedef)e(int)i +(rl_hook_func_t)c(\(void\);)150 3562 y(typedef)i(int)i(rl_getc_func_t)c +(\(FILE)j(*\);)150 3672 y(typedef)f(int)i(rl_linebuf_func_t)c(\(char)i +(*,)i(int\);)150 3781 y(typedef)e(int)i(rl_intfunc_t)d(\(int\);)150 +3891 y(#define)h(rl_ivoidfunc_t)f(rl_hook_func_t)150 +4000 y(typedef)h(int)i(rl_icpfunc_t)d(\(char)i(*\);)150 +4110 y(typedef)f(int)i(rl_icppfunc_t)d(\(char)i(**\);)150 +4220 y(typedef)f(void)i(rl_voidfunc_t)c(\(void\);)150 +4329 y(typedef)i(void)i(rl_vintfunc_t)c(\(int\);)150 +4439 y(typedef)i(void)i(rl_vcpfunc_t)d(\(char)i(*\);)150 +4548 y(typedef)f(void)i(rl_vcppfunc_t)c(\(char)j(**\);)150 +4717 y Fi(2.2.2)63 b(W)-10 b(riting)41 b(a)f(New)h(F)-10 +b(unction)150 4864 y Ft(In)30 b(order)h(to)h(write)f(new)g(functions)f (for)h(Readline,)h(y)m(ou)g(need)e(to)i(kno)m(w)f(the)g(calling)i(con)m -(v)m(en)m(tions)g(for)150 4941 y(k)m(eyb)s(oard-in)m(v)m(ok)m(ed)f +(v)m(en)m(tions)g(for)150 4973 y(k)m(eyb)s(oard-in)m(v)m(ok)m(ed)f (functions,)d(and)h(the)g(names)g(of)g(the)g(v)-5 b(ariables)31 -b(that)f(describ)s(e)g(the)g(curren)m(t)g(state)150 5051 -y(of)h(the)f(line)h(read)f(so)h(far.)275 5196 y(The)e(calling)j +b(that)f(describ)s(e)g(the)g(curren)m(t)g(state)150 5083 +y(of)h(the)f(line)h(read)f(so)h(far.)275 5211 y(The)e(calling)j (sequence)f(for)f(a)h(command)f Fs(foo)g Ft(lo)s(oks)g(lik)m(e)390 5340 y Fs(int)47 b(foo)g(\(int)f(count,)h(int)f(key\))p eop end @@ -8912,2131 +8931,2205 @@ Fs(rl_instream)p Ft(;)d(if)i(an)f(application)i(is)e(using)g(a)h (di\013eren)m(t)g(input)e(source,)j(it)f(should)390 5230 y(set)34 b(the)f(ho)s(ok)h(appropriately)-8 b(.)50 b(Readline)34 b(queries)f(for)h(a)m(v)-5 b(ailable)35 b(input)e(when)f(implemen)m -(ting)390 5340 y(in)m(tra-k)m(ey-sequence)f(timeouts)e(during)e(input)g -(and)h(incremen)m(tal)h(searc)m(hes.)41 b(This)27 b(ma)m(y)i(use)f(an)p -eop end +(ting)390 5340 y(in)m(tra-k)m(ey-sequence)43 b(timeouts)f(during)d +(input)h(and)g(incremen)m(tal)i(searc)m(hes.)73 b(This)40 +b(function)p eop end %%Page: 32 36 TeXDict begin 32 35 bop 150 -116 a Ft(Chapter)30 b(2:)41 b(Programming)30 b(with)g(GNU)h(Readline)1683 b(32)390 -299 y(application-sp)s(eci\014c)22 b(timeout)g(b)s(efore)f(returning)f -(a)h(v)-5 b(alue;)25 b(Readline)c(uses)f(the)i(v)-5 b(alue)21 -b(passed)f(to)390 408 y Fs(rl_set_keyboard_input_ti)o(meou)o(t\(\))e -Ft(or)24 b(the)g(v)-5 b(alue)25 b(of)g(the)f(user-settable)i -Fj(k)m(eyseq-timeout)390 518 y Ft(v)-5 b(ariable.)48 -b(This)31 b(is)i(designed)f(for)g(use)g(b)m(y)g(applications)i(using)e -(Readline's)h(callbac)m(k)h(in)m(terface)390 628 y(\(see)d(Section)f -(2.4.12)i([Alternate)f(In)m(terface],)h(page)e(46\),)i(whic)m(h)d(ma)m -(y)h(not)g(use)g(the)g(traditional)390 737 y Fs(read\(2\))39 -b Ft(and)g(\014le)i(descriptor)f(in)m(terface,)45 b(or)c(other)f -(applications)i(using)e(a)h(di\013eren)m(t)g(input)390 -847 y(mec)m(hanism.)k(If)31 b(an)g(application)i(uses)e(an)h(input)e -(mec)m(hanism)i(or)g(ho)s(ok)f(that)h(can)g(p)s(oten)m(tially)390 -956 y(exceed)38 b(the)e(v)-5 b(alue)37 b(of)g Fj(k)m(eyseq-timeout)p -Ft(,)k(it)c(should)e(increase)j(the)e(timeout)i(or)f(set)g(this)f(ho)s -(ok)390 1066 y(appropriately)d(ev)m(en)g(when)e(not)h(using)g(the)h -(callbac)m(k)h(in)m(terface.)48 b(In)31 b(general,)j(an)f(application) -390 1176 y(that)e(sets)g Fj(rl)p 832 1176 28 4 v 40 w(getc)p -1032 1176 V 41 w(function)f Ft(should)g(consider)g(setting)h -Fj(rl)p 2431 1176 V 40 w(input)p 2684 1176 V 39 w(a)m(v)-5 -b(ailable)p 3064 1176 V 43 w(ho)s(ok)36 b Ft(as)30 b(w)m(ell.)3371 -1362 y([V)-8 b(ariable])-3598 b Fh(rl_voidfunc_t)56 b(*)d -(rl_redisplay_function)390 1471 y Ft(If)36 b(non-zero,)i(Readline)e +299 y(m)m(ust)26 b(return)f(zero)i(if)f(there)g(is)h(no)f(input)f(a)m +(v)-5 b(ailable,)29 b(and)d(non-zero)h(if)f(input)f(is)h(a)m(v)-5 +b(ailable.)42 b(This)390 408 y(ma)m(y)36 b(use)e(an)h(application-sp)s +(eci\014c)i(timeout)f(b)s(efore)e(returning)g(a)i(v)-5 +b(alue;)38 b(Readline)d(uses)g(the)390 518 y(v)-5 b(alue)25 +b(passed)g(to)h Fs(rl_set_keyboard_input_t)o(ime)o(out\()o(\))19 +b Ft(or)25 b(the)g(v)-5 b(alue)25 b(of)h(the)f(user-settable)390 +628 y Fj(k)m(eyseq-timeout)44 b Ft(v)-5 b(ariable.)71 +b(This)39 b(is)h(designed)f(for)h(use)g(b)m(y)g(applications)h(using)e +(Readline's)390 737 y(callbac)m(k)d(in)m(terface)f(\(see)g(Section)f +(2.4.12)i([Alternate)f(In)m(terface],)i(page)d(46\),)i(whic)m(h)d(ma)m +(y)i(not)390 847 y(use)e(the)g(traditional)h Fs(read\(2\))d +Ft(and)h(\014le)h(descriptor)f(in)m(terface,)k(or)c(other)h +(applications)h(using)390 956 y(a)28 b(di\013eren)m(t)g(input)e(mec)m +(hanism.)40 b(If)27 b(an)g(application)i(uses)e(an)g(input)g(mec)m +(hanism)h(or)f(ho)s(ok)g(that)390 1066 y(can)k(p)s(oten)m(tially)h +(exceed)f(the)f(v)-5 b(alue)31 b(of)g Fj(k)m(eyseq-timeout)p +Ft(,)i(it)e(should)e(increase)i(the)g(timeout)g(or)390 +1176 y(set)c(this)g(ho)s(ok)f(appropriately)h(ev)m(en)g(when)e(not)i +(using)f(the)h(callbac)m(k)i(in)m(terface.)41 b(In)25 +b(general,)k(an)390 1285 y(application)g(that)g(sets)f +Fj(rl)p 1294 1285 28 4 v 40 w(getc)p 1494 1285 V 41 w(function)g +Ft(should)f(consider)g(setting)i Fj(rl)p 2883 1285 V +40 w(input)p 3136 1285 V 39 w(a)m(v)-5 b(ailable)p 3516 +1285 V 43 w(ho)s(ok)390 1395 y Ft(as)31 b(w)m(ell.)3371 +1600 y([V)-8 b(ariable])-3598 b Fh(rl_voidfunc_t)56 b(*)d +(rl_redisplay_function)390 1710 y Ft(If)36 b(non-zero,)i(Readline)e (will)h(call)g(indirectly)f(through)g(this)g(p)s(oin)m(ter)g(to)g(up)s -(date)g(the)g(displa)m(y)390 1581 y(with)27 b(the)g(curren)m(t)g(con)m +(date)g(the)g(displa)m(y)390 1819 y(with)27 b(the)g(curren)m(t)g(con)m (ten)m(ts)h(of)f(the)h(editing)f(bu\013er.)39 b(By)27 b(default,)h(it)g(is)f(set)g(to)h Fs(rl_redisplay)p Ft(,)390 -1691 y(the)j(default)f(Readline)h(redispla)m(y)g(function)f(\(see)h +1929 y(the)j(default)f(Readline)h(redispla)m(y)g(function)f(\(see)h (Section)g(2.4.6)h([Redispla)m(y],)g(page)f(40\).)3371 -1877 y([V)-8 b(ariable])-3598 b Fh(rl_vintfunc_t)56 b(*)d -(rl_prep_term_function)390 1987 y Ft(If)24 b(non-zero,)i(Readline)e +2134 y([V)-8 b(ariable])-3598 b Fh(rl_vintfunc_t)56 b(*)d +(rl_prep_term_function)390 2244 y Ft(If)24 b(non-zero,)i(Readline)e (will)h(call)g(indirectly)g(through)e(this)h(p)s(oin)m(ter)g(to)h -(initialize)h(the)e(terminal.)390 2096 y(The)37 b(function)f(tak)m(es)j +(initialize)h(the)e(terminal.)390 2354 y(The)37 b(function)f(tak)m(es)j (a)e(single)h(argumen)m(t,)i(an)d Fs(int)f Ft(\015ag)h(that)h(sa)m(ys)g -(whether)e(or)h(not)g(to)h(use)390 2206 y(eigh)m(t-bit)e(c)m +(whether)e(or)h(not)g(to)h(use)390 2463 y(eigh)m(t-bit)e(c)m (haracters.)53 b(By)35 b(default,)g(this)f(is)g(set)h(to)g Fs(rl_prep_terminal)29 b Ft(\(see)35 b(Section)g(2.4.9)390 -2315 y([T)-8 b(erminal)31 b(Managemen)m(t],)i(page)e(43\).)3371 -2502 y([V)-8 b(ariable])-3598 b Fh(rl_voidfunc_t)56 b(*)d -(rl_deprep_term_functio)q(n)390 2611 y Ft(If)36 b(non-zero,)j(Readline) +2573 y([T)-8 b(erminal)31 b(Managemen)m(t],)i(page)e(43\).)3371 +2778 y([V)-8 b(ariable])-3598 b Fh(rl_voidfunc_t)56 b(*)d +(rl_deprep_term_functio)q(n)390 2888 y Ft(If)36 b(non-zero,)j(Readline) e(will)g(call)h(indirectly)f(through)f(this)g(p)s(oin)m(ter)h(to)g -(reset)g(the)g(terminal.)390 2721 y(This)d(function)h(should)f(undo)g +(reset)g(the)g(terminal.)390 2998 y(This)d(function)h(should)f(undo)g (the)h(e\013ects)h(of)f Fs(rl_prep_term_function)p Ft(.)49 -b(By)35 b(default,)i(this)390 2830 y(is)30 b(set)h(to)g +b(By)35 b(default,)i(this)390 3107 y(is)30 b(set)h(to)g Fs(rl_deprep_terminal)26 b Ft(\(see)31 b(Section)g(2.4.9)i([T)-8 -b(erminal)30 b(Managemen)m(t],)j(page)e(43\).)3371 3017 -y([V)-8 b(ariable])-3598 b Fh(Keymap)54 b(rl_executing_keymap)390 -3126 y Ft(This)35 b(v)-5 b(ariable)37 b(is)f(set)g(to)h(the)f(k)m +b(erminal)30 b(Managemen)m(t],)j(page)e(43\).)3371 3313 +y([V)-8 b(ariable])-3598 b Fh(void)54 b(rl_macro_display_hook)390 +3422 y Ft(If)44 b(set,)k(this)c(p)s(oin)m(ts)h(to)g(a)f(function)g +(that)h Fs(rl_macro_dumper)40 b Ft(will)45 b(call)g(to)g(displa)m(y)g +(a)f(k)m(ey)390 3532 y(sequence)36 b(b)s(ound)e(to)i(a)g(macro.)57 +b(It)36 b(is)g(called)g(with)g(the)f(k)m(ey)i(sequence,)g(the)f +Fs(")p Ft(un)m(translated)p Fs(")390 3641 y Ft(macro)43 +b(v)-5 b(alue)44 b(\(i.e.,)k(with)42 b(bac)m(kslash)i(escap)s(es)f +(included,)i(as)f(when)d(passed)i(to)g Fs(rl_macro_)390 +3751 y(bind)p Ft(\),)25 b(the)g Fs(readable)d Ft(argumen)m(t)j(passed)f +(to)h Fs(rl_macro_dumper)p Ft(,)d(and)i(an)m(y)h(pre\014x)e(to)j +(displa)m(y)390 3861 y(b)s(efore)k(the)h(k)m(ey)g(sequence.)3371 +4066 y([V)-8 b(ariable])-3598 b Fh(Keymap)54 b(rl_executing_keymap)390 +4176 y Ft(This)35 b(v)-5 b(ariable)37 b(is)f(set)g(to)h(the)f(k)m (eymap)h(\(see)g(Section)f(2.4.2)i([Keymaps],)g(page)e(35\))i(in)d -(whic)m(h)390 3236 y(the)c(curren)m(tly)f(executing)i(Readline)f -(function)f(w)m(as)g(found.)3371 3422 y([V)-8 b(ariable])-3598 -b Fh(Keymap)54 b(rl_binding_keymap)390 3532 y Ft(This)35 +(whic)m(h)390 4285 y(the)c(curren)m(tly)f(executing)i(Readline)f +(function)f(w)m(as)g(found.)3371 4491 y([V)-8 b(ariable])-3598 +b Fh(Keymap)54 b(rl_binding_keymap)390 4600 y Ft(This)35 b(v)-5 b(ariable)37 b(is)f(set)g(to)h(the)f(k)m(eymap)h(\(see)g (Section)f(2.4.2)i([Keymaps],)g(page)e(35\))i(in)d(whic)m(h)390 -3641 y(the)c(last)g(k)m(ey)g(binding)e(o)s(ccurred.)3371 -3828 y([V)-8 b(ariable])-3598 b Fh(char)54 b(*)e(rl_executing_macro)390 -3937 y Ft(This)30 b(v)-5 b(ariable)31 b(is)f(set)h(to)g(the)g(text)g -(of)g(an)m(y)f(curren)m(tly-executing)i(macro.)3371 4124 +4710 y(the)c(last)g(k)m(ey)g(binding)e(o)s(ccurred.)3371 +4915 y([V)-8 b(ariable])-3598 b Fh(char)54 b(*)e(rl_executing_macro)390 +5025 y Ft(This)30 b(v)-5 b(ariable)31 b(is)f(set)h(to)g(the)g(text)g +(of)g(an)m(y)f(curren)m(tly-executing)i(macro.)3371 5230 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_executing_key)390 -4233 y Ft(The)30 b(k)m(ey)h(that)g(caused)f(the)h(dispatc)m(h)g(to)g -(the)f(curren)m(tly-executing)i(Readline)f(function.)3371 -4419 y([V)-8 b(ariable])-3598 b Fh(char)54 b(*)e(rl_executing_keyseq) -390 4529 y Ft(The)35 b(full)g(k)m(ey)h(sequence)g(that)g(caused)g(the)g -(dispatc)m(h)f(to)i(the)e(curren)m(tly-executing)i(Readline)390 -4639 y(function.)3371 4825 y([V)-8 b(ariable])-3598 b -Fh(int)53 b(rl_key_sequence_lengt)q(h)390 4934 y Ft(The)30 -b(n)m(um)m(b)s(er)f(of)h(c)m(haracters)i(in)e Fj(rl)p -1617 4934 V 40 w(executing)p 2032 4934 V 41 w(k)m(eyseq)p -Ft(.)3371 5121 y([V)-8 b(ariable])-3598 b Fh(int)53 b -(rl_readline_state)390 5230 y Ft(A)35 b(v)-5 b(ariable)35 -b(with)f(bit)g(v)-5 b(alues)35 b(that)g(encapsulate)h(the)e(curren)m(t) -h(Readline)g(state.)54 b(A)34 b(bit)h(is)f(set)390 5340 -y(with)k(the)g Fs(RL_SETSTATE)c Ft(macro,)41 b(and)c(unset)h(with)f -(the)h Fs(RL_UNSETSTATE)d Ft(macro.)63 b(Use)39 b(the)p +5340 y Ft(The)30 b(k)m(ey)h(that)g(caused)f(the)h(dispatc)m(h)g(to)g +(the)f(curren)m(tly-executing)i(Readline)f(function.)p eop end %%Page: 33 37 TeXDict begin 33 36 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(33)390 -299 y Fs(RL_ISSTATE)34 b Ft(macro)k(to)g(test)g(whether)f(a)h +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(33)3371 +299 y([V)-8 b(ariable])-3598 b Fh(char)54 b(*)e(rl_executing_keyseq)390 +408 y Ft(The)35 b(full)g(k)m(ey)h(sequence)g(that)g(caused)g(the)g +(dispatc)m(h)f(to)i(the)e(curren)m(tly-executing)i(Readline)390 +518 y(function.)3371 695 y([V)-8 b(ariable])-3598 b Fh(int)53 +b(rl_key_sequence_lengt)q(h)390 805 y Ft(The)30 b(n)m(um)m(b)s(er)f(of) +h(c)m(haracters)i(in)e Fj(rl)p 1617 805 28 4 v 40 w(executing)p +2032 805 V 41 w(k)m(eyseq)p Ft(.)3371 982 y([V)-8 b(ariable])-3598 +b Fh(int)53 b(rl_readline_state)390 1092 y Ft(A)35 b(v)-5 +b(ariable)35 b(with)f(bit)g(v)-5 b(alues)35 b(that)g(encapsulate)h(the) +e(curren)m(t)h(Readline)g(state.)54 b(A)34 b(bit)h(is)f(set)390 +1201 y(with)k(the)g Fs(RL_SETSTATE)c Ft(macro,)41 b(and)c(unset)h(with) +f(the)h Fs(RL_UNSETSTATE)d Ft(macro.)63 b(Use)39 b(the)390 +1311 y Fs(RL_ISSTATE)34 b Ft(macro)k(to)g(test)g(whether)f(a)h (particular)f(state)i(bit)e(is)g(set.)62 b(Curren)m(t)36 -b(state)j(bits)390 408 y(include:)390 561 y Fs(RL_STATE_NONE)870 -670 y Ft(Readline)31 b(has)f(not)h(y)m(et)g(b)s(een)f(called,)i(nor)e -(has)g(it)h(b)s(egun)e(to)i(initialize.)390 822 y Fs -(RL_STATE_INITIALIZING)870 932 y Ft(Readline)g(is)f(initializing)j(its) -e(in)m(ternal)g(data)g(structures.)390 1084 y Fs(RL_STATE_INITIALIZED) -870 1194 y Ft(Readline)g(has)f(completed)h(its)g(initialization.)390 -1346 y Fs(RL_STATE_TERMPREPPED)870 1456 y Ft(Readline)e(has)g(mo)s -(di\014ed)e(the)i(terminal)g(mo)s(des)f(to)i(do)e(its)i(o)m(wn)e(input) -g(and)g(redis-)870 1565 y(pla)m(y)-8 b(.)390 1717 y Fs -(RL_STATE_READCMD)870 1827 y Ft(Readline)31 b(is)f(reading)h(a)g -(command)f(from)g(the)g(k)m(eyb)s(oard.)390 1979 y Fs -(RL_STATE_METANEXT)870 2089 y Ft(Readline)h(is)f(reading)h(more)f -(input)g(after)h(reading)f(the)h(meta-pre\014x)f(c)m(haracter.)390 -2241 y Fs(RL_STATE_DISPATCHING)870 2351 y Ft(Readline)h(is)f(dispatc)m -(hing)h(to)g(a)g(command.)390 2503 y Fs(RL_STATE_MOREINPUT)870 -2612 y Ft(Readline)g(is)f(reading)h(more)f(input)g(while)g(executing)i -(an)e(editing)h(command.)390 2765 y Fs(RL_STATE_ISEARCH)870 -2874 y Ft(Readline)g(is)f(p)s(erforming)g(an)g(incremen)m(tal)i -(history)e(searc)m(h.)390 3026 y Fs(RL_STATE_NSEARCH)870 -3136 y Ft(Readline)h(is)f(p)s(erforming)g(a)g(non-incremen)m(tal)i -(history)e(searc)m(h.)390 3288 y Fs(RL_STATE_SEARCH)870 -3398 y Ft(Readline)21 b(is)f(searc)m(hing)i(bac)m(kw)m(ard)e(or)h(forw) -m(ard)e(through)h(the)h(history)f(for)g(a)h(string.)390 -3550 y Fs(RL_STATE_NUMERICARG)870 3660 y Ft(Readline)31 -b(is)f(reading)h(a)g(n)m(umeric)f(argumen)m(t.)390 3812 -y Fs(RL_STATE_MACROINPUT)870 3921 y Ft(Readline)25 b(is)f(curren)m(tly) -g(getting)i(its)f(input)e(from)h(a)g(previously-de\014ned)f(k)m(eyb)s -(oard)870 4031 y(macro.)390 4183 y Fs(RL_STATE_MACRODEF)870 -4293 y Ft(Readline)31 b(is)f(curren)m(tly)h(reading)f(c)m(haracters)i -(de\014ning)e(a)g(k)m(eyb)s(oard)h(macro.)390 4445 y -Fs(RL_STATE_OVERWRITE)870 4555 y Ft(Readline)g(is)f(in)g(o)m(v)m -(erwrite)i(mo)s(de.)390 4707 y Fs(RL_STATE_COMPLETING)870 -4816 y Ft(Readline)f(is)f(p)s(erforming)g(w)m(ord)g(completion.)390 -4969 y Fs(RL_STATE_SIGHANDLER)870 5078 y Ft(Readline)h(is)f(curren)m -(tly)h(executing)g(the)g(readline)g(signal)g(handler.)390 -5230 y Fs(RL_STATE_UNDOING)870 5340 y Ft(Readline)g(is)f(p)s(erforming) -g(an)g(undo.)p eop end +b(state)j(bits)390 1421 y(include:)390 1575 y Fs(RL_STATE_NONE)870 +1685 y Ft(Readline)31 b(has)f(not)h(y)m(et)g(b)s(een)f(called,)i(nor)e +(has)g(it)h(b)s(egun)e(to)i(initialize.)390 1840 y Fs +(RL_STATE_INITIALIZING)870 1949 y Ft(Readline)g(is)f(initializing)j +(its)e(in)m(ternal)g(data)g(structures.)390 2104 y Fs +(RL_STATE_INITIALIZED)870 2213 y Ft(Readline)g(has)f(completed)h(its)g +(initialization.)390 2368 y Fs(RL_STATE_TERMPREPPED)870 +2478 y Ft(Readline)e(has)g(mo)s(di\014ed)e(the)i(terminal)g(mo)s(des)f +(to)i(do)e(its)i(o)m(wn)e(input)g(and)g(redis-)870 2587 +y(pla)m(y)-8 b(.)390 2742 y Fs(RL_STATE_READCMD)870 2852 +y Ft(Readline)31 b(is)f(reading)h(a)g(command)f(from)g(the)g(k)m(eyb)s +(oard.)390 3006 y Fs(RL_STATE_METANEXT)870 3116 y Ft(Readline)h(is)f +(reading)h(more)f(input)g(after)h(reading)f(the)h(meta-pre\014x)f(c)m +(haracter.)390 3271 y Fs(RL_STATE_DISPATCHING)870 3380 +y Ft(Readline)h(is)f(dispatc)m(hing)h(to)g(a)g(command.)390 +3535 y Fs(RL_STATE_MOREINPUT)870 3645 y Ft(Readline)g(is)f(reading)h +(more)f(input)g(while)g(executing)i(an)e(editing)h(command.)390 +3799 y Fs(RL_STATE_ISEARCH)870 3909 y Ft(Readline)g(is)f(p)s(erforming) +g(an)g(incremen)m(tal)i(history)e(searc)m(h.)390 4064 +y Fs(RL_STATE_NSEARCH)870 4173 y Ft(Readline)h(is)f(p)s(erforming)g(a)g +(non-incremen)m(tal)i(history)e(searc)m(h.)390 4328 y +Fs(RL_STATE_SEARCH)870 4437 y Ft(Readline)21 b(is)f(searc)m(hing)i(bac) +m(kw)m(ard)e(or)h(forw)m(ard)e(through)h(the)h(history)f(for)g(a)h +(string.)390 4592 y Fs(RL_STATE_NUMERICARG)870 4702 y +Ft(Readline)31 b(is)f(reading)h(a)g(n)m(umeric)f(argumen)m(t.)390 +4856 y Fs(RL_STATE_MACROINPUT)870 4966 y Ft(Readline)25 +b(is)f(curren)m(tly)g(getting)i(its)f(input)e(from)h(a)g +(previously-de\014ned)f(k)m(eyb)s(oard)870 5076 y(macro.)390 +5230 y Fs(RL_STATE_MACRODEF)870 5340 y Ft(Readline)31 +b(is)f(curren)m(tly)h(reading)f(c)m(haracters)i(de\014ning)e(a)g(k)m +(eyb)s(oard)h(macro.)p eop end %%Page: 34 38 TeXDict begin 34 37 bop 150 -116 a Ft(Chapter)30 b(2:)41 b(Programming)30 b(with)g(GNU)h(Readline)1683 b(34)390 -299 y Fs(RL_STATE_INPUTPENDING)870 408 y Ft(Readline)31 -b(has)f(input)g(p)s(ending)f(due)g(to)i(a)g(call)h(to)f -Fs(rl_execute_next\(\))p Ft(.)390 557 y Fs(RL_STATE_TTYCSAVED)870 -666 y Ft(Readline)g(has)f(sa)m(v)m(ed)i(the)e(v)-5 b(alues)31 -b(of)f(the)h(terminal's)g(sp)s(ecial)g(c)m(haracters.)390 -814 y Fs(RL_STATE_CALLBACK)870 924 y Ft(Readline)44 b(is)f(curren)m -(tly)g(using)f(the)h(alternate)i(\(callbac)m(k\))h(in)m(terface)e -(\(see)g(Sec-)870 1033 y(tion)31 b(2.4.12)h([Alternate)h(In)m -(terface],)f(page)f(46\).)390 1182 y Fs(RL_STATE_VIMOTION)870 -1291 y Ft(Readline)g(is)f(reading)h(the)f(argumen)m(t)h(to)g(a)g(vi-mo) -s(de)g Fs(")p Ft(motion)p Fs(")f Ft(command.)390 1439 -y Fs(RL_STATE_MULTIKEY)870 1549 y Ft(Readline)h(is)f(reading)h(a)g(m)m -(ultiple-k)m(eystrok)m(e)i(command.)390 1697 y Fs(RL_STATE_VICMDONCE) -870 1807 y Ft(Readline)40 b(has)f(en)m(tered)g(vi)g(command)g(\(mo)m(v) -m(emen)m(t\))j(mo)s(de)d(at)h(least)g(one)f(time)870 -1916 y(during)29 b(the)i(curren)m(t)f(call)i(to)f Fs(readline\(\))p -Ft(.)390 2064 y Fs(RL_STATE_DONE)870 2174 y Ft(Readline)d(has)g(read)f -(a)i(k)m(ey)f(sequence)g(b)s(ound)e(to)i Fs(accept-line)d -Ft(and)i(is)h(ab)s(out)f(to)870 2284 y(return)i(the)i(line)g(to)g(the)f -(caller.)390 2432 y Fs(RL_STATE_TIMEOUT)870 2541 y Ft(Readline)44 +299 y Fs(RL_STATE_OVERWRITE)870 408 y Ft(Readline)31 +b(is)f(in)g(o)m(v)m(erwrite)i(mo)s(de.)390 576 y Fs +(RL_STATE_COMPLETING)870 686 y Ft(Readline)f(is)f(p)s(erforming)g(w)m +(ord)g(completion.)390 853 y Fs(RL_STATE_SIGHANDLER)870 +963 y Ft(Readline)h(is)f(curren)m(tly)h(executing)g(the)g(readline)g +(signal)g(handler.)390 1130 y Fs(RL_STATE_UNDOING)870 +1240 y Ft(Readline)g(is)f(p)s(erforming)g(an)g(undo.)390 +1407 y Fs(RL_STATE_INPUTPENDING)870 1517 y Ft(Readline)h(has)f(input)g +(p)s(ending)f(due)g(to)i(a)g(call)h(to)f Fs(rl_execute_next\(\))p +Ft(.)390 1684 y Fs(RL_STATE_TTYCSAVED)870 1794 y Ft(Readline)g(has)f +(sa)m(v)m(ed)i(the)e(v)-5 b(alues)31 b(of)f(the)h(terminal's)g(sp)s +(ecial)g(c)m(haracters.)390 1961 y Fs(RL_STATE_CALLBACK)870 +2071 y Ft(Readline)44 b(is)f(curren)m(tly)g(using)f(the)h(alternate)i +(\(callbac)m(k\))h(in)m(terface)e(\(see)g(Sec-)870 2181 +y(tion)31 b(2.4.12)h([Alternate)h(In)m(terface],)f(page)f(46\).)390 +2348 y Fs(RL_STATE_VIMOTION)870 2458 y Ft(Readline)g(is)f(reading)h +(the)f(argumen)m(t)h(to)g(a)g(vi-mo)s(de)g Fs(")p Ft(motion)p +Fs(")f Ft(command.)390 2625 y Fs(RL_STATE_MULTIKEY)870 +2735 y Ft(Readline)h(is)f(reading)h(a)g(m)m(ultiple-k)m(eystrok)m(e)i +(command.)390 2902 y Fs(RL_STATE_VICMDONCE)870 3012 y +Ft(Readline)40 b(has)f(en)m(tered)g(vi)g(command)g(\(mo)m(v)m(emen)m +(t\))j(mo)s(de)d(at)h(least)g(one)f(time)870 3121 y(during)29 +b(the)i(curren)m(t)f(call)i(to)f Fs(readline\(\))p Ft(.)390 +3289 y Fs(RL_STATE_DONE)870 3399 y Ft(Readline)d(has)g(read)f(a)i(k)m +(ey)f(sequence)g(b)s(ound)e(to)i Fs(accept-line)d Ft(and)i(is)h(ab)s +(out)f(to)870 3508 y(return)i(the)i(line)g(to)g(the)f(caller.)390 +3676 y Fs(RL_STATE_TIMEOUT)870 3785 y Ft(Readline)44 b(has)f(timed)g(out)h(\(it)g(did)f(not)g(receiv)m(e)i(a)f(line)f(or)h -(sp)s(eci\014ed)e(n)m(um)m(b)s(er)870 2651 y(of)36 b(c)m(haracters)i(b) +(sp)s(eci\014ed)e(n)m(um)m(b)s(er)870 3895 y(of)36 b(c)m(haracters)i(b) s(efore)d(the)i(timeout)g(duration)e(sp)s(eci\014ed)h(b)m(y)g -Fs(rl_set_timeout)870 2760 y Ft(elapsed\))31 b(and)f(is)g(returning)g -(that)h(status)f(to)h(the)g(caller.)390 2909 y Fs(RL_STATE_EOF)870 -3018 y Ft(Readline)39 b(has)f(read)h(an)f(EOF)h(c)m(haracter)h(\(e.g.,) +Fs(rl_set_timeout)870 4004 y Ft(elapsed\))31 b(and)f(is)g(returning)g +(that)h(status)f(to)h(the)g(caller.)390 4172 y Fs(RL_STATE_EOF)870 +4281 y Ft(Readline)39 b(has)f(read)h(an)f(EOF)h(c)m(haracter)h(\(e.g.,) i(the)d(stt)m(y)g(`)p Fs(EOF)p Ft(')f(c)m(haracter\))j(or)870 -3128 y(encoun)m(tered)k(a)h(read)e(error)h(and)f(is)h(ab)s(out)g(to)g -(return)f(a)h(NULL)g(line)g(to)h(the)870 3237 y(caller.)3371 -3405 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_explicit_arg)390 -3514 y Ft(Set)39 b(to)g(a)h(non-zero)f(v)-5 b(alue)39 +4391 y(encoun)m(tered)k(a)h(read)e(error)h(and)f(is)h(ab)s(out)g(to)g +(return)f(a)h(NULL)g(line)g(to)h(the)870 4501 y(caller.)3371 +4701 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_explicit_arg)390 +4811 y Ft(Set)39 b(to)g(a)h(non-zero)f(v)-5 b(alue)39 b(if)g(an)g(explicit)h(n)m(umeric)e(argumen)m(t)i(w)m(as)f(sp)s -(eci\014ed)f(b)m(y)g(the)h(user.)390 3624 y(Only)30 b(v)-5 +(eci\014ed)f(b)m(y)g(the)h(user.)390 4920 y(Only)30 b(v)-5 b(alid)30 b(in)h(a)f(bindable)g(command)g(function.)3371 -3791 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_numeric_arg)390 -3901 y Ft(Set)45 b(to)h(the)g(v)-5 b(alue)46 b(of)f(an)m(y)h(n)m +5121 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_numeric_arg)390 +5230 y Ft(Set)45 b(to)h(the)g(v)-5 b(alue)46 b(of)f(an)m(y)h(n)m (umeric)f(argumen)m(t)h(explicitly)h(sp)s(eci\014ed)d(b)m(y)h(the)h -(user)e(b)s(efore)390 4010 y(executing)27 b(the)f(curren)m(t)g +(user)e(b)s(efore)390 5340 y(executing)27 b(the)f(curren)m(t)g (Readline)h(function.)38 b(Only)26 b(v)-5 b(alid)26 b(in)g(a)g -(bindable)f(command)h(function.)3371 4178 y([V)-8 b(ariable])-3598 -b Fh(int)53 b(rl_editing_mode)390 4287 y Ft(Set)25 b(to)h(a)g(v)-5 -b(alue)25 b(denoting)h(Readline's)f(curren)m(t)g(editing)h(mo)s(de.)39 -b(A)25 b(v)-5 b(alue)25 b(of)h Fj(1)32 b Ft(means)25 -b(Readline)390 4397 y(is)30 b(curren)m(tly)h(in)f(emacs)h(mo)s(de;)f -Fj(0)38 b Ft(means)31 b(that)f(vi)h(mo)s(de)f(is)g(activ)m(e.)150 -4626 y Fr(2.4)68 b(Readline)47 b(Con)l(v)l(enience)f(F)-11 -b(unctions)150 4845 y Fi(2.4.1)63 b(Naming)41 b(a)g(F)-10 -b(unction)150 4992 y Ft(The)24 b(user)h(can)g(dynamically)g(c)m(hange)h -(the)f(bindings)f(of)h(k)m(eys)h(while)e(using)h(Readline.)39 -b(This)24 b(is)h(done)g(b)m(y)150 5102 y(represen)m(ting)30 +(bindable)f(command)h(function.)p eop end +%%Page: 35 39 +TeXDict begin 35 38 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(35)3371 +299 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_editing_mode)390 +408 y Ft(Set)25 b(to)h(a)g(v)-5 b(alue)25 b(denoting)h(Readline's)f +(curren)m(t)g(editing)h(mo)s(de.)39 b(A)25 b(v)-5 b(alue)25 +b(of)h Fj(1)32 b Ft(means)25 b(Readline)390 518 y(is)30 +b(curren)m(tly)h(in)f(emacs)h(mo)s(de;)f Fj(0)38 b Ft(means)31 +b(that)f(vi)h(mo)s(de)f(is)g(activ)m(e.)150 759 y Fr(2.4)68 +b(Readline)47 b(Con)l(v)l(enience)f(F)-11 b(unctions)150 +983 y Fi(2.4.1)63 b(Naming)41 b(a)g(F)-10 b(unction)150 +1130 y Ft(The)24 b(user)h(can)g(dynamically)g(c)m(hange)h(the)f +(bindings)f(of)h(k)m(eys)h(while)e(using)h(Readline.)39 +b(This)24 b(is)h(done)g(b)m(y)150 1240 y(represen)m(ting)30 b(the)h(function)f(with)g(a)g(descriptiv)m(e)h(name.)41 b(The)30 b(user)f(is)i(able)f(to)h(t)m(yp)s(e)g(the)f(descriptiv)m(e) -150 5211 y(name)g(when)g(referring)g(to)h(the)f(function.)41 +150 1349 y(name)g(when)g(referring)g(to)h(the)f(function.)41 b(Th)m(us,)29 b(in)h(an)h(init)f(\014le,)h(one)g(migh)m(t)g(\014nd)390 -5340 y Fs(Meta-Rubout:)92 b(backward-kill-word)p eop -end -%%Page: 35 39 -TeXDict begin 35 38 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(35)275 -299 y(This)84 b(binds)h(the)g(k)m(eystrok)m(e)j Fs(Meta-Rubout)82 +1484 y Fs(Meta-Rubout:)92 b(backward-kill-word)275 1619 +y Ft(This)84 b(binds)h(the)g(k)m(eystrok)m(e)j Fs(Meta-Rubout)82 b Ft(to)87 b(the)e(function)h Fk(descriptively)94 b Ft(named)150 -408 y Fs(backward-kill-word)p Ft(.)63 b(Y)-8 b(ou,)43 +1728 y Fs(backward-kill-word)p Ft(.)63 b(Y)-8 b(ou,)43 b(as)d(the)g(programmer,)i(should)c(bind)g(the)i(functions)f(y)m(ou)h -(write)g(to)150 518 y(descriptiv)m(e)31 b(names)g(as)f(w)m(ell.)42 +(write)g(to)150 1838 y(descriptiv)m(e)31 b(names)g(as)f(w)m(ell.)42 b(Readline)31 b(pro)m(vides)f(a)h(function)f(for)g(doing)h(that:)3350 -706 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_add_defun)c -Fg(\()p Ff(const)34 b(c)m(har)g(*name,)f(rl)p 1964 706 -30 5 v 43 w(command)p 2427 706 V 45 w(func)p 2656 706 -V 45 w(t)g(*function,)565 815 y(in)m(t)g(k)m(ey)p Fg(\))390 -925 y Ft(Add)h Fj(name)41 b Ft(to)36 b(the)f(list)h(of)g(named)e +2023 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_add_defun)c +Fg(\()p Ff(const)34 b(c)m(har)g(*name,)f(rl)p 1964 2023 +30 5 v 43 w(command)p 2427 2023 V 45 w(func)p 2656 2023 +V 45 w(t)g(*function,)565 2132 y(in)m(t)g(k)m(ey)p Fg(\))390 +2242 y Ft(Add)h Fj(name)41 b Ft(to)36 b(the)f(list)h(of)g(named)e (functions.)55 b(Mak)m(e)37 b Fj(function)e Ft(b)s(e)g(the)g(function)g -(that)h(gets)390 1034 y(called.)42 b(If)30 b Fj(k)m(ey)39 +(that)h(gets)390 2351 y(called.)42 b(If)30 b Fj(k)m(ey)39 b Ft(is)30 b(not)h(-1,)g(then)f(bind)f(it)i(to)g Fj(function)f -Ft(using)g Fs(rl_bind_key\(\))p Ft(.)275 1222 y(Using)g(this)g +Ft(using)g Fs(rl_bind_key\(\))p Ft(.)275 2536 y(Using)g(this)g (function)g(alone)h(is)f(su\016cien)m(t)g(for)g(most)h(applications.)42 -b(It)30 b(is)g(the)g(recommended)g(w)m(a)m(y)150 1332 +b(It)30 b(is)g(the)g(recommended)g(w)m(a)m(y)150 2646 y(to)e(add)e(a)h(few)g(functions)g(to)g(the)g(default)h(functions)e (that)i(Readline)f(has)g(built)g(in.)39 b(If)26 b(y)m(ou)i(need)e(to)i -(do)150 1441 y(something)34 b(other)g(than)f(adding)h(a)g(function)f +(do)150 2755 y(something)34 b(other)g(than)f(adding)h(a)g(function)f (to)h(Readline,)i(y)m(ou)e(ma)m(y)g(need)f(to)i(use)e(the)h(underlying) -150 1551 y(functions)c(describ)s(ed)f(b)s(elo)m(w.)150 -1752 y Fi(2.4.2)63 b(Selecting)41 b(a)f(Keymap)150 1899 +150 2865 y(functions)c(describ)s(ed)f(b)s(elo)m(w.)150 +3064 y Fi(2.4.2)63 b(Selecting)41 b(a)f(Keymap)150 3211 y Ft(Key)f(bindings)e(tak)m(e)j(place)g(on)f(a)g Fj(k)m(eymap)p Ft(.)66 b(The)38 b(k)m(eymap)h(is)g(the)g(asso)s(ciation)h(b)s(et)m(w)m -(een)f(the)g(k)m(eys)150 2008 y(that)29 b(the)g(user)e(t)m(yp)s(es)i +(een)f(the)g(k)m(eys)150 3321 y(that)29 b(the)g(user)e(t)m(yp)s(es)i (and)f(the)g(functions)g(that)h(get)h(run.)39 b(Y)-8 b(ou)29 b(can)f(mak)m(e)i(y)m(our)e(o)m(wn)h(k)m(eymaps,)g(cop)m(y)150 -2118 y(existing)i(k)m(eymaps,)g(and)f(tell)i(Readline)f(whic)m(h)f(k)m -(eymap)h(to)g(use.)3350 2305 y([F)-8 b(unction])-3599 +3430 y(existing)i(k)m(eymaps,)g(and)f(tell)i(Readline)f(whic)m(h)f(k)m +(eymap)h(to)g(use.)3350 3615 y([F)-8 b(unction])-3599 b Fh(Keymap)54 b(rl_make_bare_keymap)d Fg(\()p Ff(v)m(oid)p -Fg(\))390 2415 y Ft(Returns)23 b(a)i(new,)g(empt)m(y)f(k)m(eymap.)40 +Fg(\))390 3725 y Ft(Returns)23 b(a)i(new,)g(empt)m(y)f(k)m(eymap.)40 b(The)23 b(space)i(for)f(the)g(k)m(eymap)h(is)f(allo)s(cated)i(with)e -Fs(malloc\(\))p Ft(;)390 2524 y(the)31 b(caller)g(should)f(free)g(it)h +Fs(malloc\(\))p Ft(;)390 3834 y(the)31 b(caller)g(should)f(free)g(it)h (b)m(y)f(calling)i Fs(rl_free_keymap\(\))26 b Ft(when)j(done.)3350 -2712 y([F)-8 b(unction])-3599 b Fh(Keymap)54 b(rl_copy_keymap)c -Fg(\()p Ff(Keymap)34 b(map)p Fg(\))390 2822 y Ft(Return)c(a)g(new)g(k)m +4019 y([F)-8 b(unction])-3599 b Fh(Keymap)54 b(rl_copy_keymap)c +Fg(\()p Ff(Keymap)34 b(map)p Fg(\))390 4128 y Ft(Return)c(a)g(new)g(k)m (eymap)h(whic)m(h)f(is)h(a)f(cop)m(y)h(of)g Fj(map)p -Ft(.)3350 3009 y([F)-8 b(unction])-3599 b Fh(Keymap)54 -b(rl_make_keymap)c Fg(\()p Ff(v)m(oid)p Fg(\))390 3119 +Ft(.)3350 4313 y([F)-8 b(unction])-3599 b Fh(Keymap)54 +b(rl_make_keymap)c Fg(\()p Ff(v)m(oid)p Fg(\))390 4423 y Ft(Return)31 b(a)g(new)g(k)m(eymap)h(with)f(the)h(prin)m(ting)f(c)m -(haracters)i(b)s(ound)c(to)j(rl)p 2909 3119 28 4 v 40 -w(insert,)g(the)g(lo)m(w)m(ercase)390 3228 y(Meta)24 +(haracters)i(b)s(ound)c(to)j(rl)p 2909 4423 28 4 v 40 +w(insert,)g(the)g(lo)m(w)m(ercase)390 4532 y(Meta)24 b(c)m(haracters)g(b)s(ound)d(to)i(run)e(their)i(equiv)-5 b(alen)m(ts,)25 b(and)d(the)h(Meta)h(digits)f(b)s(ound)e(to)i(pro)s -(duce)390 3338 y(n)m(umeric)30 b(argumen)m(ts.)3350 3525 +(duce)390 4642 y(n)m(umeric)30 b(argumen)m(ts.)3350 4827 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_discard_keymap)c -Fg(\()p Ff(Keymap)34 b(k)m(eymap)p Fg(\))390 3635 y Ft(F)-8 +Fg(\()p Ff(Keymap)34 b(k)m(eymap)p Fg(\))390 4936 y Ft(F)-8 b(ree)30 b(the)g(storage)h(asso)s(ciated)g(with)e(the)g(data)h(in)f Fj(k)m(eymap)p Ft(.)41 b(The)29 b(caller)h(should)f(free)g -Fj(k)m(eymap)p Ft(.)3350 3823 y([F)-8 b(unction])-3599 +Fj(k)m(eymap)p Ft(.)3350 5121 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_free_keymap)49 b Fg(\()p Ff(Keymap)34 -b(k)m(eymap)p Fg(\))390 3932 y Ft(F)-8 b(ree)32 b(all)g(storage)g(asso) +b(k)m(eymap)p Fg(\))390 5230 y Ft(F)-8 b(ree)32 b(all)g(storage)g(asso) s(ciated)g(with)f Fj(k)m(eymap)p Ft(.)42 b(This)30 b(calls)i Fs(rl_discard_keymap)26 b Ft(to)32 b(free)f(sub-)390 -4042 y(ordindate)f(k)m(eymaps)h(and)f(macros.)3350 4229 -y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_empty_keymap)d -Fg(\()p Ff(Keymap)34 b(k)m(eymap)p Fg(\))390 4339 y Ft(Return)c +5340 y(ordindate)f(k)m(eymaps)h(and)f(macros.)p eop end +%%Page: 36 40 +TeXDict begin 36 39 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(36)3350 +299 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_empty_keymap)d +Fg(\()p Ff(Keymap)34 b(k)m(eymap)p Fg(\))390 408 y Ft(Return)c (non-zero)h(if)g(there)g(are)g(no)f(k)m(eys)i(b)s(ound)c(to)k (functions)e(in)g Fj(k)m(eymap)s Ft(;)i(zero)f(if)g(there)g(are)390 -4449 y(an)m(y)g(k)m(eys)g(b)s(ound.)275 4636 y(Readline)45 +518 y(an)m(y)g(k)m(eys)g(b)s(ound.)275 710 y(Readline)45 b(has)g(sev)m(eral)i(in)m(ternal)f(k)m(eymaps.)86 b(These)45 b(functions)g(allo)m(w)h(y)m(ou)g(to)g(c)m(hange)g(whic)m(h)150 -4746 y(k)m(eymap)31 b(is)f(activ)m(e.)3350 4933 y([F)-8 +820 y(k)m(eymap)31 b(is)f(activ)m(e.)3350 1012 y([F)-8 b(unction])-3599 b Fh(Keymap)54 b(rl_get_keymap)c Fg(\()p -Ff(v)m(oid)p Fg(\))390 5043 y Ft(Returns)29 b(the)i(curren)m(tly)f -(activ)m(e)j(k)m(eymap.)3350 5230 y([F)-8 b(unction])-3599 +Ff(v)m(oid)p Fg(\))390 1122 y Ft(Returns)29 b(the)i(curren)m(tly)f +(activ)m(e)j(k)m(eymap.)3350 1314 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_set_keymap)49 b Fg(\()p Ff(Keymap)34 -b(k)m(eymap)p Fg(\))390 5340 y Ft(Mak)m(es)e Fj(k)m(eymap)h -Ft(the)e(curren)m(tly)f(activ)m(e)j(k)m(eymap.)p eop -end -%%Page: 36 40 -TeXDict begin 36 39 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(36)3350 -299 y([F)-8 b(unction])-3599 b Fh(Keymap)54 b(rl_get_keymap_by_name)e -Fg(\()p Ff(const)34 b(c)m(har)g(*name)p Fg(\))390 408 +b(k)m(eymap)p Fg(\))390 1423 y Ft(Mak)m(es)e Fj(k)m(eymap)h +Ft(the)e(curren)m(tly)f(activ)m(e)j(k)m(eymap.)3350 1616 +y([F)-8 b(unction])-3599 b Fh(Keymap)54 b(rl_get_keymap_by_name)e +Fg(\()p Ff(const)34 b(c)m(har)g(*name)p Fg(\))390 1725 y Ft(Return)e(the)i(k)m(eymap)f(matc)m(hing)i Fj(name)p Ft(.)49 b Fj(name)38 b Ft(is)c(one)f(whic)m(h)g(w)m(ould)g(b)s(e)f -(supplied)g(in)h(a)h Fs(set)390 518 y(keymap)29 b Ft(inputrc)g(line)i +(supplied)g(in)h(a)h Fs(set)390 1835 y(keymap)29 b Ft(inputrc)g(line)i (\(see)g(Section)g(1.3)h([Readline)f(Init)f(File],)i(page)f(4\).)3350 -692 y([F)-8 b(unction])-3599 b Fh(char)54 b(*)e(rl_get_keymap_name)f -Fg(\()p Ff(Keymap)34 b(k)m(eymap)p Fg(\))390 801 y Ft(Return)e(the)i +2027 y([F)-8 b(unction])-3599 b Fh(char)54 b(*)e(rl_get_keymap_name)f +Fg(\()p Ff(Keymap)34 b(k)m(eymap)p Fg(\))390 2137 y Ft(Return)e(the)i (name)f(matc)m(hing)h Fj(k)m(eymap)p Ft(.)50 b Fj(name)38 b Ft(is)c(one)f(whic)m(h)g(w)m(ould)g(b)s(e)f(supplied)g(in)h(a)h -Fs(set)390 911 y(keymap)29 b Ft(inputrc)g(line)i(\(see)g(Section)g(1.3) -h([Readline)f(Init)f(File],)i(page)f(4\).)3350 1085 y([F)-8 -b(unction])-3599 b Fh(int)53 b(rl_set_keymap_name)e Fg(\()p -Ff(const)34 b(c)m(har)g(*name,)f(Keymap)h(k)m(eymap)p -Fg(\))390 1194 y Ft(Set)g(the)f(name)h(of)g Fj(k)m(eymap)p +Fs(set)390 2246 y(keymap)29 b Ft(inputrc)g(line)i(\(see)g(Section)g +(1.3)h([Readline)f(Init)f(File],)i(page)f(4\).)3350 2439 +y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_set_keymap_name)e +Fg(\()p Ff(const)34 b(c)m(har)g(*name,)f(Keymap)h(k)m(eymap)p +Fg(\))390 2548 y Ft(Set)g(the)f(name)h(of)g Fj(k)m(eymap)p Ft(.)50 b(This)33 b(name)h(will)f(then)h(b)s(e)e Fs(")p Ft(registered)p Fs(")i Ft(and)f(a)m(v)-5 b(ailable)36 -b(for)d(use)390 1304 y(in)i(a)g Fs(set)29 b(keymap)k +b(for)d(use)390 2658 y(in)i(a)g Fs(set)29 b(keymap)k Ft(inputrc)h(directiv)m(e)j(see)e(Section)h(1.3)g([Readline)g(Init)e -(File],)k(page)e(4\).)54 b(The)390 1414 y Fj(name)27 +(File],)k(page)e(4\).)54 b(The)390 2767 y Fj(name)27 b Ft(ma)m(y)c(not)g(b)s(e)e(one)i(of)f(Readline's)h(builtin)f(k)m (eymap)g(names;)j(y)m(ou)e(ma)m(y)g(not)f(add)g(a)g(di\013eren)m(t)390 -1523 y(name)36 b(for)g(one)g(of)g(Readline's)h(builtin)e(k)m(eymaps.)58 +2877 y(name)36 b(for)g(one)g(of)g(Readline's)h(builtin)e(k)m(eymaps.)58 b(Y)-8 b(ou)37 b(ma)m(y)f(replace)h(the)f(name)g(asso)s(ciated)390 -1633 y(with)31 b(a)g(giv)m(en)h(k)m(eymap)g(b)m(y)f(calling)h(this)f +2986 y(with)31 b(a)g(giv)m(en)h(k)m(eymap)g(b)m(y)f(calling)h(this)f (function)g(more)h(than)e(once)i(with)f(the)g(same)h -Fj(k)m(eymap)390 1742 y Ft(argumen)m(t.)50 b(Y)-8 b(ou)34 +Fj(k)m(eymap)390 3096 y Ft(argumen)m(t.)50 b(Y)-8 b(ou)34 b(ma)m(y)h(asso)s(ciate)g(a)f(registered)g Fj(name)39 b Ft(with)33 b(a)h(new)f(k)m(eymap)h(b)m(y)f(calling)i(this)390 -1852 y(function)c(more)h(than)f(once)i(with)e(the)h(same)g +3206 y(function)c(more)h(than)f(once)i(with)e(the)h(same)g Fj(name)k Ft(argumen)m(t.)45 b(There)31 b(is)h(no)g(w)m(a)m(y)g(to)g -(remo)m(v)m(e)390 1962 y(a)k(named)e(k)m(eymap)i(once)g(the)f(name)g +(remo)m(v)m(e)390 3315 y(a)k(named)e(k)m(eymap)i(once)g(the)f(name)g (has)g(b)s(een)g(registered.)56 b(Readline)36 b(will)f(mak)m(e)h(a)g -(cop)m(y)g(of)390 2071 y Fj(name)p Ft(.)41 b(The)30 b(return)f(v)-5 +(cop)m(y)g(of)390 3425 y Fj(name)p Ft(.)41 b(The)30 b(return)f(v)-5 b(alue)31 b(is)g(greater)g(than)g(zero)g(unless)f Fj(name)35 -b Ft(is)c(one)g(of)f(Readline's)h(builtin)390 2181 y(k)m(eymap)g(names) +b Ft(is)c(one)g(of)f(Readline's)h(builtin)390 3534 y(k)m(eymap)g(names) f(or)h Fj(k)m(eymap)i Ft(is)e(one)f(of)h(Readline's)g(builtin)f(k)m -(eymaps.)150 2373 y Fi(2.4.3)63 b(Binding)42 b(Keys)150 -2520 y Ft(Key)34 b(sequences)g(are)h(asso)s(ciate)h(with)e(functions)f +(eymaps.)150 3738 y Fi(2.4.3)63 b(Binding)42 b(Keys)150 +3885 y Ft(Key)34 b(sequences)g(are)h(asso)s(ciate)h(with)e(functions)f (through)h(the)g(k)m(eymap.)52 b(Readline)35 b(has)f(sev)m(eral)h(in-) -150 2629 y(ternal)30 b(k)m(eymaps:)40 b Fs(emacs_standard_keymap)p +150 3994 y(ternal)30 b(k)m(eymaps:)40 b Fs(emacs_standard_keymap)p Ft(,)24 b Fs(emacs_meta_keymap)p Ft(,)h Fs(emacs_ctlx_keymap)p -Ft(,)g Fs(vi_)150 2739 y(movement_keymap)p Ft(,)41 b(and)h +Ft(,)g Fs(vi_)150 4104 y(movement_keymap)p Ft(,)41 b(and)h Fs(vi_insertion_keymap)p Ft(.)71 b Fs(emacs_standard_keymap)37 -b Ft(is)42 b(the)g(default,)150 2849 y(and)30 b(the)g(examples)h(in)f -(this)h(man)m(ual)f(assume)g(that.)275 2980 y(Since)d +b Ft(is)42 b(the)g(default,)150 4213 y(and)30 b(the)g(examples)h(in)f +(this)h(man)m(ual)f(assume)g(that.)275 4352 y(Since)d Fs(readline\(\))e Ft(installs)j(a)g(set)g(of)g(default)g(k)m(ey)g (bindings)f(the)h(\014rst)e(time)j(it)f(is)f(called,)j(there)e(is)150 -3089 y(alw)m(a)m(ys)34 b(the)f(danger)f(that)i(a)f(custom)g(binding)e +4461 y(alw)m(a)m(ys)34 b(the)f(danger)f(that)i(a)f(custom)g(binding)e (installed)j(b)s(efore)e(the)h(\014rst)e(call)j(to)g -Fs(readline\(\))c Ft(will)150 3199 y(b)s(e)25 b(o)m(v)m(erridden.)39 +Fs(readline\(\))c Ft(will)150 4571 y(b)s(e)25 b(o)m(v)m(erridden.)39 b(An)26 b(alternate)h(mec)m(hanism)f(is)g(to)g(install)h(custom)f(k)m -(ey)g(bindings)f(in)g(an)h(initialization)150 3308 y(function)37 +(ey)g(bindings)f(in)g(an)h(initialization)150 4681 y(function)37 b(assigned)g(to)h(the)f Fs(rl_startup_hook)c Ft(v)-5 b(ariable)38 b(\(see)g(Section)g(2.3)g([Readline)g(V)-8 -b(ariables],)150 3418 y(page)31 b(29\).)275 3549 y(These)f(functions)g -(manage)h(k)m(ey)g(bindings.)3350 3723 y([F)-8 b(unction])-3599 +b(ariables],)150 4790 y(page)31 b(29\).)275 4929 y(These)f(functions)g +(manage)h(k)m(ey)g(bindings.)3350 5121 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_bind_key)c Fg(\()p Ff(in)m(t)34 b(k)m(ey)-8 -b(,)32 b(rl)p 1441 3723 30 5 v 43 w(command)p 1904 3723 -V 45 w(func)p 2133 3723 V 45 w(t)h(*function)p Fg(\))390 -3832 y Ft(Binds)f Fj(k)m(ey)42 b Ft(to)34 b Fj(function)e +b(,)32 b(rl)p 1441 5121 30 5 v 43 w(command)p 1904 5121 +V 45 w(func)p 2133 5121 V 45 w(t)h(*function)p Fg(\))390 +5230 y Ft(Binds)f Fj(k)m(ey)42 b Ft(to)34 b Fj(function)e Ft(in)h(the)g(curren)m(tly)g(activ)m(e)i(k)m(eymap.)49 -b(Returns)32 b(non-zero)i(in)f(the)g(case)390 3942 y(of)e(an)f(in)m(v) --5 b(alid)31 b Fj(k)m(ey)p Ft(.)3350 4116 y([F)-8 b(unction])-3599 -b Fh(int)53 b(rl_bind_key_in_map)e Fg(\()p Ff(in)m(t)34 -b(k)m(ey)-8 b(,)32 b(rl)p 1807 4116 V 43 w(command)p -2270 4116 V 45 w(func)p 2499 4116 V 45 w(t)h(*function,)565 -4225 y(Keymap)h(map)p Fg(\))390 4335 y Ft(Bind)c Fj(k)m(ey)39 -b Ft(to)31 b Fj(function)f Ft(in)g Fj(map)p Ft(.)40 b(Returns)30 -b(non-zero)h(in)f(the)h(case)g(of)f(an)h(in)m(v)-5 b(alid)31 -b Fj(k)m(ey)p Ft(.)3350 4509 y([F)-8 b(unction])-3599 -b Fh(int)53 b(rl_bind_key_if_unboun)q(d)e Fg(\()p Ff(in)m(t)34 -b(k)m(ey)-8 b(,)32 b(rl)p 2016 4509 V 44 w(command)p -2480 4509 V 44 w(func)p 2708 4509 V 45 w(t)565 4618 y(*function)p -Fg(\))390 4728 y Ft(Binds)43 b Fj(k)m(ey)53 b Ft(to)45 -b Fj(function)e Ft(if)h(it)h(is)f(not)g(already)g(b)s(ound)e(in)i(the)g -(curren)m(tly)g(activ)m(e)i(k)m(eymap.)390 4837 y(Returns)29 -b(non-zero)i(in)f(the)h(case)g(of)g(an)f(in)m(v)-5 b(alid)31 -b Fj(k)m(ey)39 b Ft(or)30 b(if)h Fj(k)m(ey)39 b Ft(is)30 -b(already)h(b)s(ound.)3350 5011 y([F)-8 b(unction])-3599 -b Fh(int)53 b(rl_bind_key_if_unboun)q(d_in)q(_ma)q(p)e -Fg(\()p Ff(in)m(t)34 b(k)m(ey)-8 b(,)32 b(rl)p 2382 5011 -V 44 w(command)p 2846 5011 V 44 w(func)p 3074 5011 V -46 w(t)565 5121 y(*function,)i(Keymap)g(map)p Fg(\))390 -5230 y Ft(Binds)27 b Fj(k)m(ey)36 b Ft(to)28 b Fj(function)f -Ft(if)g(it)h(is)f(not)h(already)g(b)s(ound)d(in)i Fj(map)p -Ft(.)39 b(Returns)27 b(non-zero)g(in)g(the)h(case)390 -5340 y(of)j(an)f(in)m(v)-5 b(alid)31 b Fj(k)m(ey)39 b -Ft(or)30 b(if)g Fj(k)m(ey)39 b Ft(is)31 b(already)g(b)s(ound.)p -eop end +b(Returns)32 b(non-zero)i(in)f(the)g(case)390 5340 y(of)e(an)f(in)m(v) +-5 b(alid)31 b Fj(k)m(ey)p Ft(.)p eop end %%Page: 37 41 TeXDict begin 37 40 bop 150 -116 a Ft(Chapter)30 b(2:)41 b(Programming)30 b(with)g(GNU)h(Readline)1683 b(37)3350 -299 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_unbind_key)d -Fg(\()p Ff(in)m(t)33 b(k)m(ey)p Fg(\))390 408 y Ft(Bind)j +299 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_bind_key_in_map)e +Fg(\()p Ff(in)m(t)34 b(k)m(ey)-8 b(,)32 b(rl)p 1807 299 +30 5 v 43 w(command)p 2270 299 V 45 w(func)p 2499 299 +V 45 w(t)h(*function,)565 408 y(Keymap)h(map)p Fg(\))390 +518 y Ft(Bind)c Fj(k)m(ey)39 b Ft(to)31 b Fj(function)f +Ft(in)g Fj(map)p Ft(.)40 b(Returns)30 b(non-zero)h(in)f(the)h(case)g +(of)f(an)h(in)m(v)-5 b(alid)31 b Fj(k)m(ey)p Ft(.)3350 +715 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_bind_key_if_unboun)q(d)e +Fg(\()p Ff(in)m(t)34 b(k)m(ey)-8 b(,)32 b(rl)p 2016 715 +V 44 w(command)p 2480 715 V 44 w(func)p 2708 715 V 45 +w(t)565 825 y(*function)p Fg(\))390 934 y Ft(Binds)43 +b Fj(k)m(ey)53 b Ft(to)45 b Fj(function)e Ft(if)h(it)h(is)f(not)g +(already)g(b)s(ound)e(in)i(the)g(curren)m(tly)g(activ)m(e)i(k)m(eymap.) +390 1044 y(Returns)29 b(non-zero)i(in)f(the)h(case)g(of)g(an)f(in)m(v) +-5 b(alid)31 b Fj(k)m(ey)39 b Ft(or)30 b(if)h Fj(k)m(ey)39 +b Ft(is)30 b(already)h(b)s(ound.)3350 1241 y([F)-8 b(unction])-3599 +b Fh(int)53 b(rl_bind_key_if_unboun)q(d_in)q(_ma)q(p)e +Fg(\()p Ff(in)m(t)34 b(k)m(ey)-8 b(,)32 b(rl)p 2382 1241 +V 44 w(command)p 2846 1241 V 44 w(func)p 3074 1241 V +46 w(t)565 1351 y(*function,)i(Keymap)g(map)p Fg(\))390 +1461 y Ft(Binds)27 b Fj(k)m(ey)36 b Ft(to)28 b Fj(function)f +Ft(if)g(it)h(is)f(not)h(already)g(b)s(ound)d(in)i Fj(map)p +Ft(.)39 b(Returns)27 b(non-zero)g(in)g(the)h(case)390 +1570 y(of)j(an)f(in)m(v)-5 b(alid)31 b Fj(k)m(ey)39 b +Ft(or)30 b(if)g Fj(k)m(ey)39 b Ft(is)31 b(already)g(b)s(ound.)3350 +1767 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_unbind_key)d +Fg(\()p Ff(in)m(t)33 b(k)m(ey)p Fg(\))390 1877 y Ft(Bind)j Fj(k)m(ey)45 b Ft(to)37 b(the)f(n)m(ull)g(function)g(in)g(the)h(curren) m(tly)f(activ)m(e)i(k)m(eymap.)59 b(Returns)35 b(non-zero)i(in)390 -518 y(case)31 b(of)g(error.)3350 693 y([F)-8 b(unction])-3599 +1987 y(case)31 b(of)g(error.)3350 2184 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_unbind_key_in_map)f Fg(\()p Ff(in)m(t)33 -b(k)m(ey)-8 b(,)33 b(Keymap)g(map)p Fg(\))390 803 y Ft(Bind)d -Fj(k)m(ey)39 b Ft(to)31 b(the)g(n)m(ull)f(function)g(in)g +b(k)m(ey)-8 b(,)33 b(Keymap)g(map)p Fg(\))390 2293 y +Ft(Bind)d Fj(k)m(ey)39 b Ft(to)31 b(the)g(n)m(ull)f(function)g(in)g Fj(map)p Ft(.)40 b(Returns)30 b(non-zero)h(in)f(case)h(of)g(error.)3350 -978 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_unbind_function_in)q -(_map)f Fg(\()p Ff(rl)p 1821 978 30 5 v 44 w(command)p -2285 978 V 45 w(func)p 2514 978 V 45 w(t)33 b(*function,)565 -1088 y(Keymap)h(map)p Fg(\))390 1198 y Ft(Un)m(bind)29 +2491 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_unbind_function_in)q +(_map)f Fg(\()p Ff(rl)p 1821 2491 V 44 w(command)p 2285 +2491 V 45 w(func)p 2514 2491 V 45 w(t)33 b(*function,)565 +2600 y(Keymap)h(map)p Fg(\))390 2710 y Ft(Un)m(bind)29 b(all)i(k)m(eys)g(that)g(execute)h Fj(function)e Ft(in)g -Fj(map)p Ft(.)3350 1373 y([F)-8 b(unction])-3599 b Fh(int)53 +Fj(map)p Ft(.)3350 2907 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_unbind_command_in_)q(map)f Fg(\()p Ff(const)34 b(c)m(har)g -(*command,)f(Keymap)565 1482 y(map)p Fg(\))390 1592 y +(*command,)f(Keymap)565 3017 y(map)p Fg(\))390 3126 y Ft(Un)m(bind)c(all)i(k)m(eys)g(that)g(are)g(b)s(ound)e(to)i -Fj(command)i Ft(in)d Fj(map)p Ft(.)3350 1767 y([F)-8 +Fj(command)i Ft(in)d Fj(map)p Ft(.)3350 3324 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_bind_keyseq)d Fg(\()p -Ff(const)34 b(c)m(har)g(*k)m(eyseq,)e(rl)p 2119 1767 -V 44 w(command)p 2583 1767 V 44 w(func)p 2811 1767 V -46 w(t)565 1877 y(*function)p Fg(\))390 1987 y Ft(Bind)43 +Ff(const)34 b(c)m(har)g(*k)m(eyseq,)e(rl)p 2119 3324 +V 44 w(command)p 2583 3324 V 44 w(func)p 2811 3324 V +46 w(t)565 3433 y(*function)p Fg(\))390 3543 y Ft(Bind)43 b(the)g(k)m(ey)h(sequence)f(represen)m(ted)g(b)m(y)g(the)g(string)g Fj(k)m(eyseq)j Ft(to)e(the)f(function)g Fj(function)p -Ft(,)390 2096 y(b)s(eginning)27 b(in)h(the)h(curren)m(t)f(k)m(eymap.)40 +Ft(,)390 3652 y(b)s(eginning)27 b(in)h(the)h(curren)m(t)f(k)m(eymap.)40 b(This)28 b(mak)m(es)h(new)e(k)m(eymaps)i(as)f(necessary)-8 -b(.)41 b(The)28 b(return)390 2206 y(v)-5 b(alue)31 b(is)f(non-zero)h -(if)g Fj(k)m(eyseq)i Ft(is)d(in)m(v)-5 b(alid.)3350 2381 +b(.)41 b(The)28 b(return)390 3762 y(v)-5 b(alue)31 b(is)f(non-zero)h +(if)g Fj(k)m(eyseq)i Ft(is)d(in)m(v)-5 b(alid.)3350 3959 y([F)d(unction])-3599 b Fh(int)53 b(rl_bind_keyseq_in_map)f -Fg(\()p Ff(const)34 b(c)m(har)g(*k)m(eyseq,)565 2491 -y(rl)p 639 2491 V 44 w(command)p 1103 2491 V 44 w(func)p -1331 2491 V 45 w(t)f(*function,)h(Keymap)g(map)p Fg(\))390 -2600 y Ft(Bind)25 b(the)g(k)m(ey)h(sequence)f(represen)m(ted)g(b)m(y)g +Fg(\()p Ff(const)34 b(c)m(har)g(*k)m(eyseq,)565 4069 +y(rl)p 639 4069 V 44 w(command)p 1103 4069 V 44 w(func)p +1331 4069 V 45 w(t)f(*function,)h(Keymap)g(map)p Fg(\))390 +4178 y Ft(Bind)25 b(the)g(k)m(ey)h(sequence)f(represen)m(ted)g(b)m(y)g (the)g(string)g Fj(k)m(eyseq)j Ft(to)e(the)f(function)g -Fj(function)p Ft(.)39 b(This)390 2710 y(mak)m(es)30 b(new)f(k)m(eymaps) +Fj(function)p Ft(.)39 b(This)390 4288 y(mak)m(es)30 b(new)f(k)m(eymaps) g(as)g(necessary)-8 b(.)42 b(Initial)30 b(bindings)d(are)j(p)s (erformed)e(in)g Fj(map)p Ft(.)40 b(The)29 b(return)390 -2819 y(v)-5 b(alue)31 b(is)f(non-zero)h(if)g Fj(k)m(eyseq)i -Ft(is)d(in)m(v)-5 b(alid.)3350 2995 y([F)d(unction])-3599 +4398 y(v)-5 b(alue)31 b(is)f(non-zero)h(if)g Fj(k)m(eyseq)i +Ft(is)d(in)m(v)-5 b(alid.)3350 4595 y([F)d(unction])-3599 b Fh(int)53 b(rl_set_key)c Fg(\()p Ff(const)34 b(c)m(har)g(*k)m(eyseq,) -e(rl)p 1910 2995 V 44 w(command)p 2374 2995 V 44 w(func)p -2602 2995 V 45 w(t)h(*function,)565 3104 y(Keymap)h(map)p -Fg(\))390 3214 y Ft(Equiv)-5 b(alen)m(t)31 b(to)g Fs -(rl_bind_keyseq_in_map)p Ft(.)3350 3389 y([F)-8 b(unction])-3599 +e(rl)p 1910 4595 V 44 w(command)p 2374 4595 V 44 w(func)p +2602 4595 V 45 w(t)h(*function,)565 4704 y(Keymap)h(map)p +Fg(\))390 4814 y Ft(Equiv)-5 b(alen)m(t)31 b(to)g Fs +(rl_bind_keyseq_in_map)p Ft(.)3350 5011 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_bind_keyseq_if_unb)q(ound)f Fg(\()p -Ff(const)34 b(c)m(har)g(*k)m(eyseq,)565 3499 y(rl)p 639 -3499 V 44 w(command)p 1103 3499 V 44 w(func)p 1331 3499 -V 45 w(t)f(*function)p Fg(\))390 3608 y Ft(Binds)i Fj(k)m(eyseq)k +Ff(const)34 b(c)m(har)g(*k)m(eyseq,)565 5121 y(rl)p 639 +5121 V 44 w(command)p 1103 5121 V 44 w(func)p 1331 5121 +V 45 w(t)f(*function)p Fg(\))390 5230 y Ft(Binds)i Fj(k)m(eyseq)k Ft(to)d Fj(function)f Ft(if)g(it)h(is)g(not)g(already)g(b)s(ound)d(in)i -(the)h(curren)m(tly)f(activ)m(e)j(k)m(eymap.)390 3718 +(the)h(curren)m(tly)f(activ)m(e)j(k)m(eymap.)390 5340 y(Returns)29 b(non-zero)i(in)f(the)h(case)g(of)g(an)f(in)m(v)-5 b(alid)31 b Fj(k)m(eyseq)j Ft(or)c(if)g Fj(k)m(eyseq)k -Ft(is)c(already)h(b)s(ound.)3350 3893 y([F)-8 b(unction])-3599 -b Fh(int)53 b(rl_bind_keyseq_if_unb)q(ound)q(_in)q(_ma)q(p)e -Fg(\()p Ff(const)34 b(c)m(har)g(*k)m(eyseq,)565 4003 -y(rl)p 639 4003 V 44 w(command)p 1103 4003 V 44 w(func)p -1331 4003 V 45 w(t)f(*function,)h(Keymap)g(map)p Fg(\))390 -4113 y Ft(Binds)d Fj(k)m(eyseq)k Ft(to)e Fj(function)f +Ft(is)c(already)h(b)s(ound.)p eop end +%%Page: 38 42 +TeXDict begin 38 41 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(38)3350 +299 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_bind_keyseq_if_unb)q +(ound)q(_in)q(_ma)q(p)e Fg(\()p Ff(const)34 b(c)m(har)g(*k)m(eyseq,)565 +408 y(rl)p 639 408 30 5 v 44 w(command)p 1103 408 V 44 +w(func)p 1331 408 V 45 w(t)f(*function,)h(Keymap)g(map)p +Fg(\))390 518 y Ft(Binds)d Fj(k)m(eyseq)k Ft(to)e Fj(function)f Ft(if)g(it)g(is)g(not)g(already)h(b)s(ound)d(in)h Fj(map)p -Ft(.)46 b(Returns)31 b(non-zero)h(in)g(the)390 4222 y(case)f(of)g(an)f +Ft(.)46 b(Returns)31 b(non-zero)h(in)g(the)390 628 y(case)f(of)g(an)f (in)m(v)-5 b(alid)31 b Fj(k)m(eyseq)j Ft(or)c(if)g Fj(k)m(eyseq)k -Ft(is)c(already)h(b)s(ound.)3350 4398 y([F)-8 b(unction])-3599 +Ft(is)c(already)h(b)s(ound.)3350 792 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_generic_bind)d Fg(\()p Ff(in)m(t)34 b(t)m(yp)s(e,)f(const)g(c)m(har)h(*k)m(eyseq,)f(c)m(har)h(*data,)565 -4507 y(Keymap)g(map)p Fg(\))390 4617 y Ft(Bind)27 b(the)g(k)m(ey)h +901 y(Keymap)g(map)p Fg(\))390 1011 y Ft(Bind)27 b(the)g(k)m(ey)h (sequence)f(represen)m(ted)g(b)m(y)g(the)g(string)g Fj(k)m(eyseq)j Ft(to)e(the)f(arbitrary)g(p)s(oin)m(ter)g Fj(data)p Ft(.)390 -4726 y Fj(t)m(yp)s(e)34 b Ft(sa)m(ys)29 b(what)f(kind)g(of)g(data)h(is) +1120 y Fj(t)m(yp)s(e)34 b Ft(sa)m(ys)29 b(what)f(kind)g(of)g(data)h(is) g(p)s(oin)m(ted)f(to)h(b)m(y)g Fj(data)p Ft(;)h(this)e(can)h(b)s(e)f(a) -g(function)g(\()p Fs(ISFUNC)p Ft(\),)h(a)390 4836 y(macro)h(\()p +g(function)g(\()p Fs(ISFUNC)p Ft(\),)h(a)390 1230 y(macro)h(\()p Fs(ISMACR)p Ft(\),)f(or)g(a)h(k)m(eymap)g(\()p Fs(ISKMAP)p Ft(\).)40 b(This)28 b(mak)m(es)j(new)e(k)m(eymaps)g(as)h(necessary)-8 -b(.)41 b(The)390 4945 y(initial)32 b(k)m(eymap)e(in)h(whic)m(h)f(to)h -(do)f(bindings)f(is)i Fj(map)p Ft(.)3350 5121 y([F)-8 +b(.)41 b(The)390 1339 y(initial)32 b(k)m(eymap)e(in)h(whic)m(h)f(to)h +(do)f(bindings)f(is)i Fj(map)p Ft(.)3350 1503 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_parse_and_bind)e Fg(\()p -Ff(c)m(har)34 b(*line)p Fg(\))390 5230 y Ft(P)m(arse)c +Ff(c)m(har)34 b(*line)p Fg(\))390 1613 y Ft(P)m(arse)c Fj(line)35 b Ft(as)29 b(if)h(it)g(had)e(b)s(een)h(read)g(from)g(the)h Fs(inputrc)d Ft(\014le)j(and)e(p)s(erform)g(an)m(y)i(k)m(ey)g(bindings) -390 5340 y(and)g(v)-5 b(ariable)31 b(assignmen)m(ts)g(found)e(\(see)i -(Section)h(1.3)f([Readline)g(Init)f(File],)j(page)e(4\).)p -eop end -%%Page: 38 42 -TeXDict begin 38 41 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(38)3350 -299 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_read_init_file)e +390 1723 y(and)g(v)-5 b(ariable)31 b(assignmen)m(ts)g(found)e(\(see)i +(Section)h(1.3)f([Readline)g(Init)f(File],)j(page)e(4\).)3350 +1886 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_read_init_file)e Fg(\()p Ff(const)34 b(c)m(har)g(*\014lename)p Fg(\))390 -408 y Ft(Read)e(k)m(eybindings)f(and)g(v)-5 b(ariable)32 +1996 y Ft(Read)e(k)m(eybindings)f(and)g(v)-5 b(ariable)32 b(assignmen)m(ts)g(from)f Fj(\014lename)37 b Ft(\(see)32 -b(Section)g(1.3)h([Readline)390 518 y(Init)d(File],)i(page)f(4\).)150 -726 y Fi(2.4.4)63 b(Asso)s(ciating)41 b(F)-10 b(unction)42 -b(Names)f(and)g(Bindings)150 873 y Ft(These)30 b(functions)g(allo)m(w)h -(y)m(ou)g(to)f(\014nd)f(out)h(what)g(k)m(eys)h(in)m(v)m(ok)m(e)h(named) -e(functions)g(and)f(the)h(functions)150 983 y(in)m(v)m(ok)m(ed)f(b)m(y) -e(a)h(particular)g(k)m(ey)g(sequence.)40 b(Y)-8 b(ou)28 -b(ma)m(y)g(also)h(asso)s(ciate)g(a)f(new)f(function)g(name)h(with)f(an) -150 1092 y(arbitrary)j(function.)3350 1295 y([F)-8 b(unction])-3599 -b Fh(rl_command_func_t)57 b(*)c(rl_named_function)e Fg(\()p -Ff(const)34 b(c)m(har)g(*name)p Fg(\))390 1404 y Ft(Return)c(the)g -(function)g(with)g(name)h Fj(name)p Ft(.)3350 1606 y([F)-8 -b(unction])-3599 b Fh(rl_command_func_t)57 b(*)c(rl_function_of_keyseq) -f Fg(\()p Ff(const)34 b(c)m(har)565 1716 y(*k)m(eyseq,)f(Keymap)g(map,) -g(in)m(t)h(*t)m(yp)s(e)p Fg(\))390 1826 y Ft(Return)e(the)g(function)h -(in)m(v)m(ok)m(ed)h(b)m(y)e Fj(k)m(eyseq)k Ft(in)c(k)m(eymap)h +b(Section)g(1.3)h([Readline)390 2106 y(Init)d(File],)i(page)f(4\).)150 +2291 y Fi(2.4.4)63 b(Asso)s(ciating)41 b(F)-10 b(unction)42 +b(Names)f(and)g(Bindings)150 2438 y Ft(These)30 b(functions)g(allo)m(w) +h(y)m(ou)g(to)f(\014nd)f(out)h(what)g(k)m(eys)h(in)m(v)m(ok)m(e)h +(named)e(functions)g(and)f(the)h(functions)150 2548 y(in)m(v)m(ok)m(ed) +f(b)m(y)e(a)h(particular)g(k)m(ey)g(sequence.)40 b(Y)-8 +b(ou)28 b(ma)m(y)g(also)h(asso)s(ciate)g(a)f(new)f(function)g(name)h +(with)f(an)150 2657 y(arbitrary)j(function.)3350 2821 +y([F)-8 b(unction])-3599 b Fh(rl_command_func_t)57 b(*)c +(rl_named_function)e Fg(\()p Ff(const)34 b(c)m(har)g(*name)p +Fg(\))390 2931 y Ft(Return)c(the)g(function)g(with)g(name)h +Fj(name)p Ft(.)3350 3095 y([F)-8 b(unction])-3599 b Fh +(rl_command_func_t)57 b(*)c(rl_function_of_keyseq)f Fg(\()p +Ff(const)34 b(c)m(har)565 3204 y(*k)m(eyseq,)f(Keymap)g(map,)g(in)m(t)h +(*t)m(yp)s(e)p Fg(\))390 3314 y Ft(Return)e(the)g(function)h(in)m(v)m +(ok)m(ed)h(b)m(y)e Fj(k)m(eyseq)k Ft(in)c(k)m(eymap)h Fj(map)p Ft(.)47 b(If)32 b Fj(map)j Ft(is)d Fs(NULL)p -Ft(,)g(the)h(curren)m(t)390 1935 y(k)m(eymap)k(is)g(used.)60 +Ft(,)g(the)h(curren)m(t)390 3424 y(k)m(eymap)k(is)g(used.)60 b(If)37 b Fj(t)m(yp)s(e)42 b Ft(is)37 b(not)g Fs(NULL)p Ft(,)h(the)f(t)m(yp)s(e)g(of)g(the)g(ob)5 b(ject)38 b(is)f(returned)f -(in)h(the)g Fs(int)390 2045 y Ft(v)-5 b(ariable)30 b(it)g(p)s(oin)m(ts) +(in)h(the)g Fs(int)390 3533 y Ft(v)-5 b(ariable)30 b(it)g(p)s(oin)m(ts) g(to)g(\(one)g(of)g Fs(ISFUNC)p Ft(,)e Fs(ISKMAP)p Ft(,)g(or)i Fs(ISMACR)p Ft(\).)39 b(It)30 b(tak)m(es)h(a)f Fs(")p -Ft(translated)p Fs(")f Ft(k)m(ey)390 2154 y(sequence)i(and)f(should)f +Ft(translated)p Fs(")f Ft(k)m(ey)390 3643 y(sequence)i(and)f(should)f (not)i(b)s(e)e(used)h(if)g(the)h(k)m(ey)g(sequence)g(can)f(include)g -(NUL.)3350 2356 y([F)-8 b(unction])-3599 b Fh(rl_command_func_t)57 +(NUL.)3350 3807 y([F)-8 b(unction])-3599 b Fh(rl_command_func_t)57 b(*)c(rl_function_of_keyseq_)q(len)f Fg(\()p Ff(const)34 -b(c)m(har)565 2466 y(*k)m(eyseq,)f(size)p 1121 2466 30 -5 v 44 w(t)g(len,)g(Keymap)h(map,)f(in)m(t)g(*t)m(yp)s(e)p -Fg(\))390 2576 y Ft(Return)20 b(the)h(function)g(in)m(v)m(ok)m(ed)i(b)m +b(c)m(har)565 3916 y(*k)m(eyseq,)f(size)p 1121 3916 V +44 w(t)g(len,)g(Keymap)h(map,)f(in)m(t)g(*t)m(yp)s(e)p +Fg(\))390 4026 y Ft(Return)20 b(the)h(function)g(in)m(v)m(ok)m(ed)i(b)m (y)e Fj(k)m(eyseq)j Ft(of)d(length)g Fj(len)h Ft(in)e(k)m(eymap)i Fj(map)p Ft(.)37 b(Equiv)-5 b(alen)m(t)22 b(to)g Fs(rl_)390 -2685 y(function_of_keyseq)g Ft(with)28 b(the)f(addition)h(of)f(the)h +4135 y(function_of_keyseq)g Ft(with)28 b(the)f(addition)h(of)f(the)h Fj(len)f Ft(parameter.)41 b(It)27 b(tak)m(es)i(a)f Fs(")p -Ft(translated)p Fs(")390 2795 y Ft(k)m(ey)j(sequence)g(and)f(should)f +Ft(translated)p Fs(")390 4245 y Ft(k)m(ey)j(sequence)g(and)f(should)f (b)s(e)h(used)f(if)i(the)f(k)m(ey)h(sequence)g(can)g(include)f(NUL.) -3350 2997 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_trim_arg_from_keys) +3350 4409 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_trim_arg_from_keys) q(eq)f Fg(\()p Ff(const)34 b(c)m(har)g(*k)m(eyseq,)e(size)p -2678 2997 V 44 w(t)h(len,)565 3107 y(Keymap)h(map)p Fg(\))390 -3216 y Ft(If)e(there)h(is)f(a)h(n)m(umeric)g(argumen)m(t)g(at)g(the)g +2678 4409 V 44 w(t)h(len,)565 4519 y(Keymap)h(map)p Fg(\))390 +4628 y Ft(If)e(there)h(is)f(a)h(n)m(umeric)g(argumen)m(t)g(at)g(the)g (b)s(eginning)e(of)i Fj(k)m(eyseq)p Ft(,)h(p)s(ossibly)e(including)g -(digits,)390 3326 y(return)24 b(the)h(index)f(of)i(the)f(\014rst)f(c)m +(digits,)390 4738 y(return)24 b(the)h(index)f(of)i(the)f(\014rst)f(c)m (haracter)i(in)f Fj(k)m(eyseq)j Ft(follo)m(wing)e(the)g(n)m(umeric)e -(argumen)m(t.)40 b(This)390 3435 y(can)24 b(b)s(e)g(used)f(to)h(skip)g +(argumen)m(t.)40 b(This)390 4847 y(can)24 b(b)s(e)g(used)f(to)h(skip)g (o)m(v)m(er)h(the)f(n)m(umeric)g(argumen)m(t)g(\(whic)m(h)g(is)g(a)m(v) --5 b(ailable)27 b(as)d Fs(rl_numeric_arg)390 3545 y Ft(while)30 +-5 b(ailable)27 b(as)d Fs(rl_numeric_arg)390 4957 y Ft(while)30 b(tra)m(v)m(ersing)i(the)f(k)m(ey)g(sequence)g(that)g(in)m(v)m(ok)m(ed) -g(the)g(curren)m(t)f(command.)3350 3747 y([F)-8 b(unction])-3599 +g(the)g(curren)m(t)f(command.)3350 5121 y([F)-8 b(unction])-3599 b Fh(char)54 b(**)e(rl_invoking_keyseqs)g Fg(\()p Ff(rl)p -1717 3747 V 44 w(command)p 2181 3747 V 44 w(func)p 2409 -3747 V 45 w(t)33 b(*function)p Fg(\))390 3857 y Ft(Return)d(an)i(arra)m +1717 5121 V 44 w(command)p 2181 5121 V 44 w(func)p 2409 +5121 V 45 w(t)33 b(*function)p Fg(\))390 5230 y Ft(Return)d(an)i(arra)m (y)f(of)h(strings)f(represen)m(ting)g(the)g(k)m(ey)h(sequences)g(used)e -(to)i(in)m(v)m(ok)m(e)h Fj(function)e Ft(in)390 3966 -y(the)g(curren)m(t)f(k)m(eymap.)3350 4168 y([F)-8 b(unction])-3599 -b Fh(char)54 b(**)e(rl_invoking_keyseqs_i)q(n_m)q(ap)g -Fg(\()p Ff(rl)p 2083 4168 V 44 w(command)p 2547 4168 -V 44 w(func)p 2775 4168 V 45 w(t)565 4278 y(*function,)34 -b(Keymap)g(map)p Fg(\))390 4388 y Ft(Return)c(an)i(arra)m(y)f(of)h -(strings)f(represen)m(ting)g(the)g(k)m(ey)h(sequences)g(used)e(to)i(in) -m(v)m(ok)m(e)h Fj(function)e Ft(in)390 4497 y(the)g(k)m(eymap)f -Fj(map)p Ft(.)3350 4699 y([F)-8 b(unction])-3599 b Fh(void)54 -b(rl_function_dumper)c Fg(\()p Ff(in)m(t)34 b(readable)p -Fg(\))390 4809 y Ft(Prin)m(t)i(the)g(Readline)g(function)g(names)f(and) -g(the)h(k)m(ey)h(sequences)f(curren)m(tly)g(b)s(ound)d(to)k(them)390 -4919 y(to)32 b Fs(rl_outstream)p Ft(.)40 b(If)31 b Fj(readable)36 -b Ft(is)c(non-zero,)g(the)f(list)h(is)f(formatted)h(in)f(suc)m(h)g(a)g -(w)m(a)m(y)i(that)e(it)390 5028 y(can)g(b)s(e)e(made)i(part)f(of)h(an)f -Fs(inputrc)e Ft(\014le)j(and)e(re-read.)3350 5230 y([F)-8 -b(unction])-3599 b Fh(void)54 b(rl_list_funmap_names)d -Fg(\()p Ff(v)m(oid)p Fg(\))390 5340 y Ft(Prin)m(t)30 -b(the)h(names)f(of)h(all)g(bindable)f(Readline)h(functions)f(to)h -Fs(rl_outstream)p Ft(.)p eop end +(to)i(in)m(v)m(ok)m(e)h Fj(function)e Ft(in)390 5340 +y(the)g(curren)m(t)f(k)m(eymap.)p eop end %%Page: 39 43 TeXDict begin 39 42 bop 150 -116 a Ft(Chapter)30 b(2:)41 b(Programming)30 b(with)g(GNU)h(Readline)1683 b(39)3350 -299 y([F)-8 b(unction])-3599 b Fh(const)54 b(char)f(**)g -(rl_funmap_names)d Fg(\()p Ff(v)m(oid)p Fg(\))390 408 +299 y([F)-8 b(unction])-3599 b Fh(char)54 b(**)e(rl_invoking_keyseqs_i) +q(n_m)q(ap)g Fg(\()p Ff(rl)p 2083 299 30 5 v 44 w(command)p +2547 299 V 44 w(func)p 2775 299 V 45 w(t)565 408 y(*function,)34 +b(Keymap)g(map)p Fg(\))390 518 y Ft(Return)c(an)i(arra)m(y)f(of)h +(strings)f(represen)m(ting)g(the)g(k)m(ey)h(sequences)g(used)e(to)i(in) +m(v)m(ok)m(e)h Fj(function)e Ft(in)390 628 y(the)g(k)m(eymap)f +Fj(map)p Ft(.)3350 822 y([F)-8 b(unction])-3599 b Fh(void)54 +b(rl_print_keybinding)d Fg(\()p Ff(const)34 b(c)m(har)g(*name,)f +(Keymap)h(map,)f(in)m(t)565 932 y(readable)p Fg(\))390 +1041 y Ft(Prin)m(t)d(k)m(ey)g(sequences)g(b)s(ound)d(to)j(Readline)h +(function)e(name)g Fj(name)35 b Ft(in)29 b(k)m(eymap)h +Fj(map)p Ft(.)40 b(If)30 b Fj(map)390 1151 y Ft(is)h(NULL,)g(this)g +(uses)g(the)g(curren)m(t)g(k)m(eymap.)44 b(If)30 b Fj(readable)37 +b Ft(is)31 b(non-zero,)h(the)f(list)h(is)f(formatted)390 +1260 y(in)f(suc)m(h)g(a)h(w)m(a)m(y)g(that)g(it)g(can)g(b)s(e)e(made)i +(part)f(of)h(an)f Fs(inputrc)e Ft(\014le)j(and)f(re-read.)3350 +1455 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_function_dumper)c +Fg(\()p Ff(in)m(t)34 b(readable)p Fg(\))390 1564 y Ft(Prin)m(t)i(the)g +(Readline)g(function)g(names)f(and)g(the)h(k)m(ey)h(sequences)f(curren) +m(tly)g(b)s(ound)d(to)k(them)390 1674 y(to)32 b Fs(rl_outstream)p +Ft(.)40 b(If)31 b Fj(readable)36 b Ft(is)c(non-zero,)g(the)f(list)h(is) +f(formatted)h(in)f(suc)m(h)g(a)g(w)m(a)m(y)i(that)e(it)390 +1783 y(can)g(b)s(e)e(made)i(part)f(of)h(an)f Fs(inputrc)e +Ft(\014le)j(and)e(re-read.)3350 1978 y([F)-8 b(unction])-3599 +b Fh(void)54 b(rl_list_funmap_names)d Fg(\()p Ff(v)m(oid)p +Fg(\))390 2087 y Ft(Prin)m(t)30 b(the)h(names)f(of)h(all)g(bindable)f +(Readline)h(functions)f(to)h Fs(rl_outstream)p Ft(.)3350 +2281 y([F)-8 b(unction])-3599 b Fh(const)54 b(char)f(**)g +(rl_funmap_names)d Fg(\()p Ff(v)m(oid)p Fg(\))390 2391 y Ft(Return)25 b(a)i(NULL)f(terminated)g(arra)m(y)h(of)f(kno)m(wn)f (function)h(names.)39 b(The)26 b(arra)m(y)g(is)g(sorted.)39 -b(The)390 518 y(arra)m(y)28 b(itself)h(is)f(allo)s(cated,)j(but)c(not)h -(the)h(strings)e(inside.)40 b(Y)-8 b(ou)29 b(should)e(free)h(the)g -(arra)m(y)-8 b(,)29 b(but)f(not)390 628 y(the)j(p)s(oin)m(ters,)f +b(The)390 2501 y(arra)m(y)28 b(itself)h(is)f(allo)s(cated,)j(but)c(not) +h(the)h(strings)e(inside.)40 b(Y)-8 b(ou)29 b(should)e(free)h(the)g +(arra)m(y)-8 b(,)29 b(but)f(not)390 2610 y(the)j(p)s(oin)m(ters,)f (using)g Fs(free)f Ft(or)i Fs(rl_free)d Ft(when)h(y)m(ou)i(are)g(done.) -3350 813 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_add_funmap_entry)e -Fg(\()p Ff(const)34 b(c)m(har)g(*name,)g(rl)p 2331 813 -30 5 v 43 w(command)p 2794 813 V 45 w(func)p 3023 813 -V 45 w(t)565 923 y(*function)p Fg(\))390 1033 y Ft(Add)e +3350 2804 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_add_funmap_entry)e +Fg(\()p Ff(const)34 b(c)m(har)g(*name,)g(rl)p 2331 2804 +V 43 w(command)p 2794 2804 V 45 w(func)p 3023 2804 V +45 w(t)565 2914 y(*function)p Fg(\))390 3024 y Ft(Add)e Fj(name)38 b Ft(to)33 b(the)g(list)h(of)f(bindable)f(Readline)h (command)g(names,)g(and)f(mak)m(e)i Fj(function)f Ft(the)390 -1142 y(function)d(to)h(b)s(e)f(called)h(when)f Fj(name)35 -b Ft(is)c(in)m(v)m(ok)m(ed.)150 1342 y Fi(2.4.5)63 b(Allo)m(wing)41 -b(Undoing)150 1489 y Ft(Supp)s(orting)34 b(the)i(undo)e(command)i(is)g +3133 y(function)d(to)h(b)s(e)f(called)h(when)f Fj(name)35 +b Ft(is)c(in)m(v)m(ok)m(ed.)150 3337 y Fi(2.4.5)63 b(Allo)m(wing)41 +b(Undoing)150 3484 y Ft(Supp)s(orting)34 b(the)i(undo)e(command)i(is)g (a)g(painless)g(thing,)h(and)e(mak)m(es)i(y)m(our)f(functions)f(m)m(uc) -m(h)h(more)150 1599 y(useful.)k(It)30 b(is)h(certainly)g(easy)g(to)g +m(h)h(more)150 3594 y(useful.)k(It)30 b(is)h(certainly)g(easy)g(to)g (try)g(something)g(if)f(y)m(ou)h(kno)m(w)f(y)m(ou)h(can)f(undo)g(it.) -275 1734 y(If)40 b(y)m(our)h(function)f(simply)g(inserts)h(text)h +275 3733 y(If)40 b(y)m(our)h(function)f(simply)g(inserts)h(text)h (once,)i(or)d(deletes)h(text)g(once,)i(and)c(uses)h Fs(rl_insert_)150 -1844 y(text\(\))26 b Ft(or)i Fs(rl_delete_text\(\))23 +3843 y(text\(\))26 b Ft(or)i Fs(rl_delete_text\(\))23 b Ft(to)29 b(do)f(it,)h(then)f(undoing)f(is)g(already)i(done)f(for)f(y) -m(ou)h(automatically)-8 b(.)275 1979 y(If)20 b(y)m(ou)g(do)h(m)m +m(ou)h(automatically)-8 b(.)275 3983 y(If)20 b(y)m(ou)g(do)h(m)m (ultiple)g(insertions)f(or)h(m)m(ultiple)g(deletions,)j(or)c(an)m(y)h -(com)m(bination)h(of)e(these)h(op)s(erations,)150 2088 +(com)m(bination)h(of)e(these)h(op)s(erations,)150 4092 y(y)m(ou)38 b(should)f(group)h(them)g(together)h(in)m(to)g(one)f(op)s (eration.)64 b(This)37 b(is)h(done)g(with)g Fs(rl_begin_undo_)150 -2198 y(group\(\))28 b Ft(and)i Fs(rl_end_undo_group\(\))p -Ft(.)275 2333 y(The)f(t)m(yp)s(es)i(of)f(ev)m(en)m(ts)i(that)f(can)g(b) -s(e)e(undone)h(are:)390 2446 y Fe(enum)40 b(undo_code)h({)f +4202 y(group\(\))28 b Ft(and)i Fs(rl_end_undo_group\(\))p +Ft(.)275 4341 y(The)f(t)m(yp)s(es)i(of)f(ev)m(en)m(ts)i(that)f(can)g(b) +s(e)e(undone)h(are:)390 4458 y Fe(enum)40 b(undo_code)h({)f (UNDO_DELETE,)i(UNDO_INSERT,)g(UNDO_BEGIN,)g(UNDO_END)f(};)275 -2581 y Ft(Notice)32 b(that)f Fs(UNDO_DELETE)c Ft(means)j(to)h(insert)f +4598 y Ft(Notice)32 b(that)f Fs(UNDO_DELETE)c Ft(means)j(to)h(insert)f (some)h(text,)h(and)d Fs(UNDO_INSERT)e Ft(means)k(to)g(delete)150 -2691 y(some)d(text.)41 b(That)27 b(is,)i(the)e(undo)g(co)s(de)h(tells)g +4707 y(some)d(text.)41 b(That)27 b(is,)i(the)e(undo)g(co)s(de)h(tells)g (what)g(to)g(undo,)f(not)h(ho)m(w)g(to)g(undo)e(it.)41 -b Fs(UNDO_BEGIN)25 b Ft(and)150 2800 y Fs(UNDO_END)j +b Fs(UNDO_BEGIN)25 b Ft(and)150 4817 y Fs(UNDO_END)j Ft(are)j(tags)g(added)f(b)m(y)g Fs(rl_begin_undo_group\(\))25 -b Ft(and)30 b Fs(rl_end_undo_group\(\))p Ft(.)3350 2986 +b Ft(and)30 b Fs(rl_end_undo_group\(\))p Ft(.)3350 5011 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_begin_undo_group)e -Fg(\()p Ff(v)m(oid)p Fg(\))390 3096 y Ft(Begins)32 b(sa)m(ving)g(undo)d +Fg(\()p Ff(v)m(oid)p Fg(\))390 5121 y Ft(Begins)32 b(sa)m(ving)g(undo)d (information)j(in)e(a)i(group)e(construct.)43 b(The)30 -b(undo)g(information)h(usually)390 3205 y(comes)42 b(from)f(calls)i(to) +b(undo)g(information)h(usually)390 5230 y(comes)42 b(from)f(calls)i(to) f Fs(rl_insert_text\(\))37 b Ft(and)k Fs(rl_delete_text\(\))p -Ft(,)f(but)h(could)h(b)s(e)f(the)390 3315 y(result)30 -b(of)h(calls)g(to)g Fs(rl_add_undo\(\))p Ft(.)3350 3501 -y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_end_undo_group)e -Fg(\()p Ff(v)m(oid)p Fg(\))390 3610 y Ft(Closes)29 b(the)h(curren)m(t)e +Ft(,)f(but)h(could)h(b)s(e)f(the)390 5340 y(result)30 +b(of)h(calls)g(to)g Fs(rl_add_undo\(\))p Ft(.)p eop end +%%Page: 40 44 +TeXDict begin 40 43 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(40)3350 +299 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_end_undo_group)e +Fg(\()p Ff(v)m(oid)p Fg(\))390 408 y Ft(Closes)29 b(the)h(curren)m(t)e (undo)g(group)h(started)g(with)g Fs(rl_begin_undo_group)c(\(\))p -Ft(.)39 b(There)29 b(should)390 3720 y(b)s(e)h(one)g(call)i(to)f +Ft(.)39 b(There)29 b(should)390 518 y(b)s(e)h(one)g(call)i(to)f Fs(rl_end_undo_group\(\))25 b Ft(for)30 b(eac)m(h)i(call)g(to)f -Fs(rl_begin_undo_group\(\))p Ft(.)3350 3906 y([F)-8 b(unction])-3599 +Fs(rl_begin_undo_group\(\))p Ft(.)3350 708 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_add_undo)48 b Fg(\()p Ff(en)m(um)35 -b(undo)p 1558 3906 V 45 w(co)s(de)e(what,)g(in)m(t)g(start,)g(in)m(t)g -(end,)h(c)m(har)565 4015 y(*text)p Fg(\))390 4125 y Ft(Remem)m(b)s(er)g -(ho)m(w)g(to)h(undo)d(an)i(ev)m(en)m(t)i(\(according)f(to)g -Fj(what)r Ft(\).)52 b(The)33 b(a\013ected)j(text)f(runs)d(from)390 -4235 y Fj(start)h Ft(to)e Fj(end)p Ft(,)f(and)g(encompasses)h -Fj(text)p Ft(.)3350 4420 y([F)-8 b(unction])-3599 b Fh(void)54 -b(rl_free_undo_list)c Fg(\()p Ff(v)m(oid)p Fg(\))390 -4530 y Ft(F)-8 b(ree)31 b(the)g(existing)g(undo)f(list.)3350 -4716 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_do_undo)c -Fg(\()p Ff(v)m(oid)p Fg(\))390 4825 y Ft(Undo)22 b(the)h(\014rst)g +b(undo)p 1558 708 30 5 v 45 w(co)s(de)e(what,)g(in)m(t)g(start,)g(in)m +(t)g(end,)h(c)m(har)565 818 y(*text)p Fg(\))390 927 y +Ft(Remem)m(b)s(er)g(ho)m(w)g(to)h(undo)d(an)i(ev)m(en)m(t)i +(\(according)f(to)g Fj(what)r Ft(\).)52 b(The)33 b(a\013ected)j(text)f +(runs)d(from)390 1037 y Fj(start)h Ft(to)e Fj(end)p Ft(,)f(and)g +(encompasses)h Fj(text)p Ft(.)3350 1227 y([F)-8 b(unction])-3599 +b Fh(void)54 b(rl_free_undo_list)c Fg(\()p Ff(v)m(oid)p +Fg(\))390 1336 y Ft(F)-8 b(ree)31 b(the)g(existing)g(undo)f(list.)3350 +1526 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_do_undo)c +Fg(\()p Ff(v)m(oid)p Fg(\))390 1636 y Ft(Undo)22 b(the)h(\014rst)g (thing)f(on)h(the)g(undo)f(list.)39 b(Returns)22 b Fs(0)g Ft(if)h(there)g(w)m(as)g(nothing)g(to)h(undo,)f(non-zero)390 -4935 y(if)30 b(something)h(w)m(as)g(undone.)275 5121 +1745 y(if)30 b(something)h(w)m(as)g(undone.)275 1935 y(Finally)-8 b(,)32 b(if)f(y)m(ou)h(neither)f(insert)g(nor)f(delete)j (text,)f(but)f(directly)g(mo)s(dify)g(the)g(existing)h(text)g(\(e.g.,) -150 5230 y(c)m(hange)40 b(its)f(case\),)j(call)e Fs(rl_modifying\(\))35 +150 2045 y(c)m(hange)40 b(its)f(case\),)j(call)e Fs(rl_modifying\(\))35 b Ft(once,)42 b(just)c(b)s(efore)g(y)m(ou)h(mo)s(dify)f(the)h(text.)67 -b(Y)-8 b(ou)39 b(m)m(ust)150 5340 y(supply)29 b(the)h(indices)h(of)f +b(Y)-8 b(ou)39 b(m)m(ust)150 2155 y(supply)29 b(the)h(indices)h(of)f (the)h(text)g(range)g(that)g(y)m(ou)g(are)g(going)g(to)g(mo)s(dify)-8 -b(.)p eop end -%%Page: 40 44 -TeXDict begin 40 43 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(40)3350 -299 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_modifying)c +b(.)3350 2345 y([F)g(unction])-3599 b Fh(int)53 b(rl_modifying)c Fg(\()p Ff(in)m(t)34 b(start,)e(in)m(t)i(end)p Fg(\))390 -408 y Ft(T)-8 b(ell)41 b(Readline)g(to)g(sa)m(v)m(e)g(the)g(text)g(b)s +2454 y Ft(T)-8 b(ell)41 b(Readline)g(to)g(sa)m(v)m(e)g(the)g(text)g(b)s (et)m(w)m(een)g Fj(start)i Ft(and)c Fj(end)k Ft(as)e(a)f(single)h(undo) -e(unit.)70 b(It)40 b(is)390 518 y(assumed)30 b(that)h(y)m(ou)f(will)h -(subsequen)m(tly)f(mo)s(dify)f(that)i(text.)150 712 y -Fi(2.4.6)63 b(Redispla)m(y)3350 903 y Ft([F)-8 b(unction])-3599 +e(unit.)70 b(It)40 b(is)390 2564 y(assumed)30 b(that)h(y)m(ou)f(will)h +(subsequen)m(tly)f(mo)s(dify)f(that)i(text.)150 2766 +y Fi(2.4.6)63 b(Redispla)m(y)3350 2965 y Ft([F)-8 b(unction])-3599 b Fh(void)54 b(rl_redisplay)49 b Fg(\()p Ff(v)m(oid)p -Fg(\))390 1013 y Ft(Change)38 b(what's)f(displa)m(y)m(ed)i(on)e(the)h +Fg(\))390 3075 y Ft(Change)38 b(what's)f(displa)m(y)m(ed)i(on)e(the)h (screen)g(to)h(re\015ect)f(the)g(curren)m(t)g(con)m(ten)m(ts)h(of)f -Fs(rl_line_)390 1123 y(buffer)p Ft(.)3350 1299 y([F)-8 +Fs(rl_line_)390 3185 y(buffer)p Ft(.)3350 3375 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_forced_update_disp)q(lay)f -Fg(\()p Ff(v)m(oid)p Fg(\))390 1409 y Ft(F)-8 b(orce)41 +Fg(\()p Ff(v)m(oid)p Fg(\))390 3484 y Ft(F)-8 b(orce)41 b(the)f(line)g(to)h(b)s(e)e(up)s(dated)f(and)h(redispla)m(y)m(ed,)k -(whether)c(or)g(not)h(Readline)h(thinks)e(the)390 1518 -y(screen)30 b(displa)m(y)h(is)f(correct.)3350 1695 y([F)-8 +(whether)c(or)g(not)h(Readline)h(thinks)e(the)390 3594 +y(screen)30 b(displa)m(y)h(is)f(correct.)3350 3784 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_on_new_line)d Fg(\()p -Ff(v)m(oid)p Fg(\))390 1804 y Ft(T)-8 b(ell)31 b(the)f(up)s(date)f +Ff(v)m(oid)p Fg(\))390 3893 y Ft(T)-8 b(ell)31 b(the)f(up)s(date)f (functions)g(that)i(w)m(e)f(ha)m(v)m(e)h(mo)m(v)m(ed)g(on)m(to)g(a)f -(new)f(\(empt)m(y\))i(line,)g(usually)e(after)390 1914 -y(outputting)i(a)f(newline.)3350 2090 y([F)-8 b(unction])-3599 +(new)f(\(empt)m(y\))i(line,)g(usually)e(after)390 4003 +y(outputting)i(a)f(newline.)3350 4193 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_on_new_line_with_p)q(romp)q(t)f Fg(\()p -Ff(v)m(oid)p Fg(\))390 2200 y Ft(T)-8 b(ell)25 b(the)f(up)s(date)f +Ff(v)m(oid)p Fg(\))390 4303 y Ft(T)-8 b(ell)25 b(the)f(up)s(date)f (functions)h(that)h(w)m(e)f(ha)m(v)m(e)h(mo)m(v)m(ed)g(on)m(to)h(a)e -(new)g(line,)i(with)d Fj(rl)p 3106 2200 28 4 v 40 w(prompt)i -Ft(already)390 2309 y(displa)m(y)m(ed.)41 b(This)28 b(could)g(b)s(e)g +(new)g(line,)i(with)d Fj(rl)p 3106 4303 28 4 v 40 w(prompt)i +Ft(already)390 4412 y(displa)m(y)m(ed.)41 b(This)28 b(could)g(b)s(e)g (used)g(b)m(y)g(applications)i(that)f(w)m(an)m(t)h(to)f(output)f(the)h -(prompt)f(string)390 2419 y(themselv)m(es,)h(but)e(still)h(need)g +(prompt)f(string)390 4522 y(themselv)m(es,)h(but)e(still)h(need)g (Readline)g(to)g(kno)m(w)f(the)h(prompt)e(string)h(length)h(for)f -(redispla)m(y)-8 b(.)41 b(It)390 2528 y(should)29 b(b)s(e)h(used)g -(after)h(setting)g Fj(rl)p 1590 2528 V 40 w(already)p -1920 2528 V 41 w(prompted)p Ft(.)3350 2705 y([F)-8 b(unction])-3599 +(redispla)m(y)-8 b(.)41 b(It)390 4631 y(should)29 b(b)s(e)h(used)g +(after)h(setting)g Fj(rl)p 1590 4631 V 40 w(already)p +1920 4631 V 41 w(prompted)p Ft(.)3350 4821 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_clear_visible_line)f Fg(\()p Ff(v)m(oid)p -Fg(\))390 2814 y Ft(Clear)31 b(the)f(screen)h(lines)f(corresp)s(onding) +Fg(\))390 4931 y Ft(Clear)31 b(the)f(screen)h(lines)f(corresp)s(onding) g(to)h(the)f(curren)m(t)g(line's)h(con)m(ten)m(ts.)3350 -2991 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_reset_line_state)e -Fg(\()p Ff(v)m(oid)p Fg(\))390 3100 y Ft(Reset)36 b(the)e(displa)m(y)h +5121 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_reset_line_state)e +Fg(\()p Ff(v)m(oid)p Fg(\))390 5230 y Ft(Reset)36 b(the)e(displa)m(y)h (state)h(to)g(a)f(clean)g(state)h(and)e(redispla)m(y)h(the)g(curren)m -(t)g(line)g(starting)g(on)g(a)390 3210 y(new)30 b(line.)3350 -3386 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_crlf)48 -b Fg(\()p Ff(v)m(oid)p Fg(\))390 3496 y Ft(Mo)m(v)m(e)32 +(t)g(line)g(starting)g(on)g(a)390 5340 y(new)30 b(line.)p +eop end +%%Page: 41 45 +TeXDict begin 41 44 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(41)3350 +299 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_crlf)48 +b Fg(\()p Ff(v)m(oid)p Fg(\))390 408 y Ft(Mo)m(v)m(e)32 b(the)f(cursor)f(to)h(the)f(start)h(of)g(the)f(next)h(screen)f(line.) -3350 3672 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_show_char)c -Fg(\()p Ff(in)m(t)34 b(c)p Fg(\))390 3782 y Ft(Displa)m(y)g(c)m +3350 640 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_show_char)c +Fg(\()p Ff(in)m(t)34 b(c)p Fg(\))390 750 y Ft(Displa)m(y)g(c)m (haracter)g Fj(c)k Ft(on)32 b Fs(rl_outstream)p Ft(.)44 b(If)32 b(Readline)h(has)g(not)f(b)s(een)g(set)h(to)g(displa)m(y)g -(meta)390 3891 y(c)m(haracters)27 b(directly)-8 b(,)29 +(meta)390 860 y(c)m(haracters)27 b(directly)-8 b(,)29 b(this)c(will)i(con)m(v)m(ert)g(meta)g(c)m(haracters)h(to)e(a)h -(meta-pre\014xed)f(k)m(ey)g(sequence.)390 4001 y(This)k(is)g(in)m +(meta-pre\014xed)f(k)m(ey)g(sequence.)390 969 y(This)k(is)g(in)m (tended)g(for)g(use)g(b)m(y)h(applications)g(whic)m(h)f(wish)g(to)h(do) -f(their)h(o)m(wn)f(redispla)m(y)-8 b(.)3350 4177 y([F)g(unction])-3599 +f(their)h(o)m(wn)f(redispla)m(y)-8 b(.)3350 1201 y([F)g(unction])-3599 b Fh(int)53 b(rl_message)c Fg(\()p Ff(const)34 b(c)m(har)g(*,)k(.)24 -b(.)g(.)12 b Fg(\))390 4287 y Ft(The)20 b(argumen)m(ts)h(are)g(a)g +b(.)g(.)12 b Fg(\))390 1311 y Ft(The)20 b(argumen)m(ts)h(are)g(a)g (format)g(string)g(as)f(w)m(ould)h(b)s(e)f(supplied)f(to)j -Fs(printf)p Ft(,)f(p)s(ossibly)e(con)m(taining)390 4396 +Fs(printf)p Ft(,)f(p)s(ossibly)e(con)m(taining)390 1420 y(con)m(v)m(ersion)45 b(sp)s(eci\014cations)g(suc)m(h)f(as)g(`)p Fs(\045d)p Ft(',)k(and)c(an)m(y)g(additional)h(argumen)m(ts)g -(necessary)f(to)390 4506 y(satisfy)e(the)f(con)m(v)m(ersion)i(sp)s +(necessary)f(to)390 1530 y(satisfy)e(the)f(con)m(v)m(ersion)i(sp)s (eci\014cations.)74 b(The)41 b(resulting)h(string)f(is)g(displa)m(y)m -(ed)h(in)f(the)h Fj(ec)m(ho)390 4616 y(area)p Ft(.)63 +(ed)h(in)f(the)h Fj(ec)m(ho)390 1639 y(area)p Ft(.)63 b(The)37 b(ec)m(ho)i(area)f(is)g(also)g(used)f(to)h(displa)m(y)g(n)m (umeric)f(argumen)m(ts)h(and)f(searc)m(h)h(strings.)390 -4725 y(Y)-8 b(ou)34 b(should)e(call)j Fs(rl_save_prompt)29 +1749 y(Y)-8 b(ou)34 b(should)e(call)j Fs(rl_save_prompt)29 b Ft(to)34 b(sa)m(v)m(e)h(the)f(prompt)e(information)i(b)s(efore)f -(calling)i(this)390 4835 y(function.)3350 5011 y([F)-8 +(calling)i(this)390 1859 y(function.)3350 2091 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_clear_message)e Fg(\()p -Ff(v)m(oid)p Fg(\))390 5121 y Ft(Clear)29 b(the)g(message)h(in)f(the)g +Ff(v)m(oid)p Fg(\))390 2200 y Ft(Clear)29 b(the)g(message)h(in)f(the)g (ec)m(ho)h(area.)41 b(If)29 b(the)g(prompt)f(w)m(as)h(sa)m(v)m(ed)h -(with)f(a)g(call)i(to)e Fs(rl_save_)390 5230 y(prompt)38 +(with)f(a)g(call)i(to)e Fs(rl_save_)390 2310 y(prompt)38 b Ft(b)s(efore)h(the)g(last)h(call)h(to)f Fs(rl_message)p Ft(,)f(call)i Fs(rl_restore_prompt)34 b Ft(b)s(efore)39 -b(calling)390 5340 y(this)30 b(function.)p eop end -%%Page: 41 45 -TeXDict begin 41 44 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(41)3350 -299 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_save_prompt)49 -b Fg(\()p Ff(v)m(oid)p Fg(\))390 408 y Ft(Sa)m(v)m(e)44 -b(the)f(lo)s(cal)i(Readline)e(prompt)f(displa)m(y)i(state)g(in)f -(preparation)g(for)g(displa)m(ying)g(a)g(new)390 518 -y(message)31 b(in)g(the)f(message)i(area)f(with)f Fs(rl_message\(\))p -Ft(.)3350 722 y([F)-8 b(unction])-3599 b Fh(void)54 b -(rl_restore_prompt)c Fg(\()p Ff(v)m(oid)p Fg(\))390 832 -y Ft(Restore)44 b(the)e(lo)s(cal)i(Readline)g(prompt)d(displa)m(y)i -(state)h(sa)m(v)m(ed)g(b)m(y)f(the)f(most)h(recen)m(t)h(call)g(to)390 -941 y Fs(rl_save_prompt)p Ft(.)69 b(if)41 b Fs(rl_save_prompt)d -Ft(w)m(as)j(called)i(to)f(sa)m(v)m(e)h(the)e(prompt)f(b)s(efore)h(a)h -(call)390 1051 y(to)37 b Fs(rl_message)p Ft(,)f(this)h(function)f -(should)g(b)s(e)g(called)i(b)s(efore)f(the)g(corresp)s(onding)e(call)j -(to)g Fs(rl_)390 1161 y(clear_message)p Ft(.)3350 1365 -y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_expand_prompt)e -Fg(\()p Ff(c)m(har)34 b(*prompt)p Fg(\))390 1474 y Ft(Expand)41 -b(an)m(y)j(sp)s(ecial)f(c)m(haracter)h(sequences)f(in)g -Fj(prompt)g Ft(and)f(set)i(up)d(the)i(lo)s(cal)h(Readline)390 -1584 y(prompt)35 b(redispla)m(y)h(v)-5 b(ariables.)57 -b(This)35 b(function)h(is)g(called)h(b)m(y)e Fs(readline\(\))p -Ft(.)55 b(It)35 b(ma)m(y)i(also)g(b)s(e)390 1694 y(called)22 -b(to)g(expand)f(the)g(primary)f(prompt)g(if)i(the)f Fs -(rl_on_new_line_with_prom)o(pt\()o(\))15 b Ft(function)390 -1803 y(or)25 b Fs(rl_already_prompted)c Ft(v)-5 b(ariable)26 +b(calling)390 2419 y(this)30 b(function.)3350 2651 y([F)-8 +b(unction])-3599 b Fh(void)54 b(rl_save_prompt)49 b Fg(\()p +Ff(v)m(oid)p Fg(\))390 2761 y Ft(Sa)m(v)m(e)44 b(the)f(lo)s(cal)i +(Readline)e(prompt)f(displa)m(y)i(state)g(in)f(preparation)g(for)g +(displa)m(ying)g(a)g(new)390 2871 y(message)31 b(in)g(the)f(message)i +(area)f(with)f Fs(rl_message\(\))p Ft(.)3350 3102 y([F)-8 +b(unction])-3599 b Fh(void)54 b(rl_restore_prompt)c Fg(\()p +Ff(v)m(oid)p Fg(\))390 3212 y Ft(Restore)44 b(the)e(lo)s(cal)i +(Readline)g(prompt)d(displa)m(y)i(state)h(sa)m(v)m(ed)g(b)m(y)f(the)f +(most)h(recen)m(t)h(call)g(to)390 3322 y Fs(rl_save_prompt)p +Ft(.)69 b(if)41 b Fs(rl_save_prompt)d Ft(w)m(as)j(called)i(to)f(sa)m(v) +m(e)h(the)e(prompt)f(b)s(efore)h(a)h(call)390 3431 y(to)37 +b Fs(rl_message)p Ft(,)f(this)h(function)f(should)g(b)s(e)g(called)i(b) +s(efore)f(the)g(corresp)s(onding)e(call)j(to)g Fs(rl_)390 +3541 y(clear_message)p Ft(.)3350 3773 y([F)-8 b(unction])-3599 +b Fh(int)53 b(rl_expand_prompt)e Fg(\()p Ff(c)m(har)34 +b(*prompt)p Fg(\))390 3882 y Ft(Expand)41 b(an)m(y)j(sp)s(ecial)f(c)m +(haracter)h(sequences)f(in)g Fj(prompt)g Ft(and)f(set)i(up)d(the)i(lo)s +(cal)h(Readline)390 3992 y(prompt)35 b(redispla)m(y)h(v)-5 +b(ariables.)57 b(This)35 b(function)h(is)g(called)h(b)m(y)e +Fs(readline\(\))p Ft(.)55 b(It)35 b(ma)m(y)i(also)g(b)s(e)390 +4102 y(called)22 b(to)g(expand)f(the)g(primary)f(prompt)g(if)i(the)f +Fs(rl_on_new_line_with_prom)o(pt\()o(\))15 b Ft(function)390 +4211 y(or)25 b Fs(rl_already_prompted)c Ft(v)-5 b(ariable)26 b(is)f(used.)39 b(It)25 b(returns)f(the)i(n)m(um)m(b)s(er)e(of)i -(visible)f(c)m(haracters)390 1913 y(on)34 b(the)g(last)g(line)g(of)g +(visible)f(c)m(haracters)390 4321 y(on)34 b(the)g(last)g(line)g(of)g (the)g(\(p)s(ossibly)f(m)m(ulti-line\))j(prompt.)50 b(Applications)34 -b(ma)m(y)h(indicate)f(that)390 2022 y(the)28 b(prompt)f(con)m(tains)i +b(ma)m(y)h(indicate)f(that)390 4430 y(the)28 b(prompt)f(con)m(tains)i (c)m(haracters)g(that)g(tak)m(e)g(up)e(no)h(ph)m(ysical)g(screen)g -(space)g(when)f(displa)m(y)m(ed)390 2132 y(b)m(y)41 b(brac)m(k)m(eting) +(space)g(when)f(displa)m(y)m(ed)390 4540 y(b)m(y)41 b(brac)m(k)m(eting) i(a)e(sequence)g(of)g(suc)m(h)g(c)m(haracters)h(with)f(the)g(sp)s -(ecial)h(mark)m(ers)f Fs(RL_PROMPT_)390 2242 y(START_IGNORE)34 +(ecial)h(mark)m(ers)f Fs(RL_PROMPT_)390 4649 y(START_IGNORE)34 b Ft(and)j Fs(RL_PROMPT_END_IGNORE)32 b Ft(\(declared)39 b(in)e Fs(readline.h)e Ft(as)j(`)p Fs(\\001)p Ft(')f(and)390 -2351 y(`)p Fs(\\002)p Ft(',)31 b(resp)s(ectiv)m(ely\).)46 +4759 y(`)p Fs(\\002)p Ft(',)31 b(resp)s(ectiv)m(ely\).)46 b(This)31 b(ma)m(y)h(b)s(e)f(used)f(to)j(em)m(b)s(ed)e(terminal-sp)s -(eci\014c)h(escap)s(e)g(sequences)390 2461 y(in)e(prompts.)3350 -2665 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_set_prompt)d -Fg(\()p Ff(const)34 b(c)m(har)g(*prompt)p Fg(\))390 2775 +(eci\014c)h(escap)s(e)g(sequences)390 4869 y(in)e(prompts.)3350 +5101 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_set_prompt)d +Fg(\()p Ff(const)34 b(c)m(har)g(*prompt)p Fg(\))390 5210 y Ft(Mak)m(e)28 b(Readline)g(use)f Fj(prompt)h Ft(for)e(subsequen)m(t)h (redispla)m(y)-8 b(.)40 b(This)26 b(calls)i Fs(rl_expand_prompt\(\))390 -2884 y Ft(to)j(expand)f(the)g(prompt)g(and)g(sets)g Fs(rl_prompt)e -Ft(to)j(the)g(result.)150 3093 y Fi(2.4.7)63 b(Mo)s(difying)43 -b(T)-10 b(ext)3350 3300 y Ft([F)i(unction])-3599 b Fh(int)53 -b(rl_insert_text)d Fg(\()p Ff(const)34 b(c)m(har)g(*text)p -Fg(\))390 3410 y Ft(Insert)d Fj(text)k Ft(in)m(to)d(the)g(line)g(at)g -(the)g(curren)m(t)f(cursor)g(p)s(osition.)45 b(Returns)30 -b(the)i(n)m(um)m(b)s(er)f(of)g(c)m(har-)390 3519 y(acters)g(inserted.) -3350 3723 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_delete_text)d +5320 y Ft(to)j(expand)f(the)g(prompt)g(and)g(sets)g Fs(rl_prompt)e +Ft(to)j(the)g(result.)p eop end +%%Page: 42 46 +TeXDict begin 42 45 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(42)150 +299 y Fi(2.4.7)63 b(Mo)s(difying)43 b(T)-10 b(ext)3350 +502 y Ft([F)i(unction])-3599 b Fh(int)53 b(rl_insert_text)d +Fg(\()p Ff(const)34 b(c)m(har)g(*text)p Fg(\))390 612 +y Ft(Insert)d Fj(text)k Ft(in)m(to)d(the)g(line)g(at)g(the)g(curren)m +(t)f(cursor)g(p)s(osition.)45 b(Returns)30 b(the)i(n)m(um)m(b)s(er)f +(of)g(c)m(har-)390 721 y(acters)g(inserted.)3350 919 +y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_delete_text)d Fg(\()p Ff(in)m(t)33 b(start,)g(in)m(t)g(end)p Fg(\))390 -3833 y Ft(Delete)40 b(the)e(text)h(b)s(et)m(w)m(een)f +1028 y Ft(Delete)40 b(the)e(text)h(b)s(et)m(w)m(een)f Fj(start)i Ft(and)d Fj(end)k Ft(in)c(the)h(curren)m(t)g(line.)63 -b(Returns)36 b(the)i(n)m(um)m(b)s(er)f(of)390 3943 y(c)m(haracters)32 -b(deleted.)3350 4147 y([F)-8 b(unction])-3599 b Fh(char)54 +b(Returns)36 b(the)i(n)m(um)m(b)s(er)f(of)390 1138 y(c)m(haracters)32 +b(deleted.)3350 1335 y([F)-8 b(unction])-3599 b Fh(char)54 b(*)e(rl_copy_text)d Fg(\()p Ff(in)m(t)34 b(start,)e(in)m(t)h(end)p -Fg(\))390 4256 y Ft(Return)d(a)g(cop)m(y)h(of)g(the)g(text)g(b)s(et)m +Fg(\))390 1445 y Ft(Return)d(a)g(cop)m(y)h(of)g(the)g(text)g(b)s(et)m (w)m(een)g Fj(start)i Ft(and)d Fj(end)j Ft(in)d(the)h(curren)m(t)f -(line.)3350 4461 y([F)-8 b(unction])-3599 b Fh(int)53 +(line.)3350 1642 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_kill_text)c Fg(\()p Ff(in)m(t)34 b(start,)e(in)m(t)i(end)p -Fg(\))390 4570 y Ft(Cop)m(y)g(the)g(text)i(b)s(et)m(w)m(een)e +Fg(\))390 1752 y Ft(Cop)m(y)g(the)g(text)i(b)s(et)m(w)m(een)e Fj(start)j Ft(and)d Fj(end)j Ft(in)d(the)g(curren)m(t)g(line)g(to)h -(the)f(kill)h(ring,)g(app)s(ending)390 4680 y(or)f(prep)s(ending)e(to)j +(the)f(kill)h(ring,)g(app)s(ending)390 1862 y(or)f(prep)s(ending)e(to)j (the)f(last)h(kill)f(if)g(the)g(last)h(command)f(w)m(as)g(a)h(kill)f -(command.)51 b(The)34 b(text)h(is)390 4789 y(deleted.)51 +(command.)51 b(The)34 b(text)h(is)390 1971 y(deleted.)51 b(If)33 b Fj(start)j Ft(is)e(less)g(than)f Fj(end)p Ft(,)h(the)g(text)g (is)g(app)s(ended,)f(otherwise)h(prep)s(ended.)48 b(If)33 -b(the)390 4899 y(last)e(command)f(w)m(as)h(not)g(a)f(kill,)i(a)f(new)e -(kill)i(ring)g(slot)g(is)f(used.)3350 5103 y([F)-8 b(unction])-3599 +b(the)390 2081 y(last)e(command)f(w)m(as)h(not)g(a)f(kill,)i(a)f(new)e +(kill)i(ring)g(slot)g(is)f(used.)3350 2278 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_push_macro_input)e Fg(\()p Ff(c)m(har)35 -b(*macro)p Fg(\))390 5213 y Ft(Cause)28 b Fj(macro)33 +b(*macro)p Fg(\))390 2388 y Ft(Cause)28 b Fj(macro)33 b Ft(to)c(b)s(e)f(inserted)g(in)m(to)h(the)g(line,)g(as)f(if)h(it)f (had)g(b)s(een)g(in)m(v)m(ok)m(ed)h(b)m(y)f(a)h(k)m(ey)g(b)s(ound)d(to) -390 5322 y(a)31 b(macro.)41 b(Not)31 b(esp)s(ecially)h(useful;)e(use)g -Fs(rl_insert_text\(\))c Ft(instead.)p eop end -%%Page: 42 46 -TeXDict begin 42 45 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(42)150 -299 y Fi(2.4.8)63 b(Character)39 b(Input)3350 505 y Ft([F)-8 -b(unction])-3599 b Fh(int)53 b(rl_read_key)c Fg(\()p -Ff(v)m(oid)p Fg(\))390 615 y Ft(Return)29 b(the)g(next)h(c)m(haracter)h -(a)m(v)-5 b(ailable)32 b(from)d(Readline's)h(curren)m(t)f(input)g -(stream.)41 b(This)28 b(han-)390 724 y(dles)e(input)g(inserted)g(in)m -(to)i(the)e(input)g(stream)h(via)g Fj(rl)p 2226 724 28 -4 v 40 w(p)s(ending)p 2583 724 V 38 w(input)h Ft(\(see)f(Section)h(2.3) -f([Read-)390 834 y(line)40 b(V)-8 b(ariables],)43 b(page)d(29\))g(and)f +390 2497 y(a)31 b(macro.)41 b(Not)31 b(esp)s(ecially)h(useful;)e(use)g +Fs(rl_insert_text\(\))c Ft(instead.)150 2703 y Fi(2.4.8)63 +b(Character)39 b(Input)3350 2906 y Ft([F)-8 b(unction])-3599 +b Fh(int)53 b(rl_read_key)c Fg(\()p Ff(v)m(oid)p Fg(\))390 +3016 y Ft(Return)29 b(the)g(next)h(c)m(haracter)h(a)m(v)-5 +b(ailable)32 b(from)d(Readline's)h(curren)m(t)f(input)g(stream.)41 +b(This)28 b(han-)390 3126 y(dles)e(input)g(inserted)g(in)m(to)i(the)e +(input)g(stream)h(via)g Fj(rl)p 2226 3126 28 4 v 40 w(p)s(ending)p +2583 3126 V 38 w(input)h Ft(\(see)f(Section)h(2.3)f([Read-)390 +3235 y(line)40 b(V)-8 b(ariables],)43 b(page)d(29\))g(and)f Fs(rl_stuff_char\(\))p Ft(,)f(macros,)k(and)d(c)m(haracters)h(read)f -(from)390 943 y(the)34 b(k)m(eyb)s(oard.)52 b(While)35 +(from)390 3345 y(the)34 b(k)m(eyb)s(oard.)52 b(While)35 b(w)m(aiting)g(for)f(input,)g(this)g(function)g(will)g(call)i(an)m(y)e -(function)g(assigned)390 1053 y(to)d(the)g Fs(rl_event_hook)26 -b Ft(v)-5 b(ariable.)3350 1256 y([F)d(unction])-3599 +(function)g(assigned)390 3454 y(to)d(the)g Fs(rl_event_hook)26 +b Ft(v)-5 b(ariable.)3350 3652 y([F)d(unction])-3599 b Fh(int)53 b(rl_getc)48 b Fg(\()p Ff(FILE)33 b(*stream)p -Fg(\))390 1365 y Ft(Return)20 b(the)i(next)f(c)m(haracter)i(a)m(v)-5 +Fg(\))390 3761 y Ft(Return)20 b(the)i(next)f(c)m(haracter)i(a)m(v)-5 b(ailable)24 b(from)c Fj(stream)p Ft(,)k(whic)m(h)d(is)g(assumed)g(to)h -(b)s(e)e(the)i(k)m(eyb)s(oard.)3350 1568 y([F)-8 b(unction])-3599 +(b)s(e)e(the)i(k)m(eyb)s(oard.)3350 3959 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_stuff_char)d Fg(\()p Ff(in)m(t)33 b(c)p -Fg(\))390 1678 y Ft(Insert)f Fj(c)39 b Ft(in)m(to)34 +Fg(\))390 4068 y Ft(Insert)f Fj(c)39 b Ft(in)m(to)34 b(the)f(Readline)g(input)f(stream.)49 b(It)33 b(will)g(b)s(e)f Fs(")p Ft(read)p Fs(")g Ft(b)s(efore)h(Readline)g(attempts)390 -1787 y(to)27 b(read)g(c)m(haracters)h(from)f(the)g(terminal)g(with)f +4178 y(to)27 b(read)g(c)m(haracters)h(from)f(the)g(terminal)g(with)f Fs(rl_read_key\(\))p Ft(.)36 b(Up)27 b(to)g(512)h(c)m(haracters)g(ma)m -(y)390 1897 y(b)s(e)i(pushed)f(bac)m(k.)42 b Fs(rl_stuff_char)27 +(y)390 4288 y(b)s(e)i(pushed)f(bac)m(k.)42 b Fs(rl_stuff_char)27 b Ft(returns)i(1)i(if)f(the)h(c)m(haracter)h(w)m(as)f(successfully)g -(inserted;)390 2007 y(0)g(otherwise.)3350 2209 y([F)-8 +(inserted;)390 4397 y(0)g(otherwise.)3350 4595 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_execute_next)d Fg(\()p -Ff(in)m(t)34 b(c)p Fg(\))390 2319 y Ft(Mak)m(e)j Fj(c)42 +Ff(in)m(t)34 b(c)p Fg(\))390 4704 y Ft(Mak)m(e)j Fj(c)42 b Ft(b)s(e)35 b(the)h(next)f(command)h(to)g(b)s(e)f(executed)i(when)d -Fs(rl_read_key\(\))e Ft(is)k(called.)58 b(This)390 2429 -y(sets)31 b Fj(rl)p 635 2429 V 40 w(p)s(ending)p 992 -2429 V 38 w(input)p Ft(.)3350 2631 y([F)-8 b(unction])-3599 +Fs(rl_read_key\(\))e Ft(is)k(called.)58 b(This)390 4814 +y(sets)31 b Fj(rl)p 635 4814 V 40 w(p)s(ending)p 992 +4814 V 38 w(input)p Ft(.)3350 5011 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_clear_pending_inpu)q(t)e Fg(\()p Ff(v)m(oid)p -Fg(\))390 2741 y Ft(Unset)42 b Fj(rl)p 729 2741 V 40 -w(p)s(ending)p 1086 2741 V 38 w(input)p Ft(,)i(e\013ectiv)m(ely)h +Fg(\))390 5121 y Ft(Unset)42 b Fj(rl)p 729 5121 V 40 +w(p)s(ending)p 1086 5121 V 38 w(input)p Ft(,)i(e\013ectiv)m(ely)h (negating)e(the)f(e\013ect)h(of)f(an)m(y)g(previous)f(call)i(to)g -Fs(rl_)390 2851 y(execute_next\(\))p Ft(.)59 b(This)36 +Fs(rl_)390 5230 y(execute_next\(\))p Ft(.)59 b(This)36 b(w)m(orks)i(only)g(if)f(the)h(p)s(ending)e(input)h(has)g(not)h -(already)g(b)s(een)f(read)390 2960 y(with)30 b Fs(rl_read_key\(\))p -Ft(.)3350 3163 y([F)-8 b(unction])-3599 b Fh(int)53 b -(rl_set_keyboard_input)q(_tim)q(eou)q(t)e Fg(\()p Ff(in)m(t)34 -b(u)p Fg(\))390 3273 y Ft(While)41 b(w)m(aiting)g(for)f(k)m(eyb)s(oard) -g(input)f(in)h Fs(rl_read_key\(\))p Ft(,)f(Readline)i(will)f(w)m(ait)h -(for)f Fj(u)g Ft(mi-)390 3382 y(croseconds)31 b(for)g(input)f(b)s -(efore)g(calling)j(an)m(y)e(function)f(assigned)i(to)f -Fs(rl_event_hook)p Ft(.)39 b Fj(u)30 b Ft(m)m(ust)390 -3492 y(b)s(e)h(greater)i(than)f(or)g(equal)g(to)h(zero)f(\(a)h -(zero-length)g(timeout)g(is)f(equiv)-5 b(alen)m(t)33 -b(to)g(a)f(p)s(oll\).)45 b(The)390 3601 y(default)31 -b(w)m(aiting)g(p)s(erio)s(d)e(is)i(one-ten)m(th)g(of)g(a)g(second.)40 -b(Returns)30 b(the)g(old)h(timeout)g(v)-5 b(alue.)3350 -3804 y([F)d(unction])-3599 b Fh(int)53 b(rl_set_timeout)d +(already)g(b)s(een)f(read)390 5340 y(with)30 b Fs(rl_read_key\(\))p +Ft(.)p eop end +%%Page: 43 47 +TeXDict begin 43 46 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(43)3350 +299 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_set_keyboard_input)q +(_tim)q(eou)q(t)e Fg(\()p Ff(in)m(t)34 b(u)p Fg(\))390 +408 y Ft(While)41 b(w)m(aiting)g(for)f(k)m(eyb)s(oard)g(input)f(in)h +Fs(rl_read_key\(\))p Ft(,)f(Readline)i(will)f(w)m(ait)h(for)f +Fj(u)g Ft(mi-)390 518 y(croseconds)31 b(for)g(input)f(b)s(efore)g +(calling)j(an)m(y)e(function)f(assigned)i(to)f Fs(rl_event_hook)p +Ft(.)39 b Fj(u)30 b Ft(m)m(ust)390 628 y(b)s(e)h(greater)i(than)f(or)g +(equal)g(to)h(zero)f(\(a)h(zero-length)g(timeout)g(is)f(equiv)-5 +b(alen)m(t)33 b(to)g(a)f(p)s(oll\).)45 b(The)390 737 +y(default)31 b(w)m(aiting)g(p)s(erio)s(d)e(is)i(one-ten)m(th)g(of)g(a)g +(second.)40 b(Returns)30 b(the)g(old)h(timeout)g(v)-5 +b(alue.)3350 957 y([F)d(unction])-3599 b Fh(int)53 b(rl_set_timeout)d Fg(\()p Ff(unsigned)35 b(in)m(t)e(secs,)h(unsigned)h(in)m(t)e(usecs)p -Fg(\))390 3914 y Ft(Set)f(a)g(timeout)h(for)f(subsequen)m(t)f(calls)j +Fg(\))390 1067 y Ft(Set)f(a)g(timeout)h(for)f(subsequen)m(t)f(calls)j (to)e Fs(readline\(\))p Ft(.)43 b(If)31 b(Readline)i(do)s(es)f(not)g -(read)g(a)g(com-)390 4024 y(plete)37 b(line,)h(or)e(the)g(n)m(um)m(b)s +(read)g(a)g(com-)390 1177 y(plete)37 b(line,)h(or)e(the)g(n)m(um)m(b)s (er)f(of)h(c)m(haracters)i(sp)s(eci\014ed)d(b)m(y)h Fs -(rl_num_chars_to_read)p Ft(,)c(b)s(efore)390 4133 y(the)h(duration)g +(rl_num_chars_to_read)p Ft(,)c(b)s(efore)390 1286 y(the)h(duration)g (sp)s(eci\014ed)g(b)m(y)g Fj(secs)38 b Ft(\(in)33 b(seconds\))h(and)e Fj(usecs)37 b Ft(\(microseconds\),)f(it)d(returns)g(and)390 -4243 y(sets)22 b Fs(RL_STATE_TIMEOUT)17 b Ft(in)k Fs(rl_readline_state) +1396 y(sets)22 b Fs(RL_STATE_TIMEOUT)17 b Ft(in)k Fs(rl_readline_state) p Ft(.)33 b(P)m(assing)22 b(0)g(for)f Fs(secs)g Ft(and)g -Fs(usecs)f Ft(cancels)390 4352 y(an)m(y)k(previously)f(set)h(timeout;)j +Fs(usecs)f Ft(cancels)390 1505 y(an)m(y)k(previously)f(set)h(timeout;)j (the)d(con)m(v)m(enience)h(macro)f Fs(rl_clear_timeout\(\))19 -b Ft(is)k(shorthand)390 4462 y(for)30 b(this.)41 b(Returns)29 +b Ft(is)k(shorthand)390 1615 y(for)30 b(this.)41 b(Returns)29 b(0)i(if)f(the)h(timeout)g(is)g(set)g(successfully)-8 -b(.)3350 4665 y([F)g(unction])-3599 b Fh(int)53 b(rl_timeout_remaining) +b(.)3350 1835 y([F)g(unction])-3599 b Fh(int)53 b(rl_timeout_remaining) f Fg(\()p Ff(unsigned)33 b(in)m(t)f(*secs,)h(unsigned)g(in)m(t)f -(*usecs)p Fg(\))390 4774 y Ft(Return)38 b(the)h(n)m(um)m(b)s(er)e(of)i +(*usecs)p Fg(\))390 1945 y Ft(Return)38 b(the)h(n)m(um)m(b)s(er)e(of)i (seconds)f(and)g(microseconds)h(remaining)g(in)f(the)h(curren)m(t)f -(timeout)390 4884 y(duration)26 b(in)g Fj(*secs)31 b +(timeout)390 2054 y(duration)26 b(in)g Fj(*secs)31 b Ft(and)26 b Fj(*usecs)p Ft(,)i(resp)s(ectiv)m(ely)-8 b(.)41 b(Both)27 b Fj(*secs)k Ft(and)26 b Fj(*usecs)k -Ft(m)m(ust)c(b)s(e)g(non-NULL)390 4994 y(to)j(return)f(an)m(y)h(v)-5 +Ft(m)m(ust)c(b)s(e)g(non-NULL)390 2164 y(to)j(return)f(an)m(y)h(v)-5 b(alues.)40 b(The)29 b(return)e(v)-5 b(alue)29 b(is)g(-1)g(on)g(error)f -(or)h(when)e(there)i(is)g(no)f(timeout)i(set,)390 5103 +(or)h(when)e(there)i(is)g(no)f(timeout)i(set,)390 2274 y(0)35 b(when)e(the)i(timeout)h(has)e(expired)g(\(lea)m(ving)j Fj(*secs)i Ft(and)34 b Fj(*usecs)39 b Ft(unc)m(hanged\),)c(and)f(1)h -(if)g(the)390 5213 y(timeout)27 b(has)e(not)h(expired.)38 +(if)g(the)390 2383 y(timeout)27 b(has)e(not)h(expired.)38 b(If)26 b(either)g(of)f Fj(secs)30 b Ft(and)25 b Fj(usecs)k Ft(is)d Fs(NULL)p Ft(,)g(the)f(return)g(v)-5 b(alue)26 -b(indicates)390 5322 y(whether)k(the)g(timeout)i(has)e(expired.)p -eop end -%%Page: 43 47 -TeXDict begin 43 46 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(43)150 -299 y Fi(2.4.9)63 b(T)-10 b(erminal)41 b(Managemen)m(t)3350 -496 y Ft([F)-8 b(unction])-3599 b Fh(void)54 b(rl_prep_terminal)c -Fg(\()p Ff(in)m(t)33 b(meta)p 1704 496 30 5 v 44 w(\015ag)p -Fg(\))390 606 y Ft(Mo)s(dify)42 b(the)h(terminal)g(settings)g(for)f +b(indicates)390 2493 y(whether)k(the)g(timeout)i(has)e(expired.)150 +2710 y Fi(2.4.9)63 b(T)-10 b(erminal)41 b(Managemen)m(t)3350 +2925 y Ft([F)-8 b(unction])-3599 b Fh(void)54 b(rl_prep_terminal)c +Fg(\()p Ff(in)m(t)33 b(meta)p 1704 2925 30 5 v 44 w(\015ag)p +Fg(\))390 3034 y Ft(Mo)s(dify)42 b(the)h(terminal)g(settings)g(for)f (Readline's)i(use,)h(so)e Fs(readline\(\))c Ft(can)k(read)f(a)h(single) -390 716 y(c)m(haracter)32 b(at)g(a)f(time)h(from)e(the)h(k)m(eyb)s -(oard.)43 b(The)30 b Fj(meta)p 2376 716 28 4 v 41 w(\015ag)39 -b Ft(argumen)m(t)31 b(should)f(b)s(e)g(non-zero)390 825 +390 3144 y(c)m(haracter)32 b(at)g(a)f(time)h(from)e(the)h(k)m(eyb)s +(oard.)43 b(The)30 b Fj(meta)p 2376 3144 28 4 v 41 w(\015ag)39 +b Ft(argumen)m(t)31 b(should)f(b)s(e)g(non-zero)390 3254 y(if)g(Readline)h(should)f(read)g(eigh)m(t-bit)i(input.)3350 -1011 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_deprep_terminal)c -Fg(\()p Ff(v)m(oid)p Fg(\))390 1121 y Ft(Undo)31 b(the)h(e\013ects)h +3474 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_deprep_terminal)c +Fg(\()p Ff(v)m(oid)p Fg(\))390 3583 y Ft(Undo)31 b(the)h(e\013ects)h (of)f Fs(rl_prep_terminal\(\))p Ft(,)27 b(lea)m(ving)33 b(the)f(terminal)g(in)f(the)h(state)h(in)e(whic)m(h)390 -1230 y(it)g(w)m(as)g(b)s(efore)f(the)g(most)h(recen)m(t)g(call)h(to)f -Fs(rl_prep_terminal\(\))p Ft(.)3350 1416 y([F)-8 b(unction])-3599 +3693 y(it)g(w)m(as)g(b)s(efore)f(the)g(most)h(recen)m(t)g(call)h(to)f +Fs(rl_prep_terminal\(\))p Ft(.)3350 3913 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_tty_set_default_bindi)q(ngs)e Fg(\()p -Ff(Keymap)34 b(kmap)p Fg(\))390 1526 y Ft(Read)j(the)g(op)s(erating)h +Ff(Keymap)34 b(kmap)p Fg(\))390 4023 y Ft(Read)j(the)g(op)s(erating)h (system's)f(terminal)g(editing)h(c)m(haracters)g(\(as)g(w)m(ould)e(b)s -(e)h(displa)m(y)m(ed)g(b)m(y)390 1635 y Fs(stty)p Ft(\))30 +(e)h(displa)m(y)m(ed)g(b)m(y)390 4132 y Fs(stty)p Ft(\))30 b(to)h(their)f(Readline)h(equiv)-5 b(alen)m(ts.)42 b(The)30 b(bindings)f(are)i(p)s(erformed)e(in)h Fj(kmap)p Ft(.)3350 -1821 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_tty_unset_default_bin)q -(din)q(gs)e Fg(\()p Ff(Keymap)34 b(kmap)p Fg(\))390 1931 +4353 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_tty_unset_default_bin)q +(din)q(gs)e Fg(\()p Ff(Keymap)34 b(kmap)p Fg(\))390 4462 y Ft(Reset)f(the)f(bindings)e(manipulated)i(b)m(y)g Fs (rl_tty_set_default_bind)o(ing)o(s)26 b Ft(so)32 b(that)g(the)g(ter-) -390 2040 y(minal)40 b(editing)g(c)m(haracters)h(are)f(b)s(ound)e(to)i +390 4572 y(minal)40 b(editing)g(c)m(haracters)h(are)f(b)s(ound)e(to)i Fs(rl_insert)p Ft(.)66 b(The)39 b(bindings)f(are)i(p)s(erformed)e(in) -390 2150 y Fj(kmap)p Ft(.)3350 2336 y([F)-8 b(unction])-3599 +390 4681 y Fj(kmap)p Ft(.)3350 4902 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_tty_set_echoing)e Fg(\()p Ff(in)m(t)34 -b(v)-6 b(alue)p Fg(\))390 2445 y Ft(Set)48 b(Readline's)g(idea)g(of)g +b(v)-6 b(alue)p Fg(\))390 5011 y Ft(Set)48 b(Readline's)g(idea)g(of)g (whether)f(or)g(not)h(it)g(is)f(ec)m(hoing)i(output)e(to)i(its)e -(output)h(stream)390 2555 y(\()p Fj(rl)p 492 2555 V 40 +(output)h(stream)390 5121 y(\()p Fj(rl)p 492 5121 V 40 w(outstream)p Ft(\).)j(If)32 b Fj(v)-5 b(alue)39 b Ft(is)34 b(0,)g(Readline)g(do)s(es)f(not)h(displa)m(y)f(output)g(to)h -Fj(rl)p 3115 2555 V 40 w(outstream)p Ft(;)i(an)m(y)390 -2665 y(other)43 b(v)-5 b(alue)43 b(enables)h(output.)77 +Fj(rl)p 3115 5121 V 40 w(outstream)p Ft(;)i(an)m(y)390 +5230 y(other)43 b(v)-5 b(alue)43 b(enables)h(output.)77 b(The)43 b(initial)h(v)-5 b(alue)43 b(is)g(set)g(when)f(Readline)i -(initializes)h(the)390 2774 y(terminal)31 b(settings.)42 +(initializes)h(the)390 5340 y(terminal)31 b(settings.)42 b(This)29 b(function)h(returns)f(the)i(previous)f(v)-5 -b(alue.)3350 2960 y([F)d(unction])-3599 b Fh(int)53 b -(rl_reset_terminal)e Fg(\()p Ff(const)34 b(c)m(har)g(*terminal)p -2232 2960 30 5 v 43 w(name)p Fg(\))390 3070 y Ft(Reinitialize)26 +b(alue.)p eop end +%%Page: 44 48 +TeXDict begin 44 47 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(44)3350 +299 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_reset_terminal)e +Fg(\()p Ff(const)34 b(c)m(har)g(*terminal)p 2232 299 +30 5 v 43 w(name)p Fg(\))390 408 y Ft(Reinitialize)26 b(Readline's)f(idea)f(of)g(the)g(terminal)h(settings)f(using)g -Fj(terminal)p 2977 3070 28 4 v 40 w(name)29 b Ft(as)24 -b(the)g(termi-)390 3179 y(nal)32 b(t)m(yp)s(e)g(\(e.g.,)i -Fs(vt100)p Ft(\).)44 b(If)31 b Fj(terminal)p 1753 3179 +Fj(terminal)p 2977 408 28 4 v 40 w(name)29 b Ft(as)24 +b(the)g(termi-)390 518 y(nal)32 b(t)m(yp)s(e)g(\(e.g.,)i +Fs(vt100)p Ft(\).)44 b(If)31 b Fj(terminal)p 1753 518 V 41 w(name)37 b Ft(is)31 b Fs(NULL)p Ft(,)h(the)g(v)-5 b(alue)32 b(of)g(the)g Fs(TERM)e Ft(en)m(vironmen)m(t)390 -3289 y(v)-5 b(ariable)31 b(is)g(used.)150 3489 y Fi(2.4.10)63 -b(Utilit)m(y)40 b(F)-10 b(unctions)3350 3686 y Ft([F)i(unction])-3599 +628 y(v)-5 b(ariable)31 b(is)g(used.)150 822 y Fi(2.4.10)63 +b(Utilit)m(y)40 b(F)-10 b(unctions)3350 1013 y Ft([F)i(unction])-3599 b Fh(int)53 b(rl_save_state)d Fg(\()p Ff(struct)34 b(readline)p -1759 3686 30 5 v 44 w(state)f(*sp)p Fg(\))390 3796 y +1759 1013 30 5 v 44 w(state)f(*sp)p Fg(\))390 1123 y Ft(Sa)m(v)m(e)d(a)f(snapshot)e(of)i(Readline's)g(in)m(ternal)g(state)h (to)f Fj(sp)p Ft(.)40 b(The)28 b(con)m(ten)m(ts)i(of)e(the)h -Fj(readline)p 3518 3796 28 4 v 40 w(state)390 3906 y +Fj(readline)p 3518 1123 28 4 v 40 w(state)390 1232 y Ft(structure)g(are)g(do)s(cumen)m(ted)g(in)g Fs(readline.h)p Ft(.)38 b(The)28 b(caller)j(is)e(resp)s(onsible)f(for)h(allo)s(cating)j -(the)390 4015 y(structure.)3350 4201 y([F)-8 b(unction])-3599 +(the)390 1342 y(structure.)3350 1518 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_restore_state)e Fg(\()p Ff(struct)34 -b(readline)p 1916 4201 30 5 v 44 w(state)f(*sp)p Fg(\))390 -4311 y Ft(Restore)23 b(Readline's)g(in)m(ternal)g(state)g(to)g(that)g +b(readline)p 1916 1518 30 5 v 44 w(state)f(*sp)p Fg(\))390 +1628 y Ft(Restore)23 b(Readline's)g(in)m(ternal)g(state)g(to)g(that)g (stored)f(in)g Fj(sp)p Ft(,)i(whic)m(h)d(m)m(ust)h(ha)m(v)m(e)i(b)s -(een)d(sa)m(v)m(ed)i(b)m(y)g(a)390 4420 y(call)30 b(to)g +(een)d(sa)m(v)m(ed)i(b)m(y)g(a)390 1737 y(call)30 b(to)g Fs(rl_save_state)p Ft(.)37 b(The)28 b(con)m(ten)m(ts)j(of)e(the)g -Fj(readline)p 2470 4420 28 4 v 41 w(state)35 b Ft(structure)29 -b(are)g(do)s(cumen)m(ted)390 4530 y(in)h Fs(readline.h)p +Fj(readline)p 2470 1737 28 4 v 41 w(state)35 b Ft(structure)29 +b(are)g(do)s(cumen)m(ted)390 1847 y(in)h Fs(readline.h)p Ft(.)38 b(The)30 b(caller)i(is)e(resp)s(onsible)f(for)i(freeing)f(the)h -(structure.)3350 4716 y([F)-8 b(unction])-3599 b Fh(void)54 +(structure.)3350 2023 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_free)47 b Fg(\()p Ff(v)m(oid)33 b(*mem)p Fg(\))390 -4825 y Ft(Deallo)s(cate)25 b(the)c(memory)g(p)s(oin)m(ted)g(to)h(b)m(y) +2133 y Ft(Deallo)s(cate)25 b(the)c(memory)g(p)s(oin)m(ted)g(to)h(b)m(y) f Fj(mem)p Ft(.)38 b Fj(mem)21 b Ft(m)m(ust)g(ha)m(v)m(e)i(b)s(een)d -(allo)s(cated)j(b)m(y)e Fs(malloc)p Ft(.)3350 5011 y([F)-8 +(allo)s(cated)j(b)m(y)e Fs(malloc)p Ft(.)3350 2309 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_replace_line)c Fg(\()p Ff(const)34 b(c)m(har)f(*text,)g(in)m(t)g(clear)p 2406 -5011 30 5 v 44 w(undo)p Fg(\))390 5121 y Ft(Replace)41 +2309 30 5 v 44 w(undo)p Fg(\))390 2419 y Ft(Replace)41 b(the)e(con)m(ten)m(ts)i(of)f Fs(rl_line_buffer)35 b Ft(with)k Fj(text)p Ft(.)69 b(The)39 b(p)s(oin)m(t)h(and)e(mark)h(are)h -(pre-)390 5230 y(serv)m(ed,)27 b(if)e(p)s(ossible.)39 -b(If)25 b Fj(clear)p 1422 5230 28 4 v 41 w(undo)k Ft(is)d(non-zero,)h +(pre-)390 2528 y(serv)m(ed,)27 b(if)e(p)s(ossible.)39 +b(If)25 b Fj(clear)p 1422 2528 28 4 v 41 w(undo)k Ft(is)d(non-zero,)h (the)f(undo)e(list)i(asso)s(ciated)h(with)e(the)h(curren)m(t)390 -5340 y(line)31 b(is)f(cleared.)p eop end -%%Page: 44 48 -TeXDict begin 44 47 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(44)3350 -299 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_extend_line_buffer)d -Fg(\()p Ff(in)m(t)34 b(len)p Fg(\))390 408 y Ft(Ensure)29 -b(that)h Fs(rl_line_buffer)d Ft(has)j(enough)f(space)i(to)g(hold)f -Fj(len)g Ft(c)m(haracters,)i(p)s(ossibly)d(real-)390 -518 y(lo)s(cating)j(it)f(if)f(necessary)-8 b(.)3350 756 -y([F)g(unction])-3599 b Fh(int)53 b(rl_initialize)d Fg(\()p -Ff(v)m(oid)p Fg(\))390 865 y Ft(Initialize)39 b(or)e(re-initialize)i -(Readline's)f(in)m(ternal)f(state.)62 b(It's)37 b(not)g(strictly)h -(necessary)f(to)h(call)390 975 y(this;)31 b Fs(readline\(\))c -Ft(calls)32 b(it)f(b)s(efore)f(reading)g(an)m(y)h(input.)3350 -1212 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_ding)48 -b Fg(\()p Ff(v)m(oid)p Fg(\))390 1322 y Ft(Ring)30 b(the)h(terminal)g -(b)s(ell,)f(ob)s(eying)h(the)f(setting)i(of)e Fs(bell-style)p -Ft(.)3350 1559 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_alphabetic)d -Fg(\()p Ff(in)m(t)33 b(c)p Fg(\))390 1669 y Ft(Return)d(1)g(if)h +2638 y(line)31 b(is)f(cleared.)3350 2814 y([F)-8 b(unction])-3599 +b Fh(void)54 b(rl_extend_line_buffer)d Fg(\()p Ff(in)m(t)34 +b(len)p Fg(\))390 2924 y Ft(Ensure)29 b(that)h Fs(rl_line_buffer)d +Ft(has)j(enough)f(space)i(to)g(hold)f Fj(len)g Ft(c)m(haracters,)i(p)s +(ossibly)d(real-)390 3034 y(lo)s(cating)j(it)f(if)f(necessary)-8 +b(.)3350 3210 y([F)g(unction])-3599 b Fh(int)53 b(rl_initialize)d +Fg(\()p Ff(v)m(oid)p Fg(\))390 3319 y Ft(Initialize)39 +b(or)e(re-initialize)i(Readline's)f(in)m(ternal)f(state.)62 +b(It's)37 b(not)g(strictly)h(necessary)f(to)h(call)390 +3429 y(this;)31 b Fs(readline\(\))c Ft(calls)32 b(it)f(b)s(efore)f +(reading)g(an)m(y)h(input.)3350 3605 y([F)-8 b(unction])-3599 +b Fh(int)53 b(rl_ding)48 b Fg(\()p Ff(v)m(oid)p Fg(\))390 +3715 y Ft(Ring)30 b(the)h(terminal)g(b)s(ell,)f(ob)s(eying)h(the)f +(setting)i(of)e Fs(bell-style)p Ft(.)3350 3891 y([F)-8 +b(unction])-3599 b Fh(int)53 b(rl_alphabetic)d Fg(\()p +Ff(in)m(t)33 b(c)p Fg(\))390 4001 y Ft(Return)d(1)g(if)h Fj(c)36 b Ft(is)30 b(an)h(alphab)s(etic)g(c)m(haracter.)3350 -1906 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_display_match_list)d +4177 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_display_match_list)d Fg(\()p Ff(c)m(har)35 b(**matc)m(hes,)e(in)m(t)g(len,)h(in)m(t)f(max)p -Fg(\))390 2016 y Ft(A)i(con)m(v)m(enience)h(function)e(for)g(displa)m +Fg(\))390 4287 y Ft(A)i(con)m(v)m(enience)h(function)e(for)g(displa)m (ying)h(a)g(list)g(of)g(strings)f(in)g(columnar)g(format)h(on)f(Read-) -390 2126 y(line's)g(output)f(stream.)51 b Fs(matches)31 +390 4396 y(line's)g(output)f(stream.)51 b Fs(matches)31 b Ft(is)j(the)f(list)i(of)e(strings,)i(in)e(argv)h(format,)h(suc)m(h)e -(as)h(a)g(list)g(of)390 2235 y(completion)26 b(matc)m(hes.)39 +(as)h(a)g(list)g(of)390 4506 y(completion)26 b(matc)m(hes.)39 b Fs(len)24 b Ft(is)g(the)g(n)m(um)m(b)s(er)f(of)i(strings)f(in)g Fs(matches)p Ft(,)f(and)h Fs(max)f Ft(is)i(the)f(length)h(of)390 -2345 y(the)h(longest)i(string)e(in)g Fs(matches)p Ft(.)37 +4616 y(the)h(longest)i(string)e(in)g Fs(matches)p Ft(.)37 b(This)25 b(function)h(uses)g(the)g(setting)i(of)e Fs -(print-completions-)390 2454 y(horizontally)33 b Ft(to)k(select)h(ho)m +(print-completions-)390 4725 y(horizontally)33 b Ft(to)k(select)h(ho)m (w)e(the)g(matc)m(hes)i(are)e(displa)m(y)m(ed)h(\(see)g(Section)g -(1.3.1)h([Readline)390 2564 y(Init)30 b(File)h(Syn)m(tax],)g(page)g +(1.3.1)h([Readline)390 4835 y(Init)30 b(File)h(Syn)m(tax],)g(page)g (4\).)42 b(When)29 b(displa)m(ying)i(completions,)h(this)e(function)g -(sets)g(the)g(n)m(um-)390 2674 y(b)s(er)23 b(of)g(columns)g(used)g(for) +(sets)g(the)g(n)m(um-)390 4944 y(b)s(er)23 b(of)g(columns)g(used)g(for) h(displa)m(y)f(to)i(the)e(v)-5 b(alue)24 b(of)g Fs (completion-display-width)p Ft(,)19 b(the)k(v)-5 b(alue)390 -2783 y(of)31 b(the)f(en)m(vironmen)m(t)h(v)-5 b(ariable)31 +5054 y(of)31 b(the)f(en)m(vironmen)m(t)h(v)-5 b(ariable)31 b Fs(COLUMNS)p Ft(,)e(or)h(the)h(screen)f(width,)g(in)g(that)h(order.) -275 3021 y(The)g(follo)m(wing)j(are)e(implemen)m(ted)h(as)f(macros,)h +275 5230 y(The)g(follo)m(wing)j(are)e(implemen)m(ted)h(as)f(macros,)h (de\014ned)e(in)h Fs(chardefs.h)p Ft(.)43 b(Applications)33 -b(should)150 3130 y(refrain)d(from)g(using)g(them.)3350 -3368 y([F)-8 b(unction])-3599 b Fh(int)53 b(_rl_uppercase_p)d -Fg(\()p Ff(in)m(t)34 b(c)p Fg(\))390 3477 y Ft(Return)c(1)g(if)h +b(should)150 5340 y(refrain)d(from)g(using)g(them.)p +eop end +%%Page: 45 49 +TeXDict begin 45 48 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(45)3350 +299 y([F)-8 b(unction])-3599 b Fh(int)53 b(_rl_uppercase_p)d +Fg(\()p Ff(in)m(t)34 b(c)p Fg(\))390 408 y Ft(Return)c(1)g(if)h Fj(c)36 b Ft(is)30 b(an)h(upp)s(ercase)e(alphab)s(etic)i(c)m(haracter.) -3350 3715 y([F)-8 b(unction])-3599 b Fh(int)53 b(_rl_lowercase_p)d -Fg(\()p Ff(in)m(t)34 b(c)p Fg(\))390 3824 y Ft(Return)c(1)g(if)h +3350 589 y([F)-8 b(unction])-3599 b Fh(int)53 b(_rl_lowercase_p)d +Fg(\()p Ff(in)m(t)34 b(c)p Fg(\))390 698 y Ft(Return)c(1)g(if)h Fj(c)36 b Ft(is)30 b(a)h(lo)m(w)m(ercase)i(alphab)s(etic)e(c)m -(haracter.)3350 4062 y([F)-8 b(unction])-3599 b Fh(int)53 +(haracter.)3350 878 y([F)-8 b(unction])-3599 b Fh(int)53 b(_rl_digit_p)c Fg(\()p Ff(in)m(t)34 b(c)p Fg(\))390 -4171 y Ft(Return)c(1)g(if)h Fj(c)36 b Ft(is)30 b(a)h(n)m(umeric)f(c)m -(haracter.)3350 4409 y([F)-8 b(unction])-3599 b Fh(int)53 +988 y Ft(Return)c(1)g(if)h Fj(c)36 b Ft(is)30 b(a)h(n)m(umeric)f(c)m +(haracter.)3350 1168 y([F)-8 b(unction])-3599 b Fh(int)53 b(_rl_to_upper)c Fg(\()p Ff(in)m(t)34 b(c)p Fg(\))390 -4519 y Ft(If)23 b Fj(c)30 b Ft(is)24 b(a)g(lo)m(w)m(ercase)i(alphab)s +1278 y Ft(If)23 b Fj(c)30 b Ft(is)24 b(a)g(lo)m(w)m(ercase)i(alphab)s (etic)e(c)m(haracter,)j(return)c(the)h(corresp)s(onding)e(upp)s(ercase) -h(c)m(haracter.)3350 4756 y([F)-8 b(unction])-3599 b +h(c)m(haracter.)3350 1458 y([F)-8 b(unction])-3599 b Fh(int)53 b(_rl_to_lower)c Fg(\()p Ff(in)m(t)34 b(c)p -Fg(\))390 4866 y Ft(If)28 b Fj(c)35 b Ft(is)29 b(an)g(upp)s(ercase)f +Fg(\))390 1567 y Ft(If)28 b Fj(c)35 b Ft(is)29 b(an)g(upp)s(ercase)f (alphab)s(etic)h(c)m(haracter,)i(return)d(the)h(corresp)s(onding)f(lo)m -(w)m(ercase)j(c)m(harac-)390 4975 y(ter.)3350 5213 y([F)-8 +(w)m(ercase)j(c)m(harac-)390 1677 y(ter.)3350 1857 y([F)-8 b(unction])-3599 b Fh(int)53 b(_rl_digit_value)d Fg(\()p -Ff(in)m(t)34 b(c)p Fg(\))390 5322 y Ft(If)c Fj(c)36 b +Ff(in)m(t)34 b(c)p Fg(\))390 1967 y Ft(If)c Fj(c)36 b Ft(is)31 b(a)f(n)m(um)m(b)s(er,)g(return)f(the)h(v)-5 -b(alue)31 b(it)g(represen)m(ts.)p eop end -%%Page: 45 49 -TeXDict begin 45 48 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(45)150 -299 y Fi(2.4.11)63 b(Miscellaneous)42 b(F)-10 b(unctions)3350 -489 y Ft([F)i(unction])-3599 b Fh(int)53 b(rl_macro_bind)d -Fg(\()p Ff(const)34 b(c)m(har)g(*k)m(eyseq,)e(const)i(c)m(har)g -(*macro,)565 598 y(Keymap)g(map)p Fg(\))390 708 y Ft(Bind)23 -b(the)g(k)m(ey)h(sequence)g Fj(k)m(eyseq)i Ft(to)e(in)m(v)m(ok)m(e)h -(the)f(macro)f Fj(macro)p Ft(.)39 b(The)23 b(binding)f(is)i(p)s -(erformed)d(in)390 817 y Fj(map)p Ft(.)39 b(When)28 b -Fj(k)m(eyseq)i Ft(is)e(in)m(v)m(ok)m(ed,)i(the)d Fj(macro)33 -b Ft(will)28 b(b)s(e)f(inserted)g(in)m(to)i(the)e(line.)41 -b(This)26 b(function)390 927 y(is)k(deprecated;)i(use)e -Fs(rl_generic_bind\(\))25 b Ft(instead.)3350 1101 y([F)-8 +b(alue)31 b(it)g(represen)m(ts.)150 2163 y Fi(2.4.11)63 +b(Miscellaneous)42 b(F)-10 b(unctions)3350 2357 y Ft([F)i(unction]) +-3599 b Fh(int)53 b(rl_macro_bind)d Fg(\()p Ff(const)34 +b(c)m(har)g(*k)m(eyseq,)e(const)i(c)m(har)g(*macro,)565 +2467 y(Keymap)g(map)p Fg(\))390 2576 y Ft(Bind)23 b(the)g(k)m(ey)h +(sequence)g Fj(k)m(eyseq)i Ft(to)e(in)m(v)m(ok)m(e)h(the)f(macro)f +Fj(macro)p Ft(.)39 b(The)23 b(binding)f(is)i(p)s(erformed)d(in)390 +2686 y Fj(map)p Ft(.)39 b(When)28 b Fj(k)m(eyseq)i Ft(is)e(in)m(v)m(ok) +m(ed,)i(the)d Fj(macro)33 b Ft(will)28 b(b)s(e)f(inserted)g(in)m(to)i +(the)e(line.)41 b(This)26 b(function)390 2795 y(is)k(deprecated;)i(use) +e Fs(rl_generic_bind)c Ft(instead.)3350 2976 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_macro_dumper)c Fg(\()p -Ff(in)m(t)33 b(readable)p Fg(\))390 1210 y Ft(Prin)m(t)27 +Ff(in)m(t)33 b(readable)p Fg(\))390 3085 y Ft(Prin)m(t)27 b(the)g(k)m(ey)h(sequences)g(b)s(ound)d(to)j(macros)f(and)g(their)g(v) -5 b(alues,)28 b(using)f(the)g(curren)m(t)g(k)m(eymap,)390 -1320 y(to)32 b Fs(rl_outstream)p Ft(.)40 b(If)31 b Fj(readable)36 -b Ft(is)c(non-zero,)g(the)f(list)h(is)f(formatted)h(in)f(suc)m(h)g(a)g -(w)m(a)m(y)i(that)e(it)390 1429 y(can)g(b)s(e)e(made)i(part)f(of)h(an)f -Fs(inputrc)e Ft(\014le)j(and)e(re-read.)3350 1603 y([F)-8 -b(unction])-3599 b Fh(int)53 b(rl_variable_bind)e Fg(\()p -Ff(const)34 b(c)m(har)f(*v)-6 b(ariable,)33 b(const)h(c)m(har)f(*v)-6 -b(alue)p Fg(\))390 1713 y Ft(Mak)m(e)28 b(the)f(Readline)g(v)-5 +3195 y(to)43 b Fs(rl_outstream)p Ft(.)72 b(If)41 b(the)h(application)h +(has)f(assigned)g(a)h(v)-5 b(alue)42 b(to)h Fs(rl_macro_display_)390 +3304 y(hook)p Ft(,)36 b Fs(rl_macro_dumper)31 b Ft(calls)37 +b(it)f(instead)f(of)h(prin)m(ting)f(an)m(ything.)56 b(If)35 +b Fj(readable)41 b Ft(is)36 b(greater)390 3414 y(than)28 +b(zero,)h(the)f(list)h(is)f(formatted)g(in)g(suc)m(h)f(a)h(w)m(a)m(y)h +(that)g(it)f(can)g(b)s(e)f(made)h(part)g(of)g(an)g Fs(inputrc)390 +3524 y Ft(\014le)i(and)g(re-read.)3350 3704 y([F)-8 b(unction])-3599 +b Fh(int)53 b(rl_variable_bind)e Fg(\()p Ff(const)34 +b(c)m(har)f(*v)-6 b(ariable,)33 b(const)h(c)m(har)f(*v)-6 +b(alue)p Fg(\))390 3813 y Ft(Mak)m(e)28 b(the)f(Readline)g(v)-5 b(ariable)27 b Fj(v)-5 b(ariable)32 b Ft(ha)m(v)m(e)c Fj(v)-5 b(alue)p Ft(.)40 b(This)25 b(b)s(eha)m(v)m(es)i(as)g(if)f(the)h -(Readline)g(com-)390 1822 y(mand)j(`)p Fs(set)g Fl(variable)e(value)p +(Readline)g(com-)390 3923 y(mand)j(`)p Fs(set)g Fl(variable)e(value)p Ft(')h(had)h(b)s(een)h(executed)g(in)g(an)f Fs(inputrc)f -Ft(\014le)i(\(see)h(Section)f(1.3.1)390 1932 y([Readline)g(Init)f(File) -i(Syn)m(tax],)f(page)g(4\).)3350 2106 y([F)-8 b(unction])-3599 +Ft(\014le)i(\(see)h(Section)f(1.3.1)390 4032 y([Readline)g(Init)f(File) +i(Syn)m(tax],)f(page)g(4\).)3350 4213 y([F)-8 b(unction])-3599 b Fh(char)54 b(*)e(rl_variable_value)f Fg(\()p Ff(const)34 -b(c)m(har)g(*v)-6 b(ariable)p Fg(\))390 2215 y Ft(Return)28 +b(c)m(har)g(*v)-6 b(ariable)p Fg(\))390 4322 y Ft(Return)28 b(a)i(string)f(represen)m(ting)h(the)f(v)-5 b(alue)30 b(of)f(the)h(Readline)g(v)-5 b(ariable)30 b Fj(v)-5 b(ariable)p -Ft(.)41 b(F)-8 b(or)30 b(b)s(o)s(olean)390 2325 y(v)-5 +Ft(.)41 b(F)-8 b(or)30 b(b)s(o)s(olean)390 4432 y(v)-5 b(ariables,)31 b(this)g(string)f(is)g(either)h(`)p Fs(on)p -Ft(')f(or)h(`)p Fs(off)p Ft('.)3350 2499 y([F)-8 b(unction])-3599 +Ft(')f(or)h(`)p Fs(off)p Ft('.)3350 4612 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_variable_dumper)c Fg(\()p Ff(in)m(t)34 -b(readable)p Fg(\))390 2608 y Ft(Prin)m(t)44 b(the)h(Readline)g(v)-5 +b(readable)p Fg(\))390 4721 y Ft(Prin)m(t)44 b(the)h(Readline)g(v)-5 b(ariable)45 b(names)f(and)g(their)g(curren)m(t)g(v)-5 b(alues)45 b(to)g Fs(rl_outstream)p Ft(.)79 b(If)390 -2718 y Fj(readable)37 b Ft(is)32 b(non-zero,)h(the)e(list)i(is)e +4831 y Fj(readable)37 b Ft(is)32 b(non-zero,)h(the)e(list)i(is)e (formatted)h(in)g(suc)m(h)f(a)h(w)m(a)m(y)h(that)f(it)g(can)g(b)s(e)f -(made)g(part)h(of)390 2827 y(an)e Fs(inputrc)f Ft(\014le)h(and)g -(re-read.)3350 3001 y([F)-8 b(unction])-3599 b Fh(int)53 +(made)g(part)h(of)390 4941 y(an)e Fs(inputrc)f Ft(\014le)h(and)g +(re-read.)3350 5121 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_set_paren_blink_ti)q(meou)q(t)f Fg(\()p Ff(in)m(t)33 -b(u)p Fg(\))390 3111 y Ft(Set)25 b(the)h(time)f(in)m(terv)-5 +b(u)p Fg(\))390 5230 y Ft(Set)25 b(the)h(time)f(in)m(terv)-5 b(al)27 b(\(in)e(microseconds\))h(that)g(Readline)f(w)m(aits)h(when)e -(sho)m(wing)i(a)f(balancing)390 3220 y(c)m(haracter)32 -b(when)d Fs(blink-matching-paren)c Ft(has)30 b(b)s(een)g(enabled.)3350 -3394 y([F)-8 b(unction])-3599 b Fh(char)54 b(*)e(rl_get_termcap)e -Fg(\()p Ff(const)34 b(c)m(har)g(*cap)p Fg(\))390 3504 +(sho)m(wing)i(a)f(balancing)390 5340 y(c)m(haracter)32 +b(when)d Fs(blink-matching-paren)c Ft(has)30 b(b)s(een)g(enabled.)p +eop end +%%Page: 46 50 +TeXDict begin 46 49 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(46)3350 +299 y([F)-8 b(unction])-3599 b Fh(char)54 b(*)e(rl_get_termcap)e +Fg(\()p Ff(const)34 b(c)m(har)g(*cap)p Fg(\))390 408 y Ft(Retriev)m(e)29 b(the)e(string)g(v)-5 b(alue)27 b(of)g(the)h (termcap)f(capabilit)m(y)i Fj(cap)p Ft(.)40 b(Readline)27 -b(fetc)m(hes)h(the)g(termcap)390 3613 y(en)m(try)34 b(for)f(the)h +b(fetc)m(hes)h(the)g(termcap)390 518 y(en)m(try)34 b(for)f(the)h (curren)m(t)f(terminal)h(name)g(and)f(uses)g(those)h(capabilities)h(to) -f(mo)m(v)m(e)h(around)e(the)390 3723 y(screen)21 b(line)h(and)e(p)s +f(mo)m(v)m(e)h(around)e(the)390 628 y(screen)21 b(line)h(and)e(p)s (erform)g(other)h(terminal-sp)s(eci\014c)h(op)s(erations,)h(lik)m(e)f -(erasing)g(a)f(line.)38 b(Readline)390 3832 y(do)s(es)d(not)g(use)g -(all)g(of)h(a)f(terminal's)g(capabilities,)k(and)34 b(this)h(function)g -(will)g(return)f(v)-5 b(alues)35 b(for)390 3942 y(only)30 -b(those)h(capabilities)i(Readline)e(uses.)3350 4116 y([F)-8 -b(unction])-3599 b Fh(void)54 b(rl_clear_history)c Fg(\()p -Ff(v)m(oid)p Fg(\))390 4225 y Ft(Clear)27 b(the)h(history)f(list)h(b)m -(y)f(deleting)h(all)g(of)f(the)h(en)m(tries,)h(in)d(the)i(same)f -(manner)g(as)g(the)g(History)390 4335 y(library's)42 +(erasing)g(a)f(line.)38 b(Readline)390 737 y(do)s(es)d(not)g(use)g(all) +g(of)h(a)f(terminal's)g(capabilities,)k(and)34 b(this)h(function)g +(will)g(return)f(v)-5 b(alues)35 b(for)390 847 y(only)30 +b(those)h(capabilities)i(Readline)e(uses.)3350 1023 y([F)-8 +b(unction])-3599 b Fh(void)54 b(rl_reparse_colors)c Fg(\()p +Ff(v)m(oid)p Fg(\))390 1133 y Ft(Read)31 b(or)f(re-read)h(color)g +(de\014nitions)f(from)g Fs(LS_COLORS)p Ft(.)3350 1310 +y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_clear_history)c +Fg(\()p Ff(v)m(oid)p Fg(\))390 1419 y Ft(Clear)27 b(the)h(history)f +(list)h(b)m(y)f(deleting)h(all)g(of)f(the)h(en)m(tries,)h(in)d(the)i +(same)f(manner)g(as)g(the)g(History)390 1529 y(library's)42 b Fs(clear_history\(\))d Ft(function.)78 b(This)42 b(di\013ers)g(from)g -Fs(clear_history)e Ft(b)s(ecause)i(it)390 4445 y(frees)30 +Fs(clear_history)e Ft(b)s(ecause)i(it)390 1638 y(frees)30 b(priv)-5 b(ate)31 b(data)g(Readline)g(sa)m(v)m(es)h(in)e(the)h -(history)f(list.)3350 4618 y([F)-8 b(unction])-3599 b +(history)f(list.)3350 1815 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_activate_mark)c Fg(\()p Ff(v)m(oid)p -Fg(\))390 4728 y Ft(Enable)30 b(an)f Fk(active)37 b Ft(mark.)j(When)30 +Fg(\))390 1924 y Ft(Enable)30 b(an)f Fk(active)37 b Ft(mark.)j(When)30 b(this)f(is)h(enabled,)g(the)g(text)h(b)s(et)m(w)m(een)f(p)s(oin)m(t)g -(and)f(mark)g(\(the)390 4837 y Fj(region)p Ft(\))c(is)f(displa)m(y)m +(and)f(mark)g(\(the)390 2034 y Fj(region)p Ft(\))c(is)f(displa)m(y)m (ed)h(in)f(the)g(terminal's)h(standout)f(mo)s(de)f(\(a)i Fj(face)5 b Ft(\).)40 b(This)24 b(is)g(called)h(b)m(y)f(v)-5 -b(arious)390 4947 y(Readline)28 b(functions)f(that)h(set)g(the)f(mark)g +b(arious)390 2144 y(Readline)28 b(functions)f(that)h(set)g(the)f(mark)g (and)g(insert)g(text,)j(and)c(is)i(a)m(v)-5 b(ailable)30 -b(for)d(applications)390 5057 y(to)k(call.)3350 5230 +b(for)d(applications)390 2253 y(to)k(call.)3350 2430 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_deactivate_mark)c -Fg(\()p Ff(v)m(oid)p Fg(\))390 5340 y Ft(T)-8 b(urn)29 -b(o\013)i(the)f(activ)m(e)j(mark.)p eop end -%%Page: 46 50 -TeXDict begin 46 49 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(46)3350 -299 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_keep_mark_active)d -Fg(\()p Ff(v)m(oid)p Fg(\))390 408 y Ft(Indicate)45 b(that)g(the)g -(mark)f(should)g(remain)g(activ)m(e)j(when)c(the)i(curren)m(t)f -(Readline)h(function)390 518 y(completes)28 b(and)e(after)h(redispla)m -(y)g(o)s(ccurs.)40 b(In)26 b(most)h(cases,)h(the)f(mark)g(remains)f -(activ)m(e)j(for)e(only)390 628 y(the)k(duration)f(of)g(a)h(single)g -(bindable)f(Readline)h(function.)3350 799 y([F)-8 b(unction])-3599 +Fg(\()p Ff(v)m(oid)p Fg(\))390 2539 y Ft(T)-8 b(urn)29 +b(o\013)i(the)f(activ)m(e)j(mark.)3350 2716 y([F)-8 b(unction])-3599 +b Fh(void)54 b(rl_keep_mark_active)d Fg(\()p Ff(v)m(oid)p +Fg(\))390 2825 y Ft(Indicate)45 b(that)g(the)g(mark)f(should)g(remain)g +(activ)m(e)j(when)c(the)i(curren)m(t)f(Readline)h(function)390 +2935 y(completes)28 b(and)e(after)h(redispla)m(y)g(o)s(ccurs.)40 +b(In)26 b(most)h(cases,)h(the)f(mark)g(remains)f(activ)m(e)j(for)e +(only)390 3045 y(the)k(duration)f(of)g(a)h(single)g(bindable)f +(Readline)h(function.)3350 3221 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_mark_active_p)e Fg(\()p Ff(v)m(oid)p -Fg(\))390 909 y Ft(Return)30 b(a)g(non-zero)h(v)-5 b(alue)31 +Fg(\))390 3331 y Ft(Return)30 b(a)g(non-zero)h(v)-5 b(alue)31 b(if)f(the)h(mark)f(is)h(curren)m(tly)f(activ)m(e;)j(zero)e(otherwise.) -150 1100 y Fi(2.4.12)63 b(Alternate)40 b(In)m(terface)150 -1247 y Ft(An)21 b(alternate)j(in)m(terface)f(is)f(a)m(v)-5 +150 3525 y Fi(2.4.12)63 b(Alternate)40 b(In)m(terface)150 +3672 y Ft(An)21 b(alternate)j(in)m(terface)f(is)f(a)m(v)-5 b(ailable)24 b(to)e(plain)g Fs(readline\(\))p Ft(.)35 b(Some)21 b(applications)i(need)f(to)g(in)m(terlea)m(v)m(e)150 -1356 y(k)m(eyb)s(oard)35 b(I/O)h(with)f(\014le,)i(device,)h(or)e(windo) +3781 y(k)m(eyb)s(oard)35 b(I/O)h(with)f(\014le,)i(device,)h(or)e(windo) m(w)f(system)g(I/O,)h(t)m(ypically)i(b)m(y)d(using)g(a)h(main)g(lo)s -(op)f(to)150 1466 y Fs(select\(\))40 b Ft(on)i(v)-5 b(arious)42 +(op)f(to)150 3891 y Fs(select\(\))40 b Ft(on)i(v)-5 b(arious)42 b(\014le)g(descriptors.)76 b(T)-8 b(o)43 b(accommo)s(date)h(this)e -(need,)j(Readline)e(can)f(also)i(b)s(e)150 1576 y(in)m(v)m(ok)m(ed)33 +(need,)j(Readline)e(can)f(also)i(b)s(e)150 4001 y(in)m(v)m(ok)m(ed)33 b(as)e(a)h(`callbac)m(k')h(function)e(from)g(an)g(ev)m(en)m(t)h(lo)s (op.)44 b(There)30 b(are)i(functions)f(a)m(v)-5 b(ailable)33 -b(to)f(mak)m(e)150 1685 y(this)e(easy)-8 b(.)3350 1857 +b(to)f(mak)m(e)150 4110 y(this)e(easy)-8 b(.)3350 4287 y([F)g(unction])-3599 b Fh(void)54 b(rl_callback_handler_inst)q(all)e -Fg(\()p Ff(const)34 b(c)m(har)g(*prompt,)565 1966 y(rl)p -639 1966 30 5 v 44 w(v)m(cpfunc)p 1016 1966 V 45 w(t)f(*lhandler)p -Fg(\))390 2076 y Ft(Set)23 b(up)e(the)i(terminal)g(for)f(Readline)h +Fg(\()p Ff(const)34 b(c)m(har)g(*prompt,)565 4396 y(rl)p +639 4396 30 5 v 44 w(v)m(cpfunc)p 1016 4396 V 45 w(t)f(*lhandler)p +Fg(\))390 4506 y Ft(Set)23 b(up)e(the)i(terminal)g(for)f(Readline)h (I/O)g(and)f(displa)m(y)h(the)f(initial)i(expanded)e(v)-5 -b(alue)23 b(of)g Fj(prompt)p Ft(.)390 2186 y(Sa)m(v)m(e)34 +b(alue)23 b(of)g Fj(prompt)p Ft(.)390 4615 y(Sa)m(v)m(e)34 b(the)f(v)-5 b(alue)33 b(of)g Fj(lhandler)39 b Ft(to)34 b(use)e(as)h(a)g(handler)f(function)h(to)g(call)h(when)e(a)h(complete)i -(line)390 2295 y(of)h(input)f(has)g(b)s(een)g(en)m(tered.)57 +(line)390 4725 y(of)h(input)f(has)g(b)s(een)g(en)m(tered.)57 b(The)35 b(handler)g(function)g(receiv)m(es)j(the)e(text)g(of)g(the)g -(line)g(as)g(an)390 2405 y(argumen)m(t.)k(As)29 b(with)f +(line)g(as)g(an)390 4835 y(argumen)m(t.)k(As)29 b(with)f Fs(readline\(\))p Ft(,)e(the)j(handler)e(function)h(should)g -Fs(free)f Ft(the)h(line)h(when)e(it)i(it)390 2514 y(\014nished)g(with)h -(it.)3350 2686 y([F)-8 b(unction])-3599 b Fh(void)54 +Fs(free)f Ft(the)h(line)h(when)e(it)i(it)390 4944 y(\014nished)g(with)h +(it.)3350 5121 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_callback_read_char)d Fg(\()p Ff(v)m(oid)p Fg(\))390 -2796 y Ft(Whenev)m(er)34 b(an)g(application)h(determines)e(that)i(k)m +5230 y Ft(Whenev)m(er)34 b(an)g(application)h(determines)e(that)i(k)m (eyb)s(oard)e(input)g(is)h(a)m(v)-5 b(ailable,)37 b(it)d(should)f(call) -390 2905 y Fs(rl_callback_read_char\(\))p Ft(,)17 b(whic)m(h)22 +390 5340 y Fs(rl_callback_read_char\(\))p Ft(,)17 b(whic)m(h)22 b(will)g(read)f(the)h(next)g(c)m(haracter)h(from)f(the)f(curren)m(t)h -(input)390 3015 y(source.)40 b(If)27 b(that)i(c)m(haracter)g(completes) -h(the)e(line,)h Fs(rl_callback_read_char)22 b Ft(will)28 -b(in)m(v)m(ok)m(e)i(the)390 3124 y Fj(lhandler)47 b Ft(function)40 -b(installed)i(b)m(y)e Fs(rl_callback_handler_insta)o(ll)35 -b Ft(to)41 b(pro)s(cess)f(the)h(line.)390 3234 y(Before)j(calling)h -(the)e Fj(lhandler)49 b Ft(function,)e(the)c(terminal)h(settings)g(are) -g(reset)f(to)h(the)g(v)-5 b(alues)390 3344 y(they)44 -b(had)e(b)s(efore)h(calling)i Fs(rl_callback_handler_insta)o(ll)p -Ft(.)73 b(If)43 b(the)h Fj(lhandler)49 b Ft(function)390 -3453 y(returns,)27 b(and)h(the)g(line)g(handler)f(remains)h(installed,) -i(the)e(terminal)g(settings)h(are)f(mo)s(di\014ed)f(for)390 -3563 y(Readline's)k(use)f(again.)42 b Fs(EOF)29 b Ft(is)i(indicated)g -(b)m(y)f(calling)i Fj(lhandler)k Ft(with)30 b(a)h Fs(NULL)e -Ft(line.)3350 3735 y([F)-8 b(unction])-3599 b Fh(void)54 -b(rl_callback_sigcleanup)e Fg(\()p Ff(v)m(oid)p Fg(\))390 -3844 y Ft(Clean)26 b(up)e(an)m(y)i(in)m(ternal)g(state)h(the)e(callbac) -m(k)j(in)m(terface)f(uses)e(to)h(main)m(tain)g(state)h(b)s(et)m(w)m -(een)f(calls)390 3954 y(to)35 b(rl)p 572 3954 28 4 v -40 w(callbac)m(k)p 928 3954 V 42 w(read)p 1142 3954 V -40 w(c)m(har)f(\(e.g.,)j(the)e(state)g(of)f(an)m(y)h(activ)m(e)h -(incremen)m(tal)f(searc)m(hes\).)54 b(This)33 b(is)390 -4063 y(in)m(tended)f(to)h(b)s(e)e(used)g(b)m(y)h(applications)h(that)g -(wish)e(to)i(p)s(erform)d(their)j(o)m(wn)f(signal)g(handling;)390 -4173 y(Readline's)f(in)m(ternal)g(signal)g(handler)f(calls)h(this)g -(when)e(appropriate.)3350 4345 y([F)-8 b(unction])-3599 -b Fh(void)54 b(rl_callback_handler_remo)q(ve)e Fg(\()p -Ff(v)m(oid)p Fg(\))390 4454 y Ft(Restore)37 b(the)f(terminal)g(to)g -(its)h(initial)g(state)g(and)e(remo)m(v)m(e)i(the)f(line)g(handler.)56 -b(Y)-8 b(ou)36 b(ma)m(y)h(call)390 4564 y(this)25 b(function)g(from)g -(within)g(a)h(callbac)m(k)i(as)d(w)m(ell)i(as)f(indep)s(enden)m(tly)-8 -b(.)38 b(If)25 b(the)h Fj(lhandler)31 b Ft(installed)390 -4673 y(b)m(y)25 b Fs(rl_callback_handler_insta)o(ll)19 -b Ft(do)s(es)25 b(not)h(exit)g(the)g(program,)g(either)g(this)f -(function)g(or)390 4783 y(the)32 b(function)f(referred)f(to)i(b)m(y)g +(input)p eop end +%%Page: 47 51 +TeXDict begin 47 50 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(47)390 +299 y(source.)40 b(If)27 b(that)i(c)m(haracter)g(completes)h(the)e +(line,)h Fs(rl_callback_read_char)22 b Ft(will)28 b(in)m(v)m(ok)m(e)i +(the)390 408 y Fj(lhandler)47 b Ft(function)40 b(installed)i(b)m(y)e +Fs(rl_callback_handler_insta)o(ll)35 b Ft(to)41 b(pro)s(cess)f(the)h +(line.)390 518 y(Before)j(calling)h(the)e Fj(lhandler)49 +b Ft(function,)e(the)c(terminal)h(settings)g(are)g(reset)f(to)h(the)g +(v)-5 b(alues)390 628 y(they)44 b(had)e(b)s(efore)h(calling)i +Fs(rl_callback_handler_insta)o(ll)p Ft(.)73 b(If)43 b(the)h +Fj(lhandler)49 b Ft(function)390 737 y(returns,)27 b(and)h(the)g(line)g +(handler)f(remains)h(installed,)i(the)e(terminal)g(settings)h(are)f(mo) +s(di\014ed)f(for)390 847 y(Readline's)k(use)f(again.)42 +b Fs(EOF)29 b Ft(is)i(indicated)g(b)m(y)f(calling)i Fj(lhandler)k +Ft(with)30 b(a)h Fs(NULL)e Ft(line.)3350 1040 y([F)-8 +b(unction])-3599 b Fh(void)54 b(rl_callback_sigcleanup)e +Fg(\()p Ff(v)m(oid)p Fg(\))390 1150 y Ft(Clean)26 b(up)e(an)m(y)i(in)m +(ternal)g(state)h(the)e(callbac)m(k)j(in)m(terface)f(uses)e(to)h(main)m +(tain)g(state)h(b)s(et)m(w)m(een)f(calls)390 1259 y(to)35 +b(rl)p 572 1259 28 4 v 40 w(callbac)m(k)p 928 1259 V +42 w(read)p 1142 1259 V 40 w(c)m(har)f(\(e.g.,)j(the)e(state)g(of)f(an) +m(y)h(activ)m(e)h(incremen)m(tal)f(searc)m(hes\).)54 +b(This)33 b(is)390 1369 y(in)m(tended)f(to)h(b)s(e)e(used)g(b)m(y)h +(applications)h(that)g(wish)e(to)i(p)s(erform)d(their)j(o)m(wn)f +(signal)g(handling;)390 1479 y(Readline's)f(in)m(ternal)g(signal)g +(handler)f(calls)h(this)g(when)e(appropriate.)3350 1672 +y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_callback_handler_remo)q(ve)e +Fg(\()p Ff(v)m(oid)p Fg(\))390 1782 y Ft(Restore)37 b(the)f(terminal)g +(to)g(its)h(initial)g(state)g(and)e(remo)m(v)m(e)i(the)f(line)g +(handler.)56 b(Y)-8 b(ou)36 b(ma)m(y)h(call)390 1891 +y(this)25 b(function)g(from)g(within)g(a)h(callbac)m(k)i(as)d(w)m(ell)i +(as)f(indep)s(enden)m(tly)-8 b(.)38 b(If)25 b(the)h Fj(lhandler)31 +b Ft(installed)390 2001 y(b)m(y)25 b Fs(rl_callback_handler_insta)o(ll) +19 b Ft(do)s(es)25 b(not)h(exit)g(the)g(program,)g(either)g(this)f +(function)g(or)390 2110 y(the)32 b(function)f(referred)f(to)i(b)m(y)g (the)f(v)-5 b(alue)32 b(of)g Fs(rl_deprep_term_function)25 -b Ft(should)30 b(b)s(e)h(called)390 4893 y(b)s(efore)f(the)h(program)f +b Ft(should)30 b(b)s(e)h(called)390 2220 y(b)s(efore)f(the)h(program)f (exits)h(to)g(reset)g(the)f(terminal)h(settings.)150 -5083 y Fi(2.4.13)63 b(A)41 b(Readline)f(Example)150 5230 +2424 y Fi(2.4.13)63 b(A)41 b(Readline)f(Example)150 2571 y Ft(Here)34 b(is)g(a)g(function)g(whic)m(h)g(c)m(hanges)g(lo)m(w)m (ercase)j(c)m(haracters)e(to)f(their)g(upp)s(ercase)f(equiv)-5 -b(alen)m(ts,)37 b(and)150 5340 y(upp)s(ercase)d(c)m(haracters)j(to)f +b(alen)m(ts,)37 b(and)150 2680 y(upp)s(ercase)d(c)m(haracters)j(to)f (lo)m(w)m(ercase.)58 b(If)35 b(this)g(function)g(w)m(as)h(b)s(ound)d (to)j(`)p Fs(M-c)p Ft(',)h(then)e(t)m(yping)g(`)p Fs(M-c)p -Ft(')p eop end -%%Page: 47 51 -TeXDict begin 47 50 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(47)150 -299 y(w)m(ould)31 b(c)m(hange)i(the)f(case)g(of)g(the)g(c)m(haracter)h -(under)d(p)s(oin)m(t.)44 b(T)m(yping)31 b(`)p Fs(M-1)f(0)g(M-c)p -Ft(')h(w)m(ould)g(c)m(hange)i(the)150 408 y(case)e(of)g(the)g(follo)m -(wing)g(10)h(c)m(haracters,)g(lea)m(ving)g(the)e(cursor)g(on)g(the)h -(last)g(c)m(haracter)h(c)m(hanged.)390 628 y Fs(/*)47 -b(Invert)f(the)h(case)g(of)g(the)g(COUNT)f(following)g(characters.)e -(*/)390 737 y(int)390 847 y(invert_case_line)f(\(count,)j(key\))629 -956 y(int)h(count,)f(key;)390 1066 y({)485 1176 y(register)g(int)h -(start,)f(end,)h(i;)485 1395 y(start)g(=)g(rl_point;)485 -1614 y(if)h(\(rl_point)d(>=)i(rl_end\))581 1724 y(return)f(\(0\);)485 -1943 y(if)i(\(count)e(<)h(0\))581 2052 y({)676 2162 y(direction)f(=)h -(-1;)676 2271 y(count)g(=)g(-count;)581 2381 y(})485 -2491 y(else)581 2600 y(direction)e(=)j(1;)485 2819 y(/*)g(Find)e(the)h -(end)g(of)g(the)g(range)g(to)g(modify.)f(*/)485 2929 -y(end)h(=)h(start)e(+)i(\(count)e(*)h(direction\);)485 -3148 y(/*)h(Force)e(it)h(to)g(be)h(within)e(range.)g(*/)485 -3258 y(if)i(\(end)e(>)i(rl_end\))581 3367 y(end)f(=)g(rl_end;)485 -3477 y(else)g(if)g(\(end)g(<)g(0\))581 3587 y(end)g(=)g(0;)485 -3806 y(if)h(\(start)e(==)h(end\))581 3915 y(return)f(\(0\);)485 -4134 y(if)i(\(start)e(>)h(end\))581 4244 y({)676 4354 -y(int)g(temp)g(=)g(start;)676 4463 y(start)g(=)g(end;)676 -4573 y(end)g(=)h(temp;)581 4682 y(})485 4902 y(/*)g(Tell)e(readline)g -(that)g(we)i(are)f(modifying)e(the)i(line,)629 5011 y(so)g(it)g(will)g -(save)f(the)h(undo)g(information.)d(*/)485 5121 y(rl_modifying)h -(\(start,)h(end\);)485 5340 y(for)h(\(i)h(=)f(start;)f(i)i(!=)f(end;)f -(i++\))p eop end +Ft(')150 2790 y(w)m(ould)c(c)m(hange)i(the)f(case)g(of)g(the)g(c)m +(haracter)h(under)d(p)s(oin)m(t.)44 b(T)m(yping)31 b(`)p +Fs(M-1)f(0)g(M-c)p Ft(')h(w)m(ould)g(c)m(hange)i(the)150 +2900 y(case)e(of)g(the)g(follo)m(wing)g(10)h(c)m(haracters,)g(lea)m +(ving)g(the)e(cursor)g(on)g(the)h(last)g(c)m(haracter)h(c)m(hanged.)390 +3039 y Fs(/*)47 b(Invert)f(the)h(case)g(of)g(the)g(COUNT)f(following)g +(characters.)e(*/)390 3148 y(int)390 3258 y(invert_case_line)f +(\(count,)j(key\))629 3367 y(int)h(count,)f(key;)390 +3477 y({)485 3587 y(register)g(int)h(start,)f(end,)h(i;)485 +3806 y(start)g(=)g(rl_point;)485 4025 y(if)h(\(rl_point)d(>=)i +(rl_end\))581 4134 y(return)f(\(0\);)485 4354 y(if)i(\(count)e(<)h(0\)) +581 4463 y({)676 4573 y(direction)f(=)h(-1;)676 4682 +y(count)g(=)g(-count;)581 4792 y(})485 4902 y(else)581 +5011 y(direction)e(=)j(1;)485 5230 y(/*)g(Find)e(the)h(end)g(of)g(the)g +(range)g(to)g(modify.)f(*/)485 5340 y(end)h(=)h(start)e(+)i(\(count)e +(*)h(direction\);)p eop end %%Page: 48 52 TeXDict begin 48 51 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(48)581 -299 y Fs({)676 408 y(if)48 b(\(_rl_uppercase_p)43 b -(\(rl_line_buffer[i]\)\))772 518 y(rl_line_buffer[i])g(=)k -(_rl_to_lower)e(\(rl_line_buffer[i]\);)676 628 y(else)i(if)g -(\(_rl_lowercase_p)d(\(rl_line_buffer[i]\)\))772 737 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(48)485 +408 y Fs(/*)48 b(Force)e(it)h(to)g(be)h(within)e(range.)g(*/)485 +518 y(if)i(\(end)e(>)i(rl_end\))581 628 y(end)f(=)g(rl_end;)485 +737 y(else)g(if)g(\(end)g(<)g(0\))581 847 y(end)g(=)g(0;)485 +1066 y(if)h(\(start)e(==)h(end\))581 1176 y(return)f(\(0\);)485 +1395 y(if)i(\(start)e(>)h(end\))581 1504 y({)676 1614 +y(int)g(temp)g(=)g(start;)676 1724 y(start)g(=)g(end;)676 +1833 y(end)g(=)h(temp;)581 1943 y(})485 2162 y(/*)g(Tell)e(readline)g +(that)g(we)i(are)f(modifying)e(the)i(line,)629 2271 y(so)g(it)g(will)g +(save)f(the)h(undo)g(information.)d(*/)485 2381 y(rl_modifying)h +(\(start,)h(end\);)485 2600 y(for)h(\(i)h(=)f(start;)f(i)i(!=)f(end;)f +(i++\))581 2710 y({)676 2819 y(if)i(\(_rl_uppercase_p)43 +b(\(rl_line_buffer[i]\)\))772 2929 y(rl_line_buffer[i])g(=)k +(_rl_to_lower)e(\(rl_line_buffer[i]\);)676 3039 y(else)i(if)g +(\(_rl_lowercase_p)d(\(rl_line_buffer[i]\)\))772 3148 y(rl_line_buffer[i])f(=)k(_rl_to_upper)e(\(rl_line_buffer[i]\);)581 -847 y(})485 956 y(/*)j(Move)e(point)h(to)g(on)g(top)g(of)g(the)g(last)g -(character)e(changed.)g(*/)485 1066 y(rl_point)h(=)h(\(direction)e(==)j -(1\))f(?)g(end)g(-)h(1)f(:)h(start;)485 1176 y(return)f(\(0\);)390 -1285 y(})150 1518 y Fi(2.4.14)63 b(Alternate)40 b(In)m(terface)g -(Example)150 1665 y Ft(Here)f(is)g(a)g(complete)h(program)e(that)h -(illustrates)h(Readline's)f(alternate)h(in)m(terface.)67 -b(It)38 b(reads)h(lines)150 1775 y(from)30 b(the)i(terminal)f(and)f -(displa)m(ys)h(them,)h(pro)m(viding)f(the)g(standard)f(history)h(and)f -(T)-8 b(AB)32 b(completion)150 1884 y(functions.)40 b(It)31 -b(understands)d(the)j(EOF)f(c)m(haracter)i(or)e Fs(")p -Ft(exit)p Fs(")h Ft(to)g(exit)g(the)g(program.)390 2052 -y Fs(/*)47 b(Standard)f(include)g(files.)g(stdio.h)f(is)j(required.)d -(*/)390 2162 y(#include)h(<stdlib.h>)390 2271 y(#include)g(<string.h>) -390 2381 y(#include)g(<unistd.h>)390 2491 y(#include)g(<locale.h>)390 -2710 y(/*)h(Used)g(for)g(select\(2\))e(*/)390 2819 y(#include)h -(<sys/types.h>)390 2929 y(#include)g(<sys/select.h>)390 -3148 y(#include)g(<signal.h>)390 3367 y(#include)g(<stdio.h>)390 -3587 y(/*)h(Standard)f(readline)f(include)h(files.)g(*/)390 -3696 y(#include)g(<readline/readline.h>)390 3806 y(#include)g -(<readline/history.h>)390 4025 y(static)g(void)h(cb_linehandler)d -(\(char)i(*\);)390 4134 y(static)g(void)h(sighandler)e(\(int\);)390 -4354 y(int)i(running;)390 4463 y(int)g(sigwinch_received;)390 -4573 y(const)f(char)h(*prompt)f(=)h("rltest$)f(";)390 -4792 y(/*)h(Handle)f(SIGWINCH)g(and)h(window)f(size)g(changes)g(when)h -(readline)e(is)j(not)f(active)f(and)p 3922 4812 42 84 -v 533 4902 a(reading)g(a)h(character.)e(*/)390 5011 y(static)h(void)390 -5121 y(sighandler)f(\(int)i(sig\))390 5230 y({)485 5340 -y(sigwinch_received)d(=)j(1;)p eop end +3258 y(})485 3367 y(/*)j(Move)e(point)h(to)g(on)g(top)g(of)g(the)g +(last)g(character)e(changed.)g(*/)485 3477 y(rl_point)h(=)h +(\(direction)e(==)j(1\))f(?)g(end)g(-)h(1)f(:)h(start;)485 +3587 y(return)f(\(0\);)390 3696 y(})150 3929 y Fi(2.4.14)63 +b(Alternate)40 b(In)m(terface)g(Example)150 4076 y Ft(Here)f(is)g(a)g +(complete)h(program)e(that)h(illustrates)h(Readline's)f(alternate)h(in) +m(terface.)67 b(It)38 b(reads)h(lines)150 4186 y(from)30 +b(the)i(terminal)f(and)f(displa)m(ys)h(them,)h(pro)m(viding)f(the)g +(standard)f(history)h(and)f(T)-8 b(AB)32 b(completion)150 +4295 y(functions.)40 b(It)31 b(understands)d(the)j(EOF)f(c)m(haracter)i +(or)e Fs(")p Ft(exit)p Fs(")h Ft(to)g(exit)g(the)g(program.)390 +4463 y Fs(/*)47 b(Standard)f(include)g(files.)g(stdio.h)f(is)j +(required.)d(*/)390 4573 y(#include)h(<stdlib.h>)390 +4682 y(#include)g(<string.h>)390 4792 y(#include)g(<unistd.h>)390 +4902 y(#include)g(<locale.h>)390 5121 y(/*)h(Used)g(for)g(select\(2\))e +(*/)390 5230 y(#include)h(<sys/types.h>)390 5340 y(#include)g +(<sys/select.h>)p eop end %%Page: 49 53 TeXDict begin 49 52 bop 150 -116 a Ft(Chapter)30 b(2:)41 b(Programming)30 b(with)g(GNU)h(Readline)1683 b(49)390 -299 y Fs(})390 518 y(/*)47 b(Callback)f(function)f(called)h(for)h(each) -g(line)g(when)f(accept-line)f(executed,)g(EOF)533 628 -y(seen,)i(or)g(EOF)g(character)e(read.)94 b(This)47 b(sets)f(a)i(flag)e -(and)h(returns;)f(it)h(could)533 737 y(also)g(call)f(exit\(3\).)g(*/) -390 847 y(static)g(void)390 956 y(cb_linehandler)e(\(char)i(*line\))390 -1066 y({)485 1176 y(/*)i(Can)f(use)f(^D)i(\(stty)e(eof\))h(or)g(`exit') -f(to)h(exit.)f(*/)485 1285 y(if)i(\(line)e(==)h(NULL)g(||)g(strcmp)f -(\(line,)g("exit"\))g(==)h(0\))581 1395 y({)676 1504 -y(if)h(\(line)e(==)h(0\))772 1614 y(printf)f(\("\\n"\);)676 -1724 y(printf)g(\("exit\\n"\);)676 1833 y(/*)i(This)e(function)g(needs) -g(to)h(be)g(called)g(to)g(reset)f(the)h(terminal)f(settings,)p -3874 1853 42 84 v 820 1943 a(and)g(calling)g(it)h(from)g(the)g(line)g -(handler)e(keeps)i(one)g(extra)f(prompt)g(from)p 3874 -1963 42 76 v 820 2052 a(being)g(displayed.)f(*/)676 2162 -y(rl_callback_handler_remove)c(\(\);)676 2381 y(running)46 -b(=)i(0;)581 2491 y(})485 2600 y(else)581 2710 y({)676 -2819 y(if)g(\(*line\))772 2929 y(add_history)d(\(line\);)676 -3039 y(printf)h(\("input)g(line:)h(\045s\\n",)f(line\);)676 -3148 y(free)h(\(line\);)581 3258 y(})390 3367 y(})390 -3587 y(int)390 3696 y(main)g(\(int)f(c,)h(char)g(**v\))390 -3806 y({)485 3915 y(fd_set)g(fds;)485 4025 y(int)g(r;)485 -4244 y(/*)h(Set)f(the)f(default)g(locale)g(values)g(according)g(to)h -(environment)e(variables.)g(*/)p 3874 4264 42 84 v 485 -4354 a(setlocale)h(\(LC_ALL,)f(""\);)485 4573 y(/*)j(Handle)e(window)g -(size)g(changes)g(when)h(readline)e(is)j(not)f(active)f(and)h(reading) -629 4682 y(characters.)d(*/)485 4792 y(signal)j(\(SIGWINCH,)e -(sighandler\);)485 5011 y(/*)j(Install)d(the)i(line)g(handler.)f(*/)485 -5121 y(rl_callback_handler_instal)o(l)c(\(prompt,)j(cb_linehandler\);) -485 5340 y(/*)j(Enter)e(a)h(simple)g(event)f(loop.)94 -b(This)47 b(waits)f(until)g(something)g(is)h(available)p +408 y Fs(#include)46 b(<signal.h>)390 628 y(#include)g(<stdio.h>)390 +847 y(/*)h(Standard)f(readline)f(include)h(files.)g(*/)390 +956 y(#include)g(<readline/readline.h>)390 1066 y(#include)g +(<readline/history.h>)390 1285 y(static)g(void)h(cb_linehandler)d +(\(char)i(*\);)390 1395 y(static)g(void)h(sighandler)e(\(int\);)390 +1614 y(int)i(running;)390 1724 y(int)g(sigwinch_received;)390 +1833 y(const)f(char)h(*prompt)f(=)h("rltest$)f(";)390 +2052 y(/*)h(Handle)f(SIGWINCH)g(and)h(window)f(size)g(changes)g(when)h +(readline)e(is)j(not)f(active)f(and)p 3922 2073 42 84 +v 533 2162 a(reading)g(a)h(character.)e(*/)390 2271 y(static)h(void)390 +2381 y(sighandler)f(\(int)i(sig\))390 2491 y({)485 2600 +y(sigwinch_received)d(=)j(1;)390 2710 y(})390 2929 y(/*)g(Callback)f +(function)f(called)h(for)h(each)g(line)g(when)f(accept-line)f +(executed,)g(EOF)533 3039 y(seen,)i(or)g(EOF)g(character)e(read.)94 +b(This)47 b(sets)f(a)i(flag)e(and)h(returns;)f(it)h(could)533 +3148 y(also)g(call)f(exit\(3\).)g(*/)390 3258 y(static)g(void)390 +3367 y(cb_linehandler)e(\(char)i(*line\))390 3477 y({)485 +3587 y(/*)i(Can)f(use)f(^D)i(\(stty)e(eof\))h(or)g(`exit')f(to)h(exit.) +f(*/)485 3696 y(if)i(\(line)e(==)h(NULL)g(||)g(strcmp)f(\(line,)g +("exit"\))g(==)h(0\))581 3806 y({)676 3915 y(if)h(\(line)e(==)h(0\))772 +4025 y(printf)f(\("\\n"\);)676 4134 y(printf)g(\("exit\\n"\);)676 +4244 y(/*)i(This)e(function)g(needs)g(to)h(be)g(called)g(to)g(reset)f +(the)h(terminal)f(settings,)p 3874 4264 V 820 4354 a(and)g(calling)g +(it)h(from)g(the)g(line)g(handler)e(keeps)i(one)g(extra)f(prompt)g +(from)p 3874 4374 42 76 v 820 4463 a(being)g(displayed.)f(*/)676 +4573 y(rl_callback_handler_remove)c(\(\);)676 4792 y(running)46 +b(=)i(0;)581 4902 y(})485 5011 y(else)581 5121 y({)676 +5230 y(if)g(\(*line\))772 5340 y(add_history)d(\(line\);)p eop end %%Page: 50 54 TeXDict begin 50 53 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(50)629 -299 y Fs(to)47 b(read)f(on)i(readline's)d(input)h(stream)g(\(defaults)f -(to)j(standard)d(input\))h(and)629 408 y(calls)g(the)h(builtin)f -(character)f(read)i(callback)e(to)i(read)g(it.)95 b(It)47 -b(does)f(not)629 518 y(have)g(to)h(modify)g(the)f(user's)h(terminal)e -(settings.)g(*/)485 628 y(running)h(=)i(1;)485 737 y(while)f -(\(running\))581 847 y({)676 956 y(FD_ZERO)f(\(&fds\);)676 -1066 y(FD_SET)g(\(fileno)g(\(rl_instream\),)e(&fds\);)676 -1285 y(r)k(=)f(select)f(\(FD_SETSIZE,)f(&fds,)h(NULL,)h(NULL,)f -(NULL\);)676 1395 y(if)i(\(r)f(<)g(0)h(&&)f(errno)f(!=)h(EINTR\))772 -1504 y({)867 1614 y(perror)f(\("rltest:)g(select"\);)867 -1724 y(rl_callback_handler_remov)o(e)c(\(\);)867 1833 -y(break;)772 1943 y(})676 2052 y(if)48 b(\(sigwinch_received\))390 -2162 y({)485 2271 y(rl_resize_terminal)43 b(\(\);)485 -2381 y(sigwinch_received)h(=)j(0;)390 2491 y(})676 2600 -y(if)h(\(r)f(<)g(0\))390 2710 y(continue;)676 2929 y(if)h(\(FD_ISSET)d -(\(fileno)h(\(rl_instream\),)e(&fds\)\))772 3039 y -(rl_callback_read_char)e(\(\);)581 3148 y(})485 3367 -y(printf)47 b(\("rltest:)e(Event)h(loop)h(has)g(exited\\n"\);)485 -3477 y(return)g(0;)390 3587 y(})150 3835 y Fr(2.5)68 -b(Readline)47 b(Signal)e(Handling)150 3995 y Ft(Signals)31 -b(are)f(async)m(hronous)g(ev)m(en)m(ts)i(sen)m(t)f(to)g(a)g(pro)s(cess) -f(b)m(y)h(the)f(Unix)g(k)m(ernel,)i(sometimes)f(on)g(b)s(ehalf)150 -4104 y(of)24 b(another)f(pro)s(cess.)38 b(They)23 b(are)h(in)m(tended)f -(to)h(indicate)h(exceptional)g(ev)m(en)m(ts,)i(lik)m(e)d(a)g(user)f -(pressing)g(the)150 4214 y(terminal's)33 b(in)m(terrupt)f(k)m(ey)-8 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(50)676 +299 y Fs(printf)46 b(\("input)g(line:)h(\045s\\n",)f(line\);)676 +408 y(free)h(\(line\);)581 518 y(})390 628 y(})390 847 +y(int)390 956 y(main)g(\(int)f(c,)h(char)g(**v\))390 +1066 y({)485 1176 y(fd_set)g(fds;)485 1285 y(int)g(r;)485 +1504 y(/*)h(Set)f(the)f(default)g(locale)g(values)g(according)g(to)h +(environment)e(variables.)g(*/)p 3874 1525 42 84 v 485 +1614 a(setlocale)h(\(LC_ALL,)f(""\);)485 1833 y(/*)j(Handle)e(window)g +(size)g(changes)g(when)h(readline)e(is)j(not)f(active)f(and)h(reading) +629 1943 y(characters.)d(*/)485 2052 y(signal)j(\(SIGWINCH,)e +(sighandler\);)485 2271 y(/*)j(Install)d(the)i(line)g(handler.)f(*/)485 +2381 y(rl_callback_handler_instal)o(l)c(\(prompt,)j(cb_linehandler\);) +485 2600 y(/*)j(Enter)e(a)h(simple)g(event)f(loop.)94 +b(This)47 b(waits)f(until)g(something)g(is)h(available)629 +2710 y(to)g(read)f(on)i(readline's)d(input)h(stream)g(\(defaults)f(to)j +(standard)d(input\))h(and)629 2819 y(calls)g(the)h(builtin)f(character) +f(read)i(callback)e(to)i(read)g(it.)95 b(It)47 b(does)f(not)629 +2929 y(have)g(to)h(modify)g(the)f(user's)h(terminal)e(settings.)g(*/) +485 3039 y(running)h(=)i(1;)485 3148 y(while)f(\(running\))581 +3258 y({)676 3367 y(FD_ZERO)f(\(&fds\);)676 3477 y(FD_SET)g(\(fileno)g +(\(rl_instream\),)e(&fds\);)676 3696 y(r)k(=)f(select)f(\(FD_SETSIZE,)f +(&fds,)h(NULL,)h(NULL,)f(NULL\);)676 3806 y(if)i(\(r)f(<)g(0)h(&&)f +(errno)f(!=)h(EINTR\))772 3915 y({)867 4025 y(perror)f(\("rltest:)g +(select"\);)867 4134 y(rl_callback_handler_remov)o(e)c(\(\);)867 +4244 y(break;)772 4354 y(})676 4463 y(if)48 b(\(sigwinch_received\))390 +4573 y({)485 4682 y(rl_resize_terminal)43 b(\(\);)485 +4792 y(sigwinch_received)h(=)j(0;)390 4902 y(})676 5011 +y(if)h(\(r)f(<)g(0\))390 5121 y(continue;)676 5340 y(if)h(\(FD_ISSET)d +(\(fileno)h(\(rl_instream\),)e(&fds\)\))p eop end +%%Page: 51 55 +TeXDict begin 51 54 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(51)772 +299 y Fs(rl_callback_read_char)42 b(\(\);)581 408 y(})485 +628 y(printf)47 b(\("rltest:)e(Event)h(loop)h(has)g(exited\\n"\);)485 +737 y(return)g(0;)390 847 y(})150 1101 y Fr(2.5)68 b(Readline)47 +b(Signal)e(Handling)150 1260 y Ft(Signals)31 b(are)f(async)m(hronous)g +(ev)m(en)m(ts)i(sen)m(t)f(to)g(a)g(pro)s(cess)f(b)m(y)h(the)f(Unix)g(k) +m(ernel,)i(sometimes)f(on)g(b)s(ehalf)150 1370 y(of)24 +b(another)f(pro)s(cess.)38 b(They)23 b(are)h(in)m(tended)f(to)h +(indicate)h(exceptional)g(ev)m(en)m(ts,)i(lik)m(e)d(a)g(user)f +(pressing)g(the)150 1479 y(terminal's)33 b(in)m(terrupt)f(k)m(ey)-8 b(,)34 b(or)e(a)g(net)m(w)m(ork)h(connection)h(b)s(eing)e(brok)m(en.)46 -b(There)31 b(is)h(a)h(class)g(of)f(signals)150 4323 y(that)f(can)g(b)s +b(There)31 b(is)h(a)h(class)g(of)f(signals)150 1589 y(that)f(can)g(b)s (e)e(sen)m(t)i(to)g(the)g(pro)s(cess)f(curren)m(tly)g(reading)h(input)e (from)h(the)g(k)m(eyb)s(oard.)41 b(Since)30 b(Readline)150 -4433 y(c)m(hanges)41 b(the)e(terminal)i(attributes)f(when)f(it)h(is)f +1698 y(c)m(hanges)41 b(the)e(terminal)i(attributes)f(when)f(it)h(is)f (called,)44 b(it)c(needs)f(to)i(p)s(erform)d(sp)s(ecial)i(pro)s -(cessing)150 4543 y(when)33 b(suc)m(h)h(a)h(signal)g(is)f(receiv)m(ed)i +(cessing)150 1808 y(when)33 b(suc)m(h)h(a)h(signal)g(is)f(receiv)m(ed)i (in)e(order)g(to)h(restore)f(the)h(terminal)g(to)g(a)f(sane)h(state,)i -(or)d(pro)m(vide)150 4652 y(application)e(writers)e(with)g(functions)g -(to)h(do)f(so)h(man)m(ually)-8 b(.)275 4792 y(Readline)40 +(or)d(pro)m(vide)150 1918 y(application)e(writers)e(with)g(functions)g +(to)h(do)f(so)h(man)m(ually)-8 b(.)275 2061 y(Readline)40 b(con)m(tains)i(an)e(in)m(ternal)h(signal)g(handler)f(that)h(is)f (installed)h(for)f(a)h(n)m(um)m(b)s(er)e(of)h(signals)150 -4902 y(\()p Fs(SIGINT)p Ft(,)e Fs(SIGQUIT)p Ft(,)f Fs(SIGTERM)p +2170 y(\()p Fs(SIGINT)p Ft(,)e Fs(SIGQUIT)p Ft(,)f Fs(SIGTERM)p Ft(,)g Fs(SIGHUP)p Ft(,)g Fs(SIGALRM)p Ft(,)g Fs(SIGTSTP)p Ft(,)g Fs(SIGTTIN)p Ft(,)g(and)g Fs(SIGTTOU)p Ft(\).)59 -b(When)150 5011 y(one)27 b(of)g(these)g(signals)g(is)g(receiv)m(ed,)i +b(When)150 2280 y(one)27 b(of)g(these)g(signals)g(is)g(receiv)m(ed,)i (the)e(signal)g(handler)f(will)h(reset)h(the)e(terminal)i(attributes)f -(to)g(those)150 5121 y(that)33 b(w)m(ere)g(in)f(e\013ect)h(b)s(efore)f +(to)g(those)150 2390 y(that)33 b(w)m(ere)g(in)f(e\013ect)h(b)s(efore)f Fs(readline\(\))e Ft(w)m(as)i(called,)j(reset)d(the)h(signal)g -(handling)f(to)h(what)f(it)h(w)m(as)150 5230 y(b)s(efore)26 +(handling)f(to)h(what)f(it)h(w)m(as)150 2499 y(b)s(efore)26 b Fs(readline\(\))e Ft(w)m(as)j(called,)i(and)d(resend)g(the)h(signal)g (to)h(the)f(calling)h(application.)41 b(If)26 b(and)g(when)150 -5340 y(the)34 b(calling)i(application's)f(signal)g(handler)e(returns,)h -(Readline)g(will)h(reinitialize)h(the)e(terminal)h(and)p -eop end -%%Page: 51 55 -TeXDict begin 51 54 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(51)150 -299 y(con)m(tin)m(ue)29 b(to)g(accept)h(input.)39 b(When)28 +2609 y(the)34 b(calling)i(application's)f(signal)g(handler)e(returns,)h +(Readline)g(will)h(reinitialize)h(the)e(terminal)h(and)150 +2718 y(con)m(tin)m(ue)29 b(to)g(accept)h(input.)39 b(When)28 b(a)h Fs(SIGINT)d Ft(is)j(receiv)m(ed,)h(the)e(Readline)h(signal)g -(handler)f(p)s(erforms)150 408 y(some)39 b(additional)h(w)m(ork,)h +(handler)f(p)s(erforms)150 2828 y(some)39 b(additional)h(w)m(ork,)h (whic)m(h)d(will)h(cause)g(an)m(y)h(partially-en)m(tered)g(line)f(to)h -(b)s(e)e(ab)s(orted)g(\(see)i(the)150 518 y(description)30 +(b)s(e)e(ab)s(orted)g(\(see)i(the)150 2938 y(description)30 b(of)h Fs(rl_free_line_state\(\))25 b Ft(b)s(elo)m(w\).)275 -656 y(There)e(is)i(an)f(additional)h(Readline)g(signal)g(handler,)g +3081 y(There)e(is)i(an)f(additional)h(Readline)g(signal)g(handler,)g (for)f Fs(SIGWINCH)p Ft(,)g(whic)m(h)g(the)g(k)m(ernel)h(sends)e(to)j -(a)150 765 y(pro)s(cess)i(whenev)m(er)h(the)g(terminal's)g(size)h(c)m +(a)150 3190 y(pro)s(cess)i(whenev)m(er)h(the)g(terminal's)g(size)h(c)m (hanges)g(\(for)f(example,)h(if)f(a)g(user)f(resizes)i(an)e -Fs(xterm)p Ft(\).)39 b(The)150 875 y(Readline)d Fs(SIGWINCH)e +Fs(xterm)p Ft(\).)39 b(The)150 3300 y(Readline)d Fs(SIGWINCH)e Ft(handler)g(up)s(dates)h(Readline's)h(in)m(ternal)h(screen)e(size)i -(information,)g(and)e(then)150 984 y(calls)g(an)m(y)f +(information,)g(and)e(then)150 3410 y(calls)g(an)m(y)f Fs(SIGWINCH)e Ft(signal)i(handler)f(the)h(calling)h(application)g(has)f -(installed.)51 b(Readline)35 b(calls)g(the)150 1094 y(application's)i +(installed.)51 b(Readline)35 b(calls)g(the)150 3519 y(application's)i Fs(SIGWINCH)c Ft(signal)i(handler)g(without)g(resetting)h(the)g -(terminal)f(to)h(its)g(original)g(state.)150 1204 y(If)31 +(terminal)f(to)h(its)g(original)g(state.)150 3629 y(If)31 b(the)i(application's)g(signal)g(handler)e(do)s(es)g(more)h(than)g(up)s (date)f(its)i(idea)f(of)g(the)g(terminal)h(size)g(and)150 -1313 y(return)28 b(\(for)i(example,)h(a)f Fs(longjmp)d +3738 y(return)28 b(\(for)i(example,)h(a)f Fs(longjmp)d Ft(bac)m(k)k(to)f(a)g(main)g(pro)s(cessing)f(lo)s(op\),)h(it)g -Fk(must)39 b Ft(call)31 b Fs(rl_cleanup_)150 1423 y(after_signal\(\))26 +Fk(must)39 b Ft(call)31 b Fs(rl_cleanup_)150 3848 y(after_signal\(\))26 b Ft(\(describ)s(ed)k(b)s(elo)m(w\),)h(to)g(restore)g(the)g(terminal)g -(state.)275 1560 y(When)38 b(an)h(application)h(is)f(using)g(the)g +(state.)275 3991 y(When)38 b(an)h(application)h(is)f(using)g(the)g (callbac)m(k)i(in)m(terface)f(\(see)g(Section)g(2.4.12)h([Alternate)f -(In-)150 1670 y(terface],)48 b(page)c(46\),)j(Readline)c(installs)h +(In-)150 4101 y(terface],)48 b(page)c(46\),)j(Readline)c(installs)h (signal)g(handlers)e(only)h(for)f(the)h(duration)g(of)g(the)g(call)h -(to)150 1779 y Fs(rl_callback_read_char)p Ft(.)c(Applications)33 +(to)150 4210 y Fs(rl_callback_read_char)p Ft(.)c(Applications)33 b(using)f(the)g(callbac)m(k)j(in)m(terface)e(should)f(b)s(e)f(prepared) -g(to)150 1889 y(clean)d(up)d(Readline's)j(state)g(if)e(they)h(wish)f +g(to)150 4320 y(clean)d(up)d(Readline's)j(state)g(if)e(they)h(wish)f (to)h(handle)f(the)h(signal)h(b)s(efore)e(the)h(line)g(handler)f -(completes)150 1999 y(and)k(restores)h(the)f(terminal)h(state.)275 -2136 y(If)k(an)g(application)i(using)f(the)g(callbac)m(k)h(in)m +(completes)150 4430 y(and)k(restores)h(the)f(terminal)h(state.)275 +4573 y(If)k(an)g(application)i(using)f(the)g(callbac)m(k)h(in)m (terface)h(wishes)d(to)h(ha)m(v)m(e)h(Readline)g(install)f(its)g -(signal)150 2246 y(handlers)22 b(at)h(the)g(time)h(the)e(application)j +(signal)150 4682 y(handlers)22 b(at)h(the)g(time)h(the)e(application)j (calls)e Fs(rl_callback_handler_instal)o(l)17 b Ft(and)22 -b(remo)m(v)m(e)i(them)150 2355 y(only)f(when)g(a)g(complete)i(line)f +b(remo)m(v)m(e)i(them)150 4792 y(only)f(when)g(a)g(complete)i(line)f (of)f(input)f(has)h(b)s(een)g(read,)i(it)e(should)g(set)g(the)h -Fs(rl_persistent_signal_)150 2465 y(handlers)c Ft(v)-5 +Fs(rl_persistent_signal_)150 4902 y(handlers)c Ft(v)-5 b(ariable)23 b(to)f(a)h(non-zero)f(v)-5 b(alue.)39 b(This)21 b(allo)m(ws)i(an)f(application)i(to)f(defer)e(all)i(of)f(the)h -(handling)150 2575 y(of)j(the)h(signals)f(Readline)h(catc)m(hes)h(to)f +(handling)150 5011 y(of)j(the)h(signals)f(Readline)h(catc)m(hes)h(to)f (Readline.)39 b(Applications)27 b(should)f(use)f(this)h(v)-5 -b(ariable)27 b(with)f(care;)150 2684 y(it)d(can)g(result)g(in)f +b(ariable)27 b(with)f(care;)150 5121 y(it)d(can)g(result)g(in)f (Readline)h(catc)m(hing)i(signals)e(and)f(not)h(acting)h(on)f(them)f -(\(or)h(allo)m(wing)i(the)e(application)150 2794 y(to)36 +(\(or)h(allo)m(wing)i(the)e(application)150 5230 y(to)36 b(react)g(to)g(them\))g(un)m(til)f(the)h(application)g(calls)h Fs(rl_callback_read_char)p Ft(.)49 b(This)35 b(can)g(result)g(in)150 -2903 y(an)30 b(application)h(b)s(ecoming)f(less)g(resp)s(onsiv)m(e)f +5340 y(an)30 b(application)h(b)s(ecoming)f(less)g(resp)s(onsiv)m(e)f (to)i(k)m(eyb)s(oard)e(signals)h(lik)m(e)h(SIGINT.)f(If)f(an)h -(application)150 3013 y(do)s(es)24 b(not)g(w)m(an)m(t)h(or)g(need)f(to) -h(p)s(erform)d(an)m(y)j(signal)g(handling,)g(or)f(do)s(es)g(not)h(need) -f(to)g(do)h(an)m(y)f(pro)s(cessing)150 3123 y(b)s(et)m(w)m(een)31 -b(calls)h(to)f Fs(rl_callback_read_char)p Ft(,)24 b(setting)32 -b(this)e(v)-5 b(ariable)31 b(ma)m(y)g(b)s(e)f(desirable.)275 -3260 y(Readline)f(pro)m(vides)f(t)m(w)m(o)i(v)-5 b(ariables)29 -b(that)h(allo)m(w)g(application)g(writers)e(to)h(con)m(trol)h(whether)e -(or)h(not)150 3370 y(it)34 b(will)f(catc)m(h)i(certain)f(signals)f(and) -g(act)h(on)f(them)g(when)f(they)i(are)f(receiv)m(ed.)51 -b(It)33 b(is)g(imp)s(ortan)m(t)g(that)150 3479 y(applications)38 -b(c)m(hange)g(the)e(v)-5 b(alues)37 b(of)g(these)g(v)-5 -b(ariables)37 b(only)g(when)f(calling)i Fs(readline\(\))p -Ft(,)d(not)i(in)g(a)150 3589 y(signal)31 b(handler,)f(so)g(Readline's)i -(in)m(ternal)f(signal)g(state)h(is)e(not)h(corrupted.)3371 -3779 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_catch_signals)390 -3889 y Ft(If)28 b(this)h(v)-5 b(ariable)30 b(is)f(non-zero,)h(Readline) -f(will)g(install)h(signal)f(handlers)f(for)h Fs(SIGINT)p -Ft(,)f Fs(SIGQUIT)p Ft(,)390 3998 y Fs(SIGTERM)p Ft(,)h -Fs(SIGHUP)p Ft(,)g Fs(SIGALRM)p Ft(,)f Fs(SIGTSTP)p Ft(,)h -Fs(SIGTTIN)p Ft(,)f(and)i Fs(SIGTTOU)p Ft(.)390 4136 -y(The)g(default)g(v)-5 b(alue)31 b(of)g Fs(rl_catch_signals)26 -b Ft(is)k(1.)3371 4326 y([V)-8 b(ariable])-3598 b Fh(int)53 -b(rl_catch_sigwinch)390 4436 y Ft(If)37 b(this)h(v)-5 -b(ariable)38 b(is)g(set)g(to)g(a)g(non-zero)g(v)-5 b(alue,)40 -b(Readline)f(will)f(install)g(a)g(signal)g(handler)f(for)390 -4546 y Fs(SIGWINCH)p Ft(.)390 4683 y(The)30 b(default)g(v)-5 -b(alue)31 b(of)g Fs(rl_catch_sigwinch)25 b Ft(is)31 b(1.)3371 -4874 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_persistent_signal_)q -(hand)q(ler)q(s)390 4983 y Ft(If)31 b(an)h(application)g(using)g(the)f -(callbac)m(k)j(in)m(terface)f(wishes)e(Readline's)h(signal)h(handlers)d -(to)j(b)s(e)390 5093 y(installed)21 b(and)f(activ)m(e)j(during)d(the)h -(set)g(of)f(calls)i(to)g Fs(rl_callback_read_char)14 -b Ft(that)22 b(constitutes)390 5202 y(an)30 b(en)m(tire)i(single)f -(line,)g(it)f(should)g(set)h(this)f(v)-5 b(ariable)31 -b(to)g(a)g(non-zero)g(v)-5 b(alue.)390 5340 y(The)30 -b(default)g(v)-5 b(alue)31 b(of)g Fs(rl_persistent_signal_han)o(dle)o -(rs)24 b Ft(is)31 b(0.)p eop end +(application)p eop end %%Page: 52 56 TeXDict begin 52 55 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(52)3371 -299 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_change_environment)390 -408 y Ft(If)31 b(this)g(v)-5 b(ariable)32 b(is)f(set)h(to)g(a)g -(non-zero)g(v)-5 b(alue,)32 b(and)f(Readline)h(is)f(handling)g -Fs(SIGWINCH)p Ft(,)e(Read-)390 518 y(line)h(will)h(mo)s(dify)e(the)h -Fj(LINES)35 b Ft(and)29 b Fj(COLUMNS)35 b Ft(en)m(vironmen)m(t)30 -b(v)-5 b(ariables)31 b(up)s(on)d(receipt)j(of)g(a)390 -628 y Fs(SIGWINCH)390 766 y Ft(The)f(default)g(v)-5 b(alue)31 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(52)150 +299 y(do)s(es)24 b(not)g(w)m(an)m(t)h(or)g(need)f(to)h(p)s(erform)d(an) +m(y)j(signal)g(handling,)g(or)f(do)s(es)g(not)h(need)f(to)g(do)h(an)m +(y)f(pro)s(cessing)150 408 y(b)s(et)m(w)m(een)31 b(calls)h(to)f +Fs(rl_callback_read_char)p Ft(,)24 b(setting)32 b(this)e(v)-5 +b(ariable)31 b(ma)m(y)g(b)s(e)f(desirable.)275 545 y(Readline)f(pro)m +(vides)f(t)m(w)m(o)i(v)-5 b(ariables)29 b(that)h(allo)m(w)g +(application)g(writers)e(to)h(con)m(trol)h(whether)e(or)h(not)150 +655 y(it)34 b(will)f(catc)m(h)i(certain)f(signals)f(and)g(act)h(on)f +(them)g(when)f(they)i(are)f(receiv)m(ed.)51 b(It)33 b(is)g(imp)s(ortan) +m(t)g(that)150 764 y(applications)38 b(c)m(hange)g(the)e(v)-5 +b(alues)37 b(of)g(these)g(v)-5 b(ariables)37 b(only)g(when)f(calling)i +Fs(readline\(\))p Ft(,)d(not)i(in)g(a)150 874 y(signal)31 +b(handler,)f(so)g(Readline's)i(in)m(ternal)f(signal)g(state)h(is)e(not) +h(corrupted.)3371 1062 y([V)-8 b(ariable])-3598 b Fh(int)53 +b(rl_catch_signals)390 1172 y Ft(If)28 b(this)h(v)-5 +b(ariable)30 b(is)f(non-zero,)h(Readline)f(will)g(install)h(signal)f +(handlers)f(for)h Fs(SIGINT)p Ft(,)f Fs(SIGQUIT)p Ft(,)390 +1282 y Fs(SIGTERM)p Ft(,)h Fs(SIGHUP)p Ft(,)g Fs(SIGALRM)p +Ft(,)f Fs(SIGTSTP)p Ft(,)h Fs(SIGTTIN)p Ft(,)f(and)i +Fs(SIGTTOU)p Ft(.)390 1418 y(The)g(default)g(v)-5 b(alue)31 +b(of)g Fs(rl_catch_signals)26 b Ft(is)k(1.)3371 1607 +y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_catch_sigwinch)390 +1716 y Ft(If)37 b(this)h(v)-5 b(ariable)38 b(is)g(set)g(to)g(a)g +(non-zero)g(v)-5 b(alue,)40 b(Readline)f(will)f(install)g(a)g(signal)g +(handler)f(for)390 1826 y Fs(SIGWINCH)p Ft(.)390 1963 +y(The)30 b(default)g(v)-5 b(alue)31 b(of)g Fs(rl_catch_sigwinch)25 +b Ft(is)31 b(1.)3371 2151 y([V)-8 b(ariable])-3598 b +Fh(int)53 b(rl_persistent_signal_)q(hand)q(ler)q(s)390 +2261 y Ft(If)31 b(an)h(application)g(using)g(the)f(callbac)m(k)j(in)m +(terface)f(wishes)e(Readline's)h(signal)h(handlers)d(to)j(b)s(e)390 +2370 y(installed)21 b(and)f(activ)m(e)j(during)d(the)h(set)g(of)f +(calls)i(to)g Fs(rl_callback_read_char)14 b Ft(that)22 +b(constitutes)390 2480 y(an)30 b(en)m(tire)i(single)f(line,)g(it)f +(should)g(set)h(this)f(v)-5 b(ariable)31 b(to)g(a)g(non-zero)g(v)-5 +b(alue.)390 2617 y(The)30 b(default)g(v)-5 b(alue)31 +b(of)g Fs(rl_persistent_signal_han)o(dle)o(rs)24 b Ft(is)31 +b(0.)3371 2805 y([V)-8 b(ariable])-3598 b Fh(int)53 b +(rl_change_environment)390 2915 y Ft(If)31 b(this)g(v)-5 +b(ariable)32 b(is)f(set)h(to)g(a)g(non-zero)g(v)-5 b(alue,)32 +b(and)f(Readline)h(is)f(handling)g Fs(SIGWINCH)p Ft(,)e(Read-)390 +3024 y(line)h(will)h(mo)s(dify)e(the)h Fj(LINES)35 b +Ft(and)29 b Fj(COLUMNS)35 b Ft(en)m(vironmen)m(t)30 b(v)-5 +b(ariables)31 b(up)s(on)d(receipt)j(of)g(a)390 3134 y +Fs(SIGWINCH)390 3271 y Ft(The)f(default)g(v)-5 b(alue)31 b(of)g Fs(rl_change_environment)24 b Ft(is)31 b(1.)275 -957 y(If)f(an)h(application)h(do)s(es)f(not)g(wish)f(to)i(ha)m(v)m(e)g +3459 y(If)f(an)h(application)h(do)s(es)f(not)g(wish)f(to)i(ha)m(v)m(e)g (Readline)g(catc)m(h)g(an)m(y)f(signals,)h(or)f(to)h(handle)e(signals) -150 1067 y(other)39 b(than)f(those)h(Readline)h(catc)m(hes)g(\()p +150 3569 y(other)39 b(than)f(those)h(Readline)h(catc)m(hes)g(\()p Fs(SIGHUP)p Ft(,)g(for)e(example\),)k(Readline)d(pro)m(vides)g(con)m(v) -m(enience)150 1177 y(functions)30 b(to)h(do)f(the)h(necessary)g +m(enience)150 3678 y(functions)30 b(to)h(do)f(the)h(necessary)g (terminal)g(and)e(in)m(ternal)i(state)h(clean)m(up)f(up)s(on)e(receipt) -i(of)g(a)f(signal.)3350 1368 y([F)-8 b(unction])-3599 +i(of)g(a)f(signal.)3350 3867 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_pending_signal)e Fg(\()p Ff(v)m(oid)p -Fg(\))390 1478 y Ft(Return)27 b(the)g(signal)h(n)m(um)m(b)s(er)e(of)i +Fg(\))390 3977 y Ft(Return)27 b(the)g(signal)h(n)m(um)m(b)s(er)e(of)i (the)f(most)h(recen)m(t)h(signal)f(Readline)g(receiv)m(ed)g(but)f(has)g -(not)h(y)m(et)390 1587 y(handled,)i(or)g(0)h(if)f(there)h(is)f(no)g(p)s -(ending)f(signal.)3350 1779 y([F)-8 b(unction])-3599 +(not)h(y)m(et)390 4086 y(handled,)i(or)g(0)h(if)f(there)h(is)f(no)g(p)s +(ending)f(signal.)3350 4275 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_cleanup_after_signal)e Fg(\()p Ff(v)m(oid)p -Fg(\))390 1889 y Ft(This)33 b(function)h(will)g(reset)g(the)g(state)i +Fg(\))390 4384 y Ft(This)33 b(function)h(will)g(reset)g(the)g(state)i (of)e(the)g(terminal)g(to)h(what)f(it)g(w)m(as)g(b)s(efore)g -Fs(readline\(\))390 1998 y Ft(w)m(as)c(called,)h(and)d(remo)m(v)m(e)j +Fs(readline\(\))390 4494 y Ft(w)m(as)c(called,)h(and)d(remo)m(v)m(e)j (the)f(Readline)g(signal)g(handlers)e(for)h(all)h(signals,)h(dep)s -(ending)d(on)h(the)390 2108 y(v)-5 b(alues)31 b(of)f +(ending)d(on)h(the)390 4603 y(v)-5 b(alues)31 b(of)f Fs(rl_catch_signals)c Ft(and)k Fs(rl_catch_sigwinch)p -Ft(.)3350 2300 y([F)-8 b(unction])-3599 b Fh(void)54 +Ft(.)3350 4792 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_free_line_state)c Fg(\()p Ff(v)m(oid)p Fg(\))390 -2409 y Ft(This)38 b(will)i(free)f(an)m(y)h(partial)g(state)g(asso)s +4902 y Ft(This)38 b(will)i(free)f(an)m(y)h(partial)g(state)g(asso)s (ciated)h(with)e(the)g(curren)m(t)g(input)f(line)i(\(undo)e(infor-)390 -2519 y(mation,)46 b(an)m(y)d(partial)h(history)e(en)m(try)-8 +5011 y(mation,)46 b(an)m(y)d(partial)h(history)e(en)m(try)-8 b(,)47 b(an)m(y)42 b(partially-en)m(tered)j(k)m(eyb)s(oard)d(macro,)47 -b(and)42 b(an)m(y)390 2628 y(partially-en)m(tered)50 +b(and)42 b(an)m(y)390 5121 y(partially-en)m(tered)50 b(n)m(umeric)d(argumen)m(t\).)94 b(This)47 b(should)g(b)s(e)g(called)i -(b)s(efore)e Fs(rl_cleanup_)390 2738 y(after_signal\(\))p +(b)s(efore)e Fs(rl_cleanup_)390 5230 y(after_signal\(\))p Ft(.)74 b(The)42 b(Readline)h(signal)g(handler)f(for)h Fs(SIGINT)e Ft(calls)i(this)g(to)g(ab)s(ort)g(the)390 -2847 y(curren)m(t)30 b(input)g(line.)3350 3039 y([F)-8 -b(unction])-3599 b Fh(void)54 b(rl_reset_after_signal)d -Fg(\()p Ff(v)m(oid)p Fg(\))390 3149 y Ft(This)28 b(will)g(reinitialize) -j(the)e(terminal)g(and)f(reinstall)h(an)m(y)g(Readline)g(signal)g -(handlers,)f(dep)s(end-)390 3258 y(ing)j(on)f(the)g(v)-5 +5340 y(curren)m(t)30 b(input)g(line.)p eop end +%%Page: 53 57 +TeXDict begin 53 56 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(53)3350 +299 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_reset_after_signal)d +Fg(\()p Ff(v)m(oid)p Fg(\))390 408 y Ft(This)28 b(will)g(reinitialize)j +(the)e(terminal)g(and)f(reinstall)h(an)m(y)g(Readline)g(signal)g +(handlers,)f(dep)s(end-)390 518 y(ing)j(on)f(the)g(v)-5 b(alues)31 b(of)g Fs(rl_catch_signals)26 b Ft(and)j Fs -(rl_catch_sigwinch)p Ft(.)275 3450 y(If)j(an)g(application)i(w)m(an)m +(rl_catch_sigwinch)p Ft(.)275 681 y(If)j(an)g(application)i(w)m(an)m (ts)g(to)f(force)g(Readline)h(to)f(handle)g(an)m(y)g(signals)g(that)g -(ha)m(v)m(e)h(arriv)m(ed)f(while)150 3560 y(it)j(has)g(b)s(een)f +(ha)m(v)m(e)h(arriv)m(ed)f(while)150 790 y(it)j(has)g(b)s(een)f (executing,)j Fs(rl_check_signals\(\))31 b Ft(will)36 b(call)h(Readline's)g(in)m(ternal)g(signal)f(handler)f(if)150 -3669 y(there)i(are)g(an)m(y)g(p)s(ending)e(signals.)61 +900 y(there)i(are)g(an)m(y)g(p)s(ending)e(signals.)61 b(This)36 b(is)g(primarily)h(in)m(tended)f(for)h(those)g(applications)h -(that)f(use)150 3779 y(a)h(custom)g Fs(rl_getc_function)33 +(that)f(use)150 1010 y(a)h(custom)g Fs(rl_getc_function)33 b Ft(\(see)39 b(Section)g(2.3)g([Readline)f(V)-8 b(ariables],)42 -b(page)c(29\))h(and)e(wish)g(to)150 3888 y(handle)30 +b(page)c(29\))h(and)e(wish)g(to)150 1119 y(handle)30 b(signals)h(receiv)m(ed)h(while)e(w)m(aiting)i(for)e(input.)3350 -4080 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_check_signals)c -Fg(\()p Ff(v)m(oid)p Fg(\))390 4190 y Ft(If)40 b(there)h(are)g(an)m(y)g +1282 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_check_signals)c +Fg(\()p Ff(v)m(oid)p Fg(\))390 1391 y Ft(If)40 b(there)h(are)g(an)m(y)g (p)s(ending)e(signals,)44 b(call)e(Readline's)g(in)m(ternal)f(signal)g -(handling)f(functions)390 4299 y(to)j(pro)s(cess)g(them.)77 +(handling)f(functions)390 1501 y(to)j(pro)s(cess)g(them.)77 b Fs(rl_pending_signal\(\))38 b Ft(can)43 b(b)s(e)f(used)g(indep)s -(enden)m(tly)f(to)j(determine)390 4409 y(whether)30 b(or)g(not)h(there) -f(are)h(an)m(y)g(p)s(ending)e(signals.)275 4600 y(If)38 +(enden)m(tly)f(to)j(determine)390 1611 y(whether)30 b(or)g(not)h(there) +f(are)h(an)m(y)g(p)s(ending)e(signals.)275 1773 y(If)38 b(an)i(application)g(do)s(es)f(not)h(wish)f(Readline)h(to)g(catc)m(h)h Fs(SIGWINCH)p Ft(,)e(it)h(ma)m(y)g(call)h Fs(rl_resize_)150 -4710 y(terminal\(\))24 b Ft(or)j Fs(rl_set_screen_size\(\))22 +1883 y(terminal\(\))24 b Ft(or)j Fs(rl_set_screen_size\(\))22 b Ft(to)28 b(force)g(Readline)f(to)h(up)s(date)f(its)g(idea)h(of)f(the) -g(terminal)150 4820 y(size)k(when)f(it)h(receiv)m(es)h(a)e -Fs(SIGWINCH)p Ft(.)3350 5011 y([F)-8 b(unction])-3599 +g(terminal)150 1992 y(size)k(when)f(it)h(receiv)m(es)h(a)e +Fs(SIGWINCH)p Ft(.)3350 2155 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_echo_signal_char)d Fg(\()p Ff(in)m(t)33 -b(sig)p Fg(\))390 5121 y Ft(If)41 b(an)g(application)h(wishes)f(to)h +b(sig)p Fg(\))390 2265 y Ft(If)41 b(an)g(application)h(wishes)f(to)h (install)g(its)f(o)m(wn)g(signal)h(handlers,)h(but)e(still)h(ha)m(v)m -(e)g(Readline)390 5230 y(displa)m(y)31 b(c)m(haracters)h(that)f +(e)g(Readline)390 2374 y(displa)m(y)31 b(c)m(haracters)h(that)f (generate)h(signals,)f(calling)h(this)e(function)g(with)g -Fj(sig)39 b Ft(set)31 b(to)g Fs(SIGINT)p Ft(,)390 5340 +Fj(sig)39 b Ft(set)31 b(to)g Fs(SIGINT)p Ft(,)390 2484 y Fs(SIGQUIT)p Ft(,)e(or)h Fs(SIGTSTP)e Ft(will)j(displa)m(y)g(the)f(c) -m(haracter)i(generating)g(that)f(signal.)p eop end -%%Page: 53 57 -TeXDict begin 53 56 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(53)3350 -299 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_resize_terminal)c -Fg(\()p Ff(v)m(oid)p Fg(\))390 408 y Ft(Up)s(date)30 +m(haracter)i(generating)g(that)f(signal.)3350 2647 y([F)-8 +b(unction])-3599 b Fh(void)54 b(rl_resize_terminal)c +Fg(\()p Ff(v)m(oid)p Fg(\))390 2756 y Ft(Up)s(date)30 b(Readline's)h(in)m(ternal)g(screen)g(size)g(b)m(y)f(reading)h(v)-5 -b(alues)31 b(from)f(the)g(k)m(ernel.)3350 592 y([F)-8 +b(alues)31 b(from)f(the)g(k)m(ernel.)3350 2919 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_set_screen_size)c Fg(\()p Ff(in)m(t)34 b(ro)m(ws,)f(in)m(t)g(cols)p Fg(\))390 -702 y Ft(Set)28 b(Readline's)h(idea)f(of)g(the)g(terminal)g(size)h(to)g -Fj(ro)m(ws)i Ft(ro)m(ws)d(and)f Fj(cols)33 b Ft(columns.)40 -b(If)27 b(either)h Fj(ro)m(ws)390 811 y Ft(or)35 b Fj(columns)k +3029 y Ft(Set)28 b(Readline's)h(idea)f(of)g(the)g(terminal)g(size)h(to) +g Fj(ro)m(ws)i Ft(ro)m(ws)d(and)f Fj(cols)33 b Ft(columns.)40 +b(If)27 b(either)h Fj(ro)m(ws)390 3138 y Ft(or)35 b Fj(columns)k Ft(is)c(less)g(than)g(or)g(equal)h(to)g(0,)h(Readline's)f(idea)g(of)f -(that)h(terminal)f(dimension)g(is)390 921 y(unc)m(hanged.)k(This)27 +(that)h(terminal)f(dimension)g(is)390 3248 y(unc)m(hanged.)k(This)27 b(is)h(in)m(tended)g(to)g(tell)h(Readline)f(the)g(ph)m(ysical)g -(dimensions)f(of)h(the)g(terminal,)390 1031 y(and)44 +(dimensions)f(of)h(the)g(terminal,)390 3357 y(and)44 b(is)h(used)f(in)m(ternally)i(to)f(calculate)j(the)d(maxim)m(um)f(n)m (um)m(b)s(er)g(of)h(c)m(haracters)h(that)f(ma)m(y)390 -1140 y(app)s(ear)30 b(on)g(a)h(single)g(line)g(and)e(on)i(the)f -(screen.)275 1324 y(If)i(an)i(application)g(do)s(es)f(not)h(w)m(an)m(t) +3467 y(app)s(ear)30 b(on)g(a)h(single)g(line)g(and)e(on)i(the)f +(screen.)275 3630 y(If)i(an)i(application)g(do)s(es)f(not)h(w)m(an)m(t) g(to)g(install)g(a)g Fs(SIGWINCH)d Ft(handler,)j(but)e(is)i(still)g(in) -m(terested)g(in)150 1434 y(the)d(screen)f(dimensions,)g(it)h(ma)m(y)g +m(terested)g(in)150 3739 y(the)d(screen)f(dimensions,)g(it)h(ma)m(y)g (query)f(Readline's)h(idea)g(of)f(the)h(screen)f(size.)3350 -1618 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_get_screen_size)c +3902 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_get_screen_size)c Fg(\()p Ff(in)m(t)34 b(*ro)m(ws,)f(in)m(t)g(*cols)p Fg(\))390 -1727 y Ft(Return)c(Readline's)i(idea)g(of)f(the)g(terminal's)h(size)g +4011 y Ft(Return)c(Readline's)i(idea)g(of)f(the)g(terminal's)h(size)g (in)f(the)g(v)-5 b(ariables)31 b(p)s(oin)m(ted)f(to)g(b)m(y)g(the)h -(argu-)390 1837 y(men)m(ts.)3350 2021 y([F)-8 b(unction])-3599 +(argu-)390 4121 y(men)m(ts.)3350 4284 y([F)-8 b(unction])-3599 b Fh(void)54 b(rl_reset_screen_size)d Fg(\()p Ff(v)m(oid)p -Fg(\))390 2130 y Ft(Cause)30 b(Readline)h(to)g(reobtain)g(the)g(screen) -f(size)h(and)f(recalculate)j(its)e(dimensions.)275 2314 +Fg(\))390 4393 y Ft(Cause)30 b(Readline)h(to)g(reobtain)g(the)g(screen) +f(size)h(and)f(recalculate)j(its)e(dimensions.)275 4556 y(The)e(follo)m(wing)j(functions)e(install)h(and)f(remo)m(v)m(e)i -(Readline's)f(signal)g(handlers.)3350 2498 y([F)-8 b(unction])-3599 +(Readline's)f(signal)g(handlers.)3350 4719 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_set_signals)d Fg(\()p Ff(v)m(oid)p Fg(\))390 -2607 y Ft(Install)40 b(Readline's)h(signal)f(handler)f(for)h +4828 y Ft(Install)40 b(Readline's)h(signal)f(handler)f(for)h Fs(SIGINT)p Ft(,)h Fs(SIGQUIT)p Ft(,)f Fs(SIGTERM)p Ft(,)h -Fs(SIGHUP)p Ft(,)g Fs(SIGALRM)p Ft(,)390 2717 y Fs(SIGTSTP)p +Fs(SIGHUP)p Ft(,)g Fs(SIGALRM)p Ft(,)390 4938 y Fs(SIGTSTP)p Ft(,)35 b Fs(SIGTTIN)p Ft(,)f Fs(SIGTTOU)p Ft(,)h(and)g Fs(SIGWINCH)p Ft(,)f(dep)s(ending)g(on)h(the)g(v)-5 b(alues)36 -b(of)f Fs(rl_catch_)390 2827 y(signals)28 b Ft(and)i -Fs(rl_catch_sigwinch)p Ft(.)3350 3010 y([F)-8 b(unction])-3599 +b(of)f Fs(rl_catch_)390 5047 y(signals)28 b Ft(and)i +Fs(rl_catch_sigwinch)p Ft(.)3350 5210 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_clear_signals)e Fg(\()p Ff(v)m(oid)p -Fg(\))390 3120 y Ft(Remo)m(v)m(e)32 b(all)f(of)g(the)g(Readline)g +Fg(\))390 5320 y Ft(Remo)m(v)m(e)32 b(all)f(of)g(the)g(Readline)g (signal)g(handlers)e(installed)i(b)m(y)f Fs(rl_set_signals\(\))p -Ft(.)150 3361 y Fr(2.6)68 b(Custom)45 b(Completers)150 -3520 y Ft(T)m(ypically)-8 b(,)47 b(a)c(program)g(that)g(reads)f -(commands)h(from)f(the)g(user)g(has)h(a)g(w)m(a)m(y)g(of)g(disam)m -(biguating)150 3630 y(commands)35 b(and)g(data.)56 b(If)35 -b(y)m(our)h(program)f(is)g(one)h(of)g(these,)h(then)e(it)h(can)g(pro)m -(vide)f(completion)i(for)150 3739 y(commands,)29 b(data,)i(or)e(b)s -(oth.)39 b(The)29 b(follo)m(wing)i(sections)f(describ)s(e)e(ho)m(w)i(y) -m(our)f(program)g(and)f(Readline)150 3849 y(co)s(op)s(erate)j(to)h(pro) -m(vide)e(this)g(service.)150 4048 y Fi(2.6.1)63 b(Ho)m(w)40 -b(Completing)i(W)-10 b(orks)150 4195 y Ft(In)26 b(order)f(to)i -(complete)h(some)f(text,)h(the)f(full)f(list)h(of)f(p)s(ossible)g -(completions)h(m)m(ust)g(b)s(e)e(a)m(v)-5 b(ailable.)42 -b(That)150 4304 y(is,)28 b(it)f(is)g(not)g(p)s(ossible)g(to)g -(accurately)i(expand)d(a)h(partial)h(w)m(ord)f(without)f(kno)m(wing)i -(all)f(of)g(the)g(p)s(ossible)150 4414 y(w)m(ords)33 +Ft(.)p eop end +%%Page: 54 58 +TeXDict begin 54 57 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(54)150 +299 y Fr(2.6)68 b(Custom)45 b(Completers)150 458 y Ft(T)m(ypically)-8 +b(,)47 b(a)c(program)g(that)g(reads)f(commands)h(from)f(the)g(user)g +(has)h(a)g(w)m(a)m(y)g(of)g(disam)m(biguating)150 568 +y(commands)35 b(and)g(data.)56 b(If)35 b(y)m(our)h(program)f(is)g(one)h +(of)g(these,)h(then)e(it)h(can)g(pro)m(vide)f(completion)i(for)150 +677 y(commands,)29 b(data,)i(or)e(b)s(oth.)39 b(The)29 +b(follo)m(wing)i(sections)f(describ)s(e)e(ho)m(w)i(y)m(our)f(program)g +(and)f(Readline)150 787 y(co)s(op)s(erate)j(to)h(pro)m(vide)e(this)g +(service.)150 970 y Fi(2.6.1)63 b(Ho)m(w)40 b(Completing)i(W)-10 +b(orks)150 1117 y Ft(In)26 b(order)f(to)i(complete)h(some)f(text,)h +(the)f(full)f(list)h(of)f(p)s(ossible)g(completions)h(m)m(ust)g(b)s(e)e +(a)m(v)-5 b(ailable.)42 b(That)150 1227 y(is,)28 b(it)f(is)g(not)g(p)s +(ossible)g(to)g(accurately)i(expand)d(a)h(partial)h(w)m(ord)f(without)f +(kno)m(wing)i(all)f(of)g(the)g(p)s(ossible)150 1336 y(w)m(ords)33 b(whic)m(h)g(mak)m(e)h(sense)f(in)g(that)g(con)m(text.)51 b(The)33 b(Readline)h(library)e(pro)m(vides)i(the)f(user)f(in)m -(terface)150 4523 y(to)d(completion,)h(and)e(t)m(w)m(o)i(of)e(the)h +(terface)150 1446 y(to)d(completion,)h(and)e(t)m(w)m(o)i(of)e(the)h (most)f(common)h(completion)h(functions:)39 b(\014lename)29 -b(and)e(username.)150 4633 y(F)-8 b(or)39 b(completing)g(other)f(t)m +b(and)e(username.)150 1555 y(F)-8 b(or)39 b(completing)g(other)f(t)m (yp)s(es)g(of)h(text,)i(y)m(ou)d(m)m(ust)g(write)g(y)m(our)g(o)m(wn)g -(completion)h(function.)64 b(This)150 4743 y(section)32 +(completion)h(function.)64 b(This)150 1665 y(section)32 b(describ)s(es)d(exactly)j(what)f(suc)m(h)f(functions)g(m)m(ust)g(do,)g -(and)g(pro)m(vides)g(an)h(example.)275 4877 y(There)e(are)i(three)g(ma) +(and)g(pro)m(vides)g(an)h(example.)275 1791 y(There)e(are)i(three)g(ma) 5 b(jor)30 b(functions)g(used)g(to)h(p)s(erform)e(completion:)199 -5011 y(1.)61 b(The)43 b(user-in)m(terface)h(function)f +1918 y(1.)61 b(The)43 b(user-in)m(terface)h(function)f Fs(rl_complete\(\))p Ft(.)76 b(This)43 b(function)g(is)g(called)i(with) -e(the)h(same)330 5121 y(argumen)m(ts)36 b(as)g(other)g(bindable)f +e(the)h(same)330 2027 y(argumen)m(ts)36 b(as)g(other)g(bindable)f (Readline)h(functions:)51 b Fj(coun)m(t)38 b Ft(and)d -Fj(in)m(v)m(oking)p 3107 5121 28 4 v 41 w(k)m(ey)p Ft(.)57 -b(It)36 b(isolates)330 5230 y(the)i(w)m(ord)f(to)h(b)s(e)f(completed)i +Fj(in)m(v)m(oking)p 3107 2027 28 4 v 41 w(k)m(ey)p Ft(.)57 +b(It)36 b(isolates)330 2137 y(the)i(w)m(ord)f(to)h(b)s(e)f(completed)i (and)d(calls)j Fs(rl_completion_matches\(\))31 b Ft(to)39 -b(generate)g(a)f(list)g(of)330 5340 y(p)s(ossible)31 +b(generate)g(a)f(list)g(of)330 2247 y(p)s(ossible)31 b(completions.)44 b(It)31 b(then)g(either)g(lists)h(the)f(p)s(ossible)g -(completions,)h(inserts)f(the)g(p)s(ossible)p eop end -%%Page: 54 58 -TeXDict begin 54 57 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(54)330 -299 y(completions,)50 b(or)45 b(actually)i(p)s(erforms)d(the)h -(completion,)50 b(dep)s(ending)44 b(on)h(whic)m(h)g(b)s(eha)m(vior)g -(is)330 408 y(desired.)199 552 y(2.)61 b(The)33 b(in)m(ternal)h -(function)g Fs(rl_completion_matches\(\))27 b Ft(uses)33 -b(an)g(application-supplied)h Fj(gener-)330 662 y(ator)44 +(completions,)h(inserts)f(the)g(p)s(ossible)330 2356 +y(completions,)50 b(or)45 b(actually)i(p)s(erforms)d(the)h(completion,) +50 b(dep)s(ending)44 b(on)h(whic)m(h)g(b)s(eha)m(vior)g(is)330 +2466 y(desired.)199 2592 y(2.)61 b(The)33 b(in)m(ternal)h(function)g +Fs(rl_completion_matches\(\))27 b Ft(uses)33 b(an)g +(application-supplied)h Fj(gener-)330 2702 y(ator)44 b Ft(function)37 b(to)h(generate)g(the)f(list)h(of)f(p)s(ossible)f (matc)m(hes,)k(and)d(then)f(returns)g(the)h(arra)m(y)h(of)330 -771 y(these)h(matc)m(hes.)68 b(The)39 b(caller)h(should)e(place)i(the)f -(address)f(of)h(its)g(generator)i(function)d(in)h Fs(rl_)330 -881 y(completion_entry_functio)o(n)p Ft(.)199 1024 y(3.)61 +2811 y(these)h(matc)m(hes.)68 b(The)39 b(caller)h(should)e(place)i(the) +f(address)f(of)h(its)g(generator)i(function)d(in)h Fs(rl_)330 +2921 y(completion_entry_functio)o(n)p Ft(.)199 3047 y(3.)61 b(The)22 b(generator)i(function)f(is)g(called)h(rep)s(eatedly)f(from)g -Fs(rl_completion_matches\(\))o Ft(,)c(returning)330 1134 +Fs(rl_completion_matches\(\))o Ft(,)c(returning)330 3157 y(a)33 b(string)g(eac)m(h)h(time.)48 b(The)32 b(argumen)m(ts)h(to)h (the)f(generator)h(function)e(are)h Fj(text)j Ft(and)c -Fj(state)p Ft(.)49 b Fj(text)330 1244 y Ft(is)32 b(the)g(partial)h(w)m +Fj(state)p Ft(.)49 b Fj(text)330 3267 y Ft(is)32 b(the)g(partial)h(w)m (ord)f(to)h(b)s(e)e(completed.)47 b Fj(state)38 b Ft(is)32 b(zero)h(the)f(\014rst)g(time)g(the)h(function)e(is)h(called,)330 -1353 y(allo)m(wing)46 b(the)e(generator)h(to)f(p)s(erform)f(an)m(y)h +3376 y(allo)m(wing)46 b(the)e(generator)h(to)f(p)s(erform)f(an)m(y)h (necessary)g(initialization,)51 b(and)43 b(a)h(p)s(ositiv)m(e)h(non-) -330 1463 y(zero)30 b(in)m(teger)h(for)d(eac)m(h)j(subsequen)m(t)d +330 3486 y(zero)30 b(in)m(teger)h(for)d(eac)m(h)j(subsequen)m(t)d (call.)42 b(The)29 b(generator)h(function)f(returns)f -Fs(\(char)h(*\)NULL)e Ft(to)330 1572 y(inform)37 b Fs +Fs(\(char)h(*\)NULL)e Ft(to)330 3595 y(inform)37 b Fs (rl_completion_matches\(\))32 b Ft(that)39 b(there)f(are)g(no)g(more)g -(p)s(ossibilities)h(left.)65 b(Usually)330 1682 y(the)39 +(p)s(ossibilities)h(left.)65 b(Usually)330 3705 y(the)39 b(generator)h(function)e(computes)h(the)g(list)g(of)g(p)s(ossible)f (completions)i(when)e Fj(state)45 b Ft(is)39 b(zero,)330 -1792 y(and)25 b(returns)f(them)i(one)f(at)i(a)f(time)g(on)f(subsequen)m +3814 y(and)25 b(returns)f(them)i(one)f(at)i(a)f(time)g(on)f(subsequen)m (t)g(calls.)40 b(Eac)m(h)26 b(string)g(the)g(generator)g(function)330 -1901 y(returns)31 b(as)h(a)g(matc)m(h)h(m)m(ust)f(b)s(e)f(allo)s(cated) +3924 y(returns)31 b(as)h(a)g(matc)m(h)h(m)m(ust)f(b)s(e)f(allo)s(cated) j(with)d Fs(malloc\(\))p Ft(;)g(Readline)h(frees)g(the)g(strings)g -(when)330 2011 y(it)i(has)g(\014nished)e(with)i(them.)51 +(when)330 4034 y(it)i(has)g(\014nished)e(with)i(them.)51 b(Suc)m(h)33 b(a)h(generator)h(function)f(is)g(referred)f(to)h(as)h(an) -e Fj(application-)330 2120 y(sp)s(eci\014c)d(completion)i(function)p -Ft(.)3350 2341 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_complete)c +e Fj(application-)330 4143 y(sp)s(eci\014c)d(completion)i(function)p +Ft(.)3350 4303 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_complete)c Fg(\()p Ff(in)m(t)34 b(ignore,)e(in)m(t)i(in)m(v)m(oking)p -2020 2341 30 5 v 43 w(k)m(ey)p Fg(\))390 2451 y Ft(Complete)d(the)g(w)m +2020 4303 30 5 v 43 w(k)m(ey)p Fg(\))390 4413 y Ft(Complete)d(the)g(w)m (ord)g(at)g(or)g(b)s(efore)f(p)s(oin)m(t.)41 b(Y)-8 b(ou)32 b(ha)m(v)m(e)g(supplied)d(the)i(function)f(that)h(do)s(es)g(the)390 -2560 y(initial)42 b(simple)f(matc)m(hing)i(selection)f(algorithm)h +4522 y(initial)42 b(simple)f(matc)m(hing)i(selection)f(algorithm)h (\(see)f Fs(rl_completion_matches\(\))o Ft(\).)67 b(The)390 -2670 y(default)31 b(is)f(to)h(do)f(\014lename)h(completion.)3371 -2890 y([V)-8 b(ariable])-3598 b Fh(rl_compentry_func_t)58 -b(*)53 b(rl_completion_entry_fun)q(cti)q(on)390 3000 +4632 y(default)31 b(is)f(to)h(do)f(\014lename)h(completion.)3371 +4792 y([V)-8 b(ariable])-3598 b Fh(rl_compentry_func_t)58 +b(*)53 b(rl_completion_entry_fun)q(cti)q(on)390 4902 y Ft(This)39 b(is)h(a)g(p)s(oin)m(ter)g(to)h(the)f(generator)h (function)f(for)f Fs(rl_completion_matches\(\))p Ft(.)63 -b(If)40 b(the)390 3110 y(v)-5 b(alue)24 b(of)g Fs +b(If)40 b(the)390 5011 y(v)-5 b(alue)24 b(of)g Fs (rl_completion_entry_funct)o(ion)17 b Ft(is)24 b Fs(NULL)f Ft(then)g(the)h(default)g(\014lename)g(generator)390 -3219 y(function,)49 b Fs(rl_filename_completion_)o(fun)o(ctio)o(n\(\))p +5121 y(function,)49 b Fs(rl_filename_completion_)o(fun)o(ctio)o(n\(\))p Ft(,)42 b(is)j(used.)84 b(An)44 b Fj(application-sp)s(eci\014c)390 -3329 y(completion)22 b(function)f Ft(is)g(a)h(function)e(whose)h +5230 y(completion)22 b(function)f Ft(is)g(a)h(function)e(whose)h (address)f(is)h(assigned)h(to)f Fs(rl_completion_entry_)390 -3438 y(function)28 b Ft(and)i(whose)g(return)f(v)-5 b(alues)31 -b(are)g(used)e(to)j(generate)f(p)s(ossible)f(completions.)150 -3656 y Fi(2.6.2)63 b(Completion)41 b(F)-10 b(unctions)150 -3803 y Ft(Here)31 b(is)f(the)h(complete)h(list)f(of)f(callable)j +5340 y(function)28 b Ft(and)i(whose)g(return)f(v)-5 b(alues)31 +b(are)g(used)e(to)j(generate)f(p)s(ossible)f(completions.)p +eop end +%%Page: 55 59 +TeXDict begin 55 58 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(55)150 +299 y Fi(2.6.2)63 b(Completion)41 b(F)-10 b(unctions)150 +446 y Ft(Here)31 b(is)f(the)h(complete)h(list)f(of)f(callable)j (completion)e(functions)f(presen)m(t)h(in)f(Readline.)3350 -4023 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_complete_internal)f -Fg(\()p Ff(in)m(t)33 b(what)p 1861 4023 V 44 w(to)p 1994 -4023 V 43 w(do)p Fg(\))390 4133 y Ft(Complete)k(the)g(w)m(ord)f(at)i -(or)e(b)s(efore)g(p)s(oin)m(t.)60 b Fj(what)p 2208 4133 -28 4 v 40 w(to)p 2328 4133 V 41 w(do)41 b Ft(sa)m(ys)c(what)f(to)i(do)e -(with)g(the)h(com-)390 4243 y(pletion.)44 b(A)31 b(v)-5 +640 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_complete_internal)f +Fg(\()p Ff(in)m(t)33 b(what)p 1861 640 30 5 v 44 w(to)p +1994 640 V 43 w(do)p Fg(\))390 749 y Ft(Complete)k(the)g(w)m(ord)f(at)i +(or)e(b)s(efore)g(p)s(oin)m(t.)60 b Fj(what)p 2208 749 +28 4 v 40 w(to)p 2328 749 V 41 w(do)41 b Ft(sa)m(ys)c(what)f(to)i(do)e +(with)g(the)h(com-)390 859 y(pletion.)44 b(A)31 b(v)-5 b(alue)32 b(of)f(`)p Fs(?)p Ft(')g(means)h(list)f(the)h(p)s(ossible)e (completions.)45 b(`)p Fs(TAB)p Ft(')31 b(means)g(do)g(standard)390 -4352 y(completion.)44 b(`)p Fs(*)p Ft(')32 b(means)f(insert)g(all)h(of) -f(the)g(p)s(ossible)g(completions.)44 b(`)p Fs(!)p Ft(')32 -b(means)f(to)h(displa)m(y)f(all)390 4462 y(of)k(the)f(p)s(ossible)g +969 y(completion.)44 b(`)p Fs(*)p Ft(')32 b(means)f(insert)g(all)h(of)f +(the)g(p)s(ossible)g(completions.)44 b(`)p Fs(!)p Ft(')32 +b(means)f(to)h(displa)m(y)f(all)390 1078 y(of)k(the)f(p)s(ossible)g (completions,)j(if)d(there)h(is)f(more)g(than)h(one,)g(as)g(w)m(ell)g -(as)g(p)s(erforming)e(partial)390 4571 y(completion.)41 +(as)g(p)s(erforming)e(partial)390 1188 y(completion.)41 b(`)p Fs(@)p Ft(')27 b(is)h(similar)f(to)h(`)p Fs(!)p Ft(',)h(but)d(p)s(ossible)h(completions)i(are)e(not)h(listed)g(if)f -(the)g(p)s(ossible)390 4681 y(completions)32 b(share)e(a)g(common)h -(pre\014x.)3350 4902 y([F)-8 b(unction])-3599 b Fh(int)53 +(the)g(p)s(ossible)390 1297 y(completions)32 b(share)e(a)g(common)h +(pre\014x.)3350 1491 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_complete)c Fg(\()p Ff(in)m(t)34 b(ignore,)e(in)m(t)i(in)m(v)m -(oking)p 2020 4902 30 5 v 43 w(k)m(ey)p Fg(\))390 5011 +(oking)p 2020 1491 30 5 v 43 w(k)m(ey)p Fg(\))390 1601 y Ft(Complete)42 b(the)f(w)m(ord)g(at)h(or)f(b)s(efore)g(p)s(oin)m(t.) 73 b(Y)-8 b(ou)41 b(ha)m(v)m(e)i(supplied)c(the)j(function)f(that)g(do) -s(es)390 5121 y(the)33 b(initial)h(simple)f(matc)m(hing)h(selection)h +s(es)390 1710 y(the)33 b(initial)h(simple)f(matc)m(hing)h(selection)h (algorithm)f(\(see)g Fs(rl_completion_matches\(\))27 -b Ft(and)390 5230 y Fs(rl_completion_entry_func)o(tion)o +b Ft(and)390 1820 y Fs(rl_completion_entry_func)o(tion)o Ft(\).)52 b(The)35 b(default)h(is)g(to)h(do)e(\014lename)h(completion.) -59 b(This)390 5340 y(calls)32 b Fs(rl_complete_internal\(\))24 +59 b(This)390 1930 y(calls)32 b Fs(rl_complete_internal\(\))24 b Ft(with)30 b(an)g(argumen)m(t)h(dep)s(ending)e(on)h -Fj(in)m(v)m(oking)p 3314 5340 28 4 v 41 w(k)m(ey)p Ft(.)p -eop end -%%Page: 55 59 -TeXDict begin 55 58 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(55)3350 -299 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_possible_completio)q(ns)f -Fg(\()p Ff(in)m(t)33 b(coun)m(t,)h(in)m(t)f(in)m(v)m(oking)p -2622 299 30 5 v 43 w(k)m(ey)p Fg(\))390 408 y Ft(List)41 +Fj(in)m(v)m(oking)p 3314 1930 28 4 v 41 w(k)m(ey)p Ft(.)3350 +2124 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_possible_completio)q(ns) +f Fg(\()p Ff(in)m(t)33 b(coun)m(t,)h(in)m(t)f(in)m(v)m(oking)p +2622 2124 30 5 v 43 w(k)m(ey)p Fg(\))390 2233 y Ft(List)41 b(the)f(p)s(ossible)g(completions.)73 b(See)40 b(description)h(of)g Fs(rl_complete)27 b(\(\))p Ft(.)70 b(This)40 b(calls)i -Fs(rl_)390 518 y(complete_internal\(\))25 b Ft(with)30 -b(an)g(argumen)m(t)h(of)g(`)p Fs(?)p Ft('.)3350 718 y([F)-8 -b(unction])-3599 b Fh(int)53 b(rl_insert_completions)f +Fs(rl_)390 2343 y(complete_internal\(\))25 b Ft(with)30 +b(an)g(argumen)m(t)h(of)g(`)p Fs(?)p Ft('.)3350 2537 +y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_insert_completions)f Fg(\()p Ff(in)m(t)34 b(coun)m(t,)f(in)m(t)g(in)m(v)m(oking)p -2517 718 V 44 w(k)m(ey)p Fg(\))390 828 y Ft(Insert)g(the)h(list)g(of)g -(p)s(ossible)f(completions)i(in)m(to)f(the)g(line,)h(deleting)g(the)f -(partially-completed)390 937 y(w)m(ord.)44 b(See)32 b(description)g(of) -g Fs(rl_complete\(\))p Ft(.)41 b(This)31 b(calls)i Fs -(rl_complete_internal\(\))25 b Ft(with)390 1047 y(an)30 -b(argumen)m(t)h(of)g(`)p Fs(*)p Ft('.)3350 1247 y([F)-8 -b(unction])-3599 b Fh(int)53 b(rl_completion_mode)e Fg(\()p -Ff(rl)p 1455 1247 V 44 w(command)p 1919 1247 V 44 w(func)p -2147 1247 V 46 w(t)33 b(*cfunc)p Fg(\))390 1356 y Ft(Returns)40 -b(the)i(appropriate)g(v)-5 b(alue)41 b(to)i(pass)e(to)h -Fs(rl_complete_internal\(\))35 b Ft(dep)s(ending)40 b(on)390 -1466 y(whether)g Fj(cfunc)46 b Ft(w)m(as)41 b(called)h(t)m(wice)g(in)f -(succession)g(and)f(the)h(v)-5 b(alues)41 b(of)g(the)g -Fs(show-all-if-)390 1575 y(ambiguous)25 b Ft(and)i Fs -(show-all-if-unmodified)21 b Ft(v)-5 b(ariables.)41 b(Application-sp)s -(eci\014c)29 b(completion)390 1685 y(functions)h(ma)m(y)h(use)f(this)g -(function)g(to)h(presen)m(t)g(the)f(same)h(in)m(terface)h(as)f -Fs(rl_complete\(\))p Ft(.)3350 1885 y([F)-8 b(unction])-3599 -b Fh(char)54 b(**)e(rl_completion_matches)g Fg(\()p Ff(const)34 -b(c)m(har)g(*text,)565 1995 y(rl)p 639 1995 V 44 w(comp)s(en)m(try)p -1145 1995 V 44 w(func)p 1373 1995 V 45 w(t)f(*en)m(try)p -1767 1995 V 44 w(func)p Fg(\))390 2104 y Ft(Returns)k(an)h(arra)m(y)g -(of)g(strings)g(whic)m(h)f(is)h(a)g(list)h(of)f(completions)h(for)e -Fj(text)p Ft(.)64 b(If)38 b(there)g(are)g(no)390 2214 +2517 2537 V 44 w(k)m(ey)p Fg(\))390 2646 y Ft(Insert)g(the)h(list)g(of) +g(p)s(ossible)f(completions)i(in)m(to)f(the)g(line,)h(deleting)g(the)f +(partially-completed)390 2756 y(w)m(ord.)44 b(See)32 +b(description)g(of)g Fs(rl_complete\(\))p Ft(.)41 b(This)31 +b(calls)i Fs(rl_complete_internal\(\))25 b Ft(with)390 +2865 y(an)30 b(argumen)m(t)h(of)g(`)p Fs(*)p Ft('.)3350 +3059 y([F)-8 b(unction])-3599 b Fh(int)53 b(rl_completion_mode)e +Fg(\()p Ff(rl)p 1455 3059 V 44 w(command)p 1919 3059 +V 44 w(func)p 2147 3059 V 46 w(t)33 b(*cfunc)p Fg(\))390 +3169 y Ft(Returns)40 b(the)i(appropriate)g(v)-5 b(alue)41 +b(to)i(pass)e(to)h Fs(rl_complete_internal\(\))35 b Ft(dep)s(ending)40 +b(on)390 3279 y(whether)g Fj(cfunc)46 b Ft(w)m(as)41 +b(called)h(t)m(wice)g(in)f(succession)g(and)f(the)h(v)-5 +b(alues)41 b(of)g(the)g Fs(show-all-if-)390 3388 y(ambiguous)25 +b Ft(and)i Fs(show-all-if-unmodified)21 b Ft(v)-5 b(ariables.)41 +b(Application-sp)s(eci\014c)29 b(completion)390 3498 +y(functions)h(ma)m(y)h(use)f(this)g(function)g(to)h(presen)m(t)g(the)f +(same)h(in)m(terface)h(as)f Fs(rl_complete\(\))p Ft(.)3350 +3692 y([F)-8 b(unction])-3599 b Fh(char)54 b(**)e +(rl_completion_matches)g Fg(\()p Ff(const)34 b(c)m(har)g(*text,)565 +3801 y(rl)p 639 3801 V 44 w(comp)s(en)m(try)p 1145 3801 +V 44 w(func)p 1373 3801 V 45 w(t)f(*en)m(try)p 1767 3801 +V 44 w(func)p Fg(\))390 3911 y Ft(Returns)k(an)h(arra)m(y)g(of)g +(strings)g(whic)m(h)f(is)h(a)g(list)h(of)f(completions)h(for)e +Fj(text)p Ft(.)64 b(If)38 b(there)g(are)g(no)390 4020 y(completions,)f(returns)c Fs(NULL)p Ft(.)52 b(The)34 b(\014rst)f(en)m(try)i(in)f(the)h(returned)e(arra)m(y)i(is)g(the)f -(substitution)390 2323 y(for)26 b Fj(text)p Ft(.)40 b(The)26 +(substitution)390 4130 y(for)26 b Fj(text)p Ft(.)40 b(The)26 b(remaining)h(en)m(tries)g(are)g(the)f(p)s(ossible)g(completions.)40 -b(The)26 b(arra)m(y)h(is)f(terminated)390 2433 y(with)k(a)h -Fs(NULL)e Ft(p)s(oin)m(ter.)390 2575 y Fj(en)m(try)p -603 2575 28 4 v 40 w(func)44 b Ft(is)c(a)g(function)f(of)h(t)m(w)m(o)g +b(The)26 b(arra)m(y)h(is)f(terminated)390 4240 y(with)k(a)h +Fs(NULL)e Ft(p)s(oin)m(ter.)390 4379 y Fj(en)m(try)p +603 4379 28 4 v 40 w(func)44 b Ft(is)c(a)g(function)f(of)h(t)m(w)m(o)g (args,)j(and)38 b(returns)h(a)g Fs(char)30 b(*)p Ft(.)67 -b(The)39 b(\014rst)g(argumen)m(t)h(is)390 2685 y Fj(text)p +b(The)39 b(\014rst)g(argumen)m(t)h(is)390 4489 y Fj(text)p Ft(.)66 b(The)39 b(second)f(is)h(a)g(state)h(argumen)m(t;)j(it)c(is)g (zero)g(on)g(the)g(\014rst)f(call,)k(and)c(non-zero)h(on)390 -2794 y(subsequen)m(t)33 b(calls.)52 b Fj(en)m(try)p 1320 -2794 V 41 w(func)38 b Ft(returns)33 b(a)h Fs(NULL)f Ft(p)s(oin)m(ter)g -(to)i(the)f(caller)h(when)e(there)h(are)g(no)390 2904 -y(more)d(matc)m(hes.)3350 3104 y([F)-8 b(unction])-3599 +4598 y(subsequen)m(t)33 b(calls.)52 b Fj(en)m(try)p 1320 +4598 V 41 w(func)38 b Ft(returns)33 b(a)h Fs(NULL)f Ft(p)s(oin)m(ter)g +(to)i(the)f(caller)h(when)e(there)h(are)g(no)390 4708 +y(more)d(matc)m(hes.)3350 4902 y([F)-8 b(unction])-3599 b Fh(char)54 b(*)e(rl_filename_completion)q(_fu)q(nct)q(ion)g -Fg(\()p Ff(const)34 b(c)m(har)g(*text,)e(in)m(t)565 3213 -y(state)p Fg(\))390 3323 y Ft(A)26 b(generator)h(function)e(for)g +Fg(\()p Ff(const)34 b(c)m(har)g(*text,)e(in)m(t)565 5011 +y(state)p Fg(\))390 5121 y Ft(A)26 b(generator)h(function)e(for)g (\014lename)h(completion)h(in)e(the)h(general)h(case.)40 -b Fj(text)28 b Ft(is)e(a)g(partial)h(\014le-)390 3433 +b Fj(text)28 b Ft(is)e(a)g(partial)h(\014le-)390 5230 y(name.)38 b(The)21 b(Bash)g(source)h(is)g(a)f(useful)g(reference)h (for)f(writing)h(application-sp)s(eci\014c)h(completion)390 -3542 y(functions)30 b(\(the)h(Bash)f(completion)i(functions)e(call)i -(this)e(and)g(other)g(Readline)h(functions\).)3350 3742 -y([F)-8 b(unction])-3599 b Fh(char)54 b(*)e(rl_username_completion)q -(_fu)q(nct)q(ion)g Fg(\()p Ff(const)34 b(c)m(har)g(*text,)e(in)m(t)565 -3852 y(state)p Fg(\))390 3961 y Ft(A)d(completion)g(generator)h(for)e +5340 y(functions)30 b(\(the)h(Bash)f(completion)i(functions)e(call)i +(this)e(and)g(other)g(Readline)h(functions\).)p eop end +%%Page: 56 60 +TeXDict begin 56 59 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(56)3350 +299 y([F)-8 b(unction])-3599 b Fh(char)54 b(*)e(rl_username_completion) +q(_fu)q(nct)q(ion)g Fg(\()p Ff(const)34 b(c)m(har)g(*text,)e(in)m(t)565 +408 y(state)p Fg(\))390 518 y Ft(A)d(completion)g(generator)h(for)e (usernames.)40 b Fj(text)31 b Ft(con)m(tains)f(a)f(partial)g(username)f -(preceded)g(b)m(y)390 4071 y(a)j(random)f(c)m(haracter)i(\(usually)e(`) -p Fs(~)p Ft('\).)42 b(As)31 b(with)f(all)h(completion)h(generators,)g -Fj(state)37 b Ft(is)31 b(zero)g(on)390 4180 y(the)g(\014rst)e(call)j -(and)e(non-zero)h(for)f(subsequen)m(t)f(calls.)150 4388 +(preceded)g(b)m(y)390 628 y(a)j(random)f(c)m(haracter)i(\(usually)e(`)p +Fs(~)p Ft('\).)42 b(As)31 b(with)f(all)h(completion)h(generators,)g +Fj(state)37 b Ft(is)31 b(zero)g(on)390 737 y(the)g(\014rst)e(call)j +(and)e(non-zero)h(for)f(subsequen)m(t)f(calls.)150 955 y Fi(2.6.3)63 b(Completion)41 b(V)-10 b(ariables)3371 -4592 y Ft([V)i(ariable])-3598 b Fh(rl_compentry_func_t)58 -b(*)53 b(rl_completion_entry_fun)q(cti)q(on)390 4702 +1170 y Ft([V)i(ariable])-3598 b Fh(rl_compentry_func_t)58 +b(*)53 b(rl_completion_entry_fun)q(cti)q(on)390 1279 y Ft(A)34 b(p)s(oin)m(ter)f(to)h(the)g(generator)h(function)e(for)g Fs(rl_completion_matches\(\))p Ft(.)44 b Fs(NULL)32 b -Ft(means)h(to)390 4811 y(use)d Fs(rl_filename_completion_fu)o(nct)o +Ft(means)h(to)390 1389 y(use)d Fs(rl_filename_completion_fu)o(nct)o (ion\()o(\))p Ft(,)25 b(the)30 b(default)h(\014lename)f(completer.)3371 -5011 y([V)-8 b(ariable])-3598 b Fh(rl_completion_func_t)58 +1609 y([V)-8 b(ariable])-3598 b Fh(rl_completion_func_t)58 b(*)53 b(rl_attempted_completio)q(n_f)q(unct)q(ion)390 -5121 y Ft(A)35 b(p)s(oin)m(ter)g(to)g(an)g(alternativ)m(e)i(function)d +1719 y Ft(A)35 b(p)s(oin)m(ter)g(to)g(an)g(alternativ)m(e)i(function)d (to)i(create)g(matc)m(hes.)55 b(The)34 b(function)h(is)f(called)i(with) -390 5230 y Fj(text)p Ft(,)26 b Fj(start)p Ft(,)f(and)d +390 1829 y Fj(text)p Ft(,)26 b Fj(start)p Ft(,)f(and)d Fj(end)p Ft(.)38 b Fj(start)25 b Ft(and)e Fj(end)j Ft(are)d(indices)g (in)g Fs(rl_line_buffer)c Ft(de\014ning)j(the)h(b)s(ound-)390 -5340 y(aries)j(of)h Fj(text)p Ft(,)h(whic)m(h)d(is)h(a)h(c)m(haracter)g +1938 y(aries)j(of)h Fj(text)p Ft(,)h(whic)m(h)d(is)h(a)h(c)m(haracter)g (string.)39 b(If)26 b(this)g(function)f(exists)i(and)e(returns)g -Fs(NULL)p Ft(,)h(or)g(if)p eop end -%%Page: 56 60 -TeXDict begin 56 59 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(56)390 -299 y(this)22 b(v)-5 b(ariable)22 b(is)g(set)h(to)f Fs(NULL)p -Ft(,)h(then)f Fs(rl_complete\(\))c Ft(will)k(call)h(the)f(v)-5 -b(alue)23 b(of)f Fs(rl_completion_)390 408 y(entry_function)i -Ft(to)30 b(generate)f(matc)m(hes,)i(otherwise)d(the)h(arra)m(y)g(of)f -(strings)h(returned)e(will)i(b)s(e)390 518 y(used.)37 -b(If)22 b(this)g(function)g(sets)h(the)g Fs(rl_attempted_completion)o -(_ove)o(r)16 b Ft(v)-5 b(ariable)24 b(to)f(a)f(non-zero)390 -628 y(v)-5 b(alue,)35 b(Readline)g(will)f(not)g(p)s(erform)f(its)h -(default)g(completion)h(ev)m(en)g(if)f(this)g(function)f(returns)390 -737 y(no)d(matc)m(hes.)3371 913 y([V)-8 b(ariable])-3598 -b Fh(rl_quote_func_t)57 b(*)52 b(rl_filename_quoting_)q(func)q(tio)q(n) -390 1022 y Ft(A)33 b(p)s(oin)m(ter)f(to)h(a)g(function)g(that)g(will)g -(quote)g(a)g(\014lename)f(in)h(an)f(application-sp)s(eci\014c)i -(fashion.)390 1132 y(This)k(is)i(called)g(if)f(\014lename)h(completion) -g(is)f(b)s(eing)g(attempted)i(and)d(one)i(of)f(the)g(c)m(haracters)390 -1241 y(in)33 b Fs(rl_filename_quote_charac)o(ter)o(s)27 +Fs(NULL)p Ft(,)h(or)g(if)390 2048 y(this)c(v)-5 b(ariable)22 +b(is)g(set)h(to)f Fs(NULL)p Ft(,)h(then)f Fs(rl_complete\(\))c +Ft(will)k(call)h(the)f(v)-5 b(alue)23 b(of)f Fs(rl_completion_)390 +2157 y(entry_function)i Ft(to)30 b(generate)f(matc)m(hes,)i(otherwise)d +(the)h(arra)m(y)g(of)f(strings)h(returned)e(will)i(b)s(e)390 +2267 y(used.)37 b(If)22 b(this)g(function)g(sets)h(the)g +Fs(rl_attempted_completion)o(_ove)o(r)16 b Ft(v)-5 b(ariable)24 +b(to)f(a)f(non-zero)390 2377 y(v)-5 b(alue,)35 b(Readline)g(will)f(not) +g(p)s(erform)f(its)h(default)g(completion)h(ev)m(en)g(if)f(this)g +(function)f(returns)390 2486 y(no)d(matc)m(hes.)3371 +2707 y([V)-8 b(ariable])-3598 b Fh(rl_quote_func_t)57 +b(*)52 b(rl_filename_quoting_)q(func)q(tio)q(n)390 2816 +y Ft(A)33 b(p)s(oin)m(ter)f(to)h(a)g(function)g(that)g(will)g(quote)g +(a)g(\014lename)f(in)h(an)f(application-sp)s(eci\014c)i(fashion.)390 +2926 y(This)k(is)i(called)g(if)f(\014lename)h(completion)g(is)f(b)s +(eing)g(attempted)i(and)d(one)i(of)f(the)g(c)m(haracters)390 +3036 y(in)33 b Fs(rl_filename_quote_charac)o(ter)o(s)27 b Ft(app)s(ears)33 b(in)g(a)g(completed)h(\014lename.)50 -b(The)32 b(function)390 1351 y(is)37 b(called)h(with)e -Fj(text)p Ft(,)k Fj(matc)m(h)p 1438 1351 28 4 v 41 w(t)m(yp)s(e)p -Ft(,)f(and)d Fj(quote)p 2119 1351 V 41 w(p)s(oin)m(ter)p +b(The)32 b(function)390 3145 y(is)37 b(called)h(with)e +Fj(text)p Ft(,)k Fj(matc)m(h)p 1438 3145 28 4 v 41 w(t)m(yp)s(e)p +Ft(,)f(and)d Fj(quote)p 2119 3145 V 41 w(p)s(oin)m(ter)p Ft(.)60 b(The)36 b Fj(text)k Ft(is)d(the)g(\014lename)g(to)h(b)s(e)390 -1461 y(quoted.)76 b(The)42 b Fj(matc)m(h)p 1210 1461 +3255 y(quoted.)76 b(The)42 b Fj(matc)m(h)p 1210 3255 V 41 w(t)m(yp)s(e)48 b Ft(is)42 b(either)h Fs(SINGLE_MATCH)p Ft(,)f(if)g(there)g(is)h(only)f(one)h(completion)390 -1570 y(matc)m(h,)33 b(or)e Fs(MULT_MATCH)p Ft(.)41 b(Some)31 +3364 y(matc)m(h,)33 b(or)e Fs(MULT_MATCH)p Ft(.)41 b(Some)31 b(functions)g(use)g(this)h(to)g(decide)f(whether)g(or)h(not)f(to)h -(insert)g(a)390 1680 y(closing)22 b(quote)f(c)m(haracter.)40 -b(The)20 b Fj(quote)p 1751 1680 V 41 w(p)s(oin)m(ter)27 +(insert)g(a)390 3474 y(closing)22 b(quote)f(c)m(haracter.)40 +b(The)20 b Fj(quote)p 1751 3474 V 41 w(p)s(oin)m(ter)27 b Ft(is)21 b(a)g(p)s(oin)m(ter)g(to)g(an)m(y)h(op)s(ening)e(quote)h(c)m -(haracter)390 1789 y(the)31 b(user)e(t)m(yp)s(ed.)41 +(haracter)390 3584 y(the)31 b(user)e(t)m(yp)s(ed.)41 b(Some)30 b(functions)g(c)m(ho)s(ose)h(to)g(reset)g(this)g(c)m -(haracter.)3371 1965 y([V)-8 b(ariable])-3598 b Fh(rl_dequote_func_t)57 -b(*)c(rl_filename_dequoting_)q(fun)q(cti)q(on)390 2074 +(haracter.)3371 3804 y([V)-8 b(ariable])-3598 b Fh(rl_dequote_func_t)57 +b(*)c(rl_filename_dequoting_)q(fun)q(cti)q(on)390 3914 y Ft(A)30 b(p)s(oin)m(ter)f(to)i(a)f(function)f(that)h(will)g(remo)m(v) m(e)h(application-sp)s(eci\014c)g(quoting)f(c)m(haracters)h(from)390 -2184 y(a)i(\014lename)g(b)s(efore)f(completion)h(is)g(attempted,)h(so)f +4023 y(a)i(\014lename)g(b)s(efore)f(completion)h(is)g(attempted,)h(so)f (those)g(c)m(haracters)h(do)e(not)h(in)m(terfere)g(with)390 -2293 y(matc)m(hing)39 b(the)f(text)i(against)f(names)f(in)g(the)g +4133 y(matc)m(hing)39 b(the)f(text)i(against)f(names)f(in)g(the)g (\014lesystem.)64 b(It)38 b(is)g(called)i(with)d Fj(text)p -Ft(,)42 b(the)c(text)390 2403 y(of)k(the)h(w)m(ord)f(to)g(b)s(e)g -(dequoted,)j(and)d Fj(quote)p 2014 2403 V 41 w(c)m(har)p +Ft(,)42 b(the)c(text)390 4243 y(of)k(the)h(w)m(ord)f(to)g(b)s(e)g +(dequoted,)j(and)d Fj(quote)p 2014 4243 V 41 w(c)m(har)p Ft(,)j(whic)m(h)d(is)h(the)f(quoting)h(c)m(haracter)g(that)390 -2513 y(delimits)33 b(the)f(\014lename)g(\(usually)h(`)p +4352 y(delimits)33 b(the)f(\014lename)g(\(usually)h(`)p Fs(')p Ft(')f(or)g(`)p Fs(")p Ft('\).)46 b(If)32 b Fj(quote)p -2368 2513 V 41 w(c)m(har)39 b Ft(is)32 b(zero,)i(the)e(\014lename)g(w)m -(as)h(not)390 2622 y(in)d(an)g(em)m(b)s(edded)g(string.)3371 -2798 y([V)-8 b(ariable])-3598 b Fh(rl_linebuf_func_t)57 -b(*)c(rl_char_is_quoted_p)390 2907 y Ft(A)37 b(p)s(oin)m(ter)g(to)g(a)g +2368 4352 V 41 w(c)m(har)39 b Ft(is)32 b(zero,)i(the)e(\014lename)g(w)m +(as)h(not)390 4462 y(in)d(an)g(em)m(b)s(edded)g(string.)3371 +4682 y([V)-8 b(ariable])-3598 b Fh(rl_linebuf_func_t)57 +b(*)c(rl_char_is_quoted_p)390 4792 y Ft(A)37 b(p)s(oin)m(ter)g(to)g(a)g (function)g(to)g(call)h(that)g(determines)f(whether)f(or)h(not)g(a)g -(sp)s(eci\014c)f(c)m(haracter)390 3017 y(in)e(the)h(line)f(bu\013er)g +(sp)s(eci\014c)f(c)m(haracter)390 4902 y(in)e(the)h(line)f(bu\013er)g (is)g(quoted,)i(according)g(to)f(whatev)m(er)g(quoting)g(mec)m(hanism)g -(the)f(program)390 3126 y(calling)26 b(Readline)g(uses.)38 +(the)f(program)390 5011 y(calling)26 b(Readline)g(uses.)38 b(The)24 b(function)h(is)g(called)h(with)e(t)m(w)m(o)i(argumen)m(ts:)39 -b Fj(text)p Ft(,)27 b(the)e(text)h(of)f(the)390 3236 +b Fj(text)p Ft(,)27 b(the)e(text)h(of)f(the)390 5121 y(line,)31 b(and)g Fj(index)p Ft(,)f(the)h(index)f(of)h(the)g(c)m (haracter)i(in)d(the)h(line.)42 b(It)31 b(is)g(used)f(to)h(decide)g -(whether)g(a)390 3345 y(c)m(haracter)h(found)d(in)g Fs +(whether)g(a)390 5230 y(c)m(haracter)h(found)d(in)g Fs (rl_completer_word_break_ch)o(ara)o(cter)o(s)24 b Ft(should)29 -b(b)s(e)h(used)f(to)i(break)390 3455 y(w)m(ords)f(for)g(the)h -(completer.)3371 3630 y([V)-8 b(ariable])-3598 b Fh -(rl_compignore_func_t)58 b(*)53 b(rl_ignore_some_complet)q(ion)q(s_fu)q -(nct)q(ion)390 3740 y Ft(This)37 b(function,)i(if)f(de\014ned,)g(is)g -(called)h(b)m(y)e(the)h(completer)h(when)e(real)h(\014lename)g -(completion)390 3850 y(is)c(done,)h(after)f(all)h(the)g(matc)m(hing)g -(names)e(ha)m(v)m(e)j(b)s(een)d(generated.)53 b(It)34 -b(is)g(passed)f(a)i Fs(NULL)d Ft(ter-)390 3959 y(minated)f(arra)m(y)g -(of)g(matc)m(hes.)43 b(The)31 b(\014rst)f(elemen)m(t)i(\()p -Fs(matches[0])p Ft(\))d(is)h(the)h(maximal)h(substring)390 -4069 y(common)d(to)g(all)h(matc)m(hes.)41 b(This)28 b(function)h(can)g -(re-arrange)g(the)g(list)h(of)f(matc)m(hes)g(as)g(required,)390 -4178 y(but)h(eac)m(h)h(elemen)m(t)h(deleted)f(from)f(the)h(arra)m(y)g -(m)m(ust)f(b)s(e)g(freed.)3371 4354 y([V)-8 b(ariable])-3598 -b Fh(rl_icppfunc_t)56 b(*)d(rl_directory_completio)q(n_ho)q(ok)390 -4463 y Ft(This)44 b(function,)49 b(if)d(de\014ned,)i(is)d(allo)m(w)m -(ed)i(to)f(mo)s(dify)e(the)i(directory)g(p)s(ortion)e(of)i(\014lenames) -390 4573 y(Readline)35 b(completes.)56 b(It)35 b(could)g(b)s(e)f(used)g -(to)i(expand)e(sym)m(b)s(olic)h(links)g(or)g(shell)g(v)-5 -b(ariables)35 b(in)390 4682 y(pathnames.)70 b(It)41 b(is)f(called)h +b(b)s(e)h(used)f(to)i(break)390 5340 y(w)m(ords)f(for)g(the)h +(completer.)p eop end +%%Page: 57 61 +TeXDict begin 57 60 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(57)3371 +299 y([V)-8 b(ariable])-3598 b Fh(rl_compignore_func_t)58 +b(*)53 b(rl_ignore_some_complet)q(ion)q(s_fu)q(nct)q(ion)390 +408 y Ft(This)37 b(function,)i(if)f(de\014ned,)g(is)g(called)h(b)m(y)e +(the)h(completer)h(when)e(real)h(\014lename)g(completion)390 +518 y(is)c(done,)h(after)f(all)h(the)g(matc)m(hing)g(names)e(ha)m(v)m +(e)j(b)s(een)d(generated.)53 b(It)34 b(is)g(passed)f(a)i +Fs(NULL)d Ft(ter-)390 628 y(minated)f(arra)m(y)g(of)g(matc)m(hes.)43 +b(The)31 b(\014rst)f(elemen)m(t)i(\()p Fs(matches[0])p +Ft(\))d(is)h(the)h(maximal)h(substring)390 737 y(common)d(to)g(all)h +(matc)m(hes.)41 b(This)28 b(function)h(can)g(re-arrange)g(the)g(list)h +(of)f(matc)m(hes)g(as)g(required,)390 847 y(but)h(eac)m(h)h(elemen)m(t) +h(deleted)f(from)f(the)h(arra)m(y)g(m)m(ust)f(b)s(e)g(freed.)3371 +1063 y([V)-8 b(ariable])-3598 b Fh(rl_icppfunc_t)56 b(*)d +(rl_directory_completio)q(n_ho)q(ok)390 1172 y Ft(This)44 +b(function,)49 b(if)d(de\014ned,)i(is)d(allo)m(w)m(ed)i(to)f(mo)s(dify) +e(the)i(directory)g(p)s(ortion)e(of)i(\014lenames)390 +1282 y(Readline)35 b(completes.)56 b(It)35 b(could)g(b)s(e)f(used)g(to) +i(expand)e(sym)m(b)s(olic)h(links)g(or)g(shell)g(v)-5 +b(ariables)35 b(in)390 1392 y(pathnames.)70 b(It)41 b(is)f(called)h (with)f(the)h(address)e(of)i(a)g(string)f(\(the)h(curren)m(t)f -(directory)h(name\))390 4792 y(as)d(an)f(argumen)m(t,)j(and)d(ma)m(y)i +(directory)h(name\))390 1501 y(as)d(an)f(argumen)m(t,)j(and)d(ma)m(y)i (mo)s(dify)d(that)j(string.)62 b(If)37 b(the)h(string)f(is)h(replaced)g -(with)f(a)h(new)390 4902 y(string,)j(the)d(old)h(v)-5 +(with)f(a)h(new)390 1611 y(string,)j(the)d(old)h(v)-5 b(alue)39 b(should)e(b)s(e)h(freed.)64 b(An)m(y)39 b(mo)s(di\014ed)e -(directory)i(name)f(should)g(ha)m(v)m(e)i(a)390 5011 +(directory)i(name)f(should)g(ha)m(v)m(e)i(a)390 1720 y(trailing)c(slash.)54 b(The)35 b(mo)s(di\014ed)e(v)-5 b(alue)36 b(will)f(b)s(e)f(used)g(as)i(part)e(of)h(the)h(completion,)h -(replacing)390 5121 y(the)32 b(directory)g(p)s(ortion)f(of)h(the)g +(replacing)390 1830 y(the)32 b(directory)g(p)s(ortion)f(of)h(the)g (pathname)f(the)h(user)f(t)m(yp)s(ed.)44 b(A)m(t)33 b(the)f(least,)h -(ev)m(en)g(if)e(no)h(other)390 5230 y(expansion)j(is)h(p)s(erformed,)f +(ev)m(en)g(if)e(no)h(other)390 1940 y(expansion)j(is)h(p)s(erformed,)f (this)h(function)f(should)g(remo)m(v)m(e)i(an)m(y)f(quote)g(c)m -(haracters)h(from)e(the)390 5340 y(directory)c(name,)g(b)s(ecause)f +(haracters)h(from)e(the)390 2049 y(directory)c(name,)g(b)s(ecause)f (its)h(result)f(will)h(b)s(e)e(passed)h(directly)h(to)g -Fs(opendir\(\))p Ft(.)p eop end -%%Page: 57 61 -TeXDict begin 57 60 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(57)390 -299 y(The)25 b(directory)i(completion)g(ho)s(ok)e(returns)g(an)h(in)m -(teger)h(that)f(should)f(b)s(e)g(non-zero)i(if)e(the)i(func-)390 -408 y(tion)35 b(mo)s(di\014es)e(its)i(directory)f(argumen)m(t.)53 -b(The)33 b(function)h(should)f(not)i(mo)s(dify)e(the)h(directory)390 -518 y(argumen)m(t)d(if)f(it)h(returns)e(0.)3371 720 y([V)-8 -b(ariable])-3598 b Fh(rl_icppfunc_t)56 b(*)d(rl_directory_rewrite_h)q -(ook;)390 830 y Ft(If)24 b(non-zero,)i(this)e(is)h(the)f(address)g(of)g -(a)h(function)f(to)h(call)g(when)f(completing)h(a)g(directory)g(name.) -390 939 y(This)h(function)g(tak)m(es)i(the)f(address)f(of)h(the)f -(directory)h(name)g(to)g(b)s(e)f(mo)s(di\014ed)g(as)h(an)f(argumen)m -(t.)390 1049 y(Unlik)m(e)40 b Fs(rl_directory_completion_h)o(ook)p -Ft(,)35 b(it)40 b(only)f(mo)s(di\014es)f(the)i(directory)f(name)h(used) -390 1159 y(in)35 b Fs(opendir)p Ft(,)g(not)g(what)h(is)f(displa)m(y)m -(ed)h(when)e(the)i(p)s(ossible)f(completions)h(are)g(prin)m(ted)f(or)g -(in-)390 1268 y(serted.)k(It)27 b(is)f(called)h(b)s(efore)f(rl)p -1463 1268 28 4 v 40 w(directory)p 1859 1268 V 41 w(completion)p -2333 1268 V 41 w(ho)s(ok.)39 b(A)m(t)27 b(the)g(least,)h(ev)m(en)f(if)g -(no)f(other)390 1378 y(expansion)35 b(is)h(p)s(erformed,)f(this)h +Fs(opendir\(\))p Ft(.)390 2199 y(The)25 b(directory)i(completion)g(ho)s +(ok)e(returns)g(an)h(in)m(teger)h(that)f(should)f(b)s(e)g(non-zero)i +(if)e(the)i(func-)390 2309 y(tion)35 b(mo)s(di\014es)e(its)i(directory) +f(argumen)m(t.)53 b(The)33 b(function)h(should)f(not)i(mo)s(dify)e(the) +h(directory)390 2419 y(argumen)m(t)d(if)f(it)h(returns)e(0.)3371 +2635 y([V)-8 b(ariable])-3598 b Fh(rl_icppfunc_t)56 b(*)d +(rl_directory_rewrite_h)q(ook;)390 2744 y Ft(If)24 b(non-zero,)i(this)e +(is)h(the)f(address)g(of)g(a)h(function)f(to)h(call)g(when)f +(completing)h(a)g(directory)g(name.)390 2854 y(This)h(function)g(tak)m +(es)i(the)f(address)f(of)h(the)f(directory)h(name)g(to)g(b)s(e)f(mo)s +(di\014ed)g(as)h(an)f(argumen)m(t.)390 2963 y(Unlik)m(e)40 +b Fs(rl_directory_completion_h)o(ook)p Ft(,)35 b(it)40 +b(only)f(mo)s(di\014es)f(the)i(directory)f(name)h(used)390 +3073 y(in)35 b Fs(opendir)p Ft(,)g(not)g(what)h(is)f(displa)m(y)m(ed)h +(when)e(the)i(p)s(ossible)f(completions)h(are)g(prin)m(ted)f(or)g(in-) +390 3183 y(serted.)k(It)27 b(is)f(called)h(b)s(efore)f(rl)p +1463 3183 28 4 v 40 w(directory)p 1859 3183 V 41 w(completion)p +2333 3183 V 41 w(ho)s(ok.)39 b(A)m(t)27 b(the)g(least,)h(ev)m(en)f(if)g +(no)f(other)390 3292 y(expansion)35 b(is)h(p)s(erformed,)f(this)h (function)f(should)g(remo)m(v)m(e)i(an)m(y)f(quote)g(c)m(haracters)h -(from)e(the)390 1487 y(directory)c(name,)g(b)s(ecause)f(its)h(result)f +(from)e(the)390 3402 y(directory)c(name,)g(b)s(ecause)f(its)h(result)f (will)h(b)s(e)e(passed)h(directly)h(to)g Fs(opendir\(\))p -Ft(.)390 1631 y(The)37 b(directory)i(rewrite)f(ho)s(ok)f(returns)g(an)h +Ft(.)390 3552 y(The)37 b(directory)i(rewrite)f(ho)s(ok)f(returns)g(an)h (in)m(teger)h(that)f(should)f(b)s(e)g(non-zero)i(if)e(the)i(func-)390 -1740 y(tion)c(mo)s(di\014es)e(its)i(directory)f(argumen)m(t.)53 +3662 y(tion)c(mo)s(di\014es)e(its)i(directory)f(argumen)m(t.)53 b(The)33 b(function)h(should)f(not)i(mo)s(dify)e(the)h(directory)390 -1850 y(argumen)m(t)d(if)f(it)h(returns)e(0.)3371 2052 +3771 y(argumen)m(t)d(if)f(it)h(returns)e(0.)3371 3987 y([V)-8 b(ariable])-3598 b Fh(rl_icppfunc_t)56 b(*)d -(rl_filename_stat_hook)390 2162 y Ft(If)30 b(non-zero,)h(this)f(is)g +(rl_filename_stat_hook)390 4097 y Ft(If)30 b(non-zero,)h(this)f(is)g (the)g(address)f(of)h(a)h(function)f(for)f(the)i(completer)g(to)g(call) -g(b)s(efore)f(deciding)390 2271 y(whic)m(h)g(c)m(haracter)i(to)e(app)s +g(b)s(efore)f(deciding)390 4206 y(whic)m(h)g(c)m(haracter)i(to)e(app)s (end)f(to)i(a)f(completed)h(name.)41 b(This)29 b(function)h(mo)s -(di\014es)f(its)i(\014lename)390 2381 y(name)36 b(argumen)m(t,)h(and)e +(di\014es)f(its)i(\014lename)390 4316 y(name)36 b(argumen)m(t,)h(and)e (the)h(mo)s(di\014ed)e(v)-5 b(alue)36 b(is)g(passed)f(to)h Fs(stat\(\))e Ft(to)i(determine)g(the)g(\014le's)390 -2491 y(t)m(yp)s(e)41 b(and)f(c)m(haracteristics.)73 b(This)40 +4426 y(t)m(yp)s(e)41 b(and)f(c)m(haracteristics.)73 b(This)40 b(function)g(do)s(es)g(not)h(need)f(to)h(remo)m(v)m(e)h(quote)f(c)m -(haracters)390 2600 y(from)30 b(the)g(\014lename.)390 -2744 y(The)40 b(stat)h(ho)s(ok)f(returns)f(an)h(in)m(teger)h(that)g +(haracters)390 4535 y(from)30 b(the)g(\014lename.)390 +4686 y(The)40 b(stat)h(ho)s(ok)f(returns)f(an)h(in)m(teger)h(that)g (should)e(b)s(e)h(non-zero)g(if)h(the)f(function)g(mo)s(di\014es)390 -2853 y(its)32 b(directory)f(argumen)m(t.)44 b(The)31 +4795 y(its)32 b(directory)f(argumen)m(t.)44 b(The)31 b(function)f(should)h(not)g(mo)s(dify)g(the)g(directory)h(argumen)m(t)f -(if)g(it)390 2963 y(returns)e(0.)3371 3165 y([V)-8 b(ariable])-3598 +(if)g(it)390 4905 y(returns)e(0.)3371 5121 y([V)-8 b(ariable])-3598 b Fh(rl_dequote_func_t)57 b(*)c(rl_filename_rewrite_ho)q(ok)390 -3275 y Ft(If)39 b(non-zero,)k(this)d(is)f(the)h(address)f(of)h(a)g +5230 y Ft(If)39 b(non-zero,)k(this)d(is)f(the)h(address)f(of)h(a)g (function)g(called)g(when)f(reading)h(directory)g(en)m(tries)390 -3384 y(from)f(the)h(\014lesystem)g(for)g(completion)h(and)e(comparing)i -(them)e(to)i(the)f(partial)h(w)m(ord)e(to)i(b)s(e)390 -3494 y(completed.)g(The)26 b(function)h(should)f(p)s(erform)f(an)m(y)j -(necessary)f(application)i(or)e(system-sp)s(eci\014c)390 -3603 y(con)m(v)m(ersion)35 b(on)g(the)f(\014lename,)i(suc)m(h)d(as)i -(con)m(v)m(erting)h(b)s(et)m(w)m(een)f(c)m(haracter)g(sets)g(or)f(con)m -(v)m(erting)390 3713 y(from)f(a)g(\014lesystem)h(format)g(to)g(a)f(c)m -(haracter)i(input)e(format.)50 b(The)32 b(function)h(tak)m(es)i(t)m(w)m -(o)g(argu-)390 3823 y(men)m(ts:)49 b Fj(fname)p Ft(,)36 -b(the)e(\014lename)h(to)g(b)s(e)f(con)m(v)m(erted,)j(and)d -Fj(fnlen)p Ft(,)h(its)g(length)g(in)f(b)m(ytes.)53 b(It)35 -b(m)m(ust)390 3932 y(either)24 b(return)e(its)h(\014rst)g(argumen)m(t)g -(\(if)h(no)f(con)m(v)m(ersion)h(tak)m(es)h(place\))g(or)e(the)g(con)m -(v)m(erted)i(\014lename)390 4042 y(in)j(newly-allo)s(cated)i(memory)-8 -b(.)41 b(The)27 b(con)m(v)m(erted)j(form)e(is)g(used)g(to)h(compare)f -(against)i(the)e(w)m(ord)390 4151 y(to)g(b)s(e)e(completed,)j(and,)f -(if)f(it)h(matc)m(hes,)h(is)e(added)f(to)i(the)g(list)f(of)h(matc)m -(hes.)41 b(Readline)27 b(will)h(free)390 4261 y(the)j(allo)s(cated)h -(string.)3371 4463 y([V)-8 b(ariable])-3598 b Fh(rl_compdisp_func_t)58 -b(*)52 b(rl_completion_display)q(_ma)q(tch)q(es_h)q(ook)390 -4573 y Ft(If)22 b(non-zero,)i(then)e(this)g(is)g(the)g(address)f(of)h +5340 y(from)25 b(the)h(\014lesystem)f(for)h(completion)g(and)f +(comparing)h(them)f(to)i(the)e(\014lename)h(p)s(ortion)f(of)h(the)p +eop end +%%Page: 58 62 +TeXDict begin 58 61 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(58)390 +299 y(partial)41 b(w)m(ord)e(to)i(b)s(e)e(completed)i(\(after)f(its)h +(p)s(oten)m(tial)g(mo)s(di\014cation)f(b)m(y)g Fs(rl_completion_)390 +408 y(rewrite_hook)p Ft(\).)52 b(The)35 b(function)g(should)f(p)s +(erform)g(an)m(y)i(necessary)g(application)g(or)f(system-)390 +518 y(sp)s(eci\014c)45 b(con)m(v)m(ersion)i(on)e(the)h(\014lename,)j +(suc)m(h)c(as)h(con)m(v)m(erting)h(b)s(et)m(w)m(een)f(c)m(haracter)h +(sets)f(or)390 628 y(con)m(v)m(erting)33 b(from)e(a)g(\014lesystem)h +(format)f(to)h(a)g(c)m(haracter)g(input)f(format.)43 +b(The)31 b(function)f(tak)m(es)390 737 y(t)m(w)m(o)e(argumen)m(ts:)38 +b Fj(fname)p Ft(,)28 b(the)e(\014lename)g(to)h(b)s(e)f(con)m(v)m +(erted,)j(and)c Fj(fnlen)p Ft(,)i(its)f(length)h(in)f(b)m(ytes.)40 +b(It)390 847 y(m)m(ust)33 b(either)h(return)f(its)g(\014rst)g(argumen)m +(t)h(\(if)g(no)f(con)m(v)m(ersion)i(tak)m(es)g(place\))f(or)g(the)f +(con)m(v)m(erted)390 956 y(\014lename)d(in)g(newly-allo)s(cated)j +(memory)-8 b(.)41 b(The)30 b(con)m(v)m(erted)h(form)f(is)g(used)g(to)h +(compare)g(against)390 1066 y(the)25 b(w)m(ord)f(to)i(b)s(e)e +(completed,)j(and,)f(if)e(it)h(matc)m(hes,)j(is)d(added)f(to)h(the)g +(list)g(of)g(matc)m(hes.)40 b(Readline)390 1176 y(will)31 +b(free)f(the)h(allo)s(cated)h(string.)3371 1358 y([V)-8 +b(ariable])-3598 b Fh(rl_dequote_func_t)57 b(*)c +(rl_completion_rewrite_)q(hoo)q(k)390 1468 y Ft(If)38 +b(non-zero,)i(this)e(is)g(the)h(address)e(of)h(a)h(function)e(to)i +(call)g(b)s(efore)f(comparing)g(the)h(\014lename)390 +1577 y(p)s(ortion)e(of)g(a)g(w)m(ord)g(to)g(b)s(e)g(completed)h(with)f +(directory)g(en)m(tries)h(from)e(the)i(\014lesystem.)60 +b(The)390 1687 y(function)38 b(tak)m(es)i(t)m(w)m(o)g(argumen)m(ts:)57 +b Fj(fname)p Ft(,)41 b(the)d(\014lename)h(to)g(b)s(e)f(con)m(v)m +(erted,)k(after)d(an)m(y)g Fs(rl_)390 1797 y(filename_dequoting_funct)o +(ion)27 b Ft(has)34 b(b)s(een)f(applied,)h(and)g Fj(fnlen)p +Ft(,)g(its)g(length)g(in)f(b)m(ytes.)52 b(It)390 1906 +y(m)m(ust)33 b(either)h(return)f(its)g(\014rst)g(argumen)m(t)h(\(if)g +(no)f(con)m(v)m(ersion)i(tak)m(es)g(place\))f(or)g(the)f(con)m(v)m +(erted)390 2016 y(\014lename)44 b(in)g(newly-allo)s(cated)i(memory)-8 +b(.)82 b(The)44 b(function)f(should)h(p)s(erform)e(an)m(y)j(necessary) +390 2125 y(application)29 b(or)e(system-sp)s(eci\014c)h(con)m(v)m +(ersion)h(on)f(the)f(\014lename,)i(suc)m(h)e(as)h(con)m(v)m(erting)h(b) +s(et)m(w)m(een)390 2235 y(c)m(haracter)44 b(sets)e(or)g(con)m(v)m +(erting)i(from)d(a)h(c)m(haracter)i(input)d(format)h(to)h(some)f(other) +g(format.)390 2345 y(Readline)31 b(compares)g(the)f(con)m(v)m(erted)i +(form)e(against)h(directory)g(en)m(tries,)g(after)g(their)f(p)s(oten)m +(tial)390 2454 y(mo)s(di\014cation)41 b(b)m(y)f Fs +(rl_filename_rewrite_hook)p Ft(,)d(and)j(adds)g(an)m(y)h(matc)m(hes)g +(to)h(the)f(list)g(of)390 2564 y(matc)m(hes.)h(Readline)31 +b(will)g(free)f(the)h(allo)s(cated)h(string.)3371 2746 +y([V)-8 b(ariable])-3598 b Fh(rl_compdisp_func_t)58 b(*)52 +b(rl_completion_display)q(_ma)q(tch)q(es_h)q(ook)390 +2856 y Ft(If)22 b(non-zero,)i(then)e(this)g(is)g(the)g(address)f(of)h (a)g(function)g(to)h(call)g(when)e(completing)i(a)g(w)m(ord)e(w)m(ould) -390 4682 y(normally)h(displa)m(y)h(the)f(list)h(of)f(p)s(ossible)g +390 2966 y(normally)h(displa)m(y)h(the)f(list)h(of)f(p)s(ossible)g (matc)m(hes.)39 b(This)21 b(function)h(is)g(called)i(in)e(lieu)g(of)g -(Readline)390 4792 y(displa)m(ying)37 b(the)h(list.)61 +(Readline)390 3075 y(displa)m(ying)37 b(the)h(list.)61 b(It)37 b(tak)m(es)i(three)e(argumen)m(ts:)54 b(\()p Fs(char)30 b(**)p Fj(matc)m(hes)p Ft(,)39 b Fs(int)d -Fj(n)m(um)p 3370 4792 V 40 w(matc)m(hes)p Ft(,)390 4902 -y Fs(int)26 b Fj(max)p 735 4902 V 40 w(length)p Ft(\))h(where)f -Fj(matc)m(hes)31 b Ft(is)c(the)f(arra)m(y)h(of)g(matc)m(hing)g -(strings,)h Fj(n)m(um)p 3152 4902 V 39 w(matc)m(hes)j -Ft(is)c(the)390 5011 y(n)m(um)m(b)s(er)35 b(of)i(strings)f(in)g(that)h -(arra)m(y)-8 b(,)39 b(and)d Fj(max)p 2073 5011 V 40 w(length)h +Fj(n)m(um)p 3370 3075 28 4 v 40 w(matc)m(hes)p Ft(,)390 +3185 y Fs(int)26 b Fj(max)p 735 3185 V 40 w(length)p +Ft(\))h(where)f Fj(matc)m(hes)31 b Ft(is)c(the)f(arra)m(y)h(of)g(matc)m +(hing)g(strings,)h Fj(n)m(um)p 3152 3185 V 39 w(matc)m(hes)j +Ft(is)c(the)390 3294 y(n)m(um)m(b)s(er)35 b(of)i(strings)f(in)g(that)h +(arra)m(y)-8 b(,)39 b(and)d Fj(max)p 2073 3294 V 40 w(length)h Ft(is)g(the)f(length)h(of)g(the)f(longest)i(string)390 -5121 y(in)f(that)i(arra)m(y)-8 b(.)63 b(Readline)39 b(pro)m(vides)e(a)h +3404 y(in)f(that)i(arra)m(y)-8 b(.)63 b(Readline)39 b(pro)m(vides)e(a)h (con)m(v)m(enience)i(function,)f Fs(rl_display_match_list)p -Ft(,)390 5230 y(that)33 b(tak)m(es)g(care)g(of)f(doing)g(the)g(displa)m +Ft(,)390 3513 y(that)33 b(tak)m(es)g(care)g(of)f(doing)g(the)g(displa)m (y)g(to)h(Readline's)g(output)e(stream.)46 b(Y)-8 b(ou)33 -b(ma)m(y)f(call)h(that)390 5340 y(function)d(from)g(this)g(ho)s(ok.)p -eop end -%%Page: 58 62 -TeXDict begin 58 61 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(58)3371 -299 y([V)-8 b(ariable])-3598 b Fh(const)54 b(char)f(*)g -(rl_basic_word_break_ch)q(ara)q(cter)q(s)390 408 y Ft(The)44 +b(ma)m(y)f(call)h(that)390 3623 y(function)d(from)g(this)g(ho)s(ok.) +3371 3806 y([V)-8 b(ariable])-3598 b Fh(const)54 b(char)f(*)g +(rl_basic_word_break_ch)q(ara)q(cter)q(s)390 3915 y Ft(The)44 b(basic)g(list)h(of)f(c)m(haracters)i(that)f(signal)g(a)f(break)g(b)s (et)m(w)m(een)h(w)m(ords)f(for)g(the)g(completer)390 -518 y(routine.)61 b(The)37 b(default)g(v)-5 b(alue)37 +4025 y(routine.)61 b(The)37 b(default)g(v)-5 b(alue)37 b(of)h(this)f(v)-5 b(ariable)38 b(is)f(the)g(c)m(haracters)i(whic)m(h)e -(break)g(w)m(ords)f(for)390 628 y(completion)c(in)e(Bash:)41 -b Fs(")30 b(\\t\\n\\"\\\\'`@$><=;|&{\(")p Ft(.)3371 819 +(break)g(w)m(ords)f(for)390 4134 y(completion)c(in)e(Bash:)41 +b Fs(")30 b(\\t\\n\\"\\\\'`@$><=;|&{\(")p Ft(.)3371 4317 y([V)-8 b(ariable])-3598 b Fh(const)54 b(char)f(*)g -(rl_basic_quote_charact)q(ers)390 929 y Ft(A)30 b(list)i(of)e(quote)h +(rl_basic_quote_charact)q(ers)390 4427 y Ft(A)30 b(list)i(of)e(quote)h (c)m(haracters)h(whic)m(h)e(can)h(cause)g(a)f(w)m(ord)g(break.)3371 -1121 y([V)-8 b(ariable])-3598 b Fh(const)54 b(char)f(*)g -(rl_completer_word_brea)q(k_c)q(hara)q(cte)q(rs)390 1230 +4609 y([V)-8 b(ariable])-3598 b Fh(const)54 b(char)f(*)g +(rl_completer_word_brea)q(k_c)q(hara)q(cte)q(rs)390 4719 y Ft(The)64 b(list)i(of)f(c)m(haracters)h(that)g(signal)g(a)f(break)g (b)s(et)m(w)m(een)g(w)m(ords)g(for)f Fs(rl_complete_)390 -1340 y(internal\(\))p Ft(.)38 b(The)30 b(default)g(list)h(is)g(the)f(v) +4829 y(internal\(\))p Ft(.)38 b(The)30 b(default)g(list)h(is)g(the)f(v) -5 b(alue)31 b(of)g Fs(rl_basic_word_break_cha)o(ract)o(ers)p -Ft(.)3371 1532 y([V)-8 b(ariable])-3598 b Fh(rl_cpvfunc_t)56 -b(*)d(rl_completion_word_brea)q(k_ho)q(ok)390 1641 y +Ft(.)3371 5011 y([V)-8 b(ariable])-3598 b Fh(rl_cpvfunc_t)56 +b(*)d(rl_completion_word_brea)q(k_ho)q(ok)390 5121 y Ft(If)31 b(non-zero,)i(this)e(is)h(the)f(address)g(of)g(a)h(function)g (to)g(call)h(when)d(Readline)i(is)g(deciding)f(where)390 -1751 y(to)k(separate)g(w)m(ords)f(for)g(w)m(ord)g(completion.)54 +5230 y(to)k(separate)g(w)m(ords)f(for)g(w)m(ord)g(completion.)54 b(It)34 b(should)f(return)g(a)i(c)m(haracter)h(string)e(lik)m(e)i -Fs(rl_)390 1861 y(completer_word_break_cha)o(ract)o(ers)26 +Fs(rl_)390 5340 y(completer_word_break_cha)o(ract)o(ers)26 b Ft(to)34 b(b)s(e)e(used)g(to)i(p)s(erform)e(the)h(curren)m(t)f -(completion.)390 1970 y(The)24 b(function)h(ma)m(y)g(c)m(ho)s(ose)h(to) -f(set)g Fs(rl_completer_word_break_ch)o(arac)o(ter)o(s)19 -b Ft(itself.)39 b(If)25 b(the)390 2080 y(function)30 -b(returns)f Fs(NULL)p Ft(,)h Fs(rl_completer_word_break)o(_cha)o(rac)o -(ters)24 b Ft(is)30 b(used.)3371 2271 y([V)-8 b(ariable])-3598 +(completion.)p eop end +%%Page: 59 63 +TeXDict begin 59 62 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(59)390 +299 y(The)24 b(function)h(ma)m(y)g(c)m(ho)s(ose)h(to)f(set)g +Fs(rl_completer_word_break_ch)o(arac)o(ter)o(s)19 b Ft(itself.)39 +b(If)25 b(the)390 408 y(function)30 b(returns)f Fs(NULL)p +Ft(,)h Fs(rl_completer_word_break)o(_cha)o(rac)o(ters)24 +b Ft(is)30 b(used.)3371 614 y([V)-8 b(ariable])-3598 b Fh(const)54 b(char)f(*)g(rl_completer_quote_cha)q(rac)q(ters)390 -2381 y Ft(A)34 b(list)g(of)g(c)m(haracters)h(whic)m(h)e(can)h(b)s(e)g +724 y Ft(A)34 b(list)g(of)g(c)m(haracters)h(whic)m(h)e(can)h(b)s(e)g (used)e(to)j(quote)f(a)g(substring)f(of)h(the)f(line.)51 -b(Completion)390 2491 y(o)s(ccurs)26 b(on)g(the)g(en)m(tire)i +b(Completion)390 833 y(o)s(ccurs)26 b(on)g(the)g(en)m(tire)i (substring,)e(and)f(within)h(the)g(substring)g Fs -(rl_completer_word_break)o(_)390 2600 y(characters)32 +(rl_completer_word_break)o(_)390 943 y(characters)32 b Ft(are)k(treated)g(as)f(an)m(y)h(other)f(c)m(haracter,)j(unless)d -(they)g(also)h(app)s(ear)e(within)h(this)390 2710 y(list.)3371 -2902 y([V)-8 b(ariable])-3598 b Fh(const)54 b(char)f(*)g -(rl_filename_quote_char)q(act)q(ers)390 3011 y Ft(A)34 +(they)g(also)h(app)s(ear)e(within)h(this)390 1052 y(list.)3371 +1258 y([V)-8 b(ariable])-3598 b Fh(const)54 b(char)f(*)g +(rl_filename_quote_char)q(act)q(ers)390 1367 y Ft(A)34 b(list)g(of)g(c)m(haracters)h(that)f(cause)h(a)f(\014lename)g(to)g(b)s (e)f(quoted)h(b)m(y)f(the)h(completer)h(when)e(they)390 -3121 y(app)s(ear)d(in)g(a)h(completed)g(\014lename.)41 +1477 y(app)s(ear)d(in)g(a)h(completed)g(\014lename.)41 b(The)30 b(default)g(is)h(the)f(n)m(ull)h(string.)3371 -3313 y([V)-8 b(ariable])-3598 b Fh(const)54 b(char)f(*)g -(rl_special_prefixes)390 3422 y Ft(The)27 b(list)i(of)e(c)m(haracters)j +1682 y([V)-8 b(ariable])-3598 b Fh(const)54 b(char)f(*)g +(rl_special_prefixes)390 1792 y Ft(The)27 b(list)i(of)e(c)m(haracters)j (that)e(are)g(w)m(ord)f(break)h(c)m(haracters,)i(but)d(should)f(b)s(e)h -(left)i(in)e Fj(text)k Ft(when)390 3532 y(it)25 b(is)g(passed)f(to)h +(left)i(in)e Fj(text)k Ft(when)390 1902 y(it)25 b(is)g(passed)f(to)h (the)g(completion)h(function.)38 b(Programs)25 b(can)g(use)f(this)h(to) -g(help)f(determine)h(what)390 3641 y(kind)i(of)h(completing)h(to)f(do.) +g(help)f(determine)h(what)390 2011 y(kind)i(of)h(completing)h(to)f(do.) 40 b(F)-8 b(or)29 b(instance,)g(Bash)f(sets)g(this)g(v)-5 b(ariable)28 b(to)h Fs(")p Ft($@)p Fs(")e Ft(so)h(that)g(it)h(can)390 -3751 y(complete)j(shell)e(v)-5 b(ariables)31 b(and)f(hostnames.)3371 -3943 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_query_i)q -(tems)390 4052 y Ft(Up)36 b(to)h(this)f(man)m(y)g(items)h(will)f(b)s(e) +2121 y(complete)j(shell)e(v)-5 b(ariables)31 b(and)f(hostnames.)3371 +2326 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_query_i)q +(tems)390 2436 y Ft(Up)36 b(to)h(this)f(man)m(y)g(items)h(will)f(b)s(e) g(displa)m(y)m(ed)h(in)e(resp)s(onse)h(to)h(a)f(p)s -(ossible-completions)h(call.)390 4162 y(After)44 b(that,)49 +(ossible-completions)h(call.)390 2545 y(After)44 b(that,)49 b(Readline)c(asks)f(the)h(user)e(for)h(con\014rmation)h(b)s(efore)e -(displa)m(ying)i(them.)82 b(The)390 4271 y(default)36 +(displa)m(ying)i(them.)82 b(The)390 2655 y(default)36 b(v)-5 b(alue)37 b(is)f(100.)58 b(A)36 b(negativ)m(e)i(v)-5 b(alue)37 b(indicates)g(that)f(Readline)h(should)e(nev)m(er)h(ask)g -(for)390 4381 y(con\014rmation.)3371 4573 y([V)-8 b(ariable])-3598 +(for)390 2765 y(con\014rmation.)3371 2970 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_append_)q(char)q(act)q(er)390 -4682 y Ft(When)33 b(a)h(single)f(completion)i(alternativ)m(e)h(matc)m +3080 y Ft(When)33 b(a)h(single)f(completion)i(alternativ)m(e)h(matc)m (hes)e(at)g(the)f(end)g(of)g(the)h(command)f(line,)h(this)390 -4792 y(c)m(haracter)23 b(is)e(app)s(ended)f(to)i(the)g(inserted)f +3189 y(c)m(haracter)23 b(is)e(app)s(ended)f(to)i(the)g(inserted)f (completion)i(text.)39 b(The)20 b(default)i(is)g(a)f(space)h(c)m -(haracter)390 4902 y(\(`)31 b('\).)40 b(Setting)27 b(this)g(to)g(the)g +(haracter)390 3299 y(\(`)31 b('\).)40 b(Setting)27 b(this)g(to)g(the)g (n)m(ull)f(c)m(haracter)j(\(`)p Fs(\\0)p Ft('\))e(prev)m(en)m(ts)g(an)m -(ything)g(b)s(eing)f(app)s(ended)f(auto-)390 5011 y(matically)-8 +(ything)g(b)s(eing)f(app)s(ended)f(auto-)390 3408 y(matically)-8 b(.)41 b(This)22 b(can)i(b)s(e)f(c)m(hanged)h(in)f(application-sp)s (eci\014c)h(completion)h(functions)e(to)h(pro)m(vide)390 -5121 y(the)d(\\most)i(sensible)e(w)m(ord)g(separator)h(c)m(haracter")h +3518 y(the)d(\\most)i(sensible)e(w)m(ord)g(separator)h(c)m(haracter")h (according)f(to)g(an)f(application-sp)s(eci\014c)i(com-)390 -5230 y(mand)28 b(line)i(syn)m(tax)f(sp)s(eci\014cation.)42 +3628 y(mand)28 b(line)i(syn)m(tax)f(sp)s(eci\014cation.)42 b(It)29 b(is)g(set)h(to)g(the)f(default)g(b)s(efore)g(an)m(y)g -(application-sp)s(eci\014c)390 5340 y(completion)j(function)e(is)g +(application-sp)s(eci\014c)390 3737 y(completion)j(function)e(is)g (called,)i(and)e(ma)m(y)h(only)f(b)s(e)g(c)m(hanged)h(within)f(suc)m(h) -g(a)h(function.)p eop end -%%Page: 59 63 -TeXDict begin 59 62 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(59)3371 -299 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_suppres)q -(s_ap)q(pen)q(d)390 408 y Ft(If)33 b(non-zero,)i Fj(rl)p -949 408 28 4 v 39 w(completion)p 1421 408 V 42 w(app)s(end)p -1755 408 V 38 w(c)m(haracter)42 b Ft(is)33 b(not)g(app)s(ended)f(to)i -(matc)m(hes)g(at)g(the)g(end)390 518 y(of)28 b(the)f(command)h(line,)h -(as)e(describ)s(ed)g(ab)s(o)m(v)m(e.)41 b(It)27 b(is)h(set)g(to)g(0)g -(b)s(efore)g(an)m(y)f(application-sp)s(eci\014c)390 628 +g(a)h(function.)3371 3943 y([V)-8 b(ariable])-3598 b +Fh(int)53 b(rl_completion_suppres)q(s_ap)q(pen)q(d)390 +4052 y Ft(If)33 b(non-zero,)i Fj(rl)p 949 4052 28 4 v +39 w(completion)p 1421 4052 V 42 w(app)s(end)p 1755 4052 +V 38 w(c)m(haracter)42 b Ft(is)33 b(not)g(app)s(ended)f(to)i(matc)m +(hes)g(at)g(the)g(end)390 4162 y(of)28 b(the)f(command)h(line,)h(as)e +(describ)s(ed)g(ab)s(o)m(v)m(e.)41 b(It)27 b(is)h(set)g(to)g(0)g(b)s +(efore)g(an)m(y)f(application-sp)s(eci\014c)390 4271 y(completion)32 b(function)e(is)g(called,)i(and)e(ma)m(y)h(only)f(b)s (e)g(c)m(hanged)h(within)f(suc)m(h)g(a)h(function.)3371 -847 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_quote_c)q -(hara)q(cte)q(r)390 956 y Ft(When)36 b(Readline)h(is)f(completing)h +4477 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_quote_c)q +(hara)q(cte)q(r)390 4587 y Ft(When)36 b(Readline)h(is)f(completing)h (quoted)g(text,)h(as)f(delimited)g(b)m(y)f(one)g(of)g(the)h(c)m -(haracters)g(in)390 1066 y Fj(rl)p 457 1066 V 40 w(completer)p -885 1066 V 41 w(quote)p 1145 1066 V 41 w(c)m(haracters)p +(haracters)g(in)390 4696 y Fj(rl)p 457 4696 V 40 w(completer)p +885 4696 V 41 w(quote)p 1145 4696 V 41 w(c)m(haracters)p Ft(,)43 b(it)c(sets)g(this)g(v)-5 b(ariable)40 b(to)g(the)f(quoting)g -(c)m(haracter)i(found.)390 1176 y(This)30 b(is)g(set)h(b)s(efore)f(an)m +(c)m(haracter)i(found.)390 4806 y(This)30 b(is)g(set)h(b)s(efore)f(an)m (y)h(application-sp)s(eci\014c)g(completion)h(function)e(is)h(called.) -3371 1395 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_suppres) -q(s_qu)q(ote)390 1504 y Ft(If)32 b(non-zero,)h(Readline)g(do)s(es)f +3371 5011 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_suppres) +q(s_qu)q(ote)390 5121 y Ft(If)32 b(non-zero,)h(Readline)g(do)s(es)f (not)h(app)s(end)d(a)j(matc)m(hing)g(quote)g(c)m(haracter)h(when)d(p)s -(erforming)390 1614 y(completion)25 b(on)e(a)h(quoted)g(string.)38 +(erforming)390 5230 y(completion)25 b(on)e(a)h(quoted)g(string.)38 b(It)24 b(is)f(set)h(to)h(0)f(b)s(efore)f(an)m(y)h(application-sp)s -(eci\014c)h(completion)390 1724 y(function)30 b(is)g(called,)i(and)e +(eci\014c)h(completion)390 5340 y(function)30 b(is)g(called,)i(and)e (ma)m(y)h(only)g(b)s(e)e(c)m(hanged)i(within)f(suc)m(h)g(a)h(function.) -3371 1943 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_found_q) -q(uote)390 2052 y Ft(When)31 b(Readline)i(is)e(completing)i(quoted)f +p eop end +%%Page: 60 64 +TeXDict begin 60 63 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(60)3371 +299 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_found_q)q +(uote)390 408 y Ft(When)31 b(Readline)i(is)e(completing)i(quoted)f (text,)h(it)f(sets)g(this)g(v)-5 b(ariable)32 b(to)h(a)f(non-zero)g(v) --5 b(alue)32 b(if)390 2162 y(the)21 b(w)m(ord)g(b)s(eing)g(completed)h +-5 b(alue)32 b(if)390 518 y(the)21 b(w)m(ord)g(b)s(eing)g(completed)h (con)m(tains)g(or)f(is)g(delimited)h(b)m(y)f(an)m(y)g(quoting)h(c)m -(haracters,)i(including)390 2271 y(bac)m(kslashes.)42 +(haracters,)i(including)390 628 y(bac)m(kslashes.)42 b(This)29 b(is)i(set)g(b)s(efore)f(an)m(y)g(application-sp)s(eci\014c)i -(completion)g(function)e(is)g(called.)3371 2491 y([V)-8 +(completion)g(function)e(is)g(called.)3371 800 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_mark_sy)q(mlin)q(k_d)q -(irs)390 2600 y Ft(If)31 b(non-zero,)i(a)f(slash)g(will)g(b)s(e)f(app)s +(irs)390 909 y Ft(If)31 b(non-zero,)i(a)f(slash)g(will)g(b)s(e)f(app)s (ended)f(to)j(completed)g(\014lenames)e(that)i(are)f(sym)m(b)s(olic)g -(links)390 2710 y(to)25 b(directory)g(names,)g(sub)5 +(links)390 1019 y(to)25 b(directory)g(names,)g(sub)5 b(ject)24 b(to)h(the)f(v)-5 b(alue)25 b(of)f(the)h(user-settable)g -Fj(mark-directories)k Ft(v)-5 b(ariable.)390 2819 y(This)27 +Fj(mark-directories)k Ft(v)-5 b(ariable.)390 1129 y(This)27 b(v)-5 b(ariable)28 b(exists)g(so)f(that)h(application-sp)s(eci\014c)h (completion)g(functions)e(can)g(o)m(v)m(erride)i(the)390 -2929 y(user's)42 b(global)h(preference)g(\(set)g(via)g(the)f +1238 y(user's)42 b(global)h(preference)g(\(set)g(via)g(the)f Fj(mark-symlink)m(ed-directories)48 b Ft(Readline)43 -b(v)-5 b(ariable\))390 3039 y(if)38 b(appropriate.)62 +b(v)-5 b(ariable\))390 1348 y(if)38 b(appropriate.)62 b(This)37 b(v)-5 b(ariable)38 b(is)g(set)g(to)g(the)g(user's)f -(preference)g(b)s(efore)g(an)m(y)h(application-)390 3148 +(preference)g(b)s(efore)g(an)m(y)h(application-)390 1457 y(sp)s(eci\014c)31 b(completion)i(function)f(is)f(called,)j(so)e (unless)f(that)h(function)f(mo)s(di\014es)g(the)h(v)-5 -b(alue,)33 b(the)390 3258 y(user's)d(preferences)g(are)h(honored.)3371 -3477 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_ignore_completion_)q -(dupl)q(ica)q(tes)390 3587 y Ft(If)30 b(non-zero,)h(then)f(duplicates)h +b(alue,)33 b(the)390 1567 y(user's)d(preferences)g(are)h(honored.)3371 +1739 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_ignore_completion_)q +(dupl)q(ica)q(tes)390 1849 y Ft(If)30 b(non-zero,)h(then)f(duplicates)h (in)f(the)h(matc)m(hes)g(are)g(remo)m(v)m(ed.)42 b(The)29 -b(default)i(is)f(1.)3371 3806 y([V)-8 b(ariable])-3598 +b(default)i(is)f(1.)3371 2021 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_filename_completio)q(n_de)q(sir)q(ed)390 -3915 y Ft(Non-zero)33 b(means)f(that)g(the)g(results)f(of)h(the)g(matc) +2131 y Ft(Non-zero)33 b(means)f(that)g(the)g(results)f(of)h(the)g(matc) m(hes)h(are)f(to)h(b)s(e)e(treated)i(as)f(\014lenames.)45 -b(This)390 4025 y(is)40 b Fk(always)49 b Ft(zero)41 b(when)e +b(This)390 2240 y(is)40 b Fk(always)49 b Ft(zero)41 b(when)e (completion)i(is)f(attempted,)j(and)d(can)g(only)g(b)s(e)f(c)m(hanged)i -(within)e(an)390 4134 y(application-sp)s(eci\014c)i(completion)g +(within)e(an)390 2350 y(application-sp)s(eci\014c)i(completion)g (function.)67 b(If)39 b(it)h(is)f(set)h(to)h(a)e(non-zero)h(v)-5 -b(alue)40 b(b)m(y)f(suc)m(h)h(a)390 4244 y(function,)24 +b(alue)40 b(b)m(y)f(suc)m(h)h(a)390 2459 y(function,)24 b(directory)f(names)f(ha)m(v)m(e)h(a)g(slash)f(app)s(ended)e(and)i -(Readline)h(attempts)g(to)g(quote)g(com-)390 4354 y(pleted)35 +(Readline)h(attempts)g(to)g(quote)g(com-)390 2569 y(pleted)35 b(\014lenames)g(if)g(they)h(con)m(tain)g(an)m(y)f(c)m(haracters)i(in)e -Fs(rl_filename_quote_chara)o(cter)o(s)390 4463 y Ft(and)30 +Fs(rl_filename_quote_chara)o(cter)o(s)390 2679 y Ft(and)30 b Fs(rl_filename_quoting_des)o(ired)24 b Ft(is)30 b(set)h(to)g(a)g -(non-zero)g(v)-5 b(alue.)3371 4682 y([V)d(ariable])-3598 -b Fh(int)53 b(rl_filename_quoting_d)q(esir)q(ed)390 4792 +(non-zero)g(v)-5 b(alue.)3371 2851 y([V)d(ariable])-3598 +b Fh(int)53 b(rl_filename_quoting_d)q(esir)q(ed)390 2960 y Ft(Non-zero)29 b(means)f(that)h(the)f(results)g(of)g(the)g(matc)m (hes)i(are)e(to)h(b)s(e)e(quoted)h(using)g(double)f(quotes)390 -4902 y(\(or)43 b(an)f(application-sp)s(eci\014c)i(quoting)f(mec)m +3070 y(\(or)43 b(an)f(application-sp)s(eci\014c)i(quoting)f(mec)m (hanism\))g(if)f(the)h(completed)g(\014lename)g(con)m(tains)390 -5011 y(an)m(y)28 b(c)m(haracters)h(in)e Fs(rl_filename_quote_chars)p +3180 y(an)m(y)28 b(c)m(haracters)h(in)e Fs(rl_filename_quote_chars)p Ft(.)34 b(This)27 b(is)g Fk(always)37 b Ft(non-zero)28 -b(when)f(comple-)390 5121 y(tion)h(is)g(attempted,)h(and)e(can)h(only)g +b(when)f(comple-)390 3289 y(tion)h(is)g(attempted,)h(and)e(can)h(only)g (b)s(e)f(c)m(hanged)h(within)f(an)h(application-sp)s(eci\014c)h -(completion)390 5230 y(function.)37 b(The)21 b(quoting)g(is)g +(completion)390 3399 y(function.)37 b(The)21 b(quoting)g(is)g (e\013ected)i(via)e(a)h(call)g(to)g(the)f(function)g(p)s(oin)m(ted)g -(to)g(b)m(y)g Fs(rl_filename_)390 5340 y(quoting_function)p -Ft(.)p eop end -%%Page: 60 64 -TeXDict begin 60 63 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(60)3371 -299 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_attempted_completi)q -(on_o)q(ver)390 408 y Ft(If)93 b(an)h(application-sp)s(eci\014c)i -(completion)f(function)f(assigned)g(to)h Fs(rl_attempted_)390 -518 y(completion_function)48 b Ft(sets)53 b(this)g(v)-5 -b(ariable)54 b(to)g(a)f(non-zero)h(v)-5 b(alue,)60 b(Readline)53 -b(will)h(not)390 628 y(p)s(erform)28 b(its)i(default)g(\014lename)g -(completion)h(ev)m(en)f(if)g(the)f(application's)i(completion)g -(function)390 737 y(returns)e(no)h(matc)m(hes.)42 b(It)31 -b(should)e(b)s(e)h(set)h(only)f(b)m(y)h(an)f(application's)i -(completion)f(function.)3371 922 y([V)-8 b(ariable])-3598 -b Fh(int)53 b(rl_sort_completion_ma)q(tche)q(s)390 1031 -y Ft(If)29 b(an)h(application)h(sets)f(this)g(v)-5 b(ariable)31 -b(to)f(0,)h(Readline)f(will)g(not)g(sort)g(the)g(list)h(of)f -(completions)390 1141 y(\(whic)m(h)25 b(implies)f(that)i(it)f(cannot)g -(remo)m(v)m(e)h(an)m(y)f(duplicate)g(completions\).)40 -b(The)24 b(default)h(v)-5 b(alue)25 b(is)390 1250 y(1,)32 -b(whic)m(h)f(means)g(that)h(Readline)g(will)f(sort)h(the)f(completions) -h(and,)f(dep)s(ending)f(on)h(the)g(v)-5 b(alue)390 1360 -y(of)31 b Fs(rl_ignore_completion_du)o(pli)o(cate)o(s)p +(to)g(b)m(y)g Fs(rl_filename_)390 3508 y(quoting_function)p +Ft(.)3371 3680 y([V)-8 b(ariable])-3598 b Fh(int)53 b +(rl_full_quoting_desir)q(ed)390 3790 y Ft(Non-zero)45 +b(means)e(that)h(Readline)h(should)d(apply)h(\014lename-st)m(yle)j +(quoting,)h(including)d(an)m(y)390 3900 y(application-sp)s(eci\014ed)d +(quoting)g(mec)m(hanism,)i(to)e(all)g(completion)g(matc)m(hes)h(ev)m +(en)f(if)f(w)m(e)h(are)390 4009 y(not)35 b(otherwise)h(treating)h(the)e +(matc)m(hes)i(as)e(\014lenames.)55 b(This)35 b(is)g Fk(always)45 +b Ft(zero)36 b(when)e(comple-)390 4119 y(tion)28 b(is)g(attempted,)h +(and)e(can)h(only)g(b)s(e)f(c)m(hanged)h(within)f(an)h(application-sp)s +(eci\014c)h(completion)390 4228 y(function.)37 b(The)21 +b(quoting)g(is)g(e\013ected)i(via)e(a)h(call)g(to)g(the)f(function)g(p) +s(oin)m(ted)g(to)g(b)m(y)g Fs(rl_filename_)390 4338 y(quoting_function) +p Ft(.)3371 4510 y([V)-8 b(ariable])-3598 b Fh(int)53 +b(rl_attempted_completi)q(on_o)q(ver)390 4620 y Ft(If)93 +b(an)h(application-sp)s(eci\014c)i(completion)f(function)f(assigned)g +(to)h Fs(rl_attempted_)390 4729 y(completion_function)48 +b Ft(sets)53 b(this)g(v)-5 b(ariable)54 b(to)g(a)f(non-zero)h(v)-5 +b(alue,)60 b(Readline)53 b(will)h(not)390 4839 y(p)s(erform)28 +b(its)i(default)g(\014lename)g(completion)h(ev)m(en)f(if)g(the)f +(application's)i(completion)g(function)390 4949 y(returns)e(no)h(matc)m +(hes.)42 b(It)31 b(should)e(b)s(e)h(set)h(only)f(b)m(y)h(an)f +(application's)i(completion)f(function.)3371 5121 y([V)-8 +b(ariable])-3598 b Fh(int)53 b(rl_sort_completion_ma)q(tche)q(s)390 +5230 y Ft(If)29 b(an)h(application)h(sets)f(this)g(v)-5 +b(ariable)31 b(to)f(0,)h(Readline)f(will)g(not)g(sort)g(the)g(list)h +(of)f(completions)390 5340 y(\(whic)m(h)25 b(implies)f(that)i(it)f +(cannot)g(remo)m(v)m(e)h(an)m(y)f(duplicate)g(completions\).)40 +b(The)24 b(default)h(v)-5 b(alue)25 b(is)p eop end +%%Page: 61 65 +TeXDict begin 61 64 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(61)390 +299 y(1,)32 b(whic)m(h)f(means)g(that)h(Readline)g(will)f(sort)h(the)f +(completions)h(and,)f(dep)s(ending)f(on)h(the)g(v)-5 +b(alue)390 408 y(of)31 b Fs(rl_ignore_completion_du)o(pli)o(cate)o(s)p Ft(,)25 b(will)30 b(attempt)i(to)f(remo)m(v)m(e)h(duplicate)f(matc)m -(hes.)3371 1544 y([V)-8 b(ariable])-3598 b Fh(int)53 -b(rl_completion_type)390 1654 y Ft(Set)35 b(to)h(a)f(c)m(haracter)i +(hes.)3371 593 y([V)-8 b(ariable])-3598 b Fh(int)53 b +(rl_completion_type)390 702 y Ft(Set)35 b(to)h(a)f(c)m(haracter)i (describing)e(the)g(t)m(yp)s(e)g(of)g(completion)i(Readline)e(is)g -(curren)m(tly)h(attempt-)390 1763 y(ing;)f(see)f(the)g(description)f -(of)g Fs(rl_complete_internal\(\))28 b Ft(\(see)34 b(Section)g(2.6.2)h -([Completion)390 1873 y(F)-8 b(unctions],)39 b(page)f(54\))f(for)g(the) -g(list)g(of)g(c)m(haracters.)61 b(This)36 b(is)g(set)i(to)f(the)g -(appropriate)f(v)-5 b(alue)390 1983 y(b)s(efore)31 b(an)m(y)h +(curren)m(tly)h(attempt-)390 812 y(ing;)f(see)f(the)g(description)f(of) +g Fs(rl_complete_internal\(\))28 b Ft(\(see)34 b(Section)g(2.6.2)h +([Completion)390 922 y(F)-8 b(unctions],)39 b(page)f(55\))f(for)g(the)g +(list)g(of)g(c)m(haracters.)61 b(This)36 b(is)g(set)i(to)f(the)g +(appropriate)f(v)-5 b(alue)390 1031 y(b)s(efore)31 b(an)m(y)h (application-sp)s(eci\014c)h(completion)g(function)f(is)f(called,)j -(allo)m(wing)f(suc)m(h)e(functions)390 2092 y(to)g(presen)m(t)g(the)f +(allo)m(wing)f(suc)m(h)e(functions)390 1141 y(to)g(presen)m(t)g(the)f (same)h(in)m(terface)h(as)e Fs(rl_complete\(\))p Ft(.)3371 -2276 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_invokin)q -(g_ke)q(y)390 2386 y Ft(Set)41 b(to)g(the)g(\014nal)g(c)m(haracter)h +1325 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_completion_invokin)q +(g_ke)q(y)390 1435 y Ft(Set)41 b(to)g(the)g(\014nal)g(c)m(haracter)h (in)e(the)h(k)m(ey)g(sequence)h(that)f(in)m(v)m(ok)m(ed)h(one)f(of)g -(the)g(completion)390 2496 y(functions)c(that)h(call)h +(the)g(completion)390 1544 y(functions)c(that)h(call)h Fs(rl_complete_internal\(\))p Ft(.)56 b(This)37 b(is)g(set)h(to)g(the)g -(appropriate)f(v)-5 b(alue)390 2605 y(b)s(efore)30 b(an)m(y)h +(appropriate)f(v)-5 b(alue)390 1654 y(b)s(efore)30 b(an)m(y)h (application-sp)s(eci\014c)h(completion)f(function)f(is)h(called.)3371 -2790 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_inhibit_completion)390 -2899 y Ft(If)28 b(this)g(v)-5 b(ariable)29 b(is)f(non-zero,)i +1838 y([V)-8 b(ariable])-3598 b Fh(int)53 b(rl_inhibit_completion)390 +1948 y Ft(If)28 b(this)g(v)-5 b(ariable)29 b(is)f(non-zero,)i (completion)f(is)f(inhibited.)40 b(The)28 b(completion)h(c)m(haracter)h -(will)f(b)s(e)390 3009 y(inserted)h(as)h(an)m(y)g(other)f(b)s(ound)e -(to)k Fs(self-insert)p Ft(.)150 3208 y Fi(2.6.4)63 b(A)40 -b(Short)i(Completion)g(Example)150 3355 y Ft(Here)30 +(will)f(b)s(e)390 2057 y(inserted)h(as)h(an)m(y)g(other)f(b)s(ound)e +(to)k Fs(self-insert)p Ft(.)150 2257 y Fi(2.6.4)63 b(A)40 +b(Short)i(Completion)g(Example)150 2403 y Ft(Here)30 b(is)f(a)g(small)h(application)g(demonstrating)f(the)h(use)e(of)i(the)f (GNU)h(Readline)f(library)-8 b(.)40 b(It)30 b(is)f(called)150 -3465 y Fs(fileman)p Ft(,)40 b(and)f(the)h(source)g(co)s(de)g(resides)f +2513 y Fs(fileman)p Ft(,)40 b(and)f(the)h(source)g(co)s(de)g(resides)f (in)g Fs(examples/fileman.c)p Ft(.)64 b(This)39 b(sample)h(application) -150 3574 y(pro)m(vides)26 b(completion)i(of)e(command)g(names,)h(line)f +150 2623 y(pro)m(vides)26 b(completion)i(of)e(command)g(names,)h(line)f (editing)h(features,)h(and)d(access)j(to)f(the)f(history)g(list.)p eop end -%%Page: 61 65 -TeXDict begin 61 64 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(61)390 +%%Page: 62 66 +TeXDict begin 62 65 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(62)390 299 y Fe(/*)40 b(fileman.c)h(--)f(A)f(tiny)h(application)i(which)e (demonstrates)i(how)e(to)g(use)g(the)508 386 y(GNU)g(Readline)h (library.)80 b(This)40 b(application)i(interactively)g(allows)f(users) @@ -11073,9 +11166,9 @@ y(int)e(com_cd)g(PARAMS\(\(char)i(*\)\);)390 4570 y(int)e(com_quit)h (call)i(to)e(do)h(the)g(job.)g(*/)468 5268 y(char)h(*doc;)f(/*)g (Documentation)i(for)e(this)g(function.)80 b(*/)p eop end -%%Page: 62 66 -TeXDict begin 62 65 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(62)390 +%%Page: 63 67 +TeXDict begin 63 66 bop 150 -116 a Ft(Chapter)30 b(2:)41 +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(63)390 299 y Fe(})39 b(COMMAND;)390 473 y(COMMAND)i(commands[])g(=)f({)468 560 y({)g("cd",)g(com_cd,)h("Change)g(to)f(directory)h(DIR")f(},)468 648 y({)g("delete",)h(com_delete,)h("Delete)f(FILE")f(},)468 @@ -11091,235 +11184,231 @@ f(statistics)h(on)f(FILE")g(},)468 1432 y({)g("view",)h(com_view,)g ("View)f(the)g(contents)h(of)f(FILE")g(},)468 1519 y({)g(\(char)g (*\)NULL,)h(\(rl_icpfunc_t)h(*\)NULL,)f(\(char)f(*\)NULL)h(})390 1606 y(};)390 1781 y(/*)f(Forward)g(declarations.)j(*/)390 -1868 y(char)d(*stripwhite)i(\(\);)390 1955 y(COMMAND)f(*find_command)h -(\(\);)390 2130 y(/*)e(The)g(name)g(of)f(this)i(program,)g(as)e(taken)i -(from)f(argv[0].)h(*/)390 2217 y(char)f(*progname;)390 -2391 y(/*)g(When)g(non-zero,)h(this)f(global)h(means)f(the)g(user)g(is) -g(done)g(using)g(this)h(program.)g(*/)390 2478 y(int)f(done;)390 -2653 y(char)g(*)390 2740 y(dupstr)h(\(s\))586 2827 y(char)f(*s;)390 -2914 y({)468 3001 y(char)h(*r;)468 3176 y(r)f(=)f(xmalloc)i(\(strlen)g -(\(s\))f(+)f(1\);)468 3263 y(strcpy)i(\(r,)f(s\);)468 -3350 y(return)h(\(r\);)390 3437 y(})390 3611 y(main)f(\(argc,)h(argv\)) -586 3699 y(int)f(argc;)586 3786 y(char)g(**argv;)390 -3873 y({)468 3960 y(char)h(*line,)f(*s;)468 4134 y(setlocale)i -(\(LC_ALL,)f(""\);)468 4309 y(progname)g(=)f(argv[0];)468 -4483 y(initialize_readline)k(\(\);)c(/*)g(Bind)g(our)g(completer.)h(*/) -468 4658 y(/*)f(Loop)g(reading)h(and)f(executing)h(lines)g(until)f(the) -g(user)g(quits.)h(*/)468 4745 y(for)f(\()g(;)f(done)h(==)g(0;)g(\))547 -4832 y({)625 4919 y(line)g(=)g(readline)h(\("FileMan:)h("\);)625 -5093 y(if)e(\(!line\))704 5181 y(break;)p eop end -%%Page: 63 67 -TeXDict begin 63 66 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(63)625 -299 y Fe(/*)40 b(Remove)h(leading)f(and)g(trailing)h(whitespace)h(from) -e(the)g(line.)743 386 y(Then,)g(if)g(there)g(is)g(anything)h(left,)g -(add)e(it)h(to)g(the)g(history)h(list)743 473 y(and)f(execute)h(it.)f -(*/)625 560 y(s)g(=)f(stripwhite)j(\(line\);)625 735 -y(if)e(\(*s\))704 822 y({)782 909 y(add_history)i(\(s\);)782 -996 y(execute_line)g(\(s\);)704 1083 y(})625 1258 y(free)e(\(line\);) -547 1345 y(})468 1432 y(exit)h(\(0\);)390 1519 y(})390 -1694 y(/*)f(Execute)g(a)g(command)h(line.)f(*/)390 1781 -y(int)390 1868 y(execute_line)i(\(line\))586 1955 y(char)e(*line;)390 -2042 y({)468 2130 y(register)h(int)f(i;)468 2217 y(COMMAND)h(*command;) -468 2304 y(char)g(*word;)468 2478 y(/*)f(Isolate)h(the)f(command)h -(word.)f(*/)468 2565 y(i)g(=)f(0;)468 2653 y(while)i(\(line[i])g(&&)f -(whitespace)h(\(line[i]\)\))547 2740 y(i++;)468 2827 -y(word)g(=)e(line)h(+)g(i;)468 3001 y(while)h(\(line[i])g(&&)f -(!whitespace)h(\(line[i]\)\))547 3088 y(i++;)468 3263 -y(if)f(\(line[i]\))547 3350 y(line[i++])h(=)f('\\0';)468 -3524 y(command)h(=)f(find_command)i(\(word\);)468 3699 -y(if)e(\(!command\))547 3786 y({)625 3873 y(fprintf)h(\(stderr,)g -("\045s:)f(No)g(such)g(command)h(for)f(FileMan.\\n",)i(word\);)625 -3960 y(return)f(\(-1\);)547 4047 y(})468 4222 y(/*)f(Get)g(argument)h -(to)f(command,)h(if)f(any.)g(*/)468 4309 y(while)h(\(whitespace)h -(\(line[i]\)\))547 4396 y(i++;)468 4570 y(word)f(=)e(line)h(+)g(i;)468 -4745 y(/*)g(Call)g(the)g(function.)h(*/)468 4832 y(return)g -(\(\(*\(command->func\)\))j(\(word\)\);)390 4919 y(})390 -5093 y(/*)c(Look)g(up)f(NAME)i(as)e(the)h(name)g(of)g(a)g(command,)h -(and)e(return)i(a)f(pointer)g(to)g(that)508 5181 y(command.)80 -b(Return)41 b(a)e(NULL)h(pointer)h(if)f(NAME)g(isn't)g(a)g(command)g -(name.)h(*/)390 5268 y(COMMAND)g(*)p eop end +1868 y(char)d(*stripwhite)i(\(char)e(*\);)390 1955 y(COMMAND)h +(*find_command)h(\(char)e(*\);)390 2130 y(/*)g(The)g(name)g(of)f(this)i +(program,)g(as)e(taken)i(from)f(argv[0].)h(*/)390 2217 +y(char)f(*progname;)390 2391 y(/*)g(When)g(non-zero,)h(this)f(global)h +(means)f(the)g(user)g(is)g(done)g(using)g(this)h(program.)g(*/)390 +2478 y(int)f(done;)390 2653 y(char)g(*)390 2740 y(dupstr)h(\(char)f +(*s\))390 2827 y({)468 2914 y(char)h(*r;)468 3088 y(r)f(=)f(xmalloc)i +(\(strlen)g(\(s\))f(+)f(1\);)468 3176 y(strcpy)i(\(r,)f(s\);)468 +3263 y(return)h(\(r\);)390 3350 y(})390 3524 y(int)390 +3611 y(main)f(\(int)g(argc,)h(char)f(**argv\))390 3699 +y({)468 3786 y(char)h(*line,)f(*s;)468 3960 y(setlocale)i(\(LC_ALL,)f +(""\);)468 4134 y(progname)g(=)f(argv[0];)468 4309 y +(initialize_readline)k(\(\);)c(/*)g(Bind)g(our)g(completer.)h(*/)468 +4483 y(/*)f(Loop)g(reading)h(and)f(executing)h(lines)g(until)f(the)g +(user)g(quits.)h(*/)468 4570 y(for)f(\()g(;)f(done)h(==)g(0;)g(\))547 +4658 y({)625 4745 y(line)g(=)g(readline)h(\("FileMan:)h("\);)625 +4919 y(if)e(\(!line\))704 5006 y(break;)625 5181 y(/*)g(Remove)h +(leading)f(and)g(trailing)h(whitespace)h(from)e(the)g(line.)743 +5268 y(Then,)g(if)g(there)g(is)g(anything)h(left,)g(add)e(it)h(to)g +(the)g(history)h(list)p eop end %%Page: 64 68 TeXDict begin 64 67 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(64)390 -299 y Fe(find_command)42 b(\(name\))586 386 y(char)e(*name;)390 -473 y({)468 560 y(register)h(int)f(i;)468 735 y(for)g(\(i)g(=)f(0;)h -(commands[i].name;)j(i++\))547 822 y(if)d(\(strcmp)g(\(name,)h -(commands[i].name\))i(==)d(0\))625 909 y(return)h(\(&commands[i]\);)468 -1083 y(return)g(\(\(COMMAND)g(*\)NULL\);)390 1171 y(})390 -1345 y(/*)f(Strip)g(whitespace)i(from)e(the)g(start)g(and)g(end)g(of)f -(STRING.)81 b(Return)40 b(a)g(pointer)508 1432 y(into)g(STRING.)h(*/) -390 1519 y(char)f(*)390 1606 y(stripwhite)h(\(string\))586 -1694 y(char)f(*string;)390 1781 y({)468 1868 y(register)h(char)g(*s,)f -(*t;)468 2042 y(for)g(\(s)g(=)f(string;)i(whitespace)h(\(*s\);)e(s++\)) -547 2130 y(;)468 2304 y(if)g(\(*s)g(==)g(0\))547 2391 -y(return)g(\(s\);)468 2565 y(t)g(=)f(s)h(+)f(strlen)i(\(s\))f(-)f(1;) -468 2653 y(while)i(\(t)e(>)h(s)f(&&)h(whitespace)i(\(*t\)\))547 -2740 y(t--;)468 2827 y(*++t)f(=)e('\\0';)468 3001 y(return)i(s;)390 -3088 y(})390 3263 y(/*)f(******************************)q(*****)q(****) -q(*****)q(****)q(****)q(*****)q(****)q(***)45 b(*/)390 -3350 y(/*)2589 b(*/)390 3437 y(/*)707 b(Interface)41 -b(to)f(Readline)h(Completion)629 b(*/)390 3524 y(/*)2589 -b(*/)390 3611 y(/*)40 b(******************************)q(*****)q(****)q -(*****)q(****)q(****)q(*****)q(****)q(***)45 b(*/)390 -3786 y(char)40 b(*command_generator)j(PARAMS\(\(const)g(char)d(*,)f -(int\)\);)390 3873 y(char)h(**fileman_completion)k(PARAMS\(\(const)e -(char)e(*,)g(int,)g(int\)\);)390 4047 y(/*)g(Tell)g(the)g(GNU)g -(Readline)h(library)g(how)e(to)h(complete.)81 b(We)39 -b(want)h(to)g(try)g(to)g(complete)508 4134 y(on)f(command)i(names)g(if) -e(this)h(is)g(the)g(first)g(word)g(in)g(the)g(line,)g(or)g(on)g -(filenames)508 4222 y(if)f(not.)h(*/)390 4309 y(initialize_readline)k -(\(\))390 4396 y({)468 4483 y(/*)c(Allow)g(conditional)i(parsing)f(of)f -(the)g(~/.inputrc)h(file.)g(*/)468 4570 y(rl_readline_name)i(=)d -("FileMan";)468 4745 y(/*)g(Tell)g(the)g(completer)h(that)g(we)e(want)h -(a)g(crack)g(first.)h(*/)468 4832 y(rl_attempted_completion_fun)q(ctio) -q(n)k(=)39 b(fileman_completion;)390 4919 y(})390 5093 -y(/*)h(Attempt)g(to)g(complete)h(on)f(the)g(contents)h(of)f(TEXT.)79 -b(START)41 b(and)e(END)h(bound)h(the)508 5181 y(region)f(of)g -(rl_line_buffer)i(that)f(contains)g(the)e(word)i(to)e(complete.)81 -b(TEXT)40 b(is)508 5268 y(the)g(word)g(to)f(complete.)81 -b(We)40 b(can)g(use)f(the)h(entire)h(contents)g(of)f(rl_line_buffer)p +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(64)743 +299 y Fe(and)40 b(execute)h(it.)f(*/)625 386 y(s)g(=)f(stripwhite)j +(\(line\);)625 560 y(if)e(\(*s\))704 648 y({)782 735 +y(add_history)i(\(s\);)782 822 y(execute_line)g(\(s\);)704 +909 y(})625 1083 y(free)e(\(line\);)547 1171 y(})468 +1258 y(exit)h(\(0\);)390 1345 y(})390 1519 y(/*)f(Execute)g(a)g +(command)h(line.)f(*/)390 1606 y(int)390 1694 y(execute_line)i(\(char)e +(*line\))390 1781 y({)468 1868 y(register)h(int)f(i;)468 +1955 y(COMMAND)h(*command;)468 2042 y(char)g(*word;)468 +2217 y(/*)f(Isolate)h(the)f(command)h(word.)f(*/)468 +2304 y(i)g(=)f(0;)468 2391 y(while)i(\(line[i])g(&&)f(whitespace)h +(\(line[i]\)\))547 2478 y(i++;)468 2565 y(word)g(=)e(line)h(+)g(i;)468 +2740 y(while)h(\(line[i])g(&&)f(!whitespace)h(\(line[i]\)\))547 +2827 y(i++;)468 3001 y(if)f(\(line[i]\))547 3088 y(line[i++])h(=)f +('\\0';)468 3263 y(command)h(=)f(find_command)i(\(word\);)468 +3437 y(if)e(\(!command\))547 3524 y({)625 3611 y(fprintf)h(\(stderr,)g +("\045s:)f(No)g(such)g(command)h(for)f(FileMan.\\n",)i(word\);)625 +3699 y(return)f(\(-1\);)547 3786 y(})468 3960 y(/*)f(Get)g(argument)h +(to)f(command,)h(if)f(any.)g(*/)468 4047 y(while)h(\(whitespace)h +(\(line[i]\)\))547 4134 y(i++;)468 4309 y(word)f(=)e(line)h(+)g(i;)468 +4483 y(/*)g(Call)g(the)g(function.)h(*/)468 4570 y(return)g +(\(\(*\(command->func\)\))j(\(word\)\);)390 4658 y(})390 +4832 y(/*)c(Look)g(up)f(NAME)i(as)e(the)h(name)g(of)g(a)g(command,)h +(and)e(return)i(a)f(pointer)g(to)g(that)508 4919 y(command.)80 +b(Return)41 b(a)e(NULL)h(pointer)h(if)f(NAME)g(isn't)g(a)g(command)g +(name.)h(*/)390 5006 y(COMMAND)g(*)390 5093 y(find_command)h(\(char)e +(*name\))390 5181 y({)468 5268 y(register)h(int)f(i;)p eop end %%Page: 65 69 TeXDict begin 65 68 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(65)508 -299 y Fe(in)39 b(case)h(we)g(want)g(to)g(do)g(some)g(simple)g(parsing.) -81 b(Return)40 b(the)g(array)h(of)e(matches,)508 386 -y(or)g(NULL)h(if)g(there)h(aren't)f(any.)g(*/)390 473 -y(char)g(**)390 560 y(fileman_completion)j(\(text,)e(start,)g(end\))586 -648 y(const)f(char)h(*text;)586 735 y(int)f(start,)h(end;)390 -822 y({)468 909 y(char)g(**matches;)468 1083 y(matches)g(=)f(\(char)g -(**\)NULL;)468 1258 y(/*)g(If)g(this)g(word)g(is)g(at)f(the)h(start)h -(of)e(the)h(line,)h(then)f(it)g(is)f(a)h(command)586 -1345 y(to)g(complete.)80 b(Otherwise)42 b(it)d(is)h(the)g(name)g(of)g -(a)f(file)h(in)g(the)g(current)586 1432 y(directory.)i(*/)468 -1519 y(if)e(\(start)h(==)e(0\))547 1606 y(matches)i(=)e -(rl_completion_matches)44 b(\(text,)d(command_generator\);)468 -1781 y(return)g(\(matches\);)390 1868 y(})390 2042 y(/*)f(Generator)h -(function)g(for)f(command)h(completion.)81 b(STATE)40 -b(lets)g(us)g(know)g(whether)508 2130 y(to)f(start)i(from)f(scratch;)h -(without)g(any)f(state)g(\(i.e.)g(STATE)h(==)e(0\),)h(then)g(we)508 -2217 y(start)g(at)g(the)g(top)g(of)f(the)h(list.)h(*/)390 -2304 y(char)f(*)390 2391 y(command_generator)j(\(text,)e(state\))586 -2478 y(const)f(char)h(*text;)586 2565 y(int)f(state;)390 -2653 y({)468 2740 y(static)h(int)f(list_index,)i(len;)468 -2827 y(char)f(*name;)468 3001 y(/*)f(If)g(this)g(is)g(a)f(new)h(word)g -(to)g(complete,)h(initialize)h(now.)79 b(This)40 b(includes)586 -3088 y(saving)h(the)f(length)g(of)g(TEXT)g(for)g(efficiency,)i(and)e -(initializing)i(the)d(index)586 3176 y(variable)i(to)f(0.)g(*/)468 -3263 y(if)g(\(!state\))547 3350 y({)625 3437 y(list_index)i(=)d(0;)625 -3524 y(len)h(=)g(strlen)g(\(text\);)547 3611 y(})468 -3786 y(/*)g(Return)h(the)f(next)g(name)g(which)g(partially)i(matches)e -(from)h(the)e(command)i(list.)g(*/)468 3873 y(while)g(\(name)f(=)g -(commands[list_index].name\))547 3960 y({)625 4047 y(list_index++;)625 -4222 y(if)g(\(strncmp)h(\(name,)g(text,)f(len\))g(==)g(0\))704 -4309 y(return)g(\(dupstr\(name\)\);)547 4396 y(})468 -4570 y(/*)g(If)g(no)f(names)i(matched,)g(then)f(return)h(NULL.)f(*/)468 -4658 y(return)h(\(\(char)g(*\)NULL\);)390 4745 y(})390 -4919 y(/*)f(******************************)q(*****)q(****)q(*****)q -(****)q(****)q(*****)q(****)q(***)45 b(*/)390 5006 y(/*)2589 -b(*/)390 5093 y(/*)903 b(FileMan)41 b(Commands)1060 b(*/)390 -5181 y(/*)2589 b(*/)390 5268 y(/*)40 b(******************************)q -(*****)q(****)q(*****)q(****)q(****)q(*****)q(****)q(***)45 -b(*/)p eop end +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(65)468 +386 y Fe(for)40 b(\(i)g(=)f(0;)h(commands[i].name;)j(i++\))547 +473 y(if)d(\(strcmp)g(\(name,)h(commands[i].name\))i(==)d(0\))625 +560 y(return)h(\(&commands[i]\);)468 735 y(return)g(\(\(COMMAND)g +(*\)NULL\);)390 822 y(})390 996 y(/*)f(Strip)g(whitespace)i(from)e(the) +g(start)g(and)g(end)g(of)f(STRING.)81 b(Return)40 b(a)g(pointer)508 +1083 y(into)g(STRING.)h(*/)390 1171 y(char)f(*)390 1258 +y(stripwhite)h(\(char)g(*string\))390 1345 y({)468 1432 +y(register)g(char)g(*s,)f(*t;)468 1606 y(for)g(\(s)g(=)f(string;)i +(whitespace)h(\(*s\);)e(s++\))547 1694 y(;)468 1868 y(if)g(\(*s)g(==)g +(0\))547 1955 y(return)g(\(s\);)468 2130 y(t)g(=)f(s)h(+)f(strlen)i +(\(s\))f(-)f(1;)468 2217 y(while)i(\(t)e(>)h(s)f(&&)h(whitespace)i +(\(*t\)\))547 2304 y(t--;)468 2391 y(*++t)f(=)e('\\0';)468 +2565 y(return)i(s;)390 2653 y(})390 2827 y(/*)f +(******************************)q(*****)q(****)q(*****)q(****)q(****)q +(*****)q(****)q(***)45 b(*/)390 2914 y(/*)2589 b(*/)390 +3001 y(/*)707 b(Interface)41 b(to)f(Readline)h(Completion)629 +b(*/)390 3088 y(/*)2589 b(*/)390 3176 y(/*)40 b +(******************************)q(*****)q(****)q(*****)q(****)q(****)q +(*****)q(****)q(***)45 b(*/)390 3350 y(char)40 b(*command_generator)j +(\(const)e(char)f(*,)g(int\);)390 3437 y(char)g(**fileman_completion)k +(\(const)d(char)f(*,)f(int,)h(int\);)390 3611 y(/*)g(Tell)g(the)g(GNU)g +(Readline)h(library)g(how)e(to)h(complete.)81 b(We)39 +b(want)h(to)g(try)g(to)g(complete)508 3699 y(on)f(command)i(names)g(if) +e(this)h(is)g(the)g(first)g(word)g(in)g(the)g(line,)g(or)g(on)g +(filenames)508 3786 y(if)f(not.)h(*/)390 3873 y(void)390 +3960 y(initialize_readline)k(\(void\))390 4047 y({)468 +4134 y(/*)c(Allow)g(conditional)i(parsing)f(of)f(the)g(~/.inputrc)h +(file.)g(*/)468 4222 y(rl_readline_name)i(=)d("FileMan";)468 +4396 y(/*)g(Tell)g(the)g(completer)h(that)g(we)e(want)h(a)g(crack)g +(first.)h(*/)468 4483 y(rl_attempted_completion_fun)q(ctio)q(n)k(=)39 +b(fileman_completion;)390 4570 y(})390 4745 y(/*)h(Attempt)g(to)g +(complete)h(on)f(the)g(contents)h(of)f(TEXT.)79 b(START)41 +b(and)e(END)h(bound)h(the)508 4832 y(region)f(of)g(rl_line_buffer)i +(that)f(contains)g(the)e(word)i(to)e(complete.)81 b(TEXT)40 +b(is)508 4919 y(the)g(word)g(to)f(complete.)81 b(We)40 +b(can)g(use)f(the)h(entire)h(contents)g(of)f(rl_line_buffer)508 +5006 y(in)f(case)h(we)g(want)g(to)g(do)g(some)g(simple)g(parsing.)81 +b(Return)40 b(the)g(array)h(of)e(matches,)508 5093 y(or)g(NULL)h(if)g +(there)h(aren't)f(any.)g(*/)390 5181 y(char)g(**)390 +5268 y(fileman_completion)j(\(const)e(char)f(*text,)h(int)f(start,)g +(int)g(end\))p eop end %%Page: 66 70 TeXDict begin 66 69 bop 150 -116 a Ft(Chapter)30 b(2:)41 b(Programming)30 b(with)g(GNU)h(Readline)1683 b(66)390 -386 y Fe(/*)40 b(String)g(to)g(pass)g(to)g(system)g(\(\).)80 -b(This)40 b(is)f(for)h(the)g(LIST,)h(VIEW)f(and)g(RENAME)508 -473 y(commands.)h(*/)390 560 y(static)g(char)f(syscom[1024];)390 -735 y(/*)g(List)g(the)g(file\(s\))h(named)f(in)g(arg.)g(*/)390 -822 y(com_list)h(\(arg\))586 909 y(char)f(*arg;)390 996 -y({)468 1083 y(if)g(\(!arg\))547 1171 y(arg)g(=)f("";)468 -1345 y(sprintf)i(\(syscom,)g("ls)f(-FClg)h(\045s",)f(arg\);)468 -1432 y(return)h(\(system)g(\(syscom\)\);)390 1519 y(})390 -1694 y(com_view)g(\(arg\))586 1781 y(char)f(*arg;)390 -1868 y({)468 1955 y(if)g(\(!valid_argument)j(\("view",)e(arg\)\))547 -2042 y(return)f(1;)390 2217 y(#if)g(defined)h(\(__MSDOS__\))468 -2304 y(/*)f(more.com)h(doesn't)g(grok)f(slashes)h(in)f(pathnames)h(*/) -468 2391 y(sprintf)g(\(syscom,)g("less)g(\045s",)f(arg\);)390 -2478 y(#else)468 2565 y(sprintf)h(\(syscom,)g("more)g(\045s",)f(arg\);) -390 2653 y(#endif)468 2740 y(return)h(\(system)g(\(syscom\)\);)390 -2827 y(})390 3001 y(com_rename)g(\(arg\))586 3088 y(char)f(*arg;)390 -3176 y({)468 3263 y(too_dangerous)j(\("rename"\);)468 -3350 y(return)e(\(1\);)390 3437 y(})390 3611 y(com_stat)g(\(arg\))586 -3699 y(char)f(*arg;)390 3786 y({)468 3873 y(struct)h(stat)f(finfo;)468 -4047 y(if)g(\(!valid_argument)j(\("stat",)e(arg\)\))547 -4134 y(return)f(\(1\);)468 4309 y(if)g(\(stat)g(\(arg,)h(&finfo\))g(==) -e(-1\))547 4396 y({)625 4483 y(perror)i(\(arg\);)625 -4570 y(return)g(\(1\);)547 4658 y(})468 4832 y(printf)g(\("Statistics)h -(for)e(`\045s':\\n",)h(arg\);)468 5006 y(printf)g(\("\045s)f(has)g -(\045d)g(link\045s,)h(and)f(is)f(\045d)h(byte\045s)g(in)g(length.\\n",) -468 5093 y(arg,)782 5181 y(finfo.st_nlink,)782 5268 y(\(finfo.st_nlink) -j(==)d(1\))f(?)h("")f(:)h("s",)p eop end +299 y Fe({)468 386 y(char)41 b(**matches;)468 560 y(matches)g(=)f +(\(char)g(**\)NULL;)468 735 y(/*)g(If)g(this)g(word)g(is)g(at)f(the)h +(start)h(of)e(the)h(line,)h(then)f(it)g(is)f(a)h(command)586 +822 y(to)g(complete.)80 b(Otherwise)42 b(it)d(is)h(the)g(name)g(of)g(a) +f(file)h(in)g(the)g(current)586 909 y(directory.)i(*/)468 +996 y(if)e(\(start)h(==)e(0\))547 1083 y(matches)i(=)e +(rl_completion_matches)44 b(\(text,)d(command_generator\);)468 +1258 y(return)g(\(matches\);)390 1345 y(})390 1519 y(/*)f(Generator)h +(function)g(for)f(command)h(completion.)81 b(STATE)40 +b(lets)g(us)g(know)g(whether)508 1606 y(to)f(start)i(from)f(scratch;)h +(without)g(any)f(state)g(\(i.e.)g(STATE)h(==)e(0\),)h(then)g(we)508 +1694 y(start)g(at)g(the)g(top)g(of)f(the)h(list.)h(*/)390 +1781 y(char)f(*)390 1868 y(command_generator)j(\(const)e(char)f(*text,) +g(int)g(state\))390 1955 y({)468 2042 y(static)h(int)f(list_index,)i +(len;)468 2130 y(char)f(*name;)468 2304 y(/*)f(If)g(this)g(is)g(a)f +(new)h(word)g(to)g(complete,)h(initialize)h(now.)79 b(This)40 +b(includes)586 2391 y(saving)h(the)f(length)g(of)g(TEXT)g(for)g +(efficiency,)i(and)e(initializing)i(the)d(index)586 2478 +y(variable)i(to)f(0.)g(*/)468 2565 y(if)g(\(!state\))547 +2653 y({)625 2740 y(list_index)i(=)d(0;)625 2827 y(len)h(=)g(strlen)g +(\(text\);)547 2914 y(})468 3088 y(/*)g(Return)h(the)f(next)g(name)g +(which)g(partially)i(matches)e(from)h(the)e(command)i(list.)g(*/)468 +3176 y(while)g(\(name)f(=)g(commands[list_index].name\))547 +3263 y({)625 3350 y(list_index++;)625 3524 y(if)g(\(strncmp)h(\(name,)g +(text,)f(len\))g(==)g(0\))704 3611 y(return)g(\(dupstr\(name\)\);)547 +3699 y(})468 3873 y(/*)g(If)g(no)f(names)i(matched,)g(then)f(return)h +(NULL.)f(*/)468 3960 y(return)h(\(\(char)g(*\)NULL\);)390 +4047 y(})390 4222 y(/*)f(******************************)q(*****)q(****) +q(*****)q(****)q(****)q(*****)q(****)q(***)45 b(*/)390 +4309 y(/*)2589 b(*/)390 4396 y(/*)903 b(FileMan)41 b(Commands)1060 +b(*/)390 4483 y(/*)2589 b(*/)390 4570 y(/*)40 b +(******************************)q(*****)q(****)q(*****)q(****)q(****)q +(*****)q(****)q(***)45 b(*/)390 4745 y(/*)40 b(String)g(to)g(pass)g(to) +g(system)g(\(\).)80 b(This)40 b(is)f(for)h(the)g(LIST,)h(VIEW)f(and)g +(RENAME)508 4832 y(commands.)h(*/)390 4919 y(static)g(char)f +(syscom[1024];)390 5093 y(/*)g(List)g(the)g(file\(s\))h(named)f(in)g +(arg.)g(*/)390 5181 y(int)390 5268 y(com_list)h(\(char)f(*arg\))p +eop end %%Page: 67 71 TeXDict begin 67 70 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(67)782 -299 y Fe(finfo.st_size,)782 386 y(\(finfo.st_size)43 -b(==)c(1\))h(?)g("")f(:)h("s"\);)468 473 y(printf)h(\("Inode)g(Last)f -(Change)h(at:)f(\045s",)g(ctime)g(\(&finfo.st_ctime\)\);)468 -560 y(printf)h(\(")236 b(Last)40 b(access)h(at:)f(\045s",)g(ctime)g -(\(&finfo.st_atime\)\);)468 648 y(printf)h(\(")157 b(Last)41 -b(modified)g(at:)f(\045s",)g(ctime)g(\(&finfo.st_mtime\)\);)468 -735 y(return)h(\(0\);)390 822 y(})390 996 y(com_delete)g(\(arg\))586 -1083 y(char)f(*arg;)390 1171 y({)468 1258 y(too_dangerous)j -(\("delete"\);)468 1345 y(return)e(\(1\);)390 1432 y(})390 -1606 y(/*)f(Print)g(out)g(help)g(for)g(ARG,)g(or)g(for)g(all)g(of)f -(the)h(commands)h(if)f(ARG)g(is)508 1694 y(not)g(present.)h(*/)390 -1781 y(com_help)g(\(arg\))586 1868 y(char)f(*arg;)390 -1955 y({)468 2042 y(register)h(int)f(i;)468 2130 y(int)g(printed)h(=)f -(0;)468 2304 y(for)g(\(i)g(=)f(0;)h(commands[i].name;)j(i++\))547 -2391 y({)625 2478 y(if)d(\(!*arg)h(||)e(\(strcmp)i(\(arg,)g -(commands[i].name\))i(==)c(0\)\))704 2565 y({)782 2653 -y(printf)i(\("\045s\\t\\t\045s.\\n",)i(commands[i].name,)g -(commands[i].doc\);)782 2740 y(printed++;)704 2827 y(})547 -2914 y(})468 3088 y(if)d(\(!printed\))547 3176 y({)625 -3263 y(printf)h(\("No)f(commands)h(match)g(`\045s'.)79 -b(Possibilities)42 b(are:\\n",)f(arg\);)625 3437 y(for)f(\(i)g(=)f(0;)h -(commands[i].name;)j(i++\))704 3524 y({)782 3611 y(/*)d(Print)g(in)g -(six)g(columns.)h(*/)782 3699 y(if)f(\(printed)h(==)f(6\))861 -3786 y({)939 3873 y(printed)h(=)e(0;)939 3960 y(printf)i(\("\\n"\);)861 -4047 y(})782 4222 y(printf)g(\("\045s\\t",)g(commands[i].name\);)782 -4309 y(printed++;)704 4396 y(})625 4570 y(if)f(\(printed\))704 -4658 y(printf)g(\("\\n"\);)547 4745 y(})468 4832 y(return)h(\(0\);)390 -4919 y(})390 5093 y(/*)f(Change)g(to)g(the)g(directory)h(ARG.)f(*/)390 -5181 y(com_cd)h(\(arg\))586 5268 y(char)f(*arg;)p eop -end +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(67)390 +299 y Fe({)468 386 y(if)40 b(\(!arg\))547 473 y(arg)g(=)f("";)468 +648 y(snprintf)i(\(syscom,)h(sizeof)e(\(syscom\),)h("ls)f(-FClg)h +(\045s",)f(arg\);)468 735 y(return)h(\(system)g(\(syscom\)\);)390 +822 y(})390 996 y(int)390 1083 y(com_view)g(\(char)f(*arg\))390 +1171 y({)468 1258 y(if)g(\(!valid_argument)j(\("view",)e(arg\)\))547 +1345 y(return)f(1;)390 1519 y(#if)g(defined)h(\(__MSDOS__\))468 +1606 y(/*)f(more.com)h(doesn't)g(grok)f(slashes)h(in)f(pathnames)h(*/) +468 1694 y(snprintf)g(\(syscom,)h(sizeof)e(\(syscom\),)h("less)g +(\045s",)f(arg\);)390 1781 y(#else)468 1868 y(snprintf)h(\(syscom,)h +(sizeof)e(\(syscom\),)h("more)g(\045s",)f(arg\);)390 +1955 y(#endif)468 2042 y(return)h(\(system)g(\(syscom\)\);)390 +2130 y(})390 2304 y(int)390 2391 y(com_rename)g(\(char)g(*arg\))390 +2478 y({)468 2565 y(too_dangerous)i(\("rename"\);)468 +2653 y(return)e(\(1\);)390 2740 y(})390 2914 y(int)390 +3001 y(com_stat)g(\(char)f(*arg\))390 3088 y({)468 3176 +y(struct)h(stat)f(finfo;)468 3350 y(if)g(\(!valid_argument)j(\("stat",) +e(arg\)\))547 3437 y(return)f(\(1\);)468 3611 y(if)g(\(stat)g(\(arg,)h +(&finfo\))g(==)e(-1\))547 3699 y({)625 3786 y(perror)i(\(arg\);)625 +3873 y(return)g(\(1\);)547 3960 y(})468 4134 y(printf)g(\("Statistics)h +(for)e(`\045s':\\n",)h(arg\);)468 4309 y(printf)g(\("\045s)f(has)g +(\045d)g(link\045s,)h(and)f(is)f(\045d)h(byte\045s)g(in)g(length.\\n",) +468 4396 y(arg,)782 4483 y(finfo.st_nlink,)782 4570 y(\(finfo.st_nlink) +j(==)d(1\))f(?)h("")f(:)h("s",)782 4658 y(finfo.st_size,)782 +4745 y(\(finfo.st_size)j(==)c(1\))h(?)g("")f(:)h("s"\);)468 +4832 y(printf)h(\("Inode)g(Last)f(Change)h(at:)f(\045s",)g(ctime)g +(\(&finfo.st_ctime\)\);)468 4919 y(printf)h(\(")236 b(Last)40 +b(access)h(at:)f(\045s",)g(ctime)g(\(&finfo.st_atime\)\);)468 +5006 y(printf)h(\(")157 b(Last)41 b(modified)g(at:)f(\045s",)g(ctime)g +(\(&finfo.st_mtime\)\);)468 5093 y(return)h(\(0\);)390 +5181 y(})p eop end %%Page: 68 72 TeXDict begin 68 71 bop 150 -116 a Ft(Chapter)30 b(2:)41 b(Programming)30 b(with)g(GNU)h(Readline)1683 b(68)390 -299 y Fe({)468 386 y(if)40 b(\(chdir)h(\(arg\))f(==)g(-1\))547 -473 y({)625 560 y(perror)h(\(arg\);)625 648 y(return)g(1;)547 -735 y(})468 909 y(com_pwd)g(\(""\);)468 996 y(return)g(\(0\);)390 -1083 y(})390 1258 y(/*)f(Print)g(out)g(the)g(current)h(working)g -(directory.)g(*/)390 1345 y(com_pwd)g(\(ignore\))586 -1432 y(char)f(*ignore;)390 1519 y({)468 1606 y(char)h(dir[1024],)g(*s;) -468 1781 y(s)f(=)f(getcwd)i(\(dir,)f(sizeof\(dir\))i(-)e(1\);)468 -1868 y(if)g(\(s)g(==)f(0\))547 1955 y({)625 2042 y(printf)i(\("Error)g -(getting)g(pwd:)f(\045s\\n",)g(dir\);)625 2130 y(return)h(1;)547 -2217 y(})468 2391 y(printf)g(\("Current)g(directory)h(is)d(\045s\\n",)i -(dir\);)468 2478 y(return)g(0;)390 2565 y(})390 2740 -y(/*)f(The)g(user)g(wishes)g(to)g(quit)g(using)h(this)f(program.)80 -b(Just)40 b(set)g(DONE)g(non-zero.)h(*/)390 2827 y(com_quit)g(\(arg\)) -586 2914 y(char)f(*arg;)390 3001 y({)468 3088 y(done)h(=)e(1;)468 -3176 y(return)i(\(0\);)390 3263 y(})390 3437 y(/*)f(Function)h(which)f -(tells)g(you)g(that)h(you)e(can't)i(do)e(this.)i(*/)390 -3524 y(too_dangerous)h(\(caller\))586 3611 y(char)e(*caller;)390 -3699 y({)468 3786 y(fprintf)h(\(stderr,)821 3873 y("\045s:)g(Too)f -(dangerous)h(for)f(me)f(to)h(distribute.)81 b(Write)40 -b(it)g(yourself.\\n",)821 3960 y(caller\);)390 4047 y(})390 -4222 y(/*)g(Return)g(non-zero)h(if)f(ARG)g(is)g(a)f(valid)h(argument)h -(for)f(CALLER,)h(else)f(print)508 4309 y(an)f(error)i(message)g(and)e -(return)i(zero.)f(*/)390 4396 y(int)390 4483 y(valid_argument)i -(\(caller,)f(arg\))586 4570 y(char)f(*caller,)h(*arg;)390 -4658 y({)468 4745 y(if)f(\(!arg)g(||)g(!*arg\))547 4832 -y({)625 4919 y(fprintf)h(\(stderr,)g("\045s:)f(Argument)h -(required.\\n",)i(caller\);)625 5006 y(return)e(\(0\);)547 -5093 y(})468 5268 y(return)g(\(1\);)p eop end +299 y Fe(int)390 386 y(com_delete)41 b(\(char)g(*arg\))390 +473 y({)468 560 y(too_dangerous)i(\("delete"\);)468 648 +y(return)e(\(1\);)390 735 y(})390 909 y(/*)f(Print)g(out)g(help)g(for)g +(ARG,)g(or)g(for)g(all)g(of)f(the)h(commands)h(if)f(ARG)g(is)508 +996 y(not)g(present.)h(*/)390 1083 y(int)390 1171 y(com_help)g(\(char)f +(*arg\))390 1258 y({)468 1345 y(register)h(int)f(i;)468 +1432 y(int)g(printed)h(=)f(0;)468 1606 y(for)g(\(i)g(=)f(0;)h +(commands[i].name;)j(i++\))547 1694 y({)625 1781 y(if)d(\(!*arg)h(||)e +(\(strcmp)i(\(arg,)g(commands[i].name\))i(==)c(0\)\))704 +1868 y({)782 1955 y(printf)i(\("\045s\\t\\t\045s.\\n",)i +(commands[i].name,)g(commands[i].doc\);)782 2042 y(printed++;)704 +2130 y(})547 2217 y(})468 2391 y(if)d(\(!printed\))547 +2478 y({)625 2565 y(printf)h(\("No)f(commands)h(match)g(`\045s'.)79 +b(Possibilities)42 b(are:\\n",)f(arg\);)625 2740 y(for)f(\(i)g(=)f(0;)h +(commands[i].name;)j(i++\))704 2827 y({)782 2914 y(/*)d(Print)g(in)g +(six)g(columns.)h(*/)782 3001 y(if)f(\(printed)h(==)f(6\))861 +3088 y({)939 3176 y(printed)h(=)e(0;)939 3263 y(printf)i(\("\\n"\);)861 +3350 y(})782 3524 y(printf)g(\("\045s\\t",)g(commands[i].name\);)782 +3611 y(printed++;)704 3699 y(})625 3873 y(if)f(\(printed\))704 +3960 y(printf)g(\("\\n"\);)547 4047 y(})468 4134 y(return)h(\(0\);)390 +4222 y(})390 4396 y(/*)f(Change)g(to)g(the)g(directory)h(ARG.)f(*/)390 +4483 y(int)390 4570 y(com_cd)h(\(char)f(*arg\))390 4658 +y({)468 4745 y(if)g(\(chdir)h(\(arg\))f(==)g(-1\))547 +4832 y({)625 4919 y(perror)h(\(arg\);)625 5006 y(return)g(1;)547 +5093 y(})468 5268 y(com_pwd)g(\(""\);)p eop end %%Page: 69 73 TeXDict begin 69 72 bop 150 -116 a Ft(Chapter)30 b(2:)41 -b(Programming)30 b(with)g(GNU)h(Readline)1683 b(69)390 -299 y Fe(})p eop end +b(Programming)30 b(with)g(GNU)h(Readline)1683 b(69)468 +299 y Fe(return)41 b(\(0\);)390 386 y(})390 560 y(/*)f(Print)g(out)g +(the)g(current)h(working)g(directory.)g(*/)390 648 y(int)390 +735 y(com_pwd)g(\(char)f(*ignore\))390 822 y({)468 909 +y(char)h(dir[1024],)g(*s;)468 1083 y(s)f(=)f(getcwd)i(\(dir,)f +(sizeof\(dir\))i(-)e(1\);)468 1171 y(if)g(\(s)g(==)f(0\))547 +1258 y({)625 1345 y(printf)i(\("Error)g(getting)g(pwd:)f(\045s\\n",)g +(dir\);)625 1432 y(return)h(1;)547 1519 y(})468 1694 +y(printf)g(\("Current)g(directory)h(is)d(\045s\\n",)i(dir\);)468 +1781 y(return)g(0;)390 1868 y(})390 2042 y(/*)f(The)g(user)g(wishes)g +(to)g(quit)g(using)h(this)f(program.)80 b(Just)40 b(set)g(DONE)g +(non-zero.)h(*/)390 2130 y(int)390 2217 y(com_quit)g(\(char)f(*arg\)) +390 2304 y({)468 2391 y(done)h(=)e(1;)468 2478 y(return)i(\(0\);)390 +2565 y(})390 2740 y(/*)f(Function)h(which)f(tells)g(you)g(that)h(you)e +(can't)i(do)e(this.)i(*/)390 2827 y(void)390 2914 y(too_dangerous)h +(\(char)f(*caller\))390 3001 y({)468 3088 y(fprintf)g(\(stderr,)821 +3176 y("\045s:)g(Too)f(dangerous)h(for)f(me)f(to)h(distribute.)81 +b(Write)40 b(it)g(yourself.\\n",)821 3263 y(caller\);)390 +3350 y(})390 3524 y(/*)g(Return)g(non-zero)h(if)f(ARG)g(is)g(a)f(valid) +h(argument)h(for)f(CALLER,)h(else)f(print)508 3611 y(an)f(error)i +(message)g(and)e(return)i(zero.)f(*/)390 3699 y(int)390 +3786 y(valid_argument)i(\(char)f(*caller,)g(char)f(*arg\))390 +3873 y({)468 3960 y(if)g(\(!arg)g(||)g(!*arg\))547 4047 +y({)625 4134 y(fprintf)h(\(stderr,)g("\045s:)f(Argument)h +(required.\\n",)i(caller\);)625 4222 y(return)e(\(0\);)547 +4309 y(})468 4483 y(return)g(\(1\);)390 4570 y(})p eop +end %%Page: 70 74 TeXDict begin 70 73 bop 3659 -116 a Ft(70)150 299 y Fp(App)t(endix)52 b(A)81 b(GNU)54 b(F)-13 b(ree)53 b(Do)t(cumen)l(tation)e(License)1359 @@ -11956,7 +12045,7 @@ eop end TeXDict begin 78 81 bop 150 -116 a Ft(Concept)31 b(Index)2927 b(78)150 100 y Fp(Concept)52 b(Index)146 434 y Fr(A)150 550 y Fb(application-sp)r(eci\014c)27 b(completion)f(functions)e -Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)37 b Fb(53)146 796 y +Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)37 b Fb(54)146 796 y Fr(C)150 913 y Fb(command)26 b(editing)6 b Fa(:)14 b(:)f(:)g(:)g(:)g(:) g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)21 b Fb(1)146 1159 @@ -11992,21 +12081,21 @@ TeXDict begin 79 82 bop 3659 -116 a Ft(79)150 299 y Fp(F)-13 b(unction)52 b(and)h(V)-13 b(ariable)53 b(Index)p 156 740 41 6 v 150 860 a Fe(_rl_digit_p)10 b Fa(:)16 b(:)d(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) -g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)25 b Fb(44)150 +g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)25 b Fb(45)150 948 y Fe(_rl_digit_value)17 b Fa(:)g(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g -(:)g(:)g(:)32 b Fb(44)150 1036 y Fe(_rl_lowercase_p)17 +(:)g(:)g(:)32 b Fb(45)150 1036 y Fe(_rl_lowercase_p)17 b Fa(:)g(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)32 -b Fb(44)150 1125 y Fe(_rl_to_lower)8 b Fa(:)16 b(:)d(:)g(:)g(:)g(:)g(:) +b Fb(45)150 1125 y Fe(_rl_to_lower)8 b Fa(:)16 b(:)d(:)g(:)g(:)g(:)g(:) g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)22 b Fb(44)150 +(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)22 b Fb(45)150 1213 y Fe(_rl_to_upper)8 b Fa(:)16 b(:)d(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)g(:)h(:)f(:)g(:)22 b Fb(44)150 1300 y Fe(_rl_uppercase_p)17 +(:)g(:)g(:)g(:)h(:)f(:)g(:)22 b Fb(45)150 1300 y Fe(_rl_uppercase_p)17 b Fa(:)g(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)32 -b Fb(44)146 1569 y Fr(A)150 1689 y Fe(abort)27 b(\(C-g\))17 +b Fb(45)146 1569 y Fr(A)150 1689 y Fe(abort)27 b(\(C-g\))17 b Fa(:)d(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h (:)31 b Fb(23)150 1777 y Fe(accept-line)d(\(Newline)g(or)e(Return\))14 @@ -12089,173 +12178,174 @@ b(\(\))9 b Fa(:)k(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f g(:)26 b Fb(22)150 5199 y Fe(copy-region-as-kill)k(\(\))6 b Fa(:)14 b(:)f(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)21 b Fb(22)2021 817 y Fr(D)2025 -933 y Fe(delete-char)28 b(\(C-d\))20 b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:) +941 y Fe(delete-char)28 b(\(C-d\))20 b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)g(:)34 b Fb(20)2025 1020 y Fe(delete-char-or-list)c(\(\))6 +(:)g(:)g(:)g(:)34 b Fb(20)2025 1031 y Fe(delete-char-or-list)c(\(\))6 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g -(:)h(:)f(:)g(:)g(:)g(:)g(:)21 b Fb(23)2025 1108 y Fe +(:)h(:)f(:)g(:)g(:)g(:)g(:)21 b Fb(23)2025 1121 y Fe (delete-horizontal-space)31 b(\(\))13 b Fa(:)g(:)g(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)28 b Fb(22)2025 -1195 y Fe(digit-argument)h(\()p Fc(M-0)p Fe(,)d Fc(M-1)p +(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)28 b Fb(21)2025 +1210 y Fe(digit-argument)h(\()p Fc(M-0)p Fe(,)d Fc(M-1)p Fe(,)h(...)f Fc(M--)p Fe(\))13 b Fa(:)h(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g -(:)28 b Fb(22)2025 1282 y(disable-completion)20 b Fa(:)13 +(:)28 b Fb(22)2025 1300 y(disable-completion)20 b Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)34 b Fb(7)2025 -1370 y Fe(do-lowercase-version)c(\(M-A,)d(M-B,)f(M-)p -Fc(x)p Fe(,)h(...\))12 b Fa(:)i(:)27 b Fb(23)2025 1457 +1390 y Fe(do-lowercase-version)c(\(M-A,)d(M-B,)f(M-)p +Fc(x)p Fe(,)h(...\))12 b Fa(:)i(:)27 b Fb(23)2025 1480 y Fe(downcase-word)h(\(M-l\))14 b Fa(:)g(:)g(:)f(:)g(:)g(:)g(:)g(:)g(:) g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)28 -b Fb(20)2025 1544 y Fe(dump-functions)h(\(\))19 b Fa(:)13 +b Fb(20)2025 1570 y Fe(dump-functions)h(\(\))19 b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)34 b Fb(24)2025 -1631 y Fe(dump-macros)28 b(\(\))10 b Fa(:)j(:)g(:)g(:)g(:)h(:)f(:)g(:)g +1659 y Fe(dump-macros)28 b(\(\))10 b Fa(:)j(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) -g(:)g(:)h(:)f(:)g(:)g(:)24 b Fb(25)2025 1719 y Fe(dump-variables)29 +g(:)g(:)h(:)f(:)g(:)g(:)24 b Fb(25)2025 1747 y Fe(dump-variables)29 b(\(\))19 b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)34 -b Fb(25)2021 1965 y Fr(E)2025 2081 y Fb(ec)n(ho-con)n(trol-c)n +b Fb(24)2021 2046 y Fr(E)2025 2170 y Fb(ec)n(ho-con)n(trol-c)n (haracters)13 b Fa(:)h(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)29 -b Fb(7)2025 2169 y(editing-mo)r(de)10 b Fa(:)j(:)g(:)g(:)g(:)g(:)g(:)h +b Fb(7)2025 2260 y(editing-mo)r(de)10 b Fa(:)j(:)g(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)25 b Fb(7)2025 -2256 y Fe(emacs-editing-mode)k(\(C-e\))18 b Fa(:)d(:)e(:)g(:)g(:)g(:)h +2350 y Fe(emacs-editing-mode)k(\(C-e\))18 b Fa(:)d(:)e(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)33 -b Fb(25)2025 2343 y(emacs-mo)r(de-string)18 b Fa(:)c(:)f(:)g(:)g(:)g(:) +b Fb(25)2025 2440 y(emacs-mo)r(de-string)18 b Fa(:)c(:)f(:)g(:)g(:)g(:) g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g -(:)h(:)f(:)g(:)g(:)g(:)g(:)33 b Fb(7)2025 2431 y(enable-activ)n +(:)h(:)f(:)g(:)g(:)g(:)g(:)33 b Fb(7)2025 2530 y(enable-activ)n (e-region)15 b Fa(:)f(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)30 -b Fb(7)2025 2518 y(enable-brac)n(k)n(eted-paste)18 b +b Fb(7)2025 2619 y(enable-brac)n(k)n(eted-paste)18 b Fa(:)12 b(:)h(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)33 b Fb(7)2025 -2605 y(enable-k)n(eypad)7 b Fa(:)12 b(:)h(:)g(:)g(:)h(:)f(:)g(:)g(:)g +2709 y(enable-k)n(eypad)7 b Fa(:)12 b(:)h(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)23 b Fb(7)2025 2692 y +h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)23 b Fb(8)2025 2799 y Fe(end-kbd-macro)28 b(\(C-x)f(\)\))16 b Fa(:)d(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)30 -b Fb(23)2025 2780 y Fc(end-of-file)e Fe(\(usually)f(C-d\))d +b Fb(23)2025 2889 y Fc(end-of-file)e Fe(\(usually)f(C-d\))d Fa(:)13 b(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)37 b Fb(19)2025 2867 y Fe(end-of-history)29 +(:)g(:)g(:)37 b Fb(19)2025 2979 y Fe(end-of-history)29 b(\(M->\))11 b Fa(:)j(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)26 b Fb(18)2025 -2954 y Fe(end-of-line)i(\(C-e\))20 b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g +3068 y Fe(end-of-line)i(\(C-e\))20 b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) -g(:)g(:)g(:)34 b Fb(17)2025 3042 y Fe(exchange-point-and-mark)d(\(C-x) +g(:)g(:)g(:)34 b Fb(17)2025 3158 y Fe(exchange-point-and-mark)d(\(C-x) 26 b(C-x\))20 b Fa(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)34 -b Fb(24)2025 3129 y(expand-tilde)19 b Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g -(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) -g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)35 b Fb(8)2021 -3373 y Fr(F)2025 3490 y Fe(fetch-history)28 b(\(\))22 -b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g -(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)36 -b Fb(19)2025 3577 y Fe(forward-backward-delete-char)c(\(\))17 +b Fb(24)2025 3248 y Fe(execute-named-command)c(\(M-x\))11 +b Fa(:)j(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) +25 b Fb(25)2025 3335 y(expand-tilde)19 b Fa(:)13 b(:)g(:)g(:)h(:)f(:)g +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) +g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)35 b +Fb(8)2021 3633 y Fr(F)2025 3757 y Fe(fetch-history)28 +b(\(\))22 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g +(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)36 +b Fb(19)2025 3847 y Fe(forward-backward-delete-char)c(\(\))17 b Fa(:)d(:)f(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)32 -b Fb(20)2025 3664 y Fe(forward-char)c(\(C-f\))16 b Fa(:)f(:)e(:)g(:)g +b Fb(20)2025 3936 y Fe(forward-char)c(\(C-f\))16 b Fa(:)f(:)e(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)g(:)g(:)31 b Fb(17)2025 3751 y Fe(forward-search-history)f +h(:)f(:)g(:)g(:)g(:)31 b Fb(17)2025 4026 y Fe(forward-search-history)f (\(C-s\))8 b Fa(:)15 b(:)e(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g -(:)g(:)g(:)23 b Fb(18)2025 3839 y Fe(forward-word)28 +(:)g(:)g(:)23 b Fb(18)2025 4113 y Fe(forward-word)28 b(\(M-f\))16 b Fa(:)f(:)e(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)31 -b Fb(17)2021 4075 y Fr(H)2025 4191 y Fb(history-preserv)n(e-p)r(oin)n +b Fb(17)2021 4403 y Fr(H)2025 4527 y Fb(history-preserv)n(e-p)r(oin)n (t)15 b Fa(:)d(:)h(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)30 b Fb(8)2025 -4278 y Fe(history-search-backward)h(\(\))13 b Fa(:)g(:)g(:)h(:)f(:)g(:) +4617 y Fe(history-search-backward)h(\(\))13 b Fa(:)g(:)g(:)h(:)f(:)g(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)28 b -Fb(18)2025 4366 y Fe(history-search-forward)i(\(\))16 +Fb(18)2025 4706 y Fe(history-search-forward)i(\(\))16 b Fa(:)e(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:) -f(:)g(:)30 b Fb(18)2025 4453 y(history-size)22 b Fa(:)13 +f(:)g(:)30 b Fb(18)2025 4796 y(history-size)22 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) -g(:)37 b Fb(8)2025 4540 y Fe(history-substring-search-backw)q(ard)32 +g(:)37 b Fb(8)2025 4886 y Fe(history-substring-search-backw)q(ard)32 b(\(\))22 b Fa(:)13 b(:)g(:)g(:)h(:)f(:)36 b Fb(19)2025 -4628 y Fe(history-substring-search-forwa)q(rd)c(\(\))7 +4976 y Fe(history-substring-search-forwa)q(rd)c(\(\))7 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)22 b Fb(19)2025 -4715 y(horizon)n(tal-scroll-mo)r(de)10 b Fa(:)15 b(:)e(:)h(:)f(:)g(:)g +5063 y(horizon)n(tal-scroll-mo)r(de)10 b Fa(:)15 b(:)e(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) -g(:)g(:)h(:)25 b Fb(8)2021 4950 y Fr(I)2025 5066 y Fb(input-meta)9 -b Fa(:)j(:)h(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:) -f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g -(:)g(:)g(:)g(:)24 b Fb(8)2025 5154 y Fe(insert-comment)29 -b(\(M-#\))11 b Fa(:)j(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)26 b Fb(24)2025 -5241 y Fe(insert-completions)j(\(M-*\))18 b Fa(:)d(:)e(:)g(:)g(:)g(:)h -(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)33 -b Fb(23)2025 5328 y(isearc)n(h-terminators)9 b Fa(:)14 -b(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h -(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)24 b Fb(8)p -eop end +g(:)g(:)h(:)25 b Fb(8)p eop end %%Page: 80 84 TeXDict begin 80 83 bop 150 -116 a Ft(F)-8 b(unction)31 b(and)f(V)-8 b(ariable)32 b(Index)2370 b(80)146 294 y -Fr(K)150 423 y Fb(k)n(eymap)14 b Fa(:)e(:)h(:)g(:)h(:)f(:)g(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)29 -b Fb(8)150 514 y Fe(kill-line)f(\(C-k\))7 b Fa(:)14 b(:)f(:)g(:)g(:)g -(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) -g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)21 b Fb(21)150 605 y -Fe(kill-region)28 b(\(\))10 b Fa(:)j(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) -g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h -(:)f(:)g(:)g(:)g(:)24 b Fb(22)150 697 y Fe(kill-whole-line)29 -b(\(\))16 b Fa(:)e(:)f(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)31 -b Fb(21)150 784 y Fe(kill-word)d(\(M-d\))7 b Fa(:)14 -b(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)21 -b Fb(21)146 1106 y Fr(M)150 1235 y Fb(mark-mo)r(di\014ed-lines)c +Fr(I)150 414 y Fb(input-meta)9 b Fa(:)j(:)h(:)g(:)g(:)g(:)h(:)f(:)g(:)g +(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) +g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)23 b Fb(8)150 +503 y Fe(insert-comment)29 b(\(M-#\))11 b Fa(:)j(:)f(:)h(:)f(:)g(:)g(:) +g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g +(:)26 b Fb(24)150 592 y Fe(insert-completions)k(\(M-*\))18 +b Fa(:)c(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) +g(:)g(:)g(:)33 b Fb(22)150 679 y(isearc)n(h-terminators)9 +b Fa(:)15 b(:)e(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g +(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)24 +b Fb(8)146 943 y Fr(K)150 1064 y Fb(k)n(eymap)14 b Fa(:)e(:)h(:)g(:)h +(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) +g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g +(:)g(:)29 b Fb(9)150 1153 y Fe(kill-line)f(\(C-k\))7 +b Fa(:)14 b(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g +(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)21 +b Fb(21)150 1241 y Fe(kill-region)28 b(\(\))10 b Fa(:)j(:)g(:)g(:)h(:)f +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) +g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)24 b Fb(21)150 1330 +y Fe(kill-whole-line)29 b(\(\))16 b Fa(:)e(:)f(:)g(:)g(:)h(:)f(:)g(:)g +(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) +g(:)31 b Fb(21)150 1417 y Fe(kill-word)d(\(M-d\))7 b +Fa(:)14 b(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g +(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)21 +b Fb(21)146 1683 y Fr(M)150 1804 y Fb(mark-mo)r(di\014ed-lines)c Fa(:)c(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)32 b Fb(9)150 -1326 y(mark-symlink)n(ed-directories)14 b Fa(:)f(:)g(:)h(:)f(:)g(:)g(:) +1892 y(mark-symlink)n(ed-directories)14 b Fa(:)f(:)g(:)h(:)f(:)g(:)g(:) g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)29 -b Fb(9)150 1417 y(matc)n(h-hidden-\014les)7 b Fa(:)12 +b Fb(9)150 1981 y(matc)n(h-hidden-\014les)7 b Fa(:)12 b(:)h(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)22 -b Fb(9)150 1509 y Fe(menu-complete)29 b(\(\))22 b Fa(:)13 +b Fb(9)150 2070 y Fe(menu-complete)29 b(\(\))22 b Fa(:)13 b(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)36 b Fb(23)150 -1600 y Fe(menu-complete-backward)31 b(\(\))16 b Fa(:)d(:)g(:)g(:)g(:)g +2158 y Fe(menu-complete-backward)31 b(\(\))16 b Fa(:)d(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)30 -b Fb(23)150 1692 y(men)n(u-complete-displa)n(y-pre\014x)10 +b Fb(23)150 2247 y(men)n(u-complete-displa)n(y-pre\014x)10 b Fa(:)h(:)j(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)25 b Fb(9)150 1779 y(meta-\015ag)d Fa(:)13 +h(:)f(:)g(:)25 b Fb(9)150 2334 y(meta-\015ag)d Fa(:)13 b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)36 b Fb(8)146 2109 y Fr(N)150 2238 y Fe(next-history)28 +h(:)f(:)g(:)36 b Fb(8)146 2608 y Fr(N)150 2729 y Fe(next-history)28 b(\(C-n\))16 b Fa(:)f(:)e(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)31 -b Fb(18)150 2329 y Fe(next-screen-line)e(\(\))14 b Fa(:)g(:)f(:)g(:)g +b Fb(18)150 2817 y Fe(next-screen-line)e(\(\))14 b Fa(:)g(:)f(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -g(:)h(:)f(:)g(:)28 b Fb(17)150 2401 y Fe(non-incremental-forward-)227 -2488 y(search-history)h(\(M-n\))7 b Fa(:)14 b(:)f(:)g(:)g(:)g(:)h(:)f +g(:)h(:)f(:)g(:)28 b Fb(17)150 2887 y Fe(non-incremental-forward-)227 +2974 y(search-history)h(\(M-n\))7 b Fa(:)14 b(:)f(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)21 -b Fb(18)150 2576 y Fe(non-incremental-reverse-)227 2663 +b Fb(18)150 3061 y Fe(non-incremental-reverse-)227 3148 y(search-history)29 b(\(M-p\))7 b Fa(:)14 b(:)f(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)21 -b Fb(18)146 3004 y Fr(O)150 3133 y Fe(operate-and-get-next)30 +b Fb(18)146 3433 y Fr(O)150 3554 y Fe(operate-and-get-next)30 b(\(C-o\))13 b Fa(:)h(:)g(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)g(:)h(:)27 b Fb(19)150 3224 y(output-meta)18 -b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g -(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) -g(:)g(:)34 b Fb(9)150 3311 y Fe(overwrite-mode)29 b(\(\))19 +(:)g(:)g(:)g(:)h(:)27 b Fb(19)150 3642 y(output-meta)17 +b Fa(:)12 b(:)h(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g +(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:) +f(:)31 b Fb(10)150 3730 y Fe(overwrite-mode)e(\(\))19 b Fa(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)33 b Fb(21)146 -3633 y Fr(P)150 3762 y Fb(page-completions)6 b Fa(:)15 +3995 y Fr(P)150 4116 y Fb(page-completions)6 b Fa(:)15 b(:)e(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)20 -b Fb(10)150 3853 y Fe(possible-completions)30 b(\(M-?\))13 +b Fb(10)150 4205 y Fe(possible-completions)30 b(\(M-?\))13 b Fa(:)h(:)g(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:) -h(:)27 b Fb(22)150 3945 y Fe(prefix-meta)h(\(ESC\))20 +h(:)27 b Fb(22)150 4293 y Fe(prefix-meta)h(\(ESC\))20 b Fa(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g -(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)33 b Fb(24)150 -4036 y Fe(previous-history)c(\(C-p\))6 b Fa(:)15 b(:)e(:)g(:)g(:)g(:)g +(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)33 b Fb(23)150 +4382 y Fe(previous-history)c(\(C-p\))6 b Fa(:)15 b(:)e(:)g(:)g(:)g(:)g (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)21 -b Fb(18)150 4128 y Fe(previous-screen-line)30 b(\(\))21 +b Fb(18)150 4471 y Fe(previous-screen-line)30 b(\(\))21 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g -(:)h(:)f(:)g(:)g(:)35 b Fb(17)150 4215 y Fe(print-last-kbd-macro)30 +(:)h(:)f(:)g(:)g(:)35 b Fb(17)150 4558 y Fe(print-last-kbd-macro)30 b(\(\))21 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)35 b Fb(23)146 4547 y -Fr(Q)150 4672 y Fe(quoted-insert)29 b(\(C-q)d(or)g(C-v\))10 +(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)35 b Fb(23)146 4834 y +Fr(Q)150 4953 y Fe(quoted-insert)29 b(\(C-q)d(or)g(C-v\))10 b Fa(:)k(:)f(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) g(:)g(:)24 b Fb(20)2021 294 y Fr(R)2025 410 y Fe(re-read-init-file)29 b(\(C-x)e(C-r\))17 b Fa(:)d(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h @@ -12274,7 +12364,7 @@ b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)34 b Fb(24)2025 935 y Fe(rl_activate_mark)15 b Fa(:)h(:)d(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)29 b Fb(45)2025 1022 y Fe(rl_add_defun)8 b Fa(:)15 +h(:)f(:)29 b Fb(46)2025 1022 y Fe(rl_add_defun)8 b Fa(:)15 b(:)f(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)22 b Fb(35)2025 1109 y Fe(rl_add_funmap_entry)7 b Fa(:)17 @@ -12282,7 +12372,7 @@ b(:)c(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)22 b Fb(39)2025 1197 y Fe(rl_add_undo)10 b Fa(:)16 b(:)d(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -g(:)h(:)f(:)g(:)g(:)g(:)25 b Fb(39)2025 1284 y Fe(rl_alphabetic)g +g(:)h(:)f(:)g(:)g(:)g(:)25 b Fb(40)2025 1284 y Fe(rl_alphabetic)g Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)37 b Fb(44)2025 1371 y Fe(rl_begin_undo_group)7 b Fa(:)17 @@ -12293,70 +12383,69 @@ Fe(rl_bind_key)10 b Fa(:)16 b(:)d(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g g(:)h(:)f(:)g(:)g(:)g(:)25 b Fb(36)2025 1546 y Fe (rl_bind_key_if_unbound)16 b Fa(:)i(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)31 -b Fb(36)2025 1633 y Fe(rl_bind_key_if_unbound_in_map)16 +b Fb(37)2025 1633 y Fe(rl_bind_key_if_unbound_in_map)16 b Fa(:)j(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)30 -b Fb(36)2025 1721 y Fe(rl_bind_key_in_map)10 b Fa(:)17 +b Fb(37)2025 1721 y Fe(rl_bind_key_in_map)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g -(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 b Fb(36)2025 1808 +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 b Fb(37)2025 1808 y Fe(rl_bind_keyseq)f Fa(:)13 b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) h(:)f(:)34 b Fb(37)2025 1896 y Fe(rl_bind_keyseq_if_unbound)9 b Fa(:)18 b(:)c(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)g(:)h(:)23 b Fb(37)2025 1983 y Fe(rl_bind_keyseq_if_unbound_in_m)q (ap)8 b Fa(:)19 b(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)23 -b Fb(37)2025 2070 y Fe(rl_bind_keyseq_in_map)h Fa(:)13 +b Fb(38)2025 2070 y Fe(rl_bind_keyseq_in_map)h Fa(:)13 b(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)g(:)34 b Fb(37)2025 2158 y Fe (rl_callback_handler_install)27 b Fa(:)13 b(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)35 b Fb(46)2025 2245 y Fe(rl_callback_handler_remove)6 b Fa(:)19 b(:)13 b(:)g(:)g(:)h(:)f(:)g -(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)21 b Fb(46)2025 +(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)21 b Fb(47)2025 2332 y Fe(rl_callback_read_char)j Fa(:)13 b(:)g(:)g(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)34 b Fb(46)2025 2420 y Fe(rl_callback_sigcleanup)16 b Fa(:)i(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)31 b Fb(46)2025 2507 y Fe(rl_check_signals)15 +(:)g(:)g(:)31 b Fb(47)2025 2507 y Fe(rl_check_signals)15 b Fa(:)h(:)d(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)29 b -Fb(52)2025 2595 y Fe(rl_cleanup_after_signal)14 b Fa(:)k(:)13 +Fb(53)2025 2595 y Fe(rl_cleanup_after_signal)14 b Fa(:)k(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)h(:)28 b Fb(52)2025 2682 y Fe(rl_clear_history)15 b Fa(:)h(:)d(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)29 b -Fb(45)2025 2769 y Fe(rl_clear_message)15 b Fa(:)h(:)d(:)g(:)h(:)f(:)g +Fb(46)2025 2769 y Fe(rl_clear_message)15 b Fa(:)h(:)d(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) -g(:)g(:)g(:)h(:)f(:)29 b Fb(40)2025 2857 y Fe(rl_clear_pending_input)16 +g(:)g(:)g(:)h(:)f(:)29 b Fb(41)2025 2857 y Fe(rl_clear_pending_input)16 b Fa(:)i(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)31 b Fb(42)2025 2944 y Fe(rl_clear_signals)15 b Fa(:)h(:)d(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)29 b Fb(53)2025 3031 y Fe(rl_clear_visible_line)24 b Fa(:)13 b(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g -(:)g(:)g(:)g(:)g(:)34 b Fb(40)2025 3119 y Fe(rl_complete)10 -b Fa(:)16 b(:)d(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) -g(:)25 b Fb(54)2025 3206 y Fe(rl_complete_internal)h -Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g -(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)36 b Fb(54)2025 3293 y -Fe(rl_completion_matches)24 b Fa(:)13 b(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)34 -b Fb(55)2025 3381 y Fe(rl_completion_mode)10 b Fa(:)17 -b(:)c(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g -(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 b Fb(55)2025 3468 -y Fe(rl_copy_keymap)f Fa(:)13 b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)34 b Fb(35)2025 3556 y Fe(rl_copy_text)8 b Fa(:)15 -b(:)f(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)22 -b Fb(41)2025 3643 y Fe(rl_crlf)g Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g -(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) -g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)35 -b Fb(40)2025 3730 y Fe(rl_deactivate_mark)10 b Fa(:)17 +(:)g(:)g(:)g(:)g(:)34 b Fb(40)2025 3119 y Fe(rl_complete)17 +b Fa(:)e(:)e(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) +g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)31 +b Fb(54,)c(55)2025 3206 y Fe(rl_complete_internal)f Fa(:)13 +b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g +(:)g(:)g(:)h(:)f(:)g(:)36 b Fb(55)2025 3293 y Fe(rl_completion_matches) +24 b Fa(:)13 b(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h +(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)34 b Fb(55)2025 3381 y +Fe(rl_completion_mode)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:) +f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 +b Fb(55)2025 3468 y Fe(rl_copy_keymap)f Fa(:)13 b(:)g(:)g(:)g(:)g(:)h +(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) +g(:)g(:)g(:)g(:)g(:)h(:)f(:)34 b Fb(35)2025 3556 y Fe(rl_copy_text)8 +b Fa(:)15 b(:)f(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g +(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:) +22 b Fb(42)2025 3643 y Fe(rl_crlf)g Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) +g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)35 +b Fb(41)2025 3730 y Fe(rl_deactivate_mark)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g -(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 b Fb(45)2025 3818 +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 b Fb(46)2025 3818 y Fe(rl_delete_text)f Fa(:)13 b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)34 b Fb(41)2025 3905 y Fe(rl_deprep_terminal)10 +h(:)f(:)34 b Fb(42)2025 3905 y Fe(rl_deprep_terminal)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 b Fb(43)2025 3992 y Fe(rl_ding)e Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g @@ -12369,14 +12458,14 @@ Fa(:)13 b(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)34 b Fb(44)2025 4255 y Fe(rl_do_undo)13 b Fa(:)i(:)e(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g -(:)h(:)27 b Fb(39)2025 4342 y Fe(rl_echo_signal_char)7 +(:)h(:)27 b Fb(40)2025 4342 y Fe(rl_echo_signal_char)7 b Fa(:)17 b(:)c(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)22 b Fb(52)2025 +(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)22 b Fb(53)2025 4429 y Fe(rl_empty_keymap)17 b Fa(:)g(:)c(:)g(:)g(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) -g(:)g(:)g(:)32 b Fb(35)2025 4517 y Fe(rl_end_undo_group)12 +g(:)g(:)g(:)32 b Fb(36)2025 4517 y Fe(rl_end_undo_group)12 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g -(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)27 b Fb(39)2025 +(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)27 b Fb(40)2025 4604 y Fe(rl_execute_next)17 b Fa(:)g(:)c(:)g(:)g(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) g(:)g(:)g(:)32 b Fb(42)2025 4691 y Fe(rl_expand_prompt)15 @@ -12392,7 +12481,7 @@ b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)26 b Fb(40)2025 5041 y Fe(rl_free)c Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:) g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)35 -b Fb(43)2025 5128 y Fe(rl_free_keymap)23 b Fa(:)13 b(:)g(:)g(:)g(:)g(:) +b Fb(44)2025 5128 y Fe(rl_free_keymap)23 b Fa(:)13 b(:)g(:)g(:)g(:)g(:) h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)34 b Fb(35)p eop end %%Page: 81 85 @@ -12402,9 +12491,9 @@ Fe(rl_free_line_state)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)24 b Fb(52)150 348 y Fe(rl_free_undo_list)12 b Fa(:)17 b(:)c(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) -g(:)g(:)g(:)g(:)h(:)26 b Fb(39)150 437 y Fe(rl_function_dumper)10 +g(:)g(:)g(:)g(:)h(:)26 b Fb(40)150 437 y Fe(rl_function_dumper)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g -(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)24 b Fb(38)150 +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)24 b Fb(39)150 525 y Fe(rl_function_of_keyseq)g Fa(:)13 b(:)g(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)33 b Fb(38)150 614 y Fe(rl_function_of_keyseq_len)9 b Fa(:)19 @@ -12414,9 +12503,9 @@ g(:)23 b Fb(38)150 702 y Fe(rl_funmap_names)17 b Fa(:)g(:)c(:)g(:)g(:)g f(:)g(:)g(:)g(:)g(:)g(:)g(:)32 b Fb(39)150 791 y Fe(rl_generic_bind)17 b Fa(:)g(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)32 -b Fb(37)150 879 y Fe(rl_get_keymap)25 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g +b Fb(38)150 879 y Fe(rl_get_keymap)25 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)37 b Fb(35)150 968 y +g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)37 b Fb(36)150 968 y Fe(rl_get_keymap_by_name)24 b Fa(:)13 b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)33 b Fb(36)150 1057 y Fe(rl_get_keymap_name)10 b Fa(:)17 @@ -12426,7 +12515,7 @@ y Fe(rl_get_screen_size)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) 24 b Fb(53)150 1234 y Fe(rl_get_termcap)f Fa(:)13 b(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) -g(:)g(:)g(:)h(:)f(:)g(:)g(:)34 b Fb(45)150 1322 y Fe(rl_getc)22 +g(:)g(:)g(:)h(:)f(:)g(:)g(:)34 b Fb(46)150 1322 y Fe(rl_getc)22 b Fa(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:) h(:)f(:)g(:)g(:)g(:)35 b Fb(42)150 1411 y Fe(rl_initialize)25 @@ -12437,19 +12526,19 @@ b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)33 b Fb(55)150 1588 y Fe(rl_insert_text)23 b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)34 -b Fb(41)150 1676 y Fe(rl_invoking_keyseqs)7 b Fa(:)17 +b Fb(42)150 1676 y Fe(rl_invoking_keyseqs)7 b Fa(:)17 b(:)d(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)21 b Fb(38)150 1765 y Fe(rl_invoking_keyseqs_in_map)7 b Fa(:)18 b(:)13 b(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)21 b Fb(38)150 +(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)21 b Fb(39)150 1853 y Fe(rl_keep_mark_active)7 b Fa(:)17 b(:)d(:)f(:)g(:)g(:)g(:)g(:)g (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) 21 b Fb(46)150 1942 y Fe(rl_kill_text)8 b Fa(:)16 b(:)d(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:) -f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)22 b Fb(41)150 +f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)22 b Fb(42)150 2030 y Fe(rl_list_funmap_names)k Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)36 -b Fb(38)150 2119 y Fe(rl_macro_bind)25 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g +b Fb(39)150 2119 y Fe(rl_macro_bind)25 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)37 b Fb(45)150 2207 y Fe(rl_macro_dumper)17 b Fa(:)g(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g @@ -12464,7 +12553,7 @@ b Fa(:)h(:)e(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:) h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)29 b Fb(46)150 2561 y Fe(rl_message)13 b Fa(:)i(:)e(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)27 b Fb(40)150 +h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)27 b Fb(41)150 2650 y Fe(rl_modifying)8 b Fa(:)16 b(:)d(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)22 b Fb(40)150 2738 y Fe(rl_named_function) @@ -12477,163 +12566,168 @@ g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)21 b Fb(40)150 3004 y Fe(rl_parse_and_bind)12 b Fa(:)17 b(:)c(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) -g(:)h(:)26 b Fb(37)150 3092 y Fe(rl_pending_signal)12 +g(:)h(:)26 b Fb(38)150 3092 y Fe(rl_pending_signal)12 b Fa(:)17 b(:)c(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)26 b Fb(52)150 3181 y Fe(rl_possible_completions)14 b Fa(:)k(:)13 b(:)h(:)f(:)g(:)g(:) g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)28 b Fb(55)150 3269 y Fe(rl_prep_terminal)15 b Fa(:)h(:)e(:)f(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -g(:)h(:)f(:)g(:)g(:)29 b Fb(43)150 3358 y Fe(rl_push_macro_input)7 +g(:)h(:)f(:)g(:)g(:)29 b Fb(43)150 3358 y Fe(rl_print_keybinding)7 b Fa(:)17 b(:)d(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g -(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)21 b Fb(41)150 -3446 y Fe(rl_read_init_file)12 b Fa(:)17 b(:)c(:)g(:)h(:)f(:)g(:)g(:)g +(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)21 b Fb(39)150 +3446 y Fe(rl_push_macro_input)7 b Fa(:)17 b(:)d(:)f(:)g(:)g(:)g(:)g(:)g +(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) +21 b Fb(42)150 3535 y Fe(rl_read_init_file)12 b Fa(:)17 +b(:)c(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g +(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)26 b Fb(38)150 +3623 y Fe(rl_read_key)10 b Fa(:)16 b(:)d(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) +g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g +(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)25 b Fb(42)150 3712 y +Fe(rl_redisplay)8 b Fa(:)16 b(:)d(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) -g(:)h(:)26 b Fb(38)150 3535 y Fe(rl_read_key)10 b Fa(:)16 -b(:)d(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)25 -b Fb(42)150 3623 y Fe(rl_redisplay)8 b Fa(:)16 b(:)d(:)g(:)g(:)g(:)g(:) -g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)22 b Fb(40)150 -3712 y Fe(rl_replace_line)17 b Fa(:)g(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g +g(:)g(:)h(:)f(:)g(:)22 b Fb(40)150 3801 y Fe(rl_reparse_colors)12 +b Fa(:)17 b(:)c(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g +(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)26 b Fb(46)150 +3889 y Fe(rl_replace_line)17 b Fa(:)g(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) -g(:)g(:)g(:)32 b Fb(43)150 3801 y Fe(rl_reset_after_signal)24 +g(:)g(:)g(:)32 b Fb(44)150 3978 y Fe(rl_reset_after_signal)24 b Fa(:)13 b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g -(:)g(:)g(:)g(:)g(:)h(:)f(:)33 b Fb(52)150 3889 y Fe +(:)g(:)g(:)g(:)g(:)h(:)f(:)33 b Fb(53)150 4066 y Fe (rl_reset_line_state)7 b Fa(:)17 b(:)d(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)21 -b Fb(40)150 3978 y Fe(rl_reset_screen_size)26 b Fa(:)13 +b Fb(40)150 4155 y Fe(rl_reset_screen_size)26 b Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g -(:)h(:)f(:)g(:)g(:)g(:)36 b Fb(53)150 4066 y Fe(rl_reset_terminal)12 +(:)h(:)f(:)g(:)g(:)g(:)36 b Fb(53)150 4243 y Fe(rl_reset_terminal)12 b Fa(:)17 b(:)c(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)26 b Fb(43)150 -4155 y Fe(rl_resize_terminal)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)h(:)f +(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)26 b Fb(44)150 +4332 y Fe(rl_resize_terminal)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) -g(:)24 b Fb(53)150 4243 y Fe(rl_restore_prompt)12 b Fa(:)17 +g(:)24 b Fb(53)150 4420 y Fe(rl_restore_prompt)12 b Fa(:)17 b(:)c(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)26 b Fb(41)150 -4332 y Fe(rl_restore_state)15 b Fa(:)h(:)e(:)f(:)g(:)g(:)g(:)g(:)g(:)h +4509 y Fe(rl_restore_state)15 b Fa(:)h(:)e(:)f(:)g(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) -g(:)g(:)29 b Fb(43)150 4420 y Fe(rl_save_prompt)23 b +g(:)g(:)29 b Fb(44)150 4597 y Fe(rl_save_prompt)23 b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)34 -b Fb(41)150 4509 y Fe(rl_save_state)25 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g +b Fb(41)150 4686 y Fe(rl_save_state)25 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) -g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)37 b Fb(43)150 4597 y +g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)37 b Fb(44)150 4774 y Fe(rl_set_key)13 b Fa(:)i(:)e(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) -g(:)g(:)g(:)h(:)f(:)g(:)27 b Fb(37)150 4686 y Fe +g(:)g(:)g(:)h(:)f(:)g(:)27 b Fb(37)150 4863 y Fe (rl_set_keyboard_input_timeout)17 b Fa(:)h(:)c(:)f(:)g(:)g(:)g(:)g(:)g -(:)g(:)h(:)f(:)g(:)g(:)30 b Fb(42)150 4774 y Fe(rl_set_keymap)25 +(:)g(:)h(:)f(:)g(:)g(:)30 b Fb(43)150 4951 y Fe(rl_set_keymap)25 b Fa(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)37 -b Fb(35)150 4863 y Fe(rl_set_keymap_name)10 b Fa(:)17 +b Fb(36)150 5040 y Fe(rl_set_keymap_name)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)24 b Fb(36)150 4951 +(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)24 b Fb(36)150 5128 y Fe(rl_set_paren_blink_timeout)7 b Fa(:)18 b(:)13 b(:)h(:)f(:)g(:)g(:) -g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)21 b Fb(45)150 -5040 y Fe(rl_set_prompt)k Fa(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h -(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) -g(:)g(:)g(:)g(:)37 b Fb(41)150 5128 y Fe(rl_set_screen_size)10 -b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g -(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)24 b Fb(53)2025 -260 y Fe(rl_set_signals)f Fa(:)13 b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g +g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)21 b Fb(45)2025 +260 y Fe(rl_set_prompt)k Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g +(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:) +f(:)g(:)g(:)g(:)37 b Fb(41)2025 348 y Fe(rl_set_screen_size)10 +b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h +(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 b Fb(53)2025 +436 y Fe(rl_set_signals)f Fa(:)13 b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:) -g(:)h(:)f(:)34 b Fb(53)2025 349 y Fe(rl_set_timeout)23 +g(:)h(:)f(:)34 b Fb(53)2025 524 y Fe(rl_set_timeout)23 b Fa(:)13 b(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)34 -b Fb(42)2025 438 y Fe(rl_show_char)8 b Fa(:)15 b(:)f(:)f(:)g(:)g(:)g(:) +b Fb(43)2025 612 y Fe(rl_show_char)8 b Fa(:)15 b(:)f(:)f(:)g(:)g(:)g(:) g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g -(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)22 b Fb(40)2025 -527 y Fe(rl_stuff_char)j Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g +(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)22 b Fb(41)2025 +700 y Fe(rl_stuff_char)j Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:) -f(:)g(:)g(:)g(:)37 b Fb(42)2025 615 y Fe(rl_timeout_remaining)26 +f(:)g(:)g(:)g(:)37 b Fb(42)2025 789 y Fe(rl_timeout_remaining)26 b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g -(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)36 b Fb(42)2025 704 y +(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)36 b Fb(43)2025 877 y Fe(rl_trim_arg_from_keyseq)14 b Fa(:)k(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)28 -b Fb(38)2025 793 y Fe(rl_tty_set_default_bindings)f Fa(:)13 +b Fb(38)2025 965 y Fe(rl_tty_set_default_bindings)f Fa(:)13 b(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)35 -b Fb(43)2025 882 y Fe(rl_tty_set_echoing)10 b Fa(:)17 +b Fb(43)2025 1053 y Fe(rl_tty_set_echoing)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g -(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 b Fb(43)2025 971 +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 b Fb(43)2025 1141 y Fe(rl_tty_unset_default_bindings)16 b Fa(:)j(:)13 b(:)g(:)h(:)f(:)g -(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)30 b Fb(43)2025 1060 y +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)30 b Fb(43)2025 1229 y Fe(rl_unbind_command_in_map)11 b Fa(:)19 b(:)13 b(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)26 -b Fb(37)2025 1149 y Fe(rl_unbind_function_in_map)9 b +b Fb(37)2025 1317 y Fe(rl_unbind_function_in_map)9 b Fa(:)18 b(:)c(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g -(:)g(:)h(:)23 b Fb(37)2025 1238 y Fe(rl_unbind_key)i +(:)g(:)h(:)23 b Fb(37)2025 1405 y Fe(rl_unbind_key)i Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)37 -b Fb(37)2025 1326 y Fe(rl_unbind_key_in_map)26 b Fa(:)13 +b Fb(37)2025 1494 y Fe(rl_unbind_key_in_map)26 b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)36 b Fb(37)2025 1415 y Fe +(:)g(:)g(:)h(:)f(:)g(:)36 b Fb(37)2025 1582 y Fe (rl_username_completion_functio)q(n)11 b Fa(:)19 b(:)13 -b(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)25 b Fb(55)2025 -1504 y Fe(rl_variable_bind)15 b Fa(:)h(:)d(:)g(:)h(:)f(:)g(:)g(:)g(:)g +b(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)25 b Fb(56)2025 +1670 y Fe(rl_variable_bind)15 b Fa(:)h(:)d(:)g(:)h(:)f(:)g(:)g(:)g(:)g (:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:) -h(:)f(:)29 b Fb(45)2025 1593 y Fe(rl_variable_dumper)10 +h(:)f(:)29 b Fb(45)2025 1758 y Fe(rl_variable_dumper)10 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)24 b Fb(45)2025 -1680 y Fe(rl_variable_value)12 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)h(:)f(:)g +1845 y Fe(rl_variable_value)12 b Fa(:)17 b(:)c(:)g(:)g(:)g(:)h(:)f(:)g (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) -g(:)g(:)27 b Fb(45)2021 1951 y Fr(S)2025 2072 y Fe(self-insert)h(\(a,)e -(b,)g(A,)g(1,)g(!,)g(...)q(\))15 b Fa(:)e(:)g(:)g(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)29 b Fb(20)2025 2161 y Fe(set-mark)e(\(C-@\))10 -b Fa(:)k(:)f(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) -g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)24 -b Fb(24)2025 2250 y Fe(shell-transpose-words)30 b(\(M-C-t\))24 -b Fa(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)37 -b Fb(21)2025 2339 y(sho)n(w-all-if-am)n(biguous)18 b -Fa(:)d(:)e(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f -(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)32 b Fb(10)2025 2428 -y(sho)n(w-all-if-unmo)r(di\014ed)9 b Fa(:)14 b(:)f(:)g(:)g(:)g(:)h(:)f +g(:)g(:)27 b Fb(45)2021 2100 y Fr(S)2025 2219 y Fb(searc)n +(h-ignore-case)11 b Fa(:)k(:)e(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g +(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:) +26 b Fb(10)2025 2307 y Fe(self-insert)i(\(a,)e(b,)g(A,)g(1,)g(!,)g(...) +q(\))15 b Fa(:)e(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)29 +b Fb(20)2025 2395 y Fe(set-mark)e(\(C-@\))10 b Fa(:)k(:)f(:)g(:)g(:)h +(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) +g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)24 b Fb(24)2025 2483 +y(sho)n(w-all-if-am)n(biguous)18 b Fa(:)d(:)e(:)g(:)g(:)g(:)g(:)g(:)h +(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) +32 b Fb(10)2025 2571 y(sho)n(w-all-if-unmo)r(di\014ed)9 +b Fa(:)14 b(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g +(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)24 b Fb(10)2025 +2660 y(sho)n(w-mo)r(de-in-prompt)12 b Fa(:)h(:)g(:)g(:)g(:)g(:)g(:)h(:) +f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g +(:)27 b Fb(10)2025 2748 y(skip-completed-text)15 b Fa(:)c(:)i(:)h(:)f (:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:) -g(:)24 b Fb(10)2025 2517 y(sho)n(w-mo)r(de-in-prompt)12 -b Fa(:)h(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) -g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)27 b Fb(10)2025 2606 -y(skip-completed-text)15 b Fa(:)c(:)i(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h -(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:) -29 b Fb(10)2025 2695 y Fe(skip-csi-sequence)g(\(\))11 -b Fa(:)j(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) -g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)26 b Fb(24)2025 2782 -y Fe(start-kbd-macro)j(\(C-x)d(\(\))10 b Fa(:)k(:)f(:)h(:)f(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)25 -b Fb(23)2021 3052 y Fr(T)2025 3173 y Fe(tab-insert)j(\(M-TAB\))16 +g(:)g(:)g(:)h(:)f(:)g(:)29 b Fb(10)2025 2836 y Fe(skip-csi-sequence)g +(\(\))11 b Fa(:)j(:)f(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)26 b Fb(24)2025 +2923 y Fe(start-kbd-macro)j(\(C-x)d(\(\))10 b Fa(:)k(:)f(:)h(:)f(:)g(:) +g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)25 +b Fb(23)2021 3177 y Fr(T)2025 3296 y Fe(tab-insert)j(\(M-TAB\))16 b Fa(:)f(:)e(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)31 b Fb(20)2025 -3262 y Fe(tilde-expand)d(\(M-~\))16 b Fa(:)f(:)e(:)g(:)g(:)g(:)g(:)h(:) +3384 y Fe(tilde-expand)d(\(M-~\))16 b Fa(:)f(:)e(:)g(:)g(:)g(:)g(:)h(:) f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g -(:)g(:)31 b Fb(24)2025 3351 y Fe(transpose-chars)e(\(C-t\))9 +(:)g(:)31 b Fb(24)2025 3472 y Fe(transpose-chars)e(\(C-t\))9 b Fa(:)14 b(:)f(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g -(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)23 b Fb(20)2025 3438 y +(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)23 b Fb(20)2025 3559 y Fe(transpose-words)29 b(\(M-t\))9 b Fa(:)14 b(:)f(:)g(:)g(:)g(:)g(:)h (:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)23 -b Fb(20)2021 3718 y Fr(U)2025 3839 y Fe(undo)j(\(C-_)h(or)f(C-x)g +b Fb(20)2021 3823 y Fr(U)2025 3942 y Fe(undo)j(\(C-_)h(or)f(C-x)g (C-u\))12 b Fa(:)i(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)27 b Fb(24)2025 -3928 y Fe(universal-argument)i(\(\))9 b Fa(:)14 b(:)f(:)g(:)g(:)g(:)g +4030 y Fe(universal-argument)i(\(\))9 b Fa(:)14 b(:)f(:)g(:)g(:)g(:)g (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) -23 b Fb(22)2025 4017 y Fe(unix-filename-rubout)30 b(\(\))21 +23 b Fb(22)2025 4118 y Fe(unix-filename-rubout)30 b(\(\))21 b Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g -(:)g(:)g(:)h(:)f(:)35 b Fb(21)2025 4106 y Fe(unix-line-discard)29 +(:)g(:)g(:)h(:)f(:)35 b Fb(21)2025 4207 y Fe(unix-line-discard)29 b(\(C-u\))22 b Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:) -g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)35 b Fb(21)2025 4195 +g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)35 b Fb(21)2025 4295 y Fe(unix-word-rubout)29 b(\(C-w\))6 b Fa(:)14 b(:)g(:)f(:)g(:)g(:)g(:) g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)21 -b Fb(21)2025 4282 y Fe(upcase-word)28 b(\(M-u\))20 b +b Fb(21)2025 4382 y Fe(upcase-word)28 b(\(M-u\))20 b Fa(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)34 b Fb(20)2021 -4562 y Fr(V)2025 4683 y Fb(vi-cmd-mo)r(de-string)18 b +4646 y Fr(V)2025 4765 y Fb(vi-cmd-mo)r(de-string)18 b Fa(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g (:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)33 b Fb(11)2025 -4772 y Fe(vi-editing-mode)c(\(M-C-j\))22 b Fa(:)13 b(:)g(:)g(:)h(:)f(:) +4853 y Fe(vi-editing-mode)c(\(M-C-j\))22 b Fa(:)13 b(:)g(:)g(:)h(:)f(:) g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)35 -b Fb(25)2025 4861 y(vi-ins-mo)r(de-string)8 b Fa(:)13 +b Fb(25)2025 4941 y(vi-ins-mo)r(de-string)8 b Fa(:)13 b(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g (:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)23 b Fb(11)2025 -4948 y(visible-stats)11 b Fa(:)j(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) +5028 y(visible-stats)11 b Fa(:)j(:)f(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:) g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g (:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)26 b Fb(11)p eop end %%Page: 82 86 |