diff options
Diffstat (limited to 'doc/bashref.texi~')
| -rw-r--r-- | doc/bashref.texi~ | 23 |
1 files changed, 14 insertions, 9 deletions
diff --git a/doc/bashref.texi~ b/doc/bashref.texi~ index ad164058..e43ff326 100644 --- a/doc/bashref.texi~ +++ b/doc/bashref.texi~ @@ -3449,7 +3449,7 @@ parent. @item printf @btindex printf @example -@code{printf} @var{format} [@var{arguments}] +@code{printf} [-v @var{var}] @var{format} [@var{arguments}] @end example Write the formatted @var{arguments} to the standard output under the control of the @var{format}. @@ -3467,6 +3467,9 @@ beginning with @samp{\0} may contain up to four digits), and @samp{%q} causes @code{printf} to output the corresponding @var{argument} in a format that can be reused as shell input. +The @option{-v} option causes the output to be assigned to the variable +@var{var} rather than being printed to the standard output. + The @var{format} is reused as necessary to consume all of the @var{arguments}. If the @var{format} requires more @var{arguments} than are supplied, the extra format specifications behave as if a zero value or null string, as @@ -3746,6 +3749,11 @@ on an empty line. If set, Bash matches filenames in a case-insensitive fashion when performing filename expansion. +@item nocasematch +If set, Bash matches patterns in a case-insensitive fashion when +performing matching while executing @code{case} or @code{[[} +conditional commands. + @item nullglob If set, Bash allows filename patterns which match no files to expand to a null string, rather than themselves. @@ -5627,6 +5635,8 @@ referencing element zero. The @code{unset} builtin is used to destroy arrays. @code{unset} @var{name}[@var{subscript}] destroys the array element at index @var{subscript}. +Care must be taken to avoid unwanted side effects caused by filename +generation. @code{unset} @var{name}, where @var{name} is an array, removes the entire array. A subscript of @samp{*} or @samp{@@} also removes the entire array. @@ -5919,7 +5929,8 @@ is stopped is `Stopped(@var{signame})', where @var{signame} is, for example, @code{SIGTSTP}. @item -Reserved words may not be aliased. +Reserved words appearing in a context where reserved words are recognized +do not undergo alias expansion. @item The @sc{posix} 1003.2 @env{PS1} and @env{PS2} expansions of @samp{!} to @@ -5981,12 +5992,6 @@ redirection errors, variable assignment errors for assignments preceding the command name, and so on. @item -If the @code{cd} builtin finds a directory to change to -using @env{$CDPATH}, the -value it assigns to the @env{PWD} variable does not contain any -symbolic links, as if @samp{cd -P} had been executed. - -@item If @env{CDPATH} is set, the @code{cd} builtin will not implicitly append the current directory to it. This means that @code{cd} will fail if no valid directory name can be constructed from @@ -6067,7 +6072,7 @@ does not refer to an existing directory, @code{cd} will fail instead of falling back to @var{physical} mode. @item -When the @code{pwd} builtin is supplied the @opt{-P} option, it resets +When the @code{pwd} builtin is supplied the @option{-P} option, it resets @code{$PWD} to a pathname containing no symlinks. @item |