commit bash-20050217 snapshot

This commit is contained in:
Chet Ramey
2011-12-03 13:43:32 -05:00
parent cc87ba64ee
commit 2206f89ab4
45 changed files with 2735 additions and 979 deletions
+59 -58
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.30:1701
%DVIPSSource: TeX output 2005.02.14:1156
%%BeginProcSet: texc.pro
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -4226,30 +4226,31 @@ 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)1963 1589 y(Edition)h(3.1-dev)m(el,)
i(for)d Fs(Bash)f Ft(V)-8 b(ersion)31 b(3.1-dev)m(el.)3145
1697 y(Decem)m(b)s(er)g(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
i(for)d Fs(Bash)f Ft(V)-8 b(ersion)31 b(3.1-dev)m(el.)3180
1697 y(F)-8 b(ebruary)30 b(2005)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.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
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.1-dev)m(el,)d(11)e(F)-8
b(ebruary)30 b(2005\).)150 3133 y(This)41 b(is)i(Edition)f(3.1-dev)m
(el,)48 b(last)43 b(up)s(dated)e(11)i(F)-8 b(ebruary)42
b(2005,)47 b(of)42 b Fq(The)g(GNU)h(Bash)f(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-2005)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
@@ -5728,25 +5729,25 @@ Ft(')630 3393 y(option)i(\(see)g(Section)h(6.1)f([In)m(v)m(oking)h
f(executed,)i(if)f(one)g(is)f(presen)m(t.)42 b(Otherwise,)31
b(it)g(is)f(set)630 3613 y(to)h(the)g(\014lename)f(used)g(to)h(in)m(v)m
(ok)m(e)h(Bash,)f(as)g(giv)m(en)g(b)m(y)f(argumen)m(t)h(zero.)150
3773 y Fs(_)432 b Ft(\(An)34 b(underscore.\))50 b(A)m(t)34
b(shell)g(startup,)h(set)f(to)g(the)g(absolute)g(\014lename)g(of)g(the)
g(shell)g(or)630 3882 y(shell)j(script)h(b)s(eing)e(executed)i(as)g
(passed)f(in)g(the)g(argumen)m(t)h(list.)62 b(Subsequen)m(tly)-8
b(,)38 b(ex-)630 3992 y(pands)e(to)i(the)g(last)g(argumen)m(t)g(to)h
(the)e(previous)g(command,)i(after)f(expansion.)62 b(Also)630
4102 y(set)30 b(to)f(the)h(full)e(pathname)h(of)h(eac)m(h)g(command)f
(executed)h(and)e(placed)i(in)e(the)i(en)m(viron-)630
4211 y(men)m(t)37 b(exp)s(orted)f(to)h(that)h(command.)58
b(When)37 b(c)m(hec)m(king)h(mail,)h(this)d(parameter)h(holds)630
4321 y(the)31 b(name)f(of)h(the)f(mail)h(\014le.)150
4580 y Fr(3.5)68 b(Shell)45 b(Expansions)275 4825 y Ft(Expansion)29
b(is)h(p)s(erformed)e(on)i(the)g(command)g(line)g(after)h(it)f(has)g(b)
s(een)f(split)h(in)m(to)h Fs(token)p Ft(s.)39 b(There)150
4935 y(are)31 b(sev)m(en)g(kinds)e(of)i(expansion)f(p)s(erformed:)225
5070 y Fp(\017)60 b Ft(brace)31 b(expansion)225 5205
y Fp(\017)60 b Ft(tilde)31 b(expansion)225 5340 y Fp(\017)60
b Ft(parameter)31 b(and)f(v)-5 b(ariable)31 b(expansion)p
eop end
3773 y Fs(_)432 b Ft(\(An)27 b(underscore.\))39 b(A)m(t)29
b(shell)e(startup,)h(set)f(to)h(the)g(absolute)g(pathname)f(used)f(to)i
(in)m(v)m(ok)m(e)630 3882 y(the)22 b(shell)g(or)g(shell)g(script)f(b)s
(eing)h(executed)h(as)f(passed)f(in)g(the)h(en)m(vironmen)m(t)h(or)e
(argumen)m(t)630 3992 y(list.)72 b(Subsequen)m(tly)-8
b(,)43 b(expands)c(to)j(the)e(last)i(argumen)m(t)f(to)g(the)g(previous)
f(command,)630 4102 y(after)35 b(expansion.)54 b(Also)36
b(set)f(to)h(the)f(full)f(pathname)h(used)f(to)h(in)m(v)m(ok)m(e)i(eac)
m(h)f(command)630 4211 y(executed)42 b(and)e(placed)i(in)e(the)h(en)m
(vironmen)m(t)h(exp)s(orted)f(to)g(that)h(command.)72
b(When)630 4321 y(c)m(hec)m(king)32 b(mail,)f(this)g(parameter)g(holds)
e(the)i(name)f(of)h(the)g(mail)g(\014le.)150 4580 y Fr(3.5)68
b(Shell)45 b(Expansions)275 4825 y Ft(Expansion)29 b(is)h(p)s(erformed)
e(on)i(the)g(command)g(line)g(after)h(it)f(has)g(b)s(een)f(split)h(in)m
(to)h Fs(token)p Ft(s.)39 b(There)150 4935 y(are)31 b(sev)m(en)g(kinds)
e(of)i(expansion)f(p)s(erformed:)225 5070 y Fp(\017)60
b Ft(brace)31 b(expansion)225 5205 y Fp(\017)60 b Ft(tilde)31
b(expansion)225 5340 y Fp(\017)60 b Ft(parameter)31 b(and)f(v)-5
b(ariable)31 b(expansion)p eop end
%%Page: 17 23
TeXDict begin 17 22 bop 150 -116 a Ft(Chapter)30 b(3:)41
b(Basic)32 b(Shell)e(F)-8 b(eatures)2246 b(17)225 299
@@ -11848,23 +11849,23 @@ Fs(FIGNORE)f Ft(shell)150 1093 y(v)-5 b(ariable)31 b(is)g(used.)275
b(The)33 b(string)150 1340 y(is)g(\014rst)e(split)i(using)f(the)h(c)m
(haracters)h(in)e(the)h Fs(IFS)e Ft(sp)s(ecial)j(v)-5
b(ariable)33 b(as)g(delimiters.)48 b(Shell)32 b(quoting)h(is)150
1450 y(honored.)k(Eac)m(h)21 b(w)m(ord)g(is)g(then)f(expanded)g(using)h
(brace)g(expansion,)i(tilde)e(expansion,)i(parameter)f(and)150
1559 y(v)-5 b(ariable)26 b(expansion,)g(command)f(substitution,)h
(arithmetic)g(expansion,)g(and)f(pathname)g(expansion,)150
1669 y(as)j(describ)s(ed)e(ab)s(o)m(v)m(e)j(\(see)f(Section)h(3.5)f
([Shell)g(Expansions],)f(page)i(16\).)41 b(The)27 b(results)g(are)h
(split)f(using)150 1778 y(the)33 b(rules)g(describ)s(ed)e(ab)s(o)m(v)m
(e)j(\(see)g(Section)g(3.5.7)h([W)-8 b(ord)33 b(Splitting],)i(page)e
(22\).)50 b(The)32 b(results)h(of)g(the)150 1888 y(expansion)h(are)h
(pre\014x-matc)m(hed)f(against)i(the)e(w)m(ord)g(b)s(eing)g(completed,)
j(and)d(the)g(matc)m(hing)h(w)m(ords)150 1998 y(b)s(ecome)c(the)f(p)s
(ossible)g(completions.)275 2134 y(After)f(these)g(matc)m(hes)i(ha)m(v)
m(e)f(b)s(een)f(generated,)h(an)m(y)g(shell)f(function)g(or)g(command)g
(sp)s(eci\014ed)f(with)150 2244 y(the)i(`)p Fs(-F)p Ft(')g(and)f(`)p
Fs(-C)p Ft(')h(options)g(is)g(in)m(v)m(ok)m(ed.)41 b(When)30
b(the)g(command)g(or)f(function)h(is)g(in)m(v)m(ok)m(ed,)h(the)f
Fs(COMP_)150 2354 y(LINE)21 b Ft(and)h Fs(COMP_POINT)d
1450 y(honored.)56 b(Eac)m(h)37 b(w)m(ord)e(is)h(then)f(expanded)g
(using)h(brace)g(expansion,)h(tilde)f(expansion,)h(parameter)150
1559 y(and)44 b(v)-5 b(ariable)46 b(expansion,)j(command)44
b(substitution,)49 b(and)44 b(arithmetic)i(expansion,)j(as)c(describ)s
(ed)150 1669 y(ab)s(o)m(v)m(e)38 b(\(see)f(Section)h(3.5)g([Shell)e
(Expansions],)i(page)f(16\).)61 b(The)36 b(results)h(are)g(split)f
(using)h(the)f(rules)150 1778 y(describ)s(ed)29 b(ab)s(o)m(v)m(e)i
(\(see)f(Section)h(3.5.7)h([W)-8 b(ord)30 b(Splitting],)h(page)f(22\).)
42 b(The)30 b(results)f(of)h(the)g(expansion)150 1888
y(are)f(pre\014x-matc)m(hed)h(against)g(the)f(w)m(ord)g(b)s(eing)f
(completed,)j(and)d(the)i(matc)m(hing)g(w)m(ords)e(b)s(ecome)i(the)150
1998 y(p)s(ossible)g(completions.)275 2134 y(After)f(these)g(matc)m
(hes)i(ha)m(v)m(e)f(b)s(een)f(generated,)h(an)m(y)g(shell)f(function)g
(or)g(command)g(sp)s(eci\014ed)f(with)150 2244 y(the)i(`)p
Fs(-F)p Ft(')g(and)f(`)p Fs(-C)p Ft(')h(options)g(is)g(in)m(v)m(ok)m
(ed.)41 b(When)30 b(the)g(command)g(or)f(function)h(is)g(in)m(v)m(ok)m
(ed,)h(the)f Fs(COMP_)150 2354 y(LINE)21 b Ft(and)h Fs(COMP_POINT)d
Ft(v)-5 b(ariables)23 b(are)g(assigned)g(v)-5 b(alues)22
b(as)h(describ)s(ed)e(ab)s(o)m(v)m(e)j(\(see)f(Section)g(5.2)h([Bash)
150 2463 y(V)-8 b(ariables],)33 b(page)f(55\).)44 b(If)30