pmodules/bash
0
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/bash.git synced 2026-08-12 05:00:50 +02:00
Code Issues Packages Projects Releases Wiki Activity

Bash-5.2-rc2 release

Browse Source
This commit is contained in:
Chet Ramey
2022-07-25 13:33:03 -04:00
parent 6c1407d2a9
commit f36c8c8ecd
77 changed files with 12062 additions and 10024 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/bash.0
+872 -869
View File
File diff suppressed because it is too large Load Diff
doc/bash.1
+130 -51
View File
@@ -5,12 +5,12 @@
.\" Case Western Reserve University
.\" chet.ramey@case.edu
.\"
.\" Last Change: Fri Jun 3 10:47:26 EDT 2022
.\" Last Change: Thu Jun 16 17:10:54 EDT 2022
.\"
.\" bash_builtins, strip all but Built-Ins section
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH BASH 1 "2022 June 3" "GNU Bash 5.2"
.TH BASH 1 "2022 June 16" "GNU Bash 5.2"
.\"
.\" There's some problem with having a `@'
.\" in a tagged paragraph with the BSD man macros.
@@ -864,21 +864,24 @@ that is executed, or false if any of the expressions is invalid.
.TP
\fBselect\fP \fIname\fP [ \fBin\fP \fIword\fP ] ; \fBdo\fP \fIlist\fP ; \fBdone\fP
The list of words following \fBin\fP is expanded, generating a list
of items. The set of expanded words is printed on the standard
of items, and the set of expanded words is printed on the standard
error, each preceded by a number. If the \fBin\fP
\fIword\fP is omitted, the positional parameters are printed (see
.SM
.B PARAMETERS
below). The
below).
.B select
then displays the
.SM
.B PS3
prompt is then displayed and a line read from the standard input.
prompt and reads a line from the standard input.
If the line consists of a number corresponding to one of
the displayed words, then the value of
.I name
is set to that word. If the line is empty, the words and prompt
are displayed again. If EOF is read, the command completes. Any
other value read causes
is set to that word.
If the line is empty, the words and prompt are displayed again.
If EOF is read, the \fBselect\fP command completes and returns 1.
Any other value read causes
.I name
to be set to null. The line read is saved in the variable
.SM
@@ -8083,7 +8086,9 @@ If any of \fB\-D\fP, \fB\-E\fP, or \fB\-I\fP are supplied, any other
specified by the option.
.sp 1
The process of applying these completion specifications when word completion
is attempted is described above under \fBProgrammable Completion\fP.
is attempted is described
.ie \n(zZ=1 in \fIbash(1)\fP.
.el above under \fBProgrammable Completion\fP.
.sp 1
Other options, if specified, have the following meanings.
The arguments to the \fB\-G\fP, \fB\-W\fP, and \fB\-X\fP options
@@ -8218,6 +8223,7 @@ Names of all shell variables. May also be specified as \fB\-v\fP.
\fB\-C\fP \fIcommand\fP
\fIcommand\fP is executed in a subshell environment, and its output is
used as the possible completions.
Arguments are passed as with the \fB\-F\fP option.
.TP 8
\fB\-F\fP \fIfunction\fP
The shell function \fIfunction\fP is executed in the current shell
@@ -8371,12 +8377,14 @@ to give variables attributes:
.B \-a
Each \fIname\fP is an indexed array variable (see
.B Arrays
above).
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
.TP
.B \-A
Each \fIname\fP is an associative array variable (see
.B Arrays
above).
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
.TP
.B \-f
Use function names only.
@@ -8385,7 +8393,9 @@ Use function names only.
The variable is treated as an integer; arithmetic evaluation (see
.SM
.B "ARITHMETIC EVALUATION"
above) is performed when the variable is assigned a value.
.ie \n(zZ=1 in \fIbash(1)\fP)
.el above)
is performed when the variable is assigned a value.
.TP
.B \-l
When the variable is assigned a value, all upper-case characters are
@@ -8448,7 +8458,9 @@ an attempt is made to assign a value to a readonly variable,
an attempt is made to assign a value to an array variable without
using the compound assignment syntax (see
.B Arrays
above), one of the \fInames\fP is not a valid shell variable name,
.ie \n(zZ=1 in \fIbash(1)\fP),
.el above),
one of the \fInames\fP is not a valid shell variable name,
an attempt is made to turn off readonly status for a readonly variable,
an attempt is made to turn off array status for an array variable,
or an attempt is made to display a non-existent function with \fB\-f\fP.
@@ -9233,7 +9245,8 @@ Each
is an arithmetic expression to be evaluated (see
.SM
.B "ARITHMETIC EVALUATION"
above).
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
If the last
.I arg
evaluates to 0,
@@ -9544,7 +9557,10 @@ invalid option is supplied.
\fBread\fP [\fB\-ers\fP] [\fB\-a\fP \fIaname\fP] [\fB\-d\fP \fIdelim\fP] [\fB\-i\fP \fItext\fP] [\fB\-n\fP \fInchars\fP] [\fB\-N\fP \fInchars\fP] [\fB\-p\fP \fIprompt\fP] [\fB\-t\fP \fItimeout\fP] [\fB\-u\fP \fIfd\fP] [\fIname\fP ...]
One line is read from the standard input, or from the file descriptor
\fIfd\fP supplied as an argument to the \fB\-u\fP option,
split into words as described above under \fBWord Splitting\fP,
split into words as described
.ie \n(zZ=1 in \fIbash(1)\fP
.el above
under \fBWord Splitting\fP,
and the first word
is assigned to the first
.IR name ,
@@ -9560,7 +9576,10 @@ The characters in
.SM
.B IFS
are used to split the line into words using the same rules the shell
uses for expansion (described above under \fBWord Splitting\fP).
uses for expansion (described
.ie \n(zZ=1 in \fIbash(1)\fP
.el above
under \fBWord Splitting\fP).
The backslash character (\fB\e\fP) may be used to remove any special
meaning for the next character read and for line continuation.
Options, if supplied, have the following meanings:
@@ -9589,7 +9608,9 @@ is coming from a terminal,
(see
.SM
.B READLINE
above) is used to obtain the line.
.ie \n(zZ=1 in \fIbash(1)\fP)
.el above)
is used to obtain the line.
Readline uses the current (or default, if line editing was not previously
active) editing settings, but uses Readline's default filename completion.
.TP
@@ -9779,7 +9800,9 @@ or a \fIcompound command\fP
(see
.SM
.B SHELL GRAMMAR
above), exits with a non-zero status.
.ie \n(zZ=1 in \fIbash(1)\fP),
.el above),
exits with a non-zero status.
The shell does not exit if the
command that fails is part of the command list immediately following a
.B while
@@ -9807,7 +9830,9 @@ This option applies to the shell environment and each subshell environment
separately (see
.SM
.B "COMMAND EXECUTION ENVIRONMENT"
above), and may cause
.ie \n(zZ=1 in \fIbash(1)\fP),
.el above),
and may cause
subshells to exit before executing all the commands in the subshell.
.if t .sp 0.5
.if n .sp 1
@@ -9839,7 +9864,8 @@ by default for interactive shells on systems that support
it (see
.SM
.B JOB CONTROL
above).
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
All processes run in a separate process group.
When a background job completes, the shell prints a line
containing its exit status.
@@ -9890,7 +9916,10 @@ Same as
.BR \-H .
.TP 8
.B history
Enable command history, as described above under
Enable command history, as described
.ie \n(zZ=1 in \fIbash(1)\fP
.el above
under
.SM
.BR HISTORY .
This option is on by default in interactive shells.
@@ -9902,7 +9931,8 @@ The effect is as if the shell command
had been executed
(see
.B Shell Variables
above).
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
.TP 8
.B keyword
Same as
@@ -9957,7 +9987,9 @@ from the POSIX standard to match the standard (\fIposix mode\fP).
See
.SM
.B "SEE ALSO"
below for a reference to a document that details how posix mode affects
.ie \n(zZ=1 in \fIbash(1)\fP
.el below
for a reference to a document that details how posix mode affects
bash's behavior.
.TP 8
.B privileged
@@ -10049,7 +10081,9 @@ or associated word list.
.B \-B
The shell performs brace expansion (see
.B Brace Expansion
above). This is on by default.
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
This is on by default.
.TP 8
.B \-C
If set,
@@ -10242,8 +10276,9 @@ the exit to be deferred until a second exit is attempted without an
intervening command (see
.SM
.B "JOB CONTROL"
above). The shell always
postpones exiting if any jobs are stopped.
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
The shell always postpones exiting if any jobs are stopped.
.TP 8
.B checkwinsize
If set, \fBbash\fP checks the window size after each external (non-builtin)
@@ -10262,7 +10297,10 @@ attempts to save all lines of a multiple-line
command in the same history entry. This allows
easy re-editing of multi-line commands.
This option is enabled by default, but only has an effect if command
history is enabled, as described above under
history is enabled, as described
.ie \n(zZ=1 in \fIbash(1)\fP
.el above
under
.SM
.BR HISTORY .
.PD 0
@@ -10287,7 +10325,8 @@ These control aspects of the shell's compatibility mode
(see
.SM
.B "SHELL COMPATIBILITY MODE"
below).
.ie \n(zZ=1 in \fIbash(1)\fP).
.el below).
.TP 8
.B complete_fullquote
If set,
@@ -10346,7 +10385,10 @@ builtin command. An interactive shell does not exit if
fails.
.TP 8
.B expand_aliases
If set, aliases are expanded as described above under
If set, aliases are expanded as described
.ie \n(zZ=1 in \fIbash(1)\fP
.el above
under
.SM
.BR ALIASES .
This option is enabled by default for interactive shells.
@@ -10380,7 +10422,9 @@ a call to \fBreturn\fP.
and
.SM
.B BASH_ARGV
are updated as described in their descriptions above.
are updated as described in their descriptions
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
.TP
.B 5.
Function tracing is enabled: command substitution, shell functions, and
@@ -10394,7 +10438,10 @@ subshells invoked with \fB(\fP \fIcommand\fP \fB)\fP inherit the
.RE
.TP 8
.B extglob
If set, the extended pattern matching features described above under
If set, the extended pattern matching features described
.ie \n(zZ=1 in \fIbash(1)\fP
.el above
under
\fBPathname Expansion\fP are enabled.
.TP 8
.B extquote
@@ -10416,7 +10463,9 @@ the ignored words are the only possible completions.
See
.SM
\fBSHELL VARIABLES\fP
above for a description of
.ie \n(zZ=1 in \fIbash(1)\fP
.el above
for a description of
.SM
.BR FIGNORE .
This option is enabled by default.
@@ -10425,7 +10474,9 @@ This option is enabled by default.
If set, range expressions used in pattern matching bracket expressions (see
.SM
.B Pattern Matching
above) behave as if in the traditional C locale when performing
.ie \n(zZ=1 in \fIbash(1)\fP)
.el above)
behave as if in the traditional C locale when performing
comparisons. That is, the current locale's collating sequence
is not taken into account, so
.B b
@@ -10483,7 +10534,8 @@ word containing a \fB@\fP is being completed (see
under
.SM
.B READLINE
above).
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
This is enabled by default.
.TP 8
.B huponexit
@@ -10504,7 +10556,9 @@ to cause that word and all remaining characters on that
line to be ignored in an interactive shell (see
.SM
.B COMMENTS
above). This option is enabled by default.
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
This option is enabled by default.
.TP 8
.B lastpipe
If set, and job control is not active, the shell runs the last command of
@@ -10531,7 +10585,8 @@ at the current function scope.
The shell sets this option if it is started as a login shell (see
.SM
.B "INVOCATION"
above).
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
The value may not be changed.
.TP 8
.B mailwarn
@@ -10556,7 +10611,8 @@ If set,
matches filenames in a case\-insensitive fashion when performing pathname
expansion (see
.B Pathname Expansion
above).
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
.TP 8
.B nocasematch
If set,
@@ -10579,19 +10635,25 @@ If set,
allows patterns which match no
files (see
.B Pathname Expansion
above)
.ie \n(zZ=1 in \fIbash(1)\fP)
.el above)
to expand to a null string, rather than themselves.
.TP 8
.B patsub_replacement
If set, \fBbash\fP
expands occurrences of \fB&\fP in the replacement string of pattern
substitution to the text matched by the pattern, as described
under \fBParameter Expansion\fP above.
under \fBParameter Expansion\fP
.ie \n(zZ=1 in \fIbash(1)\fP.
.el above.
This option is enabled by default.
.TP 8
.B progcomp
If set, the programmable completion facilities (see
\fBProgrammable Completion\fP above) are enabled.
\fBProgrammable Completion\fP
.ie \n(zZ=1 in \fIbash(1)\fP)
.el above)
are enabled.
This option is enabled by default.
.TP 8
.B progcomp_alias
@@ -10606,14 +10668,17 @@ parameter expansion, command substitution, arithmetic
expansion, and quote removal after being expanded as described in
.SM
.B PROMPTING
above. This option is enabled by default.
.ie \n(zZ=1 in \fIbash(1)\fP.
.el above.
This option is enabled by default.
.TP 8
.B restricted_shell
The shell sets this option if it is started in restricted mode
(see
.SM
.B "RESTRICTED SHELL"
below).
.ie \n(zZ=1 in \fIbash(1)\fP).
.el below).
The value may not be changed.
This is not reset when the startup files are executed, allowing
the startup files to discover whether or not a shell is restricted.
@@ -10637,7 +10702,9 @@ If set, the shell automatically closes file descriptors assigned using the
\fI{varname}\fP redirection syntax (see
.SM
.B REDIRECTION
above) instead of leaving them open when the command completes.
.ie \n(zZ=1 in \fIbash(1)\fP)
.el above)
instead of leaving them open when the command completes.
.TP 8
.B xpg_echo
If set, the \fBecho\fP builtin expands backslash-escape sequences
@@ -10668,8 +10735,10 @@ Return a status of 0 (true) or 1 (false) depending on
the evaluation of the conditional expression
.IR expr .
Each operator and operand must be a separate argument.
.if \n(zZ=0 Expressions are composed of the primaries described above under
.if \n(zZ=1 Expressions are composed of the primaries described in the \fBbash\fP manual page under
Expressions are composed of the primaries described
.ie \n(zZ=1 in \fIbash(1)\fP
.el above
under
.SM
.BR "CONDITIONAL EXPRESSIONS" .
\fBtest\fP does not accept any options, nor does it accept and ignore
@@ -10722,7 +10791,9 @@ The expression is true if and only if the argument is not null.
2 arguments
If the first argument is \fB!\fP, the expression is true if and
only if the second argument is null.
If the first argument is one of the unary conditional operators listed above
If the first argument is one of the unary conditional operators listed
.ie \n(zZ=1 in \fIbash(1)\fP
.el above
under
.SM
.BR "CONDITIONAL EXPRESSIONS" ,
@@ -10732,7 +10803,9 @@ is false.
.TP
3 arguments
The following conditions are applied in the order listed.
If the second argument is one of the binary conditional operators listed above
If the second argument is one of the binary conditional operators listed
.ie \n(zZ=1 in \fIbash(1)\fP
.el above
under
.SM
.BR "CONDITIONAL EXPRESSIONS" ,
@@ -10837,7 +10910,8 @@ is executed before every \fIsimple command\fP, \fIfor\fP command,
command, and before the first command executes in a shell function (see
.SM
.B SHELL GRAMMAR
above).
.ie \n(zZ=1 in \fIbash(1)\fP).
.el above).
Refer to the description of the \fBextdebug\fP option to the
\fBshopt\fP builtin for details of its effect on the \fBDEBUG\fP trap.
If a
@@ -11236,8 +11310,13 @@ forces \fBwait\fP to wait for \fIid\fP to terminate before returning
its status, instead of returning when it changes status.
If
.I id
specifies a non-existent process or job, the return status is
127. Otherwise, the return status is the exit status of the last
specifies a non-existent process or job, the return status is 127.
If \fBwait\fP is interrupted by a signal, the return status will be greater
than 128, as described under
.B SIGNALS
.ie \n(zZ=1 in \fIbash(1)\fP.
.el above.
Otherwise, the return status is the exit status of the last
process or job waited for.
.SH "SHELL COMPATIBILITY MODE"
Bash-4.0 introduced the concept of a \fIshell compatibility level\fP,
@@ -11257,7 +11336,7 @@ behavior. It's intended to be a temporary solution.
This section does not mention behavior that is standard for a particular
version (e.g., setting \fBcompat32\fP means that quoting the rhs of the regexp
matching operator quotes special regexp characters in the word, which is
default behavior in bash-3.2 and above).
default behavior in bash-3.2 and subsequent versions).
.PP
If a user enables, say, \fBcompat32\fP, it may affect the behavior of other
compatibility levels up to and including the current compatibility level.
doc/bash.info
+128 -124
View File
@@ -949,16 +949,16 @@ File: bash.info, Node: Conditional Constructs, Next: Command Grouping, Prev:
select NAME [in WORDS ...]; do COMMANDS; done
The list of words following 'in' is expanded, generating a list of
items. The set of expanded words is printed on the standard error
output stream, each preceded by a number. If the 'in WORDS' is
omitted, the positional parameters are printed, as if 'in "$@"' had
been specified. The 'PS3' prompt is then displayed and a line is
read from the standard input. If the line consists of a number
corresponding to one of the displayed words, then the value of NAME
is set to that word. If the line is empty, the words and prompt
are displayed again. If 'EOF' is read, the 'select' command
completes. Any other value read causes NAME to be set to null.
The line read is saved in the variable 'REPLY'.
items, and the set of expanded words is printed on the standard
error output stream, each preceded by a number. If the 'in WORDS'
is omitted, the positional parameters are printed, as if 'in "$@"'
had been specified. 'select' then displays the 'PS3' prompt and
reads a line from the standard input. If the line consists of a
number corresponding to one of the displayed words, then the value
of NAME is set to that word. If the line is empty, the words and
prompt are displayed again. If 'EOF' is read, the 'select' command
completes and returns 1. Any other value read causes NAME to be
set to null. The line read is saved in the variable 'REPLY'.
The COMMANDS are executed after each selection until a 'break'
command is executed, at which point the 'select' command completes.
@@ -7294,7 +7294,7 @@ be a temporary solution.
This section does not mention behavior that is standard for a
particular version (e.g., setting 'compat32' means that quoting the rhs
of the regexp matching operator quotes special regexp characters in the
word, which is default behavior in bash-3.2 and above).
word, which is default behavior in bash-3.2 and subsequent versions).
If a user enables, say, 'compat32', it may affect the behavior of
other compatibility levels up to and including the current compatibility
@@ -7638,7 +7638,10 @@ File: bash.info, Node: Job Control Builtins, Next: Job Control Variables, Pre
'wait' to wait for each PID or JOBSPEC to terminate before
returning its status, intead of returning when it changes status.
If neither JOBSPEC nor PID specifies an active child process of the
shell, the return status is 127.
shell, the return status is 127. If 'wait' is interrupted by a
signal, the return status will be greater than 128, as described
above (*note Signals::). Otherwise, the return status is the exit
status of the last process or job waited for.
'disown'
disown [-ar] [-h] [JOBSPEC ... | PID ... ]
@@ -9698,7 +9701,8 @@ happening.
'-C COMMAND'
COMMAND is executed in a subshell environment, and its output
is used as the possible completions.
is used as the possible completions. Arguments are passed as
with the '-F' option.
'-F FUNCTION'
The shell function FUNCTION is executed in the current shell
@@ -11774,14 +11778,14 @@ D.1 Index of Shell Builtin Commands
* complete: Programmable Completion Builtins.
(line 30)
* compopt: Programmable Completion Builtins.
(line 237)
(line 238)
* continue: Bourne Shell Builtins.
(line 89)
* declare: Bash Builtins. (line 154)
* dirs: Directory Stack Builtins.
(line 7)
* disown: Job Control Builtins.
(line 101)
(line 104)
* echo: Bash Builtins. (line 257)
* enable: Bash Builtins. (line 306)
* eval: Bourne Shell Builtins.
@@ -11830,7 +11834,7 @@ D.1 Index of Shell Builtin Commands
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 594)
* suspend: Job Control Builtins.
(line 113)
(line 116)
* test: Bourne Shell Builtins.
(line 274)
* times: Bourne Shell Builtins.
@@ -12532,114 +12536,114 @@ Node: Lists29209
Node: Compound Commands31001
Node: Looping Constructs32010
Node: Conditional Constructs34502
Node: Command Grouping48966
Node: Coprocesses50441
Node: GNU Parallel53101
Node: Shell Functions54015
Node: Shell Parameters61897
Node: Positional Parameters66282
Node: Special Parameters67181
Node: Shell Expansions70392
Node: Brace Expansion72516
Node: Tilde Expansion75247
Node: Shell Parameter Expansion77865
Node: Command Substitution96213
Node: Arithmetic Expansion97565
Node: Process Substitution98530
Node: Word Splitting99647
Node: Filename Expansion101588
Node: Pattern Matching104334
Node: Quote Removal108988
Node: Redirections109280
Node: Executing Commands118937
Node: Simple Command Expansion119604
Node: Command Search and Execution121711
Node: Command Execution Environment124086
Node: Environment127118
Node: Exit Status128778
Node: Signals130559
Node: Shell Scripts134005
Node: Shell Builtin Commands137029
Node: Bourne Shell Builtins139064
Node: Bash Builtins160522
Node: Modifying Shell Behavior191375
Node: The Set Builtin191717
Node: The Shopt Builtin202315
Node: Special Builtins218224
Node: Shell Variables219200
Node: Bourne Shell Variables219634
Node: Bash Variables221735
Node: Bash Features254548
Node: Invoking Bash255558
Node: Bash Startup Files261568
Node: Interactive Shells266696
Node: What is an Interactive Shell?267103
Node: Is this Shell Interactive?267749
Node: Interactive Shell Behavior268561
Node: Bash Conditional Expressions272187
Node: Shell Arithmetic276826
Node: Aliases279767
Node: Arrays282377
Node: The Directory Stack288765
Node: Directory Stack Builtins289546
Node: Controlling the Prompt293803
Node: The Restricted Shell296765
Node: Bash POSIX Mode299372
Node: Shell Compatibility Mode311293
Node: Job Control319319
Node: Job Control Basics319776
Node: Job Control Builtins324775
Node: Job Control Variables330342
Node: Command Line Editing331495
Node: Introduction and Notation333163
Node: Readline Interaction334783
Node: Readline Bare Essentials335971
Node: Readline Movement Commands337751
Node: Readline Killing Commands338708
Node: Readline Arguments340623
Node: Searching341664
Node: Readline Init File343847
Node: Readline Init File Syntax345105
Node: Conditional Init Constructs368301
Node: Sample Init File372494
Node: Bindable Readline Commands375615
Node: Commands For Moving376816
Node: Commands For History378864
Node: Commands For Text383855
Node: Commands For Killing387501
Node: Numeric Arguments390531
Node: Commands For Completion391667
Node: Keyboard Macros395855
Node: Miscellaneous Commands396539
Node: Readline vi Mode402475
Node: Programmable Completion403379
Node: Programmable Completion Builtins411156
Node: A Programmable Completion Example421848
Node: Using History Interactively427092
Node: Bash History Facilities427773
Node: Bash History Builtins430775
Node: History Interaction435780
Node: Event Designators439397
Node: Word Designators440748
Node: Modifiers442505
Node: Installing Bash444313
Node: Basic Installation445447
Node: Compilers and Options449166
Node: Compiling For Multiple Architectures449904
Node: Installation Names451594
Node: Specifying the System Type453700
Node: Sharing Defaults454413
Node: Operation Controls455083
Node: Optional Features456038
Node: Reporting Bugs467253
Node: Major Differences From The Bourne Shell468525
Node: GNU Free Documentation License485372
Node: Indexes510546
Node: Builtin Index510997
Node: Reserved Word Index517821
Node: Variable Index520266
Node: Function Index537037
Node: Concept Index550818
Node: Command Grouping48987
Node: Coprocesses50462
Node: GNU Parallel53122
Node: Shell Functions54036
Node: Shell Parameters61918
Node: Positional Parameters66303
Node: Special Parameters67202
Node: Shell Expansions70413
Node: Brace Expansion72537
Node: Tilde Expansion75268
Node: Shell Parameter Expansion77886
Node: Command Substitution96234
Node: Arithmetic Expansion97586
Node: Process Substitution98551
Node: Word Splitting99668
Node: Filename Expansion101609
Node: Pattern Matching104355
Node: Quote Removal109009
Node: Redirections109301
Node: Executing Commands118958
Node: Simple Command Expansion119625
Node: Command Search and Execution121732
Node: Command Execution Environment124107
Node: Environment127139
Node: Exit Status128799
Node: Signals130580
Node: Shell Scripts134026
Node: Shell Builtin Commands137050
Node: Bourne Shell Builtins139085
Node: Bash Builtins160543
Node: Modifying Shell Behavior191396
Node: The Set Builtin191738
Node: The Shopt Builtin202336
Node: Special Builtins218245
Node: Shell Variables219221
Node: Bourne Shell Variables219655
Node: Bash Variables221756
Node: Bash Features254569
Node: Invoking Bash255579
Node: Bash Startup Files261589
Node: Interactive Shells266717
Node: What is an Interactive Shell?267124
Node: Is this Shell Interactive?267770
Node: Interactive Shell Behavior268582
Node: Bash Conditional Expressions272208
Node: Shell Arithmetic276847
Node: Aliases279788
Node: Arrays282398
Node: The Directory Stack288786
Node: Directory Stack Builtins289567
Node: Controlling the Prompt293824
Node: The Restricted Shell296786
Node: Bash POSIX Mode299393
Node: Shell Compatibility Mode311314
Node: Job Control319354
Node: Job Control Basics319811
Node: Job Control Builtins324810
Node: Job Control Variables330601
Node: Command Line Editing331754
Node: Introduction and Notation333422
Node: Readline Interaction335042
Node: Readline Bare Essentials336230
Node: Readline Movement Commands338010
Node: Readline Killing Commands338967
Node: Readline Arguments340882
Node: Searching341923
Node: Readline Init File344106
Node: Readline Init File Syntax345364
Node: Conditional Init Constructs368560
Node: Sample Init File372753
Node: Bindable Readline Commands375874
Node: Commands For Moving377075
Node: Commands For History379123
Node: Commands For Text384114
Node: Commands For Killing387760
Node: Numeric Arguments390790
Node: Commands For Completion391926
Node: Keyboard Macros396114
Node: Miscellaneous Commands396798
Node: Readline vi Mode402734
Node: Programmable Completion403638
Node: Programmable Completion Builtins411415
Node: A Programmable Completion Example422164
Node: Using History Interactively427408
Node: Bash History Facilities428089
Node: Bash History Builtins431091
Node: History Interaction436096
Node: Event Designators439713
Node: Word Designators441064
Node: Modifiers442821
Node: Installing Bash444629
Node: Basic Installation445763
Node: Compilers and Options449482
Node: Compiling For Multiple Architectures450220
Node: Installation Names451910
Node: Specifying the System Type454016
Node: Sharing Defaults454729
Node: Operation Controls455399
Node: Optional Features456354
Node: Reporting Bugs467569
Node: Major Differences From The Bourne Shell468841
Node: GNU Free Documentation License485688
Node: Indexes510862
Node: Builtin Index511313
Node: Reserved Word Index518137
Node: Variable Index520582
Node: Function Index537353
Node: Concept Index551134

End Tag Table
doc/bashref.info
+128 -124
View File
@@ -950,16 +950,16 @@ File: bashref.info, Node: Conditional Constructs, Next: Command Grouping, Pre
select NAME [in WORDS ...]; do COMMANDS; done
The list of words following 'in' is expanded, generating a list of
items. The set of expanded words is printed on the standard error
output stream, each preceded by a number. If the 'in WORDS' is
omitted, the positional parameters are printed, as if 'in "$@"' had
been specified. The 'PS3' prompt is then displayed and a line is
read from the standard input. If the line consists of a number
corresponding to one of the displayed words, then the value of NAME
is set to that word. If the line is empty, the words and prompt
are displayed again. If 'EOF' is read, the 'select' command
completes. Any other value read causes NAME to be set to null.
The line read is saved in the variable 'REPLY'.
items, and the set of expanded words is printed on the standard
error output stream, each preceded by a number. If the 'in WORDS'
is omitted, the positional parameters are printed, as if 'in "$@"'
had been specified. 'select' then displays the 'PS3' prompt and
reads a line from the standard input. If the line consists of a
number corresponding to one of the displayed words, then the value
of NAME is set to that word. If the line is empty, the words and
prompt are displayed again. If 'EOF' is read, the 'select' command
completes and returns 1. Any other value read causes NAME to be
set to null. The line read is saved in the variable 'REPLY'.
The COMMANDS are executed after each selection until a 'break'
command is executed, at which point the 'select' command completes.
@@ -7295,7 +7295,7 @@ be a temporary solution.
This section does not mention behavior that is standard for a
particular version (e.g., setting 'compat32' means that quoting the rhs
of the regexp matching operator quotes special regexp characters in the
word, which is default behavior in bash-3.2 and above).
word, which is default behavior in bash-3.2 and subsequent versions).
If a user enables, say, 'compat32', it may affect the behavior of
other compatibility levels up to and including the current compatibility
@@ -7639,7 +7639,10 @@ File: bashref.info, Node: Job Control Builtins, Next: Job Control Variables,
'wait' to wait for each PID or JOBSPEC to terminate before
returning its status, intead of returning when it changes status.
If neither JOBSPEC nor PID specifies an active child process of the
shell, the return status is 127.
shell, the return status is 127. If 'wait' is interrupted by a
signal, the return status will be greater than 128, as described
above (*note Signals::). Otherwise, the return status is the exit
status of the last process or job waited for.
'disown'
disown [-ar] [-h] [JOBSPEC ... | PID ... ]
@@ -9699,7 +9702,8 @@ happening.
'-C COMMAND'
COMMAND is executed in a subshell environment, and its output
is used as the possible completions.
is used as the possible completions. Arguments are passed as
with the '-F' option.
'-F FUNCTION'
The shell function FUNCTION is executed in the current shell
@@ -11775,14 +11779,14 @@ D.1 Index of Shell Builtin Commands
* complete: Programmable Completion Builtins.
(line 30)
* compopt: Programmable Completion Builtins.
(line 237)
(line 238)
* continue: Bourne Shell Builtins.
(line 89)
* declare: Bash Builtins. (line 154)
* dirs: Directory Stack Builtins.
(line 7)
* disown: Job Control Builtins.
(line 101)
(line 104)
* echo: Bash Builtins. (line 257)
* enable: Bash Builtins. (line 306)
* eval: Bourne Shell Builtins.
@@ -11831,7 +11835,7 @@ D.1 Index of Shell Builtin Commands
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 594)
* suspend: Job Control Builtins.
(line 113)
(line 116)
* test: Bourne Shell Builtins.
(line 274)
* times: Bourne Shell Builtins.
@@ -12533,114 +12537,114 @@ Node: Lists29272
Node: Compound Commands31067
Node: Looping Constructs32079
Node: Conditional Constructs34574
Node: Command Grouping49041
Node: Coprocesses50519
Node: GNU Parallel53182
Node: Shell Functions54099
Node: Shell Parameters61984
Node: Positional Parameters66372
Node: Special Parameters67274
Node: Shell Expansions70488
Node: Brace Expansion72615
Node: Tilde Expansion75349
Node: Shell Parameter Expansion77970
Node: Command Substitution96321
Node: Arithmetic Expansion97676
Node: Process Substitution98644
Node: Word Splitting99764
Node: Filename Expansion101708
Node: Pattern Matching104457
Node: Quote Removal109114
Node: Redirections109409
Node: Executing Commands119069
Node: Simple Command Expansion119739
Node: Command Search and Execution121849
Node: Command Execution Environment124227
Node: Environment127262
Node: Exit Status128925
Node: Signals130709
Node: Shell Scripts134158
Node: Shell Builtin Commands137185
Node: Bourne Shell Builtins139223
Node: Bash Builtins160684
Node: Modifying Shell Behavior191540
Node: The Set Builtin191885
Node: The Shopt Builtin202486
Node: Special Builtins218398
Node: Shell Variables219377
Node: Bourne Shell Variables219814
Node: Bash Variables221918
Node: Bash Features254734
Node: Invoking Bash255747
Node: Bash Startup Files261760
Node: Interactive Shells266891
Node: What is an Interactive Shell?267301
Node: Is this Shell Interactive?267950
Node: Interactive Shell Behavior268765
Node: Bash Conditional Expressions272394
Node: Shell Arithmetic277036
Node: Aliases279980
Node: Arrays282593
Node: The Directory Stack288984
Node: Directory Stack Builtins289768
Node: Controlling the Prompt294028
Node: The Restricted Shell296993
Node: Bash POSIX Mode299603
Node: Shell Compatibility Mode311527
Node: Job Control319556
Node: Job Control Basics320016
Node: Job Control Builtins325018
Node: Job Control Variables330588
Node: Command Line Editing331744
Node: Introduction and Notation333415
Node: Readline Interaction335038
Node: Readline Bare Essentials336229
Node: Readline Movement Commands338012
Node: Readline Killing Commands338972
Node: Readline Arguments340890
Node: Searching341934
Node: Readline Init File344120
Node: Readline Init File Syntax345381
Node: Conditional Init Constructs368580
Node: Sample Init File372776
Node: Bindable Readline Commands375900
Node: Commands For Moving377104
Node: Commands For History379155
Node: Commands For Text384149
Node: Commands For Killing387798
Node: Numeric Arguments390831
Node: Commands For Completion391970
Node: Keyboard Macros396161
Node: Miscellaneous Commands396848
Node: Readline vi Mode402787
Node: Programmable Completion403694
Node: Programmable Completion Builtins411474
Node: A Programmable Completion Example422169
Node: Using History Interactively427416
Node: Bash History Facilities428100
Node: Bash History Builtins431105
Node: History Interaction436113
Node: Event Designators439733
Node: Word Designators441087
Node: Modifiers442847
Node: Installing Bash444658
Node: Basic Installation445795
Node: Compilers and Options449517
Node: Compiling For Multiple Architectures450258
Node: Installation Names451951
Node: Specifying the System Type454060
Node: Sharing Defaults454776
Node: Operation Controls455449
Node: Optional Features456407
Node: Reporting Bugs467625
Node: Major Differences From The Bourne Shell468900
Node: GNU Free Documentation License485750
Node: Indexes510927
Node: Builtin Index511381
Node: Reserved Word Index518208
Node: Variable Index520656
Node: Function Index537430
Node: Concept Index551214
Node: Command Grouping49062
Node: Coprocesses50540
Node: GNU Parallel53203
Node: Shell Functions54120
Node: Shell Parameters62005
Node: Positional Parameters66393
Node: Special Parameters67295
Node: Shell Expansions70509
Node: Brace Expansion72636
Node: Tilde Expansion75370
Node: Shell Parameter Expansion77991
Node: Command Substitution96342
Node: Arithmetic Expansion97697
Node: Process Substitution98665
Node: Word Splitting99785
Node: Filename Expansion101729
Node: Pattern Matching104478
Node: Quote Removal109135
Node: Redirections109430
Node: Executing Commands119090
Node: Simple Command Expansion119760
Node: Command Search and Execution121870
Node: Command Execution Environment124248
Node: Environment127283
Node: Exit Status128946
Node: Signals130730
Node: Shell Scripts134179
Node: Shell Builtin Commands137206
Node: Bourne Shell Builtins139244
Node: Bash Builtins160705
Node: Modifying Shell Behavior191561
Node: The Set Builtin191906
Node: The Shopt Builtin202507
Node: Special Builtins218419
Node: Shell Variables219398
Node: Bourne Shell Variables219835
Node: Bash Variables221939
Node: Bash Features254755
Node: Invoking Bash255768
Node: Bash Startup Files261781
Node: Interactive Shells266912
Node: What is an Interactive Shell?267322
Node: Is this Shell Interactive?267971
Node: Interactive Shell Behavior268786
Node: Bash Conditional Expressions272415
Node: Shell Arithmetic277057
Node: Aliases280001
Node: Arrays282614
Node: The Directory Stack289005
Node: Directory Stack Builtins289789
Node: Controlling the Prompt294049
Node: The Restricted Shell297014
Node: Bash POSIX Mode299624
Node: Shell Compatibility Mode311548
Node: Job Control319591
Node: Job Control Basics320051
Node: Job Control Builtins325053
Node: Job Control Variables330847
Node: Command Line Editing332003
Node: Introduction and Notation333674
Node: Readline Interaction335297
Node: Readline Bare Essentials336488
Node: Readline Movement Commands338271
Node: Readline Killing Commands339231
Node: Readline Arguments341149
Node: Searching342193
Node: Readline Init File344379
Node: Readline Init File Syntax345640
Node: Conditional Init Constructs368839
Node: Sample Init File373035
Node: Bindable Readline Commands376159
Node: Commands For Moving377363
Node: Commands For History379414
Node: Commands For Text384408
Node: Commands For Killing388057
Node: Numeric Arguments391090
Node: Commands For Completion392229
Node: Keyboard Macros396420
Node: Miscellaneous Commands397107
Node: Readline vi Mode403046
Node: Programmable Completion403953
Node: Programmable Completion Builtins411733
Node: A Programmable Completion Example422485
Node: Using History Interactively427732
Node: Bash History Facilities428416
Node: Bash History Builtins431421
Node: History Interaction436429
Node: Event Designators440049
Node: Word Designators441403
Node: Modifiers443163
Node: Installing Bash444974
Node: Basic Installation446111
Node: Compilers and Options449833
Node: Compiling For Multiple Architectures450574
Node: Installation Names452267
Node: Specifying the System Type454376
Node: Sharing Defaults455092
Node: Operation Controls455765
Node: Optional Features456723
Node: Reporting Bugs467941
Node: Major Differences From The Bourne Shell469216
Node: GNU Free Documentation License486066
Node: Indexes511243
Node: Builtin Index511697
Node: Reserved Word Index518524
Node: Variable Index520972
Node: Function Index537746
Node: Concept Index551530

End Tag Table
doc/bashref.texi
+9 -5
View File
@@ -1096,16 +1096,16 @@ select @var{name} [in @var{words} @dots{}]; do @var{commands}; done
@end example
The list of words following @code{in} is expanded, generating a list
of items. The set of expanded words is printed on the standard
of items, and the set of expanded words is printed on the standard
error output stream, each preceded by a number. If the
@samp{in @var{words}} is omitted, the positional parameters are printed,
as if @samp{in "$@@"} had been specified.
The @env{PS3} prompt is then displayed and a line is read from the
standard input.
@code{select} then displays the @env{PS3}
prompt and reads a line from the standard input.
If the line consists of a number corresponding to one of the displayed
words, then the value of @var{name} is set to that word.
If the line is empty, the words and prompt are displayed again.
If @code{EOF} is read, the @code{select} command completes.
If @code{EOF} is read, the @code{select} command completes and returns 1.
Any other value read causes @var{name} to be set to null.
The line read is saved in the variable @env{REPLY}.
@@ -8464,7 +8464,7 @@ behavior. It's intended to be a temporary solution.
This section does not mention behavior that is standard for a particular
version (e.g., setting @code{compat32} means that quoting the rhs of the regexp
matching operator quotes special regexp characters in the word, which is
default behavior in bash-3.2 and above).
default behavior in bash-3.2 and subsequent versions).
If a user enables, say, @code{compat32}, it may affect the behavior of other
compatibility levels up to and including the current compatibility level.
@@ -8896,6 +8896,10 @@ terminate before returning its status, intead of returning when it changes
status.
If neither @var{jobspec} nor @var{pid} specifies an active child process
of the shell, the return status is 127.
If @code{wait} is interrupted by a signal, the return status will be greater
than 128, as described above (@pxref{Signals}).
Otherwise, the return status is the exit status
of the last process or job waited for.
@item disown
@btindex disown