2.46 F(ault)-.1 E F1(dir)2.71 E F0 5.21(.T).73 G .21(he v)-5.21 F(ariable)-.25 E F3(CDP)2.71 E -.855(AT)-.666 G(H).855 E F0 .776(de\214nes the search path for the directory containing)144 636 R F1(dir)3.276 E F0 5.777(.A).73 G(lternati)-5.777 E 1.077 -.15(ve d)-.25 H.777(irectory names in).15 F F3(CDP)3.277 E -.855(AT)-.666 G(H).855 E F0.764(are separated by a colon \(:\).)144 648 R 3.264(An)5.764 G .764(ull directory name in)-3.264 F F3(CDP)3.264 E -.855(AT)-.666 G(H).855 EF0 .764(is the same as the current direc-)3.014 F(tory)144 660 Q 2.973(,i)-.65 G .473(.e., `)-2.973 F(`)-.74 E F2(.)A F0 -.74('')C 5.473(.I).74 G(f)-5.473 E F1(dir)3.323 E F0(be)3.703 E .474(gins with a slash \(/\), then)-.15 F F3(CDP)2.974 E -.855(AT)-.666 G(H).855 E F0 .474(is not used. The)2.724 F F2<ad50>2.974 E F0 .474(option says to use)2.974 F .58(the ph)144 672 R .58(ysical directory structure instead of follo)-.05 F .579(wing symbolic links \(see also the)-.25 F F2<ad50>3.079 E F0 .579(option to the)3.079 F F2(set)144 684 Q F0 -.2(bu)2.716 G .216(iltin command\); the).2 F F2<ad4c>2.716 E F0 .216(option forces symbolic links to be follo)2.716 F 2.717(wed. If)-.25 F(the)2.717 E F2<ad65>2.717 E F0 .217(option is sup-)2.717 F 1.087(plied with)144 696 R F2<ad50>3.587 E F0 3.587(,a)C 1.087(nd the current w)-3.587 F 1.086(orking directory cannot be successfully determined after a suc-)-.1 F.44(cessful directory change,)144 708 R F2(cd)2.94 E F0 .44(will return an unsuccessful status.)2.94 F .44(An ar)5.44 F .44(gument of)-.18 F F2<ad>2.94 E F0 .44(is equi)2.94 F -.25(va)-.25 G .44(lent to).25 F F3($OLDPWD)144 720 Q F4(.)A F0 1.045(If a non-empty directory name from)5.545 F F3(CDP)3.545 E -.855(AT)-.666 G(H).855 E F0 1.044(is used, or if)3.295 F F2<ad>3.544 E F0 1.044(is the \214rst ar)3.544 F(gument,)-.18 E(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(2)203.725 E 0 Cg EP%%Page: 3 3%%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 .021(and th\e directory change is successful, the absolute pathname of the ne)144 84R 2.522(ww)-.25 G .022(orking directory is writ-)-2.622 F .165(ten to the standard output.)144 96 R .165(The return v)5.165 F .165(alue is true if the directory w)-.25 F .165(as successfully changed; f)-.1 F(alse)-.1 E(otherwise.)144 108 Q/F1 10/Times-Bold@0 SF(command)108124.8 Q F0([)2.5 E F1(\255pVv)A F0(])A/F2 10/Times-Italic@0 SF(command)2.5 E F0([)2.5 E F2(ar)A(g)-.37 E F0(...])2.5 E(Run)144 136.8 Q F2(command)2.956 E F0(with)3.527 E F2(ar)3.087 E(gs)-.37 E F0 .257(suppressing the normal shell function lookup. Only b)3.027 F .257(uiltin commands or)-.2 F .502(commands found in the)144 148.8 R/F3 9/Times-Bold@0 SF -.666(PA)3.002 G(TH)-.189 E F0 .502(are e)2.752 F -.15(xe)-.15 G 3.002(cuted. If).15 F(the)3.002 E F1<ad70>3.002 E F0 .502(option is gi)3.002 F -.15(ve)-.25 G .501(n, the search for).15 F F2(command)3.201 E F0(is)3.771 E .399(performed using a def)144 160.8 R.399(ault v)-.1 F .399(alue for)-.25 F F3 -.666(PA)2.899 G(TH)-.189 E F0.4(that is guaranteed to \214nd all of the standard utilities.)2.649 F(If)5.4 E .175(either the)144 172.8 R F1<ad56>2.675 E F0(or)2.675 E F1<ad76>2.675 E F0 .175(option is supplied, a description of)2.675 F F2(command)2.875 E F0 .174(is printed.)3.445 F(The)5.174 E F1<ad76>2.674 EF0 .174(option causes)2.674 F 3.11(as)144 184.8 S .61(ingle w)-3.11 F.61(ord indicating the command or \214le name used to in)-.1 F -.2(vo)-.4 G -.1(ke).2 G F2(command)3.41 E F0 .61(to be displayed; the)3.88 FF1<ad56>144 196.8 Q F0 .25(option produces a more v)2.75 F .25(erbose description.)-.15 F .249(If the)5.25 F F1<ad56>2.749 E F0(or)2.749 E F1<ad76>2.749 E F0 .249(option is supplied, the e)2.749 F .249(xit status)-.15 F 1.004(is 0 if)144 208.8 R F2(command)3.704 E F0 -.1(wa)4.274 G 3.504(sf).1 G 1.005(ound, and 1 if not.)-3.504 F 1.005(If neither option is supplied and an error occurred or)6.005 F F2(command)144.2 220.8 Q F0 1.599(cannot be found, the e)4.869 F 1.599(xit status is 127.)-.15 F 1.599(Otherwise, the e)6.599 F 1.598(xit status of the)-.15 F F1(command)4.098 E F0 -.2(bu)144 232.8 S(iltin is the e).2 E(xit status of)-.15 E F2(command)2.5 E F0(.).77 E F1(compgen)108 249.6 Q F0([)2.5 E F2(option)A F0 2.5(][)C F2(wor)-2.5 E(d)-.37 E F0(])A .012(Generate possible completion matches for)144 261.6 RF2(wor)2.513 E(d)-.37 E F0 .013(according to the)2.513 F F2(option)2.513E F0 .013(s, which may be an)B 2.513(yo)-.15 G(ption)-2.513 E .982(accepted by the)144 273.6 R F1(complete)3.482 E F0 -.2(bu)3.481 G .981(iltin with the e).2 F .981(xception of)-.15 F F1<ad70>3.481 E F0(and)3.481 E F1<ad72>3.481 E F0 3.481(,a)C .981(nd write the matches to the)-3.481 F 1.415(standard output.)144 285.6 R 1.415(When using the)6.415 FF1<ad46>3.915 E F0(or)3.915 E F1<ad43>3.915 E F0 1.415(options, the v)3.915 F 1.415(arious shell v)-.25 F 1.415(ariables set by the pro-)-.25F(grammable completion f)144 297.6 Q(acilities, while a)-.1 E -.25(va)-.2 G(ilable, will not ha).25 E .3 -.15(ve u)-.2 H(seful v).15 E(alues.)-.25 E .352(The matches will be generated in the same w)144 321.6 R .352(ay as if the programmable completion code had gen-)-.1 F .02(erated th\em directly from a completion speci\214cation with the same \215ags.)144333.6 R(If)5.02 E F2(wor)2.52 E(d)-.37 E F0 .02(is speci\214ed, only)2.52 F(those completions matching)144 345.6 Q F2(wor)2.5 E(d)-.37 E F0(will be displayed.)2.5 E(The return v)144 369.6 Q(alue is true unless an in)-.25 E -.25(va)-.4 G(lid option is supplied, or no matches were generated.).25 E F1(complete)108 386.4 Q F0([)3.729 E F1(\255abcdefgjksuv)A F0 3.729(][)CF1<ad6f>-3.729 E F2(comp-option)3.729 E F0 3.729(][)C F1(\255DE)-3.729 EF0 3.728(][)C F1<ad41>-3.728 E F2(action)3.728 E F0 3.728(][)C F1<ad47>-3.728 E F2(globpat)3.728 E F0 3.728(][)C F1<ad57>-3.728 E F2(wor)3.728E(dlist)-.37 E F0 3.728(][)C F1<ad46>-3.728 E F2(func-)3.728 E(tion)108398.4 Q F0 2.5(][)C F1<ad43>-2.5 E F2(command)2.5 E F0(])A([)144 410.4 QF1<ad58>A F2(\214lterpat)2.5 E F0 2.5(][)C F1<ad50>-2.5 E F2(pr)2.5 E(e\214x)-.37 E F0 2.5(][)C F1<ad53>-2.5 E F2(suf)2.5 E<8c78>-.18 E F0(])A F2(name)2.5 E F0([)2.5 E F2(name ...)A F0(])A F1(complete \255pr)108422.4 Q F0([)2.5 E F1(\255DE)A F0 2.5(][)C F2(name)-2.5 E F0(...])2.5 E.634(Specify ho)144 434.4 R 3.134(wa)-.25 G -.18(rg)-3.134 G .634(uments to each).18 F F2(name)3.134 E F0 .634(should be completed.)3.134F .633(If the)5.634 F F1<ad70>3.133 E F0 .633(option is supplied, or if no)3.133 F .139(options are supplied, e)144446.4 R .139(xisting completion speci\214cations are printed in a w)-.15F .14(ay that allo)-.1 F .14(ws them to be)-.25 F .31(reused as input.)144 458.4 R(The)5.31 E F1<ad72>2.81 E F0 .31(option remo)2.81 F -.15(ve)-.15 G 2.81(sac).15 G .31(ompletion speci\214cation for each)-2.81 F F2(name)2.81 E F0 2.81(,o)C 1.11 -.4(r, i)-2.81 H 2.81(fn).4 G(o)-2.81 EF2(name)2.81 E F0(s)A 1.346(are supplied, all completion speci\214cations.)144 470.4 R(The)6.347 EF1<ad44>3.847 E F0 1.347(option indicates that the remaining options)3.847 F .5(and actions should apply to the `)144 482.4 R(`def)-.74 E(ault')-.1 E 3('c)-.74 G .5(ommand completion; that is, completion attempted on)-3 F 3.455(ac)144494.4 S .955(ommand for which no completion has pre)-3.455 F .955(viously been de\214ned.)-.25 F(The)5.955 E F1<ad45>3.455 E F0 .955(option indicates that)3.455 F .065(the remaining options and actions should apply to `)144 506.4 R(`empty')-.74 E 2.564('c)-.74 G .064(ommand completion; that is, comple-)-2.564 F(tion attempted on a blank line.)144 518.4 Q 1.437(The process of applying these completion speci\214cations when w)144542.4 R 1.438(ord completion is attempted is)-.1 F(described abo)144554.4 Q .3 -.15(ve u)-.15 H(nder).15 E F1(Pr)2.5 E(ogrammable Completion)-.18 E F0(.)A .556(Other options, if speci\214ed, ha)144 578.4 R .856 -.15(ve t)-.2 H .555(he follo).15 F .555(wing meanings.)-.25 F .555(The ar)5.555 F .555(guments to the)-.18 F F1<ad47>3.055 E F0(,)A F1<ad57>3.055 E F0 3.055(,a)C(nd)-3.055 E F1<ad58>3.055 E F0 .722(options \(and, if necessary)144 590.4 R 3.222(,t)-.65 G(he)-3.222 E F1<ad50>3.222 E F0(and)3.222 EF1<ad53>3.222 E F0 .723(options\) should be quoted to protect them from e)3.222 F(xpan-)-.15 E(sion before the)144 602.4 Q F1(complete)2.5 E F0 -.2(bu)2.5 G(iltin is in).2 E -.2(vo)-.4 G -.1(ke).2 G(d.).1 E F1<ad6f>144 614.4 QF2(comp-option)2.5 E F0(The)184 626.4 Q F2(comp-option)2.791 E F0 .291(controls se)2.791 F -.15(ve)-.25 G .291(ral aspects of the compspec').15 F 2.791(sb)-.55 G(eha)-2.791 E .291(vior be)-.2 F .291(yond the simple)-.15 F(generation of completions.)184 638.4 Q F2(comp-option)5 E F0(may be one of:)2.5 E F1(bashdefault)184 650.4 Q F0.281(Perform the rest of the def)224 662.4 R(ault)-.1 E F1(bash)2.781 EF0 .281(completions if the compspec generates no)2.781 F(matches.)224674.4 Q F1(default)184 686.4 Q F0 2.876(Use readline')10 F 5.376(sd)-.55G(ef)-5.376 E 2.875(ault \214lename completion if the compspec generates no)-.1 F(matches.)224 698.4 Q(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(3)203.725 E 0 CgEP%%Page: 4 4%%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(dir)184 84 Q(names)-.15 E F0(Perform directory name co\mpletion if the compspec generates no matches.)224 96 Q F1(\214lenames)184 108 Q F0 -.7(Te)224 120 S .137(ll readline that the compspec genera\tes \214lenames, so it can perform an).7 F 2.637<798c>-.15 G(le-)-2.637E .134(name\255speci\214c processing \(lik)224 132 R 2.634(ea)-.1 G .134(dding a slash to directory names, quoting spe-)-2.634 F .45(cial characters, or suppressing trailing spaces\).)224 144 R .45(Intended to be used with shell)5.45 F(functions.)224 156 Q F1(nospace)184 168 Q F0 -.7(Te)6.11 G .22(ll readline not to append a space \(the def).7 F .22(ault\) to w)-.1 F.22(ords completed at the end)-.1 F(of the line.)224 180 Q F1(plusdirs)184 192 Q F0 1.985(After an)5.54 F 4.485(ym)-.15 G 1.985(atches de\214ned by the compspec are generated, directory name)-4.485 F.584(completion is attempted and an)224 204 R 3.084(ym)-.15 G .584(atches are added to the results of the other)-3.084 F(actions.)224 216Q F1<ad41>144 228 Q/F2 10/Times-Italic@0 SF(action)2.5 E F0(The)184 240Q F2(action)2.5 E F0(may be one of the follo)2.5 E(wing to generate a list of possible completions:)-.25 E F1(alias)184252 Q F0(Alias names.)20.55 E(May also be speci\214ed as)5 E F1<ad61>2.5E F0(.)A F1(arrayv)184 264 Q(ar)-.1 E F0(Array v)224 276 Q(ariable names.)-.25 E F1 4.7(binding Readline)184 288 R F0 -.1(ke)2.5 G2.5(yb)-.05 G(inding names.)-2.5 E F1 -.2(bu)184 300 S(iltin).2 E F0(Names of shell b)11.85 E(uiltin commands.)-.2 E(May also be speci\214ed as)5 E F1<ad62>2.5 E F0(.)A F1(command)184 312Q F0(Command names.)224 324 Q(May also be speci\214ed as)5 E F1<ad63>2.5E F0(.)A F1(dir)184 336 Q(ectory)-.18 E F0(Directory names.)224 348 Q(May also be speci\214ed as)5 E F1<ad64>2.5 E F0(.)A F1(disabled)184 360Q F0(Names of disabled shell b)224 372 Q(uiltins.)-.2 E F1(enabled)184384 Q F0(Names of enabled shell b)6.66 E(uiltins.)-.2 E F1(export)184396 Q F0(Names of e)12.23 E(xported shell v)-.15 E 2.5(ariables. May)-.25 F(also be speci\214ed as)2.5 E F1<ad65>2.5 E F0(.)A F1(\214le)184408 Q F0(File names.)27.22 E(May also be speci\214ed as)5 E F1<ad66>2.5E F0(.)A F1(function)184 420 Q F0(Names of shell functions.)224 432 Q F1(gr)184 444 Q(oup)-.18 E F0(Group names.)14.62 E(May also be speci\214ed as)5 E F1<ad67>2.5 E F0(.)A F1(helptopic)184456 Q F0(Help topics as accepted by the)224 468 Q F1(help)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E F1(hostname)184 480 Q F0(Hostnames, as tak)224 492Q(en from the \214le speci\214ed by the)-.1 E/F3 9/Times-Bold@0 SF(HOSTFILE)2.5 E F0(shell v)2.25 E(ariable.)-.25 E F1(job)184 504 Q F0(Job names, if job control is acti)26.11 E -.15(ve)-.25 G 5(.M).15 G(ay also be speci\214ed as)-5 E F1<ad6a>2.5 E F0(.)A F1 -.1(ke)184 516 S(yw).1 E(ord)-.1 E F0(Shell reserv)224 528 Q(ed w)-.15 E 2.5(ords. May)-.1 F(also be speci\214ed as)2.5 E F1<ad6b>2.5 E F0(.)A F1(running)184540 Q F0(Names of running jobs, if job control is acti)5.54 E -.15(ve)-.25 G(.).15 E F1(ser)184 552 Q(vice)-.1 E F0(Service names.)10.67 E(May also be speci\214ed as)5 E F1<ad73>2.5 E F0(.)A F1(setopt)184 564 QF0 -1.11(Va)14.45 G(lid ar)1.11 E(guments for the)-.18 E F1<ad6f>2.5 EF0(option to the)2.5 E F1(set)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E F1(shopt)184 576 Q F0(Shell option names as accepted by the)16.66 E F1(shopt)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E F1(signal)184 588 Q F0(Signal names.)14.99 E F1(stopped)184 600 Q F0(Names of stopped jobs, if job control is acti)6.66 E -.15(ve)-.25 G(.).15 E F1(user)184 612 Q F0(User names.)21.67 E(May also be speci\214ed as)5 E F1<ad75>2.5 E F0(.)A F1 -.1(va)184 624 S(riable).1 E F0(Names of all shell v)5.1 E 2.5(ariables. May)-.25 F(also be speci\214ed as)2.5 E F1<ad76>2.5 E F0(.)A F1<ad43>144 636 Q F2(command)2.5 E(command)184 648 Q F0 1.055(is e)3.555 F -.15(xe)-.15 G1.055(cuted in a subshell en).15 F 1.056(vironment, and its output is used as the possible)-.4 F(completions.)184 660 Q F1<ad46>144 672 Q F2(function)2.5 E F0 1.181(The shell function)184 684 R F2(function)3.681 E F0 1.181(is e)3.681 F-.15(xe)-.15 G 1.181(cuted in the current shell en).15 F 3.68(vironment. When)-.4 F 1.18(it \214n-)3.68 F .932(ishes, the possible completions are retrie)184 696 R -.15(ve)-.25 G3.432(df).15 G .932(rom the v)-3.432 F .932(alue of the)-.25 F F3(COMPREPL)3.432 E(Y)-.828 E F0(array)3.182 E -.25(va)184 708 S(riable.).25 E(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(4)203.725 E 0 Cg EP%%Page: 5 5%%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<ad47>144 84 Q/F2 10/Times-Italic@0 SF(globpat)2.5 E F01.008(The pathname e)184 96 R 1.008(xpansion pattern)-.15 F F2(globpat)3.507 E F0 1.007(is e)3.507 F 1.007(xpanded to generate the possible comple-)-.15 F(tions.)184 108 Q F1<ad50>144 120 Q F2(pr)2.5 E(e\214x)-.37 E(pr)184 132 Q(e\214x)-.37 E F0.534(is added at the be)3.034 F .534(ginning of each possible completion after all other options ha)-.15 F-.15(ve)-.2 G(been applied.)184 144 Q F1<ad53>144 156 Q F2(suf)2.5 E