diff --git a/doc/bash.1 b/doc/bash.1 index cf712fe3..61a4acbc 100644 --- a/doc/bash.1 +++ b/doc/bash.1 @@ -5,12 +5,12 @@ .\" Case Western Reserve University .\" chet.ramey@case.edu .\" -.\" Last Change: Thu Mar 15 11:30:03 EDT 2018 +.\" Last Change: Sat May 19 21:48:08 EDT 2018 .\" .\" bash_builtins, strip all but Built-Ins section .if \n(zZ=1 .ig zZ .if \n(zY=1 .ig zY -.TH BASH 1 "2018 March 15" "GNU Bash 5.0" +.TH BASH 1 "2018 May 19" "GNU Bash 5.0" .\" .\" There's some problem with having a `@' .\" in a tagged paragraph with the BSD man macros. @@ -1357,7 +1357,14 @@ If is null, the parameters are joined without intervening separators. .TP .B @ -Expands to the positional parameters, starting from one. When the +Expands to the positional parameters, starting from one. +In contexts where word splitting is performed, this expands each +positional parameter to a separate word; if not within double +quotes, these words are subject to word splitting. +In contexts where word splitting is not performed, +this expands to a single word +with each positional parameter separated by a space. +When the expansion occurs within double quotes, each parameter expands to a separate word. That is, "\fB$@\fP" is equivalent to "\fB$1\fP" "\fB$2\fP" ... diff --git a/doc/bashref.texi b/doc/bashref.texi index c97e1175..2f16d353 100644 --- a/doc/bashref.texi +++ b/doc/bashref.texi @@ -1663,8 +1663,16 @@ separators. @item @@ @vindex $@@ -($@@) Expands to the positional parameters, starting from one. When the -expansion occurs within double quotes, each parameter expands to a +($@@) Expands to the positional parameters, starting from one. +In contexts where word splitting is performed, this expands each +positional parameter to a separate word; if not within double +quotes, these words are subject to word splitting. +In contexts where word splitting is not performed, +this expands to a single word +with each positional parameter separated by a space. +When the +expansion occurs within double quotes, and word splitting is performed, +each parameter expands to a separate word. That is, @code{"$@@"} is equivalent to @code{"$1" "$2" @dots{}}. If the double-quoted expansion occurs within a word, the expansion of @@ -7421,7 +7429,7 @@ shell session. After the string is decoded, it is expanded via parameter expansion, command substitution, arithmetic expansion, and quote removal, subject to the value of the -@code{promptvars} shell option (@pxref{Bash Builtins}). +@code{promptvars} shell option (@pxref{The Shopt Builtin}). @node The Restricted Shell @section The Restricted Shell diff --git a/doc/version.texi b/doc/version.texi index 2072eeed..d74aad3e 100644 --- a/doc/version.texi +++ b/doc/version.texi @@ -2,10 +2,10 @@ Copyright (C) 1988-2018 Free Software Foundation, Inc. @end ignore -@set LASTCHANGE Thu Mar 15 11:29:49 EDT 2018 +@set LASTCHANGE Sat May 19 21:47:36 EDT 2018 @set EDITION 5.0 @set VERSION 5.0 -@set UPDATED 15 March 2018 -@set UPDATED-MONTH March 2018 +@set UPDATED 19 May 2018 +@set UPDATED-MONTH May 2018