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

commit bash-20040422 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2011-12-03 12:56:49 -05:00
parent 1d7ecd770c
commit de8913bd20
51 changed files with 13071 additions and 634 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/bash.0
+22 -22
View File
@@ -1729,17 +1729,17 @@ AALLIIAASSEESS
the first word of a simple command. The shell maintains a list of
aliases that may be set and unset with the aalliiaass and uunnaalliiaass builtin
commands (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). The first word of each
command, if unquoted, is checked to see if it has an alias. If so,
that word is replaced by the text of the alias. The alias name and the
replacement text may contain any valid shell input, including the
_m_e_t_a_c_h_a_r_a_c_t_e_r_s listed above, with the exception that the alias name may
not contain _=. The first word of the replacement text is tested for
aliases, but a word that is identical to an alias being expanded is not
expanded a second time. This means that one may alias llss to llss --FF, for
instance, and bbaasshh does not try to recursively expand the replacement
text. If the last character of the alias value is a _b_l_a_n_k, then the
next command word following the alias is also checked for alias expan-
sion.
simple command, if unquoted, is checked to see if it has an alias. If
so, that word is replaced by the text of the alias. The characters //,
$$, ``, and == and any of the shell _m_e_t_a_c_h_a_r_a_c_t_e_r_s or quoting characters
listed above may not appear in an alias name. The replacement text may
contain any valid shell input, including shell metacharacters. The
first word of the replacement text is tested for aliases, but a word
that is identical to an alias being expanded is not expanded a second
time. This means that one may alias llss to llss --FF, for instance, and
bbaasshh does not try to recursively expand the replacement text. If the
last character of the alias value is a _b_l_a_n_k, then the next command
word following the alias is also checked for alias expansion.
Aliases are created and listed with the aalliiaass command, and removed with
the uunnaalliiaass command.
@@ -1778,16 +1778,16 @@ FFUUNNCCTTIIOONNSS
interpret them (contrast this with the execution of a shell script).
When a function is executed, the arguments to the function become the
positional parameters during its execution. The special parameter ## is
updated to reflect the change. Positional parameter 0 is unchanged.
The first element of the FFUUNNCCNNAAMMEE variable is set to the name of the
function while the function is executing. All other aspects of the
shell execution environment are identical between a function and its
caller with the exception that the DDEEBBUUGG trap (see the description of
the ttrraapp builtin under SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below) is not inherited
unless the function has been given the ttrraaccee attribute (see the
description of the ddeeccllaarree builtin below) or the --oo ffuunnccttrraaccee shell
option has been enabled with the sseett builtin (in which case all func-
tions inherit the DDEEBBUUGG trap).
updated to reflect the change. Special parameter 0 is unchanged. The
first element of the FFUUNNCCNNAAMMEE variable is set to the name of the func-
tion while the function is executing. All other aspects of the shell
execution environment are identical between a function and its caller
with the exception that the DDEEBBUUGG trap (see the description of the ttrraapp
builtin under SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below) is not inherited unless the
function has been given the ttrraaccee attribute (see the description of the
ddeeccllaarree builtin below) or the --oo ffuunnccttrraaccee shell option has been
enabled with the sseett builtin (in which case all functions inherit the
DDEEBBUUGG trap).
Variables local to the function may be declared with the llooccaall builtin
command. Ordinarily, variables and their values are shared between the
@@ -4775,4 +4775,4 @@ BBUUGGSS
GNU Bash-3.0 2004 Jan 28 BASH(1)
GNU Bash-3.0 2004 Apr 20 BASH(1)
doc/bash.1
+12 -10
View File
@@ -6,12 +6,12 @@
.\" Case Western Reserve University
.\" chet@po.CWRU.Edu
.\"
.\" Last Change: Wed Jan 28 15:49:29 EST 2004
.\" Last Change: Tue Apr 20 13:39:08 EDT 2004
.\"
.\" bash_builtins, strip all but Built-Ins section
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH BASH 1 "2004 Jan 28" "GNU Bash-3.0"
.TH BASH 1 "2004 Apr 20" "GNU Bash-3.0"
.\"
.\" There's some problem with having a `@'
.\" in a tagged paragraph with the BSD man macros.
@@ -3189,16 +3189,18 @@ builtin commands (see
.SM
.B SHELL BUILTIN COMMANDS
below).
The first word of each command, if unquoted,
The first word of each simple command, if unquoted,
is checked to see if it has an
alias. If so, that word is replaced by the text of the alias.
The alias name and the replacement text may contain any valid
shell input, including the
.I metacharacters
listed above, with the exception that the alias name may not
contain \fI=\fP. The first word of the replacement text is tested
The characters \fB/\fP, \fB$\fP, \fB`\fP, and \fB=\fP and
any of the shell \fImetacharacters\fP or quoting characters
listed above may not appear in an alias name.
The replacement text may contain any valid shell input,
including shell metacharacters.
The first word of the replacement text is tested
for aliases, but a word that is identical to an alias being expanded
is not expanded a second time. This means that one may alias
is not expanded a second time.
This means that one may alias
.B ls
to
.BR "ls \-F" ,
@@ -3272,7 +3274,7 @@ function become the positional parameters
during its execution.
The special parameter
.B #
is updated to reflect the change. Positional parameter 0
is updated to reflect the change. Special parameter 0
is unchanged.
The first element of the
.SM
doc/bash.html
+12 -11
View File
@@ -2,7 +2,7 @@
<TITLE>BASH(1) Manual Page</TITLE>
</HEAD>
<BODY><TABLE WIDTH=100%>
<TH ALIGN=LEFT>BASH(1)<TH ALIGN=CENTER>2004 Jan 28<TH ALIGN=RIGHT>BASH(1)
<TH ALIGN=LEFT>BASH(1)<TH ALIGN=CENTER>2004 Apr 20<TH ALIGN=RIGHT>BASH(1)
</TABLE>
<BR><A HREF="#index">Index</A>
<HR>
@@ -4156,17 +4156,18 @@ builtin commands (see
</FONT>
below).
The first word of each command, if unquoted,
The first word of each simple command, if unquoted,
is checked to see if it has an
alias. If so, that word is replaced by the text of the alias.
The alias name and the replacement text may contain any valid
shell input, including the
<I>metacharacters</I>
listed above, with the exception that the alias name may not
contain <I>=</I>. The first word of the replacement text is tested
The characters <B>/</B>, <B>$</B>, <B>`</B>, and <B>=</B> and
any of the shell <I>metacharacters</I> or quoting characters
listed above may not appear in an alias name.
The replacement text may contain any valid shell input,
including shell metacharacters.
The first word of the replacement text is tested
for aliases, but a word that is identical to an alias being expanded
is not expanded a second time. This means that one may alias
is not expanded a second time.
This means that one may alias
<B>ls</B>
to
@@ -4260,7 +4261,7 @@ during its execution.
The special parameter
<B>#</B>
is updated to reflect the change. Positional parameter 0
is updated to reflect the change. Special parameter 0
is unchanged.
The first element of the
<FONT SIZE=-1><B>FUNCNAME</B>
@@ -11343,6 +11344,6 @@ Array variables may not (yet) be exported.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 29 January 2004 16:59:30 EST
Time: 20 April 2004 15:26:54 EDT
</BODY>
</HTML>
doc/bash.ps
+152 -136
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.18.1
%%CreationDate: Thu Jan 29 16:59:28 2004
%%Creator: groff version 1.19
%%CreationDate: Tue Apr 20 15:26:44 2004
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
@@ -9,13 +9,17 @@
%%+ font Palatino-Roman
%%+ font Palatino-Italic
%%+ font Palatino-Bold
%%DocumentSuppliedResources: procset grops 1.18 1
%%DocumentSuppliedResources: procset grops 1.19 0
%%Pages: 63
%%PageOrder: Ascend
%%DocumentMedia: Default 612 792 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.18 1
%%BeginResource: procset grops 1.19 0
/setpacking where{
pop
currentpacking
@@ -116,16 +120,22 @@ TM setmatrix
/Fr{
setrgbcolor fill
}bind def
/setcmykcolor where{
pop
/Fk{
setcmykcolor fill
}bind def
}if
/Fg{
setgray fill
}bind def
/FL/fill load def
/LW/setlinewidth load def
/Cr/setrgbcolor load def
/setcmykcolor where{
pop
/Ck/setcmykcolor load def
}if
/Cg/setgray load def
/RE{
findfont
@@ -168,6 +178,7 @@ newpath
/CNT countdictstack def
userdict begin
/showpage{}def
/setpagedevice{}def
}bind def
/PEND{
clear
@@ -180,6 +191,9 @@ pop
setpacking
}if
%%EndResource
%%BeginFeature: *PageSize Default
<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
@@ -321,7 +335,7 @@ E F2(po)2.5 E F0(\(portable object\) \214le format.)2.5 E F2
144 686.4 Q .3 -.15(ve \()-.25 H(see).15 E F4(INV)2.5 E(OCA)-.405 E
(TION)-.855 E F0(belo)2.25 E(w\).)-.25 E F2(\255\255login)108 703.2 Q F0
(Equi)144 715.2 Q -.25(va)-.25 G(lent to).25 E F2<ad6c>2.5 E F0(.)A
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(1)204.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(1)203.725 E 0 Cg EP
%%Page: 2 2
%%BeginPageSetup
BP
@@ -444,7 +458,7 @@ F(ariable)-.25 E F3 -.27(BA)108 679.2 S(SH_ENV).27 E F0 1.01(in the en)
108 727.2 S 2.5(tt).2 G(he v)-2.5 E(alue of the)-.25 E F3 -.666(PA)2.5 G
(TH)-.189 E F0 -.25(va)2.25 G
(riable is not used to search for the \214le name.).25 E(GNU Bash-3.0)72
768 Q(2004 Jan 28)149.845 E(2)204.835 E 0 Cg EP
768 Q(2004 Apr 20)148.735 E(2)203.725 E 0 Cg EP
%%Page: 3 3
%%BeginPageSetup
BP
@@ -569,7 +583,7 @@ F1(Pipelines)87 679.2 Q F0(A)108 691.2 Q F2(pipeline)2.919 E F0 .419
F F1(|)2.92 E F0 5.42(.T)C .42(he format for a pipeline)-5.42 F(is:)108
703.2 Q([)144 720 Q F1(time)A F0([)2.5 E F1<ad70>A F0(]] [ ! ])A F2
(command)2.5 E F0([)2.5 E F1(|)2.5 E F2(command2)2.5 E F0(... ])2.5 E
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(3)204.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(3)203.725 E 0 Cg EP
%%Page: 4 4
%%BeginPageSetup
BP
@@ -689,7 +703,7 @@ A({)108 573.6 Q F1(list)2.5 E F0 2.5(;})C F1(list)3.89 E F0 .402
F(SIONS)144 727.2 Q F5(.)A F0 -.8(Wo)5.633 G 1.133
(rd splitting and pathname e).8 F 1.133
(xpansion are not performed on the w)-.15 F 1.133(ords between the)-.1 F
F3([[)3.632 E F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(4)204.835 E
F3([[)3.632 E F0(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(4)203.725 E
0 Cg EP
%%Page: 5 5
%%BeginPageSetup
@@ -829,7 +843,7 @@ F F2(name)144 727.2 Q F0 .759(to be set to null.)3.439 F .759
(The line read is sa)5.759 F -.15(ve)-.2 G 3.26(di).15 G 3.26(nt)-3.26 G
.76(he v)-3.26 F(ariable)-.25 E F1(REPL)3.26 E(Y)-.92 E F0 5.76(.T)C(he)
-5.76 E F2(list)3.35 E F0 .76(is e)3.94 F -.15(xe)-.15 G .76
(cuted after).15 F(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(5)204.835
(cuted after).15 F(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(5)203.725
E 0 Cg EP
%%Page: 6 6
%%BeginPageSetup
@@ -965,7 +979,7 @@ E(xpansion.)-.15 E(There are three quoting mechanisms: the)108 708 Q F2
G(he)-2.974 E F2 .474(escape c)2.974 F(har)-.15 E(acter)-.15 E F0 5.474
(.I).73 G 2.974(tp)-5.474 G(reserv)-2.974 E .474(es the literal v)-.15 F
.474(alue of the ne)-.25 F .474(xt character that)-.15 F(GNU Bash-3.0)72
768 Q(2004 Jan 28)149.845 E(6)204.835 E 0 Cg EP
768 Q(2004 Apr 20)148.735 E(6)203.725 E 0 Cg EP
%%Page: 7 7
%%BeginPageSetup
BP
@@ -1082,7 +1096,7 @@ d by one or more digits, other than the single digit 0.)3.935 F(Posi-)
5.706 E .445(tional parameters are assigned from the shell')108 729.6 R
2.944(sa)-.55 G -.18(rg)-2.944 G .444(uments when it is in).18 F -.2(vo)
-.4 G -.1(ke).2 G .444(d, and may be reassigned using).1 F(GNU Bash-3.0)
72 768 Q(2004 Jan 28)149.845 E(7)204.835 E 0 Cg EP
72 768 Q(2004 Apr 20)148.735 E(7)203.725 E 0 Cg EP
%%Page: 8 8
%%BeginPageSetup
BP
@@ -1200,7 +1214,7 @@ F F1 -.3(BA)144 619.2 S(SH_ARGV).3 E F0(.)A F1 -.3(BA)108 631.2 S
F F1(${FUNCN)144 727.2 Q(AME[)-.2 E F3 8.951($i + 1)B F1(]})A F0 -.1(wa)
11.451 G 11.451(sc).1 G 11.451(alled. The)-11.451 F 8.951
(corresponding source \214le name is)11.451 F(GNU Bash-3.0)72 768 Q
(2004 Jan 28)149.845 E(8)204.835 E 0 Cg EP
(2004 Apr 20)148.735 E(8)203.725 E 0 Cg EP
%%Page: 9 9
%%BeginPageSetup
BP
@@ -1301,7 +1315,7 @@ F(ariable)-.25 E .351(will not change the current directory)144 711.6 R
5.35(.I)-.65 G(f)-5.35 E F3(DIRST)2.85 E -.495(AC)-.81 G(K).495 E F0 .35
(is unset, it loses its special properties, e)2.6 F -.15(ve)-.25 G 2.85
(ni).15 G(f)-2.85 E(it is subsequently reset.)144 723.6 Q(GNU Bash-3.0)
72 768 Q(2004 Jan 28)149.845 E(9)204.835 E 0 Cg EP
72 768 Q(2004 Apr 20)148.735 E(9)203.725 E 0 Cg EP
%%Page: 10 10
%%BeginPageSetup
BP
@@ -1390,7 +1404,7 @@ R .01(alue to)-.25 F F2(RANDOM)2.51 E/F4 9/Times-Roman@0 SF(.)A F0(If)
4.51 E F2(RANDOM)2.51 E F0(is)2.26 E
(unset, it loses its special properties, e)144 720 Q -.15(ve)-.25 G 2.5
(ni).15 G 2.5(fi)-2.5 G 2.5(ti)-2.5 G 2.5(ss)-2.5 G(ubsequently reset.)
-2.5 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(10)199.835 E 0 Cg EP
-2.5 E(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(10)198.725 E 0 Cg EP
%%Page: 11 11
%%BeginPageSetup
BP
@@ -1499,7 +1513,7 @@ me e)-3.118 F(xpan-)-.15 E 3.131(sion. If)144 640.8 R 3.132<618c>3.131 G
(all pre)144 724.8 R .698
(vious lines matching the current line to be remo)-.25 F -.15(ve)-.15 G
3.198(df).15 G .698(rom the history list before that line is)-3.198 F
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(11)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(11)198.725 E 0 Cg EP
%%Page: 12 12
%%BeginPageSetup
BP
@@ -1612,7 +1626,7 @@ E F1(LANG)108 648 Q F0 1.24(Used to determine the locale cate)7.11 F
(rrides the v).15 F .764(alue of)-.25 F F1(LANG)3.264 E F0 .764(and an)
3.264 F 3.264(yo)-.15 G(ther)-3.264 E F1(LC_)3.264 E F0 -.25(va)3.264 G
.764(riable specifying a locale cate-).25 F(gory)144 696 Q(.)-.65 E
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(12)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(12)198.725 E 0 Cg EP
%%Page: 13 13
%%BeginPageSetup
BP
@@ -1716,8 +1730,8 @@ F0 1.225(displays during an e)3.725 F -.15(xe)-.15 G 1.225
E F0 1.226(is replicated multiple)3.476 F(times, as necessary)144 696 Q
2.5(,t)-.65 G 2.5(oi)-2.5 G(ndicate multiple le)-2.5 E -.15(ve)-.25 G
(ls of indirection.).15 E(The def)5 E(ault is `)-.1 E(`)-.74 E F1(+)A F0
-.74('')2.5 G(.).74 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(13)
199.835 E 0 Cg EP
-.74('')2.5 G(.).74 E(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(13)
198.725 E 0 Cg EP
%%Page: 14 14
%%BeginPageSetup
BP
@@ -1835,7 +1849,7 @@ G .961(or an)-3.461 F 3.461(yr)-.15 G(equirement)-3.461 E
1.302(An array is created automatically if an)108 728.4 R 3.801(yv)-.15
G 1.301(ariable is assigned to using the syntax)-4.051 F F2(name)3.801 E
F0([)A F2(subscript)A F0(]=)A F2(value)A F0(.)A(GNU Bash-3.0)72 768 Q
(2004 Jan 28)149.845 E(14)199.835 E 0 Cg EP
(2004 Apr 20)148.735 E(14)198.725 E 0 Cg EP
%%Page: 15 15
%%BeginPageSetup
BP
@@ -1987,7 +2001,7 @@ F0(must be of the same type.)2.5 E .582(Brace e)108 705.6 R .582
(does not apply an)2.516 F 2.516(ys)-.15 G .016
(yntactic interpretation to the con-)-2.516 F(te)108 729.6 Q
(xt of the e)-.15 E(xpansion or the te)-.15 E(xt between the braces.)
-.15 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(15)199.835 E 0 Cg EP
-.15 E(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(15)198.725 E 0 Cg EP
%%Page: 16 16
%%BeginPageSetup
BP
@@ -2115,7 +2129,7 @@ E .351(able is then e)108 700.8 R .351(xpanded and that v)-.15 F .352
F2(@)A F0 .762(]} described belo)B 4.563 -.65(w. T)-.25 H .763(he e).65
F .763(xclamation point must immediately follo)-.15 F 3.263(wt)-.25 G
.763(he left brace in order to)-3.263 F(GNU Bash-3.0)72 768 Q
(2004 Jan 28)149.845 E(16)199.835 E 0 Cg EP
(2004 Apr 20)148.735 E(16)198.725 E 0 Cg EP
%%Page: 17 17
%%BeginPageSetup
BP
@@ -2238,7 +2252,7 @@ F1(par)145.25 664.8 Q(ameter)-.15 E F0 .607
3.151(,t)C .651(he pattern remo)-3.151 F -.25(va)-.15 G 3.151(lo).25 G
.65(peration is applied to each member of the array in)-3.151 F
(turn, and the e)144 712.8 Q(xpansion is the resultant list.)-.15 E
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(17)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(17)198.725 E 0 Cg EP
%%Page: 18 18
%%BeginPageSetup
BP
@@ -2351,7 +2365,7 @@ F1 -.2(ex)2.666 G(pr).2 E(ession)-.37 E F0 .165
A F0(If)5.878 E F1 -.2(ex)108 705.6 S(pr).2 E(ession)-.37 E F0(is in)
2.74 E -.25(va)-.4 G(lid,).25 E F2(bash)2.5 E F0
(prints a message indicating f)2.5 E(ailure and no substitution occurs.)
-.1 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(18)199.835 E 0 Cg EP
-.1 E(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(18)198.725 E 0 Cg EP
%%Page: 19 19
%%BeginPageSetup
BP
@@ -2488,8 +2502,8 @@ R 1.12(NUL character may not occur in a pattern.)3.62 F 3.62(Ab)6.12 G
(The special pattern characters must be quoted if the)5.576 F 3.076(ya)
-.15 G(re)-3.076 E(to be matched literally)108 691.2 Q(.)-.65 E
(The special pattern characters ha)108 708 Q .3 -.15(ve t)-.2 H
(he follo).15 E(wing meanings:)-.25 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)
149.845 E(19)199.835 E 0 Cg EP
(he follo).15 E(wing meanings:)-.25 E(GNU Bash-3.0)72 768 Q(2004 Apr 20)
148.735 E(19)198.725 E 0 Cg EP
%%Page: 20 20
%%BeginPageSetup
BP
@@ -2576,12 +2590,12 @@ F2 -.37(re)3.045 G(dir).37 E(ected)-.37 E F0 .545
(ywhere within a)-.15 F F2 .775(simple command)3.615 F F0(or)4.045 E
(may follo)108 584.4 Q 2.5(wa)-.25 G F2(command)A F0 5(.R).77 G
(edirections are processed in the order the)-5 E 2.5(ya)-.15 G(ppear)
-2.5 E 2.5(,f)-.4 G(rom left to right.)-2.5 E .448(In the follo)108
601.2 R .447(wing descriptions, if the \214le descriptor number is omit\
ted, and the \214rst character of the redirec-)-.25 F .365
(tion operator is)108 613.2 R F1(<)2.865 E F0 2.865(,t)C .366
-2.5 E 2.5(,f)-.4 G(rom left to right.)-2.5 E .284(In the follo)108
601.2 R .283(wing descriptions, if the \214le descriptor number is omit\
ted, and the \214rst character of the redirect-)-.25 F .512
(ion operator is)108 613.2 R F1(<)3.012 E F0 3.012(,t)C .512
(he redirection refers to the standard input \(\214le descriptor 0\).)
-2.865 F .366(If the \214rst character of the)5.366 F
-3.012 F .512(If the \214rst character of the)5.512 F
(redirection operator is)108 625.2 Q F1(>)2.5 E F0 2.5(,t)C
(he redirection refers to the standard output \(\214le descriptor 1\).)
-2.5 E .825(The w)108 642 R .825(ord follo)-.1 F .824
@@ -2599,7 +2613,7 @@ ted, and the \214rst character of the redirec-)-.25 F .365
E F0(dirlist 2)2.5 E F1(>&)A F0(1)A
(directs both standard output and standard error to the \214le)108 728.4
Q F2(dirlist)2.5 E F0 2.5(,w).68 G(hile the command)-2.5 E(GNU Bash-3.0)
72 768 Q(2004 Jan 28)149.845 E(20)199.835 E 0 Cg EP
72 768 Q(2004 Apr 20)148.735 E(20)198.725 E 0 Cg EP
%%Page: 21 21
%%BeginPageSetup
BP
@@ -2658,15 +2672,15 @@ F2(n)A F0(])A F1(>)A F2(wor)A(d)-.37 E F0 .155
(If the redirection operator is)108 508.8 R F1(>)2.655 E F0 2.655(,a)C
.155(nd the)-2.655 F F1(noclob)2.655 E(ber)-.1 E F0 .154(option to the)
2.654 F F1(set)2.654 E F0 -.2(bu)2.654 G .154
(iltin has been enabled, the redirection).2 F .076(will f)108 520.8 R
.076(ail if the \214le whose name results from the e)-.1 F .076
(xpansion of)-.15 F F2(wor)2.576 E(d)-.37 E F0 -.15(ex)2.576 G .076
(ists and is a re).15 F .077(gular \214le.)-.15 F .077(If the redirec-)
5.077 F .548(tion operator is)108 532.8 R F1(>|)3.048 E F0 3.048(,o)C
3.048(rt)-3.048 G .548(he redirection operator is)-3.048 F F1(>)3.047 E
F0 .547(and the)3.047 F F1(noclob)3.047 E(ber)-.1 E F0 .547
(option to the)3.047 F F1(set)3.047 E F0 -.2(bu)3.047 G .547
(iltin command is).2 F(not enabled, the redirection is attempted e)108
(iltin has been enabled, the redirection).2 F .657(will f)108 520.8 R
.657(ail if the \214le whose name results from the e)-.1 F .658
(xpansion of)-.15 F F2(wor)3.158 E(d)-.37 E F0 -.15(ex)3.158 G .658
(ists and is a re).15 F .658(gular \214le.)-.15 F .658(If the redi-)
5.658 F .409(rection operator is)108 532.8 R F1(>|)2.909 E F0 2.909(,o)C
2.909(rt)-2.909 G .409(he redirection operator is)-2.909 F F1(>)2.909 E
F0 .409(and the)2.909 F F1(noclob)2.909 E(ber)-.1 E F0 .409
(option to the)2.909 F F1(set)2.909 E F0 -.2(bu)2.908 G .408
(iltin command).2 F(is not enabled, the redirection is attempted e)108
544.8 Q -.15(ve)-.25 G 2.5(ni).15 G 2.5(ft)-2.5 G(he \214le named by)
-2.5 E F2(wor)2.5 E(d)-.37 E F0 -.15(ex)2.5 G(ists.).15 E F1 -.25(Ap)87
561.6 S(pending Redir).25 E(ected Output)-.18 E F0 .641
@@ -2688,7 +2702,7 @@ Q F0(allo)3.141 E .642(ws both the standard output \(\214le descriptor \
E(There are tw)108 693.6 Q 2.5(of)-.1 G
(ormats for redirecting standard output and standard error:)-2.5 E F1
(&>)144 710.4 Q F2(wor)A(d)-.37 E F0(and)108 722.4 Q(GNU Bash-3.0)72 768
Q(2004 Jan 28)149.845 E(21)199.835 E 0 Cg EP
Q(2004 Apr 20)148.735 E(21)198.725 E 0 Cg EP
%%Page: 22 22
%%BeginPageSetup
BP
@@ -2775,7 +2789,7 @@ E F0(is closed after being duplicated to)2.5 E F2(n)2.5 E F0(.)A
.24 G 2.786(rt)-2.786 G .285
(he standard output \(\214le descriptor 1\) if)-2.786 F F2(n)2.785 E F0
.285(is not speci-)2.785 F(\214ed.)108 705.6 Q(GNU Bash-3.0)72 768 Q
(2004 Jan 28)149.845 E(22)199.835 E 0 Cg EP
(2004 Apr 20)148.735 E(22)198.725 E 0 Cg EP
%%Page: 23 23
%%BeginPageSetup
BP
@@ -2796,32 +2810,34 @@ E 3.174(was)-.25 G .674(tring to be substituted for a w)-3.174 F .674
(ord of a simple command.)-.1 F .394(The shell maintains a list of alia\
ses that may be set and unset with the)108 182.4 R F1(alias)2.894 E F0
(and)2.894 E F1(unalias)2.894 E F0 -.2(bu)2.894 G .394(iltin commands).2
F(\(see)108 194.4 Q/F4 9/Times-Bold@0 SF .763(SHELL B)3.264 F(UIL)-.09 E
.763(TIN COMMANDS)-.828 F F0(belo)3.013 E 3.263(w\). The)-.25 F .763
(\214rst w)3.263 F .763(ord of each command, if unquoted, is check)-.1 F
.763(ed to)-.1 F .633(see if it has an alias.)108 206.4 R .633
(If so, that w)5.633 F .633(ord is replaced by the te)-.1 F .634
(xt of the alias.)-.15 F .634(The alias name and the replace-)5.634 F
.538(ment te)108 218.4 R .538(xt may contain an)-.15 F 3.038(yv)-.15 G
.537(alid shell input, including the)-3.288 F F2(metac)3.417 E(har)-.15
E(acter)-.15 E(s)-.1 E F0 .537(listed abo)3.307 F -.15(ve)-.15 G 3.037
(,w).15 G .537(ith the e)-3.037 F(xception)-.15 E .996
(that the alias name may not contain)108 230.4 R F2(=)3.496 E F0 5.996
(.T)C .996(he \214rst w)-5.996 F .997(ord of the replacement te)-.1 F
.997(xt is tested for aliases, b)-.15 F .997(ut a)-.2 F -.1(wo)108 242.4
S .495(rd that is identical to an alias being e).1 F .495
(xpanded is not e)-.15 F .495(xpanded a second time.)-.15 F .494
(This means that one may)5.494 F(alias)108 254.4 Q F1(ls)3.019 E F0(to)
3.019 E F1 .519(ls \255F)3.019 F F0 3.019(,f)C .519(or instance, and)
-3.019 F F1(bash)3.019 E F0 .52(does not try to recursi)3.019 F -.15(ve)
-.25 G .52(ly e).15 F .52(xpand the replacement te)-.15 F 3.02(xt. If)
-.15 F .52(the last)3.02 F .441(character of the alias v)108 266.4 R
.441(alue is a)-.25 F F2(blank)2.941 E F0 2.941(,t).67 G .441
(hen the ne)-2.941 F .441(xt command w)-.15 F .441(ord follo)-.1 F .441
(wing the alias is also check)-.25 F .441(ed for)-.1 F(alias e)108 278.4
Q(xpansion.)-.15 E(Aliases are created and listed with the)108 295.2 Q
F1(alias)2.5 E F0(command, and remo)2.5 E -.15(ve)-.15 G 2.5(dw).15 G
(ith the)-2.5 E F1(unalias)2.5 E F0(command.)2.5 E .284
F(\(see)108 194.4 Q/F4 9/Times-Bold@0 SF 1.98(SHELL B)4.48 F(UIL)-.09 E
1.98(TIN COMMANDS)-.828 F F0(belo)4.23 E 4.48(w\). The)-.25 F 1.98
(\214rst w)4.48 F 1.979(ord of each simple command, if unquoted, is)-.1
F(check)108 206.4 Q .472(ed to see if it has an alias.)-.1 F .472
(If so, that w)5.472 F .473(ord is replaced by the te)-.1 F .473
(xt of the alias.)-.15 F .473(The characters)5.473 F F1(/)2.973 E F0(,)A
F1($)2.973 E F0(,)A F1(`)2.973 E F0(,)A(and)108 218.4 Q F1(=)3.612 E F0
1.112(and an)3.612 F 3.612(yo)-.15 G 3.612(ft)-3.612 G 1.112(he shell)
-3.612 F F2(metac)3.612 E(har)-.15 E(acter)-.15 E(s)-.1 E F0 1.112
(or quoting characters listed abo)3.612 F 1.411 -.15(ve m)-.15 H 1.111
(ay not appear in an alias).15 F 3.619(name. The)108 230.4 R 1.119
(replacement te)3.619 F 1.119(xt may contain an)-.15 F 3.619(yv)-.15 G
1.119(alid shell input, including shell metacharacters.)-3.869 F 1.12
(The \214rst)6.12 F -.1(wo)108 242.4 S .514(rd of the replacement te).1
F .514(xt is tested for aliases, b)-.15 F .514(ut a w)-.2 F .513
(ord that is identical to an alias being e)-.1 F .513(xpanded is)-.15 F
.295(not e)108 254.4 R .295(xpanded a second time.)-.15 F .296
(This means that one may alias)5.295 F F1(ls)2.796 E F0(to)2.796 E F1
.296(ls \255F)2.796 F F0 2.796(,f)C .296(or instance, and)-2.796 F F1
(bash)2.796 E F0 .296(does not try)2.796 F .543(to recursi)108 266.4 R
-.15(ve)-.25 G .543(ly e).15 F .543(xpand the replacement te)-.15 F
3.043(xt. If)-.15 F .543(the last character of the alias v)3.043 F .542
(alue is a)-.25 F F2(blank)3.042 E F0 3.042(,t).67 G .542(hen the ne)
-3.042 F(xt)-.15 E(command w)108 278.4 Q(ord follo)-.1 E
(wing the alias is also check)-.25 E(ed for alias e)-.1 E(xpansion.)-.15
E(Aliases are created and listed with the)108 295.2 Q F1(alias)2.5 E F0
(command, and remo)2.5 E -.15(ve)-.15 G 2.5(dw).15 G(ith the)-2.5 E F1
(unalias)2.5 E F0(command.)2.5 E .284
(There is no mechanism for using ar)108 312 R .284
(guments in the replacement te)-.18 F 2.784(xt. If)-.15 F(ar)2.784 E
.284(guments are needed, a shell func-)-.18 F(tion should be used \(see)
@@ -2877,13 +2893,13 @@ G 2.816(cuted. Functions).15 F .316(are e)2.816 F -.15(xe)-.15 G .316
F .639(function is e)108 559.2 R -.15(xe)-.15 G .639(cuted, the ar).15 F
.639
(guments to the function become the positional parameters during its e)
-.18 F -.15(xe)-.15 G(cution.).15 E .999(The special parameter)108 571.2
R F1(#)3.498 E F0 .998(is updated to re\215ect the change.)3.498 F .998
(Positional parameter 0 is unchanged.)5.998 F .998(The \214rst)5.998 F
.369(element of the)108 583.2 R F4(FUNCN)2.869 E(AME)-.18 E F0 -.25(va)
2.619 G .37
-.18 F -.15(xe)-.15 G(cution.).15 E .533(The special parameter)108 571.2
R F1(#)3.033 E F0 .532(is updated to re\215ect the change.)3.033 F .532
(Special parameter 0 is unchanged.)5.532 F .532(The \214rst ele-)5.532 F
1.017(ment of the)108 583.2 R F4(FUNCN)3.517 E(AME)-.18 E F0 -.25(va)
3.267 G 1.017
(riable is set to the name of the function while the function is e).25 F
-.15(xe)-.15 G 2.87(cuting. All).15 F 1.285
-.15(xe)-.15 G 3.518(cuting. All).15 F 1.285
(other aspects of the shell e)108 595.2 R -.15(xe)-.15 G 1.285
(cution en).15 F 1.285
(vironment are identical between a function and its caller with the)-.4
@@ -2915,8 +2931,8 @@ F F1 .616(\255o functrace)3.115 F F0 .616
(alues of the positional parameters and the spe-)-.25 F(cial parameter)
108 724.8 Q F1(#)2.5 E F0(are restored to the v)2.5 E(alues the)-.25 E
2.5(yh)-.15 G(ad prior to the function')-2.5 E 2.5(se)-.55 G -.15(xe)
-2.65 G(cution.).15 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(23)
199.835 E 0 Cg EP
-2.65 G(cution.).15 E(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(23)
198.725 E 0 Cg EP
%%Page: 24 24
%%BeginPageSetup
BP
@@ -3018,7 +3034,7 @@ H .343(ts inte).15 F .343(ger attrib)-.15 F .343(ute turned on)-.2 F
(xpressions in parentheses are e)-.15 F -.25(va)-.25 G .234
(luated \214rst and may).25 F -.15(ove)108 724.8 S
(rride the precedence rules abo).15 E -.15(ve)-.15 G(.).15 E
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(24)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(24)198.725 E 0 Cg EP
%%Page: 25 25
%%BeginPageSetup
BP
@@ -3128,7 +3144,7 @@ qual to, greater than, or greater than or equal to)144 696 R F3(ar)144
-.65 E F3(Ar)6.01 E(g1)-.37 E F0(and)2.5 E F3(ar)2.83 E(g2)-.37 E F0
(may be positi)2.52 E .3 -.15(ve o)-.25 H 2.5(rn).15 G -2.25 -.15(eg a)
-2.5 H(ti).15 E .3 -.15(ve i)-.25 H(nte).15 E(gers.)-.15 E(GNU Bash-3.0)
72 768 Q(2004 Jan 28)149.845 E(25)199.835 E 0 Cg EP
72 768 Q(2004 Apr 20)148.735 E(25)198.725 E 0 Cg EP
%%Page: 26 26
%%BeginPageSetup
BP
@@ -3244,7 +3260,7 @@ e remainder of the \214rst line speci\214es an interpreter for the pro-)
(COMMAND EXECUTION ENVIR)72 703.2 Q(ONMENT)-.329 E F0(The shell has an)
108 715.2 Q F5 -.2(ex)2.5 G(ecution en).2 E(vir)-.4 E(onment)-.45 E F0
2.5(,w)C(hich consists of the follo)-2.5 E(wing:)-.25 E(GNU Bash-3.0)72
768 Q(2004 Jan 28)149.845 E(26)199.835 E 0 Cg EP
768 Q(2004 Apr 20)148.735 E(26)198.725 E 0 Cg EP
%%Page: 27 27
%%BeginPageSetup
BP
@@ -3354,8 +3370,8 @@ t for)-.4 F F2 -.2(ex)2.643 G(port).2 E F0 .143(to child pro-)3.323 F
.202(parameter assignments, as described abo)108 724.8 R .502 -.15(ve i)
-.15 H(n).15 E/F4 9/Times-Bold@0 SF -.666(PA)2.702 G(RAMETERS).666 E/F5
9/Times-Roman@0 SF(.)A F0 .202(These assignment statements af)4.702 F
.203(fect only the)-.25 F(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E
(27)199.835 E 0 Cg EP
.203(fect only the)-.25 F(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E
(27)198.725 E 0 Cg EP
%%Page: 28 28
%%BeginPageSetup
BP
@@ -3440,14 +3456,14 @@ E F1(diso)2.5 E(wn \255h)-.1 E F0(.)A .166(If the)108 484.8 R F1
(huponexit)2.666 E F0 .166(shell option has been set with)2.666 F F1
(shopt)2.666 E F0(,)A F1(bash)2.666 E F0 .166(sends a)2.666 F F4(SIGHUP)
2.666 E F0 .166(to all jobs when an interacti)2.416 F -.15(ve)-.25 G
(login shell e)108 496.8 Q(xits.)-.15 E .076
(If 0for which a trap has been set, the trap will not be e)108 513.6 R
-.15(xe)-.15 G .077(cuted until the command completes.).15 F(When)5.077
E F1(bash)2.577 E F0(is)2.577 E -.1(wa)108 525.6 S .826
(iting for an asynchronous command via the).1 F F1(wait)3.326 E F0 -.2
(bu)3.326 G .826(iltin, the reception of a signal for which a trap has)
.2 F .369(been set will cause the)108 537.6 R F1(wait)2.869 E F0 -.2(bu)
2.869 G .369(iltin to return immediately with an e).2 F .37
(login shell e)108 496.8 Q(xits.)-.15 E .41
(If 0 for which a trap has been set, the trap will not be e)108 513.6 R
-.15(xe)-.15 G .41(cuted until the command completes.).15 F(When)5.41 E
F1(bash)2.91 E F0 .3(is w)108 525.6 R .3
(aiting for an asynchronous command via the)-.1 F F1(wait)2.8 E F0 -.2
(bu)2.8 G .3(iltin, the reception of a signal for which a trap has).2 F
.369(been set will cause the)108 537.6 R F1(wait)2.869 E F0 -.2(bu)2.869
G .369(iltin to return immediately with an e).2 F .37
(xit status greater than 128, immediately)-.15 F
(after which the trap is e)108 549.6 Q -.15(xe)-.15 G(cuted.).15 E F3
(JOB CONTR)72 566.4 Q(OL)-.329 E F2 -.25(Jo)108 578.4 S 4.568(bc).25 G
@@ -3479,7 +3495,7 @@ iated)108 676.8 R .732(with this job is 25647.)108 688.8 R .733
.87(notion of a)108 729.6 R F2(curr)3.37 E .87(ent terminal pr)-.37 F
.871(ocess gr)-.45 F .871(oup ID)-.45 F F0 5.871(.M)C .871
(embers of this process group \(processes whose process)-5.871 F
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(28)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(28)198.725 E 0 Cg EP
%%Page: 29 29
%%BeginPageSetup
BP
@@ -3606,7 +3622,7 @@ ized by inserting a number of backslash-escaped special characters that\
(\\r)144 700.8 Q F0(carriage return)28.78 E F4(\\s)144 712.8 Q F0
(the name of the shell, the basename of)29.33 E F4($0)2.5 E F0
(\(the portion follo)2.5 E(wing the \214nal slash\))-.25 E(GNU Bash-3.0)
72 768 Q(2004 Jan 28)149.845 E(29)199.835 E 0 Cg EP
72 768 Q(2004 Apr 20)148.735 E(29)198.725 E 0 Cg EP
%%Page: 30 30
%%BeginPageSetup
BP
@@ -3727,8 +3743,8 @@ nd the k)108 652.8 R 1.334 -.15(ey b)-.1 H 1.034(indings and).15 F -.25
-.15(ey)-.1 G .987(-bindings may be changed with an).15 F F2(inputr)
3.497 E(c)-.37 E F0 3.487(\214le. Other)3.797 F .987
(programs that use this library may)3.487 F(add their o)108 717.6 Q
(wn commands and bindings.)-.25 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)
149.845 E(30)199.835 E 0 Cg EP
(wn commands and bindings.)-.25 E(GNU Bash-3.0)72 768 Q(2004 Apr 20)
148.735 E(30)198.725 E 0 Cg EP
%%Page: 31 31
%%BeginPageSetup
BP
@@ -3810,8 +3826,8 @@ pes is a)108 612 Q -.25(va)-.2 G(ilable:).25 E F2(\\a)144 624 Q F0
648 Q F0(delete)27.66 E F2(\\f)144 660 Q F0(form feed)29.89 E F2(\\n)144
672 Q F0(ne)27.66 E(wline)-.25 E F2(\\r)144 684 Q F0(carriage return)
28.78 E F2(\\t)144 696 Q F0(horizontal tab)29.89 E F2(\\v)144 708 Q F0
-.15(ve)28.22 G(rtical tab).15 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)
149.845 E(31)199.835 E 0 Cg EP
-.15(ve)28.22 G(rtical tab).15 E(GNU Bash-3.0)72 768 Q(2004 Apr 20)
148.735 E(31)198.725 E 0 Cg EP
%%Page: 32 32
%%BeginPageSetup
BP
@@ -3910,7 +3926,7 @@ F0 .448(When set to)144 688.8 R F1(On)2.948 E F0 2.948(,m)C(ak)-2.948 E
.449(crolling the input horizontally on a)-2.948 F 1.194(single screen \
line when it becomes longer than the screen width rather than wrapping \
to a ne)144 700.8 R(w)-.25 E(line.)144 712.8 Q(GNU Bash-3.0)72 768 Q
(2004 Jan 28)149.845 E(32)199.835 E 0 Cg EP
(2004 Apr 20)148.735 E(32)198.725 E 0 Cg EP
%%Page: 33 33
%%BeginPageSetup
BP
@@ -4009,7 +4025,7 @@ F0 .463(construct allo)2.963 F .462(ws bindings to be made based on the\
(xt of the test e)-.15 F .477
(xtends to the end of the line; no characters)-.15 F
(are required to isolate it.)144 705.6 Q(GNU Bash-3.0)72 768 Q
(2004 Jan 28)149.845 E(33)199.835 E 0 Cg EP
(2004 Apr 20)148.735 E(33)198.725 E 0 Cg EP
%%Page: 34 34
%%BeginPageSetup
BP
@@ -4117,8 +4133,8 @@ E F0 .911(refers to the current cursor position, and)3.411 F F2(mark)
(db).15 G 3.41(yt)-3.41 G(he)-3.41 E F1(set\255mark)108 724.8 Q F0 2.5
(command. The)2.5 F(te)2.5 E
(xt between the point and mark is referred to as the)-.15 E F2 -.37(re)
2.5 G(gion)-.03 E F0(.)A(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(34)
199.835 E 0 Cg EP
2.5 G(gion)-.03 E F0(.)A(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(34)
198.725 E 0 Cg EP
%%Page: 35 35
%%BeginPageSetup
BP
@@ -4197,8 +4213,8 @@ etween the start of the current)-.1 F(line and the point.)144 688.8 Q
(th an ar).4 F(gument)-.18 E/F3 10/Times-Italic@0 SF(n)3.294 E F0 3.294
(,i).24 G .794(nsert the)-3.294 F F3(n)3.294 E F0 .794(th w)B .794
(ord from the pre)-.1 F .794(vious command \(the w)-.25 F .795
(ords in the)-.1 F(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(35)
199.835 E 0 Cg EP
(ords in the)-.1 F(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(35)
198.725 E 0 Cg EP
%%Page: 36 36
%%BeginPageSetup
BP
@@ -4294,8 +4310,8 @@ G .779(nsert characters lik)-3.279 F(e)-.1 E F2(C\255q)3.278 E F0 3.278
-.1 F .023(ving point o)-.15 F -.15(ve)-.15 G 2.524(rt).15 G .024(hat w)
-2.524 F .024(ord as well.)-.1 F .024(If point)5.024 F
(is at the end of the line, this transposes the last tw)144 700.8 Q 2.5
(ow)-.1 G(ords on the line.)-2.6 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)
149.845 E(36)199.835 E 0 Cg EP
(ow)-.1 G(ords on the line.)-2.6 E(GNU Bash-3.0)72 768 Q(2004 Apr 20)
148.735 E(36)198.725 E 0 Cg EP
%%Page: 37 37
%%BeginPageSetup
BP
@@ -4384,7 +4400,7 @@ F0 -1(Ya)144 676.8 S(nk the top of the kill ring into the b)1 E(uf)-.2 E
(Rotate the kill ring, and yank the ne)144 700.8 Q 2.5(wt)-.25 G 2.5
(op. Only)-2.5 F -.1(wo)2.5 G(rks follo).1 E(wing)-.25 E F1(yank)2.5 E
F0(or)2.5 E F1(yank\255pop)2.5 E F0(.)A(GNU Bash-3.0)72 768 Q
(2004 Jan 28)149.845 E(37)199.835 E 0 Cg EP
(2004 Apr 20)148.735 E(37)198.725 E 0 Cg EP
%%Page: 38 38
%%BeginPageSetup
BP
@@ -4486,7 +4502,7 @@ F0(List the possible completions of the te)144 628.8 Q
.715(ords, shell functions, shell b)-.1 F .715(uiltins, and)-.2 F
(\214nally e)144 724.8 Q -.15(xe)-.15 G
(cutable \214lenames, in that order).15 E(.)-.55 E(GNU Bash-3.0)72 768 Q
(2004 Jan 28)149.845 E(38)199.835 E 0 Cg EP
(2004 Apr 20)148.735 E(38)198.725 E 0 Cg EP
%%Page: 39 39
%%BeginPageSetup
BP
@@ -4582,8 +4598,8 @@ F0 1.095(command enough times to)3.595 F
(he current line a shell comment.)-3.339 F .839(If a numeric ar)5.839 F
(gu-)-.18 E(ment causes the comment character to be remo)144 729.6 Q
-.15(ve)-.15 G(d, the line will be e).15 E -.15(xe)-.15 G
(cuted by the shell.).15 E(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E
(39)199.835 E 0 Cg EP
(cuted by the shell.).15 E(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E
(39)198.725 E 0 Cg EP
%%Page: 40 40
%%BeginPageSetup
BP
@@ -4703,7 +4719,7 @@ F .404(gument is the name of the command whose ar)-.18 F .403
(guments are being completed, the second)-.18 F(ar)108 729.6 Q 1.993
(gument is the w)-.18 F 1.993(ord being completed, and the third ar)-.1
F 1.993(gument is the w)-.18 F 1.993(ord preceding the w)-.1 F 1.994
(ord being)-.1 F(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(40)199.835
(ord being)-.1 F(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(40)198.725
E 0 Cg EP
%%Page: 41 41
%%BeginPageSetup
@@ -4849,7 +4865,7 @@ R 1.485(ws control o)-.25 F -.15(ve)-.15 G 3.986(rw).15 G 1.486
E(OL)-.27 E F0(and)3.736 E F2(HISTIGNORE)108 729.6 Q F0 -.25(va)2.708 G
.458(riables may be set to cause the shell to sa).25 F .757 -.15(ve o)
-.2 H .457(nly a subset of the commands entered.).15 F(The)5.457 E
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(41)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(41)198.725 E 0 Cg EP
%%Page: 42 42
%%BeginPageSetup
BP
@@ -4972,7 +4988,7 @@ SF(^)108 667.4 Q F4(string1)-5 I F5(^)5 I F4(string2)-5 I F5(^)5 I F0
F4(string2)A F0(/')A 2.5('\()-.74 G(see)-2.5 E F1(Modi\214ers)2.5 E F0
(belo)2.5 E(w\).)-.25 E F1(!#)108 698.4 Q F0
(The entire command line typed so f)27.67 E(ar)-.1 E(.)-.55 E
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(42)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(42)198.725 E 0 Cg EP
%%Page: 43 43
%%BeginPageSetup
BP
@@ -5088,7 +5104,7 @@ R -.15(xe)-.15 G 3.332(cutable. When).15 F F1(bash)3.332 E F0 .832
/Times-Roman@0 SF(.)A F0 .981(If the)5.481 F F1(sour)3.481 E(cepath)-.18
E F0 .981(option to the)3.481 F F1(shopt)3.481 E F0 -.2(bu)3.481 G .981
(iltin command is turned of).2 F .981(f, the)-.25 F(GNU Bash-3.0)72 768
Q(2004 Jan 28)149.845 E(43)199.835 E 0 Cg EP
Q(2004 Apr 20)148.735 E(43)198.725 E 0 Cg EP
%%Page: 44 44
%%BeginPageSetup
BP
@@ -5200,7 +5216,7 @@ F2 -.1(ke)2.5 G(yseq)-.2 E F0(Remo)180 650.4 Q .3 -.15(ve a)-.15 H .3
F2 -.1(ke)2.5 G(yseq)-.2 E F0(is entered.)2.5 E(The return v)144 691.2 Q
(alue is 0 unless an unrecognized option is gi)-.25 E -.15(ve)-.25 G 2.5
(no).15 G 2.5(ra)-2.5 G 2.5(ne)-2.5 G(rror occurred.)-2.5 E
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(44)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(44)198.725 E 0 Cg EP
%%Page: 45 45
%%BeginPageSetup
BP
@@ -5336,8 +5352,8 @@ F2(action)2.786 E F0 2.786(][)C F1<ad47>-2.786 E F2(globpat)2.786 E F0
E F2(suf-)2.786 E<8c78>108 712.8 Q F0(])A([)144 724.8 Q F1<ad58>A F2
(\214lterpat)2.5 E F0 2.5(][)C F1<ad46>-2.5 E F2(function)2.5 E F0 2.5
(][)C F1<ad43>-2.5 E F2(command)2.5 E F0(])A F2(name)2.5 E F0([)2.5 E F2
(name ...)A F0(])A(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(45)
199.835 E 0 Cg EP
(name ...)A F0(])A(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(45)
198.725 E 0 Cg EP
%%Page: 46 46
%%BeginPageSetup
BP
@@ -5412,7 +5428,7 @@ Q(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 696 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(GNU Bash-3.0)72 768
Q(2004 Jan 28)149.845 E(46)199.835 E 0 Cg EP
Q(2004 Apr 20)148.735 E(46)198.725 E 0 Cg EP
%%Page: 47 47
%%BeginPageSetup
BP
@@ -5519,7 +5535,7 @@ n is de\214ned are displayed as well.)144 662.4 R(The)6.309 E F1<ad46>
698.4 Q F0(Each)25.3 E F2(name)2.5 E F0(is an array 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<ad66>144 710.4 Q F0(Use function names only)26.97 E(.)-.65 E
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(47)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(47)198.725 E 0 Cg EP
%%Page: 48 48
%%BeginPageSetup
BP
@@ -5639,7 +5655,7 @@ F .659(by def)144 648 R(ault.)-.1 E F1(echo)5.659 E F0 .659
(\\a)144 672 Q F0(alert \(bell\))28.22 E F1(\\b)144 684 Q F0(backspace)
27.66 E F1(\\c)144 696 Q F0(suppress trailing ne)28.78 E(wline)-.25 E F1
(\\e)144 708 Q F0(an escape character)28.78 E(GNU Bash-3.0)72 768 Q
(2004 Jan 28)149.845 E(48)199.835 E 0 Cg EP
(2004 Apr 20)148.735 E(48)198.725 E 0 Cg EP
%%Page: 49 49
%%BeginPageSetup
BP
@@ -5773,8 +5789,8 @@ Q F0(that is not a function.)2.68 E F1(fc)108 688.8 Q F0([)2.5 E F1
(is selected from the his-)3.658 F .882(tory list.)144 724.8 R F2 -.45
(Fi)5.882 G -.1(rs).45 G(t).1 E F0(and)4.062 E F2(last)3.472 E F0 .882
(may be speci\214ed as a string \(to locate the last command be)4.062 F
.881(ginning with)-.15 F(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(49)
199.835 E 0 Cg EP
.881(ginning with)-.15 F(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(49)
198.725 E 0 Cg EP
%%Page: 50 50
%%BeginPageSetup
BP
@@ -5904,7 +5920,7 @@ F0 .399(is silent, the option character found is placed in)2.899 F F4
729.6 R 1.241(gument is not found, and)-.18 F F3(getopts)3.741 E F0
1.241(is not silent, a question mark \()3.741 F F3(?).833 E F0 3.742
(\)i).833 G 3.742(sp)-3.742 G 1.242(laced in)-3.742 F(GNU Bash-3.0)72
768 Q(2004 Jan 28)149.845 E(50)199.835 E 0 Cg EP
768 Q(2004 Apr 20)148.735 E(50)198.725 E 0 Cg EP
%%Page: 51 51
%%BeginPageSetup
BP
@@ -6019,7 +6035,7 @@ E F0 .28
(is supplied as an ar)2.922 F .421(gument to)-.18 F F3<ad64>2.921 E F0
(,)A(or the history e)144 703.2 Q(xpansion supplied as an ar)-.15 E
(gument to)-.18 E F3<ad70>2.5 E F0 -.1(fa)2.5 G(ils.).1 E(GNU Bash-3.0)
72 768 Q(2004 Jan 28)149.845 E(51)199.835 E 0 Cg EP
72 768 Q(2004 Apr 20)148.735 E(51)198.725 E 0 Cg EP
%%Page: 52 52
%%BeginPageSetup
BP
@@ -6146,7 +6162,7 @@ tring which contains three types of objects: plain characters, which ar\
e simply)144 715.2 R 1.859
(copied to standard output, character escape sequences, which are con)
144 727.2 R -.15(ve)-.4 G 1.858(rted and copied to the).15 F
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(52)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(52)198.725 E 0 Cg EP
%%Page: 53 53
%%BeginPageSetup
BP
@@ -6264,8 +6280,8 @@ F2<ad65>144 655.2 Q F0 .373
-.15 E(s)-.1 E F2 -.18(re)180 691.2 S(ad).18 E F0 1.394
(returns after reading)3.894 F F1(nc)3.894 E(har)-.15 E(s)-.1 E F0 1.395
(characters rather than w)3.894 F 1.395(aiting for a complete line of)
-.1 F(input.)180 703.2 Q(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(53)
199.835 E 0 Cg EP
-.1 F(input.)180 703.2 Q(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(53)
198.725 E 0 Cg EP
%%Page: 54 54
%%BeginPageSetup
BP
@@ -6389,7 +6405,7 @@ SF<efef>3.481 E F3 .98(list, or if the command's r)3.481 F .98
.711(This option is on by default for interac-)5.711 F 1.165
(tive shells on systems that support it \(see)184 727.2 R F5 1.164
(JOB CONTROL)3.664 F F3 3.664(above\). Backgr)3.414 F(ound)-.18 E F0
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(54)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(54)198.725 E 0 Cg EP
%%Page: 55 55
%%BeginPageSetup
BP
@@ -6451,7 +6467,7 @@ F2<ad6f>4.631 E F1 2.131(is supplied with no)4.631 F F3(option\255name)
(ent options ar)-.18 F(e)-.18 E 4.411(printed. If)184 726 R F2(+o)4.411
E F1 1.911(is supplied with no)4.411 F F3(option\255name)4.412 E F1
4.412(,as)C 1.912(eries of)-4.412 F F2(set)4.412 E F1 1.912(commands to)
4.412 F F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(55)199.835 E 0 Cg
4.412 F F0(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(55)198.725 E 0 Cg
EP
%%Page: 56 56
%%BeginPageSetup
@@ -6573,8 +6589,8 @@ G(f)-2.5 E F3(n)2.76 E F1(is gr)2.58 E(eater than)-.18 E F2($#)2.5 E F1
(olling optional shell behavior)-.18 F 6.523(.W)-.74 G 1.523
(ith no options, or)-7.073 F 2.532(with the)144 722.4 R F2<ad70>5.032 E
F1 2.531(option, a list of all settable options is displayed, with an i\
ndication of)5.032 F F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(56)
199.835 E 0 Cg EP
ndication of)5.032 F F0(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(56)
198.725 E 0 Cg EP
%%Page: 57 57
%%BeginPageSetup
BP
@@ -6668,7 +6684,7 @@ F1 1.106(trap r)3.606 F 1.107(eturns a value of 2, and the)-.18 F .871
(outine \(a shell function or a shell script exe-)-.18 F(cuted by the)
220 728.4 Q F2(.)2.5 E F1(or)2.5 E F2(source)2.5 E F1
(builtins\), a call to)2.5 E F2(return)2.5 E F1(is simulated.)2.5 E F0
(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(57)199.835 E 0 Cg EP
(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(57)198.725 E 0 Cg EP
%%Page: 58 58
%%BeginPageSetup
BP
@@ -6748,8 +6764,8 @@ F3(mail\214le)4.147 E F2 1.647(has been r)4.147 F(ead')-.18 E 4.147('i)
F2 1.548
(matches \214lenames in a case\255insensitive fashion when performing)
4.048 F(pathname expansion \(see)184 696 Q F1(Pathname Expansion)2.5 E
F2(above\).)2.5 E F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(58)
199.835 E 0 Cg EP
F2(above\).)2.5 E F0(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(58)
198.725 E 0 Cg EP
%%Page: 59 59
%%BeginPageSetup
BP
@@ -6835,7 +6851,7 @@ F2 1.401(the expr)3.651 F 1.401(ession is tr)-.18 F 1.401
1.356(the \214rst ar)3.856 F 1.356
(gument is not a valid unary conditional operator)-.18 F 3.855(,t)-.74 G
(he)-3.855 E(expr)180 712.8 Q(ession is false.)-.18 E F0(GNU Bash-3.0)72
768 Q(2004 Jan 28)149.845 E(59)199.835 E 0 Cg EP
768 Q(2004 Apr 20)148.735 E(59)198.725 E 0 Cg EP
%%Page: 60 60
%%BeginPageSetup
BP
@@ -6976,7 +6992,7 @@ E F1 2.515(,e)C .015(ven if)-2.515 F F7 .015(type -t)2.515 F(name)144
.411(option is used,)2.911 F F4(type)2.91 E F1 .41(prints all)2.91 F
.164(of the places that contain an executable named)144 722.4 R F5(name)
2.664 E F1 5.164(.T).35 G .164(his includes aliases and functions,)
-5.164 F F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(60)199.835 E 0
-5.164 F F0(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(60)198.725 E 0
Cg EP
%%Page: 61 61
%%BeginPageSetup
@@ -7098,7 +7114,7 @@ E F5(,)A F4(HISTCMD)3.724 E F5(,)A F4(FUNCNAME)144 708 Q F5(,)A F4
.553(operties, even if)-.18 F(they ar)144 720 Q 2.5(es)-.18 G
(ubsequently r)-2.5 E 2.5(eset. The)-.18 F(exit status is tr)2.5 E
(ue unless a)-.08 E F3(name)2.76 E F1(is r)2.85 E(eadonly)-.18 E(.)-1.11
E F0(GNU Bash-3.0)72 768 Q(2004 Jan 28)149.845 E(61)199.835 E 0 Cg EP
E F0(GNU Bash-3.0)72 768 Q(2004 Apr 20)148.735 E(61)198.725 E 0 Cg EP
%%Page: 62 62
%%BeginPageSetup
BP
@@ -7182,7 +7198,7 @@ F2 2.5(,B)C(rian Fox and Chet Ramey)-2.5 E F3(Portable Operating System\
(The personal initialization \214le, executed for login shells)144 686.4
Q F3(~/.bashr)109.666 698.4 Q(c)-.18 E F2(The individual per)144 710.4 Q
(-interactive-shell startup \214le)-.18 E F0(GNU Bash-3.0)72 768 Q
(2004 Jan 28)149.845 E(62)199.835 E 0 Cg EP
(2004 Apr 20)148.735 E(62)198.725 E 0 Cg EP
%%Page: 63 63
%%BeginPageSetup
BP
@@ -7249,7 +7265,7 @@ F1(bashbug)108.13 393.6 Q F2 1.316(inserts the \214rst thr)4.296 F 1.316
-.18 F .431(or messages while the con-)-.18 F(str)108 631.2 Q
(uct is being r)-.08 E(ead.)-.18 E
(Array variables may not \(yet\) be exported.)108 648 Q F0(GNU Bash-3.0)
72 768 Q(2004 Jan 28)149.845 E(63)199.835 E 0 Cg EP
72 768 Q(2004 Apr 20)148.735 E(63)198.725 E 0 Cg EP
%%Trailer
end
%%EOF
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.html
+17 -15
View File
@@ -1,6 +1,6 @@
<HTML>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<!-- Created on January, 28 2004 by texi2html 1.64 -->
<!-- Created on April, 20 2004 by texi2html 1.64 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
@@ -33,10 +33,10 @@ Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
<H1>Bash Reference Manual</H1></P><P>
This text is a brief description of the features that are present in
the Bash shell (version 3.0-beta1, 28 January 2004)..
the Bash shell (version 3.0-beta1, 20 April 2004)..
</P><P>
This is Edition 3.0, last updated 28 January 2004,
This is Edition 3.0, last updated 20 April 2004,
of <CITE>The GNU Bash Reference Manual</CITE>,
for <CODE>Bash</CODE>, Version 3.0-beta1.
</P><P>
@@ -1554,7 +1554,7 @@ function become the positional parameters
during its execution (see section <A HREF="bashref.html#SEC25">3.4.1 Positional Parameters</A>).
The special parameter <SAMP>`#'</SAMP> that expands to the number of
positional parameters is updated to reflect the change.
Positional parameter <CODE>0</CODE> is unchanged.
Special parameter <CODE>0</CODE> is unchanged.
The first element of the <CODE>FUNCNAME</CODE> variable is set to the
name of the function while the function is executing.
All other aspects of the shell execution
@@ -2142,9 +2142,9 @@ if the colon is omitted, the operator tests only for existence.
<DD>If <VAR>parameter</VAR>
is unset or null, the expansion of <VAR>word</VAR>
is assigned to <VAR>parameter</VAR>.
The value of <VAR>parameter</VAR>
is then substituted. Positional parameters and special parameters may
not be assigned to in this way.
The value of <VAR>parameter</VAR> is then substituted.
Positional parameters and special parameters may not be assigned to
in this way.
<P>
<DT><CODE>${<VAR>parameter</VAR>:?<VAR>word</VAR>}</CODE>
@@ -7281,13 +7281,15 @@ the <CODE>alias</CODE> and <CODE>unalias</CODE> builtin commands.
The first word of each simple command, if unquoted, is checked to see
if it has an alias.
If so, that word is replaced by the text of the alias.
The alias name and the replacement text may contain any valid
shell input, including shell metacharacters, with the exception
that the alias name may not contain <SAMP>`='</SAMP>.
The characters <SAMP>`/'</SAMP>, <SAMP>`$'</SAMP>, <SAMP>``'</SAMP>, <SAMP>`='</SAMP> and any of the
shell metacharacters or quoting characters listed above may not appear
in an alias name.
The replacement text may contain any valid
shell input, including shell metacharacters.
The first word of the replacement text is tested for
aliases, but a word that is identical to an alias being expanded
is not expanded a second time. This means that one may alias
<CODE>ls</CODE> to <CODE>"ls -F"</CODE>,
is not expanded a second time.
This means that one may alias <CODE>ls</CODE> to <CODE>"ls -F"</CODE>,
for instance, and Bash does not try to recursively expand the
replacement text. If the last character of the alias value is a
space or tab character, then the next command word following the
@@ -8138,7 +8140,7 @@ Any trap on <CODE>SIGCHLD</CODE> is executed for each child process
that exits.
</P><P>
If an attempt to exit Bash is while jobs are stopped, the
If an attempt to exit Bash is made while jobs are stopped, the
shell prints a message warning that there are stopped jobs.
The <CODE>jobs</CODE> command may then be used to inspect their status.
If a second attempt to exit is made without an intervening command,
@@ -14996,7 +14998,7 @@ to permit their use in free software.
<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="bashref.html#SEC_About"> ? </A>]</TD>
</TR></TABLE>
<H1>About this document</H1>
This document was generated by <I>Chet Ramey</I> on <I>January, 28 2004</I>
This document was generated by <I>Chet Ramey</I> on <I>April, 20 2004</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
<P></P>
@@ -15158,7 +15160,7 @@ the following structure:
<BR>
<FONT SIZE="-1">
This document was generated
by <I>Chet Ramey</I> on <I>January, 28 2004</I>
by <I>Chet Ramey</I> on <I>April, 20 2004</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>
doc/bashref.info
+142 -141
View File
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 4.5 from
/usr/homes/chet/src/bash/src/doc/bashref.texi.
This text is a brief description of the features that are present in
the Bash shell (version 3.0-beta1, 28 January 2004).
the Bash shell (version 3.0-beta1, 20 April 2004).
This is Edition 3.0, last updated 28 January 2004, of `The GNU Bash
This is Edition 3.0, last updated 20 April 2004, of `The GNU Bash
Reference Manual', for `Bash', Version 3.0-beta1.
Copyright (C) 1988-2003 Free Software Foundation, Inc.
@@ -37,9 +37,9 @@ Bash Features
*************
This text is a brief description of the features that are present in
the Bash shell (version 3.0-beta1, 28 January 2004)..
the Bash shell (version 3.0-beta1, 20 April 2004)..
This is Edition 3.0, last updated 28 January 2004, of `The GNU Bash
This is Edition 3.0, last updated 20 April 2004, of `The GNU Bash
Reference Manual', for `Bash', Version 3.0-beta1.
Bash contains features that appear in other popular shells, and some
@@ -975,7 +975,7 @@ terminated by a semicolon, a `&', or a newline.
When a function is executed, the arguments to the function become
the positional parameters during its execution (*note Positional
Parameters::). The special parameter `#' that expands to the number of
positional parameters is updated to reflect the change. Positional
positional parameters is updated to reflect the change. Special
parameter `0' is unchanged. The first element of the `FUNCNAME'
variable is set to the name of the function while the function is
executing. All other aspects of the shell execution environment are
@@ -1351,8 +1351,8 @@ if the colon is omitted, the operator tests only for existence.
`${PARAMETER:=WORD}'
If PARAMETER is unset or null, the expansion of WORD is assigned
to PARAMETER. The value of PARAMETER is then substituted.
Positional parameters and special parameters may not be assigned
to in this way.
Positional parameters and special parameters may not be assigned to
in this way.
`${PARAMETER:?WORD}'
If PARAMETER is null or unset, the expansion of WORD (or a message
@@ -4809,15 +4809,16 @@ builtin commands.
The first word of each simple command, if unquoted, is checked to see
if it has an alias. If so, that word is replaced by the text of the
alias. The alias name and the replacement text may contain any valid
shell input, including shell metacharacters, with the exception that
the alias name may not contain `='. The first word of the replacement
text is tested for aliases, but a word that is identical to an alias
being expanded is not expanded a second time. This means that one may
alias `ls' to `"ls -F"', for instance, and Bash does not try to
recursively expand the replacement text. If the last character of the
alias value is a space or tab character, then the next command word
following the alias is also checked for alias expansion.
alias. The characters `/', `$', ``', `=' and any of the shell
metacharacters or quoting characters listed above may not appear in an
alias name. The replacement text may contain any valid shell input,
including shell metacharacters. The first word of the replacement text
is tested for aliases, but a word that is identical to an alias being
expanded is not expanded a second time. This means that one may alias
`ls' to `"ls -F"', for instance, and Bash does not try to recursively
expand the replacement text. If the last character of the alias value
is a space or tab character, then the next command word following the
alias is also checked for alias expansion.
Aliases are created and listed with the `alias' command, and removed
with the `unalias' command.
@@ -5428,7 +5429,7 @@ output. If the `-b' option to the `set' builtin is enabled, Bash
reports such changes immediately (*note The Set Builtin::). Any trap
on `SIGCHLD' is executed for each child process that exits.
If an attempt to exit Bash is while jobs are stopped, the shell
If an attempt to exit Bash is made while jobs are stopped, the shell
prints a message warning that there are stopped jobs. The `jobs'
command may then be used to inspect their status. If a second attempt
to exit is made without an intervening command, Bash does not print
@@ -9256,129 +9257,129 @@ Concept Index

Tag Table:
Node: Top1371
Node: Introduction3528
Node: What is Bash?3753
Node: What is a shell?4841
Node: Definitions7377
Node: Basic Shell Features10117
Node: Shell Syntax11335
Node: Shell Operation12359
Node: Quoting13644
Node: Escape Character14906
Node: Single Quotes15378
Node: Double Quotes15713
Node: ANSI-C Quoting16726
Node: Locale Translation17669
Node: Comments18552
Node: Shell Commands19157
Node: Simple Commands19918
Node: Pipelines20539
Node: Lists22405
Node: Compound Commands24027
Node: Looping Constructs24799
Node: Conditional Constructs27233
Node: Command Grouping34286
Node: Shell Functions35722
Node: Shell Parameters39987
Node: Positional Parameters41558
Node: Special Parameters42449
Node: Shell Expansions45107
Node: Brace Expansion47027
Node: Tilde Expansion49343
Node: Shell Parameter Expansion51675
Node: Command Substitution58929
Node: Arithmetic Expansion60251
Node: Process Substitution61092
Node: Word Splitting62129
Node: Filename Expansion63581
Node: Pattern Matching65705
Node: Quote Removal69026
Node: Redirections69312
Node: Executing Commands76787
Node: Simple Command Expansion77454
Node: Command Search and Execution79375
Node: Command Execution Environment81372
Node: Environment84134
Node: Exit Status85785
Node: Signals86980
Node: Shell Scripts88935
Node: Shell Builtin Commands91446
Node: Bourne Shell Builtins92876
Node: Bash Builtins109759
Node: The Set Builtin137881
Node: Special Builtins146099
Node: Shell Variables147071
Node: Bourne Shell Variables147507
Node: Bash Variables149484
Node: Bash Features168989
Node: Invoking Bash169871
Node: Bash Startup Files175682
Node: Interactive Shells180552
Node: What is an Interactive Shell?180954
Node: Is this Shell Interactive?181589
Node: Interactive Shell Behavior182395
Node: Bash Conditional Expressions185662
Node: Shell Arithmetic189082
Node: Aliases191822
Node: Arrays194325
Node: The Directory Stack197345
Node: Directory Stack Builtins198051
Node: Printing a Prompt200930
Node: The Restricted Shell203639
Node: Bash POSIX Mode205464
Node: Job Control212110
Node: Job Control Basics212576
Node: Job Control Builtins216856
Node: Job Control Variables221152
Node: Command Line Editing222302
Node: Introduction and Notation223300
Node: Readline Interaction224917
Node: Readline Bare Essentials226103
Node: Readline Movement Commands227883
Node: Readline Killing Commands228839
Node: Readline Arguments230748
Node: Searching231783
Node: Readline Init File233960
Node: Readline Init File Syntax235014
Node: Conditional Init Constructs246658
Node: Sample Init File249182
Node: Bindable Readline Commands252365
Node: Commands For Moving253564
Node: Commands For History254413
Node: Commands For Text257302
Node: Commands For Killing259963
Node: Numeric Arguments262093
Node: Commands For Completion263220
Node: Keyboard Macros266801
Node: Miscellaneous Commands267360
Node: Readline vi Mode272659
Node: Programmable Completion273568
Node: Programmable Completion Builtins279375
Node: Using History Interactively286737
Node: Bash History Facilities287416
Node: Bash History Builtins290106
Node: History Interaction293958
Node: Event Designators296509
Node: Word Designators297513
Node: Modifiers299143
Node: Installing Bash300540
Node: Basic Installation301674
Node: Compilers and Options304359
Node: Compiling For Multiple Architectures305093
Node: Installation Names306750
Node: Specifying the System Type307561
Node: Sharing Defaults308270
Node: Operation Controls308935
Node: Optional Features309886
Node: Reporting Bugs318158
Node: Major Differences From The Bourne Shell319333
Node: Copying This Manual335081
Node: GNU Free Documentation License335335
Node: Builtin Index357728
Node: Reserved Word Index361355
Node: Variable Index362831
Node: Function Index369824
Node: Concept Index374437
Node: Top1367
Node: Introduction3520
Node: What is Bash?3745
Node: What is a shell?4833
Node: Definitions7369
Node: Basic Shell Features10109
Node: Shell Syntax11327
Node: Shell Operation12351
Node: Quoting13636
Node: Escape Character14898
Node: Single Quotes15370
Node: Double Quotes15705
Node: ANSI-C Quoting16718
Node: Locale Translation17661
Node: Comments18544
Node: Shell Commands19149
Node: Simple Commands19910
Node: Pipelines20531
Node: Lists22397
Node: Compound Commands24019
Node: Looping Constructs24791
Node: Conditional Constructs27225
Node: Command Grouping34278
Node: Shell Functions35714
Node: Shell Parameters39976
Node: Positional Parameters41547
Node: Special Parameters42438
Node: Shell Expansions45096
Node: Brace Expansion47016
Node: Tilde Expansion49332
Node: Shell Parameter Expansion51664
Node: Command Substitution58918
Node: Arithmetic Expansion60240
Node: Process Substitution61081
Node: Word Splitting62118
Node: Filename Expansion63570
Node: Pattern Matching65694
Node: Quote Removal69015
Node: Redirections69301
Node: Executing Commands76776
Node: Simple Command Expansion77443
Node: Command Search and Execution79364
Node: Command Execution Environment81361
Node: Environment84123
Node: Exit Status85774
Node: Signals86969
Node: Shell Scripts88924
Node: Shell Builtin Commands91435
Node: Bourne Shell Builtins92865
Node: Bash Builtins109748
Node: The Set Builtin137870
Node: Special Builtins146088
Node: Shell Variables147060
Node: Bourne Shell Variables147496
Node: Bash Variables149473
Node: Bash Features168978
Node: Invoking Bash169860
Node: Bash Startup Files175671
Node: Interactive Shells180541
Node: What is an Interactive Shell?180943
Node: Is this Shell Interactive?181578
Node: Interactive Shell Behavior182384
Node: Bash Conditional Expressions185651
Node: Shell Arithmetic189071
Node: Aliases191811
Node: Arrays194374
Node: The Directory Stack197394
Node: Directory Stack Builtins198100
Node: Printing a Prompt200979
Node: The Restricted Shell203688
Node: Bash POSIX Mode205513
Node: Job Control212159
Node: Job Control Basics212625
Node: Job Control Builtins216910
Node: Job Control Variables221206
Node: Command Line Editing222356
Node: Introduction and Notation223354
Node: Readline Interaction224971
Node: Readline Bare Essentials226157
Node: Readline Movement Commands227937
Node: Readline Killing Commands228893
Node: Readline Arguments230802
Node: Searching231837
Node: Readline Init File234014
Node: Readline Init File Syntax235068
Node: Conditional Init Constructs246712
Node: Sample Init File249236
Node: Bindable Readline Commands252419
Node: Commands For Moving253618
Node: Commands For History254467
Node: Commands For Text257356
Node: Commands For Killing260017
Node: Numeric Arguments262147
Node: Commands For Completion263274
Node: Keyboard Macros266855
Node: Miscellaneous Commands267414
Node: Readline vi Mode272713
Node: Programmable Completion273622
Node: Programmable Completion Builtins279429
Node: Using History Interactively286791
Node: Bash History Facilities287470
Node: Bash History Builtins290160
Node: History Interaction294012
Node: Event Designators296563
Node: Word Designators297567
Node: Modifiers299197
Node: Installing Bash300594
Node: Basic Installation301728
Node: Compilers and Options304413
Node: Compiling For Multiple Architectures305147
Node: Installation Names306804
Node: Specifying the System Type307615
Node: Sharing Defaults308324
Node: Operation Controls308989
Node: Optional Features309940
Node: Reporting Bugs318212
Node: Major Differences From The Bourne Shell319387
Node: Copying This Manual335135
Node: GNU Free Documentation License335389
Node: Builtin Index357782
Node: Reserved Word Index361409
Node: Variable Index362885
Node: Function Index369878
Node: Concept Index374491

End Tag Table
doc/bashref.log
+4 -4
View File
@@ -1,4 +1,4 @@
This is TeX, Version 3.14159 (Web2C 7.3.1) (format=tex 2001.2.12) 28 JAN 2004 15:50
This is TeX, Version 3.14159 (Web2C 7.3.1) (format=tex 2001.2.12) 20 APR 2004 15:26
**/usr/homes/chet/src/bash/src/doc/bashref.texi
(/usr/homes/chet/src/bash/src/doc/bashref.texi (texinfo.tex
Loading texinfo [version 2003-02-03.16]: Basics,
@@ -318,7 +318,7 @@ Underfull \hbox (badness 2753) in paragraph at lines 1742--1745
[107]) (/usr/homes/chet/src/bash/src/lib/readline/doc/hsuser.texi Chapter 9
[108] [109] [110] [111] [112]) Chapter 10 [113] [114] [115] [116] [117]
Underfull \hbox (badness 2772) in paragraph at lines 6598--6602
Underfull \hbox (badness 2772) in paragraph at lines 6600--6604
[]@textrm Enable sup-port for large files (@texttt http://www.sas.com/standard
s/large_
@@ -357,10 +357,10 @@ Overfull \vbox (42.26959pt too high) has occurred while \output is active
Here is how much of TeX's memory you used:
1713 strings out of 13013
23227 string characters out of 97233
52393 words of memory out of 263001
52389 words of memory out of 263001
2577 multiletter control sequences out of 10000+0
31953 words of font info for 111 fonts, out of 400000 for 1000
19 hyphenation exceptions out of 1000
15i,8n,11p,273b,465s stack positions out of 300i,100n,500p,50000b,4000s
Output written on bashref.dvi (154 pages, 579212 bytes).
Output written on bashref.dvi (154 pages, 579284 bytes).
doc/bashref.ps
+63 -61
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.01.28:1550
%DVIPSSource: TeX output 2004.04.20:1526
%%BeginProcSet: texc.pro
%!
/TeXDict 300 dict def TeXDict begin/N{def}def/B{bind def}N/S{exch}N/X{S
@@ -2540,7 +2540,7 @@ letter
1 0 bop 150 1318 a Fu(Bash)64 b(Reference)j(Man)-5 b(ual)p
150 1385 3600 34 v 2361 1481 a Ft(Reference)31 b(Do)s(cumen)m(tation)h
(for)e(Bash)2178 1589 y(Edition)f(3.0,)i(for)f Fs(Bash)g
Ft(V)-8 b(ersion)30 b(3.0-b)s(eta1.)3218 1697 y(Jan)m(uary)g(2004)150
Ft(V)-8 b(ersion)30 b(3.0-b)s(eta1.)3333 1697 y(April)e(2004)150
4935 y Fr(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
@@ -2548,10 +2548,10 @@ b(oundation)p 150 5141 3600 17 v eop
%%Page: 2 2
2 1 bop 150 2889 a Ft(This)34 b(text)i(is)f(a)h(brief)e(description)g
(of)h(the)h(features)g(that)g(are)g(presen)m(t)g(in)e(the)i(Bash)f
(shell)f(\(v)m(ersion)150 2999 y(3.0-b)s(eta1,)f(28)e(Jan)m(uary)f
(2004\).)150 3133 y(This)i(is)g(Edition)f(3.0,)36 b(last)d(up)s(dated)f
(28)i(Jan)m(uary)f(2004,)j(of)d Fq(The)g(GNU)h(Bash)g(Reference)g(Man)m
(ual)p Ft(,)150 3243 y(for)c Fs(Bash)p Ft(,)g(V)-8 b(ersion)30
(shell)f(\(v)m(ersion)150 2999 y(3.0-b)s(eta1,)f(20)e(April)d(2004\).)
150 3133 y(This)k(is)h(Edition)e(3.0,)36 b(last)e(up)s(dated)e(20)j
(April)c(2004,)37 b(of)d Fq(The)f(GNU)h(Bash)g(Reference)g(Man)m(ual)p
Ft(,)h(for)150 3243 y Fs(Bash)p Ft(,)29 b(V)-8 b(ersion)30
b(3.0-b)s(eta1.)150 3377 y(Cop)m(yrigh)m(t)602 3374 y(c)577
3377 y Fp(\015)g Ft(1988-2003)k(F)-8 b(ree)32 b(Soft)m(w)m(are)f(F)-8
b(oundation,)31 b(Inc.)150 3512 y(P)m(ermission)f(is)i(gran)m(ted)h(to)
@@ -3828,21 +3828,21 @@ Fq(list)h Ft(m)m(ust)e(b)s(e)g(terminated)h(b)m(y)g(a)150
b(The)150 2436 y(sp)s(ecial)35 b(parameter)h(`)p Fs(#)p
Ft(')g(that)h(expands)e(to)i(the)f(n)m(um)m(b)s(er)f(of)h(p)s
(ositional)e(parameters)i(is)f(up)s(dated)g(to)150 2545
y(re\015ect)28 b(the)g(c)m(hange.)41 b(P)m(ositional)27
b(parameter)h Fs(0)f Ft(is)f(unc)m(hanged.)40 b(The)27
b(\014rst)g(elemen)m(t)h(of)f(the)h Fs(FUNCNAME)150 2655
y Ft(v)-5 b(ariable)25 b(is)h(set)h(to)h(the)f(name)f(of)h(the)g
(function)e(while)g(the)i(function)e(is)h(executing.)39
b(All)26 b(other)h(asp)s(ects)150 2765 y(of)32 b(the)g(shell)e
(execution)j(en)m(vironmen)m(t)e(are)i(iden)m(tical)d(b)s(et)m(w)m(een)
j(a)f(function)f(and)g(its)h(caller)f(with)g(the)150
2874 y(exception)25 b(that)h(the)f Fs(DEBUG)f Ft(trap)h(b)s(elo)m(w\))g
(is)f(not)i(inherited)c(unless)i(the)h(function)f(has)h(b)s(een)g(giv)m
(en)g(the)150 2984 y Fs(trace)36 b Ft(attribute)g(using)g(the)h
Fs(declare)e Ft(builtin)e(or)k(the)g Fs(-o)30 b(functrace)35
b Ft(option)h(has)h(b)s(een)f(enabled)150 3093 y(with)c(the)h
Fs(set)g Ft(builtin,)e(\(in)h(whic)m(h)g(case)i(all)e(functions)g
(inherit)f(the)j Fs(DEBUG)e Ft(trap\).)49 b(See)34 b(Section)f(4.1)150
y(re\015ect)h(the)f(c)m(hange.)56 b(Sp)s(ecial)33 b(parameter)j
Fs(0)f Ft(is)f(unc)m(hanged.)54 b(The)35 b(\014rst)f(elemen)m(t)i(of)f
(the)g Fs(FUNCNAME)150 2655 y Ft(v)-5 b(ariable)25 b(is)h(set)h(to)h
(the)f(name)f(of)h(the)g(function)e(while)g(the)i(function)e(is)h
(executing.)39 b(All)26 b(other)h(asp)s(ects)150 2765
y(of)32 b(the)g(shell)e(execution)j(en)m(vironmen)m(t)e(are)i(iden)m
(tical)d(b)s(et)m(w)m(een)j(a)f(function)f(and)g(its)h(caller)f(with)g
(the)150 2874 y(exception)25 b(that)h(the)f Fs(DEBUG)f
Ft(trap)h(b)s(elo)m(w\))g(is)f(not)i(inherited)c(unless)i(the)h
(function)f(has)h(b)s(een)g(giv)m(en)g(the)150 2984 y
Fs(trace)36 b Ft(attribute)g(using)g(the)h Fs(declare)e
Ft(builtin)e(or)k(the)g Fs(-o)30 b(functrace)35 b Ft(option)h(has)h(b)s
(een)f(enabled)150 3093 y(with)c(the)h Fs(set)g Ft(builtin,)e(\(in)h
(whic)m(h)g(case)i(all)e(functions)g(inherit)f(the)j
Fs(DEBUG)e Ft(trap\).)49 b(See)34 b(Section)f(4.1)150
3203 y([Bourne)d(Shell)f(Builtins],)f(page)j(33,)g(for)g(the)f
(description)f(of)h(the)h Fs(trap)e Ft(builtin.)275 3354
y(If)37 b(the)g(builtin)d(command)k Fs(return)d Ft(is)i(executed)h(in)f
@@ -7874,24 +7874,26 @@ Ft(and)h Fs(unalias)e Ft(builtin)f(commands.)p eop
72 77 bop 150 -116 a Ft(72)2572 b(Bash)31 b(Reference)g(Man)m(ual)275
299 y(The)e(\014rst)f(w)m(ord)i(of)f(eac)m(h)i(simple)d(command,)i(if)e
(unquoted,)h(is)g(c)m(hec)m(k)m(ed)i(to)g(see)f(if)f(it)g(has)g(an)g
(alias.)150 408 y(If)34 b(so,)i(that)f(w)m(ord)f(is)f(replaced)h(b)m(y)
g(the)h(text)g(of)g(the)f(alias.)52 b(The)34 b(alias)g(name)g(and)g
(the)g(replacemen)m(t)150 518 y(text)g(ma)m(y)f(con)m(tain)g(an)m(y)g
(v)-5 b(alid)31 b(shell)g(input,)h(including)d(shell)i(metac)m
(haracters,)36 b(with)c(the)h(exception)150 628 y(that)i(the)f(alias)f
(name)h(ma)m(y)h(not)g(con)m(tain)f(`)p Fs(=)p Ft('.)52
b(The)34 b(\014rst)f(w)m(ord)h(of)g(the)g(replacemen)m(t)h(text)g(is)e
(tested)150 737 y(for)26 b(aliases,)h(but)f(a)h(w)m(ord)f(that)h(is)f
(iden)m(tical)f(to)i(an)g(alias)e(b)s(eing)g(expanded)h(is)g(not)g
(expanded)g(a)h(second)150 847 y(time.)40 b(This)27 b(means)i(that)g
(one)g(ma)m(y)h(alias)e Fs(ls)g Ft(to)i Fs("ls)f(-F")p
Ft(,)g(for)f(instance,)i(and)e(Bash)h(do)s(es)f(not)h(try)g(to)150
956 y(recursiv)m(ely)j(expand)g(the)h(replacemen)m(t)g(text.)50
b(If)32 b(the)h(last)g(c)m(haracter)h(of)g(the)f(alias)f(v)-5
b(alue)32 b(is)g(a)h(space)150 1066 y(or)f(tab)g(c)m(haracter,)j(then)d
(the)g(next)g(command)g(w)m(ord)g(follo)m(wing)e(the)i(alias)g(is)f
(also)h(c)m(hec)m(k)m(ed)i(for)e(alias)150 1176 y(expansion.)275
1325 y(Aliases)27 b(are)h(created)i(and)d(listed)g(with)g(the)h
(alias.)150 408 y(If)24 b(so,)i(that)g(w)m(ord)e(is)g(replaced)g(b)m(y)
g(the)h(text)h(of)e(the)h(alias.)38 b(The)24 b(c)m(haracters)i(`)p
Fs(/)p Ft(',)h(`)p Fs($)p Ft(',)f(`)p Fs(`)p Ft(',)g(`)p
Fs(=)p Ft(')f(and)f(an)m(y)h(of)150 518 y(the)e(shell)e(metac)m
(haracters)k(or)e(quoting)f(c)m(haracters)i(listed)e(ab)s(o)m(v)m(e)i
(ma)m(y)f(not)g(app)s(ear)f(in)g(an)h(alias)f(name.)150
628 y(The)g(replacemen)m(t)g(text)h(ma)m(y)g(con)m(tain)g(an)m(y)f(v)-5
b(alid)21 b(shell)f(input,)i(including)d(shell)h(metac)m(haracters.)40
b(The)150 737 y(\014rst)35 b(w)m(ord)g(of)h(the)g(replacemen)m(t)h
(text)f(is)f(tested)i(for)e(aliases,)i(but)e(a)h(w)m(ord)g(that)g(is)f
(iden)m(tical)g(to)h(an)150 847 y(alias)30 b(b)s(eing)g(expanded)g(is)g
(not)h(expanded)f(a)h(second)g(time.)42 b(This)29 b(means)i(that)g(one)
g(ma)m(y)h(alias)e Fs(ls)g Ft(to)150 956 y Fs("ls)f(-F")p
Ft(,)36 b(for)f(instance,)h(and)e(Bash)h(do)s(es)g(not)g(try)g(to)g
(recursiv)m(ely)f(expand)g(the)h(replacemen)m(t)h(text.)150
1066 y(If)31 b(the)h(last)g(c)m(haracter)h(of)f(the)g(alias)f(v)-5
b(alue)31 b(is)g(a)h(space)g(or)g(tab)g(c)m(haracter,)i(then)d(the)h
(next)g(command)150 1176 y(w)m(ord)e(follo)m(wing)f(the)h(alias)g(is)f
(also)i(c)m(hec)m(k)m(ed)h(for)e(alias)g(expansion.)275
1325 y(Aliases)d(are)h(created)i(and)d(listed)g(with)g(the)h
Fs(alias)f Ft(command,)h(and)g(remo)m(v)m(ed)h(with)e(the)h
Fs(unalias)150 1434 y Ft(command.)275 1583 y(There)44
b(is)g(no)h(mec)m(hanism)f(for)g(using)g(argumen)m(ts)h(in)e(the)i
@@ -8512,28 +8514,28 @@ Fs(set)f Ft(builtin)e(is)i(enabled,)h(Bash)g(rep)s(orts)f(suc)m(h)h(c)m
(hanges)150 1228 y(immediately)j(\(see)i(Section)f(4.3)h([The)f(Set)h
(Builtin],)d(page)j(50\).)42 b(An)m(y)29 b(trap)g(on)g
Fs(SIGCHLD)f Ft(is)g(executed)150 1338 y(for)i(eac)m(h)i(c)m(hild)c
(pro)s(cess)i(that)h(exits.)275 1474 y(If)e(an)g(attempt)i(to)g(exit)e
(Bash)h(is)f(while)f(jobs)h(are)h(stopp)s(ed,)f(the)h(shell)e(prin)m
(ts)g(a)i(message)h(w)m(arning)150 1583 y(that)f(there)g(are)g(stopp)s
(ed)f(jobs.)40 b(The)30 b Fs(jobs)e Ft(command)i(ma)m(y)g(then)f(b)s(e)
h(used)f(to)h(insp)s(ect)f(their)f(status.)150 1693 y(If)i(a)h(second)g
(attempt)g(to)h(exit)e(is)g(made)g(without)g(an)g(in)m(terv)m(ening)g
(command,)h(Bash)f(do)s(es)h(not)f(prin)m(t)150 1802
y(another)h(w)m(arning,)e(and)h(the)g(stopp)s(ed)g(jobs)g(are)g
(terminated.)150 2063 y Fr(7.2)68 b(Job)45 b(Con)l(trol)h(Builtins)150
2308 y Fs(bg)870 2443 y(bg)h([)p Fj(jobspec)11 b Fs(])630
2578 y Ft(Resume)28 b(the)g(susp)s(ended)d(job)j Fq(jobsp)s(ec)k
Ft(in)27 b(the)h(bac)m(kground,)h(as)f(if)f(it)g(had)g(b)s(een)g
(started)630 2688 y(with)k(`)p Fs(&)p Ft('.)45 b(If)31
b Fq(jobsp)s(ec)37 b Ft(is)31 b(not)h(supplied,)d(the)j(curren)m(t)g
(job)f(is)g(used.)45 b(The)31 b(return)g(status)630 2797
y(is)h(zero)h(unless)e(it)h(is)g(run)f(when)h(job)g(con)m(trol)h(is)f
(not)h(enabled,)g(or,)g(when)f(run)f(with)g(job)630 2907
y(con)m(trol)37 b(enabled,)h(if)e Fq(jobsp)s(ec)42 b
Ft(w)m(as)37 b(not)h(found)d(or)i Fq(jobsp)s(ec)42 b
Ft(sp)s(eci\014es)36 b(a)h(job)g(that)h(w)m(as)630 3017
y(started)31 b(without)e(job)h(con)m(trol.)150 3177 y
Fs(fg)870 3312 y(fg)47 b([)p Fj(jobspec)11 b Fs(])630
(pro)s(cess)i(that)h(exits.)275 1474 y(If)k(an)h(attempt)h(to)g(exit)f
(Bash)h(is)e(made)h(while)e(jobs)i(are)g(stopp)s(ed,)h(the)f(shell)f
(prin)m(ts)f(a)j(message)150 1583 y(w)m(arning)25 b(that)i(there)f(are)
g(stopp)s(ed)g(jobs.)38 b(The)26 b Fs(jobs)f Ft(command)h(ma)m(y)h
(then)e(b)s(e)h(used)f(to)i(insp)s(ect)e(their)150 1693
y(status.)57 b(If)35 b(a)h(second)g(attempt)g(to)h(exit)e(is)g(made)h
(without)e(an)i(in)m(terv)m(ening)f(command,)h(Bash)g(do)s(es)150
1802 y(not)31 b(prin)m(t)e(another)h(w)m(arning,)g(and)f(the)i(stopp)s
(ed)e(jobs)h(are)h(terminated.)150 2063 y Fr(7.2)68 b(Job)45
b(Con)l(trol)h(Builtins)150 2308 y Fs(bg)870 2443 y(bg)h([)p
Fj(jobspec)11 b Fs(])630 2578 y Ft(Resume)28 b(the)g(susp)s(ended)d
(job)j Fq(jobsp)s(ec)k Ft(in)27 b(the)h(bac)m(kground,)h(as)f(if)f(it)g
(had)g(b)s(een)g(started)630 2688 y(with)k(`)p Fs(&)p
Ft('.)45 b(If)31 b Fq(jobsp)s(ec)37 b Ft(is)31 b(not)h(supplied,)d(the)
j(curren)m(t)g(job)f(is)g(used.)45 b(The)31 b(return)g(status)630
2797 y(is)h(zero)h(unless)e(it)h(is)g(run)f(when)h(job)g(con)m(trol)h
(is)f(not)h(enabled,)g(or,)g(when)f(run)f(with)g(job)630
2907 y(con)m(trol)37 b(enabled,)h(if)e Fq(jobsp)s(ec)42
b Ft(w)m(as)37 b(not)h(found)d(or)i Fq(jobsp)s(ec)42
b Ft(sp)s(eci\014es)36 b(a)h(job)g(that)h(w)m(as)630
3017 y(started)31 b(without)e(job)h(con)m(trol.)150 3177
y Fs(fg)870 3312 y(fg)47 b([)p Fj(jobspec)11 b Fs(])630
3448 y Ft(Resume)43 b(the)g(job)g Fq(jobsp)s(ec)48 b
Ft(in)42 b(the)h(foreground)g(and)f(mak)m(e)j(it)d(the)i(curren)m(t)f
(job.)78 b(If)630 3557 y Fq(jobsp)s(ec)41 b Ft(is)36
doc/bashref.texi
+15 -9
View File
@@ -1113,7 +1113,7 @@ function become the positional parameters
during its execution (@pxref{Positional Parameters}).
The special parameter @samp{#} that expands to the number of
positional parameters is updated to reflect the change.
Positional parameter @code{0} is unchanged.
Special parameter @code{0} is unchanged.
The first element of the @env{FUNCNAME} variable is set to the
name of the function while the function is executing.
All other aspects of the shell execution
@@ -1545,9 +1545,9 @@ If @var{parameter} is unset or null, the expansion of
If @var{parameter}
is unset or null, the expansion of @var{word}
is assigned to @var{parameter}.
The value of @var{parameter}
is then substituted. Positional parameters and special parameters may
not be assigned to in this way.
The value of @var{parameter} is then substituted.
Positional parameters and special parameters may not be assigned to
in this way.
@item $@{@var{parameter}:?@var{word}@}
If @var{parameter}
@@ -2600,6 +2600,10 @@ facilities (@pxref{Programmable Completion Builtins}).
Many of the builtins have been extended by @sc{posix} or Bash.
Unless otherwise noted, each builtin command documented as accepting
options preceded by @samp{-} accepts @samp{--}
to signify the end of the options.
@node Bourne Shell Builtins
@section Bourne Shell Builtins
@@ -5424,13 +5428,15 @@ the @code{alias} and @code{unalias} builtin commands.
The first word of each simple command, if unquoted, is checked to see
if it has an alias.
If so, that word is replaced by the text of the alias.
The alias name and the replacement text may contain any valid
shell input, including shell metacharacters, with the exception
that the alias name may not contain @samp{=}.
The characters @samp{/}, @samp{$}, @samp{`}, @samp{=} and any of the
shell metacharacters or quoting characters listed above may not appear
in an alias name.
The replacement text may contain any valid
shell input, including shell metacharacters.
The first word of the replacement text is tested for
aliases, but a word that is identical to an alias being expanded
is not expanded a second time. This means that one may alias
@code{ls} to @code{"ls -F"},
is not expanded a second time.
This means that one may alias @code{ls} to @code{"ls -F"},
for instance, and Bash does not try to recursively expand the
replacement text. If the last character of the alias value is a
space or tab character, then the next command word following the
doc/bashref.texi~
+13 -11
View File
@@ -1113,7 +1113,7 @@ function become the positional parameters
during its execution (@pxref{Positional Parameters}).
The special parameter @samp{#} that expands to the number of
positional parameters is updated to reflect the change.
Positional parameter @code{0} is unchanged.
Special parameter @code{0} is unchanged.
The first element of the @env{FUNCNAME} variable is set to the
name of the function while the function is executing.
All other aspects of the shell execution
@@ -1545,9 +1545,9 @@ If @var{parameter} is unset or null, the expansion of
If @var{parameter}
is unset or null, the expansion of @var{word}
is assigned to @var{parameter}.
The value of @var{parameter}
is then substituted. Positional parameters and special parameters may
not be assigned to in this way.
The value of @var{parameter} is then substituted.
Positional parameters and special parameters may not be assigned to
in this way.
@item $@{@var{parameter}:?@var{word}@}
If @var{parameter}
@@ -5424,13 +5424,15 @@ the @code{alias} and @code{unalias} builtin commands.
The first word of each simple command, if unquoted, is checked to see
if it has an alias.
If so, that word is replaced by the text of the alias.
The alias name and the replacement text may contain any valid
shell input, including shell metacharacters, with the exception
that the alias name may not contain @samp{=}.
The characters @samp{/}, @samp{$}, @samp{`}, @samp{=} and any of the
shell metacharacters or quoting characters listed above may not appear
in an alias name.
The replacement text may contain any valid
shell input, including shell metacharacters.
The first word of the replacement text is tested for
aliases, but a word that is identical to an alias being expanded
is not expanded a second time. This means that one may alias
@code{ls} to @code{"ls -F"},
is not expanded a second time.
This means that one may alias @code{ls} to @code{"ls -F"},
for instance, and Bash does not try to recursively expand the
replacement text. If the last character of the alias value is a
space or tab character, then the next command word following the
@@ -5718,7 +5720,7 @@ The release of Bash, version + patchlevel (e.g., 2.00.0)
@item \w
The current working directory, with @env{$HOME} abbreviated with a tilde.
@item \W
The basename of @env{$PWD}.
The basename of @env{$PWD}, with @env{$HOME} abbreviated with a tilde.
@item \!
The history number of this command.
@item \#
@@ -6106,7 +6108,7 @@ Bash reports such changes immediately (@pxref{The Set Builtin}).
Any trap on @code{SIGCHLD} is executed for each child process
that exits.
If an attempt to exit Bash is while jobs are stopped, the
If an attempt to exit Bash is made while jobs are stopped, the
shell prints a message warning that there are stopped jobs.
The @code{jobs} command may then be used to inspect their status.
If a second attempt to exit is made without an intervening command,
doc/builtins.0
+20 -20
View File
@@ -474,12 +474,12 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
to _l_a_s_t is selected from the history list. _F_i_r_s_t and _l_a_s_t may
be specified as a string (to locate the last command beginning
with that string) or as a number (an index into the history
list, where a negative number is used as an offset from the
current command number). If _l_a_s_t is not specified it is set to
the current command for listing (so that ``fc -l -10'' prints
the last 10 commands) and to _f_i_r_s_t otherwise. If _f_i_r_s_t is not
specified it is set to the previous command for editing and -16
for listing.
list, where a negative number is used as an offset from the cur-
rent command number). If _l_a_s_t is not specified it is set to the
current command for listing (so that ``fc -l -10'' prints the
last 10 commands) and to _f_i_r_s_t otherwise. If _f_i_r_s_t is not spec-
ified it is set to the previous command for editing and -16 for
listing.
The --nn option suppresses the command numbers when listing. The
--rr option reverses the order of the commands. If the --ll option
@@ -766,14 +766,14 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
One line is read from the standard input, or from the file
descriptor _f_d supplied as an argument to the --uu option, and the
first word is assigned to the first _n_a_m_e, the second word to the
second _n_a_m_e, and so on, with leftover words and their
intervening separators assigned to the last _n_a_m_e. If there are
fewer words read from the input stream than names, the remaining
names are assigned empty values. The characters in IIFFSS are used
to split the line into words. The backslash character (\\) may
be used to remove any special meaning for the next character
read and for line continuation. Options, if supplied, have the
following meanings:
second _n_a_m_e, and so on, with leftover words and their interven-
ing separators assigned to the last _n_a_m_e. If there are fewer
words read from the input stream than names, the remaining names
are assigned empty values. The characters in IIFFSS are used to
split the line into words. The backslash character (\\) may be
used to remove any special meaning for the next character read
and for line continuation. Options, if supplied, have the fol-
lowing meanings:
--aa _a_n_a_m_e
The words are assigned to sequential indices of the array
variable _a_n_a_m_e, starting at 0. _a_n_a_m_e is unset before any
@@ -985,8 +985,8 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
rather than - causes these options to be turned off. The
options can also be specified as arguments to an invocation of
the shell. The current set of options may be found in $$--. The
return status is always true unless an invalid option is
encountered.
return status is always true unless an invalid option is encoun-
tered.
sshhiifftt [_n]
The positional parameters from _n+1 ... are renamed to $$11 ........
@@ -1044,8 +1044,8 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
formed.
cchheecckkwwiinnssiizzee
If set, bbaasshh checks the window size after each command
and, if necessary, updates the values of LLIINNEESS and
CCOOLLUUMMNNSS.
and, if necessary, updates the values of LLIINNEESS and CCOOLL--
UUMMNNSS.
ccmmddhhiisstt If set, bbaasshh attempts to save all lines of a multiple-
line command in the same history entry. This allows
easy re-editing of multi-line commands.
@@ -1058,8 +1058,8 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
exit if eexxeecc fails.
eexxppaanndd__aalliiaasseess
If set, aliases are expanded as described above under
AALLIIAASSEESS. This option is enabled by default for
interactive shells.
AALLIIAASSEESS. This option is enabled by default for interac-
tive shells.
eexxttddeebbuugg
If set, behavior intended for use by debuggers is
enabled:
doc/builtins.ps
+18 -4
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.18.1
%%CreationDate: Thu Jan 29 16:59:29 2004
%%Creator: groff version 1.19
%%CreationDate: Tue Apr 20 15:26:45 2004
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
@@ -9,13 +9,17 @@
%%+ font Palatino-Roman
%%+ font Palatino-Italic
%%+ font Palatino-Bold
%%DocumentSuppliedResources: procset grops 1.18 1
%%DocumentSuppliedResources: procset grops 1.19 0
%%Pages: 19
%%PageOrder: Ascend
%%DocumentMedia: Default 612 792 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.18 1
%%BeginResource: procset grops 1.19 0
/setpacking where{
pop
currentpacking
@@ -116,16 +120,22 @@ TM setmatrix
/Fr{
setrgbcolor fill
}bind def
/setcmykcolor where{
pop
/Fk{
setcmykcolor fill
}bind def
}if
/Fg{
setgray fill
}bind def
/FL/fill load def
/LW/setlinewidth load def
/Cr/setrgbcolor load def
/setcmykcolor where{
pop
/Ck/setcmykcolor load def
}if
/Cg/setgray load def
/RE{
findfont
@@ -168,6 +178,7 @@ newpath
/CNT countdictstack def
userdict begin
/showpage{}def
/setpagedevice{}def
}bind def
/PEND{
clear
@@ -180,6 +191,9 @@ pop
setpacking
}if
%%EndResource
%%BeginFeature: *PageSize Default
<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
%%IncludeResource: font Times-Italic
doc/rbash.0
+2 -2
View File
@@ -30,8 +30,8 @@ RREESSTTRRIICCTTEEDD SSHHEELLLL
+o parsing the value of SSHHEELLLLOOPPTTSS from the shell environment at
startup
+o redirecting output using the >, >|, <>, >&, &>, and >> redirec-
tion operators
+o redirecting output using the >, >|, <>, >&, &>, and >> redirect-
ion operators
+o using the eexxeecc builtin command to replace the shell with another
command
doc/rbash.ps
+18 -4
View File
@@ -1,15 +1,19 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.18.1
%%CreationDate: Thu Jan 29 16:59:29 2004
%%Creator: groff version 1.19
%%CreationDate: Tue Apr 20 15:26:45 2004
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.18 1
%%DocumentSuppliedResources: procset grops 1.19 0
%%Pages: 1
%%PageOrder: Ascend
%%DocumentMedia: Default 612 792 0 () ()
%%Orientation: Portrait
%%EndComments
%%BeginDefaults
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.18 1
%%BeginResource: procset grops 1.19 0
/setpacking where{
pop
currentpacking
@@ -110,16 +114,22 @@ TM setmatrix
/Fr{
setrgbcolor fill
}bind def
/setcmykcolor where{
pop
/Fk{
setcmykcolor fill
}bind def
}if
/Fg{
setgray fill
}bind def
/FL/fill load def
/LW/setlinewidth load def
/Cr/setrgbcolor load def
/setcmykcolor where{
pop
/Ck/setcmykcolor load def
}if
/Cg/setgray load def
/RE{
findfont
@@ -162,6 +172,7 @@ newpath
/CNT countdictstack def
userdict begin
/showpage{}def
/setpagedevice{}def
}bind def
/PEND{
clear
@@ -174,6 +185,9 @@ pop
setpacking
}if
%%EndResource
%%BeginFeature: *PageSize Default
<< /PageSize [ 612 792 ] /ImagingBBox null >> setpagedevice
%%EndFeature
%%IncludeResource: font Times-Roman
%%IncludeResource: font Times-Bold
grops begin/DEFS 1 dict def DEFS begin/u{.001 mul}bind def end/RES 72
doc/version.texi
+3 -3
View File
@@ -4,7 +4,7 @@ Copyright (C) 1988-2004 Free Software Foundation, Inc.
@set EDITION 3.0
@set VERSION 3.0-beta1
@set UPDATED 28 January 2004
@set UPDATED-MONTH January 2004
@set UPDATED 20 April 2004
@set UPDATED-MONTH April 2004
@set LASTCHANGE Wed Jan 28 15:50:08 EST 2004
@set LASTCHANGE Tue Apr 20 13:54:25 EDT 2004