commit bash-20200907 snapshot

This commit is contained in:
Chet Ramey
2020-09-21 08:52:51 -04:00
parent f43f678557
commit 9c10def123
21 changed files with 571 additions and 538 deletions
+71 -70
View File
@@ -1,7 +1,7 @@
%!PS-Adobe-2.0
%%Creator: dvips(k) 5.999 Copyright 2019 Radical Eye Software
%%Title: bashref.dvi
%%CreationDate: Fri Aug 7 15:58:17 2020
%%CreationDate: Mon Sep 7 13:52:24 2020
%%Pages: 189
%%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 2020.08.07:1158
%DVIPSSource: TeX output 2020.09.07:0952
%%BeginProcSet: tex.pro 0 0
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -7622,10 +7622,10 @@ 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(3)e(August)h
(2020\).)150 4523 y(This)g(is)g(Edition)h(5.1,)h(last)f(up)s(dated)e(3)
i(August)f(2020,)j(of)e Fr(The)e(GNU)j(Bash)e(Reference)h(Man)m(ual)p
Fu(,)h(for)150 4633 y Ft(Bash)p Fu(,)c(V)-8 b(ersion)31
(the)h(Bash)f(shell)h(\(v)m(ersion)150 4389 y(5.1,)c(25)f(August)f
(2020\).)150 4523 y(This)e(is)g(Edition)h(5.1,)h(last)f(up)s(dated)e
(25)i(August)f(2020,)j(of)e Fr(The)f(GNU)h(Bash)f(Reference)h(Man)m
(ual)p Fu(,)h(for)150 4633 y Ft(Bash)p Fu(,)f(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{2018)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
@@ -14054,74 +14054,74 @@ TeXDict begin 82 87 bop 150 -116 a Fu(Chapter)30 b(5:)41
b(Shell)30 b(V)-8 b(ariables)2459 b(82)150 299 y Ft(LC_NUMERIC)630
408 y Fu(This)30 b(v)-5 b(ariable)31 b(determines)f(the)h(lo)s(cale)h
(category)g(used)e(for)g(n)m(um)m(b)s(er)f(formatting.)150
565 y Ft(LC_TIME)144 b Fu(This)25 b(v)-5 b(ariable)26
573 y Ft(LC_TIME)144 b Fu(This)25 b(v)-5 b(ariable)26
b(determines)g(the)g(lo)s(cale)h(category)h(used)d(for)g(data)h(and)f
(time)i(formatting.)150 722 y Ft(LINENO)192 b Fu(The)32
(time)i(formatting.)150 737 y Ft(LINENO)192 b Fu(The)32
b(line)h(n)m(um)m(b)s(er)e(in)i(the)f(script)h(or)f(shell)h(function)f
(curren)m(tly)h(executing.)49 b(If)32 b Ft(LINENO)630
831 y Fu(is)e(unset,)h(it)g(loses)g(its)f(sp)s(ecial)h(prop)s(erties,)f
847 y Fu(is)e(unset,)h(it)g(loses)g(its)f(sp)s(ecial)h(prop)s(erties,)f
(ev)m(en)h(if)g(it)g(is)f(subsequen)m(tly)g(reset.)150
988 y Ft(LINES)240 b Fu(Used)43 b(b)m(y)g(the)g Ft(select)e
1011 y Ft(LINES)240 b Fu(Used)43 b(b)m(y)g(the)g Ft(select)e
Fu(command)i(to)g(determine)g(the)g(column)g(length)g(for)g(prin)m
(ting)630 1097 y(selection)c(lists.)63 b(Automatically)41
(ting)630 1121 y(selection)c(lists.)63 b(Automatically)41
b(set)d(if)f(the)h Ft(checkwinsize)d Fu(option)j(is)f(enabled)h(\(see)
630 1207 y(Section)44 b(4.3.2)h([The)e(Shopt)g(Builtin],)k(page)d
630 1230 y(Section)44 b(4.3.2)h([The)e(Shopt)g(Builtin],)k(page)d
(66\),)k(or)43 b(in)g(an)g(in)m(teractiv)m(e)j(shell)e(up)s(on)630
1316 y(receipt)31 b(of)g(a)g Ft(SIGWINCH)p Fu(.)150 1473
1340 y(receipt)31 b(of)g(a)g Ft(SIGWINCH)p Fu(.)150 1504
y Ft(MACHTYPE)96 b Fu(A)26 b(string)g(that)h(fully)f(describ)s(es)f
(the)h(system)g(t)m(yp)s(e)h(on)f(whic)m(h)f(Bash)i(is)f(executing,)i
(in)e(the)630 1583 y(standard)k Fm(gnu)g Fr(cpu-compan)m(y-system)h
Fu(format.)150 1739 y Ft(MAILCHECK)630 1849 y Fu(Ho)m(w)d(often)g(\(in)
(in)e(the)630 1614 y(standard)k Fm(gnu)g Fr(cpu-compan)m(y-system)h
Fu(format.)150 1778 y Ft(MAILCHECK)630 1888 y Fu(Ho)m(w)d(often)g(\(in)
g(seconds\))g(that)g(the)f(shell)h(should)f(c)m(hec)m(k)i(for)e(mail)h
(in)f(the)h(\014les)g(sp)s(eci\014ed)630 1958 y(in)i(the)h
(in)f(the)h(\014les)g(sp)s(eci\014ed)630 1998 y(in)i(the)h
Ft(MAILPATH)e Fu(or)i Ft(MAIL)e Fu(v)-5 b(ariables.)43
b(The)30 b(default)h(is)f(60)i(seconds.)42 b(When)30
b(it)h(is)g(time)630 2068 y(to)37 b(c)m(hec)m(k)h(for)e(mail,)j(the)e
b(it)h(is)g(time)630 2107 y(to)37 b(c)m(hec)m(k)h(for)e(mail,)j(the)e
(shell)f(do)s(es)g(so)h(b)s(efore)f(displa)m(ying)h(the)f(primary)g
(prompt.)57 b(If)630 2178 y(this)37 b(v)-5 b(ariable)38
(prompt.)57 b(If)630 2217 y(this)37 b(v)-5 b(ariable)38
b(is)f(unset,)h(or)f(set)h(to)g(a)f(v)-5 b(alue)38 b(that)f(is)g(not)h
(a)f(n)m(um)m(b)s(er)f(greater)i(than)f(or)630 2287 y(equal)31
(a)f(n)m(um)m(b)s(er)f(greater)i(than)f(or)630 2326 y(equal)31
b(to)g(zero,)g(the)g(shell)g(disables)f(mail)h(c)m(hec)m(king.)150
2444 y Ft(MAPFILE)144 b Fu(An)35 b(arra)m(y)h(v)-5 b(ariable)36
2491 y Ft(MAPFILE)144 b Fu(An)35 b(arra)m(y)h(v)-5 b(ariable)36
b(created)g(to)h(hold)e(the)g(text)i(read)e(b)m(y)g(the)h
Ft(mapfile)d Fu(builtin)i(when)630 2553 y(no)30 b(v)-5
b(ariable)31 b(name)g(is)f(supplied.)150 2710 y Ft(OLDPWD)192
Ft(mapfile)d Fu(builtin)i(when)630 2600 y(no)30 b(v)-5
b(ariable)31 b(name)g(is)f(supplied.)150 2765 y Ft(OLDPWD)192
b Fu(The)30 b(previous)g(w)m(orking)g(directory)h(as)g(set)g(b)m(y)f
(the)h Ft(cd)e Fu(builtin.)150 2866 y Ft(OPTERR)192 b
(the)h Ft(cd)e Fu(builtin.)150 2929 y Ft(OPTERR)192 b
Fu(If)35 b(set)i(to)f(the)h(v)-5 b(alue)36 b(1,)i(Bash)e(displa)m(ys)g
(error)f(messages)i(generated)g(b)m(y)f(the)g Ft(getopts)630
2976 y Fu(builtin)30 b(command.)150 3133 y Ft(OSTYPE)192
3039 y Fu(builtin)30 b(command.)150 3203 y Ft(OSTYPE)192
b Fu(A)30 b(string)h(describing)f(the)g(op)s(erating)h(system)g(Bash)f
(is)h(running)d(on.)150 3289 y Ft(PIPESTATUS)630 3399
(is)h(running)d(on.)150 3367 y Ft(PIPESTATUS)630 3477
y Fu(An)23 b(arra)m(y)h(v)-5 b(ariable)24 b(\(see)h(Section)f(6.7)h
([Arra)m(ys],)g(page)f(95\))h(con)m(taining)g(a)f(list)g(of)g(exit)g
(sta-)630 3508 y(tus)h(v)-5 b(alues)27 b(from)e(the)h(pro)s(cesses)g
(sta-)630 3587 y(tus)h(v)-5 b(alues)27 b(from)e(the)h(pro)s(cesses)g
(in)f(the)h(most-recen)m(tly-executed)j(foreground)c(pip)s(eline)630
3618 y(\(whic)m(h)30 b(ma)m(y)h(con)m(tain)h(only)f(a)f(single)h
(command\).)150 3774 y Ft(POSIXLY_CORRECT)630 3884 y
3696 y(\(whic)m(h)30 b(ma)m(y)h(con)m(tain)h(only)f(a)f(single)h
(command\).)150 3861 y Ft(POSIXLY_CORRECT)630 3970 y
Fu(If)h(this)g(v)-5 b(ariable)34 b(is)e(in)g(the)h(en)m(vironmen)m(t)g
(when)e(Bash)i(starts,)g(the)g(shell)g(en)m(ters)g Fm(posix)630
3994 y Fu(mo)s(de)46 b(\(see)h(Section)g(6.11)g([Bash)g(POSIX)e(Mo)s
4080 y Fu(mo)s(de)46 b(\(see)h(Section)g(6.11)g([Bash)g(POSIX)e(Mo)s
(de],)50 b(page)d(101\))h(b)s(efore)e(reading)g(the)630
4103 y(startup)38 b(\014les,)j(as)e(if)g(the)g Ft(--posix)d
4189 y(startup)38 b(\014les,)j(as)e(if)g(the)g Ft(--posix)d
Fu(in)m(v)m(o)s(cation)41 b(option)e(had)f(b)s(een)g(supplied.)64
b(If)39 b(it)g(is)630 4213 y(set)31 b(while)f(the)h(shell)f(is)h
b(If)39 b(it)g(is)630 4299 y(set)31 b(while)f(the)h(shell)f(is)h
(running,)e(Bash)h(enables)h Fm(posix)f Fu(mo)s(de,)g(as)g(if)h(the)f
(command)870 4346 y Ft(set)47 b(-o)g(posix)630 4479 y
(command)870 4436 y Ft(set)47 b(-o)g(posix)630 4573 y
Fu(had)33 b(b)s(een)g(executed.)51 b(When)33 b(the)h(shell)f(en)m(ters)
h Fm(posix)f Fu(mo)s(de,)h(it)g(sets)g(this)g(v)-5 b(ariable)34
b(if)630 4589 y(it)d(w)m(as)g(not)f(already)h(set.)150
4745 y Ft(PPID)288 b Fu(The)30 b(pro)s(cess)g Fm(id)g
b(if)630 4682 y(it)d(w)m(as)g(not)f(already)h(set.)150
4847 y Ft(PPID)288 b Fu(The)30 b(pro)s(cess)g Fm(id)g
Fu(of)h(the)f(shell's)h(paren)m(t)g(pro)s(cess.)40 b(This)30
b(v)-5 b(ariable)31 b(is)f(readonly)-8 b(.)150 4902 y
Ft(PROMPT_COMMANDS)630 5011 y Fu(If)38 b(this)g(arra)m(y)h(v)-5
b(ariable)39 b(is)f(set,)j(the)e(v)-5 b(alue)39 b(of)f(eac)m(h)h(set)g
(elemen)m(t)h(is)e(in)m(terpreted)h(as)g(a)630 5121 y(command)31
b(to)g(execute)h(b)s(efore)e(prin)m(ting)h(the)g(primary)f(prompt)g(\()
p Ft($PS1)p Fu(\).)41 b(If)30 b(this)h(is)g(not)630 5230
y(set,)36 b(but)e Ft(PROMPT_COMMAND)d Fu(is)j(set)h(to)h(a)f(v)-5
b(alue,)36 b(its)f(v)-5 b(alue)35 b(is)f(used)g(as)h(a)g(command)f(to)
630 5340 y(execute)e(instead.)p eop end
b(v)-5 b(ariable)31 b(is)f(readonly)-8 b(.)150 5011 y
Ft(PROMPT_COMMAND)630 5121 y Fu(If)23 b(this)h(v)-5 b(ariable)24
b(is)g(set,)i(and)d(is)h(an)f(arra)m(y)-8 b(,)27 b(the)d(v)-5
b(alue)24 b(of)g(eac)m(h)g(set)h(elemen)m(t)g(is)f(in)m(terpreted)630
5230 y(as)29 b(a)g(command)f(to)i(execute)g(b)s(efore)e(prin)m(ting)h
(the)g(primary)f(prompt)f(\()p Ft($PS1)p Fu(\).)40 b(If)28
b(this)h(is)630 5340 y(set)c(but)f(not)g(an)h(arra)m(y)g(v)-5
b(ariable,)26 b(its)f(v)-5 b(alue)25 b(is)f(used)g(as)h(a)f(command)g
(to)i(execute)f(instead.)p eop end
%%Page: 83 89
TeXDict begin 83 88 bop 150 -116 a Fu(Chapter)30 b(5:)41
b(Shell)30 b(V)-8 b(ariables)2459 b(83)150 299 y Ft(PROMPT_DIRTRIM)630
@@ -21260,33 +21260,34 @@ g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g
(:)g(:)g(:)32 b Fb(82)150 758 y Fe(PPID)11 b Fc(:)j(:)f(:)g(:)h(:)f(:)g
(:)g(:)g(:)g(:)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(:)25 b Fb(82)150 846 y Fe(PROMPT_COMMANDS)17 b Fc(:)g(:)c(:)g(:)g
(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)
h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)32 b Fb(82)150 933 y
Fe(PROMPT_DIRTRIM)23 b Fc(:)13 b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)
g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f
(:)g(:)g(:)34 b Fb(83)150 1020 y Fe(PS0)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g
(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)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(:)28 b Fb(83)150 1107 y Fe(PS1)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g
(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)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(:)28 b Fb(73)150 1194 y Fe(PS2)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g
(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)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(:)28 b Fb(73)150 1281 y Fe(PS3)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g
(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)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(:)28 b Fb(83)150 1369 y Fe(PS4)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g
(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)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(:)28 b Fb(83)150 1456 y Fe(PWD)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g
(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)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(:)28 b Fb(83)146 1689 y Fs(R)150 1804 y Fe(RANDOM)6
b Fc(:)15 b(:)e(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g
(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)
g(:)g(:)g(:)g(:)g(:)h(:)f(:)20 b Fb(83)150 1892 y Fe(READLINE_LINE)25
(:)h(:)25 b Fb(82)150 846 y Fe(PROMPT_COMMAND)e Fc(:)13
b(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g
(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)34
b Fb(82)150 933 y Fe(PROMPT_DIRTRIM)23 b Fc(:)13 b(:)g(:)g(:)g(:)h(:)f
(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)
g(:)g(:)g(:)h(:)f(:)g(:)g(:)34 b Fb(83)150 1020 y Fe(PS0)14
b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)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(:)28 b Fb(83)150
1107 y Fe(PS1)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g
(:)g(:)g(:)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(:)28
b Fb(73)150 1194 y Fe(PS2)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h
(:)f(:)g(:)g(:)g(:)g(:)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(:)28
b Fb(73)150 1281 y Fe(PS3)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h
(:)f(:)g(:)g(:)g(:)g(:)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(:)28
b Fb(83)150 1369 y Fe(PS4)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h
(:)f(:)g(:)g(:)g(:)g(:)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(:)28
b Fb(83)150 1456 y Fe(PWD)14 b Fc(:)f(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)h
(:)f(:)g(:)g(:)g(:)g(:)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(:)28
b Fb(83)146 1689 y Fs(R)150 1804 y Fe(RANDOM)6 b Fc(:)15
b(:)e(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f
(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)
g(:)g(:)g(:)h(:)f(:)20 b Fb(83)150 1892 y Fe(READLINE_LINE)25
b Fc(:)13 b(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g
(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)g(:)h(:)f(:)g(:)g(:)g(:)g(:)g(:)37
b Fb(83)150 1979 y Fe(READLINE_MARK)25 b Fc(:)13 b(:)h(:)f(:)g(:)g(:)g