commit bash-20201218 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, 29 October 2020).
+Bash shell (version 5.1, 21 December 2020).
 
-   This is Edition 5.1, last updated 29 October 2020, of 'The GNU Bash
+   This is Edition 5.1, last updated 21 December 2020, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.1.
 
    Copyright (C) 1988-2020 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, 29 October 2020).  The Bash home page is
+Bash shell (version 5.1, 21 December 2020).  The Bash home page is
 <http://www.gnu.org/software/bash/>.
 
-   This is Edition 5.1, last updated 29 October 2020, of 'The GNU Bash
+   This is Edition 5.1, last updated 21 December 2020, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.1.
 
    Bash contains features that appear in other popular shells, and some
@@ -5941,7 +5941,7 @@ several ways.
      string escape sequences.
 
   4. Bash executes the values of the set elements of the
-     'PROMPT_COMMANDS' array variable as commands before printing the
+     'PROMPT_COMMAND' array variable as commands before printing the
      primary prompt, '$PS1' (*note Bash Variables::).
 
   5. Readline (*note Command Line Editing::) is used to read commands
@@ -6523,9 +6523,9 @@ File: bashref.info,  Node: Controlling the Prompt,  Next: The Restricted Shell,
 6.9 Controlling the Prompt
 ==========================
 
-Bash examines the value of the array variable 'PROMPT_COMMANDS' just
+Bash examines the value of the array variable 'PROMPT_COMMAND' just
 before printing each primary prompt.  If any elements in
-'PROMPT_COMMANDS' are set and non-null, Bash executes each value, in
+'PROMPT_COMMAND' are set and non-null, Bash executes each value, in
 numeric order, just as if it had been typed on the command line.
 
    In addition, the following table describes the special characters
@@ -10135,16 +10135,20 @@ the Bash 'configure' recognizes.
      subdirectories of that directory (include files in PREFIX/'include'
      and the library in PREFIX/'lib').
 
-'--with-purify'
-     Define this to use the Purify memory allocation checker from
-     Rational Software.
+'--with-libintl-prefix[=PREFIX]'
+     Define this to make Bash link with a locally-installed version of
+     the libintl library instead ofthe version in 'lib/intl'.
+
+'--with-libiconv-prefix[=PREFIX]'
+     Define this to make Bash look for libiconv in PREFIX instead of the
+     standard system locations.  There is no version included with Bash.
 
 '--enable-minimal-config'
      This produces a shell with minimal features, close to the
      historical Bourne shell.
 
-   There are several '--enable-' options that alter how Bash is compiled
-and linked, rather than changing run-time features.
+   There are several '--enable-' options that alter how Bash is
+compiled, linked, and installed, rather than changing run-time features.
 
 '--enable-largefile'
      Enable support for large files
@@ -10157,6 +10161,10 @@ and linked, rather than changing run-time features.
      This builds a Bash binary that produces profiling information to be
      processed by 'gprof' each time it is executed.
 
+'--enable-separate-helpfiles'
+     Use external files for the documentation displayed by the 'help'
+     builtin instead of storing the text internally.
+
 '--enable-static-link'
      This causes Bash to be linked statically, if 'gcc' is being used.
      This could be used to build a version to use as root's shell.
@@ -10166,8 +10174,9 @@ following options, but it is processed first, so individual options may
 be enabled using 'enable-FEATURE'.
 
    All of the following options except for 'disabled-builtins',
-'direxpand-default', and 'xpg-echo-default' are enabled by default,
-unless the operating system does not provide the necessary support.
+'direxpand-default', 'strict-posix-default', and 'xpg-echo-default' are
+enabled by default, unless the operating system does not provide the
+necessary support.
 
 '--enable-alias'
      Allow alias expansion and include the 'alias' and 'unalias'
@@ -10314,10 +10323,6 @@ unless the operating system does not provide the necessary support.
      Include the 'select' compound command, which allows the generation
      of simple menus (*note Conditional Constructs::).
 
-'--enable-separate-helpfiles'
-     Use external files for the documentation displayed by the 'help'
-     builtin instead of storing the text internally.
-
 '--enable-single-help-strings'
      Store the text displayed by the 'help' builtin as a single string
      for each help topic.  This aids in translating the text to
@@ -11983,137 +11988,137 @@ D.5 Concept Index
 
 
 Tag Table:
-Node: Top895
-Node: Introduction2813
-Node: What is Bash?3029
-Node: What is a shell?4143
-Node: Definitions6681
-Node: Basic Shell Features9632
-Node: Shell Syntax10851
-Node: Shell Operation11877
-Node: Quoting13170
-Node: Escape Character14470
-Node: Single Quotes14955
-Node: Double Quotes15303
-Node: ANSI-C Quoting16581
-Node: Locale Translation17840
-Node: Comments18993
-Node: Shell Commands19611
-Node: Reserved Words20549
-Node: Simple Commands21305
-Node: Pipelines21959
-Node: Lists24891
-Node: Compound Commands26682
-Node: Looping Constructs27694
-Node: Conditional Constructs30189
-Node: Command Grouping41760
-Node: Coprocesses43239
-Node: GNU Parallel45142
-Node: Shell Functions49443
-Node: Shell Parameters56650
-Node: Positional Parameters61063
-Node: Special Parameters61963
-Node: Shell Expansions65187
-Node: Brace Expansion67310
-Node: Tilde Expansion70033
-Node: Shell Parameter Expansion72650
-Node: Command Substitution87779
-Node: Arithmetic Expansion89134
-Node: Process Substitution90066
-Node: Word Splitting91186
-Node: Filename Expansion93130
-Node: Pattern Matching95679
-Node: Quote Removal99665
-Node: Redirections99960
-Node: Executing Commands109530
-Node: Simple Command Expansion110200
-Node: Command Search and Execution112154
-Node: Command Execution Environment114530
-Node: Environment117514
-Node: Exit Status119173
-Node: Signals120843
-Node: Shell Scripts122810
-Node: Shell Builtin Commands125822
-Node: Bourne Shell Builtins127860
-Node: Bash Builtins148789
-Node: Modifying Shell Behavior178898
-Node: The Set Builtin179243
-Node: The Shopt Builtin189656
-Node: Special Builtins204566
-Node: Shell Variables205545
-Node: Bourne Shell Variables205982
-Node: Bash Variables208086
-Node: Bash Features240720
-Node: Invoking Bash241733
-Node: Bash Startup Files247746
-Node: Interactive Shells252849
-Node: What is an Interactive Shell?253259
-Node: Is this Shell Interactive?253908
-Node: Interactive Shell Behavior254723
-Node: Bash Conditional Expressions258237
-Node: Shell Arithmetic262814
-Node: Aliases265754
-Node: Arrays268374
-Node: The Directory Stack274383
-Node: Directory Stack Builtins275167
-Node: Controlling the Prompt278135
-Node: The Restricted Shell281085
-Node: Bash POSIX Mode283679
-Node: Shell Compatibility Mode294715
-Node: Job Control301371
-Node: Job Control Basics301831
-Node: Job Control Builtins306827
-Node: Job Control Variables312227
-Node: Command Line Editing313383
-Node: Introduction and Notation315054
-Node: Readline Interaction316677
-Node: Readline Bare Essentials317868
-Node: Readline Movement Commands319651
-Node: Readline Killing Commands320611
-Node: Readline Arguments322529
-Node: Searching323573
-Node: Readline Init File325759
-Node: Readline Init File Syntax327018
-Node: Conditional Init Constructs347556
-Node: Sample Init File351752
-Node: Bindable Readline Commands354876
-Node: Commands For Moving356080
-Node: Commands For History358131
-Node: Commands For Text362924
-Node: Commands For Killing366573
-Node: Numeric Arguments369606
-Node: Commands For Completion370745
-Node: Keyboard Macros374936
-Node: Miscellaneous Commands375623
-Node: Readline vi Mode381307
-Node: Programmable Completion382214
-Node: Programmable Completion Builtins389994
-Node: A Programmable Completion Example400689
-Node: Using History Interactively405936
-Node: Bash History Facilities406620
-Node: Bash History Builtins409625
-Node: History Interaction414354
-Node: Event Designators417974
-Node: Word Designators419328
-Node: Modifiers421088
-Node: Installing Bash422899
-Node: Basic Installation424036
-Node: Compilers and Options427294
-Node: Compiling For Multiple Architectures428035
-Node: Installation Names429728
-Node: Specifying the System Type430546
-Node: Sharing Defaults431262
-Node: Operation Controls431935
-Node: Optional Features432893
-Node: Reporting Bugs443411
-Node: Major Differences From The Bourne Shell444605
-Node: GNU Free Documentation License461457
-Node: Indexes486634
-Node: Builtin Index487088
-Node: Reserved Word Index493915
-Node: Variable Index496363
-Node: Function Index512260
-Node: Concept Index525770
+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 Character14474
+Node: Single Quotes14959
+Node: Double Quotes15307
+Node: ANSI-C Quoting16585
+Node: Locale Translation17844
+Node: Comments18997
+Node: Shell Commands19615
+Node: Reserved Words20553
+Node: Simple Commands21309
+Node: Pipelines21963
+Node: Lists24895
+Node: Compound Commands26686
+Node: Looping Constructs27698
+Node: Conditional Constructs30193
+Node: Command Grouping41764
+Node: Coprocesses43243
+Node: GNU Parallel45146
+Node: Shell Functions49447
+Node: Shell Parameters56654
+Node: Positional Parameters61067
+Node: Special Parameters61967
+Node: Shell Expansions65191
+Node: Brace Expansion67314
+Node: Tilde Expansion70037
+Node: Shell Parameter Expansion72654
+Node: Command Substitution87783
+Node: Arithmetic Expansion89138
+Node: Process Substitution90070
+Node: Word Splitting91190
+Node: Filename Expansion93134
+Node: Pattern Matching95683
+Node: Quote Removal99669
+Node: Redirections99964
+Node: Executing Commands109534
+Node: Simple Command Expansion110204
+Node: Command Search and Execution112158
+Node: Command Execution Environment114534
+Node: Environment117518
+Node: Exit Status119177
+Node: Signals120847
+Node: Shell Scripts122814
+Node: Shell Builtin Commands125826
+Node: Bourne Shell Builtins127864
+Node: Bash Builtins148793
+Node: Modifying Shell Behavior178902
+Node: The Set Builtin179247
+Node: The Shopt Builtin189660
+Node: Special Builtins204570
+Node: Shell Variables205549
+Node: Bourne Shell Variables205986
+Node: Bash Variables208090
+Node: Bash Features240724
+Node: Invoking Bash241737
+Node: Bash Startup Files247750
+Node: Interactive Shells252853
+Node: What is an Interactive Shell?253263
+Node: Is this Shell Interactive?253912
+Node: Interactive Shell Behavior254727
+Node: Bash Conditional Expressions258240
+Node: Shell Arithmetic262817
+Node: Aliases265757
+Node: Arrays268377
+Node: The Directory Stack274386
+Node: Directory Stack Builtins275170
+Node: Controlling the Prompt278138
+Node: The Restricted Shell281086
+Node: Bash POSIX Mode283680
+Node: Shell Compatibility Mode294716
+Node: Job Control301372
+Node: Job Control Basics301832
+Node: Job Control Builtins306828
+Node: Job Control Variables312228
+Node: Command Line Editing313384
+Node: Introduction and Notation315055
+Node: Readline Interaction316678
+Node: Readline Bare Essentials317869
+Node: Readline Movement Commands319652
+Node: Readline Killing Commands320612
+Node: Readline Arguments322530
+Node: Searching323574
+Node: Readline Init File325760
+Node: Readline Init File Syntax327019
+Node: Conditional Init Constructs347557
+Node: Sample Init File351753
+Node: Bindable Readline Commands354877
+Node: Commands For Moving356081
+Node: Commands For History358132
+Node: Commands For Text362925
+Node: Commands For Killing366574
+Node: Numeric Arguments369607
+Node: Commands For Completion370746
+Node: Keyboard Macros374937
+Node: Miscellaneous Commands375624
+Node: Readline vi Mode381308
+Node: Programmable Completion382215
+Node: Programmable Completion Builtins389995
+Node: A Programmable Completion Example400690
+Node: Using History Interactively405937
+Node: Bash History Facilities406621
+Node: Bash History Builtins409626
+Node: History Interaction414355
+Node: Event Designators417975
+Node: Word Designators419329
+Node: Modifiers421089
+Node: Installing Bash422900
+Node: Basic Installation424037
+Node: Compilers and Options427295
+Node: Compiling For Multiple Architectures428036
+Node: Installation Names429729
+Node: Specifying the System Type430547
+Node: Sharing Defaults431263
+Node: Operation Controls431936
+Node: Optional Features432894
+Node: Reporting Bugs443689
+Node: Major Differences From The Bourne Shell444883
+Node: GNU Free Documentation License461735
+Node: Indexes486912
+Node: Builtin Index487366
+Node: Reserved Word Index494193
+Node: Variable Index496641
+Node: Function Index512538
+Node: Concept Index526048
 
 End Tag Table