additional tests; documentation updates

doc/bash.info

@@ -949,16 +949,16 @@ File: bash.info,  Node: Conditional Constructs,  Next: Command Grouping,  Prev:
           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.
@@ -7294,7 +7294,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
@@ -7638,7 +7638,10 @@ File: bash.info,  Node: Job Control Builtins,  Next: Job Control Variables,  Pre
      '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 ... ]
@@ -9698,7 +9701,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
@@ -11774,14 +11778,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.
@@ -11830,7 +11834,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.
@@ -12532,114 +12536,114 @@ Node: Lists29209
 Node: Compound Commands31001
 Node: Looping Constructs32010
 Node: Conditional Constructs34502
-Node: Command Grouping48966
-Node: Coprocesses50441
-Node: GNU Parallel53101
-Node: Shell Functions54015
-Node: Shell Parameters61897
-Node: Positional Parameters66282
-Node: Special Parameters67181
-Node: Shell Expansions70392
-Node: Brace Expansion72516
-Node: Tilde Expansion75247
-Node: Shell Parameter Expansion77865
-Node: Command Substitution96213
-Node: Arithmetic Expansion97565
-Node: Process Substitution98530
-Node: Word Splitting99647
-Node: Filename Expansion101588
-Node: Pattern Matching104334
-Node: Quote Removal108988
-Node: Redirections109280
-Node: Executing Commands118937
-Node: Simple Command Expansion119604
-Node: Command Search and Execution121711
-Node: Command Execution Environment124086
-Node: Environment127118
-Node: Exit Status128778
-Node: Signals130559
-Node: Shell Scripts134005
-Node: Shell Builtin Commands137029
-Node: Bourne Shell Builtins139064
-Node: Bash Builtins160522
-Node: Modifying Shell Behavior191375
-Node: The Set Builtin191717
-Node: The Shopt Builtin202315
-Node: Special Builtins218224
-Node: Shell Variables219200
-Node: Bourne Shell Variables219634
-Node: Bash Variables221735
-Node: Bash Features254548
-Node: Invoking Bash255558
-Node: Bash Startup Files261568
-Node: Interactive Shells266696
-Node: What is an Interactive Shell?267103
-Node: Is this Shell Interactive?267749
-Node: Interactive Shell Behavior268561
-Node: Bash Conditional Expressions272187
-Node: Shell Arithmetic276826
-Node: Aliases279767
-Node: Arrays282377
-Node: The Directory Stack288765
-Node: Directory Stack Builtins289546
-Node: Controlling the Prompt293803
-Node: The Restricted Shell296765
-Node: Bash POSIX Mode299372
-Node: Shell Compatibility Mode311293
-Node: Job Control319319
-Node: Job Control Basics319776
-Node: Job Control Builtins324775
-Node: Job Control Variables330342
-Node: Command Line Editing331495
-Node: Introduction and Notation333163
-Node: Readline Interaction334783
-Node: Readline Bare Essentials335971
-Node: Readline Movement Commands337751
-Node: Readline Killing Commands338708
-Node: Readline Arguments340623
-Node: Searching341664
-Node: Readline Init File343847
-Node: Readline Init File Syntax345105
-Node: Conditional Init Constructs368301
-Node: Sample Init File372494
-Node: Bindable Readline Commands375615
-Node: Commands For Moving376816
-Node: Commands For History378864
-Node: Commands For Text383855
-Node: Commands For Killing387501
-Node: Numeric Arguments390531
-Node: Commands For Completion391667
-Node: Keyboard Macros395855
-Node: Miscellaneous Commands396539
-Node: Readline vi Mode402475
-Node: Programmable Completion403379
-Node: Programmable Completion Builtins411156
-Node: A Programmable Completion Example421848
-Node: Using History Interactively427092
-Node: Bash History Facilities427773
-Node: Bash History Builtins430775
-Node: History Interaction435780
-Node: Event Designators439397
-Node: Word Designators440748
-Node: Modifiers442505
-Node: Installing Bash444313
-Node: Basic Installation445447
-Node: Compilers and Options449166
-Node: Compiling For Multiple Architectures449904
-Node: Installation Names451594
-Node: Specifying the System Type453700
-Node: Sharing Defaults454413
-Node: Operation Controls455083
-Node: Optional Features456038
-Node: Reporting Bugs467253
-Node: Major Differences From The Bourne Shell468525
-Node: GNU Free Documentation License485372
-Node: Indexes510546
-Node: Builtin Index510997
-Node: Reserved Word Index517821
-Node: Variable Index520266
-Node: Function Index537037
-Node: Concept Index550818
+Node: Command Grouping48987
+Node: Coprocesses50462
+Node: GNU Parallel53122
+Node: Shell Functions54036
+Node: Shell Parameters61918
+Node: Positional Parameters66303
+Node: Special Parameters67202
+Node: Shell Expansions70413
+Node: Brace Expansion72537
+Node: Tilde Expansion75268
+Node: Shell Parameter Expansion77886
+Node: Command Substitution96234
+Node: Arithmetic Expansion97586
+Node: Process Substitution98551
+Node: Word Splitting99668
+Node: Filename Expansion101609
+Node: Pattern Matching104355
+Node: Quote Removal109009
+Node: Redirections109301
+Node: Executing Commands118958
+Node: Simple Command Expansion119625
+Node: Command Search and Execution121732
+Node: Command Execution Environment124107
+Node: Environment127139
+Node: Exit Status128799
+Node: Signals130580
+Node: Shell Scripts134026
+Node: Shell Builtin Commands137050
+Node: Bourne Shell Builtins139085
+Node: Bash Builtins160543
+Node: Modifying Shell Behavior191396
+Node: The Set Builtin191738
+Node: The Shopt Builtin202336
+Node: Special Builtins218245
+Node: Shell Variables219221
+Node: Bourne Shell Variables219655
+Node: Bash Variables221756
+Node: Bash Features254569
+Node: Invoking Bash255579
+Node: Bash Startup Files261589
+Node: Interactive Shells266717
+Node: What is an Interactive Shell?267124
+Node: Is this Shell Interactive?267770
+Node: Interactive Shell Behavior268582
+Node: Bash Conditional Expressions272208
+Node: Shell Arithmetic276847
+Node: Aliases279788
+Node: Arrays282398
+Node: The Directory Stack288786
+Node: Directory Stack Builtins289567
+Node: Controlling the Prompt293824
+Node: The Restricted Shell296786
+Node: Bash POSIX Mode299393
+Node: Shell Compatibility Mode311314
+Node: Job Control319354
+Node: Job Control Basics319811
+Node: Job Control Builtins324810
+Node: Job Control Variables330601
+Node: Command Line Editing331754
+Node: Introduction and Notation333422
+Node: Readline Interaction335042
+Node: Readline Bare Essentials336230
+Node: Readline Movement Commands338010
+Node: Readline Killing Commands338967
+Node: Readline Arguments340882
+Node: Searching341923
+Node: Readline Init File344106
+Node: Readline Init File Syntax345364
+Node: Conditional Init Constructs368560
+Node: Sample Init File372753
+Node: Bindable Readline Commands375874
+Node: Commands For Moving377075
+Node: Commands For History379123
+Node: Commands For Text384114
+Node: Commands For Killing387760
+Node: Numeric Arguments390790
+Node: Commands For Completion391926
+Node: Keyboard Macros396114
+Node: Miscellaneous Commands396798
+Node: Readline vi Mode402734
+Node: Programmable Completion403638
+Node: Programmable Completion Builtins411415
+Node: A Programmable Completion Example422164
+Node: Using History Interactively427408
+Node: Bash History Facilities428089
+Node: Bash History Builtins431091
+Node: History Interaction436096
+Node: Event Designators439713
+Node: Word Designators441064
+Node: Modifiers442821
+Node: Installing Bash444629
+Node: Basic Installation445763
+Node: Compilers and Options449482
+Node: Compiling For Multiple Architectures450220
+Node: Installation Names451910
+Node: Specifying the System Type454016
+Node: Sharing Defaults454729
+Node: Operation Controls455399
+Node: Optional Features456354
+Node: Reporting Bugs467569
+Node: Major Differences From The Bourne Shell468841
+Node: GNU Free Documentation License485688
+Node: Indexes510862
+Node: Builtin Index511313
+Node: Reserved Word Index518137
+Node: Variable Index520582
+Node: Function Index537353
+Node: Concept Index551134
 
 End Tag Table