commit bash-20041230 snapshot

This commit is contained in:
Chet Ramey
2011-12-03 13:41:51 -05:00
parent 5c96a638d0
commit 01ed5ba4e7
36 changed files with 4623 additions and 2903 deletions
+172 -156
View File
@@ -10,7 +10,7 @@
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi
%DVIPSParameters: dpi=600, compressed
%DVIPSSource: TeX output 2004.12.07:1057
%DVIPSSource: TeX output 2004.12.30:1701
%%BeginProcSet: texc.pro
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -4234,10 +4234,10 @@ b(,)46 b(Case)g(W)-11 b(estern)46 b(Reserv)l(e)g(Univ)l(ersit)l(y)150
%%Page: 2 2
TeXDict begin 2 1 bop 150 2889 a Ft(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 2999 y(3.1-dev)m(el,)d(1)e
(Decem)m(b)s(er)g(2004\).)150 3133 y(This)42 b(is)h(Edition)g(3.1-dev)m
(el,)49 b(last)44 b(up)s(dated)e(1)h(Decem)m(b)s(er)h(2004,)k(of)43
b Fq(The)f(GNU)i(Bash)f(Reference)150 3243 y(Man)m(ual)p
(the)h(Bash)f(shell)h(\(v)m(ersion)150 2999 y(3.1-dev)m(el,)d(30)e
(Decem)m(b)s(er)g(2004\).)150 3133 y(This)39 b(is)g(Edition)h(3.1-dev)m
(el,)45 b(last)40 b(up)s(dated)f(30)h(Decem)m(b)s(er)g(2004,)k(of)c
Fq(The)f(GNU)h(Bash)g(Reference)150 3243 y(Man)m(ual)p
Ft(,)32 b(for)e Fs(Bash)p Ft(,)f(V)-8 b(ersion)31 b(3.1-dev)m(el.)150
3377 y(Cop)m(yrigh)m(t)602 3374 y(c)577 3377 y Fp(\015)f
Ft(1988-2004)k(F)-8 b(ree)32 b(Soft)m(w)m(are)f(F)-8
@@ -4911,71 +4911,75 @@ eop end
%%Page: 6 12
TeXDict begin 6 11 bop 150 -116 a Ft(6)2617 b(Bash)31
b(Reference)g(Man)m(ual)150 299 y Fk(3.1.2)63 b(Quoting)275
543 y Ft(Quoting)24 b(is)g(used)f(to)h(remo)m(v)m(e)i(the)e(sp)s(ecial)
537 y Ft(Quoting)24 b(is)g(used)f(to)h(remo)m(v)m(e)i(the)e(sp)s(ecial)
g(meaning)g(of)g(certain)h(c)m(haracters)h(or)d(w)m(ords)h(to)g(the)g
(shell.)150 653 y(Quoting)k(can)f(b)s(e)g(used)f(to)j(disable)e(sp)s
(shell.)150 647 y(Quoting)k(can)f(b)s(e)g(used)f(to)j(disable)e(sp)s
(ecial)h(treatmen)m(t)h(for)e(sp)s(ecial)h(c)m(haracters,)i(to)e(prev)m
(en)m(t)g(reserv)m(ed)150 762 y(w)m(ords)i(from)g(b)s(eing)g
(en)m(t)g(reserv)m(ed)150 757 y(w)m(ords)i(from)g(b)s(eing)g
(recognized)h(as)g(suc)m(h,)f(and)g(to)h(prev)m(en)m(t)g(parameter)g
(expansion.)275 897 y(Eac)m(h)22 b(of)g(the)g(shell)g(metac)m
(expansion.)275 886 y(Eac)m(h)22 b(of)g(the)g(shell)g(metac)m
(haracters)i(\(see)f(Chapter)e(2)i([De\014nitions],)h(page)f(3\))g(has)
e(sp)s(ecial)i(meaning)150 1006 y(to)40 b(the)g(shell)f(and)g(m)m(ust)g
e(sp)s(ecial)i(meaning)150 995 y(to)40 b(the)g(shell)f(and)g(m)m(ust)g
(b)s(e)g(quoted)g(if)h(it)g(is)f(to)h(represen)m(t)g(itself.)68
b(When)39 b(the)h(command)f(history)150 1116 y(expansion)f(facilities)j
(are)d(b)s(eing)g(used,)i(the)e Fq(history)h(expansion)f
Ft(c)m(haracter,)k(usually)c(`)p Fs(!)p Ft(',)i(m)m(ust)f(b)s(e)150
1225 y(quoted)27 b(to)g(prev)m(en)m(t)g(history)f(expansion.)39
b(See)27 b(Section)g(9.1)h([Bash)e(History)h(F)-8 b(acilities],)31
b(page)c(111,)i(for)150 1335 y(more)i(details)g(concerning)g(history)f
(expansion.)275 1469 y(There)37 b(are)h(three)f(quoting)h(mec)m
(hanisms:)56 b(the)38 b Fq(escap)s(e)g(c)m(haracter)p
Ft(,)j(single)d(quotes,)i(and)d(double)150 1579 y(quotes.)150
1803 y Fk(3.1.2.1)63 b(Escap)s(e)41 b(Character)275 2047
y Ft(A)27 b(non-quoted)g(bac)m(kslash)h(`)p Fs(\\)p Ft(')f(is)g(the)h
(Bash)f(escap)s(e)g(c)m(haracter.)42 b(It)27 b(preserv)m(es)g(the)g
(literal)i(v)-5 b(alue)28 b(of)150 2157 y(the)f(next)g(c)m(haracter)h
(that)f(follo)m(ws,)i(with)d(the)h(exception)g(of)g Fs(newline)p
Ft(.)38 b(If)26 b(a)h Fs(\\newline)d Ft(pair)i(app)s(ears,)150
2267 y(and)k(the)h(bac)m(kslash)g(itself)g(is)g(not)g(quoted,)g(the)f
Fs(\\newline)f Ft(is)h(treated)i(as)f(a)g(line)g(con)m(tin)m(uation)h
(\(that)150 2376 y(is,)f(it)g(is)f(remo)m(v)m(ed)h(from)f(the)h(input)e
(stream)i(and)f(e\013ectiv)m(ely)j(ignored\).)150 2600
y Fk(3.1.2.2)63 b(Single)42 b(Quotes)275 2844 y Ft(Enclosing)36
b(c)m(haracters)i(in)d(single)i(quotes)g(\(`)p Fs(')p
Ft('\))f(preserv)m(es)h(the)f(literal)h(v)-5 b(alue)37
b(of)f(eac)m(h)h(c)m(haracter)150 2954 y(within)24 b(the)h(quotes.)39
b(A)25 b(single)h(quote)f(ma)m(y)g(not)g(o)s(ccur)g(b)s(et)m(w)m(een)g
(single)h(quotes,)g(ev)m(en)g(when)d(preceded)150 3064
y(b)m(y)30 b(a)h(bac)m(kslash.)150 3288 y Fk(3.1.2.3)63
b(Double)42 b(Quotes)275 3532 y Ft(Enclosing)36 b(c)m(haracters)i(in)e
(double)g(quotes)h(\(`)p Fs(")p Ft('\))g(preserv)m(es)f(the)g(literal)i
(v)-5 b(alue)37 b(of)f(all)h(c)m(haracters)150 3641 y(within)32
b(the)h(quotes,)h(with)e(the)h(exception)h(of)e(`)p Fs($)p
Ft(',)i(`)p Fs(`)p Ft(',)f(and)f(`)p Fs(\\)p Ft('.)48
b(The)32 b(c)m(haracters)i(`)p Fs($)p Ft(')f(and)f(`)p
Fs(`)p Ft(')g(retain)150 3751 y(their)k(sp)s(ecial)h(meaning)g(within)f
(double)g(quotes)h(\(see)g(Section)g(3.5)g([Shell)g(Expansions],)g
(page)g(16\).)150 3861 y(The)30 b(bac)m(kslash)h(retains)f(its)h(sp)s
(ecial)g(meaning)f(only)h(when)e(follo)m(w)m(ed)j(b)m(y)e(one)h(of)f
(the)h(follo)m(wing)g(c)m(har-)150 3970 y(acters:)54
b(`)p Fs($)p Ft(',)39 b(`)p Fs(`)p Ft(',)g(`)p Fs(")p
Ft(',)g(`)p Fs(\\)p Ft(',)f(or)f Fs(newline)p Ft(.)58
b(Within)37 b(double)f(quotes,)j(bac)m(kslashes)f(that)f(are)g(follo)m
(w)m(ed)150 4080 y(b)m(y)28 b(one)g(of)g(these)g(c)m(haracters)i(are)e
(remo)m(v)m(ed.)41 b(Bac)m(kslashes)30 b(preceding)e(c)m(haracters)h
(without)f(a)g(sp)s(ecial)150 4189 y(meaning)j(are)h(left)f(unmo)s
(di\014ed.)41 b(A)31 b(double)g(quote)g(ma)m(y)h(b)s(e)e(quoted)i
(within)e(double)h(quotes)g(b)m(y)g(pre-)150 4299 y(ceding)36
b(it)g(with)f(a)h(bac)m(kslash.)56 b(When)36 b(command)f(history)g(is)h
(b)s(eing)f(used,)h(the)f(double)g(quote)h(ma)m(y)150
4408 y(not)31 b(b)s(e)e(used)h(to)h(quote)g(the)g(history)f(expansion)g
(c)m(haracter.)275 4543 y(The)41 b(sp)s(ecial)h(parameters)f(`)p
Fs(*)p Ft(')h(and)f(`)p Fs(@)p Ft(')h(ha)m(v)m(e)g(sp)s(ecial)g
(meaning)g(when)f(in)g(double)g(quotes)h(\(see)150 4653
y(Section)31 b(3.5.3)h([Shell)f(P)m(arameter)h(Expansion],)e(page)h
(19\).)150 4877 y Fk(3.1.2.4)63 b(ANSI-C)40 b(Quoting)275
5121 y Ft(W)-8 b(ords)33 b(of)h(the)g(form)f Fs($')p
Fj(string)11 b Fs(')31 b Ft(are)j(treated)g(sp)s(ecially)-8
b(When)39 b(the)h(command)f(history)150 1105 y(expansion)i(facilities)j
(are)e(b)s(eing)f(used)g(\(see)h(Section)h(9.3)f([History)h(In)m
(teraction],)j(page)c(113\),)47 b(the)150 1214 y Fq(history)30
b(expansion)h Ft(c)m(haracter,)h(usually)f(`)p Fs(!)p
Ft(',)g(m)m(ust)f(b)s(e)g(quoted)h(to)g(prev)m(en)m(t)g(history)g
(expansion.)41 b(See)150 1324 y(Section)22 b(9.1)g([Bash)f(History)h(F)
-8 b(acilities],)26 b(page)c(111,)j(for)20 b(more)h(details)h
(concerning)g(history)f(expansion.)275 1453 y(There)37
b(are)h(three)f(quoting)h(mec)m(hanisms:)56 b(the)38
b Fq(escap)s(e)g(c)m(haracter)p Ft(,)j(single)d(quotes,)i(and)d(double)
150 1563 y(quotes.)150 1770 y Fk(3.1.2.1)63 b(Escap)s(e)41
b(Character)275 2009 y Ft(A)27 b(non-quoted)g(bac)m(kslash)h(`)p
Fs(\\)p Ft(')f(is)g(the)h(Bash)f(escap)s(e)g(c)m(haracter.)42
b(It)27 b(preserv)m(es)g(the)g(literal)i(v)-5 b(alue)28
b(of)150 2119 y(the)f(next)g(c)m(haracter)h(that)f(follo)m(ws,)i(with)d
(the)h(exception)g(of)g Fs(newline)p Ft(.)38 b(If)26
b(a)h Fs(\\newline)d Ft(pair)i(app)s(ears,)150 2228 y(and)k(the)h(bac)m
(kslash)g(itself)g(is)g(not)g(quoted,)g(the)f Fs(\\newline)f
Ft(is)h(treated)i(as)f(a)g(line)g(con)m(tin)m(uation)h(\(that)150
2338 y(is,)f(it)g(is)f(remo)m(v)m(ed)h(from)f(the)h(input)e(stream)i
(and)f(e\013ectiv)m(ely)j(ignored\).)150 2545 y Fk(3.1.2.2)63
b(Single)42 b(Quotes)275 2784 y Ft(Enclosing)36 b(c)m(haracters)i(in)d
(single)i(quotes)g(\(`)p Fs(')p Ft('\))f(preserv)m(es)h(the)f(literal)h
(v)-5 b(alue)37 b(of)f(eac)m(h)h(c)m(haracter)150 2894
y(within)24 b(the)h(quotes.)39 b(A)25 b(single)h(quote)f(ma)m(y)g(not)g
(o)s(ccur)g(b)s(et)m(w)m(een)g(single)h(quotes,)g(ev)m(en)g(when)d
(preceded)150 3003 y(b)m(y)30 b(a)h(bac)m(kslash.)150
3211 y Fk(3.1.2.3)63 b(Double)42 b(Quotes)275 3450 y
Ft(Enclosing)36 b(c)m(haracters)i(in)e(double)g(quotes)h(\(`)p
Fs(")p Ft('\))g(preserv)m(es)f(the)g(literal)i(v)-5 b(alue)37
b(of)f(all)h(c)m(haracters)150 3559 y(within)25 b(the)g(quotes,)i(with)
e(the)g(exception)h(of)g(`)p Fs($)p Ft(',)g(`)p Fs(`)p
Ft(',)h(`)p Fs(\\)p Ft(',)f(and,)g(when)e(history)i(expansion)f(is)g
(enabled,)150 3669 y(`)p Fs(!)p Ft('.)48 b(The)32 b(c)m(haracters)i(`)p
Fs($)p Ft(')f(and)f(`)p Fs(`)p Ft(')h(retain)g(their)g(sp)s(ecial)g
(meaning)g(within)f(double)h(quotes)g(\(see)g(Sec-)150
3778 y(tion)e(3.5)h([Shell)e(Expansions],)g(page)i(16\).)42
b(The)30 b(bac)m(kslash)h(retains)g(its)g(sp)s(ecial)g(meaning)f(only)h
(when)150 3888 y(follo)m(w)m(ed)40 b(b)m(y)e(one)h(of)g(the)f(follo)m
(wing)i(c)m(haracters:)58 b(`)p Fs($)p Ft(',)41 b(`)p
Fs(`)p Ft(',)g(`)p Fs(")p Ft(',)g(`)p Fs(\\)p Ft(',)g(or)d
Fs(newline)p Ft(.)63 b(Within)38 b(double)150 3998 y(quotes,)c(bac)m
(kslashes)g(that)f(are)g(follo)m(w)m(ed)h(b)m(y)f(one)g(of)f(these)h(c)
m(haracters)i(are)e(remo)m(v)m(ed.)48 b(Bac)m(kslashes)150
4107 y(preceding)25 b(c)m(haracters)h(without)f(a)h(sp)s(ecial)f
(meaning)h(are)f(left)h(unmo)s(di\014ed.)37 b(A)25 b(double)f(quote)i
(ma)m(y)g(b)s(e)150 4217 y(quoted)g(within)f(double)g(quotes)g(b)m(y)h
(preceding)f(it)h(with)f(a)h(bac)m(kslash.)40 b(If)25
b(enabled,)i(history)e(expansion)150 4326 y(will)38 b(b)s(e)e(p)s
(erformed)g(unless)h(an)g(`)p Fs(!)p Ft(')h(app)s(earing)f(in)g(double)
g(quotes)h(is)f(escap)s(ed)g(using)g(a)h(bac)m(kslash.)150
4436 y(The)30 b(bac)m(kslash)h(preceding)f(the)h(`)p
Fs(!)p Ft(')f(is)h(not)f(remo)m(v)m(ed.)275 4565 y(The)41
b(sp)s(ecial)h(parameters)f(`)p Fs(*)p Ft(')h(and)f(`)p
Fs(@)p Ft(')h(ha)m(v)m(e)g(sp)s(ecial)g(meaning)g(when)f(in)g(double)g
(quotes)h(\(see)150 4674 y(Section)31 b(3.5.3)h([Shell)f(P)m(arameter)h
(Expansion],)e(page)h(19\).)150 4882 y Fk(3.1.2.4)63
b(ANSI-C)40 b(Quoting)275 5121 y Ft(W)-8 b(ords)33 b(of)h(the)g(form)f
Fs($')p Fj(string)11 b Fs(')31 b Ft(are)j(treated)g(sp)s(ecially)-8
b(.)52 b(The)33 b(w)m(ord)g(expands)g(to)i Fq(string)p
Ft(,)f(with)150 5230 y(bac)m(kslash-escap)s(ed)44 b(c)m(haracters)h
(replaced)f(as)g(sp)s(eci\014ed)f(b)m(y)g(the)g(ANSI)g(C)g(standard.)79
@@ -12761,7 +12765,7 @@ Fs(--with-bash-malloc)p Ft(.)150 2378 y Fs(--with-installed-readlin)o
b(this)f(to)h(mak)m(e)h(Bash)f(link)f(with)g(a)h(lo)s(cally-installed)i
(v)m(ersion)e(of)g(Readline)g(rather)630 2597 y(than)38
b(the)h(v)m(ersion)g(in)g(`)p Fs(lib/readline)p Ft('.)62
b(This)38 b(w)m(orks)h(only)f(with)h(Readline)g(4.3)h(and)630
b(This)38 b(w)m(orks)h(only)f(with)h(Readline)g(5.0)h(and)630
2706 y(later)29 b(v)m(ersions.)40 b(If)28 b Fq(PREFIX)37
b Ft(is)28 b Fs(yes)f Ft(or)h(not)g(supplied,)f Fs(configure)f
Ft(uses)h(the)h(v)-5 b(alues)29 b(of)630 2816 y(the)c(mak)m(e)g(v)-5
@@ -12806,146 +12810,158 @@ b(Installing)31 b(Bash)2356 b(121)150 299 y Fs(--enable-static-link)630
408 y Ft(This)37 b(causes)h(Bash)f(to)h(b)s(e)f(link)m(ed)h(statically)
-8 b(,)43 b(if)37 b Fs(gcc)g Ft(is)g(b)s(eing)g(used.)61
b(This)37 b(could)h(b)s(e)630 518 y(used)30 b(to)h(build)e(a)i(v)m
(ersion)g(to)g(use)f(as)g(ro)s(ot's)h(shell.)275 663
(ersion)g(to)g(use)f(as)g(ro)s(ot's)h(shell.)275 671
y(The)f(`)p Fs(minimal-config)p Ft(')d(option)k(can)g(b)s(e)f(used)f
(to)j(disable)e(all)i(of)f(the)f(follo)m(wing)i(options,)g(but)d(it)150
772 y(is)h(pro)s(cessed)g(\014rst,)g(so)h(individual)f(options)g(ma)m
781 y(is)h(pro)s(cessed)g(\014rst,)g(so)h(individual)f(options)g(ma)m
(y)h(b)s(e)f(enabled)g(using)g(`)p Fs(enable-)p Fj(feature)11
b Ft('.)275 899 y(All)37 b(of)g(the)f(follo)m(wing)i(options)f(except)h
b Ft('.)275 913 y(All)37 b(of)g(the)f(follo)m(wing)i(options)f(except)h
(for)e(`)p Fs(disabled-builtins)p Ft(')d(and)j(`)p Fs(xpg-echo-default)
p Ft(')150 1009 y(are)26 b(enabled)g(b)m(y)g(default,)h(unless)f(the)g
p Ft(')150 1022 y(are)26 b(enabled)g(b)m(y)g(default,)h(unless)f(the)g
(op)s(erating)g(system)g(do)s(es)g(not)g(pro)m(vide)g(the)g(necessary)g
(supp)s(ort.)150 1154 y Fs(--enable-alias)630 1263 y
(supp)s(ort.)150 1176 y Fs(--enable-alias)630 1285 y
Ft(Allo)m(w)41 b(alias)g(expansion)f(and)f(include)g(the)h
Fs(alias)f Ft(and)g Fs(unalias)e Ft(builtins)j(\(see)g(Sec-)630
1373 y(tion)31 b(6.6)g([Aliases],)i(page)e(71\).)150
1518 y Fs(--enable-arith-for-comma)o(nd)630 1627 y Ft(Include)21
1395 y(tion)31 b(6.6)g([Aliases],)i(page)e(71\).)150
1548 y Fs(--enable-arith-for-comma)o(nd)630 1658 y Ft(Include)21
b(supp)s(ort)g(for)g(the)i(alternate)g(form)f(of)g(the)g
Fs(for)f Ft(command)h(that)h(b)s(eha)m(v)m(es)f(lik)m(e)i(the)630
1737 y(C)30 b(language)i Fs(for)d Ft(statemen)m(t)j(\(see)g(Section)f
1767 y(C)30 b(language)i Fs(for)d Ft(statemen)m(t)j(\(see)g(Section)f
(3.2.4.1)i([Lo)s(oping)d(Constructs],)h(page)g(9\).)150
1881 y Fs(--enable-array-variables)630 1991 y Ft(Include)h(supp)s(ort)g
1921 y Fs(--enable-array-variables)630 2030 y Ft(Include)h(supp)s(ort)g
(for)h(one-dimensional)h(arra)m(y)f(shell)h(v)-5 b(ariables)33
b(\(see)h(Section)g(6.7)h([Ar-)630 2101 y(ra)m(ys],)c(page)g(72\).)150
2245 y Fs(--enable-bang-history)630 2355 y Ft(Include)36
b(\(see)h(Section)g(6.7)h([Ar-)630 2140 y(ra)m(ys],)c(page)g(72\).)150
2293 y Fs(--enable-bang-history)630 2403 y Ft(Include)36
b(supp)s(ort)f(for)h Fs(csh)p Ft(-lik)m(e)h(history)g(substitution)f
(\(see)h(Section)g(9.3)h([History)f(In-)630 2464 y(teraction],)c(page)e
(113\).)150 2609 y Fs(--enable-brace-expansion)630 2719
(\(see)h(Section)g(9.3)h([History)f(In-)630 2513 y(teraction],)c(page)e
(113\).)150 2666 y Fs(--enable-brace-expansion)630 2776
y Ft(Include)40 b Fs(csh)p Ft(-lik)m(e)h(brace)f(expansion)g(\()h
Fs(b{a,b}c)2445 2715 y Fp(7!)2576 2719 y Fs(bac)30 b(bbc)39
b Ft(\).)71 b(See)40 b(Section)h(3.5.1)630 2828 y([Brace)32
Fs(b{a,b}c)2445 2772 y Fp(7!)2576 2776 y Fs(bac)30 b(bbc)39
b Ft(\).)71 b(See)40 b(Section)h(3.5.1)630 2885 y([Brace)32
b(Expansion],)e(page)h(17,)h(for)e(a)g(complete)i(description.)150
2973 y Fs(--enable-command-timing)630 3082 y Ft(Include)43
3039 y Fs(--enable-command-timing)630 3148 y Ft(Include)43
b(supp)s(ort)f(for)h(recognizing)i Fs(time)e Ft(as)g(a)h(reserv)m(ed)g
(w)m(ord)f(and)g(for)h(displa)m(ying)630 3192 y(timing)37
(w)m(ord)f(and)g(for)h(displa)m(ying)630 3258 y(timing)37
b(statistics)h(for)e(the)g(pip)s(eline)g(follo)m(wing)i
Fs(time)d Ft(\(see)i(Section)g(3.2.2)h([Pip)s(elines],)630
3302 y(page)24 b(8\).)39 b(This)23 b(allo)m(ws)h(pip)s(elines)f(as)h(w)
3367 y(page)24 b(8\).)39 b(This)23 b(allo)m(ws)h(pip)s(elines)f(as)h(w)
m(ell)g(as)g(shell)f(builtins)g(and)g(functions)g(to)h(b)s(e)e(timed.)
150 3446 y Fs(--enable-cond-command)630 3556 y Ft(Include)33
150 3521 y Fs(--enable-cond-command)630 3630 y Ft(Include)33
b(supp)s(ort)f(for)i(the)g Fs([[)f Ft(conditional)i(command.)51
b(\(see)34 b(Section)h(3.2.4.2)h([Condi-)630 3665 y(tional)c
(Constructs],)e(page)h(10\).)150 3810 y Fs(--enable-cond-regexp)630
3920 y Ft(Include)f(supp)s(ort)f(for)i(matc)m(hing)h(POSIX)d(regular)i
b(\(see)34 b(Section)h(3.2.4.2)h([Condi-)630 3740 y(tional)c
(Constructs],)e(page)h(10\).)150 3893 y Fs(--enable-cond-regexp)630
4003 y Ft(Include)f(supp)s(ort)f(for)i(matc)m(hing)h(POSIX)d(regular)i
(expressions)g(using)f(the)h(`)p Fs(=~)p Ft(')g(binary)630
4029 y(op)s(erator)25 b(in)f(the)h Fs([[)f Ft(conditional)h(command.)39
4113 y(op)s(erator)25 b(in)f(the)h Fs([[)f Ft(conditional)h(command.)39
b(\(see)25 b(Section)h(3.2.4.2)h([Conditional)e(Con-)630
4139 y(structs],)31 b(page)g(10\).)150 4284 y Fs
(--enable-directory-stack)630 4393 y Ft(Include)i(supp)s(ort)g(for)h(a)
g Fs(csh)p Ft(-lik)m(e)h(directory)f(stac)m(k)i(and)d(the)i
Fs(pushd)p Ft(,)f Fs(popd)p Ft(,)g(and)f Fs(dirs)630
4503 y Ft(builtins)d(\(see)h(Section)g(6.8)h([The)e(Directory)i(Stac)m
(k],)g(page)f(73\).)150 4647 y Fs(--enable-disabled-builti)o(ns)630
4757 y Ft(Allo)m(w)40 b(builtin)e(commands)g(to)h(b)s(e)f(in)m(v)m(ok)m
(ed)i(via)f(`)p Fs(builtin)29 b(xxx)p Ft(')37 b(ev)m(en)j(after)f
Fs(xxx)e Ft(has)630 4867 y(b)s(een)31 b(disabled)g(using)g(`)p
4222 y(structs],)31 b(page)g(10\).)150 4376 y Fs(--enable-debugger)630
4485 y Ft(Include)f(supp)s(ort)e(for)i(the)h(bash)f(debugger)g
(\(distributed)g(separately\).)150 4639 y Fs(--enable-directory-stack)
630 4748 y Ft(Include)j(supp)s(ort)g(for)h(a)g Fs(csh)p
Ft(-lik)m(e)h(directory)f(stac)m(k)i(and)d(the)i Fs(pushd)p
Ft(,)f Fs(popd)p Ft(,)g(and)f Fs(dirs)630 4858 y Ft(builtins)d(\(see)h
(Section)g(6.8)h([The)e(Directory)i(Stac)m(k],)g(page)f(73\).)150
5011 y Fs(--enable-disabled-builti)o(ns)630 5121 y Ft(Allo)m(w)40
b(builtin)e(commands)g(to)h(b)s(e)f(in)m(v)m(ok)m(ed)i(via)f(`)p
Fs(builtin)29 b(xxx)p Ft(')37 b(ev)m(en)j(after)f Fs(xxx)e
Ft(has)630 5230 y(b)s(een)31 b(disabled)g(using)g(`)p
Fs(enable)d(-n)i(xxx)p Ft('.)43 b(See)32 b(Section)g(4.2)h([Bash)e
(Builtins],)i(page)f(39,)630 4976 y(for)e(details)i(of)e(the)h
Fs(builtin)d Ft(and)i Fs(enable)e Ft(builtin)i(commands.)150
5121 y Fs(--enable-dparen-arithmet)o(ic)630 5230 y Ft(Include)42
b(supp)s(ort)f(for)h(the)h Fs(\(\(...)o(\)\))f Ft(command)g(\(see)i
(Section)f(3.2.4.2)i([Conditional)630 5340 y(Constructs],)30
b(page)h(10\).)p eop end
(Builtins],)i(page)f(39,)630 5340 y(for)e(details)i(of)e(the)h
Fs(builtin)d Ft(and)i Fs(enable)e Ft(builtin)i(commands.)p
eop end
%%Page: 122 128
TeXDict begin 122 127 bop 150 -116 a Ft(122)2527 b(Bash)31
b(Reference)g(Man)m(ual)150 299 y Fs(--enable-extended-glob)630
408 y Ft(Include)40 b(supp)s(ort)e(for)i(the)h(extended)f(pattern)h
(matc)m(hing)g(features)g(describ)s(ed)e(ab)s(o)m(v)m(e)630
518 y(under)29 b(Section)i(3.5.8.1)i([P)m(attern)e(Matc)m(hing],)i
(page)e(23.)150 682 y Fs(--enable-help-builtin)630 792
y Ft(Include)24 b(the)h Fs(help)f Ft(builtin,)h(whic)m(h)g(displa)m(ys)
f(help)h(on)f(shell)h(builtins)f(and)h(v)-5 b(ariables)25
b(\(see)630 902 y(Section)31 b(4.2)h([Bash)e(Builtins],)i(page)f(39\).)
150 1066 y Fs(--enable-history)630 1176 y Ft(Include)e(command)g
b(Reference)g(Man)m(ual)150 299 y Fs(--enable-dparen-arithmet)o(ic)630
408 y Ft(Include)42 b(supp)s(ort)f(for)h(the)h Fs(\(\(...)o(\)\))f
Ft(command)g(\(see)i(Section)f(3.2.4.2)i([Conditional)630
518 y(Constructs],)30 b(page)h(10\).)150 673 y Fs
(--enable-extended-glob)630 783 y Ft(Include)40 b(supp)s(ort)e(for)i
(the)h(extended)f(pattern)h(matc)m(hing)g(features)g(describ)s(ed)e(ab)
s(o)m(v)m(e)630 892 y(under)29 b(Section)i(3.5.8.1)i([P)m(attern)e
(Matc)m(hing],)i(page)e(23.)150 1048 y Fs(--enable-help-builtin)630
1157 y Ft(Include)24 b(the)h Fs(help)f Ft(builtin,)h(whic)m(h)g(displa)
m(ys)f(help)h(on)f(shell)h(builtins)f(and)h(v)-5 b(ariables)25
b(\(see)630 1267 y(Section)31 b(4.2)h([Bash)e(Builtins],)i(page)f
(39\).)150 1422 y Fs(--enable-history)630 1532 y Ft(Include)e(command)g
(history)h(and)f(the)h Fs(fc)f Ft(and)g Fs(history)e
Ft(builtin)j(commands)f(\(see)h(Sec-)630 1285 y(tion)h(9.1)g([Bash)g
Ft(builtin)j(commands)f(\(see)h(Sec-)630 1641 y(tion)h(9.1)g([Bash)g
(History)g(F)-8 b(acilities],)34 b(page)d(111\).)150
1450 y Fs(--enable-job-control)630 1559 y Ft(This)e(enables)i(the)f
1797 y Fs(--enable-job-control)630 1906 y Ft(This)e(enables)i(the)f
(job)g(con)m(trol)h(features)g(\(see)g(Chapter)f(7)g([Job)g(Con)m
(trol],)h(page)g(81\),)h(if)630 1669 y(the)f(op)s(erating)f(system)h
(supp)s(orts)d(them.)150 1833 y Fs(--enable-multibyte)630
1943 y Ft(This)h(enables)i(supp)s(ort)d(for)i(m)m(ultib)m(yte)h(c)m
(trol],)h(page)g(81\),)h(if)630 2016 y(the)f(op)s(erating)f(system)h
(supp)s(orts)d(them.)150 2171 y Fs(--enable-multibyte)630
2281 y Ft(This)h(enables)i(supp)s(ort)d(for)i(m)m(ultib)m(yte)h(c)m
(haracters)g(if)f(the)g(op)s(erating)h(system)f(pro)m(vides)630
2052 y(the)h(necessary)f(supp)s(ort.)150 2217 y Fs
(--enable-net-redirection)o(s)630 2326 y Ft(This)21 b(enables)h(the)g
2390 y(the)h(necessary)f(supp)s(ort.)150 2545 y Fs
(--enable-net-redirection)o(s)630 2655 y Ft(This)21 b(enables)h(the)g
(sp)s(ecial)h(handling)e(of)h(\014lenames)g(of)g(the)g(form)f
Fs(/dev/tcp/)p Fj(host)11 b Fs(/)p Fj(port)630 2436 y
Fs(/dev/tcp/)p Fj(host)11 b Fs(/)p Fj(port)630 2765 y
Ft(and)29 b Fs(/dev/udp/)p Fj(host)11 b Fs(/)p Fj(port)34
b Ft(when)28 b(used)g(in)h(redirections)h(\(see)g(Section)g(3.6)g
([Redirec-)630 2545 y(tions],)h(page)g(24\).)150 2710
y Fs(--enable-process-substit)o(utio)o(n)630 2819 y Ft(This)49
([Redirec-)630 2874 y(tions],)h(page)g(24\).)150 3029
y Fs(--enable-process-substit)o(utio)o(n)630 3139 y Ft(This)49
b(enables)i(pro)s(cess)f(substitution)g(\(see)h(Section)g(3.5.6)h([Pro)
s(cess)e(Substitution],)630 2929 y(page)31 b(22\))h(if)e(the)h(op)s
s(cess)e(Substitution],)630 3249 y(page)31 b(22\))h(if)e(the)h(op)s
(erating)f(system)h(pro)m(vides)f(the)h(necessary)g(supp)s(ort.)150
3093 y Fs(--enable-prompt-string-d)o(ecod)o(ing)630 3203
3404 y Fs(--enable-progcomp)630 3513 y Ft(Enable)d(the)g(programmable)g
(completion)i(facilities)g(\(see)f(Section)g(8.6)g([Programmable)630
3623 y(Completion],)i(page)h(105\).)42 b(If)30 b(Readline)h(is)f(not)h
(enabled,)f(this)h(option)g(has)f(no)g(e\013ect.)150
3778 y Fs(--enable-prompt-string-d)o(ecod)o(ing)630 3888
y Ft(T)-8 b(urn)46 b(on)h(the)h(in)m(terpretation)g(of)g(a)g(n)m(um)m
(b)s(er)e(of)h(bac)m(kslash-escap)s(ed)h(c)m(haracters)h(in)630
3313 y(the)39 b Fs($PS1)p Ft(,)g Fs($PS2)p Ft(,)h Fs($PS3)p
3998 y(the)39 b Fs($PS1)p Ft(,)g Fs($PS2)p Ft(,)h Fs($PS3)p
Ft(,)f(and)f Fs($PS4)f Ft(prompt)h(strings.)64 b(See)39
b(Section)g(6.9)h([Prin)m(ting)f(a)630 3422 y(Prompt],)30
b(Section)g(6.9)h([Prin)m(ting)f(a)630 4107 y(Prompt],)30
b(page)h(75,)h(for)e(a)h(complete)h(list)f(of)f(prompt)g(string)g
(escap)s(e)h(sequences.)150 3587 y Fs(--enable-progcomp)630
3696 y Ft(Enable)d(the)g(programmable)g(completion)i(facilities)g
(\(see)f(Section)g(8.6)g([Programmable)630 3806 y(Completion],)i(page)h
(105\).)42 b(If)30 b(Readline)h(is)f(not)h(enabled,)f(this)h(option)g
(has)f(no)g(e\013ect.)150 3970 y Fs(--enable-readline)630
4080 y Ft(Include)e(supp)s(ort)f(for)h(command-line)h(editing)g(and)f
(history)g(with)g(the)h(Bash)g(v)m(ersion)g(of)630 4189
(escap)s(e)h(sequences.)150 4262 y Fs(--enable-readline)630
4372 y Ft(Include)d(supp)s(ort)f(for)h(command-line)h(editing)g(and)f
(history)g(with)g(the)h(Bash)g(v)m(ersion)g(of)630 4482
y(the)i(Readline)g(library)f(\(see)h(Chapter)f(8)g([Command)g(Line)g
(Editing],)h(page)g(85\).)150 4354 y Fs(--enable-restricted)630
4463 y Ft(Include)41 b(supp)s(ort)f(for)i(a)g Fq(restricted)g(shell)p
(Editing],)h(page)g(85\).)150 4637 y Fs(--enable-restricted)630
4746 y Ft(Include)41 b(supp)s(ort)f(for)i(a)g Fq(restricted)g(shell)p
Ft(.)75 b(If)42 b(this)f(is)h(enabled,)j(Bash,)g(when)c(called)630
4573 y(as)f Fs(rbash)p Ft(,)h(en)m(ters)f(a)g(restricted)h(mo)s(de.)68
4856 y(as)f Fs(rbash)p Ft(,)h(en)m(ters)f(a)g(restricted)h(mo)s(de.)68
b(See)40 b(Section)h(6.10)g([The)f(Restricted)h(Shell],)630
4682 y(page)31 b(76,)h(for)e(a)g(description)h(of)f(restricted)h(mo)s
(de.)150 4847 y Fs(--enable-select)630 4956 y Ft(Include)k(the)g
4966 y(page)31 b(76,)h(for)e(a)g(description)h(of)f(restricted)h(mo)s
(de.)150 5121 y Fs(--enable-select)630 5230 y Ft(Include)k(the)g
Fs(select)f Ft(builtin,)i(whic)m(h)f(allo)m(ws)i(the)f(generation)g(of)
g(simple)f(men)m(us)g(\(see)630 5066 y(Section)c(3.2.4.2)i
([Conditional)e(Constructs],)g(page)g(10\).)150 5230
y Fs(--enable-usg-echo-defaul)o(t)630 5340 y Ft(A)f(synon)m(ym)g(for)g
Fs(--enable-xpg-echo-default)p Ft(.)p eop end
g(simple)f(men)m(us)g(\(see)630 5340 y(Section)c(3.2.4.2)i
([Conditional)e(Constructs],)g(page)g(10\).)p eop end
%%Page: 123 129
TeXDict begin 123 128 bop 150 -116 a Ft(Chapter)30 b(10:)41
b(Installing)31 b(Bash)2356 b(123)150 299 y Fs
(--enable-xpg-echo-defaul)o(t)630 408 y Ft(Mak)m(e)26
b(the)f Fs(echo)e Ft(builtin)i(expand)f(bac)m(kslash-escap)s(ed)h(c)m
(haracters)h(b)m(y)f(default,)h(without)630 518 y(requiring)41
(--enable-separate-helpfi)o(les)630 408 y Ft(Use)32 b(external)h
(\014les)f(for)g(the)g(do)s(cumen)m(tation)h(displa)m(y)m(ed)f(b)m(y)g
(the)g Fs(help)f Ft(builtin)h(instead)630 518 y(of)f(storing)f(the)h
(text)g(in)m(ternally)-8 b(.)150 677 y Fs(--enable-single-help-str)o
(ings)630 787 y Ft(Store)40 b(the)g(text)h(displa)m(y)m(ed)g(b)m(y)e
(the)i Fs(help)d Ft(builtin)i(as)g(a)g(single)h(string)f(for)f(eac)m(h)
i(help)630 897 y(topic.)54 b(This)33 b(aids)i(in)f(translating)h(the)g
(text)g(to)g(di\013eren)m(t)g(languages.)54 b(Y)-8 b(ou)35
b(ma)m(y)g(need)630 1006 y(to)c(disable)g(this)f(if)g(y)m(our)h
(compiler)g(cannot)f(handle)g(v)m(ery)h(long)g(string)f(literals.)150
1166 y Fs(--enable-usg-echo-defaul)o(t)630 1275 y Ft(A)g(synon)m(ym)g
(for)g Fs(--enable-xpg-echo-default)p Ft(.)150 1435 y
Fs(--enable-xpg-echo-defaul)o(t)630 1544 y Ft(Mak)m(e)c(the)f
Fs(echo)e Ft(builtin)i(expand)f(bac)m(kslash-escap)s(ed)h(c)m
(haracters)h(b)m(y)f(default,)h(without)630 1654 y(requiring)41
b(the)g(`)p Fs(-e)p Ft(')g(option.)73 b(This)41 b(sets)g(the)g(default)
h(v)-5 b(alue)41 b(of)h(the)f Fs(xpg_echo)e Ft(shell)630
628 y(option)26 b(to)g Fs(on)p Ft(,)g(whic)m(h)g(mak)m(es)g(the)g(Bash)
g Fs(echo)e Ft(b)s(eha)m(v)m(e)i(more)g(lik)m(e)h(the)f(v)m(ersion)g
(sp)s(eci\014ed)630 737 y(in)41 b(the)h(Single)g(Unix)f(Sp)s
(eci\014cation,)k(v)m(ersion)e(2.)74 b(See)42 b(Section)g(4.2)h([Bash)f
(Builtins],)630 847 y(page)31 b(39,)h(for)e(a)g(description)h(of)f(the)
h(escap)s(e)g(sequences)f(that)h Fs(echo)f Ft(recognizes.)275
1006 y(The)23 b(\014le)i(`)p Fs(config-top.h)p Ft(')c(con)m(tains)26
1763 y(option)26 b(to)g Fs(on)p Ft(,)g(whic)m(h)g(mak)m(es)g(the)g
(Bash)g Fs(echo)e Ft(b)s(eha)m(v)m(e)i(more)g(lik)m(e)h(the)f(v)m
(ersion)g(sp)s(eci\014ed)630 1873 y(in)41 b(the)h(Single)g(Unix)f(Sp)s
(eci\014cation,)k(v)m(ersion)e(3.)74 b(See)42 b(Section)g(4.2)h([Bash)f
(Builtins],)630 1983 y(page)31 b(39,)h(for)e(a)g(description)h(of)f
(the)h(escap)s(e)g(sequences)f(that)h Fs(echo)f Ft(recognizes.)275
2142 y(The)23 b(\014le)i(`)p Fs(config-top.h)p Ft(')c(con)m(tains)26
b(C)e(Prepro)s(cessor)g(`)p Fs(#define)p Ft(')e(statemen)m(ts)k(for)f
(options)f(whic)m(h)150 1116 y(are)35 b(not)g(settable)i(from)d
(options)f(whic)m(h)150 2252 y(are)35 b(not)g(settable)i(from)d
Fs(configure)p Ft(.)51 b(Some)35 b(of)g(these)g(are)h(not)f(mean)m(t)g
(to)h(b)s(e)e(c)m(hanged;)k(b)s(ew)m(are)d(of)150 1225
(to)h(b)s(e)e(c)m(hanged;)k(b)s(ew)m(are)d(of)150 2361
y(the)h(consequences)g(if)f(y)m(ou)h(do.)55 b(Read)36
b(the)g(commen)m(ts)g(asso)s(ciated)h(with)e(eac)m(h)i(de\014nition)e
(for)g(more)150 1335 y(information)c(ab)s(out)f(its)h(e\013ect.)p
(for)g(more)150 2471 y(information)c(ab)s(out)f(its)h(e\013ect.)p
eop end
%%Page: 124 130
TeXDict begin 124 129 bop 150 -116 a Ft(124)2527 b(Bash)31