commit bash-20040923 snapshot

This commit is contained in:
Chet Ramey
2011-12-03 13:37:00 -05:00
parent 633e5c6dee
commit 22e63b05c8
53 changed files with 23378 additions and 4244 deletions
+143 -140
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.08.30:0827
%DVIPSSource: TeX output 2004.09.21:1157
%%BeginProcSet: texc.pro
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -4226,29 +4226,29 @@ letter
TeXDict begin 1 0 bop 150 1318 a Fu(Bash)64 b(Reference)j(Man)-5
b(ual)p 150 1385 3600 34 v 2361 1481 a Ft(Reference)31
b(Do)s(cumen)m(tation)i(for)d(Bash)2428 1589 y(Edition)h(3.0,)g(for)f
Fs(Bash)g Ft(V)-8 b(ersion)31 b(3.0.)3252 1697 y(August)f(2004)150
4935 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
Fs(Bash)g Ft(V)-8 b(ersion)31 b(3.0.)3118 1697 y(Septem)m(b)s(er)f
(2004)150 4935 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 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.0,)c(27)f(August)f
(2004\).)150 3133 y(This)e(is)g(Edition)h(3.0,)h(last)f(up)s(dated)e
(27)i(August)f(2004,)j(of)e Fq(The)f(GNU)h(Bash)f(Reference)h(Man)m
(ual)p Ft(,)h(for)150 3243 y Fs(Bash)p Ft(,)f(V)-8 b(ersion)31
b(3.0.)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
b(oundation,)32 b(Inc.)150 3512 y(P)m(ermission)g(is)h(gran)m(ted)g(to)
f(mak)m(e)i(and)d(distribute)h(v)m(erbatim)h(copies)g(of)f(this)g(man)m
(ual)h(pro)m(vided)f(the)150 3621 y(cop)m(yrigh)m(t)g(notice)f(and)f
(this)g(p)s(ermission)g(notice)h(are)g(preserv)m(ed)f(on)h(all)g
(copies.)390 3756 y(P)m(ermission)k(is)h(gran)m(ted)f(to)h(cop)m(y)-8
b(,)38 b(distribute)d(and/or)g(mo)s(dify)f(this)h(do)s(cumen)m(t)g
(under)390 3866 y(the)j(terms)g(of)g(the)g(GNU)h(F)-8
b(ree)39 b(Do)s(cumen)m(tation)h(License,)g(V)-8 b(ersion)39
b(1.1)g(or)f(an)m(y)g(later)390 3975 y(v)m(ersion)28
(the)h(Bash)f(shell)h(\(v)m(ersion)150 2999 y(3.0,)c(17)f(Septem)m(b)s
(er)f(2004\).)150 3133 y(This)e(is)h(Edition)f(3.0,)j(last)e(up)s
(dated)f(17)h(Septem)m(b)s(er)f(2004,)j(of)e Fq(The)f(GNU)i(Bash)e
(Reference)i(Man)m(ual)p Ft(,)150 3243 y(for)g Fs(Bash)p
Ft(,)g(V)-8 b(ersion)31 b(3.0.)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 b(oundation,)32 b(Inc.)150 3512
y(P)m(ermission)g(is)h(gran)m(ted)g(to)f(mak)m(e)i(and)d(distribute)h
(v)m(erbatim)h(copies)g(of)f(this)g(man)m(ual)h(pro)m(vided)f(the)150
3621 y(cop)m(yrigh)m(t)g(notice)f(and)f(this)g(p)s(ermission)g(notice)h
(are)g(preserv)m(ed)f(on)h(all)g(copies.)390 3756 y(P)m(ermission)k(is)
h(gran)m(ted)f(to)h(cop)m(y)-8 b(,)38 b(distribute)d(and/or)g(mo)s
(dify)f(this)h(do)s(cumen)m(t)g(under)390 3866 y(the)j(terms)g(of)g
(the)g(GNU)h(F)-8 b(ree)39 b(Do)s(cumen)m(tation)h(License,)g(V)-8
b(ersion)39 b(1.1)g(or)f(an)m(y)g(later)390 3975 y(v)m(ersion)28
b(published)d(b)m(y)j(the)f(F)-8 b(ree)29 b(Soft)m(w)m(are)f(F)-8
b(oundation;)30 b(with)d(no)g(In)m(v)-5 b(arian)m(t)28
b(Sections,)390 4085 y(with)i(the)h(F)-8 b(ron)m(t-Co)m(v)m(er)33
@@ -8498,16 +8498,16 @@ b(ariable)39 b(whose)g(mem)m(b)s(ers)e(are)i(the)g(line)g(n)m(um)m(b)s
(ers)e(in)h(source)h(\014les)f(corre-)630 3014 y(sp)s(onding)h(to)i
(eac)m(h)g(mem)m(b)s(er)e(of)i Fq(FUNCNAME)p Ft(.)g Fs
(${BASH_LINENO[$i]})35 b Ft(is)40 b(the)h(line)630 3124
y(n)m(um)m(b)s(er)34 b(in)g(the)h(source)g(\014le)g(where)f
Fs(${FUNCNAME[$i)27 b(+)j(1]})k Ft(w)m(as)h(called.)56
b(The)34 b(corre-)630 3233 y(sp)s(onding)e(source)i(\014le)g(name)g(is)
g Fs(${BASH_SOURCE[$i)26 b(+)k(1]})p Ft(.)50 b(Use)35
b Fs(LINENO)d Ft(to)i(obtain)630 3343 y(the)d(curren)m(t)f(line)g(n)m
(um)m(b)s(er.)150 3513 y Fs(BASH_REMATCH)630 3623 y Ft(An)43
b(arra)m(y)i(v)-5 b(ariable)44 b(whose)g(mem)m(b)s(ers)f(are)h
(assigned)g(b)m(y)f(the)h(`)p Fs(=~)p Ft(')g(binary)f(op)s(erator)630
3733 y(to)37 b(the)f Fs([[)g Ft(conditional)i(command)e(\(see)h
(Section)g(3.2.4.2)i([Conditional)e(Constructs],)630
y(n)m(um)m(b)s(er)26 b(in)i(the)g(source)f(\014le)h(where)f
Fs(${FUNCNAME[$i]})d Ft(w)m(as)k(called.)41 b(The)27
b(corresp)s(ond-)630 3233 y(ing)f(source)h(\014le)f(name)g(is)h
Fs(${BASH_SOURCE[$i]})p Ft(.)34 b(Use)27 b Fs(LINENO)d
Ft(to)j(obtain)g(the)f(curren)m(t)630 3343 y(line)31
b(n)m(um)m(b)s(er.)150 3513 y Fs(BASH_REMATCH)630 3623
y Ft(An)43 b(arra)m(y)i(v)-5 b(ariable)44 b(whose)g(mem)m(b)s(ers)f
(are)h(assigned)g(b)m(y)f(the)h(`)p Fs(=~)p Ft(')g(binary)f(op)s
(erator)630 3733 y(to)37 b(the)f Fs([[)g Ft(conditional)i(command)e
(\(see)h(Section)g(3.2.4.2)i([Conditional)e(Constructs],)630
3842 y(page)e(10\).)52 b(The)33 b(elemen)m(t)j(with)d(index)g(0)i(is)f
(the)g(p)s(ortion)f(of)h(the)g(string)g(matc)m(hing)h(the)630
3952 y(en)m(tire)29 b(regular)f(expression.)40 b(The)27
@@ -11951,144 +11951,147 @@ b(Reference)g(Man)m(ual)630 299 y(The)e(pro)s(cess)g(of)h(applying)g
(these)g(completion)g(sp)s(eci\014cations)h(when)d(w)m(ord)i
(completion)630 408 y(is)35 b(attempted)h(is)f(describ)s(ed)f(ab)s(o)m
(v)m(e)j(\(see)f(Section)g(8.6)g([Programmable)g(Completion],)630
518 y(page)31 b(105\).)630 652 y(Other)41 b(options,)46
518 y(page)31 b(105\).)630 650 y(Other)41 b(options,)46
b(if)41 b(sp)s(eci\014ed,)j(ha)m(v)m(e)f(the)f(follo)m(wing)i
(meanings.)75 b(The)41 b(argumen)m(ts)h(to)630 762 y(the)e(`)p
(meanings.)75 b(The)41 b(argumen)m(ts)h(to)630 760 y(the)e(`)p
Fs(-G)p Ft(',)j(`)p Fs(-W)p Ft(',)g(and)d(`)p Fs(-X)p
Ft(')g(options)g(\(and,)j(if)d(necessary)-8 b(,)44 b(the)c(`)p
Fs(-P)p Ft(')h(and)e(`)p Fs(-S)p Ft(')h(options\))630
872 y(should)30 b(b)s(e)h(quoted)g(to)h(protect)g(them)f(from)g
869 y(should)30 b(b)s(e)h(quoted)g(to)h(protect)g(them)f(from)g
(expansion)g(b)s(efore)g(the)g Fs(complete)e Ft(builtin)630
981 y(is)h(in)m(v)m(ok)m(ed.)630 1140 y Fs(-o)g Fj(comp-option)1110
1250 y Ft(The)c Fq(comp-option)i Ft(con)m(trols)g(sev)m(eral)h(asp)s
979 y(is)h(in)m(v)m(ok)m(ed.)630 1134 y Fs(-o)g Fj(comp-option)1110
1244 y Ft(The)c Fq(comp-option)i Ft(con)m(trols)g(sev)m(eral)h(asp)s
(ects)e(of)g(the)g(compsp)s(ec's)g(b)s(eha)m(v-)1110
1359 y(ior)g(b)s(ey)m(ond)f(the)g(simple)h(generation)h(of)e
1353 y(ior)g(b)s(ey)m(ond)f(the)g(simple)h(generation)h(of)e
(completions.)41 b Fq(comp-option)27 b Ft(ma)m(y)1110
1469 y(b)s(e)j(one)g(of:)1110 1628 y Fs(bashdefault)1590
1738 y Ft(P)m(erform)d(the)h(rest)f(of)h(the)g(default)f(Bash)h
(completions)g(if)g(the)1590 1847 y(compsp)s(ec)i(generates)i(no)e
(matc)m(hes.)1110 2006 y Fs(default)144 b Ft(Use)22 b(Readline's)g
1463 y(b)s(e)j(one)g(of:)1110 1618 y Fs(bashdefault)1590
1727 y Ft(P)m(erform)d(the)h(rest)f(of)h(the)g(default)f(Bash)h
(completions)g(if)g(the)1590 1837 y(compsp)s(ec)i(generates)i(no)e
(matc)m(hes.)1110 1992 y Fs(default)144 b Ft(Use)22 b(Readline's)g
(default)g(\014lename)g(completion)g(if)g(the)g(comp-)1590
2116 y(sp)s(ec)30 b(generates)i(no)e(matc)m(hes.)1110
2275 y Fs(dirnames)96 b Ft(P)m(erform)46 b(directory)g(name)h
(completion)g(if)f(the)g(compsp)s(ec)1590 2385 y(generates)32
b(no)e(matc)m(hes.)1110 2544 y Fs(filenames)1590 2653
2101 y(sp)s(ec)30 b(generates)i(no)e(matc)m(hes.)1110
2256 y Fs(dirnames)96 b Ft(P)m(erform)46 b(directory)g(name)h
(completion)g(if)f(the)g(compsp)s(ec)1590 2366 y(generates)32
b(no)e(matc)m(hes.)1110 2521 y Fs(filenames)1590 2630
y Ft(T)-8 b(ell)40 b(Readline)f(that)h(the)f(compsp)s(ec)f(generates)j
(\014lenames,)1590 2763 y(so)29 b(it)h(can)f(p)s(erform)f(an)m(y)h
(\014lenames,)1590 2740 y(so)29 b(it)h(can)f(p)s(erform)f(an)m(y)h
(\014lename-sp)s(eci\014c)h(pro)s(cessing)e(\(lik)m(e)1590
2872 y(adding)h(a)h(slash)f(to)h(directory)g(names)f(or)g(suppressing)f
(trail-)1590 2982 y(ing)38 b(spaces\).)66 b(This)37 b(option)i(is)f(in)
m(tended)g(to)h(b)s(e)f(used)f(with)1590 3092 y(shell)31
2850 y(adding)h(a)h(slash)f(to)h(directory)g(names)f(or)g(suppressing)f
(trail-)1590 2959 y(ing)38 b(spaces\).)66 b(This)37 b(option)i(is)f(in)
m(tended)g(to)h(b)s(e)f(used)f(with)1590 3069 y(shell)31
b(functions)f(sp)s(eci\014ed)f(with)h(`)p Fs(-F)p Ft('.)1110
3251 y Fs(nospace)144 b Ft(T)-8 b(ell)40 b(Readline)g(not)g(to)g(app)s
(end)d(a)j(space)g(\(the)f(default\))h(to)1590 3360 y(w)m(ords)30
b(completed)h(at)g(the)g(end)f(of)g(the)h(line.)630 3519
y Fs(-A)f Fj(action)1110 3629 y Ft(The)25 b Fq(action)h
Ft(ma)m(y)g(b)s(e)e(one)h(of)h(the)f(follo)m(wing)i(to)e(generate)i(a)e
(list)h(of)f(p)s(ossible)1110 3739 y(completions:)1110
3898 y Fs(alias)240 b Ft(Alias)31 b(names.)41 b(Ma)m(y)31
b(also)h(b)s(e)e(sp)s(eci\014ed)f(as)i(`)p Fs(-a)p Ft('.)1110
4057 y Fs(arrayvar)96 b Ft(Arra)m(y)31 b(v)-5 b(ariable)31
b(names.)1110 4216 y Fs(binding)144 b Ft(Readline)30
b(k)m(ey)f(binding)f(names)h(\(see)h(Section)f(8.4)h([Bindable)1590
4325 y(Readline)h(Commands],)f(page)h(97\).)1110 4484
y Fs(builtin)144 b Ft(Names)21 b(of)g(shell)f(builtin)h(commands.)37
b(Ma)m(y)21 b(also)h(b)s(e)e(sp)s(eci\014ed)1590 4594
y(as)31 b(`)p Fs(-b)p Ft('.)1110 4753 y Fs(command)144
3224 y Fs(nospace)144 b Ft(T)-8 b(ell)40 b(Readline)g(not)g(to)g(app)s
(end)d(a)j(space)g(\(the)f(default\))h(to)1590 3333 y(w)m(ords)30
b(completed)h(at)g(the)g(end)f(of)g(the)h(line.)1110
3488 y Fs(plusdirs)96 b Ft(After)30 b(an)m(y)h(matc)m(hes)g(de\014ned)d
(b)m(y)i(the)g(compsp)s(ec)g(are)g(gener-)1590 3598 y(ated,)g
(directory)f(name)g(completion)i(is)d(attempted)i(and)f(an)m(y)1590
3707 y(matc)m(hes)j(are)e(added)g(to)h(the)g(results)f(of)g(the)h
(other)g(actions.)630 3862 y Fs(-A)f Fj(action)1110 3972
y Ft(The)25 b Fq(action)h Ft(ma)m(y)g(b)s(e)e(one)h(of)h(the)f(follo)m
(wing)i(to)e(generate)i(a)e(list)h(of)f(p)s(ossible)1110
4082 y(completions:)1110 4237 y Fs(alias)240 b Ft(Alias)31
b(names.)41 b(Ma)m(y)31 b(also)h(b)s(e)e(sp)s(eci\014ed)f(as)i(`)p
Fs(-a)p Ft('.)1110 4391 y Fs(arrayvar)96 b Ft(Arra)m(y)31
b(v)-5 b(ariable)31 b(names.)1110 4546 y Fs(binding)144
b Ft(Readline)30 b(k)m(ey)f(binding)f(names)h(\(see)h(Section)f(8.4)h
([Bindable)1590 4656 y(Readline)h(Commands],)f(page)h(97\).)1110
4811 y Fs(builtin)144 b Ft(Names)21 b(of)g(shell)f(builtin)h(commands.)
37 b(Ma)m(y)21 b(also)h(b)s(e)e(sp)s(eci\014ed)1590 4921
y(as)31 b(`)p Fs(-b)p Ft('.)1110 5075 y Fs(command)144
b Ft(Command)29 b(names.)41 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s
(eci\014ed)f(as)i(`)p Fs(-c)p Ft('.)1110 4912 y Fs(directory)1590
5022 y Ft(Directory)h(names.)40 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s
(eci\014ed)g(as)g(`)p Fs(-d)p Ft('.)1110 5181 y Fs(disabled)96
b Ft(Names)31 b(of)g(disabled)f(shell)g(builtins.)1110
5340 y Fs(enabled)144 b Ft(Names)31 b(of)g(enabled)f(shell)g(builtins.)
p eop end
(eci\014ed)f(as)i(`)p Fs(-c)p Ft('.)1110 5230 y Fs(directory)1590
5340 y Ft(Directory)h(names.)40 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s
(eci\014ed)g(as)g(`)p Fs(-d)p Ft('.)p eop end
%%Page: 109 115
TeXDict begin 109 114 bop 150 -116 a Ft(Chapter)30 b(8:)41
b(Command)29 b(Line)i(Editing)2062 b(109)1110 299 y Fs(export)192
b Ft(Names)34 b(of)f(exp)s(orted)f(shell)h(v)-5 b(ariables.)49
b(Ma)m(y)35 b(also)e(b)s(e)g(sp)s(eci-)1590 408 y(\014ed)d(as)g(`)p
Fs(-e)p Ft('.)1110 558 y Fs(file)288 b Ft(File)32 b(names.)40
b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)f(as)i(`)p
Fs(-f)p Ft('.)1110 708 y Fs(function)96 b Ft(Names)31
b(of)g(shell)f(functions.)1110 858 y Fs(group)240 b Ft(Group)30
b(names.)40 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)g(as)g(`)p
Fs(-g)p Ft('.)1110 1008 y Fs(helptopic)1590 1118 y Ft(Help)37
b(topics)g(as)g(accepted)h(b)m(y)e(the)h Fs(help)f Ft(builtin)g(\(see)h
(Sec-)1590 1228 y(tion)31 b(4.2)g([Bash)g(Builtins],)g(page)g(39\).)
1110 1377 y Fs(hostname)96 b Ft(Hostnames,)89 b(as)76
b(tak)m(en)h(from)f(the)g(\014le)h(sp)s(eci\014ed)e(b)m(y)1590
1487 y(the)55 b Fs(HOSTFILE)e Ft(shell)j(v)-5 b(ariable)56
b(\(see)g(Section)g(5.2)h([Bash)1590 1597 y(V)-8 b(ariables],)32
b(page)f(55\).)1110 1747 y Fs(job)336 b Ft(Job)31 b(names,)h(if)g(job)f
(con)m(trol)i(is)f(activ)m(e.)46 b(Ma)m(y)33 b(also)g(b)s(e)e(sp)s
(eci-)1590 1856 y(\014ed)f(as)g(`)p Fs(-j)p Ft('.)1110
2006 y Fs(keyword)144 b Ft(Shell)30 b(reserv)m(ed)h(w)m(ords.)40
b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)f(as)i(`)p
Fs(-k)p Ft('.)1110 2156 y Fs(running)144 b Ft(Names)31
b(of)g(running)d(jobs,)i(if)h(job)f(con)m(trol)h(is)g(activ)m(e.)1110
2306 y Fs(service)144 b Ft(Service)31 b(names.)41 b(Ma)m(y)31
b(also)g(b)s(e)f(sp)s(eci\014ed)g(as)g(`)p Fs(-s)p Ft('.)1110
2456 y Fs(setopt)192 b Ft(V)-8 b(alid)34 b(argumen)m(ts)f(for)f(the)h
(`)p Fs(-o)p Ft(')g(option)g(to)h(the)f Fs(set)e Ft(builtin)1590
2566 y(\(see)g(Section)h(4.3)f([The)f(Set)h(Builtin],)g(page)g(50\).)
1110 2716 y Fs(shopt)240 b Ft(Shell)40 b(option)g(names)g(as)g
b(Command)29 b(Line)i(Editing)2062 b(109)1110 299 y Fs(disabled)96
b Ft(Names)31 b(of)g(disabled)f(shell)g(builtins.)1110
458 y Fs(enabled)144 b Ft(Names)31 b(of)g(enabled)f(shell)g(builtins.)
1110 617 y Fs(export)192 b Ft(Names)34 b(of)f(exp)s(orted)f(shell)h(v)
-5 b(ariables.)49 b(Ma)m(y)35 b(also)e(b)s(e)g(sp)s(eci-)1590
726 y(\014ed)d(as)g(`)p Fs(-e)p Ft('.)1110 885 y Fs(file)288
b Ft(File)32 b(names.)40 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)f
(as)i(`)p Fs(-f)p Ft('.)1110 1044 y Fs(function)96 b
Ft(Names)31 b(of)g(shell)f(functions.)1110 1203 y Fs(group)240
b Ft(Group)30 b(names.)40 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)g
(as)g(`)p Fs(-g)p Ft('.)1110 1362 y Fs(helptopic)1590
1471 y Ft(Help)37 b(topics)g(as)g(accepted)h(b)m(y)e(the)h
Fs(help)f Ft(builtin)g(\(see)h(Sec-)1590 1581 y(tion)31
b(4.2)g([Bash)g(Builtins],)g(page)g(39\).)1110 1740 y
Fs(hostname)96 b Ft(Hostnames,)89 b(as)76 b(tak)m(en)h(from)f(the)g
(\014le)h(sp)s(eci\014ed)e(b)m(y)1590 1850 y(the)55 b
Fs(HOSTFILE)e Ft(shell)j(v)-5 b(ariable)56 b(\(see)g(Section)g(5.2)h
([Bash)1590 1959 y(V)-8 b(ariables],)32 b(page)f(55\).)1110
2118 y Fs(job)336 b Ft(Job)31 b(names,)h(if)g(job)f(con)m(trol)i(is)f
(activ)m(e.)46 b(Ma)m(y)33 b(also)g(b)s(e)e(sp)s(eci-)1590
2228 y(\014ed)f(as)g(`)p Fs(-j)p Ft('.)1110 2387 y Fs(keyword)144
b Ft(Shell)30 b(reserv)m(ed)h(w)m(ords.)40 b(Ma)m(y)32
b(also)f(b)s(e)f(sp)s(eci\014ed)f(as)i(`)p Fs(-k)p Ft('.)1110
2545 y Fs(running)144 b Ft(Names)31 b(of)g(running)d(jobs,)i(if)h(job)f
(con)m(trol)h(is)g(activ)m(e.)1110 2704 y Fs(service)144
b Ft(Service)31 b(names.)41 b(Ma)m(y)31 b(also)g(b)s(e)f(sp)s
(eci\014ed)g(as)g(`)p Fs(-s)p Ft('.)1110 2863 y Fs(setopt)192
b Ft(V)-8 b(alid)34 b(argumen)m(ts)f(for)f(the)h(`)p
Fs(-o)p Ft(')g(option)g(to)h(the)f Fs(set)e Ft(builtin)1590
2973 y(\(see)g(Section)h(4.3)f([The)f(Set)h(Builtin],)g(page)g(50\).)
1110 3132 y Fs(shopt)240 b Ft(Shell)40 b(option)g(names)g(as)g
(accepted)i(b)m(y)e(the)g Fs(shopt)e Ft(builtin)1590
2825 y(\(see)31 b(Section)h(4.2)f([Bash)g(Builtins],)g(page)g(39\).)
1110 2975 y Fs(signal)192 b Ft(Signal)31 b(names.)1110
3125 y Fs(stopped)144 b Ft(Names)31 b(of)g(stopp)s(ed)e(jobs,)h(if)g
(job)g(con)m(trol)i(is)f(activ)m(e.)1110 3275 y Fs(user)288
3241 y(\(see)31 b(Section)h(4.2)f([Bash)g(Builtins],)g(page)g(39\).)
1110 3400 y Fs(signal)192 b Ft(Signal)31 b(names.)1110
3559 y Fs(stopped)144 b Ft(Names)31 b(of)g(stopp)s(ed)e(jobs,)h(if)g
(job)g(con)m(trol)i(is)f(activ)m(e.)1110 3718 y Fs(user)288
b Ft(User)30 b(names.)41 b(Ma)m(y)32 b(also)f(b)s(e)f(sp)s(eci\014ed)f
(as)i(`)p Fs(-u)p Ft('.)1110 3425 y Fs(variable)96 b
(as)i(`)p Fs(-u)p Ft('.)1110 3877 y Fs(variable)96 b
Ft(Names)36 b(of)g(all)g(shell)g(v)-5 b(ariables.)56
b(Ma)m(y)37 b(also)f(b)s(e)f(sp)s(eci\014ed)g(as)1590
3535 y(`)p Fs(-v)p Ft('.)630 3685 y Fs(-G)30 b Fj(globpat)1110
3794 y Ft(The)39 b(\014lename)h(expansion)g(pattern)g
Fq(globpat)j Ft(is)d(expanded)f(to)h(generate)1110 3904
y(the)31 b(p)s(ossible)e(completions.)630 4054 y Fs(-W)h
Fj(wordlist)1110 4163 y Ft(The)24 b Fq(w)m(ordlist)k
3987 y(`)p Fs(-v)p Ft('.)630 4145 y Fs(-G)30 b Fj(globpat)1110
4255 y Ft(The)39 b(\014lename)h(expansion)g(pattern)g
Fq(globpat)j Ft(is)d(expanded)f(to)h(generate)1110 4365
y(the)31 b(p)s(ossible)e(completions.)630 4524 y Fs(-W)h
Fj(wordlist)1110 4633 y Ft(The)24 b Fq(w)m(ordlist)k
Ft(is)d(split)g(using)f(the)h(c)m(haracters)i(in)d(the)i
Fs(IFS)e Ft(sp)s(ecial)h(v)-5 b(ariable)1110 4273 y(as)36
Fs(IFS)e Ft(sp)s(ecial)h(v)-5 b(ariable)1110 4743 y(as)36
b(delimiters,)i(and)e(eac)m(h)h(resultan)m(t)g(w)m(ord)e(is)h
(expanded.)57 b(The)35 b(p)s(ossible)1110 4383 y(completions)c(are)e
(expanded.)57 b(The)35 b(p)s(ossible)1110 4852 y(completions)c(are)e
(the)h(mem)m(b)s(ers)f(of)g(the)h(resultan)m(t)g(list)g(whic)m(h)f
(matc)m(h)i(the)1110 4492 y(w)m(ord)f(b)s(eing)g(completed.)630
4642 y Fs(-C)g Fj(command)1110 4752 y Fq(command)35 b
(matc)m(h)i(the)1110 4962 y(w)m(ord)f(b)s(eing)g(completed.)630
5121 y Fs(-C)g Fj(command)1110 5230 y Fq(command)35 b
Ft(is)e(executed)g(in)e(a)i(subshell)e(en)m(vironmen)m(t,)i(and)f(its)g
(output)g(is)1110 4861 y(used)e(as)g(the)h(p)s(ossible)f(completions.)
630 5011 y Fs(-F)g Fj(function)1110 5121 y Ft(The)25
b(shell)i(function)e Fq(function)h Ft(is)g(executed)h(in)e(the)i
(curren)m(t)e(shell)i(en)m(viron-)1110 5230 y(men)m(t.)40
b(When)25 b(it)h(\014nishes,)f(the)h(p)s(ossible)f(completions)h(are)g
(retriev)m(ed)g(from)1110 5340 y(the)31 b(v)-5 b(alue)30
b(of)h(the)g Fs(COMPREPLY)c Ft(arra)m(y)k(v)-5 b(ariable.)p
(output)g(is)1110 5340 y(used)e(as)g(the)h(p)s(ossible)f(completions.)p
eop end
%%Page: 110 116
TeXDict begin 110 115 bop 150 -116 a Ft(110)2527 b(Bash)31
b(Reference)g(Man)m(ual)630 299 y Fs(-X)f Fj(filterpat)1110
408 y Fq(\014lterpat)d Ft(is)e(a)g(pattern)g(as)f(used)g(for)h
(\014lename)g(expansion.)38 b(It)25 b(is)g(applied)f(to)1110
518 y(the)30 b(list)f(of)h(p)s(ossible)f(completions)h(generated)h(b)m
(y)e(the)g(preceding)h(options)1110 628 y(and)d(argumen)m(ts,)i(and)e
(eac)m(h)i(completion)g(matc)m(hing)g Fq(\014lterpat)h
Ft(is)e(remo)m(v)m(ed)1110 737 y(from)i(the)h(list.)42
b(A)30 b(leading)i(`)p Fs(!)p Ft(')e(in)g Fq(\014lterpat)j
Ft(negates)f(the)f(pattern;)g(in)f(this)1110 847 y(case,)i(an)m(y)e
(completion)i(not)f(matc)m(hing)g Fq(\014lterpat)i Ft(is)d(remo)m(v)m
(ed.)630 1006 y Fs(-P)g Fj(prefix)1110 1116 y Fq(pre\014x)39
b Ft(is)34 b(added)f(at)i(the)f(b)s(eginning)f(of)i(eac)m(h)g(p)s
(ossible)e(completion)i(after)1110 1225 y(all)c(other)g(options)g(ha)m
(v)m(e)g(b)s(een)f(applied.)630 1385 y Fs(-S)g Fj(suffix)1110
1494 y Fq(su\016x)c Ft(is)20 b(app)s(ended)f(to)i(eac)m(h)h(p)s
(ossible)e(completion)i(after)f(all)g(other)g(options)1110
1604 y(ha)m(v)m(e)32 b(b)s(een)d(applied.)630 1763 y(The)35
b(return)g(v)-5 b(alue)37 b(is)f(true)f(unless)h(an)f(in)m(v)-5
b(alid)37 b(option)f(is)g(supplied,)g(an)g(option)h(other)630
1873 y(than)31 b(`)p Fs(-p)p Ft(')g(or)g(`)p Fs(-r)p
b(Reference)g(Man)m(ual)630 299 y Fs(-F)f Fj(function)1110
408 y Ft(The)25 b(shell)i(function)e Fq(function)h Ft(is)g(executed)h
(in)e(the)i(curren)m(t)e(shell)i(en)m(viron-)1110 518
y(men)m(t.)40 b(When)25 b(it)h(\014nishes,)f(the)h(p)s(ossible)f
(completions)h(are)g(retriev)m(ed)g(from)1110 628 y(the)31
b(v)-5 b(alue)30 b(of)h(the)g Fs(COMPREPLY)c Ft(arra)m(y)k(v)-5
b(ariable.)630 787 y Fs(-X)30 b Fj(filterpat)1110 897
y Fq(\014lterpat)d Ft(is)e(a)g(pattern)g(as)f(used)g(for)h(\014lename)g
(expansion.)38 b(It)25 b(is)g(applied)f(to)1110 1006
y(the)30 b(list)f(of)h(p)s(ossible)f(completions)h(generated)h(b)m(y)e
(the)g(preceding)h(options)1110 1116 y(and)d(argumen)m(ts,)i(and)e(eac)
m(h)i(completion)g(matc)m(hing)g Fq(\014lterpat)h Ft(is)e(remo)m(v)m
(ed)1110 1225 y(from)i(the)h(list.)42 b(A)30 b(leading)i(`)p
Fs(!)p Ft(')e(in)g Fq(\014lterpat)j Ft(negates)f(the)f(pattern;)g(in)f
(this)1110 1335 y(case,)i(an)m(y)e(completion)i(not)f(matc)m(hing)g
Fq(\014lterpat)i Ft(is)d(remo)m(v)m(ed.)630 1494 y Fs(-P)g
Fj(prefix)1110 1604 y Fq(pre\014x)39 b Ft(is)34 b(added)f(at)i(the)f(b)
s(eginning)f(of)i(eac)m(h)g(p)s(ossible)e(completion)i(after)1110
1714 y(all)c(other)g(options)g(ha)m(v)m(e)g(b)s(een)f(applied.)630
1873 y Fs(-S)g Fj(suffix)1110 1983 y Fq(su\016x)c Ft(is)20
b(app)s(ended)f(to)i(eac)m(h)h(p)s(ossible)e(completion)i(after)f(all)g
(other)g(options)1110 2092 y(ha)m(v)m(e)32 b(b)s(een)d(applied.)630
2252 y(The)35 b(return)g(v)-5 b(alue)37 b(is)f(true)f(unless)h(an)f(in)
m(v)-5 b(alid)37 b(option)f(is)g(supplied,)g(an)g(option)h(other)630
2361 y(than)31 b(`)p Fs(-p)p Ft(')g(or)g(`)p Fs(-r)p
Ft(')g(is)g(supplied)f(without)h(a)g Fq(name)37 b Ft(argumen)m(t,)32
b(an)f(attempt)h(is)f(made)g(to)630 1983 y(remo)m(v)m(e)h(a)e
b(an)f(attempt)h(is)f(made)g(to)630 2471 y(remo)m(v)m(e)h(a)e
(completion)i(sp)s(eci\014cation)f(for)f(a)h Fq(name)k
Ft(for)30 b(whic)m(h)g(no)g(sp)s(eci\014cation)h(exists,)630
2092 y(or)f(an)h(error)f(o)s(ccurs)g(adding)g(a)g(completion)i(sp)s
2580 y(or)f(an)h(error)f(o)s(ccurs)g(adding)g(a)g(completion)i(sp)s
(eci\014cation.)p eop end
%%Page: 111 117
TeXDict begin 111 116 bop 150 -116 a Ft(Chapter)30 b(9:)41