pmodules/bash
0
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/bash.git synced 2026-08-07 02:32:27 +02:00
Code Issues Packages Projects Releases Wiki Activity

commit bash-20040506 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2011-12-03 12:57:19 -05:00
parent c6d91e17e5
commit c2258e1c96
26 changed files with 2384 additions and 166 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/bashref.ps
+39 -35
View File
@@ -8,7 +8,7 @@
%DVIPSWebPage: (www.radicaleye.com)
%DVIPSCommandLine: dvips -D 600 -t letter -o bashref.ps bashref.dvi
%DVIPSParameters: dpi=600, compressed
%DVIPSSource: TeX output 2004.04.20:1526
%DVIPSSource: TeX output 2004.05.04:1027
%%BeginProcSet: texc.pro
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -5222,69 +5222,73 @@ eop
%%Page: 33 39
33 38 bop 150 -116 a Ft(Chapter)30 b(4:)41 b(Shell)28
b(Builtin)g(Commands)2069 b(33)150 299 y Fo(4)80 b(Shell)55
b(Builtin)g(Commands)275 572 y Ft(Builtin)22 b(commands)i(are)h(con)m
b(Builtin)g(Commands)275 525 y Ft(Builtin)22 b(commands)i(are)h(con)m
(tained)g(within)d(the)j(shell)e(itself.)38 b(When)24
b(the)h(name)g(of)g(a)g(builtin)c(com-)150 681 y(mand)26
b(the)h(name)g(of)g(a)g(builtin)c(com-)150 635 y(mand)26
b(is)h(used)f(as)i(the)g(\014rst)e(w)m(ord)h(of)h(a)f(simple)f(command)
h(\(see)h(Section)f(3.2.1)i([Simple)d(Commands],)150
791 y(page)21 b(8\),)j(the)d(shell)e(executes)j(the)f(command)f
745 y(page)21 b(8\),)j(the)d(shell)e(executes)j(the)f(command)f
(directly)-8 b(,)22 b(without)e(in)m(v)m(oking)g(another)h(program.)37
b(Builtin)150 900 y(commands)f(are)h(necessary)g(to)g(implemen)m(t)e
b(Builtin)150 854 y(commands)f(are)h(necessary)g(to)g(implemen)m(t)e
(functionalit)m(y)g(imp)s(ossible)e(or)k(incon)m(v)m(enien)m(t)f(to)h
(obtain)150 1010 y(with)29 b(separate)i(utilities.)275
1157 y(This)i(section)i(brie\015y)f(the)h(builtins)d(whic)m(h)i(Bash)h
(obtain)150 964 y(with)29 b(separate)i(utilities.)275
1097 y(This)i(section)i(brie\015y)f(the)h(builtins)d(whic)m(h)i(Bash)h
(inherits)e(from)i(the)g(Bourne)g(Shell,)g(as)g(w)m(ell)g(as)150
1267 y(the)c(builtin)26 b(commands)k(whic)m(h)g(are)g(unique)f(to)i(or)
f(ha)m(v)m(e)i(b)s(een)e(extended)g(in)f(Bash.)275 1414
1206 y(the)c(builtin)26 b(commands)k(whic)m(h)g(are)g(unique)f(to)i(or)
f(ha)m(v)m(e)i(b)s(een)e(extended)g(in)f(Bash.)275 1339
y(Sev)m(eral)44 b(builtin)c(commands)k(are)h(describ)s(ed)d(in)h(other)
h(c)m(hapters:)69 b(builtin)40 b(commands)k(whic)m(h)150
1524 y(pro)m(vide)22 b(the)i(Bash)f(in)m(terface)h(to)g(the)g(job)f
1449 y(pro)m(vide)22 b(the)i(Bash)f(in)m(terface)h(to)g(the)g(job)f
(con)m(trol)h(facilities)d(\(see)j(Section)g(7.2)g([Job)f(Con)m(trol)g
(Builtins],)150 1633 y(page)40 b(80\),)j(the)c(directory)g(stac)m(k)h
(Builtins],)150 1558 y(page)40 b(80\),)j(the)c(directory)g(stac)m(k)h
(\(see)g(Section)f(6.8.1)i([Directory)f(Stac)m(k)g(Builtins],)f(page)h
(73\),)j(the)150 1743 y(command)23 b(history)g(\(see)h(Section)f(9.2)i
(73\),)j(the)150 1668 y(command)23 b(history)g(\(see)h(Section)f(9.2)i
([Bash)f(History)f(Builtins],)f(page)j(109\),)h(and)d(the)h
(programmable)150 1853 y(completion)30 b(facilities)e(\(see)k(Section)e
(programmable)150 1778 y(completion)30 b(facilities)e(\(see)k(Section)e
(8.7)h([Programmable)f(Completion)f(Builtins],)f(page)k(105\).)275
2000 y(Man)m(y)f(of)f(the)h(builtins)26 b(ha)m(v)m(e)32
b(b)s(een)e(extended)g(b)m(y)g Fl(posix)g Ft(or)g(Bash.)150
2290 y Fr(4.1)68 b(Bourne)45 b(Shell)g(Builtins)275 2546
1911 y(Man)m(y)f(of)f(the)h(builtins)26 b(ha)m(v)m(e)32
b(b)s(een)e(extended)g(b)m(y)g Fl(posix)g Ft(or)g(Bash.)275
2044 y(Unless)19 b(otherwise)h(noted,)i(eac)m(h)g(builtin)17
b(command)j(do)s(cumen)m(ted)g(as)h(accepting)g(options)e(preceded)150
2153 y(b)m(y)30 b(`)p Fs(-)p Ft(')h(accepts)g(`)p Fs(--)p
Ft(')g(to)g(signify)d(the)j(end)f(of)g(the)h(options.)150
2406 y Fr(4.1)68 b(Bourne)45 b(Shell)g(Builtins)275 2648
y Ft(The)31 b(follo)m(wing)f(shell)f(builtin)g(commands)i(are)h
(inherited)d(from)i(the)h(Bourne)f(Shell.)43 b(These)31
b(com-)150 2656 y(mands)e(are)i(implemen)m(ted)e(as)i(sp)s(eci\014ed)d
(b)m(y)j(the)f Fl(posix)g Ft(1003.2)j(standard.)150 2835
y Fs(:)d Ft(\(a)h(colon\))870 2944 y Fs(:)47 b([)p Fj(arguments)11
b Fs(])630 3085 y Ft(Do)43 b(nothing)e(b)s(ey)m(ond)h(expanding)e
b(com-)150 2758 y(mands)e(are)i(implemen)m(ted)e(as)i(sp)s(eci\014ed)d
(b)m(y)j(the)f Fl(posix)g Ft(1003.2)j(standard.)150 2914
y Fs(:)d Ft(\(a)h(colon\))870 3024 y Fs(:)47 b([)p Fj(arguments)11
b Fs(])630 3157 y Ft(Do)43 b(nothing)e(b)s(ey)m(ond)h(expanding)e
Fq(argumen)m(ts)46 b Ft(and)c(p)s(erforming)e(redirections.)74
b(The)630 3195 y(return)29 b(status)i(is)e(zero.)150
3367 y Fs(.)h Ft(\(a)h(p)s(erio)s(d\))870 3477 y Fs(.)47
b(The)630 3267 y(return)29 b(status)i(is)e(zero.)150
3423 y Fs(.)h Ft(\(a)h(p)s(erio)s(d\))870 3532 y Fs(.)47
b Fj(filename)57 b Fs([)p Fj(arguments)11 b Fs(])630
3618 y Ft(Read)34 b(and)f(execute)i(commands)e(from)g(the)h
3665 y Ft(Read)34 b(and)f(execute)i(commands)e(from)g(the)h
Fq(\014lename)k Ft(argumen)m(t)c(in)e(the)i(curren)m(t)g(shell)630
3727 y(con)m(text.)45 b(If)31 b Fq(\014lename)36 b Ft(do)s(es)31
3775 y(con)m(text.)45 b(If)31 b Fq(\014lename)36 b Ft(do)s(es)31
b(not)g(con)m(tain)h(a)f(slash,)g(the)h Fs(PATH)e Ft(v)-5
b(ariable)30 b(is)g(used)g(to)i(\014nd)630 3837 y Fq(\014lename)p
b(ariable)30 b(is)g(used)g(to)i(\014nd)630 3885 y Fq(\014lename)p
Ft(.)51 b(When)34 b(Bash)g(is)g(not)g(in)f Fl(posix)g
Ft(mo)s(de,)i(the)g(curren)m(t)f(directory)f(is)g(searc)m(hed)630
3946 y(if)d Fq(\014lename)35 b Ft(is)30 b(not)i(found)d(in)h
3994 y(if)d Fq(\014lename)35 b Ft(is)30 b(not)i(found)d(in)h
Fs($PATH)p Ft(.)41 b(If)31 b(an)m(y)g Fq(argumen)m(ts)k
Ft(are)c(supplied,)d(they)k(b)s(ecome)630 4056 y(the)e(p)s(ositional)e
Ft(are)c(supplied,)d(they)k(b)s(ecome)630 4104 y(the)e(p)s(ositional)e
(parameters)j(when)e Fq(\014lename)34 b Ft(is)29 b(executed.)42
b(Otherwise)29 b(the)h(p)s(ositional)630 4166 y(parameters)43
b(Otherwise)29 b(the)h(p)s(ositional)630 4213 y(parameters)43
b(are)h(unc)m(hanged.)79 b(The)42 b(return)g(status)i(is)e(the)h(exit)g
(status)h(of)f(the)g(last)630 4275 y(command)37 b(executed,)k(or)c
(status)h(of)f(the)g(last)630 4323 y(command)37 b(executed,)k(or)c
(zero)h(if)f(no)g(commands)g(are)h(executed.)63 b(If)36
b Fq(\014lename)42 b Ft(is)37 b(not)630 4385 y(found,)22
b Fq(\014lename)42 b Ft(is)37 b(not)630 4433 y(found,)22
b(or)f(cannot)g(b)s(e)f(read,)j(the)e(return)f(status)h(is)f(non-zero.)
38 b(This)19 b(builtin)f(is)h(equiv)-5 b(alen)m(t)630
4494 y(to)31 b Fs(source)p Ft(.)150 4667 y Fs(break)870
4808 y(break)46 b([)p Fj(n)11 b Fs(])630 4949 y Ft(Exit)44
4542 y(to)31 b Fs(source)p Ft(.)150 4699 y Fs(break)870
4831 y(break)46 b([)p Fj(n)11 b Fs(])630 4964 y Ft(Exit)44
b(from)g(a)g Fs(for)p Ft(,)k Fs(while)p Ft(,)e Fs(until)p
Ft(,)h(or)d Fs(select)f Ft(lo)s(op.)82 b(If)44 b Fq(n)g
Ft(is)f(supplied,)i(the)g Fq(n)p Ft(th)630 5058 y(enclosing)39
Ft(is)f(supplied,)i(the)g Fq(n)p Ft(th)630 5074 y(enclosing)39
b(lo)s(op)g(is)h(exited.)69 b Fq(n)40 b Ft(m)m(ust)g(b)s(e)f(greater)j
(than)d(or)i(equal)e(to)i(1.)70 b(The)40 b(return)630
5168 y(status)31 b(is)e(zero)i(unless)e Fq(n)h Ft(is)f(not)i(greater)g
5184 y(status)31 b(is)e(zero)i(unless)e Fq(n)h Ft(is)f(not)i(greater)g
(than)g(or)f(equal)g(to)h(1.)150 5340 y Fs(cd)p eop
%%Page: 34 40
34 39 bop 150 -116 a Ft(34)2572 b(Bash)31 b(Reference)g(Man)m(ual)870
@@ -9947,7 +9951,7 @@ Fs(edit-and-execute-command)24 b(\(C-xC-e\))630 1906
y Ft(In)m(v)m(ok)m(e)34 b(an)f(editor)f(on)h(the)g(curren)m(t)f
(command)h(line,)f(and)g(execute)i(the)f(result)f(as)h(shell)630
2016 y(commands.)81 b(Bash)44 b(attempts)h(to)g(in)m(v)m(ok)m(e)g
Fs($FCEDIT)p Ft(,)g Fs($EDITOR)p Ft(,)h(and)d Fs(emacs)g
Fs($VISUAL)p Ft(,)g Fs($EDITOR)p Ft(,)h(and)d Fs(emacs)g
Ft(as)h(the)630 2125 y(editor,)30 b(in)f(that)i(order.)150
2363 y Fr(8.5)68 b(Readline)47 b(vi)e(Mo)t(de)275 2600
y Ft(While)22 b(the)i(Readline)e(library)f(do)s(es)j(not)g(ha)m(v)m(e)g