additional tests; documentation updates

doc/bashref.info

@@ -950,16 +950,16 @@ File: bashref.info,  Node: Conditional Constructs,  Next: Command Grouping,  Pre
           select NAME [in WORDS ...]; do COMMANDS; done
 
      The list of words following 'in' is expanded, generating a list of
-     items.  The set of expanded words is printed on the standard error
-     output stream, each preceded by a number.  If the 'in WORDS' is
-     omitted, the positional parameters are printed, as if 'in "$@"' had
-     been specified.  The 'PS3' prompt is then displayed and a line is
-     read from the standard input.  If the line consists of a number
-     corresponding to one of the displayed words, then the value of NAME
-     is set to that word.  If the line is empty, the words and prompt
-     are displayed again.  If 'EOF' is read, the 'select' command
-     completes.  Any other value read causes NAME to be set to null.
-     The line read is saved in the variable 'REPLY'.
+     items, and the set of expanded words is printed on the standard
+     error output stream, each preceded by a number.  If the 'in WORDS'
+     is omitted, the positional parameters are printed, as if 'in "$@"'
+     had been specified.  'select' then displays the 'PS3' prompt and
+     reads a line from the standard input.  If the line consists of a
+     number corresponding to one of the displayed words, then the value
+     of NAME is set to that word.  If the line is empty, the words and
+     prompt are displayed again.  If 'EOF' is read, the 'select' command
+     completes and returns 1.  Any other value read causes NAME to be
+     set to null.  The line read is saved in the variable 'REPLY'.
 
      The COMMANDS are executed after each selection until a 'break'
      command is executed, at which point the 'select' command completes.
@@ -7295,7 +7295,7 @@ be a temporary solution.
    This section does not mention behavior that is standard for a
 particular version (e.g., setting 'compat32' means that quoting the rhs
 of the regexp matching operator quotes special regexp characters in the
-word, which is default behavior in bash-3.2 and above).
+word, which is default behavior in bash-3.2 and subsequent versions).
 
    If a user enables, say, 'compat32', it may affect the behavior of
 other compatibility levels up to and including the current compatibility
@@ -7639,7 +7639,10 @@ File: bashref.info,  Node: Job Control Builtins,  Next: Job Control Variables,
      'wait' to wait for each PID or JOBSPEC to terminate before
      returning its status, intead of returning when it changes status.
      If neither JOBSPEC nor PID specifies an active child process of the
-     shell, the return status is 127.
+     shell, the return status is 127.  If 'wait' is interrupted by a
+     signal, the return status will be greater than 128, as described
+     above (*note Signals::).  Otherwise, the return status is the exit
+     status of the last process or job waited for.
 
 'disown'
           disown [-ar] [-h] [JOBSPEC ... | PID ... ]
@@ -9699,7 +9702,8 @@ happening.
 
      '-C COMMAND'
           COMMAND is executed in a subshell environment, and its output
-          is used as the possible completions.
+          is used as the possible completions.  Arguments are passed as
+          with the '-F' option.
 
      '-F FUNCTION'
           The shell function FUNCTION is executed in the current shell
@@ -11775,14 +11779,14 @@ D.1 Index of Shell Builtin Commands
 * complete:                              Programmable Completion Builtins.
                                                               (line  30)
 * compopt:                               Programmable Completion Builtins.
-                                                              (line 237)
+                                                              (line 238)
 * continue:                              Bourne Shell Builtins.
                                                               (line  89)
 * declare:                               Bash Builtins.       (line 154)
 * dirs:                                  Directory Stack Builtins.
                                                               (line   7)
 * disown:                                Job Control Builtins.
-                                                              (line 101)
+                                                              (line 104)
 * echo:                                  Bash Builtins.       (line 257)
 * enable:                                Bash Builtins.       (line 306)
 * eval:                                  Bourne Shell Builtins.
@@ -11831,7 +11835,7 @@ D.1 Index of Shell Builtin Commands
 * shopt:                                 The Shopt Builtin.   (line   9)
 * source:                                Bash Builtins.       (line 594)
 * suspend:                               Job Control Builtins.
-                                                              (line 113)
+                                                              (line 116)
 * test:                                  Bourne Shell Builtins.
                                                               (line 274)
 * times:                                 Bourne Shell Builtins.
@@ -12533,114 +12537,114 @@ Node: Lists29272
 Node: Compound Commands31067
 Node: Looping Constructs32079
 Node: Conditional Constructs34574
-Node: Command Grouping49041
-Node: Coprocesses50519
-Node: GNU Parallel53182
-Node: Shell Functions54099
-Node: Shell Parameters61984
-Node: Positional Parameters66372
-Node: Special Parameters67274
-Node: Shell Expansions70488
-Node: Brace Expansion72615
-Node: Tilde Expansion75349
-Node: Shell Parameter Expansion77970
-Node: Command Substitution96321
-Node: Arithmetic Expansion97676
-Node: Process Substitution98644
-Node: Word Splitting99764
-Node: Filename Expansion101708
-Node: Pattern Matching104457
-Node: Quote Removal109114
-Node: Redirections109409
-Node: Executing Commands119069
-Node: Simple Command Expansion119739
-Node: Command Search and Execution121849
-Node: Command Execution Environment124227
-Node: Environment127262
-Node: Exit Status128925
-Node: Signals130709
-Node: Shell Scripts134158
-Node: Shell Builtin Commands137185
-Node: Bourne Shell Builtins139223
-Node: Bash Builtins160684
-Node: Modifying Shell Behavior191540
-Node: The Set Builtin191885
-Node: The Shopt Builtin202486
-Node: Special Builtins218398
-Node: Shell Variables219377
-Node: Bourne Shell Variables219814
-Node: Bash Variables221918
-Node: Bash Features254734
-Node: Invoking Bash255747
-Node: Bash Startup Files261760
-Node: Interactive Shells266891
-Node: What is an Interactive Shell?267301
-Node: Is this Shell Interactive?267950
-Node: Interactive Shell Behavior268765
-Node: Bash Conditional Expressions272394
-Node: Shell Arithmetic277036
-Node: Aliases279980
-Node: Arrays282593
-Node: The Directory Stack288984
-Node: Directory Stack Builtins289768
-Node: Controlling the Prompt294028
-Node: The Restricted Shell296993
-Node: Bash POSIX Mode299603
-Node: Shell Compatibility Mode311527
-Node: Job Control319556
-Node: Job Control Basics320016
-Node: Job Control Builtins325018
-Node: Job Control Variables330588
-Node: Command Line Editing331744
-Node: Introduction and Notation333415
-Node: Readline Interaction335038
-Node: Readline Bare Essentials336229
-Node: Readline Movement Commands338012
-Node: Readline Killing Commands338972
-Node: Readline Arguments340890
-Node: Searching341934
-Node: Readline Init File344120
-Node: Readline Init File Syntax345381
-Node: Conditional Init Constructs368580
-Node: Sample Init File372776
-Node: Bindable Readline Commands375900
-Node: Commands For Moving377104
-Node: Commands For History379155
-Node: Commands For Text384149
-Node: Commands For Killing387798
-Node: Numeric Arguments390831
-Node: Commands For Completion391970
-Node: Keyboard Macros396161
-Node: Miscellaneous Commands396848
-Node: Readline vi Mode402787
-Node: Programmable Completion403694
-Node: Programmable Completion Builtins411474
-Node: A Programmable Completion Example422169
-Node: Using History Interactively427416
-Node: Bash History Facilities428100
-Node: Bash History Builtins431105
-Node: History Interaction436113
-Node: Event Designators439733
-Node: Word Designators441087
-Node: Modifiers442847
-Node: Installing Bash444658
-Node: Basic Installation445795
-Node: Compilers and Options449517
-Node: Compiling For Multiple Architectures450258
-Node: Installation Names451951
-Node: Specifying the System Type454060
-Node: Sharing Defaults454776
-Node: Operation Controls455449
-Node: Optional Features456407
-Node: Reporting Bugs467625
-Node: Major Differences From The Bourne Shell468900
-Node: GNU Free Documentation License485750
-Node: Indexes510927
-Node: Builtin Index511381
-Node: Reserved Word Index518208
-Node: Variable Index520656
-Node: Function Index537430
-Node: Concept Index551214
+Node: Command Grouping49062
+Node: Coprocesses50540
+Node: GNU Parallel53203
+Node: Shell Functions54120
+Node: Shell Parameters62005
+Node: Positional Parameters66393
+Node: Special Parameters67295
+Node: Shell Expansions70509
+Node: Brace Expansion72636
+Node: Tilde Expansion75370
+Node: Shell Parameter Expansion77991
+Node: Command Substitution96342
+Node: Arithmetic Expansion97697
+Node: Process Substitution98665
+Node: Word Splitting99785
+Node: Filename Expansion101729
+Node: Pattern Matching104478
+Node: Quote Removal109135
+Node: Redirections109430
+Node: Executing Commands119090
+Node: Simple Command Expansion119760
+Node: Command Search and Execution121870
+Node: Command Execution Environment124248
+Node: Environment127283
+Node: Exit Status128946
+Node: Signals130730
+Node: Shell Scripts134179
+Node: Shell Builtin Commands137206
+Node: Bourne Shell Builtins139244
+Node: Bash Builtins160705
+Node: Modifying Shell Behavior191561
+Node: The Set Builtin191906
+Node: The Shopt Builtin202507
+Node: Special Builtins218419
+Node: Shell Variables219398
+Node: Bourne Shell Variables219835
+Node: Bash Variables221939
+Node: Bash Features254755
+Node: Invoking Bash255768
+Node: Bash Startup Files261781
+Node: Interactive Shells266912
+Node: What is an Interactive Shell?267322
+Node: Is this Shell Interactive?267971
+Node: Interactive Shell Behavior268786
+Node: Bash Conditional Expressions272415
+Node: Shell Arithmetic277057
+Node: Aliases280001
+Node: Arrays282614
+Node: The Directory Stack289005
+Node: Directory Stack Builtins289789
+Node: Controlling the Prompt294049
+Node: The Restricted Shell297014
+Node: Bash POSIX Mode299624
+Node: Shell Compatibility Mode311548
+Node: Job Control319591
+Node: Job Control Basics320051
+Node: Job Control Builtins325053
+Node: Job Control Variables330847
+Node: Command Line Editing332003
+Node: Introduction and Notation333674
+Node: Readline Interaction335297
+Node: Readline Bare Essentials336488
+Node: Readline Movement Commands338271
+Node: Readline Killing Commands339231
+Node: Readline Arguments341149
+Node: Searching342193
+Node: Readline Init File344379
+Node: Readline Init File Syntax345640
+Node: Conditional Init Constructs368839
+Node: Sample Init File373035
+Node: Bindable Readline Commands376159
+Node: Commands For Moving377363
+Node: Commands For History379414
+Node: Commands For Text384408
+Node: Commands For Killing388057
+Node: Numeric Arguments391090
+Node: Commands For Completion392229
+Node: Keyboard Macros396420
+Node: Miscellaneous Commands397107
+Node: Readline vi Mode403046
+Node: Programmable Completion403953
+Node: Programmable Completion Builtins411733
+Node: A Programmable Completion Example422485
+Node: Using History Interactively427732
+Node: Bash History Facilities428416
+Node: Bash History Builtins431421
+Node: History Interaction436429
+Node: Event Designators440049
+Node: Word Designators441403
+Node: Modifiers443163
+Node: Installing Bash444974
+Node: Basic Installation446111
+Node: Compilers and Options449833
+Node: Compiling For Multiple Architectures450574
+Node: Installation Names452267
+Node: Specifying the System Type454376
+Node: Sharing Defaults455092
+Node: Operation Controls455765
+Node: Optional Features456723
+Node: Reporting Bugs467941
+Node: Major Differences From The Bourne Shell469216
+Node: GNU Free Documentation License486066
+Node: Indexes511243
+Node: Builtin Index511697
+Node: Reserved Word Index518524
+Node: Variable Index520972
+Node: Function Index537746
+Node: Concept Index551530
 
 End Tag Table