diff -ur bash-3.2.orig/doc/bashref.texi bash-3.2.new/doc/bashref.texi --- bash-3.2.orig/doc/bashref.texi 2006-09-28 16:25:28.000000000 +0200 +++ bash-3.2.new/doc/bashref.texi 2006-12-03 14:08:17.000000000 +0100 @@ -562,7 +562,7 @@ In a non-interactive shell, or an interactive shell in which the @code{interactive_comments} option to the @code{shopt} -builtin is enabled (@pxref{Bash Builtins}), +builtin is enabled (@pxref{Bash Builtin shopt}), a word beginning with @samp{#} causes that word and all remaining characters on that line to be ignored. An interactive shell without the @code{interactive_comments} @@ -848,7 +848,7 @@ @code{case} will selectively execute the @var{command-list} corresponding to the first @var{pattern} that matches @var{word}. If the shell option @code{nocasematch} -(see the description of @code{shopt} in @ref{Bash Builtins}) +(@pxref{Bash Builtin shopt}) is enabled, the match is performed without regard to the case of alphabetic characters. The @samp{|} is used to separate multiple patterns, and the @samp{)} @@ -960,7 +960,7 @@ right of the operator is considered a pattern and matched according to the rules described below in @ref{Pattern Matching}. If the shell option @code{nocasematch} -(see the description of @code{shopt} in @ref{Bash Builtins}) +(@pxref{Bash Builtin shopt}) is enabled, the match is performed without regard to the case of alphabetic characters. The return value is 0 if the string matches (@samp{==}) or does not @@ -977,7 +977,7 @@ If the regular expression is syntactically incorrect, the conditional expression's return value is 2. If the shell option @code{nocasematch} -(see the description of @code{shopt} in @ref{Bash Builtins}) +(@pxref{Bash Builtin shopt}) is enabled, the match is performed without regard to the case of alphabetic characters. Substrings matched by parenthesized subexpressions within the regular @@ -1840,7 +1840,7 @@ matched explicitly. In other cases, the @samp{.} character is not treated specially. -See the description of @code{shopt} in @ref{Bash Builtins}, +@xref{Bash Builtin shopt}, for a description of the @code{nocaseglob}, @code{nullglob}, @code{failglob}, and @code{dotglob} options. @@ -2508,7 +2508,7 @@ to not receive @code{SIGHUP} using @code{disown -h}. If the @code{huponexit} shell option has been set with @code{shopt} -(@pxref{Bash Builtins}), Bash sends a @code{SIGHUP} to all jobs when +(@pxref{Bash Builtin shopt}), Bash sends a @code{SIGHUP} to all jobs when an interactive login shell exits. If Bash is waiting for a command to complete and receives a signal @@ -3014,7 +3014,7 @@ @code{select} command, every arithmetic @code{for} command, and before the first command executes in a shell function. Refer to the description of the @code{extglob} option to the -@code{shopt} builtin (@pxref{Bash Builtins}) for details of its +@code{shopt} builtin (@pxref{Bash Builtin shopt}) for details of its effect on the @code{DEBUG} trap. If a @var{sigspec} is @code{ERR}, the command @var{arg} is executed whenever a simple command has a non-zero exit status, @@ -3250,7 +3251,7 @@ The @option{-F} option inhibits the display of function definitions; only the function name and attributes are printed. If the @code{extdebug} shell option is enabled using @code{shopt} -(@pxref{Bash Builtins}), the source file name and line number where +(@pxref{Bash Builtin shopt}), the source file name and line number where the function is defined are displayed as well. @option{-F} implies @option{-f}. The following options can be used to restrict output to variables with @@ -3521,6 +3522,7 @@ @end table +@anchor{Bash Builtin shopt} @item shopt @btindex shopt @example @@ -4310,7 +4312,7 @@ subroutine is executed, the number of parameters passed is pushed onto @code{BASH_ARGC}. The shell sets @code{BASH_ARGC} only when in extended debugging mode -(see @ref{Bash Builtins} +(see @ref{Bash Builtin shopt} for a description of the @code{extdebug} option to the @code{shopt} builtin). @@ -4321,7 +4323,7 @@ at the bottom. When a subroutine is executed, the parameters supplied are pushed onto @code{BASH_ARGV}. The shell sets @code{BASH_ARGV} only when in extended debugging mode -(see @ref{Bash Builtins} +(see @ref{Bash Builtin shopt} for a description of the @code{extdebug} option to the @code{shopt} builtin). @@ -4850,7 +4852,7 @@ @table @code @item --debugger Arrange for the debugger profile to be executed before the shell -starts. Turns on extended debugging mode (see @ref{Bash Builtins} +starts. Turns on extended debugging mode (see @ref{Bash Builtin shopt} for a description of the @code{extdebug} option to the @code{shopt} builtin) and shell function tracing (see @ref{The Set Builtin} for a description of the @code{-o functrace} @@ -4953,7 +4955,7 @@ @item [-+]O [@var{shopt_option}] @var{shopt_option} is one of the shell options accepted by the -@code{shopt} builtin (@pxref{Shell Builtin Commands}). +@code{shopt} builtin (@pxref{Bash Builtin shopt}). If @var{shopt_option} is present, @option{-O} sets the value of that option; @option{+O} unsets it. If @var{shopt_option} is not supplied, the names and values of the shell @@ -5252,7 +5254,7 @@ @item Simple spelling correction for directory arguments to the @code{cd} builtin is enabled by default (see the description of the @code{cdspell} -option to the @code{shopt} builtin in @ref{Bash Builtins}). +option to the @code{shopt} builtin in @ref{Bash Builtin shopt}). @item The shell will check the value of the @env{TMOUT} variable and exit @@ -5536,7 +5538,7 @@ Aliases are not expanded when the shell is not interactive, unless the @code{expand_aliases} shell option is set using -@code{shopt} (@pxref{Bash Builtins}). +@code{shopt} (@pxref{Bash Builtin shopt}). The rules concerning the definition and use of aliases are somewhat confusing. Bash @@ -7225,7 +7227,7 @@ @item Bash includes the @code{shopt} builtin, for finer control of shell -optional capabilities (@pxref{Bash Builtins}), and allows these options +optional capabilities (@pxref{Bash Builtin shopt}), and allows these options to be set and unset at shell invocation (@pxref{Invoking Bash}). @item