mirror of
https://https.git.savannah.gnu.org/git/bash.git
synced 2026-07-02 01:40:49 +02:00
extend assoc_expand_once to indexed arrays; rename to array_expand_once, keeping old name as a synonym; udpate shopt documentation
This commit is contained in:
+119
-125
@@ -1,7 +1,7 @@
|
||||
%!PS-Adobe-2.0
|
||||
%%Creator: dvips(k) 2022.1 (TeX Live 2022) Copyright 2022 Radical Eye Software
|
||||
%%Creator: dvips(k) 2021.1 Copyright 2021 Radical Eye Software
|
||||
%%Title: bashref.dvi
|
||||
%%CreationDate: Mon May 22 13:42:16 2023
|
||||
%%CreationDate: Tue Jun 13 14:42:21 2023
|
||||
%%Pages: 200
|
||||
%%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 2023.05.22:0942
|
||||
%DVIPSSource: TeX output 2023.06.13:1042
|
||||
%%BeginProcSet: tex.pro 0 0
|
||||
%!
|
||||
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
|
||||
@@ -7614,7 +7614,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(5.2,)g(for)f
|
||||
Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.2.)3364 1697 y(Ma)m(y)g(2023)150
|
||||
Ft(Bash)g Fu(V)-8 b(ersion)31 b(5.2.)3350 1697 y(June)e(2023)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
|
||||
@@ -7622,16 +7622,15 @@ 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.2,)c(14)f(Ma)m(y)g
|
||||
(2023\).)150 4523 y(This)k(is)h(Edition)f(5.2,)k(last)d(up)s(dated)e
|
||||
(14)j(Ma)m(y)g(2023,)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(5.2.)150 4767 y(Cop)m(yrigh)m(t)602 4764
|
||||
y(c)577 4767 y Fq(\015)f Fu(1988{2023)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(5.2,)c(13)f(June)e
|
||||
(2023\).)150 4523 y(This)34 b(is)h(Edition)g(5.2,)i(last)e(up)s(dated)f
|
||||
(13)h(June)f(2023,)k(of)d Fr(The)f(GNU)i(Bash)f(Reference)g(Man)m(ual)p
|
||||
Fu(,)i(for)150 4633 y Ft(Bash)p Fu(,)29 b(V)-8 b(ersion)31
|
||||
b(5.2.)150 4767 y(Cop)m(yrigh)m(t)602 4764 y(c)577 4767
|
||||
y Fq(\015)f Fu(1988{2023)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
|
||||
@@ -10598,99 +10597,92 @@ h(command;)h(none)f(are)h(treated)g(sp)s(ecially)-8 b(.)275
|
||||
Ft(;)e(})150 4044 y Fu(whic)m(h)38 b(executes)i Fr(command)i
|
||||
Fu(in)d(the)g(curren)m(t)f(execution)i(en)m(vironmen)m(t)f(and)f
|
||||
(captures)h(its)g(output,)150 4153 y(again)31 b(with)f(trailing)i
|
||||
(newlines)e(remo)m(v)m(ed.)275 4293 y(The)g(c)m(haracter)j
|
||||
Fr(c)k Fu(follo)m(wing)c(the)e(op)s(en)g(brace)g(m)m(ust)g(b)s(e)g(a)g
|
||||
(space,)h(tab,)g(newline,)g(`)p Ft(\()p Fu(',)g(or)f(`)p
|
||||
Ft(|)p Fu(',)h(and)150 4403 y(the)39 b(close)i(brace)e(m)m(ust)g(b)s(e)
|
||||
g(in)g(a)g(p)s(osition)h(where)e(a)i(reserv)m(ed)f(w)m(ord)g(ma)m(y)h
|
||||
(app)s(ear)e(\(i.e.,)43 b(preceded)150 4512 y(b)m(y)32
|
||||
b(a)g(command)g(terminator)h(suc)m(h)e(as)h(semicolon\).)47
|
||||
b(Bash)32 b(allo)m(ws)i(the)e(close)h(brace)f(to)h(b)s(e)e(joined)h(to)
|
||||
150 4622 y(the)f(remaining)g(c)m(haracters)h(in)e(the)h(w)m(ord)f
|
||||
(without)h(b)s(eing)f(follo)m(w)m(ed)i(b)m(y)f(a)g(shell)f(metac)m
|
||||
(haracter)k(as)d(a)150 4732 y(reserv)m(ed)g(w)m(ord)f(w)m(ould)g
|
||||
(usually)g(require.)275 4871 y(An)m(y)j(side)h(e\013ects)h(of)e
|
||||
Fr(command)k Fu(tak)m(e)e(e\013ect)h(immediately)e(in)g(the)f(curren)m
|
||||
(t)h(execution)h(en)m(viron-)150 4981 y(men)m(t)d(and)g(p)s(ersist)f
|
||||
(in)g(the)h(curren)m(t)g(en)m(vironmen)m(t)h(after)f(the)g(command)g
|
||||
(completes)h(\(e.g.,)h(the)e Ft(exit)150 5091 y Fu(builtin)e(will)h
|
||||
(exit)g(the)g(shell\).)275 5230 y(This)g(t)m(yp)s(e)i(of)g(command)f
|
||||
(substitution)g(sup)s(er\014cially)g(resem)m(bles)h(executing)h(an)f
|
||||
(unnamed)e(shell)150 5340 y(function:)42 b(lo)s(cal)33
|
||||
b(v)-5 b(ariables)32 b(are)g(created)g(as)g(when)e(a)i(shell)g
|
||||
(function)f(is)g(executing,)i(and)e(the)h Ft(return)p
|
||||
eop end
|
||||
(newlines)e(remo)m(v)m(ed.)275 4293 y(The)40 b(c)m(haracter)i
|
||||
Fr(c)47 b Fu(follo)m(wing)42 b(the)f(op)s(en)g(brace)g(m)m(ust)f(b)s(e)
|
||||
h(a)g(space,)j(tab,)g(newline,)g(or)d(`)p Ft(|)p Fu(',)j(and)150
|
||||
4403 y(the)39 b(close)i(brace)e(m)m(ust)g(b)s(e)g(in)g(a)g(p)s(osition)
|
||||
h(where)e(a)i(reserv)m(ed)f(w)m(ord)g(ma)m(y)h(app)s(ear)e(\(i.e.,)43
|
||||
b(preceded)150 4512 y(b)m(y)32 b(a)g(command)g(terminator)h(suc)m(h)e
|
||||
(as)h(semicolon\).)47 b(Bash)32 b(allo)m(ws)i(the)e(close)h(brace)f(to)
|
||||
h(b)s(e)e(joined)h(to)150 4622 y(the)f(remaining)g(c)m(haracters)h(in)e
|
||||
(the)h(w)m(ord)f(without)h(b)s(eing)f(follo)m(w)m(ed)i(b)m(y)f(a)g
|
||||
(shell)f(metac)m(haracter)k(as)d(a)150 4732 y(reserv)m(ed)g(w)m(ord)f
|
||||
(w)m(ould)g(usually)g(require.)275 4871 y(An)m(y)j(side)h(e\013ects)h
|
||||
(of)e Fr(command)k Fu(tak)m(e)e(e\013ect)h(immediately)e(in)g(the)f
|
||||
(curren)m(t)h(execution)h(en)m(viron-)150 4981 y(men)m(t)d(and)g(p)s
|
||||
(ersist)f(in)g(the)h(curren)m(t)g(en)m(vironmen)m(t)h(after)f(the)g
|
||||
(command)g(completes)h(\(e.g.,)h(the)e Ft(exit)150 5091
|
||||
y Fu(builtin)e(will)h(exit)g(the)g(shell\).)275 5230
|
||||
y(This)g(t)m(yp)s(e)i(of)g(command)f(substitution)g(sup)s(er\014cially)
|
||||
g(resem)m(bles)h(executing)h(an)f(unnamed)e(shell)150
|
||||
5340 y(function:)42 b(lo)s(cal)33 b(v)-5 b(ariables)32
|
||||
b(are)g(created)g(as)g(when)e(a)i(shell)g(function)f(is)g(executing,)i
|
||||
(and)e(the)h Ft(return)p eop end
|
||||
%%Page: 35 41
|
||||
TeXDict begin 35 40 bop 150 -116 a Fu(Chapter)30 b(3:)41
|
||||
b(Basic)32 b(Shell)e(F)-8 b(eatures)2246 b(35)150 299
|
||||
y(builtin)36 b(forces)i Fr(command)i Fu(to)e(complete;)j(ho)m(w)m(ev)m
|
||||
(er,)f(the)d(rest)g(of)g(the)h(execution)g(en)m(vironmen)m(t,)h(in-)150
|
||||
408 y(cluding)30 b(the)h(p)s(ositional)g(parameters,)g(is)f(shared)g
|
||||
(with)g(the)h(caller.)275 539 y(If)24 b(the)h(\014rst)f(c)m(haracter)j
|
||||
(follo)m(wing)f(the)f(op)s(en)f(brace)h(is)g(a)h(`)p
|
||||
Ft(\()p Fu(',)g Fr(command)i Fu(is)d(executed)h(in)e(a)i(subshell,)150
|
||||
648 y(and)33 b Fr(command)k Fu(m)m(ust)d(b)s(e)f(terminated)h(b)m(y)g
|
||||
(a)g(`)p Ft(\))p Fu('.)51 b(This)32 b(is)i(similar)g(to)h(the)f
|
||||
Ft(\()f Fu(comp)s(ound)f(command)150 758 y(\(see)44 b(Section)g
|
||||
(3.2.5.3)h([Command)e(Grouping],)j(page)d(17\).)80 b(If)43
|
||||
b(the)g(\014rst)f(c)m(haracter)j(is)e(a)g(`)p Ft(|)p
|
||||
Fu(',)k(the)150 868 y(construct)26 b(expands)f(to)i(the)e(v)-5
|
||||
b(alue)27 b(of)f(the)g Ft(REPLY)e Fu(shell)i(v)-5 b(ariable)26
|
||||
b(after)h Fr(command)i Fu(executes,)f(without)150 977
|
||||
y(remo)m(ving)i(an)m(y)g(trailing)h(newlines,)f(and)f(the)g(standard)g
|
||||
(output)g(of)h Fr(command)j Fu(remains)c(the)h(same)g(as)150
|
||||
1087 y(in)h(the)g(calling)i(shell.)42 b(Bash)32 b(creates)g
|
||||
Ft(REPLY)e Fu(as)h(an)g(initially-unset)h(lo)s(cal)h(v)-5
|
||||
b(ariable)32 b(when)e Fr(command)150 1196 y Fu(executes,)44
|
||||
b(and)39 b(restores)i Ft(REPLY)d Fu(to)j(the)f(v)-5 b(alue)41
|
||||
b(it)g(had)e(b)s(efore)h(the)g(command)g(substitution)f(after)150
|
||||
1306 y Fr(command)34 b Fu(completes,)e(as)e(with)g(an)m(y)h(lo)s(cal)h
|
||||
(v)-5 b(ariable.)275 1436 y(F)d(or)23 b(example,)i(this)e(construct)g
|
||||
(with)g(the)h(caller.)275 545 y(If)26 b(the)g(\014rst)g(c)m(haracter)i
|
||||
(follo)m(wing)g(the)f(op)s(en)f(brace)h(is)f(a)h(`)p
|
||||
Ft(|)p Fu(',)h(the)f(construct)g(expands)e(to)j(the)e(v)-5
|
||||
b(alue)150 654 y(of)24 b(the)g Ft(REPLY)e Fu(shell)i(v)-5
|
||||
b(ariable)24 b(after)g Fr(command)j Fu(executes,)g(without)d(remo)m
|
||||
(ving)g(an)m(y)g(trailing)h(newlines,)150 764 y(and)h(the)g(standard)f
|
||||
(output)h(of)g Fr(command)k Fu(remains)c(the)g(same)h(as)f(in)g(the)g
|
||||
(calling)i(shell.)39 b(Bash)27 b(creates)150 873 y Ft(REPLY)33
|
||||
b Fu(as)j(an)e(initially-unset)j(lo)s(cal)f(v)-5 b(ariable)35
|
||||
b(when)f Fr(command)39 b Fu(executes,)e(and)d(restores)i
|
||||
Ft(REPLY)d Fu(to)150 983 y(the)i(v)-5 b(alue)34 b(it)h(had)f(b)s(efore)
|
||||
g(the)h(command)f(substitution)g(after)h Fr(command)j
|
||||
Fu(completes,)f(as)d(with)h(an)m(y)150 1093 y(lo)s(cal)d(v)-5
|
||||
b(ariable.)275 1229 y(F)d(or)23 b(example,)i(this)e(construct)g
|
||||
(expands)f(to)i(`)p Ft(12345)p Fu(',)f(and)f(lea)m(v)m(es)j(the)e
|
||||
(shell)g(v)-5 b(ariable)24 b Ft(X)e Fu(unc)m(hanged)150
|
||||
1546 y(in)30 b(the)h(curren)m(t)f(execution)h(en)m(vironmen)m(t:)390
|
||||
1676 y Ft(${)47 b(local)g(X=12345)e(;)j(echo)e($X;)h(})150
|
||||
1806 y Fu(\(not)28 b(declaring)g Ft(X)f Fu(as)g(lo)s(cal)i(w)m(ould)e
|
||||
1339 y(in)30 b(the)h(curren)m(t)f(execution)h(en)m(vironmen)m(t:)390
|
||||
1584 y Ft(${)47 b(local)g(X=12345)e(;)j(echo)e($X;)h(})150
|
||||
1721 y Fu(\(not)28 b(declaring)g Ft(X)f Fu(as)g(lo)s(cal)i(w)m(ould)e
|
||||
(mo)s(dify)f(its)i(v)-5 b(alue)27 b(in)g(the)h(curren)m(t)f(en)m
|
||||
(vironmen)m(t,)i(as)e(with)g(normal)150 1916 y(shell)38
|
||||
(vironmen)m(t,)i(as)e(with)g(normal)150 1830 y(shell)38
|
||||
b(function)g(execution\),)43 b(while)38 b(this)g(construct)h(do)s(es)f
|
||||
(not)g(require)g(an)m(y)h(output)f(to)h(expand)e(to)150
|
||||
2026 y(`)p Ft(12345)p Fu(':)390 2156 y Ft(${|)47 b(REPLY=12345;)d(})150
|
||||
2286 y Fu(and)30 b(restores)h Ft(REPLY)e Fu(to)i(the)f(v)-5
|
||||
1940 y(`)p Ft(12345)p Fu(':)390 2076 y Ft(${|)47 b(REPLY=12345;)d(})150
|
||||
2212 y Fu(and)30 b(restores)h Ft(REPLY)e Fu(to)i(the)f(v)-5
|
||||
b(alue)31 b(it)g(had)f(b)s(efore)g(the)g(command)g(substitution.)275
|
||||
2416 y(Command)22 b(substitutions)g(ma)m(y)i(b)s(e)e(nested.)39
|
||||
2349 y(Command)22 b(substitutions)g(ma)m(y)i(b)s(e)e(nested.)39
|
||||
b(T)-8 b(o)23 b(nest)g(when)f(using)h(the)g(bac)m(kquoted)h(form,)g
|
||||
(escap)s(e)150 2526 y(the)31 b(inner)e(bac)m(kquotes)j(with)e(bac)m
|
||||
(kslashes.)275 2656 y(If)g(the)h(substitution)g(app)s(ears)f(within)h
|
||||
(escap)s(e)150 2458 y(the)31 b(inner)e(bac)m(kquotes)j(with)e(bac)m
|
||||
(kslashes.)275 2594 y(If)g(the)h(substitution)g(app)s(ears)f(within)h
|
||||
(double)f(quotes,)i(Bash)f(do)s(es)g(not)g(p)s(erform)f(w)m(ord)g
|
||||
(splitting)150 2766 y(and)g(\014lename)g(expansion)h(on)f(the)g
|
||||
(results.)150 2957 y Fk(3.5.5)63 b(Arithmetic)40 b(Expansion)150
|
||||
3104 y Fu(Arithmetic)25 b(expansion)g(allo)m(ws)g(the)g(ev)-5
|
||||
(splitting)150 2704 y(and)g(\014lename)g(expansion)h(on)f(the)g
|
||||
(results.)150 2905 y Fk(3.5.5)63 b(Arithmetic)40 b(Expansion)150
|
||||
3052 y Fu(Arithmetic)25 b(expansion)g(allo)m(ws)g(the)g(ev)-5
|
||||
b(aluation)26 b(of)f(an)f(arithmetic)i(expression)e(and)g(the)g
|
||||
(substitution)150 3213 y(of)31 b(the)f(result.)41 b(The)30
|
||||
b(format)g(for)g(arithmetic)i(expansion)e(is:)390 3344
|
||||
y Ft($\(\()47 b Fj(expression)e Ft(\)\))275 3474 y Fu(The)34
|
||||
(substitution)150 3162 y(of)31 b(the)f(result.)41 b(The)30
|
||||
b(format)g(for)g(arithmetic)i(expansion)e(is:)390 3298
|
||||
y Ft($\(\()47 b Fj(expression)e Ft(\)\))275 3434 y Fu(The)34
|
||||
b Fr(expression)h Fu(undergo)s(es)f(the)h(same)h(expansions)e(as)i(if)f
|
||||
(it)g(w)m(ere)h(within)e(double)h(quotes,)i(but)150 3584
|
||||
(it)g(w)m(ere)h(within)e(double)h(quotes,)i(but)150 3544
|
||||
y(double)g(quote)g(c)m(haracters)i(in)d Fr(expression)h
|
||||
Fu(are)g(not)g(treated)h(sp)s(ecially)g(and)f(are)g(remo)m(v)m(ed.)61
|
||||
b(All)38 b(to-)150 3693 y(k)m(ens)c(in)f(the)h(expression)f(undergo)g
|
||||
b(All)38 b(to-)150 3653 y(k)m(ens)c(in)f(the)h(expression)f(undergo)g
|
||||
(parameter)h(and)f(v)-5 b(ariable)34 b(expansion,)h(command)e
|
||||
(substitution,)150 3803 y(and)41 b(quote)i(remo)m(v)-5
|
||||
(substitution,)150 3763 y(and)41 b(quote)i(remo)m(v)-5
|
||||
b(al.)76 b(The)41 b(result)h(is)g(treated)h(as)f(the)g(arithmetic)h
|
||||
(expression)f(to)g(b)s(e)f(ev)-5 b(aluated.)150 3912
|
||||
(expression)f(to)g(b)s(e)f(ev)-5 b(aluated.)150 3872
|
||||
y(Arithmetic)31 b(expansions)f(ma)m(y)h(b)s(e)f(nested.)275
|
||||
4043 y(The)k(ev)-5 b(aluation)37 b(is)f(p)s(erformed)e(according)i(to)g
|
||||
4009 y(The)k(ev)-5 b(aluation)37 b(is)f(p)s(erformed)e(according)i(to)g
|
||||
(the)g(rules)f(listed)h(b)s(elo)m(w)g(\(see)g(Section)g(6.5)h([Shell)
|
||||
150 4152 y(Arithmetic],)29 b(page)e(100\).)41 b(If)27
|
||||
150 4118 y(Arithmetic],)29 b(page)e(100\).)41 b(If)27
|
||||
b(the)f(expression)h(is)f(in)m(v)-5 b(alid,)29 b(Bash)d(prin)m(ts)g(a)i
|
||||
(message)f(indicating)h(failure)150 4262 y(to)j(the)g(standard)e(error)
|
||||
h(and)g(no)g(substitution)g(o)s(ccurs.)150 4453 y Fk(3.5.6)63
|
||||
b(Pro)s(cess)42 b(Substitution)150 4600 y Fu(Pro)s(cess)33
|
||||
(message)f(indicating)h(failure)150 4228 y(to)j(the)g(standard)e(error)
|
||||
h(and)g(no)g(substitution)g(o)s(ccurs.)150 4429 y Fk(3.5.6)63
|
||||
b(Pro)s(cess)42 b(Substitution)150 4576 y Fu(Pro)s(cess)33
|
||||
b(substitution)g(allo)m(ws)i(a)e(pro)s(cess's)g(input)f(or)h(output)g
|
||||
(to)h(b)s(e)f(referred)f(to)i(using)f(a)g(\014lename.)150
|
||||
4709 y(It)d(tak)m(es)i(the)f(form)f(of)390 4839 y Ft(<\()p
|
||||
Fj(list)p Ft(\))150 4970 y Fu(or)390 5100 y Ft(>\()p
|
||||
4685 y(It)d(tak)m(es)i(the)f(form)f(of)390 4822 y Ft(<\()p
|
||||
Fj(list)p Ft(\))150 4958 y Fu(or)390 5094 y Ft(>\()p
|
||||
Fj(list)p Ft(\))150 5230 y Fu(The)e(pro)s(cess)h Fr(list)j
|
||||
Fu(is)d(run)e(async)m(hronously)-8 b(,)30 b(and)e(its)i(input)e(or)h
|
||||
(output)f(app)s(ears)h(as)g(a)g(\014lename.)41 b(This)150
|
||||
@@ -13459,70 +13451,72 @@ Fu(is)g(set)h(to)g(N.)630 4848 y(The)f(return)f(status)i(is)f(alw)m(a)m
|
||||
%%Page: 73 79
|
||||
TeXDict begin 73 78 bop 150 -116 a Fu(Chapter)30 b(4:)41
|
||||
b(Shell)30 b(Builtin)h(Commands)2069 b(73)870 299 y Ft(shopt)46
|
||||
b([-pqsu])g([-o])h([)p Fj(optname)e Ft(...])630 438 y
|
||||
b([-pqsu])g([-o])h([)p Fj(optname)e Ft(...])630 427 y
|
||||
Fu(T)-8 b(oggle)37 b(the)e(v)-5 b(alues)35 b(of)g(settings)h(con)m
|
||||
(trolling)g(optional)g(shell)f(b)s(eha)m(vior.)55 b(The)34
|
||||
b(settings)630 548 y(can)24 b(b)s(e)g(either)h(those)f(listed)h(b)s
|
||||
b(settings)630 536 y(can)24 b(b)s(e)g(either)h(those)f(listed)h(b)s
|
||||
(elo)m(w,)h(or,)f(if)g(the)f Ft(-o)f Fu(option)i(is)f(used,)h(those)g
|
||||
(a)m(v)-5 b(ailable)26 b(with)630 658 y(the)k Ft(-o)f
|
||||
(a)m(v)-5 b(ailable)26 b(with)630 646 y(the)k Ft(-o)f
|
||||
Fu(option)i(to)f(the)g Ft(set)f Fu(builtin)h(command)f(\(see)i(Section)
|
||||
g(4.3.1)g([The)f(Set)g(Builtin],)630 767 y(page)i(68\).)45
|
||||
g(4.3.1)g([The)f(Set)g(Builtin],)630 756 y(page)i(68\).)45
|
||||
b(With)32 b(no)f(options,)h(or)g(with)f(the)g Ft(-p)g
|
||||
Fu(option,)h(a)g(list)g(of)f(all)i(settable)g(options)630
|
||||
877 y(is)g(displa)m(y)m(ed,)i(with)e(an)g(indication)h(of)f(whether)g
|
||||
865 y(is)g(displa)m(y)m(ed,)i(with)e(an)g(indication)h(of)f(whether)g
|
||||
(or)g(not)g(eac)m(h)h(is)g(set;)h(if)e Fr(optname)5 b
|
||||
Fu(s)34 b(are)630 986 y(supplied,)25 b(the)g(output)g(is)g(restricted)g
|
||||
Fu(s)34 b(are)630 975 y(supplied,)25 b(the)g(output)g(is)g(restricted)g
|
||||
(to)h(those)g(options.)39 b(The)24 b Ft(-p)h Fu(option)g(causes)g
|
||||
(output)630 1096 y(to)30 b(b)s(e)f(displa)m(y)m(ed)g(in)g(a)h(form)f
|
||||
(output)630 1084 y(to)30 b(b)s(e)f(displa)m(y)m(ed)g(in)g(a)h(form)f
|
||||
(that)g(ma)m(y)h(b)s(e)f(reused)f(as)i(input.)39 b(Other)29
|
||||
b(options)g(ha)m(v)m(e)i(the)630 1205 y(follo)m(wing)h(meanings:)630
|
||||
1375 y Ft(-s)384 b Fu(Enable)30 b(\(set\))i(eac)m(h)f
|
||||
Fr(optname)p Fu(.)630 1544 y Ft(-u)384 b Fu(Disable)31
|
||||
b(\(unset\))g(eac)m(h)h Fr(optname)p Fu(.)630 1714 y
|
||||
b(options)g(ha)m(v)m(e)i(the)630 1194 y(follo)m(wing)h(meanings:)630
|
||||
1340 y Ft(-s)384 b Fu(Enable)30 b(\(set\))i(eac)m(h)f
|
||||
Fr(optname)p Fu(.)630 1486 y Ft(-u)384 b Fu(Disable)31
|
||||
b(\(unset\))g(eac)m(h)h Fr(optname)p Fu(.)630 1632 y
|
||||
Ft(-q)384 b Fu(Suppresses)28 b(normal)h(output;)h(the)g(return)e
|
||||
(status)i(indicates)h(whether)e(the)1110 1823 y Fr(optname)37
|
||||
(status)i(indicates)h(whether)e(the)1110 1742 y Fr(optname)37
|
||||
b Fu(is)31 b(set)h(or)f(unset.)43 b(If)31 b(m)m(ultiple)h
|
||||
Fr(optname)37 b Fu(argumen)m(ts)31 b(are)h(giv)m(en)1110
|
||||
1933 y(with)d Ft(-q)p Fu(,)f(the)i(return)d(status)j(is)f(zero)g(if)g
|
||||
1851 y(with)d Ft(-q)p Fu(,)f(the)i(return)d(status)j(is)f(zero)g(if)g
|
||||
(all)h Fr(optname)5 b Fu(s)29 b(are)h(enabled;)f(non-)1110
|
||||
2042 y(zero)i(otherwise.)630 2212 y Ft(-o)384 b Fu(Restricts)22
|
||||
1961 y(zero)i(otherwise.)630 2107 y Ft(-o)384 b Fu(Restricts)22
|
||||
b(the)f(v)-5 b(alues)22 b(of)f Fr(optname)27 b Fu(to)22
|
||||
b(b)s(e)e(those)i(de\014ned)e(for)h(the)g Ft(-o)f Fu(option)1110
|
||||
2321 y(to)31 b(the)g Ft(set)e Fu(builtin)h(\(see)h(Section)h(4.3.1)g
|
||||
([The)e(Set)g(Builtin],)i(page)f(68\).)630 2491 y(If)e(either)i
|
||||
2217 y(to)31 b(the)g Ft(set)e Fu(builtin)h(\(see)h(Section)h(4.3.1)g
|
||||
([The)e(Set)g(Builtin],)i(page)f(68\).)630 2363 y(If)e(either)i
|
||||
Ft(-s)e Fu(or)h Ft(-u)f Fu(is)h(used)f(with)g(no)h Fr(optname)35
|
||||
b Fu(argumen)m(ts,)c Ft(shopt)d Fu(sho)m(ws)h(only)h(those)630
|
||||
2600 y(options)h(whic)m(h)f(are)h(set)f(or)h(unset,)f(resp)s(ectiv)m
|
||||
(ely)-8 b(.)630 2740 y(Unless)30 b(otherwise)h(noted,)g(the)g
|
||||
2472 y(options)h(whic)m(h)f(are)h(set)f(or)h(unset,)f(resp)s(ectiv)m
|
||||
(ely)-8 b(.)630 2600 y(Unless)30 b(otherwise)h(noted,)g(the)g
|
||||
Ft(shopt)d Fu(options)j(are)g(disabled)f(\(o\013)7 b(\))32
|
||||
b(b)m(y)e(default.)630 2879 y(The)d(return)f(status)i(when)e(listing)j
|
||||
b(b)m(y)e(default.)630 2728 y(The)d(return)f(status)i(when)e(listing)j
|
||||
(options)e(is)h(zero)g(if)f(all)i Fr(optname)5 b Fu(s)27
|
||||
b(are)h(enabled,)g(non-)630 2989 y(zero)40 b(otherwise.)66
|
||||
b(are)h(enabled,)g(non-)630 2838 y(zero)40 b(otherwise.)66
|
||||
b(When)39 b(setting)h(or)f(unsetting)g(options,)i(the)e(return)f
|
||||
(status)h(is)g(zero)630 3098 y(unless)30 b(an)g Fr(optname)36
|
||||
(status)h(is)g(zero)630 2947 y(unless)30 b(an)g Fr(optname)36
|
||||
b Fu(is)30 b(not)h(a)g(v)-5 b(alid)30 b(shell)h(option.)630
|
||||
3238 y(The)f(list)h(of)f Ft(shopt)f Fu(options)i(is:)630
|
||||
3407 y Ft(assoc_expand_once)1110 3517 y Fu(If)h(set,)i(the)e(shell)h
|
||||
(suppresses)e(m)m(ultiple)i(ev)-5 b(aluation)34 b(of)e(asso)s(ciativ)m
|
||||
(e)j(arra)m(y)1110 3626 y(subscripts)24 b(during)h(arithmetic)h
|
||||
(expression)g(ev)-5 b(aluation,)28 b(while)e(executing)1110
|
||||
3736 y(builtins)c(that)i(can)f(p)s(erform)f(v)-5 b(ariable)24
|
||||
b(assignmen)m(ts,)h(and)e(while)g(executing)1110 3846
|
||||
y(builtins)30 b(that)h(p)s(erform)e(arra)m(y)i(dereferencing.)630
|
||||
4015 y Ft(autocd)192 b Fu(If)27 b(set,)h(a)g(command)f(name)g(that)h
|
||||
(is)f(the)g(name)g(of)h(a)f(directory)h(is)f(executed)1110
|
||||
4125 y(as)j(if)f(it)h(w)m(ere)f(the)h(argumen)m(t)g(to)g(the)f
|
||||
Ft(cd)g Fu(command.)40 b(This)29 b(option)g(is)h(only)1110
|
||||
4234 y(used)g(b)m(y)g(in)m(teractiv)m(e)j(shells.)630
|
||||
4403 y Ft(cdable_vars)1110 4513 y Fu(If)h(this)h(is)g(set,)i(an)e
|
||||
(argumen)m(t)g(to)h(the)f Ft(cd)f Fu(builtin)h(command)f(that)i(is)f
|
||||
(not)1110 4623 y(a)c(directory)g(is)g(assumed)f(to)h(b)s(e)f(the)h
|
||||
(name)f(of)h(a)g(v)-5 b(ariable)31 b(whose)g(v)-5 b(alue)31
|
||||
b(is)1110 4732 y(the)g(directory)f(to)i(c)m(hange)f(to.)630
|
||||
4902 y Ft(cdspell)144 b Fu(If)27 b(set,)h(minor)f(errors)f(in)h(the)g
|
||||
(sp)s(elling)h(of)f(a)g(directory)h(comp)s(onen)m(t)f(in)g(a)h
|
||||
Ft(cd)1110 5011 y Fu(command)i(will)h(b)s(e)f(corrected.)43
|
||||
b(The)30 b(errors)g(c)m(hec)m(k)m(ed)j(for)d(are)h(transp)s(osed)1110
|
||||
3075 y(The)f(list)h(of)f Ft(shopt)f Fu(options)i(is:)630
|
||||
3221 y Ft(array_expand_once)1110 3331 y Fu(If)39 b(set,)j(the)d(shell)g
|
||||
(suppresses)e(m)m(ultiple)j(ev)-5 b(aluation)41 b(of)e(asso)s(ciativ)m
|
||||
(e)j(and)1110 3440 y(indexed)37 b(arra)m(y)h(subscripts)e(during)g
|
||||
(arithmetic)j(expression)e(ev)-5 b(aluation,)1110 3550
|
||||
y(while)23 b(executing)h(builtins)f(that)g(can)h(p)s(erform)d(v)-5
|
||||
b(ariable)24 b(assignmen)m(ts,)i(and)1110 3660 y(while)k(executing)i
|
||||
(builtins)e(that)h(p)s(erform)e(arra)m(y)i(dereferencing.)630
|
||||
3806 y Ft(assoc_expand_once)1110 3915 y Fu(Deprecated;)h(a)f(synon)m
|
||||
(ym)f(for)g Ft(array_expand_once)p Fu(.)630 4061 y Ft(autocd)192
|
||||
b Fu(If)27 b(set,)h(a)g(command)f(name)g(that)h(is)f(the)g(name)g(of)h
|
||||
(a)f(directory)h(is)f(executed)1110 4171 y(as)j(if)f(it)h(w)m(ere)f
|
||||
(the)h(argumen)m(t)g(to)g(the)f Ft(cd)g Fu(command.)40
|
||||
b(This)29 b(option)g(is)h(only)1110 4281 y(used)g(b)m(y)g(in)m
|
||||
(teractiv)m(e)j(shells.)630 4427 y Ft(cdable_vars)1110
|
||||
4536 y Fu(If)h(this)h(is)g(set,)i(an)e(argumen)m(t)g(to)h(the)f
|
||||
Ft(cd)f Fu(builtin)h(command)f(that)i(is)f(not)1110 4646
|
||||
y(a)c(directory)g(is)g(assumed)f(to)h(b)s(e)f(the)h(name)f(of)h(a)g(v)
|
||||
-5 b(ariable)31 b(whose)g(v)-5 b(alue)31 b(is)1110 4756
|
||||
y(the)g(directory)f(to)i(c)m(hange)f(to.)630 4902 y Ft(cdspell)144
|
||||
b Fu(If)27 b(set,)h(minor)f(errors)f(in)h(the)g(sp)s(elling)h(of)f(a)g
|
||||
(directory)h(comp)s(onen)m(t)f(in)g(a)h Ft(cd)1110 5011
|
||||
y Fu(command)i(will)h(b)s(e)f(corrected.)43 b(The)30
|
||||
b(errors)g(c)m(hec)m(k)m(ed)j(for)d(are)h(transp)s(osed)1110
|
||||
5121 y(c)m(haracters,)46 b(a)c(missing)f(c)m(haracter,)47
|
||||
b(and)40 b(a)i(c)m(haracter)h(to)s(o)g(man)m(y)-8 b(.)74
|
||||
b(If)42 b(a)1110 5230 y(correction)25 b(is)e(found,)g(the)h(corrected)g
|
||||
|
||||
Reference in New Issue
Block a user