commit bash-20140625 snapshot

doc/bash.1

@@ -5,12 +5,12 @@
 .\"	Case Western Reserve University
 .\"	chet.ramey@case.edu
 .\"
-.\"	Last Change: Mon May 12 10:32:53 EDT 2014
+.\"	Last Change: Tue Jul  1 15:51:28 PDT 2014
 .\"
 .\" bash_builtins, strip all but Built-Ins section
 .if \n(zZ=1 .ig zZ
 .if \n(zY=1 .ig zY
-.TH BASH 1 "2014 May 12" "GNU Bash 4.3"
+.TH BASH 1 "2014 July 1" "GNU Bash 4.3"
 .\"
 .\" There's some problem with having a `@'
 .\" in a tagged paragraph with the BSD man macros.
@@ -1226,7 +1226,7 @@ Assignment statements may also appear as arguments to the
 .BR readonly ,
 and
 .B local
-builtin commands.
+builtin commands (\fIdeclaration\fP commands).
 When in \fIposix mode\fP, these builtins may appear in a command after
 one or more instances of the \fBcommand\fP builtin and retain these
 assignment statement properties.
@@ -1234,6 +1234,8 @@ assignment statement properties.
 In the context where an assignment statement is assigning a value
 to a shell variable or array index, the += operator can be used to
 append to or add to the variable's previous value.
+This includes arguments to builtin commands such as \fBdeclare\fP that
+accept assignment statements (\fIdeclaration\fP commands).
 When += is applied to a variable for which the \fIinteger\fP attribute has been
 set, \fIvalue\fP is evaluated as an arithmetic expression and added to the
 variable's current value, which is also evaluated.
@@ -8329,10 +8331,10 @@ is supplied, or
 .B logout
 Exit a login shell.
 .TP
-\fBmapfile\fP [\fB\-n\fP \fIcount\fP] [\fB\-O\fP \fIorigin\fP] [\fB\-s\fP \fIcount\fP] [\fB\-t\fP] [\fB\-u\fP \fIfd\fP] [\fB\-C\fP \fIcallback\fP] [\fB\-c\fP \fIquantum\fP] [\fIarray\fP]
+\fBmapfile\fP [\fB\-d\fP \fIdelim\fP] [\fB\-n\fP \fIcount\fP] [\fB\-O\fP \fIorigin\fP] [\fB\-s\fP \fIcount\fP] [\fB\-t\fP] [\fB\-u\fP \fIfd\fP] [\fB\-C\fP \fIcallback\fP] [\fB\-c\fP \fIquantum\fP] [\fIarray\fP]
 .PD 0
 .TP
-\fBreadarray\fP [\fB\-n\fP \fIcount\fP] [\fB\-O\fP \fIorigin\fP] [\fB\-s\fP \fIcount\fP] [\fB\-t\fP] [\fB\-u\fP \fIfd\fP] [\fB\-C\fP \fIcallback\fP] [\fB\-c\fP \fIquantum\fP] [\fIarray\fP]
+\fBreadarray\fP [\fB\-d\fP \fIdelim\fP] [\fB\-n\fP \fIcount\fP] [\fB\-O\fP \fIorigin\fP] [\fB\-s\fP \fIcount\fP] [\fB\-t\fP] [\fB\-u\fP \fIfd\fP] [\fB\-C\fP \fIcallback\fP] [\fB\-c\fP \fIquantum\fP] [\fIarray\fP]
 .PD
 Read lines from the standard input into the indexed array variable
 .IR array ,
@@ -8349,6 +8351,10 @@ Options, if supplied, have the following meanings:
 .RS
 .PD 0
 .TP
+.B \-d
+The first character of \fIdelim\fP is used to terminate each input line,
+rather than newline.
+.TP
 .B \-n
 Copy at most
 .I count

doc/bashref.texi

@@ -1483,7 +1483,7 @@ Filename expansion is not performed.
 Assignment statements may also appear as arguments to the
 @code{alias}, 
 @code{declare}, @code{typeset}, @code{export}, @code{readonly},
-and @code{local} builtin commands.
+and @code{local} builtin commands (@var{declaration} commands).
 When in @sc{posix} mode (@pxref{Bash POSIX Mode}), these builtins may appear
 in a command after one or more instances of the @code{command} builtin
 and retain these assignment statement properties.
@@ -1492,6 +1492,8 @@ In the context where an assignment statement is assigning a value
 to a shell variable or array index (@pxref{Arrays}), the @samp{+=}
 operator can be used to   
 append to or add to the variable's previous value.
+This includes arguments to builtin commands such as @code{declare} that
+accept assignment statements (@var{declaration} commands).
 When @samp{+=} is applied to a variable for which the @var{integer} attribute
 has been set, @var{value} is evaluated as an arithmetic expression and
 added to the variable's current value, which is also evaluated.
@@ -4180,7 +4182,7 @@ parent.
 @item mapfile
 @btindex mapfile
 @example
-mapfile [-n @var{count}] [-O @var{origin}] [-s @var{count}] [-t] [-u @var{fd}]
+mapfile [-d @var{delim}] [-n @var{count}] [-O @var{origin}] [-s @var{count}] [-t] [-u @var{fd}]
     [-C @var{callback}] [-c @var{quantum}] [@var{array}]
 @end example
 
@@ -4192,6 +4194,9 @@ Options, if supplied, have the following meanings:
 
 @table @code
 
+@item -d
+The first character of @var{delim} is used to terminate each input line,
+rather than newline.
 @item -n
 Copy at most @var{count} lines.  If @var{count} is 0, all lines are copied.
 @item -O
@@ -4376,7 +4381,7 @@ Read input from file descriptor @var{fd}.
 @item readarray
 @btindex readarray
 @example
-readarray [-n @var{count}] [-O @var{origin}] [-s @var{count}] [-t] [-u @var{fd}]
+readarray [-d @var{delim}] [-n @var{count}] [-O @var{origin}] [-s @var{count}] [-t] [-u @var{fd}]
     [-C @var{callback}] [-c @var{quantum}] [@var{array}]
 @end example
 

doc/version.texi

@@ -2,9 +2,9 @@
 Copyright (C) 1988-2014 Free Software Foundation, Inc.
 @end ignore
 
-@set LASTCHANGE Mon May 12 10:32:34 EDT 2014
+@set LASTCHANGE Tue Jul  1 15:51:09 PDT 2014
 
 @set EDITION 4.3
 @set VERSION 4.3
-@set UPDATED 12 May 2014
-@set UPDATED-MONTH May 2014
+@set UPDATED 1 July 2014
+@set UPDATED-MONTH July 2014

doc/version.texi~

@@ -0,0 +1,10 @@
+@ignore
+Copyright (C) 1988-2014 Free Software Foundation, Inc.
+@end ignore
+
+@set LASTCHANGE Mon May 12 10:32:34 EDT 2014
+
+@set EDITION 4.3
+@set VERSION 4.3
+@set UPDATED 12 May 2014
+@set UPDATED-MONTH May 2014