commit bash-20160624 snapshot

This commit is contained in:
Chet Ramey
2016-07-01 09:20:12 -04:00
parent ae0865bc25
commit d85b4caf90
18 changed files with 581 additions and 555 deletions
+50 -48
View File
@@ -1,7 +1,7 @@
%!PS-Adobe-2.0
%%Creator: dvips(k) 5.995 Copyright 2015 Radical Eye Software
%%Title: bashref.dvi
%%CreationDate: Tue May 10 08:58:18 2016
%%CreationDate: Mon Jun 20 15:38:16 2016
%%Pages: 177
%%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 2016.05.10:0858
%DVIPSSource: TeX output 2016.06.20:1538
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -7596,7 +7596,7 @@ 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(4.4,)g(for)f
Ft(Bash)g Fu(V)-8 b(ersion)31 b(4.4.)3333 1697 y(April)f(2016)150
Ft(Bash)g Fu(V)-8 b(ersion)31 b(4.4.)3364 1697 y(Ma)m(y)g(2016)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
@@ -7604,15 +7604,16 @@ 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(4.4,)c(27)f(April)f
(2016\).)150 4523 y(This)j(is)h(Edition)f(4.4,)j(last)f(up)s(dated)d
(27)j(April)e(2016,)k(of)d Fr(The)f(GNU)h(Bash)g(Reference)g(Man)m(ual)
p Fu(,)i(for)150 4633 y Ft(Bash)p Fu(,)29 b(V)-8 b(ersion)31
b(4.4.)150 4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 4767
y Fq(\015)f Fu(1988{2016)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
(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(4.4,)c(29)f(Ma)m(y)g
(2016\).)150 4523 y(This)k(is)h(Edition)f(4.4,)k(last)d(up)s(dated)e
(29)j(Ma)m(y)g(2016,)i(of)c Fr(The)h(GNU)g(Bash)g(Reference)g(Man)m
(ual)p Fu(,)i(for)150 4633 y Ft(Bash)p Fu(,)29 b(V)-8
b(ersion)31 b(4.4.)150 4767 y(Cop)m(yrigh)m(t)602 4764
y(c)577 4767 y Fq(\015)f Fu(1988{2016)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
b(1.3)g(or)f(an)m(y)h(later)g(v)m(ersion)390 5121 y(published)43
b(b)m(y)h(the)h(F)-8 b(ree)46 b(Soft)m(w)m(are)g(F)-8
@@ -9429,20 +9430,20 @@ b(ariable.)40 b(This)24 b(allo)m(ws)j(v)-5 b(ariables)26
b(to)g(b)s(e)e(manipulated)h(indirectly)-8 b(.)40 b(Whenev)m(er)150
2566 y(the)31 b(nameref)g(v)-5 b(ariable)32 b(is)f(referenced,)g
(assigned)h(to,)g(unset,)f(or)g(has)f(its)i(attributes)f(mo)s(di\014ed)
f(\(other)150 2676 y(than)45 b(the)h(nameref)f(attribute)h(itself)7
b(\),)51 b(the)45 b(op)s(eration)h(is)f(actually)i(p)s(erformed)d(on)i
(the)f(v)-5 b(ariable)150 2785 y(sp)s(eci\014ed)21 b(b)m(y)i(the)f
(nameref)g(v)-5 b(ariable's)23 b(v)-5 b(alue.)39 b(A)22
b(nameref)g(is)g(commonly)h(used)e(within)h(shell)g(functions)150
2895 y(to)34 b(refer)e(to)i(a)f(v)-5 b(ariable)33 b(whose)g(name)g(is)g
(passed)f(as)h(an)g(argumen)m(t)g(to)h(the)f(function.)47
b(F)-8 b(or)34 b(instance,)150 3005 y(if)c(a)h(v)-5 b(ariable)31
b(name)g(is)f(passed)g(to)h(a)g(shell)f(function)g(as)h(its)g(\014rst)e
(argumen)m(t,)j(running)390 3152 y Ft(declare)46 b(-n)h(ref=$1)150
3299 y Fu(inside)31 b(the)h(function)f(creates)i(a)g(nameref)e(v)-5
b(ariable)32 b Fr(ref)49 b Fu(whose)32 b(v)-5 b(alue)32
b(is)g(the)f(v)-5 b(ariable)33 b(name)e(passed)150 3409
y(as)e(the)h(\014rst)e(argumen)m(t.)41 b(References)30
f(\(other)150 2676 y(than)c(using)g(or)h(c)m(hanging)g(the)g(nameref)f
(attribute)i(itself)7 b(\),)29 b(the)d(op)s(eration)h(is)g(actually)h
(p)s(erformed)d(on)150 2785 y(the)31 b(v)-5 b(ariable)31
b(sp)s(eci\014ed)f(b)m(y)g(the)h(nameref)f(v)-5 b(ariable's)31
b(v)-5 b(alue.)42 b(A)30 b(nameref)g(is)h(commonly)g(used)e(within)150
2895 y(shell)h(functions)g(to)h(refer)f(to)h(a)f(v)-5
b(ariable)31 b(whose)f(name)h(is)f(passed)g(as)g(an)g(argumen)m(t)h(to)
g(the)f(function.)150 3005 y(F)-8 b(or)31 b(instance,)g(if)g(a)g(v)-5
b(ariable)31 b(name)f(is)h(passed)e(to)j(a)e(shell)h(function)f(as)h
(its)f(\014rst)g(argumen)m(t,)h(running)390 3152 y Ft(declare)46
b(-n)h(ref=$1)150 3299 y Fu(inside)31 b(the)h(function)f(creates)i(a)g
(nameref)e(v)-5 b(ariable)32 b Fr(ref)49 b Fu(whose)32
b(v)-5 b(alue)32 b(is)g(the)f(v)-5 b(ariable)33 b(name)e(passed)150
3409 y(as)e(the)h(\014rst)e(argumen)m(t.)41 b(References)30
b(and)e(assignmen)m(ts)i(to)g Fr(ref)p Fu(,)f(and)g(c)m(hanges)h(to)g
(its)f(attributes,)i(are)150 3518 y(treated)g(as)f(references,)g
(assignmen)m(ts,)h(and)e(attribute)i(mo)s(di\014cations)f(to)h(the)f(v)
@@ -11898,29 +11899,30 @@ b(alue,)28 b(all)f(upp)s(er-case)e(c)m(haracters)j(are)1110
b(upp)s(er-case)g(attribute)h(is)g(disabled.)630 2516
y Ft(-n)384 b Fu(Giv)m(e)28 b(eac)m(h)g Fr(name)k Fu(the)27
b Fr(nameref)44 b Fu(attribute,)28 b(making)f(it)h(a)f(name)f
(reference)1110 2626 y(to)41 b(another)g(v)-5 b(ariable.)72
b(That)40 b(other)h(v)-5 b(ariable)41 b(is)f(de\014ned)f(b)m(y)i(the)f
(v)-5 b(alue)1110 2735 y(of)36 b Fr(name)p Fu(.)56 b(All)36
(reference)1110 2626 y(to)32 b(another)g(v)-5 b(ariable.)46
b(That)31 b(other)h(v)-5 b(ariable)33 b(is)f(de\014ned)e(b)m(y)i(the)g
(v)-5 b(alue)32 b(of)1110 2735 y Fr(name)p Fu(.)54 b(All)35
b(references,)h(assignmen)m(ts,)h(and)d(attribute)h(mo)s(di\014cations)
1110 2845 y(to)30 b Fr(name)p Fu(,)f(except)h(for)f(c)m(hanging)h(the)f
Ft(-n)g Fu(attribute)h(itself,)g(are)f(p)s(erformed)1110
2954 y(on)g(the)h(v)-5 b(ariable)30 b(referenced)f(b)m(y)h
Fr(name)5 b Fu('s)29 b(v)-5 b(alue.)41 b(The)29 b(nameref)g(attribute)
1110 3064 y(cannot)i(b)s(e)f(applied)g(to)h(arra)m(y)g(v)-5
b(ariables.)630 3224 y Ft(-r)384 b Fu(Mak)m(e)25 b Fr(name)5
b Fu(s)23 b(readonly)-8 b(.)39 b(These)24 b(names)f(cannot)h(then)f(b)s
(e)g(assigned)h(v)-5 b(alues)1110 3334 y(b)m(y)30 b(subsequen)m(t)g
(assignmen)m(t)h(statemen)m(ts)h(or)f(unset.)630 3494
y Ft(-t)384 b Fu(Giv)m(e)33 b(eac)m(h)h Fr(name)j Fu(the)32
b Ft(trace)f Fu(attribute.)46 b(T)-8 b(raced)32 b(functions)g(inherit)g
(the)1110 3603 y Ft(DEBUG)26 b Fu(and)h Ft(RETURN)f Fu(traps)h(from)g
(the)h(calling)h(shell.)40 b(The)27 b(trace)i(attribute)1110
3713 y(has)h(no)g(sp)s(ecial)h(meaning)g(for)f(v)-5 b(ariables.)630
3873 y Ft(-u)384 b Fu(When)28 b(the)h(v)-5 b(ariable)29
b(is)f(assigned)h(a)f(v)-5 b(alue,)30 b(all)f(lo)m(w)m(er-case)i(c)m
(haracters)f(are)1110 3983 y(con)m(v)m(erted)i(to)f(upp)s(er-case.)40
b(The)30 b(lo)m(w)m(er-case)j(attribute)e(is)g(disabled.)630
4143 y Ft(-x)384 b Fu(Mark)30 b(eac)m(h)h Fr(name)k Fu(for)29
g(to)1110 2845 y Fr(name)p Fu(,)27 b(except)f(for)f(those)h(using)f(or)
g(c)m(hanging)h(the)f Ft(-n)g Fu(attribute)h(itself,)i(are)1110
2954 y(p)s(erformed)22 b(on)h(the)g(v)-5 b(ariable)25
b(referenced)e(b)m(y)g Fr(name)5 b Fu('s)23 b(v)-5 b(alue.)39
b(The)23 b(nameref)1110 3064 y(attribute)31 b(cannot)g(b)s(e)f(applied)
g(to)h(arra)m(y)g(v)-5 b(ariables.)630 3224 y Ft(-r)384
b Fu(Mak)m(e)25 b Fr(name)5 b Fu(s)23 b(readonly)-8 b(.)39
b(These)24 b(names)f(cannot)h(then)f(b)s(e)g(assigned)h(v)-5
b(alues)1110 3334 y(b)m(y)30 b(subsequen)m(t)g(assignmen)m(t)h
(statemen)m(ts)h(or)f(unset.)630 3494 y Ft(-t)384 b Fu(Giv)m(e)33
b(eac)m(h)h Fr(name)j Fu(the)32 b Ft(trace)f Fu(attribute.)46
b(T)-8 b(raced)32 b(functions)g(inherit)g(the)1110 3603
y Ft(DEBUG)26 b Fu(and)h Ft(RETURN)f Fu(traps)h(from)g(the)h(calling)h
(shell.)40 b(The)27 b(trace)i(attribute)1110 3713 y(has)h(no)g(sp)s
(ecial)h(meaning)g(for)f(v)-5 b(ariables.)630 3873 y
Ft(-u)384 b Fu(When)28 b(the)h(v)-5 b(ariable)29 b(is)f(assigned)h(a)f
(v)-5 b(alue,)30 b(all)f(lo)m(w)m(er-case)i(c)m(haracters)f(are)1110
3983 y(con)m(v)m(erted)i(to)f(upp)s(er-case.)40 b(The)30
b(lo)m(w)m(er-case)j(attribute)e(is)g(disabled.)630 4143
y Ft(-x)384 b Fu(Mark)30 b(eac)m(h)h Fr(name)k Fu(for)29
b(exp)s(ort)h(to)g(subsequen)m(t)f(commands)h(via)g(the)g(en)m(vi-)1110
4253 y(ronmen)m(t.)630 4413 y(Using)e(`)p Ft(+)p Fu(')h(instead)f(of)g
(`)p Ft(-)p Fu(')g(turns)f(o\013)i(the)f(attribute)h(instead,)g(with)f