commit bash-20170407 snapshot

doc/bash.1

@@ -5,12 +5,12 @@
 .\"	Case Western Reserve University
 .\"	chet.ramey@case.edu
 .\"
-.\"	Last Change: Wed Mar 22 15:35:08 EDT 2017
+.\"	Last Change: Tue Apr  4 14:55:46 EDT 2017
 .\"
 .\" bash_builtins, strip all but Built-Ins section
 .if \n(zZ=1 .ig zZ
 .if \n(zY=1 .ig zY
-.TH BASH 1 "2017 March 22" "GNU Bash 4.4"
+.TH BASH 1 "2017 April 4" "GNU Bash 4.4"
 .\"
 .\" There's some problem with having a `@'
 .\" in a tagged paragraph with the BSD man macros.
@@ -8768,6 +8768,8 @@ Options, if supplied, have the following meanings:
 .B \-d
 The first character of \fIdelim\fP is used to terminate each input line,
 rather than newline.
+If \fIdelim\fP is the empty string, \fBread\fP will terminate a line
+when it reads a NUL character.
 .TP
 .B \-n
 Copy at most

doc/bash.html

@@ -780,6 +780,12 @@ the time information.
 
 Each command in a pipeline is executed as a separate process (i.e., in a
 subshell).
+See
+<FONT SIZE=-1><B>COMMAND EXECUTION ENVIRONMENT</B></FONT>
+for a description of a subshell environment.
+If the <B>lastpipe</B> option is enabled using the <B>shopt</B> builtin
+(see the description of <B>shopt</B> below),
+the last element of a pipeline may be run by the shell process.
 <A NAME="lbAN">&nbsp;</A>
 <H4>Lists</H4>
 
@@ -855,7 +861,7 @@ An AND list has the form
 is executed if, and only if,
 <I>command1</I>
 
-returns an exit status of zero.
+returns an exit status of zero (success).
 <P>
 
 An OR list has the form
@@ -1463,7 +1469,7 @@ question mark
 
 <DD>
 the eight-bit character whose value is the octal value <I>nnn</I>
-(one to three digits)
+(one to three octal digits)
 <DT><B>\x</B><I>HH</I>
 
 <DD>
@@ -3388,10 +3394,12 @@ The
 <B>unset</B>
 
 builtin is used to destroy arrays.  <B>unset</B> <I>name</I>[<I>subscript</I>]
-destroys the array element at index <I>subscript</I>.
+destroys the array element at index <I>subscript</I>,
+for both indexed and associative arrays.
 Negative subscripts to indexed arrays are interpreted as described above.
 Care must be taken to avoid unwanted side effects caused by pathname
 expansion.
+Unsetting the last element of an array variable does not unset the variable.
 <B>unset</B> <I>name</I>, where <I>name</I> is an array, or
 <B>unset</B> <I>name</I>[<I>subscript</I>], where
 <I>subscript</I> is <B>*</B> or <B>@</B>, removes the entire array.
@@ -5452,6 +5460,16 @@ local variable <I>var</I> from <I>func1</I>, shadowing any global variable
 named <I>var</I>.
 <P>
 
+The <B>unset</B> builtin also acts using the same dynamic scope: if a
+variable is local to the current scope, <B>unset</B> will unset it;
+otherwise the unset will refer to the variable found in any calling scope
+as described above.
+If a variable at the local scope is unset, it will remain so
+until it is reset in that scope or until the function returns.
+If the unset acts on a variable at a previous scope, any instance of a
+variable with that name that had been shadowed will become visible.
+<P>
+
 The <B>FUNCNEST</B> variable, if set to a numeric value greater
 than 0, defines a maximum function nesting level.  Function
 invocations that exceed the limit cause the entire command to
@@ -13820,6 +13838,6 @@ There may be only one active coprocess at a time.
 </DL>
 <HR>
 This document was created by man2html from bash.1.<BR>
-Time: 22 March 2017 16:12:40 EDT
+Time: 03 April 2017 16:34:05 EDT
 </BODY>
 </HTML>

doc/bash.info

@@ -451,7 +451,7 @@ decoded as follows:
      question mark
 '\NNN'
      the eight-bit character whose value is the octal value NNN (one to
-     three digits)
+     three octal digits)
 '\xHH'
      the eight-bit character whose value is the hexadecimal value HH
      (one or two hex digits)
@@ -586,16 +586,20 @@ information.
    If the pipeline is not executed asynchronously (*note Lists::), the
 shell waits for all commands in the pipeline to complete.
 
-   Each command in a pipeline is executed in its own subshell (*note
-Command Execution Environment::).  The exit status of a pipeline is the
-exit status of the last command in the pipeline, unless the 'pipefail'
-option is enabled (*note The Set Builtin::).  If 'pipefail' is enabled,
-the pipeline's return status is the value of the last (rightmost)
-command to exit with a non-zero status, or zero if all commands exit
-successfully.  If the reserved word '!' precedes the pipeline, the exit
-status is the logical negation of the exit status as described above.
-The shell waits for all commands in the pipeline to terminate before
-returning a value.
+   Each command in a pipeline is executed in its own subshell, which is
+a separate process (*note Command Execution Environment::).  If the
+'lastpipe' option is enabled using the 'shopt' builtin (*note The Shopt
+Builtin::), the last element of a pipeline may be run by the shell
+process.
+
+   The exit status of a pipeline is the exit status of the last command
+in the pipeline, unless the 'pipefail' option is enabled (*note The Set
+Builtin::).  If 'pipefail' is enabled, the pipeline's return status is
+the value of the last (rightmost) command to exit with a non-zero
+status, or zero if all commands exit successfully.  If the reserved word
+'!' precedes the pipeline, the exit status is the logical negation of
+the exit status as described above.  The shell waits for all commands in
+the pipeline to terminate before returning a value.
 
 
 File: bash.info,  Node: Lists,  Next: Compound Commands,  Prev: Pipelines,  Up: Shell Commands
@@ -633,7 +637,7 @@ executed with left associativity.
      COMMAND1 && COMMAND2
 
 COMMAND2 is executed if, and only if, COMMAND1 returns an exit status of
-zero.
+zero (success).
 
    An OR list has the form
      COMMAND1 || COMMAND2
@@ -656,11 +660,12 @@ File: bash.info,  Node: Compound Commands,  Next: Coprocesses,  Prev: Lists,  Up
 * Conditional Constructs::	Shell commands for conditional execution.
 * Command Grouping::		Ways to group commands.
 
-Compound commands are the shell programming constructs.  Each construct
-begins with a reserved word or control operator and is terminated by a
-corresponding reserved word or operator.  Any redirections (*note
-Redirections::) associated with a compound command apply to all commands
-within that compound command unless explicitly overridden.
+Compound commands are the shell programming language constructs.  Each
+construct begins with a reserved word or control operator and is
+terminated by a corresponding reserved word or operator.  Any
+redirections (*note Redirections::) associated with a compound command
+apply to all commands within that compound command unless explicitly
+overridden.
 
    In most cases a list of commands in a compound command's description
 may be separated from the rest of the command by one or more newlines,
@@ -705,14 +710,16 @@ syntax, it may be replaced with one or more newlines.
 
           for NAME [ [in [WORDS ...] ] ; ] do COMMANDS; done
 
-     Expand WORDS, and execute COMMANDS once for each member in the
-     resultant list, with NAME bound to the current member.  If 'in
-     WORDS' is not present, the 'for' command executes the COMMANDS once
-     for each positional parameter that is set, as if 'in "$@"' had been
-     specified (*note Special Parameters::).  The return status is the
-     exit status of the last command that executes.  If there are no
-     items in the expansion of WORDS, no commands are executed, and the
-     return status is zero.
+     Expand WORDS (*note Shell Expansions::), and execute COMMANDS once
+     for each member in the resultant list, with NAME bound to the
+     current member.  If 'in WORDS' is not present, the 'for' command
+     executes the COMMANDS once for each positional parameter that is
+     set, as if 'in "$@"' had been specified (*note Special
+     Parameters::).
+
+     The return status is the exit status of the last command that
+     executes.  If there are no items in the expansion of WORDS, no
+     commands are executed, and the return status is zero.
 
      An alternate form of the 'for' command is also supported:
 
@@ -764,20 +771,21 @@ File: bash.info,  Node: Conditional Constructs,  Next: Command Grouping,  Prev:
           case WORD in [ [(] PATTERN [| PATTERN]...) COMMAND-LIST ;;]... esac
 
      'case' will selectively execute the COMMAND-LIST corresponding to
-     the first PATTERN that matches WORD.  If the 'nocasematch' shell
-     option (see the description of 'shopt' in *note The Shopt
-     Builtin::) is enabled, the match is performed without regard to the
-     case of alphabetic characters.  The '|' is used to separate
-     multiple patterns, and the ')' operator terminates a pattern list.
-     A list of patterns and an associated command-list is known as a
-     CLAUSE.
+     the first PATTERN that matches WORD.  The match is performed
+     according to the rules described below in *note Pattern Matching::.
+     If the 'nocasematch' shell option (see the description of 'shopt'
+     in *note The Shopt Builtin::) is enabled, the match is performed
+     without regard to the case of alphabetic characters.  The '|' is
+     used to separate multiple patterns, and the ')' operator terminates
+     a pattern list.  A list of patterns and an associated command-list
+     is known as a CLAUSE.
 
      Each clause must be terminated with ';;', ';&', or ';;&'.  The WORD
      undergoes tilde expansion, parameter expansion, command
-     substitution, arithmetic expansion, and quote removal before
-     matching is attempted.  Each PATTERN undergoes tilde expansion,
-     parameter expansion, command substitution, and arithmetic
-     expansion.
+     substitution, arithmetic expansion, and quote removal (*note Shell
+     Parameter Expansion::) before matching is attempted.  Each PATTERN
+     undergoes tilde expansion, parameter expansion, command
+     substitution, and arithmetic expansion.
 
      There may be an arbitrary number of 'case' clauses, each terminated
      by a ';;', ';&', or ';;&'.  The first pattern that matches
@@ -904,7 +912,7 @@ File: bash.info,  Node: Conditional Constructs,  Next: Command Grouping,  Prev:
      variable LINE) if there is a sequence of characters in the value
      consisting of any number, including zero, of space characters, zero
      or one instances of 'a', then a 'b':
-          [[ $line =~ [[:space:]]*(a)?b ]]
+          [[ $line =~ [[:space:]]*?(a)b ]]
 
      That means values like 'aab' and ' aaaaaab' will match, as will a
      line containing a 'b' anywhere in its value.
@@ -917,7 +925,7 @@ File: bash.info,  Node: Conditional Constructs,  Next: Command Grouping,  Prev:
      to the shell's quote removal.  Using a shell variable to store the
      pattern decreases these problems.  For example, the following is
      equivalent to the above:
-          pattern='[[:space:]]*(a)?b'
+          pattern='[[:space:]]*?(a)b'
           [[ $line =~ $pattern ]]
 
      If you want to match a character that's special to the regular
@@ -1252,6 +1260,14 @@ script displays
      var=global
      func1
 
+   The 'unset' builtin also acts using the same dynamic scope: if a
+variable is local to the current scope, 'unset' will unset it; otherwise
+the unset will refer to the variable found in any calling scope as
+described above.  If a variable at the local scope is unset, it will
+remain so until it is reset in that scope or until the function returns.
+If the unset acts on a variable at a previous scope, any instance of a
+variable with that name that had been shadowed will become visible.
+
    Function names and definitions may be listed with the '-f' option to
 the 'declare' ('typeset') builtin command (*note Bash Builtins::).  The
 '-F' option to 'declare' or 'typeset' will list the function names only
@@ -6205,8 +6221,10 @@ quotes.
 NAME[SUBSCRIPT]' destroys the array element at index SUBSCRIPT.
 Negative subscripts to indexed arrays are interpreted as described
 above.  Care must be taken to avoid unwanted side effects caused by
-filename expansion.  'unset NAME', where NAME is an array, removes the
-entire array.  A subscript of '*' or '@' also removes the entire array.
+filename expansion.  Unsetting the last element of an array variable
+does not unset the variable.  'unset NAME', where NAME is an array,
+removes the entire array.  A subscript of '*' or '@' also removes the
+entire array.
 
    The 'declare', 'local', and 'readonly' builtins each accept a '-a'
 option to specify an indexed array and a '-A' option to specify an
@@ -10854,9 +10872,9 @@ D.2 Index of Shell Reserved Words
 
 * !:                                     Pipelines.           (line   9)
 * [[:                                    Conditional Constructs.
-                                                              (line 121)
+                                                              (line 122)
 * ]]:                                    Conditional Constructs.
-                                                              (line 121)
+                                                              (line 122)
 * {:                                     Command Grouping.    (line  21)
 * }:                                     Command Grouping.    (line  21)
 * case:                                  Conditional Constructs.
@@ -10878,7 +10896,7 @@ D.2 Index of Shell Reserved Words
 * in:                                    Conditional Constructs.
                                                               (line  28)
 * select:                                Conditional Constructs.
-                                                              (line  79)
+                                                              (line  80)
 * then:                                  Conditional Constructs.
                                                               (line   7)
 * time:                                  Pipelines.           (line   9)
@@ -11485,121 +11503,121 @@ Node: Escape Character14462
 Node: Single Quotes14947
 Node: Double Quotes15295
 Node: ANSI-C Quoting16573
-Node: Locale Translation17826
-Node: Comments18722
-Node: Shell Commands19340
-Node: Simple Commands20212
-Node: Pipelines20843
-Node: Lists23586
-Node: Compound Commands25315
-Node: Looping Constructs26318
-Node: Conditional Constructs28781
-Node: Command Grouping39703
-Node: Coprocesses41182
-Node: GNU Parallel43014
-Node: Shell Functions46987
-Node: Shell Parameters53696
-Node: Positional Parameters58109
-Node: Special Parameters59009
-Node: Shell Expansions62346
-Node: Brace Expansion64440
-Node: Tilde Expansion67274
-Node: Shell Parameter Expansion69622
-Node: Command Substitution83754
-Node: Arithmetic Expansion85109
-Node: Process Substitution86041
-Node: Word Splitting87161
-Node: Filename Expansion89105
-Node: Pattern Matching91479
-Node: Quote Removal95465
-Node: Redirections95760
-Node: Executing Commands105318
-Node: Simple Command Expansion105988
-Node: Command Search and Execution107918
-Node: Command Execution Environment110254
-Node: Environment113238
-Node: Exit Status114897
-Node: Signals116567
-Node: Shell Scripts118534
-Node: Shell Builtin Commands121049
-Node: Bourne Shell Builtins123083
-Node: Bash Builtins143683
-Node: Modifying Shell Behavior172328
-Node: The Set Builtin172673
-Node: The Shopt Builtin183086
-Node: Special Builtins198984
-Node: Shell Variables199963
-Node: Bourne Shell Variables200400
-Node: Bash Variables202504
-Node: Bash Features232297
-Node: Invoking Bash233196
-Node: Bash Startup Files239145
-Node: Interactive Shells244248
-Node: What is an Interactive Shell?244658
-Node: Is this Shell Interactive?245307
-Node: Interactive Shell Behavior246122
-Node: Bash Conditional Expressions249610
-Node: Shell Arithmetic253976
-Node: Aliases256793
-Node: Arrays259341
-Node: The Directory Stack264425
-Node: Directory Stack Builtins265209
-Node: Controlling the Prompt268177
-Node: The Restricted Shell270939
-Node: Bash POSIX Mode272764
-Node: Job Control283115
-Node: Job Control Basics283575
-Node: Job Control Builtins288543
-Node: Job Control Variables293270
-Node: Command Line Editing294426
-Node: Introduction and Notation296097
-Node: Readline Interaction297720
-Node: Readline Bare Essentials298911
-Node: Readline Movement Commands300694
-Node: Readline Killing Commands301654
-Node: Readline Arguments303572
-Node: Searching304616
-Node: Readline Init File306802
-Node: Readline Init File Syntax307949
-Node: Conditional Init Constructs328136
-Node: Sample Init File330661
-Node: Bindable Readline Commands333778
-Node: Commands For Moving334982
-Node: Commands For History336831
-Node: Commands For Text341126
-Node: Commands For Killing344515
-Node: Numeric Arguments346996
-Node: Commands For Completion348135
-Node: Keyboard Macros352326
-Node: Miscellaneous Commands353013
-Node: Readline vi Mode358889
-Node: Programmable Completion359796
-Node: Programmable Completion Builtins367257
-Node: A Programmable Completion Example377143
-Node: Using History Interactively382395
-Node: Bash History Facilities383079
-Node: Bash History Builtins386080
-Node: History Interaction390372
-Node: Event Designators393336
-Node: Word Designators394555
-Node: Modifiers396192
-Node: Installing Bash397594
-Node: Basic Installation398731
-Node: Compilers and Options401422
-Node: Compiling For Multiple Architectures402163
-Node: Installation Names403826
-Node: Specifying the System Type404644
-Node: Sharing Defaults405360
-Node: Operation Controls406033
-Node: Optional Features406991
-Node: Reporting Bugs417517
-Node: Major Differences From The Bourne Shell418711
-Node: GNU Free Documentation License435563
-Node: Indexes460740
-Node: Builtin Index461194
-Node: Reserved Word Index468021
-Node: Variable Index470469
-Node: Function Index486147
-Node: Concept Index499450
+Node: Locale Translation17832
+Node: Comments18728
+Node: Shell Commands19346
+Node: Simple Commands20218
+Node: Pipelines20849
+Node: Lists23781
+Node: Compound Commands25520
+Node: Looping Constructs26532
+Node: Conditional Constructs29027
+Node: Command Grouping40082
+Node: Coprocesses41561
+Node: GNU Parallel43393
+Node: Shell Functions47366
+Node: Shell Parameters54565
+Node: Positional Parameters58978
+Node: Special Parameters59878
+Node: Shell Expansions63215
+Node: Brace Expansion65309
+Node: Tilde Expansion68143
+Node: Shell Parameter Expansion70491
+Node: Command Substitution84623
+Node: Arithmetic Expansion85978
+Node: Process Substitution86910
+Node: Word Splitting88030
+Node: Filename Expansion89974
+Node: Pattern Matching92348
+Node: Quote Removal96334
+Node: Redirections96629
+Node: Executing Commands106187
+Node: Simple Command Expansion106857
+Node: Command Search and Execution108787
+Node: Command Execution Environment111123
+Node: Environment114107
+Node: Exit Status115766
+Node: Signals117436
+Node: Shell Scripts119403
+Node: Shell Builtin Commands121918
+Node: Bourne Shell Builtins123952
+Node: Bash Builtins144552
+Node: Modifying Shell Behavior173197
+Node: The Set Builtin173542
+Node: The Shopt Builtin183955
+Node: Special Builtins199853
+Node: Shell Variables200832
+Node: Bourne Shell Variables201269
+Node: Bash Variables203373
+Node: Bash Features233166
+Node: Invoking Bash234065
+Node: Bash Startup Files240014
+Node: Interactive Shells245117
+Node: What is an Interactive Shell?245527
+Node: Is this Shell Interactive?246176
+Node: Interactive Shell Behavior246991
+Node: Bash Conditional Expressions250479
+Node: Shell Arithmetic254845
+Node: Aliases257662
+Node: Arrays260210
+Node: The Directory Stack265372
+Node: Directory Stack Builtins266156
+Node: Controlling the Prompt269124
+Node: The Restricted Shell271886
+Node: Bash POSIX Mode273711
+Node: Job Control284062
+Node: Job Control Basics284522
+Node: Job Control Builtins289490
+Node: Job Control Variables294217
+Node: Command Line Editing295373
+Node: Introduction and Notation297044
+Node: Readline Interaction298667
+Node: Readline Bare Essentials299858
+Node: Readline Movement Commands301641
+Node: Readline Killing Commands302601
+Node: Readline Arguments304519
+Node: Searching305563
+Node: Readline Init File307749
+Node: Readline Init File Syntax308896
+Node: Conditional Init Constructs329083
+Node: Sample Init File331608
+Node: Bindable Readline Commands334725
+Node: Commands For Moving335929
+Node: Commands For History337778
+Node: Commands For Text342073
+Node: Commands For Killing345462
+Node: Numeric Arguments347943
+Node: Commands For Completion349082
+Node: Keyboard Macros353273
+Node: Miscellaneous Commands353960
+Node: Readline vi Mode359836
+Node: Programmable Completion360743
+Node: Programmable Completion Builtins368204
+Node: A Programmable Completion Example378090
+Node: Using History Interactively383342
+Node: Bash History Facilities384026
+Node: Bash History Builtins387027
+Node: History Interaction391319
+Node: Event Designators394283
+Node: Word Designators395502
+Node: Modifiers397139
+Node: Installing Bash398541
+Node: Basic Installation399678
+Node: Compilers and Options402369
+Node: Compiling For Multiple Architectures403110
+Node: Installation Names404773
+Node: Specifying the System Type405591
+Node: Sharing Defaults406307
+Node: Operation Controls406980
+Node: Optional Features407938
+Node: Reporting Bugs418464
+Node: Major Differences From The Bourne Shell419658
+Node: GNU Free Documentation License436510
+Node: Indexes461687
+Node: Builtin Index462141
+Node: Reserved Word Index468968
+Node: Variable Index471416
+Node: Function Index487094
+Node: Concept Index500397
 
 End Tag Table

doc/bashref.aux

@@ -60,7 +60,7 @@
 @xrdef{Conditional Constructs-title}{Conditional Constructs}
 @xrdef{Conditional Constructs-snt}{Section@tie 3.2.4.2}
 @xrdef{Looping Constructs-pg}{10}
-@xrdef{Conditional Constructs-pg}{10}
+@xrdef{Conditional Constructs-pg}{11}
 @xrdef{Command Grouping-title}{Grouping Commands}
 @xrdef{Command Grouping-snt}{Section@tie 3.2.4.3}
 @xrdef{Command Grouping-pg}{14}
@@ -69,7 +69,7 @@
 @xrdef{GNU Parallel-title}{GNU Parallel}
 @xrdef{GNU Parallel-snt}{Section@tie 3.2.6}
 @xrdef{Coprocesses-pg}{15}
-@xrdef{GNU Parallel-pg}{15}
+@xrdef{GNU Parallel-pg}{16}
 @xrdef{Shell Functions-title}{Shell Functions}
 @xrdef{Shell Functions-snt}{Section@tie 3.3}
 @xrdef{Shell Functions-pg}{17}
@@ -78,12 +78,12 @@
 @xrdef{Shell Parameters-pg}{19}
 @xrdef{Positional Parameters-title}{Positional Parameters}
 @xrdef{Positional Parameters-snt}{Section@tie 3.4.1}
+@xrdef{Positional Parameters-pg}{20}
 @xrdef{Special Parameters-title}{Special Parameters}
 @xrdef{Special Parameters-snt}{Section@tie 3.4.2}
-@xrdef{Positional Parameters-pg}{20}
+@xrdef{Special Parameters-pg}{21}
 @xrdef{Shell Expansions-title}{Shell Expansions}
 @xrdef{Shell Expansions-snt}{Section@tie 3.5}
-@xrdef{Special Parameters-pg}{21}
 @xrdef{Brace Expansion-title}{Brace Expansion}
 @xrdef{Brace Expansion-snt}{Section@tie 3.5.1}
 @xrdef{Shell Expansions-pg}{22}
@@ -102,11 +102,11 @@
 @xrdef{Process Substitution-snt}{Section@tie 3.5.6}
 @xrdef{Command Substitution-pg}{30}
 @xrdef{Arithmetic Expansion-pg}{30}
-@xrdef{Process Substitution-pg}{30}
 @xrdef{Word Splitting-title}{Word Splitting}
 @xrdef{Word Splitting-snt}{Section@tie 3.5.7}
 @xrdef{Filename Expansion-title}{Filename Expansion}
 @xrdef{Filename Expansion-snt}{Section@tie 3.5.8}
+@xrdef{Process Substitution-pg}{31}
 @xrdef{Word Splitting-pg}{31}
 @xrdef{Filename Expansion-pg}{31}
 @xrdef{Pattern Matching-title}{Pattern Matching}

doc/bashref.cp

@@ -34,7 +34,7 @@
 \entry{commands, lists}{9}{commands, lists}
 \entry{commands, compound}{9}{commands, compound}
 \entry{commands, looping}{10}{commands, looping}
-\entry{commands, conditional}{10}{commands, conditional}
+\entry{commands, conditional}{11}{commands, conditional}
 \entry{commands, grouping}{14}{commands, grouping}
 \entry{coprocess}{15}{coprocess}
 \entry{shell function}{17}{shell function}
@@ -54,7 +54,7 @@
 \entry{command substitution}{30}{command substitution}
 \entry{expansion, arithmetic}{30}{expansion, arithmetic}
 \entry{arithmetic expansion}{30}{arithmetic expansion}
-\entry{process substitution}{30}{process substitution}
+\entry{process substitution}{31}{process substitution}
 \entry{word splitting}{31}{word splitting}
 \entry{expansion, filename}{31}{expansion, filename}
 \entry{expansion, pathname}{31}{expansion, pathname}

doc/bashref.cps

@@ -20,7 +20,7 @@
 \entry {command substitution}{30}
 \entry {command timing}{8}
 \entry {commands, compound}{9}
-\entry {commands, conditional}{10}
+\entry {commands, conditional}{11}
 \entry {commands, grouping}{14}
 \entry {commands, lists}{9}
 \entry {commands, looping}{10}
@@ -99,7 +99,7 @@
 \entry {POSIX Mode}{98}
 \entry {process group}{3}
 \entry {process group ID}{3}
-\entry {process substitution}{30}
+\entry {process substitution}{31}
 \entry {programmable completion}{131}
 \entry {prompting}{96}
 \initial {Q}

doc/bashref.html

@@ -861,7 +861,7 @@ present, are decoded as follows:
 </p></dd>
 <dt><code>\<var>nnn</var></code></dt>
 <dd><p>the eight-bit character whose value is the octal value <var>nnn</var>
-(one to three digits)
+(one to three octal digits)
 </p></dd>
 <dt><code>\x<var>HH</var></code></dt>
 <dd><p>the eight-bit character whose value is the hexadecimal value <var>HH</var>
@@ -1051,8 +1051,13 @@ the time information.
 <p>If the pipeline is not executed asynchronously (see <a href="#Lists">Lists</a>), the
 shell waits for all commands in the pipeline to complete.
 </p>
-<p>Each command in a pipeline is executed in its own subshell
-(see <a href="#Command-Execution-Environment">Command Execution Environment</a>).  The exit
+<p>Each command in a pipeline is executed in its own subshell, which is a
+separate process (see <a href="#Command-Execution-Environment">Command Execution Environment</a>).
+If the <code>lastpipe</code> option is enabled using the <code>shopt</code> builtin
+(see <a href="#The-Shopt-Builtin">The Shopt Builtin</a>),
+the last element of a pipeline may be run by the shell process.
+</p>
+<p>The exit
 status of a pipeline is the exit status of the last command in the
 pipeline, unless the <code>pipefail</code> option is enabled
 (see <a href="#The-Set-Builtin">The Set Builtin</a>).
@@ -1111,7 +1116,7 @@ associativity.
 </pre></div>
 
 <p><var>command2</var> is executed if, and only if, <var>command1</var>
-returns an exit status of zero.
+returns an exit status of zero (success).
 </p>
 <p>An <small>OR</small> list has the form
 </p><div class="example">
@@ -1144,7 +1149,7 @@ Next: <a href="#Coprocesses" accesskey="n" rel="next">Coprocesses</a>, Previous:
 </td></tr>
 </table>
 
-<p>Compound commands are the shell programming constructs.
+<p>Compound commands are the shell programming language constructs.
 Each construct begins with a reserved word or control operator and is
 terminated by a corresponding reserved word or operator.
 Any redirections (see <a href="#Redirections">Redirections</a>) associated with a compound command
@@ -1211,13 +1216,15 @@ in <var>consequent-commands</var>, or zero if none was executed.
 <pre class="example">for <var>name</var> [ [in [<var>words</var> &hellip;] ] ; ] do <var>commands</var>; done
 </pre></div>
 
-<p>Expand <var>words</var>, and execute <var>commands</var> once for each member
+<p>Expand <var>words</var> (see <a href="#Shell-Expansions">Shell Expansions</a>), and execute <var>commands</var>
+once for each member
 in the resultant list, with <var>name</var> bound to the current member.
 If &lsquo;<samp>in <var>words</var></samp>&rsquo; is not present, the <code>for</code> command
 executes the <var>commands</var> once for each positional parameter that is
 set, as if &lsquo;<samp>in &quot;$@&quot;</samp>&rsquo; had been specified
 (see <a href="#Special-Parameters">Special Parameters</a>).
-The return status is the exit status of the last command that executes.
+</p>
+<p>The return status is the exit status of the last command that executes.
 If there are no items in the expansion of <var>words</var>, no commands are
 executed, and the return status is zero.
 </p>
@@ -1295,6 +1302,8 @@ zero if no condition tested true.
 
 <p><code>case</code> will selectively execute the <var>command-list</var> corresponding to
 the first <var>pattern</var> that matches <var>word</var>.
+The match is performed according
+to the rules described below in <a href="#Pattern-Matching">Pattern Matching</a>.
 If the <code>nocasematch</code> shell option
 (see the description of <code>shopt</code> in <a href="#The-Shopt-Builtin">The Shopt Builtin</a>)
 is enabled, the match is performed without regard to the case
@@ -1306,7 +1315,9 @@ as a <var>clause</var>.
 </p>
 <p>Each clause must be terminated with &lsquo;<samp>;;</samp>&rsquo;, &lsquo;<samp>;&amp;</samp>&rsquo;, or &lsquo;<samp>;;&amp;</samp>&rsquo;.
 The <var>word</var> undergoes tilde expansion, parameter expansion, command
-substitution, arithmetic expansion, and quote removal before matching is
+substitution, arithmetic expansion, and quote removal
+(see <a href="#Shell-Parameter-Expansion">Shell Parameter Expansion</a>)
+before matching is
 attempted.  Each <var>pattern</var> undergoes tilde expansion, parameter
 expansion, command substitution, and arithmetic expansion.
 </p>
@@ -1467,7 +1478,7 @@ if there is a sequence of characters in the value consisting of
 any number, including zero, of 
 space characters, zero or one instances of &lsquo;<samp>a</samp>&rsquo;, then a &lsquo;<samp>b</samp>&rsquo;:
 </p><div class="example">
-<pre class="example">[[ $line =~ [[:space:]]*(a)?b ]]
+<pre class="example">[[ $line =~ [[:space:]]*?(a)b ]]
 </pre></div>
 
 <p>That means values like &lsquo;<samp>aab</samp>&rsquo; and &lsquo;<samp>  aaaaaab</samp>&rsquo; will match, as
@@ -1482,7 +1493,7 @@ expressions while paying attention to the shell&rsquo;s quote removal.
 Using a shell variable to store the pattern decreases these problems.
 For example, the following is equivalent to the above:
 </p><div class="example">
-<pre class="example">pattern='[[:space:]]*(a)?b'
+<pre class="example">pattern='[[:space:]]*?(a)b'
 [[ $line =~ $pattern ]]
 </pre></div>
 
@@ -1915,6 +1926,15 @@ var=global
 func1
 </pre></div>
 
+<p>The <code>unset</code> builtin also acts using the same dynamic scope: if a  
+variable is local to the current scope, <code>unset</code> will unset it;         
+otherwise the unset will refer to the variable found in any calling scope 
+as described above.
+If a variable at the local scope is unset, it will remain so
+until it is reset in that scope or until the function returns.
+If the unset acts on a variable at a previous scope, any instance of a   
+variable with that name that had been shadowed will become visible.
+</p>
 <p>Function names and definitions may be listed with the
 <samp>-f</samp> option to the <code>declare</code> (<code>typeset</code>)
 builtin command (see <a href="#Bash-Builtins">Bash Builtins</a>).
@@ -8508,6 +8528,7 @@ destroys the array element at index <var>subscript</var>.
 Negative subscripts to indexed arrays are interpreted as described above.
 Care must be taken to avoid unwanted side effects caused by filename
 expansion.
+Unsetting the last element of an array variable does not unset the variable.
 <code>unset <var>name</var></code>, where <var>name</var> is an array, removes the
 entire array.  A subscript of &lsquo;<samp>*</samp>&rsquo; or &lsquo;<samp>@</samp>&rsquo; also removes the
 entire array.

doc/bashref.info

@@ -586,16 +586,20 @@ information.
    If the pipeline is not executed asynchronously (*note Lists::), the
 shell waits for all commands in the pipeline to complete.
 
-   Each command in a pipeline is executed in its own subshell (*note
-Command Execution Environment::).  The exit status of a pipeline is the
-exit status of the last command in the pipeline, unless the 'pipefail'
-option is enabled (*note The Set Builtin::).  If 'pipefail' is enabled,
-the pipeline's return status is the value of the last (rightmost)
-command to exit with a non-zero status, or zero if all commands exit
-successfully.  If the reserved word '!' precedes the pipeline, the exit
-status is the logical negation of the exit status as described above.
-The shell waits for all commands in the pipeline to terminate before
-returning a value.
+   Each command in a pipeline is executed in its own subshell, which is
+a separate process (*note Command Execution Environment::).  If the
+'lastpipe' option is enabled using the 'shopt' builtin (*note The Shopt
+Builtin::), the last element of a pipeline may be run by the shell
+process.
+
+   The exit status of a pipeline is the exit status of the last command
+in the pipeline, unless the 'pipefail' option is enabled (*note The Set
+Builtin::).  If 'pipefail' is enabled, the pipeline's return status is
+the value of the last (rightmost) command to exit with a non-zero
+status, or zero if all commands exit successfully.  If the reserved word
+'!' precedes the pipeline, the exit status is the logical negation of
+the exit status as described above.  The shell waits for all commands in
+the pipeline to terminate before returning a value.
 
 
 File: bashref.info,  Node: Lists,  Next: Compound Commands,  Prev: Pipelines,  Up: Shell Commands
@@ -11504,116 +11508,116 @@ Node: Comments18728
 Node: Shell Commands19346
 Node: Simple Commands20218
 Node: Pipelines20849
-Node: Lists23592
-Node: Compound Commands25331
-Node: Looping Constructs26343
-Node: Conditional Constructs28838
-Node: Command Grouping39893
-Node: Coprocesses41372
-Node: GNU Parallel43204
-Node: Shell Functions47177
-Node: Shell Parameters54376
-Node: Positional Parameters58789
-Node: Special Parameters59689
-Node: Shell Expansions63026
-Node: Brace Expansion65120
-Node: Tilde Expansion67954
-Node: Shell Parameter Expansion70302
-Node: Command Substitution84434
-Node: Arithmetic Expansion85789
-Node: Process Substitution86721
-Node: Word Splitting87841
-Node: Filename Expansion89785
-Node: Pattern Matching92159
-Node: Quote Removal96145
-Node: Redirections96440
-Node: Executing Commands105998
-Node: Simple Command Expansion106668
-Node: Command Search and Execution108598
-Node: Command Execution Environment110934
-Node: Environment113918
-Node: Exit Status115577
-Node: Signals117247
-Node: Shell Scripts119214
-Node: Shell Builtin Commands121729
-Node: Bourne Shell Builtins123763
-Node: Bash Builtins144363
-Node: Modifying Shell Behavior173008
-Node: The Set Builtin173353
-Node: The Shopt Builtin183766
-Node: Special Builtins199664
-Node: Shell Variables200643
-Node: Bourne Shell Variables201080
-Node: Bash Variables203184
-Node: Bash Features232977
-Node: Invoking Bash233876
-Node: Bash Startup Files239825
-Node: Interactive Shells244928
-Node: What is an Interactive Shell?245338
-Node: Is this Shell Interactive?245987
-Node: Interactive Shell Behavior246802
-Node: Bash Conditional Expressions250290
-Node: Shell Arithmetic254656
-Node: Aliases257473
-Node: Arrays260021
-Node: The Directory Stack265183
-Node: Directory Stack Builtins265967
-Node: Controlling the Prompt268935
-Node: The Restricted Shell271697
-Node: Bash POSIX Mode273522
-Node: Job Control283873
-Node: Job Control Basics284333
-Node: Job Control Builtins289301
-Node: Job Control Variables294028
-Node: Command Line Editing295184
-Node: Introduction and Notation296855
-Node: Readline Interaction298478
-Node: Readline Bare Essentials299669
-Node: Readline Movement Commands301452
-Node: Readline Killing Commands302412
-Node: Readline Arguments304330
-Node: Searching305374
-Node: Readline Init File307560
-Node: Readline Init File Syntax308707
-Node: Conditional Init Constructs328894
-Node: Sample Init File331419
-Node: Bindable Readline Commands334536
-Node: Commands For Moving335740
-Node: Commands For History337589
-Node: Commands For Text341884
-Node: Commands For Killing345273
-Node: Numeric Arguments347754
-Node: Commands For Completion348893
-Node: Keyboard Macros353084
-Node: Miscellaneous Commands353771
-Node: Readline vi Mode359647
-Node: Programmable Completion360554
-Node: Programmable Completion Builtins368015
-Node: A Programmable Completion Example377901
-Node: Using History Interactively383153
-Node: Bash History Facilities383837
-Node: Bash History Builtins386838
-Node: History Interaction391130
-Node: Event Designators394094
-Node: Word Designators395313
-Node: Modifiers396950
-Node: Installing Bash398352
-Node: Basic Installation399489
-Node: Compilers and Options402180
-Node: Compiling For Multiple Architectures402921
-Node: Installation Names404584
-Node: Specifying the System Type405402
-Node: Sharing Defaults406118
-Node: Operation Controls406791
-Node: Optional Features407749
-Node: Reporting Bugs418275
-Node: Major Differences From The Bourne Shell419469
-Node: GNU Free Documentation License436321
-Node: Indexes461498
-Node: Builtin Index461952
-Node: Reserved Word Index468779
-Node: Variable Index471227
-Node: Function Index486905
-Node: Concept Index500208
+Node: Lists23781
+Node: Compound Commands25520
+Node: Looping Constructs26532
+Node: Conditional Constructs29027
+Node: Command Grouping40082
+Node: Coprocesses41561
+Node: GNU Parallel43393
+Node: Shell Functions47366
+Node: Shell Parameters54565
+Node: Positional Parameters58978
+Node: Special Parameters59878
+Node: Shell Expansions63215
+Node: Brace Expansion65309
+Node: Tilde Expansion68143
+Node: Shell Parameter Expansion70491
+Node: Command Substitution84623
+Node: Arithmetic Expansion85978
+Node: Process Substitution86910
+Node: Word Splitting88030
+Node: Filename Expansion89974
+Node: Pattern Matching92348
+Node: Quote Removal96334
+Node: Redirections96629
+Node: Executing Commands106187
+Node: Simple Command Expansion106857
+Node: Command Search and Execution108787
+Node: Command Execution Environment111123
+Node: Environment114107
+Node: Exit Status115766
+Node: Signals117436
+Node: Shell Scripts119403
+Node: Shell Builtin Commands121918
+Node: Bourne Shell Builtins123952
+Node: Bash Builtins144552
+Node: Modifying Shell Behavior173197
+Node: The Set Builtin173542
+Node: The Shopt Builtin183955
+Node: Special Builtins199853
+Node: Shell Variables200832
+Node: Bourne Shell Variables201269
+Node: Bash Variables203373
+Node: Bash Features233166
+Node: Invoking Bash234065
+Node: Bash Startup Files240014
+Node: Interactive Shells245117
+Node: What is an Interactive Shell?245527
+Node: Is this Shell Interactive?246176
+Node: Interactive Shell Behavior246991
+Node: Bash Conditional Expressions250479
+Node: Shell Arithmetic254845
+Node: Aliases257662
+Node: Arrays260210
+Node: The Directory Stack265372
+Node: Directory Stack Builtins266156
+Node: Controlling the Prompt269124
+Node: The Restricted Shell271886
+Node: Bash POSIX Mode273711
+Node: Job Control284062
+Node: Job Control Basics284522
+Node: Job Control Builtins289490
+Node: Job Control Variables294217
+Node: Command Line Editing295373
+Node: Introduction and Notation297044
+Node: Readline Interaction298667
+Node: Readline Bare Essentials299858
+Node: Readline Movement Commands301641
+Node: Readline Killing Commands302601
+Node: Readline Arguments304519
+Node: Searching305563
+Node: Readline Init File307749
+Node: Readline Init File Syntax308896
+Node: Conditional Init Constructs329083
+Node: Sample Init File331608
+Node: Bindable Readline Commands334725
+Node: Commands For Moving335929
+Node: Commands For History337778
+Node: Commands For Text342073
+Node: Commands For Killing345462
+Node: Numeric Arguments347943
+Node: Commands For Completion349082
+Node: Keyboard Macros353273
+Node: Miscellaneous Commands353960
+Node: Readline vi Mode359836
+Node: Programmable Completion360743
+Node: Programmable Completion Builtins368204
+Node: A Programmable Completion Example378090
+Node: Using History Interactively383342
+Node: Bash History Facilities384026
+Node: Bash History Builtins387027
+Node: History Interaction391319
+Node: Event Designators394283
+Node: Word Designators395502
+Node: Modifiers397139
+Node: Installing Bash398541
+Node: Basic Installation399678
+Node: Compilers and Options402369
+Node: Compiling For Multiple Architectures403110
+Node: Installation Names404773
+Node: Specifying the System Type405591
+Node: Sharing Defaults406307
+Node: Operation Controls406980
+Node: Optional Features407938
+Node: Reporting Bugs418464
+Node: Major Differences From The Bourne Shell419658
+Node: GNU Free Documentation License436510
+Node: Indexes461687
+Node: Builtin Index462141
+Node: Reserved Word Index468968
+Node: Variable Index471416
+Node: Function Index487094
+Node: Concept Index500397
 
 End Tag Table

doc/bashref.log

@@ -1,4 +1,4 @@
-This is pdfTeX, Version 3.14159265-2.6-1.40.17 (TeX Live 2016/MacPorts 2016_4) (preloaded format=pdfetex 2017.1.6)  28 MAR 2017 14:25
+This is pdfTeX, Version 3.14159265-2.6-1.40.17 (TeX Live 2016/MacPorts 2016_4) (preloaded format=pdfetex 2017.1.6)  3 APR 2017 16:34
 entering extended mode
  restricted \write18 enabled.
  file:line:error style messages enabled.
@@ -185,7 +185,7 @@ p/pdftex/updmap/pdftex.map}] [2] (/Users/chet/src/bash/src/doc/bashref.toc
 \openout4 = `bashref.rw'.
 
  [8] [9] [10]
-Overfull \hbox (38.26587pt too wide) in paragraph at lines 874--874
+Overfull \hbox (38.26587pt too wide) in paragraph at lines 879--879
  []@texttt case @textttsl word @texttt in [ [(] @textttsl pat-tern @texttt [| @
 textttsl pattern@texttt ][]) @textttsl command-list @texttt ;;][] esac[] 
 
@@ -198,7 +198,7 @@ textttsl pattern@texttt ][]) @textttsl command-list @texttt ;;][] esac[]
 .etc.
 
 [11] [12] [13] [14] [15]
-Overfull \hbox (89.6747pt too wide) in paragraph at lines 1280--1280
+Overfull \hbox (89.6747pt too wide) in paragraph at lines 1285--1285
  []@texttt cat list | parallel "do-something1 {} config-{} ; do-something2 < {}
 " | process-output[] 
 
@@ -210,8 +210,8 @@ Overfull \hbox (89.6747pt too wide) in paragraph at lines 1280--1280
 .@texttt t
 .etc.
 
-
-Overfull \hbox (89.6747pt too wide) in paragraph at lines 1303--1303
+[16]
+Overfull \hbox (89.6747pt too wide) in paragraph at lines 1308--1308
  []@texttt { echo foss.org.my ; echo debian.org; echo freenetproject.org; } | p
 arallel traceroute[] 
 
@@ -223,8 +223,8 @@ arallel traceroute[]
 .@glue 5.74869
 .etc.
 
-[16]
-Overfull \hbox (106.92076pt too wide) in paragraph at lines 1309--1309
+
+Overfull \hbox (106.92076pt too wide) in paragraph at lines 1314--1314
  []@texttt { echo foss.org.my ; echo debian.org; echo freenetproject.org; } | p
 arallel -k traceroute[] 
 
@@ -243,7 +243,7 @@ arallel -k traceroute[]
 
  [43] [44]
 [45] [46] [47] [48] [49] [50] [51] [52] [53] [54] [55]
-Overfull \hbox (26.76846pt too wide) in paragraph at lines 4343--4343
+Overfull \hbox (26.76846pt too wide) in paragraph at lines 4348--4348
  []@texttt mapfile [-d @textttsl de-lim@texttt ] [-n @textttsl count@texttt ] [
 -O @textttsl ori-gin@texttt ] [-s @textttsl count@texttt ] [-t] [-u @textttsl f
 d@texttt ][] 
@@ -257,7 +257,7 @@ d@texttt ][]
 .etc.
 
 [56] [57]
-Overfull \hbox (38.26584pt too wide) in paragraph at lines 4547--4547
+Overfull \hbox (38.26584pt too wide) in paragraph at lines 4552--4552
  []@texttt readarray [-d @textttsl de-lim@texttt ] [-n @textttsl count@texttt ]
  [-O @textttsl ori-gin@texttt ] [-s @textttsl count@texttt ] [-t] [-u @textttsl
  fd@texttt ][] 
@@ -272,7 +272,7 @@ Overfull \hbox (38.26584pt too wide) in paragraph at lines 4547--4547
 
 [58] [59] [60] [61] [62] [63] [64] [65] [66] [67] [68] [69] [70] Chapter 5
 [71] [72] [73] [74] [75] [76] [77] [78] [79] [80] [81] [82] Chapter 6 [83]
-Overfull \hbox (49.43388pt too wide) in paragraph at lines 6294--6294
+Overfull \hbox (49.43388pt too wide) in paragraph at lines 6299--6299
  []@texttt bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@t
 exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
 
@@ -285,7 +285,7 @@ exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
 .etc.
 
 
-Overfull \hbox (72.42863pt too wide) in paragraph at lines 6295--6295
+Overfull \hbox (72.42863pt too wide) in paragraph at lines 6300--6300
  []@texttt bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@texttt 
 ] [-O @textttsl shopt_option@texttt ] -c @textttsl string @texttt [@textttsl ar
 -
@@ -299,7 +299,7 @@ Overfull \hbox (72.42863pt too wide) in paragraph at lines 6295--6295
 .etc.
 
 
-Overfull \hbox (32.18782pt too wide) in paragraph at lines 6296--6296
+Overfull \hbox (32.18782pt too wide) in paragraph at lines 6301--6301
  []@texttt bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@text
 tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
 
@@ -389,7 +389,7 @@ texinfo.tex: doing @include of fdl.texi
 Here is how much of TeX's memory you used:
  4064 strings out of 497105
  47069 string characters out of 6206776
- 136585 words of memory out of 5000000
+ 136513 words of memory out of 5000000
  4846 multiletter control sequences out of 15000+600000
  34315 words of font info for 116 fonts, out of 8000000 for 9000
  51 hyphenation exceptions out of 8191
@@ -411,10 +411,10 @@ e/fonts/type1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf-texlive/fon
 ts/type1/public/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texlive/fonts/typ
 e1/public/cm-super/sfrm1095.pfb></opt/local/share/texmf-texlive/fonts/type1/pub
 lic/cm-super/sfrm1440.pfb>
-Output written on bashref.pdf (182 pages, 742807 bytes).
+Output written on bashref.pdf (182 pages, 742837 bytes).
 PDF statistics:
- 2607 PDF objects out of 2984 (max. 8388607)
- 2380 compressed objects within 24 object streams
+ 2606 PDF objects out of 2984 (max. 8388607)
+ 2379 compressed objects within 24 object streams
  308 named destinations out of 1000 (max. 500000)
  1125 words of extra memory for PDF output out of 10000 (max. 10000000)
 

doc/bashref.rw

@@ -5,11 +5,11 @@
 \entry{done}{10}{\code {done}}
 \entry{while}{10}{\code {while}}
 \entry{for}{10}{\code {for}}
-\entry{if}{10}{\code {if}}
-\entry{then}{10}{\code {then}}
-\entry{else}{10}{\code {else}}
-\entry{elif}{10}{\code {elif}}
-\entry{fi}{10}{\code {fi}}
+\entry{if}{11}{\code {if}}
+\entry{then}{11}{\code {then}}
+\entry{else}{11}{\code {else}}
+\entry{elif}{11}{\code {elif}}
+\entry{fi}{11}{\code {fi}}
 \entry{case}{11}{\code {case}}
 \entry{in}{11}{\code {in}}
 \entry{esac}{11}{\code {esac}}

doc/bashref.rws

@@ -14,20 +14,20 @@
 \entry {\code {do}}{10}
 \entry {\code {done}}{10}
 \initial {E}
-\entry {\code {elif}}{10}
-\entry {\code {else}}{10}
+\entry {\code {elif}}{11}
+\entry {\code {else}}{11}
 \entry {\code {esac}}{11}
 \initial {F}
-\entry {\code {fi}}{10}
+\entry {\code {fi}}{11}
 \entry {\code {for}}{10}
 \entry {\code {function}}{17}
 \initial {I}
-\entry {\code {if}}{10}
+\entry {\code {if}}{11}
 \entry {\code {in}}{11}
 \initial {S}
 \entry {\code {select}}{12}
 \initial {T}
-\entry {\code {then}}{10}
+\entry {\code {then}}{11}
 \entry {\code {time}}{8}
 \initial {U}
 \entry {\code {until}}{10}

doc/bashref.texi

@@ -4360,6 +4360,8 @@ Options, if supplied, have the following meanings:
 @item -d
 The first character of @var{delim} is used to terminate each input line,
 rather than newline.
+If @var{delim} is the empty string, @code{read} will terminate a line
+when it reads a NUL character.
 @item -n
 Copy at most @var{count} lines.  If @var{count} is 0, all lines are copied.
 @item -O

doc/bashref.toc

@@ -18,10 +18,10 @@
 @numsubsecentry{Lists of Commands}{3.2.3}{Lists}{9}
 @numsubsecentry{Compound Commands}{3.2.4}{Compound Commands}{9}
 @numsubsubsecentry{Looping Constructs}{3.2.4.1}{Looping Constructs}{10}
-@numsubsubsecentry{Conditional Constructs}{3.2.4.2}{Conditional Constructs}{10}
+@numsubsubsecentry{Conditional Constructs}{3.2.4.2}{Conditional Constructs}{11}
 @numsubsubsecentry{Grouping Commands}{3.2.4.3}{Command Grouping}{14}
 @numsubsecentry{Coprocesses}{3.2.5}{Coprocesses}{15}
-@numsubsecentry{GNU Parallel}{3.2.6}{GNU Parallel}{15}
+@numsubsecentry{GNU Parallel}{3.2.6}{GNU Parallel}{16}
 @numsecentry{Shell Functions}{3.3}{Shell Functions}{17}
 @numsecentry{Shell Parameters}{3.4}{Shell Parameters}{19}
 @numsubsecentry{Positional Parameters}{3.4.1}{Positional Parameters}{20}
@@ -32,7 +32,7 @@
 @numsubsecentry{Shell Parameter Expansion}{3.5.3}{Shell Parameter Expansion}{24}
 @numsubsecentry{Command Substitution}{3.5.4}{Command Substitution}{30}
 @numsubsecentry{Arithmetic Expansion}{3.5.5}{Arithmetic Expansion}{30}
-@numsubsecentry{Process Substitution}{3.5.6}{Process Substitution}{30}
+@numsubsecentry{Process Substitution}{3.5.6}{Process Substitution}{31}
 @numsubsecentry{Word Splitting}{3.5.7}{Word Splitting}{31}
 @numsubsecentry{Filename Expansion}{3.5.8}{Filename Expansion}{31}
 @numsubsubsecentry{Pattern Matching}{3.5.8.1}{Pattern Matching}{32}
@@ -42,7 +42,7 @@
 @numsubsecentry{Redirecting Output}{3.6.2}{}{35}
 @numsubsecentry{Appending Redirected Output}{3.6.3}{}{35}
 @numsubsecentry{Redirecting Standard Output and Standard Error}{3.6.4}{}{35}
-@numsubsecentry{Appending Standard Output and Standard Error}{3.6.5}{}{35}
+@numsubsecentry{Appending Standard Output and Standard Error}{3.6.5}{}{36}
 @numsubsecentry{Here Documents}{3.6.6}{}{36}
 @numsubsecentry{Here Strings}{3.6.7}{}{36}
 @numsubsecentry{Duplicating File Descriptors}{3.6.8}{}{36}

doc/builtins.ps

@@ -1,6 +1,6 @@
 %!PS-Adobe-3.0
 %%Creator: groff version 1.22.3
-%%CreationDate: Wed Mar 22 16:11:15 2017
+%%CreationDate: Mon Apr  3 16:33:54 2017
 %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold
 %%+ font Times-Italic

doc/rbash.ps

@@ -1,6 +1,6 @@
 %!PS-Adobe-3.0
 %%Creator: groff version 1.22.3
-%%CreationDate: Wed Mar 22 16:11:15 2017
+%%CreationDate: Mon Apr  3 16:33:54 2017
 %%DocumentNeededResources: font Times-Roman
 %%+ font Times-Bold
 %%DocumentSuppliedResources: procset grops 1.22 3

doc/version.texi

@@ -2,10 +2,10 @@
 Copyright (C) 1988-2017 Free Software Foundation, Inc.
 @end ignore
 
-@set LASTCHANGE Wed Mar 22 16:10:53 EDT 2017
+@set LASTCHANGE Tue Apr  4 14:56:04 EDT 2017
 
 @set EDITION 4.4
 @set VERSION 4.4
 
-@set UPDATED 22 March 2017
-@set UPDATED-MONTH March 2017
+@set UPDATED 4 April 2017
+@set UPDATED-MONTH April 2017