commit bash-20210305 snapshot

doc/bashref.info

@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 6.7 from
 bashref.texi.
 
 This text is a brief description of the features that are present in the
-Bash shell (version 5.1, 4 March2021).
+Bash shell (version 5.1, 28 February 2021).
 
-   This is Edition 5.1, last updated 4 March2021, of 'The GNU Bash
+   This is Edition 5.1, last updated 28 February 2021, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.1.
 
    Copyright (C) 1988-2021 Free Software Foundation, Inc.
@@ -27,10 +27,10 @@ Bash Features
 *************
 
 This text is a brief description of the features that are present in the
-Bash shell (version 5.1, 4 March2021).  The Bash home page is
+Bash shell (version 5.1, 28 February 2021).  The Bash home page is
 <http://www.gnu.org/software/bash/>.
 
-   This is Edition 5.1, last updated 4 March2021, of 'The GNU Bash
+   This is Edition 5.1, last updated 28 February 2021, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.1.
 
    Bash contains features that appear in other popular shells, and some
@@ -1059,7 +1059,6 @@ had been terminated with the '&' control operator, with a two-way pipe
 established between the executing shell and the coprocess.
 
    The syntax for a coprocess is:
-
      coproc [NAME] COMMAND [REDIRECTIONS]
 
 This creates a coprocess named NAME.  COMMAND may be either a simple
@@ -1067,26 +1066,12 @@ command (*note Simple Commands::) or a compound command (*note Compound
 Commands::).  NAME is a shell variable name.  If NAME is not supplied,
 the default name is 'COPROC'.
 
-   The recommended form to use for a coprocess is
-
-     coproc NAME { COMMAND; }
-
-This form is recommended because simple commands result in the coprocess
-always being named 'COPROC', and it is simpler to use and more complete
-than the other compound commands.
-
-   There are other forms of coprocesses:
-
-     coproc NAME COMPOUND-COMMAND
-     coproc COMPOUND-COMMAND
-     coproc SIMPLE-COMMAND
-
-If COMMAND is a compound command, NAME is optional.  The word following
-'coproc' determines whether that word is interpreted as a variable name:
-it is interpreted as NAME if it is not a reserved word that introduces a
-compound command.  If COMMAND is a simple command, NAME is not allowed;
-this is to avoid confusion between NAME and the first word of the simple
-command.
+   If COMMAND is a compound command, NAME is optional.  The word
+following 'coproc' determines whether that word is interpreted as a
+variable name: it is interpreted as NAME if it is not a reserved word
+that introduces a compound command.  If COMMAND is a simple command,
+NAME is not allowed; this is to avoid confusion between NAME and the
+first word of the simple command.
 
    When the coprocess is executed, the shell creates an array variable
 (*note Arrays::) named NAME in the context of the executing shell.  The
@@ -12022,137 +12007,137 @@ D.5 Concept Index
 
 
 Tag Table:
-Node: Top887
-Node: Introduction2797
-Node: What is Bash?3013
-Node: What is a shell?4127
-Node: Definitions6665
-Node: Basic Shell Features9616
-Node: Shell Syntax10835
-Node: Shell Operation11861
-Node: Quoting13154
-Node: Escape Character14458
-Node: Single Quotes14943
-Node: Double Quotes15291
-Node: ANSI-C Quoting16569
-Node: Locale Translation17826
-Node: Comments18981
-Node: Shell Commands19599
-Node: Reserved Words20537
-Node: Simple Commands21293
-Node: Pipelines21947
-Node: Lists24904
-Node: Compound Commands26699
-Node: Looping Constructs27711
-Node: Conditional Constructs30206
-Node: Command Grouping41777
-Node: Coprocesses43252
-Node: GNU Parallel45915
-Node: Shell Functions50216
-Node: Shell Parameters57436
-Node: Positional Parameters61869
-Node: Special Parameters62771
-Node: Shell Expansions65995
-Node: Brace Expansion68122
-Node: Tilde Expansion70847
-Node: Shell Parameter Expansion73468
-Node: Command Substitution88597
-Node: Arithmetic Expansion89952
-Node: Process Substitution90884
-Node: Word Splitting92004
-Node: Filename Expansion93948
-Node: Pattern Matching96497
-Node: Quote Removal100487
-Node: Redirections100782
-Node: Executing Commands110356
-Node: Simple Command Expansion111026
-Node: Command Search and Execution112980
-Node: Command Execution Environment115358
-Node: Environment118344
-Node: Exit Status120007
-Node: Signals121679
-Node: Shell Scripts123646
-Node: Shell Builtin Commands126658
-Node: Bourne Shell Builtins128696
-Node: Bash Builtins149627
-Node: Modifying Shell Behavior179777
-Node: The Set Builtin180122
-Node: The Shopt Builtin190535
-Node: Special Builtins205447
-Node: Shell Variables206426
-Node: Bourne Shell Variables206863
-Node: Bash Variables208967
-Node: Bash Features241625
-Node: Invoking Bash242638
-Node: Bash Startup Files248651
-Node: Interactive Shells253754
-Node: What is an Interactive Shell?254164
-Node: Is this Shell Interactive?254813
-Node: Interactive Shell Behavior255628
-Node: Bash Conditional Expressions259141
-Node: Shell Arithmetic263718
-Node: Aliases266662
-Node: Arrays269275
-Node: The Directory Stack275284
-Node: Directory Stack Builtins276068
-Node: Controlling the Prompt279036
-Node: The Restricted Shell281984
-Node: Bash POSIX Mode284578
-Node: Shell Compatibility Mode295851
-Node: Job Control302507
-Node: Job Control Basics302967
-Node: Job Control Builtins307969
-Node: Job Control Variables313369
-Node: Command Line Editing314525
-Node: Introduction and Notation316196
-Node: Readline Interaction317819
-Node: Readline Bare Essentials319010
-Node: Readline Movement Commands320793
-Node: Readline Killing Commands321753
-Node: Readline Arguments323671
-Node: Searching324715
-Node: Readline Init File326901
-Node: Readline Init File Syntax328160
-Node: Conditional Init Constructs348698
-Node: Sample Init File352894
-Node: Bindable Readline Commands356018
-Node: Commands For Moving357222
-Node: Commands For History359273
-Node: Commands For Text364066
-Node: Commands For Killing367715
-Node: Numeric Arguments370748
-Node: Commands For Completion371887
-Node: Keyboard Macros376078
-Node: Miscellaneous Commands376765
-Node: Readline vi Mode382449
-Node: Programmable Completion383356
-Node: Programmable Completion Builtins391136
-Node: A Programmable Completion Example401831
-Node: Using History Interactively407078
-Node: Bash History Facilities407762
-Node: Bash History Builtins410767
-Node: History Interaction415775
-Node: Event Designators419395
-Node: Word Designators420749
-Node: Modifiers422509
-Node: Installing Bash424320
-Node: Basic Installation425457
-Node: Compilers and Options428715
-Node: Compiling For Multiple Architectures429456
-Node: Installation Names431149
-Node: Specifying the System Type431967
-Node: Sharing Defaults432683
-Node: Operation Controls433356
-Node: Optional Features434314
-Node: Reporting Bugs445114
-Node: Major Differences From The Bourne Shell446308
-Node: GNU Free Documentation License463158
-Node: Indexes488335
-Node: Builtin Index488789
-Node: Reserved Word Index495616
-Node: Variable Index498064
-Node: Function Index513961
-Node: Concept Index527471
+Node: Top897
+Node: Introduction2817
+Node: What is Bash?3033
+Node: What is a shell?4147
+Node: Definitions6685
+Node: Basic Shell Features9636
+Node: Shell Syntax10855
+Node: Shell Operation11881
+Node: Quoting13174
+Node: Escape Character14478
+Node: Single Quotes14963
+Node: Double Quotes15311
+Node: ANSI-C Quoting16589
+Node: Locale Translation17846
+Node: Comments19001
+Node: Shell Commands19619
+Node: Reserved Words20557
+Node: Simple Commands21313
+Node: Pipelines21967
+Node: Lists24924
+Node: Compound Commands26719
+Node: Looping Constructs27731
+Node: Conditional Constructs30226
+Node: Command Grouping41797
+Node: Coprocesses43272
+Node: GNU Parallel45542
+Node: Shell Functions49843
+Node: Shell Parameters57063
+Node: Positional Parameters61496
+Node: Special Parameters62398
+Node: Shell Expansions65622
+Node: Brace Expansion67749
+Node: Tilde Expansion70474
+Node: Shell Parameter Expansion73095
+Node: Command Substitution88224
+Node: Arithmetic Expansion89579
+Node: Process Substitution90511
+Node: Word Splitting91631
+Node: Filename Expansion93575
+Node: Pattern Matching96124
+Node: Quote Removal100114
+Node: Redirections100409
+Node: Executing Commands109983
+Node: Simple Command Expansion110653
+Node: Command Search and Execution112607
+Node: Command Execution Environment114985
+Node: Environment117971
+Node: Exit Status119634
+Node: Signals121306
+Node: Shell Scripts123273
+Node: Shell Builtin Commands126285
+Node: Bourne Shell Builtins128323
+Node: Bash Builtins149254
+Node: Modifying Shell Behavior179404
+Node: The Set Builtin179749
+Node: The Shopt Builtin190162
+Node: Special Builtins205074
+Node: Shell Variables206053
+Node: Bourne Shell Variables206490
+Node: Bash Variables208594
+Node: Bash Features241252
+Node: Invoking Bash242265
+Node: Bash Startup Files248278
+Node: Interactive Shells253381
+Node: What is an Interactive Shell?253791
+Node: Is this Shell Interactive?254440
+Node: Interactive Shell Behavior255255
+Node: Bash Conditional Expressions258768
+Node: Shell Arithmetic263345
+Node: Aliases266289
+Node: Arrays268902
+Node: The Directory Stack274911
+Node: Directory Stack Builtins275695
+Node: Controlling the Prompt278663
+Node: The Restricted Shell281611
+Node: Bash POSIX Mode284205
+Node: Shell Compatibility Mode295478
+Node: Job Control302134
+Node: Job Control Basics302594
+Node: Job Control Builtins307596
+Node: Job Control Variables312996
+Node: Command Line Editing314152
+Node: Introduction and Notation315823
+Node: Readline Interaction317446
+Node: Readline Bare Essentials318637
+Node: Readline Movement Commands320420
+Node: Readline Killing Commands321380
+Node: Readline Arguments323298
+Node: Searching324342
+Node: Readline Init File326528
+Node: Readline Init File Syntax327787
+Node: Conditional Init Constructs348325
+Node: Sample Init File352521
+Node: Bindable Readline Commands355645
+Node: Commands For Moving356849
+Node: Commands For History358900
+Node: Commands For Text363693
+Node: Commands For Killing367342
+Node: Numeric Arguments370375
+Node: Commands For Completion371514
+Node: Keyboard Macros375705
+Node: Miscellaneous Commands376392
+Node: Readline vi Mode382076
+Node: Programmable Completion382983
+Node: Programmable Completion Builtins390763
+Node: A Programmable Completion Example401458
+Node: Using History Interactively406705
+Node: Bash History Facilities407389
+Node: Bash History Builtins410394
+Node: History Interaction415402
+Node: Event Designators419022
+Node: Word Designators420376
+Node: Modifiers422136
+Node: Installing Bash423947
+Node: Basic Installation425084
+Node: Compilers and Options428342
+Node: Compiling For Multiple Architectures429083
+Node: Installation Names430776
+Node: Specifying the System Type431594
+Node: Sharing Defaults432310
+Node: Operation Controls432983
+Node: Optional Features433941
+Node: Reporting Bugs444741
+Node: Major Differences From The Bourne Shell445935
+Node: GNU Free Documentation License462785
+Node: Indexes487962
+Node: Builtin Index488416
+Node: Reserved Word Index495243
+Node: Variable Index497691
+Node: Function Index513588
+Node: Concept Index527098
 
 End Tag Table