mirror of
https://https.git.savannah.gnu.org/git/bash.git
synced 2026-08-09 11:40:30 +02:00
control default value of patsub_replacement from config-top.h; documentation updates
This commit is contained in:
Chet Ramey
+190
-176
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 6.8 from
|
||||
bashref.texi.
|
||||
|
||||
This text is a brief description of the features that are present in the
|
||||
Bash shell (version 5.2, 7 February 2023).
|
||||
Bash shell (version 5.2, 20 February 2023).
|
||||
|
||||
This is Edition 5.2, last updated 7 February 2023, of 'The GNU Bash
|
||||
This is Edition 5.2, last updated 20 February 2023, of 'The GNU Bash
|
||||
Reference Manual', for 'Bash', Version 5.2.
|
||||
|
||||
Copyright (C) 1988-2023 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.2, 7 February 2023). The Bash home page is
|
||||
Bash shell (version 5.2, 20 February 2023). The Bash home page is
|
||||
<http://www.gnu.org/software/bash/>.
|
||||
|
||||
This is Edition 5.2, last updated 7 February 2023, of 'The GNU Bash
|
||||
This is Edition 5.2, last updated 20 February 2023, of 'The GNU Bash
|
||||
Reference Manual', for 'Bash', Version 5.2.
|
||||
|
||||
Bash contains features that appear in other popular shells, and some
|
||||
@@ -4039,12 +4039,13 @@ standard.
|
||||
the variable NAME have a visible scope restricted to that function
|
||||
and its children. If NAME is '-', the set of shell options is made
|
||||
local to the function in which 'local' is invoked: shell options
|
||||
changed using the 'set' builtin inside the function are restored to
|
||||
their original values when the function returns. The restore is
|
||||
effected as if a series of 'set' commands were executed to restore
|
||||
the values that were in place before the function. The return
|
||||
status is zero unless 'local' is used outside a function, an
|
||||
invalid NAME is supplied, or NAME is a readonly variable.
|
||||
changed using the 'set' builtin inside the function after the call
|
||||
to 'local' are restored to their original values when the function
|
||||
returns. The restore is effected as if a series of 'set' commands
|
||||
were executed to restore the values that were in place before the
|
||||
function. The return status is zero unless 'local' is used outside
|
||||
a function, an invalid NAME is supplied, or NAME is a readonly
|
||||
variable.
|
||||
|
||||
'logout'
|
||||
logout [N]
|
||||
@@ -6609,30 +6610,36 @@ File: bashref.info, Node: Aliases, Next: Arrays, Prev: Shell Arithmetic, Up:
|
||||
6.6 Aliases
|
||||
===========
|
||||
|
||||
"Aliases" allow a string to be substituted for a word when it is used as
|
||||
the first word of a simple command. The shell maintains a list of
|
||||
aliases that may be set and unset with the 'alias' and 'unalias' builtin
|
||||
commands.
|
||||
"Aliases" allow a string to be substituted for a word that is in a
|
||||
position in the input where it can be the first word of a simple
|
||||
command. Aliases have names and corresponding values that are set and
|
||||
unset using the 'alias' and 'unalias' builtin commands (*note Shell
|
||||
Builtin Commands::).
|
||||
|
||||
The first word of each simple command, if unquoted, is checked to see
|
||||
if it has an alias. If so, that word is replaced by the text of the
|
||||
alias. The characters '/', '$', '`', '=' and any of the shell
|
||||
metacharacters or quoting characters listed above may not appear in an
|
||||
alias name. The replacement text may contain any valid shell input,
|
||||
including shell metacharacters. The first word of the replacement text
|
||||
is tested for aliases, but a word that is identical to an alias being
|
||||
expanded is not expanded a second time. This means that one may alias
|
||||
'ls' to '"ls -F"', for instance, and Bash does not try to recursively
|
||||
expand the replacement text. If the last character of the alias value
|
||||
is a 'blank', then the next command word following the alias is also
|
||||
checked for alias expansion.
|
||||
If the shell reads an unquoted word in the right position, it checks
|
||||
the word to see if it matches an alias name. If it matches, the shell
|
||||
replaces the word with the alias value, and reads that value as if it
|
||||
had been read instead of the word. The shell doesn't look at any
|
||||
characters following the word before attempting alias substitution.
|
||||
|
||||
The characters '/', '$', '`', '=' and any of the shell metacharacters
|
||||
or quoting characters listed above may not appear in an alias name. The
|
||||
replacement text may contain any valid shell input, including shell
|
||||
metacharacters. The first word of the replacement text is tested for
|
||||
aliases, but a word that is identical to an alias being expanded is not
|
||||
expanded a second time. This means that one may alias 'ls' to '"ls
|
||||
-F"', for instance, and Bash does not try to recursively expand the
|
||||
replacement text.
|
||||
|
||||
If the last character of the alias value is a 'blank', then the next
|
||||
command word following the alias is also checked for alias expansion.
|
||||
|
||||
Aliases are created and listed with the 'alias' command, and removed
|
||||
with the 'unalias' command.
|
||||
|
||||
There is no mechanism for using arguments in the replacement text, as
|
||||
in 'csh'. If arguments are needed, use a shell function (*note Shell
|
||||
Functions::).
|
||||
Functions::) instead.
|
||||
|
||||
Aliases are not expanded when the shell is not interactive, unless
|
||||
the 'expand_aliases' shell option is set using 'shopt' (*note The Shopt
|
||||
@@ -8399,6 +8406,11 @@ Variable Settings
|
||||
undo lists across calls to 'readline()'. The default is
|
||||
'off'.
|
||||
|
||||
'search-ignore-case'
|
||||
If set to 'on', Readline performs incremental and
|
||||
non-incremental history list searches in a case-insensitive
|
||||
fashion. The default value is 'off'.
|
||||
|
||||
'show-all-if-ambiguous'
|
||||
This alters the default behavior of the completion functions.
|
||||
If set to 'on', words which have more than one possible
|
||||
@@ -11891,17 +11903,17 @@ D.1 Index of Shell Builtin Commands
|
||||
(line 58)
|
||||
* let: Bash Builtins. (line 361)
|
||||
* local: Bash Builtins. (line 369)
|
||||
* logout: Bash Builtins. (line 385)
|
||||
* mapfile: Bash Builtins. (line 390)
|
||||
* logout: Bash Builtins. (line 386)
|
||||
* mapfile: Bash Builtins. (line 391)
|
||||
* popd: Directory Stack Builtins.
|
||||
(line 35)
|
||||
* printf: Bash Builtins. (line 436)
|
||||
* printf: Bash Builtins. (line 437)
|
||||
* pushd: Directory Stack Builtins.
|
||||
(line 69)
|
||||
* pwd: Bourne Shell Builtins.
|
||||
(line 212)
|
||||
* read: Bash Builtins. (line 503)
|
||||
* readarray: Bash Builtins. (line 600)
|
||||
* read: Bash Builtins. (line 504)
|
||||
* readarray: Bash Builtins. (line 601)
|
||||
* readonly: Bourne Shell Builtins.
|
||||
(line 222)
|
||||
* return: Bourne Shell Builtins.
|
||||
@@ -11910,7 +11922,7 @@ D.1 Index of Shell Builtin Commands
|
||||
* shift: Bourne Shell Builtins.
|
||||
(line 262)
|
||||
* shopt: The Shopt Builtin. (line 9)
|
||||
* source: Bash Builtins. (line 609)
|
||||
* source: Bash Builtins. (line 610)
|
||||
* suspend: Job Control Builtins.
|
||||
(line 116)
|
||||
* test: Bourne Shell Builtins.
|
||||
@@ -11919,12 +11931,12 @@ D.1 Index of Shell Builtin Commands
|
||||
(line 360)
|
||||
* trap: Bourne Shell Builtins.
|
||||
(line 366)
|
||||
* type: Bash Builtins. (line 614)
|
||||
* typeset: Bash Builtins. (line 652)
|
||||
* ulimit: Bash Builtins. (line 658)
|
||||
* type: Bash Builtins. (line 615)
|
||||
* typeset: Bash Builtins. (line 653)
|
||||
* ulimit: Bash Builtins. (line 659)
|
||||
* umask: Bourne Shell Builtins.
|
||||
(line 428)
|
||||
* unalias: Bash Builtins. (line 764)
|
||||
* unalias: Bash Builtins. (line 765)
|
||||
* unset: Bourne Shell Builtins.
|
||||
(line 446)
|
||||
* wait: Job Control Builtins.
|
||||
@@ -12185,18 +12197,20 @@ D.3 Parameter and Variable Index
|
||||
* REPLY: Bash Variables. (line 630)
|
||||
* revert-all-at-newline: Readline Init File Syntax.
|
||||
(line 322)
|
||||
* search-ignore-case: Readline Init File Syntax.
|
||||
(line 329)
|
||||
* SECONDS: Bash Variables. (line 633)
|
||||
* SHELL: Bash Variables. (line 642)
|
||||
* SHELLOPTS: Bash Variables. (line 647)
|
||||
* SHLVL: Bash Variables. (line 656)
|
||||
* show-all-if-ambiguous: Readline Init File Syntax.
|
||||
(line 329)
|
||||
(line 334)
|
||||
* show-all-if-unmodified: Readline Init File Syntax.
|
||||
(line 335)
|
||||
(line 340)
|
||||
* show-mode-in-prompt: Readline Init File Syntax.
|
||||
(line 344)
|
||||
(line 349)
|
||||
* skip-completed-text: Readline Init File Syntax.
|
||||
(line 350)
|
||||
(line 355)
|
||||
* SRANDOM: Bash Variables. (line 661)
|
||||
* TEXTDOMAIN: Creating Internationalized Scripts.
|
||||
(line 51)
|
||||
@@ -12207,11 +12221,11 @@ D.3 Parameter and Variable Index
|
||||
* TMPDIR: Bash Variables. (line 720)
|
||||
* UID: Bash Variables. (line 724)
|
||||
* vi-cmd-mode-string: Readline Init File Syntax.
|
||||
(line 363)
|
||||
(line 368)
|
||||
* vi-ins-mode-string: Readline Init File Syntax.
|
||||
(line 374)
|
||||
(line 379)
|
||||
* visible-stats: Readline Init File Syntax.
|
||||
(line 385)
|
||||
(line 390)
|
||||
|
||||
|
||||
File: bashref.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
|
||||
@@ -12590,138 +12604,138 @@ 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 Character14474
|
||||
Node: Single Quotes14959
|
||||
Node: Double Quotes15307
|
||||
Node: ANSI-C Quoting16585
|
||||
Node: Locale Translation17895
|
||||
Node: Creating Internationalized Scripts19206
|
||||
Node: Comments23323
|
||||
Node: Shell Commands23941
|
||||
Node: Reserved Words24879
|
||||
Node: Simple Commands25635
|
||||
Node: Pipelines26289
|
||||
Node: Lists29288
|
||||
Node: Compound Commands31083
|
||||
Node: Looping Constructs32095
|
||||
Node: Conditional Constructs34590
|
||||
Node: Command Grouping49078
|
||||
Node: Coprocesses50556
|
||||
Node: GNU Parallel53219
|
||||
Node: Shell Functions54136
|
||||
Node: Shell Parameters62021
|
||||
Node: Positional Parameters66409
|
||||
Node: Special Parameters67311
|
||||
Node: Shell Expansions70525
|
||||
Node: Brace Expansion72652
|
||||
Node: Tilde Expansion75386
|
||||
Node: Shell Parameter Expansion78007
|
||||
Node: Command Substitution96409
|
||||
Node: Arithmetic Expansion97764
|
||||
Node: Process Substitution98732
|
||||
Node: Word Splitting99852
|
||||
Node: Filename Expansion101796
|
||||
Node: Pattern Matching104545
|
||||
Node: Quote Removal109547
|
||||
Node: Redirections109842
|
||||
Node: Executing Commands119502
|
||||
Node: Simple Command Expansion120172
|
||||
Node: Command Search and Execution122282
|
||||
Node: Command Execution Environment124669
|
||||
Node: Environment127704
|
||||
Node: Exit Status129367
|
||||
Node: Signals131151
|
||||
Node: Shell Scripts134600
|
||||
Node: Shell Builtin Commands137627
|
||||
Node: Bourne Shell Builtins139665
|
||||
Node: Bash Builtins161863
|
||||
Node: Modifying Shell Behavior193831
|
||||
Node: The Set Builtin194176
|
||||
Node: The Shopt Builtin204774
|
||||
Node: Special Builtins220686
|
||||
Node: Shell Variables221665
|
||||
Node: Bourne Shell Variables222102
|
||||
Node: Bash Variables224206
|
||||
Node: Bash Features257021
|
||||
Node: Invoking Bash258034
|
||||
Node: Bash Startup Files264047
|
||||
Node: Interactive Shells269178
|
||||
Node: What is an Interactive Shell?269589
|
||||
Node: Is this Shell Interactive?270238
|
||||
Node: Interactive Shell Behavior271053
|
||||
Node: Bash Conditional Expressions274682
|
||||
Node: Shell Arithmetic279324
|
||||
Node: Aliases282268
|
||||
Node: Arrays284881
|
||||
Node: The Directory Stack291272
|
||||
Node: Directory Stack Builtins292056
|
||||
Node: Controlling the Prompt296316
|
||||
Node: The Restricted Shell299281
|
||||
Node: Bash POSIX Mode301891
|
||||
Node: Shell Compatibility Mode314757
|
||||
Node: Job Control323324
|
||||
Node: Job Control Basics323784
|
||||
Node: Job Control Builtins328786
|
||||
Node: Job Control Variables334581
|
||||
Node: Command Line Editing335737
|
||||
Node: Introduction and Notation337408
|
||||
Node: Readline Interaction339031
|
||||
Node: Readline Bare Essentials340222
|
||||
Node: Readline Movement Commands342011
|
||||
Node: Readline Killing Commands342971
|
||||
Node: Readline Arguments344892
|
||||
Node: Searching345936
|
||||
Node: Readline Init File348122
|
||||
Node: Readline Init File Syntax349383
|
||||
Node: Conditional Init Constructs372969
|
||||
Node: Sample Init File377165
|
||||
Node: Bindable Readline Commands380289
|
||||
Node: Commands For Moving381493
|
||||
Node: Commands For History383544
|
||||
Node: Commands For Text388538
|
||||
Node: Commands For Killing392187
|
||||
Node: Numeric Arguments395220
|
||||
Node: Commands For Completion396359
|
||||
Node: Keyboard Macros400550
|
||||
Node: Miscellaneous Commands401238
|
||||
Node: Readline vi Mode407183
|
||||
Node: Programmable Completion408090
|
||||
Node: Programmable Completion Builtins415870
|
||||
Node: A Programmable Completion Example426622
|
||||
Node: Using History Interactively431870
|
||||
Node: Bash History Facilities432554
|
||||
Node: Bash History Builtins435559
|
||||
Node: History Interaction440583
|
||||
Node: Event Designators444203
|
||||
Node: Word Designators445557
|
||||
Node: Modifiers447317
|
||||
Node: Installing Bash449125
|
||||
Node: Basic Installation450262
|
||||
Node: Compilers and Options453984
|
||||
Node: Compiling For Multiple Architectures454725
|
||||
Node: Installation Names456417
|
||||
Node: Specifying the System Type458526
|
||||
Node: Sharing Defaults459243
|
||||
Node: Operation Controls459916
|
||||
Node: Optional Features460874
|
||||
Node: Reporting Bugs472093
|
||||
Node: Major Differences From The Bourne Shell473437
|
||||
Node: GNU Free Documentation License490286
|
||||
Node: Indexes515463
|
||||
Node: Builtin Index515917
|
||||
Node: Reserved Word Index522744
|
||||
Node: Variable Index525192
|
||||
Node: Function Index541966
|
||||
Node: Concept Index555750
|
||||
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 Translation17899
|
||||
Node: Creating Internationalized Scripts19210
|
||||
Node: Comments23327
|
||||
Node: Shell Commands23945
|
||||
Node: Reserved Words24883
|
||||
Node: Simple Commands25639
|
||||
Node: Pipelines26293
|
||||
Node: Lists29292
|
||||
Node: Compound Commands31087
|
||||
Node: Looping Constructs32099
|
||||
Node: Conditional Constructs34594
|
||||
Node: Command Grouping49082
|
||||
Node: Coprocesses50560
|
||||
Node: GNU Parallel53223
|
||||
Node: Shell Functions54140
|
||||
Node: Shell Parameters62025
|
||||
Node: Positional Parameters66413
|
||||
Node: Special Parameters67315
|
||||
Node: Shell Expansions70529
|
||||
Node: Brace Expansion72656
|
||||
Node: Tilde Expansion75390
|
||||
Node: Shell Parameter Expansion78011
|
||||
Node: Command Substitution96413
|
||||
Node: Arithmetic Expansion97768
|
||||
Node: Process Substitution98736
|
||||
Node: Word Splitting99856
|
||||
Node: Filename Expansion101800
|
||||
Node: Pattern Matching104549
|
||||
Node: Quote Removal109551
|
||||
Node: Redirections109846
|
||||
Node: Executing Commands119506
|
||||
Node: Simple Command Expansion120176
|
||||
Node: Command Search and Execution122286
|
||||
Node: Command Execution Environment124673
|
||||
Node: Environment127708
|
||||
Node: Exit Status129371
|
||||
Node: Signals131155
|
||||
Node: Shell Scripts134604
|
||||
Node: Shell Builtin Commands137631
|
||||
Node: Bourne Shell Builtins139669
|
||||
Node: Bash Builtins161867
|
||||
Node: Modifying Shell Behavior193866
|
||||
Node: The Set Builtin194211
|
||||
Node: The Shopt Builtin204809
|
||||
Node: Special Builtins220721
|
||||
Node: Shell Variables221700
|
||||
Node: Bourne Shell Variables222137
|
||||
Node: Bash Variables224241
|
||||
Node: Bash Features257056
|
||||
Node: Invoking Bash258069
|
||||
Node: Bash Startup Files264082
|
||||
Node: Interactive Shells269213
|
||||
Node: What is an Interactive Shell?269624
|
||||
Node: Is this Shell Interactive?270273
|
||||
Node: Interactive Shell Behavior271088
|
||||
Node: Bash Conditional Expressions274717
|
||||
Node: Shell Arithmetic279359
|
||||
Node: Aliases282303
|
||||
Node: Arrays285197
|
||||
Node: The Directory Stack291588
|
||||
Node: Directory Stack Builtins292372
|
||||
Node: Controlling the Prompt296632
|
||||
Node: The Restricted Shell299597
|
||||
Node: Bash POSIX Mode302207
|
||||
Node: Shell Compatibility Mode315073
|
||||
Node: Job Control323640
|
||||
Node: Job Control Basics324100
|
||||
Node: Job Control Builtins329102
|
||||
Node: Job Control Variables334897
|
||||
Node: Command Line Editing336053
|
||||
Node: Introduction and Notation337724
|
||||
Node: Readline Interaction339347
|
||||
Node: Readline Bare Essentials340538
|
||||
Node: Readline Movement Commands342327
|
||||
Node: Readline Killing Commands343287
|
||||
Node: Readline Arguments345208
|
||||
Node: Searching346252
|
||||
Node: Readline Init File348438
|
||||
Node: Readline Init File Syntax349699
|
||||
Node: Conditional Init Constructs373490
|
||||
Node: Sample Init File377686
|
||||
Node: Bindable Readline Commands380810
|
||||
Node: Commands For Moving382014
|
||||
Node: Commands For History384065
|
||||
Node: Commands For Text389059
|
||||
Node: Commands For Killing392708
|
||||
Node: Numeric Arguments395741
|
||||
Node: Commands For Completion396880
|
||||
Node: Keyboard Macros401071
|
||||
Node: Miscellaneous Commands401759
|
||||
Node: Readline vi Mode407704
|
||||
Node: Programmable Completion408611
|
||||
Node: Programmable Completion Builtins416391
|
||||
Node: A Programmable Completion Example427143
|
||||
Node: Using History Interactively432391
|
||||
Node: Bash History Facilities433075
|
||||
Node: Bash History Builtins436080
|
||||
Node: History Interaction441104
|
||||
Node: Event Designators444724
|
||||
Node: Word Designators446078
|
||||
Node: Modifiers447838
|
||||
Node: Installing Bash449646
|
||||
Node: Basic Installation450783
|
||||
Node: Compilers and Options454505
|
||||
Node: Compiling For Multiple Architectures455246
|
||||
Node: Installation Names456938
|
||||
Node: Specifying the System Type459047
|
||||
Node: Sharing Defaults459764
|
||||
Node: Operation Controls460437
|
||||
Node: Optional Features461395
|
||||
Node: Reporting Bugs472614
|
||||
Node: Major Differences From The Bourne Shell473958
|
||||
Node: GNU Free Documentation License490807
|
||||
Node: Indexes515984
|
||||
Node: Builtin Index516438
|
||||
Node: Reserved Word Index523265
|
||||
Node: Variable Index525713
|
||||
Node: Function Index542628
|
||||
Node: Concept Index556412
|
||||
|
||||
End Tag Table
|
||||
|
||||
|
||||
Reference in New Issue
Block a user