removed some commented-out code dependent on the compatibility level now that the version is 5.2

This commit is contained in:
Chet Ramey
2021-11-22 10:11:06 -05:00
parent e59452c752
commit 25e43d2c0a
27 changed files with 5088 additions and 5001 deletions
+148 -144
View File
@@ -1,7 +1,7 @@
%!PS-Adobe-2.0
%%Creator: dvips(k) 2021.1 Copyright 2021 Radical Eye Software
%%Title: bashref.dvi
%%CreationDate: Mon Nov 8 16:14:08 2021
%%CreationDate: Tue Nov 16 15:03:04 2021
%%Pages: 193
%%PageOrder: Ascend
%%BoundingBox: 0 0 612 792
@@ -12,7 +12,7 @@
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi
%DVIPSParameters: dpi=600
%DVIPSSource: TeX output 2021.11.08:1114
%DVIPSSource: TeX output 2021.11.16:1003
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -7614,22 +7614,22 @@ ifelse
TeXDict begin 1 0 bop 150 1318 a Fv(Bash)64 b(Reference)j(Man)-5
b(ual)p 150 1385 3600 34 v 2361 1481 a Fu(Reference)31
b(Do)s(cumen)m(tation)i(for)d(Bash)2428 1589 y(Edition)h(5.1,)g(for)f
Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.1.)3217 1697 y(Octob)s(er)f(2021)150
4927 y Fs(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
Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.1.)3139 1697 y(No)m(v)m(em)m(b)s(er)g
(2021)150 4927 y Fs(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 4279 a Fu(This)35 b(text)h(is)g(a)g(brief)f
(description)h(of)f(the)h(features)g(that)g(are)g(presen)m(t)g(in)f
(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(5.1,)c(25)f(Octob)s(er)f
(2021\).)150 4523 y(This)35 b(is)g(Edition)h(5.1,)i(last)f(up)s(dated)d
(25)i(Octob)s(er)g(2021,)j(of)c Fr(The)h(GNU)g(Bash)f(Reference)i(Man)m
(ual)p Fu(,)150 4633 y(for)30 b Ft(Bash)p Fu(,)g(V)-8
b(ersion)31 b(5.1.)150 4767 y(Cop)m(yrigh)m(t)602 4764
y(c)577 4767 y Fq(\015)f Fu(1988{2021)35 b(F)-8 b(ree)31
b(Soft)m(w)m(are)h(F)-8 b(oundation,)31 b(Inc.)390 4902
y(P)m(ermission)21 b(is)f(gran)m(ted)h(to)g(cop)m(y)-8
(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(5.1,)c(16)f(No)m(v)m(em)m
(b)s(er)g(2021\).)150 4523 y(This)e(is)i(Edition)f(5.1,)h(last)g(up)s
(dated)e(16)i(No)m(v)m(em)m(b)s(er)h(2021,)g(of)e Fr(The)g(GNU)h(Bash)f
(Reference)h(Man)m(ual)p Fu(,)150 4633 y(for)f Ft(Bash)p
Fu(,)g(V)-8 b(ersion)31 b(5.1.)150 4767 y(Cop)m(yrigh)m(t)602
4764 y(c)577 4767 y Fq(\015)f Fu(1988{2021)35 b(F)-8
b(ree)31 b(Soft)m(w)m(are)h(F)-8 b(oundation,)31 b(Inc.)390
4902 y(P)m(ermission)21 b(is)f(gran)m(ted)h(to)g(cop)m(y)-8
b(,)24 b(distribute)c(and/or)h(mo)s(dify)e(this)i(do)s(cumen)m(t)f
(under)f(the)390 5011 y(terms)25 b(of)h(the)f(GNU)h(F)-8
b(ree)27 b(Do)s(cumen)m(tation)g(License,)g(V)-8 b(ersion)26
@@ -13019,10 +13019,10 @@ b Ft(set)35 b Fu(allo)m(ws)j(y)m(ou)e(to)h(c)m(hange)150
777 y(the)c(v)-5 b(alues)34 b(of)f(shell)g(options)h(and)e(set)i(the)f
(p)s(ositional)h(parameters,)h(or)e(to)h(displa)m(y)f(the)g(names)h
(and)150 886 y(v)-5 b(alues)31 b(of)f(shell)h(v)-5 b(ariables.)150
1041 y Ft(set)870 1172 y(set)47 b([--abefhkmnptuvxBCEHPT])41
b([-o)47 b Fj(option-name)p Ft(])e([)p Fj(argument)g
1041 y Ft(set)870 1172 y(set)47 b([-abefhkmnptuvxBCEHPT])42
b([-o)47 b Fj(option-name)p Ft(])d([--])j([-])g([)p Fj(argument)e
Ft(...)o(])870 1282 y(set)i([+abefhkmnptuvxBCEHPT])42
b([+o)47 b Fj(option-name)p Ft(])d([)p Fj(argument)h
b([+o)47 b Fj(option-name)p Ft(])d([--])j([-])g([)p Fj(argument)e
Ft(...)o(])630 1414 y Fu(If)22 b(no)h(options)g(or)g(argumen)m(ts)g
(are)g(supplied,)g Ft(set)f Fu(displa)m(ys)g(the)h(names)g(and)f(v)-5
b(alues)23 b(of)g(all)630 1523 y(shell)j(v)-5 b(ariables)27
@@ -16895,197 +16895,201 @@ eop end
%%Page: 119 125
TeXDict begin 119 124 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(119)870 299 y Ft(set)47
b Fj(variable)e(value)630 436 y Fu(Here,)29 b(for)e(example,)h(is)g(ho)
b Fj(variable)e(value)630 439 y Fu(Here,)29 b(for)e(example,)h(is)g(ho)
m(w)f(to)h(c)m(hange)g(from)f(the)g(default)h(Emacs-lik)m(e)h(k)m(ey)f
(binding)e(to)630 545 y(use)k Ft(vi)g Fu(line)h(editing)g(commands:)870
682 y Ft(set)47 b(editing-mode)d(vi)630 819 y Fu(V)-8
(binding)e(to)630 548 y(use)k Ft(vi)g Fu(line)h(editing)g(commands:)870
689 y Ft(set)47 b(editing-mode)d(vi)630 829 y Fu(V)-8
b(ariable)36 b(names)f(and)g(v)-5 b(alues,)36 b(where)f(appropriate,)h
(are)g(recognized)g(without)f(regard)630 929 y(to)c(case.)42
(are)g(recognized)g(without)f(regard)630 938 y(to)c(case.)42
b(Unrecognized)31 b(v)-5 b(ariable)31 b(names)g(are)f(ignored.)630
1066 y(Bo)s(olean)c(v)-5 b(ariables)26 b(\(those)g(that)g(can)f(b)s(e)f
1078 y(Bo)s(olean)c(v)-5 b(ariables)26 b(\(those)g(that)g(can)f(b)s(e)f
(set)i(to)g(on)f(or)g(o\013)7 b(\))25 b(are)h(set)f(to)h(on)f(if)g(the)
g(v)-5 b(alue)26 b(is)630 1176 y(n)m(ull)e(or)g(empt)m(y)-8
g(v)-5 b(alue)26 b(is)630 1188 y(n)m(ull)e(or)g(empt)m(y)-8
b(,)27 b Fr(on)d Fu(\(case-insensitiv)m(e\),)29 b(or)24
b(1.)39 b(An)m(y)25 b(other)f(v)-5 b(alue)25 b(results)f(in)g(the)g(v)
-5 b(ariable)630 1285 y(b)s(eing)30 b(set)h(to)g(o\013.)630
1422 y(The)37 b Ft(bind)30 b(-V)37 b Fu(command)g(lists)i(the)f(curren)
-5 b(ariable)630 1297 y(b)s(eing)30 b(set)h(to)g(o\013.)630
1437 y(The)37 b Ft(bind)30 b(-V)37 b Fu(command)g(lists)i(the)f(curren)
m(t)f(Readline)i(v)-5 b(ariable)38 b(names)g(and)f(v)-5
b(alues.)630 1532 y(See)31 b(Section)g(4.2)g([Bash)g(Builtins],)g(page)
g(54.)630 1669 y(A)f(great)i(deal)f(of)g(run-time)f(b)s(eha)m(vior)g
b(alues.)630 1547 y(See)31 b(Section)g(4.2)g([Bash)g(Builtins],)g(page)
g(54.)630 1687 y(A)f(great)i(deal)f(of)g(run-time)f(b)s(eha)m(vior)g
(is)g(c)m(hangeable)j(with)d(the)g(follo)m(wing)i(v)-5
b(ariables.)630 1833 y Ft(bell-style)1110 1943 y Fu(Con)m(trols)44
b(ariables.)630 1857 y Ft(bell-style)1110 1967 y Fu(Con)m(trols)44
b(what)g(happ)s(ens)e(when)h(Readline)i(w)m(an)m(ts)f(to)h(ring)e(the)h
(termi-)1110 2052 y(nal)37 b(b)s(ell.)61 b(If)37 b(set)h(to)g(`)p
(termi-)1110 2077 y(nal)37 b(b)s(ell.)61 b(If)37 b(set)h(to)g(`)p
Ft(none)p Fu(',)g(Readline)g(nev)m(er)g(rings)e(the)i(b)s(ell.)61
b(If)36 b(set)i(to)1110 2162 y(`)p Ft(visible)p Fu(',)32
b(If)36 b(set)i(to)1110 2186 y(`)p Ft(visible)p Fu(',)32
b(Readline)i(uses)f(a)g(visible)g(b)s(ell)g(if)g(one)g(is)g(a)m(v)-5
b(ailable.)51 b(If)33 b(set)g(to)1110 2271 y(`)p Ft(audible)p
b(ailable.)51 b(If)33 b(set)g(to)1110 2296 y(`)p Ft(audible)p
Fu(')j(\(the)i(default\),)i(Readline)e(attempts)g(to)h(ring)e(the)g
(terminal's)1110 2381 y(b)s(ell.)630 2545 y Ft(bind-tty-special-chars)
1110 2655 y Fu(If)e(set)g(to)h(`)p Ft(on)p Fu(')f(\(the)g(default\),)i
(terminal's)1110 2405 y(b)s(ell.)630 2576 y Ft(bind-tty-special-chars)
1110 2685 y Fu(If)e(set)g(to)h(`)p Ft(on)p Fu(')f(\(the)g(default\),)i
(Readline)f(attempts)g(to)g(bind)d(the)i(con)m(trol)1110
2765 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 2874
y(Readline)h(equiv)-5 b(alen)m(ts.)630 3039 y Ft(blink-matching-paren)
1110 3148 y Fu(If)36 b(set)g(to)h(`)p Ft(on)p Fu(',)h(Readline)f
2795 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 2905
y(Readline)h(equiv)-5 b(alen)m(ts.)630 3075 y Ft(blink-matching-paren)
1110 3185 y Fu(If)36 b(set)g(to)h(`)p Ft(on)p Fu(',)h(Readline)f
(attempts)g(to)g(brie\015y)e(mo)m(v)m(e)j(the)f(cursor)e(to)i(an)1110
3258 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 3367 y(default)31
b(is)f(`)p Ft(off)p Fu('.)630 3532 y Ft(colored-completion-prefi)o(x)
1110 3641 y Fu(If)f(set)h(to)g(`)p Ft(on)p Fu(',)g(when)e(listing)i
3294 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 3404 y(default)31
b(is)f(`)p Ft(off)p Fu('.)630 3574 y Ft(colored-completion-prefi)o(x)
1110 3684 y Fu(If)f(set)h(to)g(`)p Ft(on)p Fu(',)g(when)e(listing)i
(completions,)h(Readline)f(displa)m(ys)g(the)f(com-)1110
3751 y(mon)c(pre\014x)f(of)i(the)f(set)h(of)g(p)s(ossible)f
3794 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
3861 y(The)39 b(color)i(de\014nitions)f(are)g(tak)m(en)h(from)f(the)g
(v)-5 b(alue)40 b(of)g(the)g Ft(LS_COLORS)1110 3970 y
Fu(en)m(vironmen)m(t)31 b(v)-5 b(ariable.)41 b(The)30
b(default)h(is)f(`)p Ft(off)p Fu('.)630 4134 y Ft(colored-stats)1110
4244 y Fu(If)c(set)h(to)g(`)p Ft(on)p Fu(',)h(Readline)f(displa)m(ys)g
(p)s(ossible)f(completions)h(using)f(di\013eren)m(t)1110
4354 y(colors)40 b(to)g(indicate)g(their)f(\014le)h(t)m(yp)s(e.)67
3903 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 Ft(LS_COLORS)e Fu(en-)1110 4013
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 Ft(LS_COLORS)e Fu(for)1110
4122 y(the)22 b(custom)g(su\016x)f(`)p Ft(readline-colored-complet)o
(ion)o(-pre)o(fix)p Fu(',)c(Read-)1110 4232 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 4341 y(default)31 b(is)f(`)p
Ft(off)p Fu('.)630 4512 y Ft(colored-stats)1110 4622
y Fu(If)c(set)h(to)g(`)p Ft(on)p Fu(',)h(Readline)f(displa)m(ys)g(p)s
(ossible)f(completions)h(using)f(di\013eren)m(t)1110
4731 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
4463 y(from)24 b(the)h(v)-5 b(alue)25 b(of)g(the)g Ft(LS_COLORS)d
4841 y(from)24 b(the)h(v)-5 b(alue)25 b(of)g(the)g Ft(LS_COLORS)d
Fu(en)m(vironmen)m(t)j(v)-5 b(ariable.)40 b(The)24 b(default)1110
4573 y(is)30 b(`)p Ft(off)p Fu('.)630 4737 y Ft(comment-begin)1110
4847 y Fu(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 4956 y Ft(insert-comment)26
4950 y(is)30 b(`)p Ft(off)p Fu('.)630 5121 y Ft(comment-begin)1110
5230 y Fu(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 5340 y Ft(insert-comment)26
b Fu(command)31 b(is)f(executed.)42 b(The)30 b(default)g(v)-5
b(alue)31 b(is)f Ft("#")p Fu(.)630 5121 y Ft(completion-display-width)
1110 5230 y Fu(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 5340
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)p
eop end
b(alue)31 b(is)f Ft("#")p Fu(.)p eop end
%%Page: 120 126
TeXDict begin 120 125 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(120)1110 299 y(0)27
b(or)f(greater)h(than)f(the)g(terminal)h(screen)f(width.)39
b(Command)29 b(Line)i(Editing)2062 b(120)630 299 y Ft
(completion-display-width)1110 408 y Fu(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 518 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
628 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
408 y(matc)m(hes)32 b(to)f(b)s(e)e(displa)m(y)m(ed)i(one)g(p)s(er)e
737 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
573 y Ft(completion-ignore-case)1110 682 y Fu(If)d(set)h(to)g(`)p
888 y Ft(completion-ignore-case)1110 998 y Fu(If)d(set)h(to)g(`)p
Ft(on)p Fu(',)g(Readline)g(p)s(erforms)e(\014lename)h(matc)m(hing)i
(and)e(completion)1110 792 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 Ft(off)p
Fu('.)630 956 y Ft(completion-map-case)1110 1066 y Fu(If)22
(and)e(completion)1110 1107 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 Ft(off)p
Fu('.)630 1258 y Ft(completion-map-case)1110 1367 y Fu(If)22
b(set)g(to)h(`)p Ft(on)p Fu(',)h(and)e Fr(completion-ignore-case)31
b Fu(is)22 b(enabled,)i(Readline)f(treats)1110 1176 y(h)m(yphens)29
b Fu(is)22 b(enabled,)i(Readline)f(treats)1110 1477 y(h)m(yphens)29
b(\(`)p Ft(-)p Fu('\))j(and)e(underscores)g(\(`)p Ft(_)p
Fu('\))i(as)f(equiv)-5 b(alen)m(t)32 b(when)e(p)s(erforming)1110
1285 y(case-insensitiv)m(e)47 b(\014lename)e(matc)m(hing)g(and)f
(completion.)85 b(The)44 b(default)1110 1395 y(v)-5 b(alue)31
b(is)f(`)p Ft(off)p Fu('.)630 1559 y Ft(completion-prefix-displa)o
(y-le)o(ngth)1110 1669 y Fu(The)h(length)g(in)g(c)m(haracters)i(of)f
1587 y(case-insensitiv)m(e)47 b(\014lename)e(matc)m(hing)g(and)f
(completion.)85 b(The)44 b(default)1110 1696 y(v)-5 b(alue)31
b(is)f(`)p Ft(off)p Fu('.)630 1847 y Ft(completion-prefix-displa)o
(y-le)o(ngth)1110 1956 y Fu(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
1778 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 1888
2066 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 2176
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 1998
(longer)j(than)e(this)g(v)-5 b(alue)27 b(are)1110 2285
y(replaced)k(with)f(an)g(ellipsis)h(when)e(displa)m(ying)i(p)s(ossible)
f(completions.)630 2162 y Ft(completion-query-items)1110
2271 y Fu(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 2381 y(is)43
f(completions.)630 2436 y Ft(completion-query-items)1110
2545 y Fu(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 2655 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 2491 y(the)29 b(n)m(um)m(b)s(er)f
s(e)g(displa)m(y)m(ed.)77 b(If)1110 2765 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 2600 y(v)-5 b(alue,)45 b(Readline)e(will)f(ask)g
(to)h(this)1110 2874 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
2710 y(them;)33 b(otherwise,)f(they)g(are)g(simply)g(listed.)45
2984 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
2819 y(to)43 b(an)e(in)m(teger)j(v)-5 b(alue)42 b(greater)h(than)f(or)g
3093 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
2929 y(means)40 b(Readline)h(should)f(nev)m(er)g(ask;)46
3203 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
3039 y(zero.)g(The)29 b(default)i(limit)g(is)g Ft(100)p
Fu(.)630 3203 y Ft(convert-meta)1110 3313 y Fu(If)22
3313 y(zero.)g(The)29 b(default)i(limit)g(is)g Ft(100)p
Fu(.)630 3463 y Ft(convert-meta)1110 3573 y Fu(If)22
b(set)g(to)h(`)p Ft(on)p Fu(',)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
3422 y(to)33 b(an)e Fm(asci)r(i)h Fu(k)m(ey)h(sequence)f(b)m(y)g
3682 y(to)33 b(an)e Fm(asci)r(i)h Fu(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
3532 y(an)24 b Ft(ESC)g Fu(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 3641
3792 y(an)24 b Ft(ESC)g Fu(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 3902
y(The)i(default)h(v)-5 b(alue)28 b(is)f(`)p Ft(on)p Fu(',)i(but)d(will)
i(b)s(e)f(set)h(to)g(`)p Ft(off)p Fu(')g(if)f(the)h(lo)s(cale)h(is)f
(one)1110 3751 y(that)j(con)m(tains)h(eigh)m(t-bit)g(c)m(haracters.)630
3915 y Ft(disable-completion)1110 4025 y Fu(If)k(set)h(to)h(`)p
(one)1110 4011 y(that)j(con)m(tains)h(eigh)m(t-bit)g(c)m(haracters.)630
4162 y Ft(disable-completion)1110 4271 y Fu(If)k(set)h(to)h(`)p
Ft(On)p Fu(',)g(Readline)f(will)g(inhibit)f(w)m(ord)h(completion.)60
b(Completion)1110 4134 y(c)m(haracters)28 b(will)e(b)s(e)f(inserted)h
b(Completion)1110 4381 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
4244 y(to)31 b Ft(self-insert)p Fu(.)38 b(The)30 b(default)g(is)h(`)p
Ft(off)p Fu('.)630 4408 y Ft(echo-control-characters)1110
4518 y Fu(When)f(set)h(to)g(`)p Ft(on)p Fu(',)f(on)g(op)s(erating)h
(systems)f(that)h(indicate)g(they)g(supp)s(ort)1110 4628
4491 y(to)31 b Ft(self-insert)p Fu(.)38 b(The)30 b(default)g(is)h(`)p
Ft(off)p Fu('.)630 4641 y Ft(echo-control-characters)1110
4751 y Fu(When)f(set)h(to)g(`)p Ft(on)p Fu(',)f(on)g(op)s(erating)h
(systems)f(that)h(indicate)g(they)g(supp)s(ort)1110 4861
y(it,)i(readline)e(ec)m(ho)s(es)i(a)f(c)m(haracter)h(corresp)s(onding)d
(to)j(a)f(signal)g(generated)1110 4737 y(from)e(the)g(k)m(eyb)s(oard.)
41 b(The)30 b(default)g(is)h(`)p Ft(on)p Fu('.)630 4902
y Ft(editing-mode)1110 5011 y Fu(The)d Ft(editing-mode)e
(to)j(a)f(signal)g(generated)1110 4970 y(from)e(the)g(k)m(eyb)s(oard.)
41 b(The)30 b(default)g(is)h(`)p Ft(on)p Fu('.)630 5121
y Ft(editing-mode)1110 5230 y Fu(The)d Ft(editing-mode)e
Fu(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 5121 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 5230 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
5340 y(b)s(e)g(set)h(to)g(either)g(`)p Ft(emacs)p Fu(')e(or)h(`)p
Ft(vi)p Fu('.)p eop end
m(ey)i(bind-)1110 5340 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,)p
eop end
%%Page: 121 127
TeXDict begin 121 126 bop 150 -116 a Fu(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(121)630 299 y Ft
(emacs-mode-string)1110 408 y Fu(If)33 b(the)h Fr(sho)m(w-mo)s
b(Command)29 b(Line)i(Editing)2062 b(121)1110 299 y(where)29
b(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 408 y(b)s(e)g(set)h(to)g
(either)g(`)p Ft(emacs)p Fu(')e(or)h(`)p Ft(vi)p Fu('.)630
565 y Ft(emacs-mode-string)1110 675 y Fu(If)j(the)h Fr(sho)m(w-mo)s
(de-in-prompt)h Fu(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
(is)h(dis-)1110 784 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(emacs)g(editing)h(mo)s(de)e(is)h(activ)m(e.)40
894 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 737 y(ing,)27 b(so)f(the)f(standard)g(set)h(of)f(meta-)i
(bind-)1110 1003 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
847 y(escap)s(e)f(sequences)h(is)e(a)m(v)-5 b(ailable.)41
1113 y(escap)s(e)f(sequences)h(is)e(a)m(v)-5 b(ailable.)41
b(Use)25 b(the)f(`)p Ft(\\1)p Fu(')f(and)h(`)p Ft(\\2)p
Fu(')g(escap)s(es)g(to)g(b)s(egin)1110 956 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 1066 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 1176
y(default)31 b(is)f(`)p Ft(@)p Fu('.)630 1377 y Ft
(enable-active-region)1110 1486 y Fu(The)46 b Fr(p)s(oin)m(t)j
Fu(is)e(the)g(curren)m(t)f(cursor)g(p)s(osition,)52 b(and)46
b Fr(mark)52 b Fu(refers)46 b(to)i(a)1110 1596 y(sa)m(v)m(ed)37
b(cursor)f(p)s(osition)g(\(see)i(Section)f(8.4.1)h([Commands)d(F)-8
b(or)37 b(Mo)m(ving],)1110 1705 y(page)d(131\).)50 b(The)33
b(text)h(b)s(et)m(w)m(een)f(the)g(p)s(oin)m(t)g(and)g(mark)g(is)g
(referred)f(to)i(as)1110 1815 y(the)23 b Fr(region)p
Fu(')g(escap)s(es)g(to)g(b)s(egin)1110 1223 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 1332 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 1442 y(default)31 b(is)f(`)p Ft(@)p Fu('.)630
1598 y Ft(enable-active-region)1110 1708 y Fu(The)46
b Fr(p)s(oin)m(t)j Fu(is)e(the)g(curren)m(t)f(cursor)g(p)s(osition,)52
b(and)46 b Fr(mark)52 b Fu(refers)46 b(to)i(a)1110 1817
y(sa)m(v)m(ed)37 b(cursor)f(p)s(osition)g(\(see)i(Section)f(8.4.1)h
([Commands)d(F)-8 b(or)37 b(Mo)m(ving],)1110 1927 y(page)d(131\).)50
b(The)33 b(text)h(b)s(et)m(w)m(een)f(the)g(p)s(oin)m(t)g(and)g(mark)g
(is)g(referred)f(to)i(as)1110 2037 y(the)23 b Fr(region)p
Fu(.)39 b(When)23 b(this)g(v)-5 b(ariable)24 b(is)f(set)h(to)g(`)p
Ft(On)p Fu(',)h(Readline)f(allo)m(ws)g(certain)1110 1924
Ft(On)p Fu(',)h(Readline)f(allo)m(ws)g(certain)1110 2146
y(commands)37 b(to)h(designate)h(the)e(region)h(as)g
Fr(activ)m(e)p Fu(.)64 b(When)37 b(the)h(region)g(is)1110
2034 y(activ)m(e,)g(Readline)d(highligh)m(ts)g(the)g(text)g(in)f(the)h
(region)g(using)f(the)g(termi-)1110 2144 y(nal's)c(standout)h(mo)s(de.)
2256 y(activ)m(e,)g(Readline)d(highligh)m(ts)g(the)g(text)g(in)f(the)h
(region)g(using)f(the)g(termi-)1110 2365 y(nal's)c(standout)h(mo)s(de.)
40 b(The)29 b(activ)m(e)k(region)e(sho)m(ws)f(the)g(text)h(inserted)f
(b)m(y)1110 2253 y(brac)m(k)m(eted-paste)37 b(and)d(an)m(y)i(matc)m
(b)m(y)1110 2475 y(brac)m(k)m(eted-paste)37 b(and)d(an)m(y)i(matc)m
(hing)f(text)h(found)e(b)m(y)g(incremen)m(tal)j(and)1110
2363 y(non-incremen)m(tal)31 b(history)g(searc)m(hes.)41
b(The)30 b(default)h(is)f(`)p Ft(On)p Fu('.)630 2564
y Ft(enable-bracketed-paste)1110 2673 y Fu(When)24 b(set)h(to)h(`)p
2585 y(non-incremen)m(tal)31 b(history)g(searc)m(hes.)41
b(The)30 b(default)h(is)f(`)p Ft(On)p Fu('.)630 2741
y Ft(enable-bracketed-paste)1110 2851 y Fu(When)24 b(set)h(to)h(`)p
Ft(On)p Fu(',)g(Readline)f(will)g(con\014gure)f(the)h(terminal)g(in)f
(a)h(w)m(a)m(y)g(that)1110 2783 y(will)k(enable)f(it)h(to)g(insert)g
(a)h(w)m(a)m(y)g(that)1110 2960 y(will)k(enable)f(it)h(to)g(insert)g
(eac)m(h)g(paste)g(in)m(to)g(the)g(editing)g(bu\013er)e(as)i(a)f
(single)1110 2892 y(string)33 b(of)f(c)m(haracters,)j(instead)e(of)g
(single)1110 3070 y(string)33 b(of)f(c)m(haracters,)j(instead)e(of)g
(treating)h(eac)m(h)g(c)m(haracter)g(as)f(if)f(it)i(had)1110
3002 y(b)s(een)e(read)i(from)e(the)i(k)m(eyb)s(oard.)49
3180 y(b)s(een)e(read)i(from)e(the)i(k)m(eyb)s(oard.)49
b(This)32 b(can)h(prev)m(en)m(t)h(pasted)f(c)m(haracters)1110
3112 y(from)d(b)s(eing)g(in)m(terpreted)h(as)f(editing)h(commands.)41
b(The)29 b(default)i(is)f(`)p Ft(On)p Fu('.)630 3313
y Ft(enable-keypad)1110 3422 y Fu(When)23 b(set)h(to)g(`)p
3289 y(from)d(b)s(eing)g(in)m(terpreted)h(as)f(editing)h(commands.)41
b(The)29 b(default)i(is)f(`)p Ft(On)p Fu('.)630 3446
y Ft(enable-keypad)1110 3555 y Fu(When)23 b(set)h(to)g(`)p
Ft(on)p Fu(',)h(Readline)f(will)g(try)f(to)h(enable)g(the)f
(application)i(k)m(eypad)1110 3532 y(when)h(it)h(is)f(called.)41
(application)i(k)m(eypad)1110 3665 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 3641 y(The)j(default)g(is)h(`)p Ft(off)p Fu('.)630
3842 y Ft(enable-meta-key)1110 3952 y Fu(When)40 b(set)g(to)g(`)p
(eys.)1110 3774 y(The)j(default)g(is)h(`)p Ft(off)p Fu('.)630
3931 y Ft(enable-meta-key)1110 4041 y Fu(When)40 b(set)g(to)g(`)p
Ft(on)p Fu(',)j(Readline)d(will)g(try)g(to)g(enable)g(an)m(y)g(meta)h
(mo)s(di\014er)1110 4061 y(k)m(ey)i(the)e(terminal)i(claims)f(to)h
(mo)s(di\014er)1110 4150 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
4171 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 4281 y(default)31
b(is)f(`)p Ft(on)p Fu('.)630 4482 y Ft(expand-tilde)1110
4591 y Fu(If)d(set)h(to)h(`)p Ft(on)p Fu(',)f(tilde)g(expansion)g(is)f
(p)s(erformed)f(when)h(Readline)h(attempts)1110 4701
4260 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 4369 y(default)31
b(is)f(`)p Ft(on)p Fu('.)630 4526 y Ft(expand-tilde)1110
4635 y Fu(If)d(set)h(to)h(`)p Ft(on)p Fu(',)f(tilde)g(expansion)g(is)f
(p)s(erformed)f(when)h(Readline)h(attempts)1110 4745
y(w)m(ord)i(completion.)42 b(The)30 b(default)g(is)h(`)p
Ft(off)p Fu('.)630 4902 y Ft(history-preserve-point)1110
5011 y Fu(If)41 b(set)h(to)h(`)p Ft(on)p Fu(',)i(the)c(history)h(co)s
@@ -21496,7 +21500,7 @@ b Fc(:)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(81)2025 4569 y Fe(completion-display-width)9
b Fc(:)19 b(:)13 b(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g
(:)h(:)f(:)g(:)24 b Fb(119)2025 4658 y Fe(completion-ignore-case)14
(:)h(:)f(:)g(:)24 b Fb(120)2025 4658 y Fe(completion-ignore-case)14
b Fc(:)k(:)13 b(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g
(:)g(:)g(:)h(:)f(:)29 b Fb(120)2025 4747 y Fe(completion-map-case)d
Fc(:)13 b(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g