changes to handling of "." and ".." when dotglob is enabled; other minor changes

2026-08-09 03:30:48 +02:00 · 2021-06-15 15:07:40 -04:00
parent 6e11792d93
commit da43077c47
20 changed files with 2413 additions and 2170 deletions
@@ -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, 18 May 2021).
+Bash shell (version 5.1, 15 June 2021).

-   This is Edition 5.1, last updated 18 May 2021, of 'The GNU Bash
+   This is Edition 5.1, last updated 15 June 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, 18 May 2021).  The Bash home page is
+Bash shell (version 5.1, 15 June 2021).  The Bash home page is
 <http://www.gnu.org/software/bash/>.

-   This is Edition 5.1, last updated 18 May 2021, of 'The GNU Bash
+   This is Edition 5.1, last updated 15 June 2021, of 'The GNU Bash
 Reference Manual', for 'Bash', Version 5.1.

   Bash contains features that appear in other popular shells, and some
@@ -2271,12 +2271,10 @@ characters.

   When a pattern is used for filename expansion, the character '.' at
 the start of a filename or immediately following a slash must be matched
-explicitly, unless the shell option 'dotglob' is set.  The filenames '.'
-and '..' must be matched by a pattern beginning with '.' (for example,
-'.?'), or a pattern beginning with '.' must be one of the patterns in an
-extended pattern matching expression (see below), even if 'dotglob' is
-set.  When not matching filenames, the '.' character is not treated
-specially.
+explicitly, unless the shell option 'dotglob' is set.  In order to match
+the filenames '.' and '..', the pattern must begin with '.' (for
+example, '.?'), even if 'dotglob' is set.  When not matching filenames,
+the '.' character is not treated specially.

   When matching a filename, the slash character must always be matched
 explicitly by a slash in the pattern, but in other matching contexts it
@@ -2364,8 +2362,10 @@ characters must be quoted if they are to be matched literally.
   If the 'extglob' shell option is enabled using the 'shopt' builtin,
 the shell recognizes several extended pattern matching operators.  In
 the following description, a PATTERN-LIST is a list of one or more
-patterns separated by a '|'.  Composite patterns may be formed using one
-or more of the following sub-patterns:
+patterns separated by a '|'.  When matching filenames, the 'dotglob'
+shell option determines the set of filenames that are tested, as
+described above.  Composite patterns may be formed using one or more of
+the following sub-patterns:

 '?(PATTERN-LIST)'
     Matches zero or one occurrence of the given patterns.
@@ -3091,10 +3091,9 @@ standard.
          cd [-L|[-P [-e]] [-@] [DIRECTORY]

     Change the current working directory to DIRECTORY.  If DIRECTORY is
-     not supplied, the value of the 'HOME' shell variable is used.  Any
-     additional arguments following DIRECTORY are ignored.  If the shell
-     variable 'CDPATH' exists, it is used as a search path: each
-     directory name in 'CDPATH' is searched for DIRECTORY, with
+     not supplied, the value of the 'HOME' shell variable is used.  If
+     the shell variable 'CDPATH' exists, it is used as a search path:
+     each directory name in 'CDPATH' is searched for DIRECTORY, with
     alternative directory names in 'CDPATH' separated by a colon (':').
     If DIRECTORY begins with a slash, 'CDPATH' is not used.

@@ -11448,7 +11447,7 @@ D.1 Index of Shell Builtin Commands
 * ::                                     Bourne Shell Builtins.
                                                              (line  11)
 * [:                                     Bourne Shell Builtins.
-                                                              (line 275)
+                                                              (line 274)
 * alias:                                 Bash Builtins.       (line  11)
 * bg:                                    Job Control Builtins.
                                                              (line   7)
@@ -11467,7 +11466,7 @@ D.1 Index of Shell Builtin Commands
 * compopt:                               Programmable Completion Builtins.
                                                              (line 237)
 * continue:                              Bourne Shell Builtins.
-                                                              (line  90)
+                                                              (line  89)
 * declare:                               Bash Builtins.       (line 154)
 * dirs:                                  Directory Stack Builtins.
                                                              (line   7)
@@ -11476,21 +11475,21 @@ D.1 Index of Shell Builtin Commands
 * echo:                                  Bash Builtins.       (line 257)
 * enable:                                Bash Builtins.       (line 306)
 * eval:                                  Bourne Shell Builtins.
-                                                              (line  99)
+                                                              (line  98)
 * exec:                                  Bourne Shell Builtins.
-                                                              (line 107)
+                                                              (line 106)
 * exit:                                  Bourne Shell Builtins.
-                                                              (line 125)
+                                                              (line 124)
 * export:                                Bourne Shell Builtins.
-                                                              (line 132)
+                                                              (line 131)
 * fc:                                    Bash History Builtins.
                                                              (line  10)
 * fg:                                    Job Control Builtins.
                                                              (line  17)
 * getopts:                               Bourne Shell Builtins.
-                                                              (line 148)
+                                                              (line 147)
 * hash:                                  Bourne Shell Builtins.
-                                                              (line 192)
+                                                              (line 191)
 * help:                                  Bash Builtins.       (line 338)
 * history:                               Bash History Builtins.
                                                              (line  46)
@@ -11508,34 +11507,34 @@ D.1 Index of Shell Builtin Commands
 * pushd:                                 Directory Stack Builtins.
                                                              (line  69)
 * pwd:                                   Bourne Shell Builtins.
-                                                              (line 212)
+                                                              (line 211)
 * read:                                  Bash Builtins.       (line 481)
 * readarray:                             Bash Builtins.       (line 577)
 * readonly:                              Bourne Shell Builtins.
-                                                              (line 222)
+                                                              (line 221)
 * return:                                Bourne Shell Builtins.
-                                                              (line 241)
+                                                              (line 240)
 * set:                                   The Set Builtin.     (line  11)
 * shift:                                 Bourne Shell Builtins.
-                                                              (line 262)
+                                                              (line 261)
 * shopt:                                 The Shopt Builtin.   (line   9)
 * source:                                Bash Builtins.       (line 586)
 * suspend:                               Job Control Builtins.
                                                              (line 113)
 * test:                                  Bourne Shell Builtins.
-                                                              (line 275)
+                                                              (line 274)
 * times:                                 Bourne Shell Builtins.
-                                                              (line 360)
+                                                              (line 359)
 * trap:                                  Bourne Shell Builtins.
-                                                              (line 366)
+                                                              (line 365)
 * type:                                  Bash Builtins.       (line 591)
 * typeset:                               Bash Builtins.       (line 623)
 * ulimit:                                Bash Builtins.       (line 629)
 * umask:                                 Bourne Shell Builtins.
-                                                              (line 415)
+                                                              (line 414)
 * unalias:                               Bash Builtins.       (line 735)
 * unset:                                 Bourne Shell Builtins.
-                                                              (line 433)
+                                                              (line 432)
 * wait:                                  Job Control Builtins.
                                                              (line  76)

@@ -12195,138 +12194,138 @@ 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 Translation17879
-Node: Creating Internationalized Scripts19034
-Node: Comments23151
-Node: Shell Commands23769
-Node: Reserved Words24707
-Node: Simple Commands25463
-Node: Pipelines26117
-Node: Lists29074
-Node: Compound Commands30869
-Node: Looping Constructs31881
-Node: Conditional Constructs34376
-Node: Command Grouping48666
-Node: Coprocesses50141
-Node: GNU Parallel52804
-Node: Shell Functions53721
-Node: Shell Parameters60941
-Node: Positional Parameters65392
-Node: Special Parameters66294
-Node: Shell Expansions69518
-Node: Brace Expansion71645
-Node: Tilde Expansion74379
-Node: Shell Parameter Expansion77000
-Node: Command Substitution92129
-Node: Arithmetic Expansion93484
-Node: Process Substitution94416
-Node: Word Splitting95536
-Node: Filename Expansion97480
-Node: Pattern Matching100193
-Node: Quote Removal104189
-Node: Redirections104484
-Node: Executing Commands114058
-Node: Simple Command Expansion114728
-Node: Command Search and Execution116682
-Node: Command Execution Environment119060
-Node: Environment122046
-Node: Exit Status123709
-Node: Signals125493
-Node: Shell Scripts127460
-Node: Shell Builtin Commands130472
-Node: Bourne Shell Builtins132510
-Node: Bash Builtins154035
-Node: Modifying Shell Behavior184549
-Node: The Set Builtin184894
-Node: The Shopt Builtin195307
-Node: Special Builtins210268
-Node: Shell Variables211247
-Node: Bourne Shell Variables211684
-Node: Bash Variables213788
-Node: Bash Features246603
-Node: Invoking Bash247616
-Node: Bash Startup Files253629
-Node: Interactive Shells258732
-Node: What is an Interactive Shell?259142
-Node: Is this Shell Interactive?259791
-Node: Interactive Shell Behavior260606
-Node: Bash Conditional Expressions264119
-Node: Shell Arithmetic268761
-Node: Aliases271705
-Node: Arrays274318
-Node: The Directory Stack280327
-Node: Directory Stack Builtins281111
-Node: Controlling the Prompt285371
-Node: The Restricted Shell288336
-Node: Bash POSIX Mode290930
-Node: Shell Compatibility Mode302203
-Node: Job Control308859
-Node: Job Control Basics309319
-Node: Job Control Builtins314321
-Node: Job Control Variables319721
-Node: Command Line Editing320877
-Node: Introduction and Notation322548
-Node: Readline Interaction324171
-Node: Readline Bare Essentials325362
-Node: Readline Movement Commands327145
-Node: Readline Killing Commands328105
-Node: Readline Arguments330023
-Node: Searching331067
-Node: Readline Init File333253
-Node: Readline Init File Syntax334512
-Node: Conditional Init Constructs355746
-Node: Sample Init File359942
-Node: Bindable Readline Commands363066
-Node: Commands For Moving364270
-Node: Commands For History366321
-Node: Commands For Text371315
-Node: Commands For Killing374964
-Node: Numeric Arguments377997
-Node: Commands For Completion379136
-Node: Keyboard Macros383327
-Node: Miscellaneous Commands384014
-Node: Readline vi Mode389953
-Node: Programmable Completion390860
-Node: Programmable Completion Builtins398640
-Node: A Programmable Completion Example409335
-Node: Using History Interactively414582
-Node: Bash History Facilities415266
-Node: Bash History Builtins418271
-Node: History Interaction423279
-Node: Event Designators426899
-Node: Word Designators428253
-Node: Modifiers430013
-Node: Installing Bash431824
-Node: Basic Installation432961
-Node: Compilers and Options436219
-Node: Compiling For Multiple Architectures436960
-Node: Installation Names438653
-Node: Specifying the System Type439471
-Node: Sharing Defaults440187
-Node: Operation Controls440860
-Node: Optional Features441818
-Node: Reporting Bugs452618
-Node: Major Differences From The Bourne Shell453893
-Node: GNU Free Documentation License470743
-Node: Indexes495920
-Node: Builtin Index496374
-Node: Reserved Word Index503201
-Node: Variable Index505649
-Node: Function Index522141
-Node: Concept Index535925
+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 Character14462
+Node: Single Quotes14947
+Node: Double Quotes15295
+Node: ANSI-C Quoting16573
+Node: Locale Translation17883
+Node: Creating Internationalized Scripts19038
+Node: Comments23155
+Node: Shell Commands23773
+Node: Reserved Words24711
+Node: Simple Commands25467
+Node: Pipelines26121
+Node: Lists29078
+Node: Compound Commands30873
+Node: Looping Constructs31885
+Node: Conditional Constructs34380
+Node: Command Grouping48670
+Node: Coprocesses50145
+Node: GNU Parallel52808
+Node: Shell Functions53725
+Node: Shell Parameters60945
+Node: Positional Parameters65396
+Node: Special Parameters66298
+Node: Shell Expansions69522
+Node: Brace Expansion71649
+Node: Tilde Expansion74383
+Node: Shell Parameter Expansion77004
+Node: Command Substitution92133
+Node: Arithmetic Expansion93488
+Node: Process Substitution94420
+Node: Word Splitting95540
+Node: Filename Expansion97484
+Node: Pattern Matching100084
+Node: Quote Removal104202
+Node: Redirections104497
+Node: Executing Commands114071
+Node: Simple Command Expansion114741
+Node: Command Search and Execution116695
+Node: Command Execution Environment119073
+Node: Environment122059
+Node: Exit Status123722
+Node: Signals125506
+Node: Shell Scripts127473
+Node: Shell Builtin Commands130485
+Node: Bourne Shell Builtins132523
+Node: Bash Builtins153984
+Node: Modifying Shell Behavior184498
+Node: The Set Builtin184843
+Node: The Shopt Builtin195256
+Node: Special Builtins210217
+Node: Shell Variables211196
+Node: Bourne Shell Variables211633
+Node: Bash Variables213737
+Node: Bash Features246552
+Node: Invoking Bash247565
+Node: Bash Startup Files253578
+Node: Interactive Shells258681
+Node: What is an Interactive Shell?259091
+Node: Is this Shell Interactive?259740
+Node: Interactive Shell Behavior260555
+Node: Bash Conditional Expressions264068
+Node: Shell Arithmetic268710
+Node: Aliases271654
+Node: Arrays274267
+Node: The Directory Stack280276
+Node: Directory Stack Builtins281060
+Node: Controlling the Prompt285320
+Node: The Restricted Shell288285
+Node: Bash POSIX Mode290879
+Node: Shell Compatibility Mode302152
+Node: Job Control308808
+Node: Job Control Basics309268
+Node: Job Control Builtins314270
+Node: Job Control Variables319670
+Node: Command Line Editing320826
+Node: Introduction and Notation322497
+Node: Readline Interaction324120
+Node: Readline Bare Essentials325311
+Node: Readline Movement Commands327094
+Node: Readline Killing Commands328054
+Node: Readline Arguments329972
+Node: Searching331016
+Node: Readline Init File333202
+Node: Readline Init File Syntax334461
+Node: Conditional Init Constructs355695
+Node: Sample Init File359891
+Node: Bindable Readline Commands363015
+Node: Commands For Moving364219
+Node: Commands For History366270
+Node: Commands For Text371264
+Node: Commands For Killing374913
+Node: Numeric Arguments377946
+Node: Commands For Completion379085
+Node: Keyboard Macros383276
+Node: Miscellaneous Commands383963
+Node: Readline vi Mode389902
+Node: Programmable Completion390809
+Node: Programmable Completion Builtins398589
+Node: A Programmable Completion Example409284
+Node: Using History Interactively414531
+Node: Bash History Facilities415215
+Node: Bash History Builtins418220
+Node: History Interaction423228
+Node: Event Designators426848
+Node: Word Designators428202
+Node: Modifiers429962
+Node: Installing Bash431773
+Node: Basic Installation432910
+Node: Compilers and Options436168
+Node: Compiling For Multiple Architectures436909
+Node: Installation Names438602
+Node: Specifying the System Type439420
+Node: Sharing Defaults440136
+Node: Operation Controls440809
+Node: Optional Features441767
+Node: Reporting Bugs452567
+Node: Major Differences From The Bourne Shell453842
+Node: GNU Free Documentation License470692
+Node: Indexes495869
+Node: Builtin Index496323
+Node: Reserved Word Index503150
+Node: Variable Index505598
+Node: Function Index522090
+Node: Concept Index535874

 End Tag Table