commit bash-20051123 snapshot
[platform/upstream/bash.git] / bashref.texi.diff
1 *** ../bash-3.0/doc/bashref.texi        Sat Jun 26 14:26:07 2004
2 --- doc/bashref.texi    Fri Aug 27 12:33:46 2004
3 ***************
4 *** 1257,1260 ****
5 --- 1257,1264 ----
6   separate word.  That is, @code{"$@@"} is equivalent to
7   @code{"$1" "$2" @dots{}}.
8 + If the double-quoted expansion occurs within a word, the expansion of
9 + the first parameter is joined with the beginning part of the original
10 + word, and the expansion of the last parameter is joined with the last
11 + part of the original word.
12   When there are no positional parameters, @code{"$@@"} and
13   @code{$@@}
14 ***************
15 *** 5202,5205 ****
16 --- 5206,5212 ----
17   descriptor 0, 1, or 2, respectively, is checked.
18   
19 + Unless otherwise specified, primaries that operate on files follow symbolic
20 + links and operate on the target of the link, rather than the link itself.
21
22   @table @code
23   @item -a @var{file}
24 ***************
25 *** 5535,5544 ****
26   @var{subscript} is @samp{@@} or @samp{*}, the word expands to all members
27   of the array @var{name}.  These subscripts differ only when the word
28 ! appears within double quotes.  If the word is double-quoted,
29   @code{$@{name[*]@}} expands to a single word with
30   the value of each array member separated by the first character of the
31   @env{IFS} variable, and @code{$@{name[@@]@}} expands each element of
32   @var{name} to a separate word.  When there are no array members,
33 ! @code{$@{name[@@]@}} expands to nothing.  This is analogous to the
34   expansion of the special parameters @samp{@@} and @samp{*}. 
35   @code{$@{#name[}@var{subscript}@code{]@}} expands to the length of
36 --- 5542,5557 ----
37   @var{subscript} is @samp{@@} or @samp{*}, the word expands to all members
38   of the array @var{name}.  These subscripts differ only when the word
39 ! appears within double quotes.
40 ! If the word is double-quoted,
41   @code{$@{name[*]@}} expands to a single word with
42   the value of each array member separated by the first character of the
43   @env{IFS} variable, and @code{$@{name[@@]@}} expands each element of
44   @var{name} to a separate word.  When there are no array members,
45 ! @code{$@{name[@@]@}} expands to nothing.
46 ! If the double-quoted expansion occurs within a word, the expansion of
47 ! the first parameter is joined with the beginning part of the original
48 ! word, and the expansion of the last parameter is joined with the last
49 ! part of the original word.
50 ! This is analogous to the
51   expansion of the special parameters @samp{@@} and @samp{*}. 
52   @code{$@{#name[}@var{subscript}@code{]@}} expands to the length of
53 ***************
54 *** 5954,5958 ****
55   The @code{trap} builtin doesn't check the first argument for a possible
56   signal specification and revert the signal handling to the original
57 ! disposition if it is.  If users want to reset the handler for a given
58   signal to the original disposition, they should use @samp{-} as the
59   first argument.
60 --- 5967,5972 ----
61   The @code{trap} builtin doesn't check the first argument for a possible
62   signal specification and revert the signal handling to the original
63 ! disposition if it is, unless that argument consists solely of digits and
64 ! is a valid signal number.  If users want to reset the handler for a given
65   signal to the original disposition, they should use @samp{-} as the
66   first argument.
67 ***************
68 *** 5989,5992 ****
69 --- 6003,6024 ----
70   does not refer to an existing directory, @code{cd} will fail instead of
71   falling back to @var{physical} mode.
72
73 + @item
74 + When listing the history, the @code{fc} builtin does not include an
75 + indication of whether or not a history entry has been modified.
76
77 + @item
78 + The default editor used by @code{fc} is @code{ed}.
79
80 + @item
81 + The @code{type} and @code{command} builtins will not report a non-executable
82 + file as having been found, though the shell will attempt to execute such a
83 + file if it is the only so-named file found in @code{$PATH}.
84
85 + @item
86 + When the @code{xpg_echo} option is enabled, Bash does not attempt to interpret
87 + any arguments to @code{echo} as options.  Each argument is displayed, after
88 + escape characters are converted.
89
90   @end enumerate
91   
92 ***************
93 *** 6132,6144 ****
94   @btindex bg
95   @example
96 ! bg [@var{jobspec}]
97   @end example
98 ! Resume the suspended job @var{jobspec} in the background, as if it
99   had been started with @samp{&}.
100   If @var{jobspec} is not supplied, the current job is used.
101   The return status is zero unless it is run when job control is not
102 ! enabled, or, when run with job control enabled, if @var{jobspec} was
103 ! not found or @var{jobspec} specifies a job that was started without
104 ! job control.
105   
106   @item fg
107 --- 6164,6176 ----
108   @btindex bg
109   @example
110 ! bg [@var{jobspec} @dots{}]
111   @end example
112 ! Resume each suspended job @var{jobspec} in the background, as if it
113   had been started with @samp{&}.
114   If @var{jobspec} is not supplied, the current job is used.
115   The return status is zero unless it is run when job control is not
116 ! enabled, or, when run with job control enabled, if the last
117 ! @var{jobspec} was not found or the last @var{jobspec} specifies a job
118 ! that was started without job control.
119   
120   @item fg