2.81(\214x suf)-.18 F<8c78>-.18 E F0(is appended to each possible completion after all other options ha)2.5E .3 -.15(ve b)-.2 H(een applied.).15 E F1<ad57>144 168 Q F2(wor)2.5 E(dlist)-.37 E F0(The)184 180 Q F2(wor)3.64 E(dlist)-.37 E F0 1.14(is split using the characters in the)3.64 F/F3 9/Times-Bold@0 SF(IFS)3.64 E F0 1.139(special v)3.39 F 1.139(ariable as delimiters, and)-.25 F2.007(each resultant w)184 192 R 2.007(ord is e)-.1 F 4.507(xpanded. The)-.15 F 2.008(possible completions are the members of the)4.507 F(resultant list which match the w)184 204 Q(ord being completed.)-.1 E F1<ad58>144 216 Q F2(\214lterpat)2.5 E(\214lterpat)184 228 Q F0.456(is a pattern as used for pathname e)2.956 F 2.956(xpansion. It)-.15F .455(is applied to the list of possible)2.956 F 1.596(completions generated by the preceding options and ar)184 240 R 1.596(guments, and each completion)-.18 F(matching)184 252 Q F2(\214lterpat)3.205 E F0 .705(is remo)3.205 F -.15(ve)-.15 G 3.205(df).15 G .704(rom the list.)-3.205 F 3.204(Al)5.704 G(eading)-3.204 E F1(!)3.204 E F0(in)3.204 E F2(\214lterpat)3.204 E F0(ne)3.204 E -.05(ga)-.15 G .704(tes the pattern;).05 F(in this case, an)184 264 Q 2.5(yc)-.15 G(ompletion not matching)-2.5 E F2(\214lterpat)2.5 E F0(is remo)2.5 E-.15(ve)-.15 G(d.).15 E .466(The return v)144 280.8 R .466(alue is true unless an in)-.25 F -.25(va)-.4 G .466(lid option is supplied, an option other than).25 F F1<ad70>2.967 E F0(or)2.967 E F1<ad72>2.967 E F0 .467(is sup-)2.967 F 1.362(plied without a)144 292.8 R F2(name)3.862 E F0(ar)3.862 E 1.361(gument, an attempt is made to remo)-.18 F 1.661 -.15(ve a c)-.15 H1.361(ompletion speci\214cation for a).15 F F2(name)144 304.8 Q F0(for which no speci\214cation e)2.5 E(xists, or an error occurs adding a completion speci\214cation.)-.15 EF1(compopt)108 321.6 Q F0([)2.5 E F1<ad6f>A F2(option)2.5 E F0 2.5(][)CF1(\255DE)-2.5 E F0 2.5(][)C F1(+o)-2.5 E F2(option)2.5 E F0 2.5(][)C F2(name)-2.5 E F0(])A .447(Modify completion options for each)144 333.6 RF2(name)2.947 E F0 .447(according to the)2.947 F F2(option)2.947 E F0.447(s, or for the currently-e)B -.15(xe)-.15 G(cuting).15 E .726(completion if no)144 345.6 R F2(name)3.226 E F0 3.226(sa)C .726(re supplied.)-3.226 F .725(If no)5.725 F F2(option)3.225 E F0 3.225(sa)C .725(re gi)-3.225 F -.15(ve)-.25 G .725(n, display the completion options for).15 F(each)144 357.6 Q F2(name)3.223 E F0 .723(or the current completion.)3.223 F .724(The possible v)5.724 F .724(alues of)-.25 F F2(option)3.224 E F0 .724(are those v)3.224F .724(alid for the)-.25 F F1(com-)3.224 E(plete)144 369.6 Q F0 -.2(bu)2.798 G .298(iltin described abo).2 F -.15(ve)-.15 G 5.297(.T).15 G(he)-5.297 E F1<ad44>2.797 E F0 .297(option indicates that the remaining options should apply to)2.797 F1.227(the `)144 381.6 R(`def)-.74 E(ault')-.1 E 3.727('c)-.74 G 1.228(o\mmand completion; that is, completion attempted on a command for which \no)-3.727 F 2.178(completion has pre)144 393.6 R 2.178(viously been de\214ned.)-.25 F(The)7.178 E F1<ad45>4.678 E F0 2.177(option indicates that the remaining options)4.677 F(should apply to `)144 405.6 Q(`empty')-.74 E 2.5('c)-.74 G(ommand completion; that is, completion attempted on a blank line.)-2.5E 1.387(The return v)144 429.6 R 1.387(alue is true unless an in)-.25 F-.25(va)-.4 G 1.388(lid option is supplied, an attempt is made to modify the).25 F(options for a)144 441.6 Q F2(name)2.5 E F0(for which no completion speci\214cation e)2.5 E(xists, or an output error occurs.)-.15 E F1(continue)108 458.4 Q F0([)2.5 E F2(n)A F0(])A 1.754(Resume the ne)144 470.4 R 1.754(xt iteration of the enclosing)-.15 F F1 -.25(fo)4.254 G(r).25 E F0(,)AF1(while)4.254 E F0(,)A F1(until)4.254 E F0 4.254(,o)C(r)-4.254 E F1(select)4.254 E F0 4.253(loop. If)4.254 F F2(n)4.613 E F0 1.753(is speci\214ed,)4.493 F 1.208(resume at the)144 482.4 R F2(n)3.709 E F01.209(th enclosing loop.)B F2(n)6.569 E F0 1.209(must be)3.949 F/F4 10/Symbol SF<b3>3.709 E F0 3.709(1. If)3.709 F F2(n)4.069 E F0 1.209(is greater than the number of enclosing)3.949 F .514(loops, the last enclosing loop \(the `)144 494.4 R(`top-le)-.74 E -.15(ve)-.25 G(l').15 E 3.014('l)-.74 G .514(oop\) is resumed.)-3.014 F .513(The return v)5.513 F .513(alue is 0 unless)-.25 F F2(n)3.013 E F0(is)3.013 E(not greater than or equal to 1.)144 506.4 Q F1(declar)108 523.2Q(e)-.18 E F0([)2.5 E F1(\255aAfFgilrtux)A F0 2.5(][)C F1<ad70>-2.5 E F02.5(][)C F2(name)-2.5 E F0([=)A F2(value)A F0 2.5(].)C(..])-2.5 E F1(typeset)108 535.2 Q F0([)2.5 E F1(\255aAfFgilrtux)A F0 2.5(][)C F1<ad70>-2.5 E F0 2.5(][)C F2(name)-2.5 E F0([=)A F2(value)A F0 2.5(].)C(..])-2.5 E 1.264(Declare v)144 547.2 R 1.264(ariables and/or gi)-.25 F1.564 -.15(ve t)-.25 H 1.264(hem attrib).15 F 3.765(utes. If)-.2 F(no)3.765 E F2(name)3.765 E F0 3.765(sa)C 1.265(re gi)-3.765 F -.15(ve)-.25G 3.765(nt).15 G 1.265(hen display the v)-3.765 F 1.265(alues of)-.25 F-.25(va)144 559.2 S 3.483(riables. The).25 F F1<ad70>3.483 E F0 .983(option will display the attrib)3.483 F .983(utes and v)-.2 F .982(alues of each)-.25 F F2(name)3.482 E F0 5.982(.W).18 G(hen)-5.982 E F1<ad70>3.482 E F0 .982(is used)3.482 F(with)144 571.2 Q F2(name)3.579 EF0(ar)3.579 E 1.079(guments, additional options are ignored.)-.18 F(When)6.079 E F1<ad70>3.579 E F0 1.079(is supplied without)3.579 F F2(name)3.58 E F0(ar)3.58 E(gu-)-.18 E .151(ments, it will display the attrib)144 583.2 R .151(utes and v)-.2 F.151(alues of all v)-.25 F .15(ariables ha)-.25 F .15(ving the attrib)-.2 F .15(utes speci\214ed by the)-.2 F .046(additional options.)144595.2 R .046(If no other options are supplied with)5.046 F F1<ad70>2.547E F0(,)A F1(declar)2.547 E(e)-.18 E F0 .047(will display the attrib)2.547 F .047(utes and)-.2 F -.25(va)144 607.2 S 1.363(lues of all shell v).25 F 3.863(ariables. The)-.25 F F1<ad66>3.863 E F01.362(option will restrict the display to shell functions.)3.863 F(The)6.362 E F1<ad46>3.862 E F0 2.422(option inhibits the display of functio\n de\214nitions; only the function name and attrib)144 619.2 R 2.423(utes are)-.2 F 2.664(printed. If)144 631.2 R(the)2.664 E F1(extdeb)2.664 E(ug)-.2 E F0 .164(shell option is enabled using)2.664 F F1(shopt)2.664 E F0 2.664(,t)C .163(he source \214le name and line number)-2.664F 1.288(where the function is de\214ned are displayed as well.)144 643.2R(The)6.288 E F1<ad46>3.788 E F0 1.288(option implies)3.788 F F1<ad66>3.788 E F0 6.288(.T)C(he)-6.288 E F1<ad67>3.789 E F0(option)3.789 E .491(forces v)144 655.2 R .491(ariables to be created or modi\214ed at the global scope, e)-.25 F -.15(ve)-.25 G 2.99(nw).15 G(hen)-2.99 E F1(declar)2.99 E(e)-.18 E F0 .49(is e)2.99 F -.15(xe)-.15 G .49(cuted in a).15 F .124(shell function.)144 667.2 R .124(It is ignored in all other cases.)5.124 F .125(The follo)5.125 F .125(wing options can be used to restrict output)-.25F(to v)144 679.2 Q(ariables with the speci\214ed attrib)-.25 E(ute or to gi)-.2 E .3 -.15(ve v)-.25 H(ariables attrib)-.1 E(utes:)-.2E F1<ad61>144 691.2 Q F0(Each)25.3 E F2(name)2.5 E F0(is an inde)2.5 E-.15(xe)-.15 G 2.5(da).15 G(rray v)-2.5 E(ariable \(see)-.25 E F1(Arrays)2.5 E F0(abo)2.5 E -.15(ve)-.15 G(\).).15 E F1<ad41>144 703.2 QF0(Each)23.08 E F2(name)2.5 E F0(is an associati)2.5 E .3 -.15(ve a)-.25H(rray v).15 E(ariable \(see)-.25 E F1(Arrays)2.5 E F0(abo)2.5 E -.15(ve)-.15 G(\).).15 E F1<ad66>144 715.2 Q F0(Use function names only)26.97 E(.)-.65 E(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(5)203.725 E0 Cg EP%%Page: 6 6%%BeginPageSetupBP%%EndPageSetup/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10/Times-Bold@0 SF<ad69>144 84 Q F0 .558(The v)27.52 F .558(ariable is treated as an inte)-.25 F .558(ger; arithmetic e)-.15 F -.25(va)-.25 G .558(luation \(see).25 F/F2 9/Times-Bold@0 SF .557(ARITHMETIC EV)3.058 F(ALU)-1.215 E(A-)-.54 E(TION)180 96 Q F0(abo)2.25E -.15(ve)-.15 G 2.5(\)i).15 G 2.5(sp)-2.5 G(erformed when the v)-2.5 E(ariable is assigned a v)-.25 E(alue.)-.25 E F1<ad6c>144 108 Q F0 .909(When the v)27.52 F .909(ariable is assigned a v)-.25 F .909(alue, all upper)-.25 F .909(-case characters are con)-.2 F -.15(ve)-.4G .91(rted to lo).15 F(wer)-.25 E(-)-.2 E 2.5(case. The)180 120 R(upper)2.5 E(-case attrib)-.2 E(ute is disabled.)-.2 E F1<ad72>144 132 Q F0(Mak)25.86 E(e)-.1 E/F3 10/Times-Italic@0 SF(name)5.047 E F0 5.047(sr)C(eadonly)-5.047 E 7.547(.T)-.65 G 2.546(hese names cannot then be assigned v)-7.547 F 2.546(alues by subsequent)-.25 F(assignment statements or unset.)180 144 Q F1<ad74>144 156 Q F0(Gi)26.97 E .729 -.15(ve e)-.25 H(ach).15 E F3(name)2.929 E F0(the)2.929 E F3(tr)2.929 E(ace)-.15 E F0(attrib)2.929 E 2.929(ute. T)-.2 F .429(raced functions inherit the)-.35 F F1(DEB)2.929 E(UG)-.1 E F0(and)2.93 E F1(RETURN)2.93 E F0(traps from the calling shell.)180 168 Q(The trace attrib)5 E(ute has no special meaning for v)-.2 E(ariables.)-.25 E F1<ad75>144 180 Q F0 .91(When the v)24.74 F .909(ariable is assigned a v)-.25 F .909(alue, all lo)-.25 F(wer)-.25 E .909(-case characters are con)-.2 F -.15(ve)-.4 G .909(rted to upper).15 F(-)-.2 E 2.5(case. The)180 192 R(lo)2.5 E(wer)-.25 E(-case attrib)-.2 E(ute is disabled.)-.2 E F1<ad78>144 204 Q F0(Mark)25.3 E F3(name)2.5 EF0 2.5(sf)C(or e)-2.5 E(xport to subsequent commands via the en)-.15 E(vironment.)-.4 E .12(Using `+' instead of `\255' turns of)144 220.8 R2.62(ft)-.25 G .12(he attrib)-2.62 F .121(ute instead, with the e)-.2 F.121(xceptions that)-.15 F F1(+a)2.621 E F0 .121(may not be used)2.621 F.645(to destro)144 232.8 R 3.145(ya)-.1 G 3.145(na)-3.145 G .645(rray v)-3.145 F .645(ariable and)-.25 F F1(+r)3.145 E F0 .645(will not remo)3.145 F .945 -.15(ve t)-.15 H .645(he readonly attrib).15 F 3.144(ute. When)-.2 F .644(used in a func-)3.144 F .53(tion, mak)144 244.8 R.53(es each)-.1 F F3(name)3.03 E F0 .53(local, as with the)3.03 F F1(local)3.031 E F0 .531(command, unless the)3.031 F F1 .531(\255gP option is supplied, If a)3.031 F -.1(va)144 256.8 S 1.558(riable name is f).1 F(ollo)-.25 E 1.558(wed by =)-.1 F F3(value)A F14.058(,t)C 1.558(he v)-4.058 F 1.557(alue of the v)-.1 F 1.557(ariable is set to)-.1 F F3(value)4.057 E F1 6.557(.T)C 1.557(he r)-6.557 F(etur)-.18 E(n)-.15 E -.1(va)144 268.8 S 1.168(lue is 0 unless an in).1 F -.1(va)-.4 G 1.168(lid option is encounter).1 F 1.168(ed, an attempt is made to de\214ne a function)-.18 F(using)144 280.8 Q/F4 10/Courier@0 SF .312(\255f foo=bar)2.812 F F1 2.812(,a)C2.812(na)-2.812 G .312(ttempt is made to assign a v)-2.812 F .312(alue to a r)-.1 F .312(eadonly v)-.18 F .311(ariable, an attempt)-.1 F.615(is made to assign a v)144 292.8 R .615(alue to an array v)-.1 F.616(ariable without using the compound assignment syn-)-.1 F .26(tax \(see Arrays)144 304.8 R F0(abo)2.76 E -.15(ve)-.15 G .26(\), one of the).15 F F3(names)2.76 E F0 .259(is not a v)2.76 F .259(alid shell v)-.25 F .259(ariable name, an attempt is made to)-.25 F.703(turn of)144 316.8 R 3.203(fr)-.25 G .704(eadonly status for a readonly v)-3.203 F .704(ariable, an attempt is made to turn of)-.25 F 3.204(fa)-.25 G .704(rray status for an)-3.204 F(array v)144 328.8 Q(ariable, or an attempt is made to display a non-e)-.25 E(xistent function with)-.15 E F1<ad66>2.5 E F0(.)A F1(dirs [+)108 345.6Q F3(n)A F1 2.5(][)C<ad>-2.5 E F3(n)A F1 2.5(][)C(\255clpv])-2.5 E F0-.4(Wi)144 357.6 S .329(thout options, displays the list of currently remembered directories.).4 F .328(The def)5.328 F .328(ault display is on a)-.1 F 1.238(single line with directory names separated by spaces.)144 369.6 R 1.238(Directories are added to the list with the)6.238 F F1(pushd)144 381.6 QF0(command; the)2.5 E F1(popd)2.5 E F0(command remo)2.5 E -.15(ve)-.15 G2.5(se).15 G(ntries from the list.)-2.5 E F1(+)144 393.6 Q F3(n)A F01.565(Displays the)25.3 F F3(n)4.065 E F0 1.565(th entry counting from the left of the list sho)B 1.564(wn by)-.25 F F1(dirs)4.064 E F0 1.564(when in)4.064 F -.2(vo)-.4 G -.1(ke).2 G(d).1 E(without options, starting with zero.)180 405.6 Q F1<ad>144 417.6 Q F3(n)A F0 1.194(Displays the)25.3 F F3(n)3.694 E F0 1.194(th entry counting from the right of the list sho)B 1.194(wn by)-.25 FF1(dirs)3.694 E F0 1.194(when in)3.694 F -.2(vo)-.4 G -.1(ke).2 G(d).1 E(without options, starting with zero.)180 429.6 Q F1<ad63>144 441.6 Q F0(Clears the directory stack by deleting all of the entries.)25.86 E F1<ad6c>144 453.6 Q F0 .324(Produces a longer listing; the def)27.52 F.324(ault listing format uses a tilde to denote the home direc-)-.1 F(tory)180 465.6 Q(.)-.65 E F1<ad70>144 477.6 Q F0(Print the directory stack with one entry per line.)24.74 E F1<ad76>144489.6 Q F0 .272(Print the directory stack with one entry per line, pre\\214xing each entry with its inde)25.3 F 2.773(xi)-.15 G 2.773(nt)-2.773G(he)-2.773 E(stack.)180 501.6 Q .258(The return v)144 518.4 R .258(alue is 0 unless an in)-.25 F -.25(va)-.4 G .258(lid option is supplied or).25 F F3(n)2.758 E F0(inde)2.758 E -.15(xe)-.15 G 2.758(sb).15 G -.15(ey)-2.758 G .258(ond the end of the direc-).15 F(tory stack.)144 530.4 Q F1(diso)108 547.2 Q(wn)-.1 E F0([)2.5 E F1(\255ar)A F0 2.5(][)C F1<ad68>-2.5 E F0 2.5(][)C F3(jobspec)-2.5 E F0(...])2.5 E -.4(Wi)144 559.2 S .295(thout options, each).4 F F3(jobspec)4.535 E F0 .295(is remo)3.105 F -.15(ve)-.15 G 2.795(df).15 G .295(rom the table of acti)-2.795 F .595 -.15(ve j)-.25 H 2.795(obs. If).15F F3(jobspec)4.535 E F0 .295(is not present,)3.105 F .423(and neither)144 571.2 R F1<ad61>2.923 E F0(nor)2.923 E F1<ad72>2.923 E F0 .423(is supplied, the shell')2.923 F 2.923(sn)-.55 G .423(otion of the)-2.923 F F3(curr)2.922 E .422(ent job)-.37 F F0 .422(is used.)2.922 F.422(If the)5.422 F F1<ad68>2.922 E F0 .422(option is)2.922 F(gi)144583.2 Q -.15(ve)-.25 G .14(n, each).15 F F3(jobspec)4.38 E F0 .14(is not remo)2.95 F -.15(ve)-.15 G 2.641(df).15 G .141(rom the table, b)-2.641 F .141(ut is mark)-.2 F .141(ed so that)-.1 F F2(SIGHUP)2.641 EF0 .141(is not sent to the)2.391 F .005(job if the shell recei)144 595.2R -.15(ve)-.25 G 2.504(sa).15 G F2(SIGHUP)A/F5 9/Times-Roman@0 SF(.)A F0.004(If no)4.504 F F3(jobspec)4.244 E F0 .004(is present, and neither the)2.814 F F1<ad61>2.504 E F0 .004(nor the)2.504 F F1<ad72>2.504 E F0 .004(option is)2.504 F 1.228(supplied, the)144 607.2 R F3(curr)3.728 E 1.228(ent job)-.37 F F0 1.229(is used.)3.729F 1.229(If no)6.229 F F3(jobspec)5.469 E F0 1.229(is supplied, the)4.039F F1<ad61>3.729 E F0 1.229(option means to remo)3.729 F 1.529 -.15(ve o)-.15 H(r).15 E .657(mark all jobs; the)144 619.2 R F1<ad72>3.157 E F0.657(option without a)3.157 F F3(jobspec)4.897 E F0(ar)3.467 E .656(gument restricts operation to running jobs.)-.18 F(The)5.656 E(return v)144 631.2 Q(alue is 0 unless a)-.25 E F3(jobspec)4.24 E F0(does not specify a v)2.81 E(alid job)-.25 E(.)-.4 E F1(echo)108 648 QF0([)2.5 E F1(\255neE)A F0 2.5(][)C F3(ar)-2.5 E(g)-.37 E F0(...])2.5 E.394(Output the)144 660 R F3(ar)2.894 E(g)-.37 E F0 .394(s, separated by spaces, follo)B .395(wed by a ne)-.25 F 2.895