commit bash-snap-20170626 snapshot

2026-08-04 01:08:19 +02:00 · 2017-06-26 09:29:20 -04:00
parent a930c746a8
commit 68d220cb05
20 changed files with 7370 additions and 7239 deletions
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 6.3 from
 bashref.texi.

 This text is a brief description of the features that are present in the
-Bash shell (version 4.4, 22 March 2017).
+Bash shell (version 4.4, 23 June 2017).

-   This is Edition 4.4, last updated 22 March 2017, of 'The GNU Bash
+   This is Edition 4.4, last updated 23 June 2017, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 4.4.

   Copyright (C) 1988-2017 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 4.4, 22 March 2017).  The Bash home page is
+Bash shell (version 4.4, 23 June 2017).  The Bash home page is
 <http://www.gnu.org/software/bash/>.

-   This is Edition 4.4, last updated 22 March 2017, of 'The GNU Bash
+   This is Edition 4.4, last updated 23 June 2017, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 4.4.

   Bash contains features that appear in other popular shells, and some
@@ -1127,7 +1127,7 @@ first.
   Finally, Parallel can be used to run a sequence of shell commands in
 parallel, similar to 'cat file | bash'.  It is not uncommon to take a
 list of filenames, create a series of shell commands to operate on them,
-and feed that list of commnds to a shell.  Parallel can speed this up.
+and feed that list of commands to a shell.  Parallel can speed this up.
 Assuming that 'file' contains a list of shell commands, one per line,

     parallel -j 10 < file
@@ -1503,10 +1503,10 @@ original word are removed unless they have been quoted themselves (QUOTE
 REMOVAL).

   Only brace expansion, word splitting, and filename expansion can
-change the number of words of the expansion; other expansions expand a
+increase the number of words of the expansion; other expansions expand a
 single word to a single word.  The only exceptions to this are the
-expansions of '"$@"' (*note Special Parameters::) and '"${NAME[@]}"'
-(*note Arrays::).
+expansions of '"$@"' and '$*' (*note Special Parameters::), and
+'"${NAME[@]}"' and '${NAME[*]}' (*note Arrays::).

   After all expansions, 'quote removal' (*note Quote Removal::) is
 performed.
@@ -3665,7 +3665,8 @@ standard.

     '-d'
          The first character of DELIM is used to terminate each input
-          line, rather than newline.
+          line, rather than newline.  If DELIM is the empty string,
+          'mapfile' will terminate a line when it reads a NUL character.
     '-n'
          Copy at most COUNT lines.  If COUNT is 0, all lines are
          copied.
@@ -3777,12 +3778,14 @@ standard.

     '-d DELIM'
          The first character of DELIM is used to terminate the input
-          line, rather than newline.
+          line, rather than newline.  If DELIM is the empty string,
+          'read' will terminate a line when it reads a NUL character.

     '-e'
          Readline (*note Command Line Editing::) is used to obtain the
          line.  Readline uses the current (or default, if line editing
-          was not previously active) editing settings.
+          was not previously active) editing settings, but uses
+          Readline's default filename completion.

     '-i TEXT'
          If Readline is being used to read the line, TEXT is placed
@@ -4366,13 +4369,16 @@ This builtin allows you to change additional shell optional behavior.
          are stopped.

     'checkwinsize'
-          If set, Bash checks the window size after each command and, if
-          necessary, updates the values of 'LINES' and 'COLUMNS'.
+          If set, Bash checks the window size after each external
+          (non-builtin) command and, if necessary, updates the values of
+          'LINES' and 'COLUMNS'.

     'cmdhist'
          If set, Bash attempts to save all lines of a multiple-line
          command in the same history entry.  This allows easy
-          re-editing of multi-line commands.
+          re-editing of multi-line commands.  This option is enabled by
+          default, but only has an effect if command history is enabled
+          (*note Bash History Facilities::).

     'compat31'
          If set, Bash changes its behavior to that of version 3.1 with
@@ -4579,6 +4585,12 @@ This builtin allows you to change additional shell optional behavior.
          commands are saved to the history with embedded newlines
          rather than using semicolon separators where possible.

+     'localvar_inherit'
+          If set, local variables inherit the value and attributes of a
+          variable of the same name that exists at a previous scope
+          before any new value is assigned.  The NAMEREF attribute is
+          not inherited.
+
     'login_shell'
          The shell sets this option if it is started as a login shell
          (*note Invoking Bash::).  The value may not be changed.
@@ -8893,10 +8905,9 @@ function and bind it to a particular command using 'complete -F'.

   The following function provides completions for the 'cd' builtin.  It
 is a reasonably good example of what shell functions must do when used
-for completion.  This function uses the word passsed as '$2' to
-determine the directory name to complete.  You can also use the
-'COMP_WORDS' array variable; the current word is indexed by the
-'COMP_CWORD' variable.
+for completion.  This function uses the word passed as '$2' to determine
+the directory name to complete.  You can also use the 'COMP_WORDS' array
+variable; the current word is indexed by the 'COMP_CWORD' variable.

   The function relies on the 'complete' and 'compgen' builtins to do
 much of the work, adding only the things that the Bash 'cd' does beyond
@@ -10826,13 +10837,13 @@ D.1 Index of Shell Builtin Commands
 * mapfile:                               Bash Builtins.       (line 369)
 * popd:                                  Directory Stack Builtins.
                                                              (line  35)
-* printf:                                Bash Builtins.       (line 414)
+* printf:                                Bash Builtins.       (line 415)
 * pushd:                                 Directory Stack Builtins.
                                                              (line  53)
 * pwd:                                   Bourne Shell Builtins.
                                                              (line 205)
-* read:                                  Bash Builtins.       (line 458)
-* readarray:                             Bash Builtins.       (line 550)
+* read:                                  Bash Builtins.       (line 459)
+* readarray:                             Bash Builtins.       (line 553)
 * readonly:                              Bourne Shell Builtins.
                                                              (line 215)
 * return:                                Bourne Shell Builtins.
@@ -10841,7 +10852,7 @@ D.1 Index of Shell Builtin Commands
 * shift:                                 Bourne Shell Builtins.
                                                              (line 255)
 * shopt:                                 The Shopt Builtin.   (line   9)
-* source:                                Bash Builtins.       (line 559)
+* source:                                Bash Builtins.       (line 562)
 * suspend:                               Job Control Builtins.
                                                              (line 104)
 * test:                                  Bourne Shell Builtins.
@@ -10850,12 +10861,12 @@ D.1 Index of Shell Builtin Commands
                                                              (line 343)
 * trap:                                  Bourne Shell Builtins.
                                                              (line 349)
-* type:                                  Bash Builtins.       (line 564)
-* typeset:                               Bash Builtins.       (line 596)
-* ulimit:                                Bash Builtins.       (line 602)
+* type:                                  Bash Builtins.       (line 567)
+* typeset:                               Bash Builtins.       (line 599)
+* ulimit:                                Bash Builtins.       (line 605)
 * umask:                                 Bourne Shell Builtins.
                                                              (line 398)
-* unalias:                               Bash Builtins.       (line 701)
+* unalias:                               Bash Builtins.       (line 704)
 * unset:                                 Bourne Shell Builtins.
                                                              (line 416)
 * wait:                                  Job Control Builtins.
@@ -11412,7 +11423,7 @@ D.5 Concept Index
 * history list:                          Bash History Facilities.
                                                              (line   6)
 * History, how to use:                   A Programmable Completion Example.
-                                                              (line 114)
+                                                              (line 113)
 * identifier:                            Definitions.         (line  51)
 * initialization file, readline:         Readline Init File.  (line   6)
 * installation:                          Basic Installation.  (line   6)
@@ -11490,134 +11501,134 @@ D.5 Concept Index


 Tag Table:
-Node: Top891
-Node: Introduction2805
-Node: What is Bash?3021
-Node: What is a shell?4135
-Node: Definitions6673
-Node: Basic Shell Features9624
-Node: Shell Syntax10843
-Node: Shell Operation11869
-Node: Quoting13162
-Node: Escape Character14462
-Node: Single Quotes14947
-Node: Double Quotes15295
-Node: ANSI-C Quoting16573
-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
+Node: Top889
+Node: Introduction2801
+Node: What is Bash?3017
+Node: What is a shell?4131
+Node: Definitions6669
+Node: Basic Shell Features9620
+Node: Shell Syntax10839
+Node: Shell Operation11865
+Node: Quoting13158
+Node: Escape Character14458
+Node: Single Quotes14943
+Node: Double Quotes15291
+Node: ANSI-C Quoting16569
+Node: Locale Translation17828
+Node: Comments18724
+Node: Shell Commands19342
+Node: Simple Commands20214
+Node: Pipelines20845
+Node: Lists23777
+Node: Compound Commands25516
+Node: Looping Constructs26528
+Node: Conditional Constructs29023
+Node: Command Grouping40078
+Node: Coprocesses41557
+Node: GNU Parallel43389
+Node: Shell Functions47363
+Node: Shell Parameters54562
+Node: Positional Parameters58975
+Node: Special Parameters59875
+Node: Shell Expansions63212
+Node: Brace Expansion65335
+Node: Tilde Expansion68169
+Node: Shell Parameter Expansion70517
+Node: Command Substitution84649
+Node: Arithmetic Expansion86004
+Node: Process Substitution86936
+Node: Word Splitting88056
+Node: Filename Expansion90000
+Node: Pattern Matching92374
+Node: Quote Removal96360
+Node: Redirections96655
+Node: Executing Commands106213
+Node: Simple Command Expansion106883
+Node: Command Search and Execution108813
+Node: Command Execution Environment111149
+Node: Environment114133
+Node: Exit Status115792
+Node: Signals117462
+Node: Shell Scripts119429
+Node: Shell Builtin Commands121944
+Node: Bourne Shell Builtins123978
+Node: Bash Builtins144578
+Node: Modifying Shell Behavior173487
+Node: The Set Builtin173832
+Node: The Shopt Builtin184245
+Node: Special Builtins200580
+Node: Shell Variables201559
+Node: Bourne Shell Variables201996
+Node: Bash Variables204100
+Node: Bash Features233893
+Node: Invoking Bash234792
+Node: Bash Startup Files240741
+Node: Interactive Shells245844
+Node: What is an Interactive Shell?246254
+Node: Is this Shell Interactive?246903
+Node: Interactive Shell Behavior247718
+Node: Bash Conditional Expressions251206
+Node: Shell Arithmetic255572
+Node: Aliases258389
+Node: Arrays260937
+Node: The Directory Stack266099
+Node: Directory Stack Builtins266883
+Node: Controlling the Prompt269851
+Node: The Restricted Shell272613
+Node: Bash POSIX Mode274438
+Node: Job Control284789
+Node: Job Control Basics285249
+Node: Job Control Builtins290217
+Node: Job Control Variables294944
+Node: Command Line Editing296100
+Node: Introduction and Notation297771
+Node: Readline Interaction299394
+Node: Readline Bare Essentials300585
+Node: Readline Movement Commands302368
+Node: Readline Killing Commands303328
+Node: Readline Arguments305246
+Node: Searching306290
+Node: Readline Init File308476
+Node: Readline Init File Syntax309623
+Node: Conditional Init Constructs329810
+Node: Sample Init File332335
+Node: Bindable Readline Commands335452
+Node: Commands For Moving336656
+Node: Commands For History338505
+Node: Commands For Text342800
+Node: Commands For Killing346189
+Node: Numeric Arguments348670
+Node: Commands For Completion349809
+Node: Keyboard Macros354000
+Node: Miscellaneous Commands354687
+Node: Readline vi Mode360563
+Node: Programmable Completion361470
+Node: Programmable Completion Builtins368931
+Node: A Programmable Completion Example378817
+Node: Using History Interactively384068
+Node: Bash History Facilities384752
+Node: Bash History Builtins387753
+Node: History Interaction392045
+Node: Event Designators395009
+Node: Word Designators396228
+Node: Modifiers397865
+Node: Installing Bash399267
+Node: Basic Installation400404
+Node: Compilers and Options403095
+Node: Compiling For Multiple Architectures403836
+Node: Installation Names405499
+Node: Specifying the System Type406317
+Node: Sharing Defaults407033
+Node: Operation Controls407706
+Node: Optional Features408664
+Node: Reporting Bugs419190
+Node: Major Differences From The Bourne Shell420384
+Node: GNU Free Documentation License437236
+Node: Indexes462413
+Node: Builtin Index462867
+Node: Reserved Word Index469694
+Node: Variable Index472142
+Node: Function Index487820
+Node: Concept Index501123

 End Tag Table