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

bash-5.1 beta release

Browse Source
This commit is contained in:
Chet Ramey
2020-09-09 15:25:32 -04:00
parent 712f80b0a4
commit 3eb0018e75
195 changed files with 16779 additions and 14645 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/bash.0
+479 -471
View File
File diff suppressed because it is too large Load Diff
doc/bash.1
+25 -15
View File
@@ -5,12 +5,12 @@
.\" Case Western Reserve University
.\" chet.ramey@case.edu
.\"
.\" Last Change: Fri Jun 5 14:46:57 EDT 2020
.\" Last Change: Tue Aug 25 09:58:55 EDT 2020
.\"
.\" bash_builtins, strip all but Built-Ins section
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH BASH 1 "2020 June 5" "GNU Bash 5.1"
.TH BASH 1 "2020 August 25" "GNU Bash 5.1"
.\"
.\" There's some problem with having a `@'
.\" in a tagged paragraph with the BSD man macros.
@@ -2037,7 +2037,8 @@ below.
.B BASH_COMPAT
The value is used to set the shell's compatibility level.
See
\fBSHELL COMPATIBILITY MODE\fP
.SM
.B SHELL COMPATIBILITY MODE
below for a description of the various compatibility
levels and their effects.
The value may be a decimal number (e.g., 4.2) or an integer (e.g., 42)
@@ -2049,7 +2050,8 @@ compatibility levels, the shell prints an error message and sets the
compatibility level to the default for the current version.
The valid values correspond to the compatibility levels
described below under
\fBSHELL COMPATIBILITY MODE\fP.
.SM
.BR BSHELL COMPATIBILITY MODE .
For example, 4.2 and 42 are valid values that correspond
to the \fBcompat42\fP \fBshopt\fP option
and set the compatibility level to 42.
@@ -2473,13 +2475,12 @@ had been executed.
When the shell enters \fIposix mode\fP, it sets this variable if it was
not already set.
.TP
.B PROMPT_COMMANDS
If this array variable is set,
.B PROMPT_COMMAND
If this variable is set, and is an array,
the value of each set element is executed as a command
prior to issuing each primary prompt.
If this is not set, but
.B PROMPT_COMMAND
is set to a value, its value is used as a command to execute instead.
If this is set but not an array variable,
its value is used as a command to execute instead.
.TP
.B PROMPT_DIRTRIM
If set to a number greater than zero, the value is used as the number of
@@ -5793,11 +5794,11 @@ replaced with an ellipsis when displaying possible completions.
This determines when the user is queried about viewing
the number of possible completions
generated by the \fBpossible\-completions\fP command.
It may be set to any integer value greater than or equal to
zero. If the number of possible completions is greater than
or equal to the value of this variable, the user is asked whether
or not he wishes to view them; otherwise they are simply listed
on the terminal.
It may be set to any integer value greater than or equal to zero.
If the number of possible completions is greater than
or equal to the value of this variable,
readline will ask whether or not the user wishes to view them;
otherwise they are simply listed on the terminal.
.TP
.B convert\-meta (On)
If set to \fBOn\fP, readline will convert characters with the
@@ -8960,6 +8961,8 @@ If \fIname\fP is \-, the set of shell options is made local to the function
in which \fBlocal\fP is invoked: shell options changed using the
\fBset\fP builtin inside the function are restored to their original values
when the function returns.
The restore is effected as if a series of \fBset\fP commands were executed
to restore the values that were in place before the function.
With no operands,
.B local
writes a list of local variables to the standard output. It is
@@ -9337,7 +9340,9 @@ Read input from file descriptor \fIfd\fP.
.PP
If no
.I names
are supplied, the line read is assigned to the variable
are supplied, the line read,
without the ending delimiter but otherwise unmodified,
is assigned to the variable
.SM
.BR REPLY .
The exit status is zero, unless end-of-file is encountered, \fBread\fP
@@ -11058,6 +11063,11 @@ so seeding the random number generator by assigning a value to
.SM
.B RANDOM
will produce the same sequence as in bash-5.0
.IP \(bu
If the command hash table is empty, bash versions prior to bash-5.1
printed an informational message to that effect, even when producing
output that can be reused as input. Bash-5.1 suppresses that message
when the \fB\-l\fP option is supplied.
.RE
.PD
.\" bash_builtins
doc/bash.html
+28 -17
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2020 June 5<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2020 August 25<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -2589,7 +2589,9 @@ below.
<DD>
The value is used to set the shell's compatibility level.
See
<B>SHELL COMPATIBILITY MODE</B>
<FONT SIZE=-1><B>SHELL COMPATIBILITY MODE</B>
</FONT>
below for a description of the various compatibility
levels and their effects.
The value may be a decimal number (e.g., 4.2) or an integer (e.g., 42)
@@ -2601,7 +2603,9 @@ compatibility levels, the shell prints an error message and sets the
compatibility level to the default for the current version.
The valid values correspond to the compatibility levels
described below under
<B>SHELL COMPATIBILITY MODE</B>.
<FONT SIZE=-1><B>BSHELL</B>COMPATIBILITY<B>MODE</B>.
</FONT>
For example, 4.2 and 42 are valid values that correspond
to the <B>compat42</B> <B>shopt</B> option
and set the compatibility level to 42.
@@ -3125,16 +3129,14 @@ running, <B>bash</B> enables <I>posix mode</I>, as if the command
had been executed.
When the shell enters <I>posix mode</I>, it sets this variable if it was
not already set.
<DT><B>PROMPT_COMMANDS</B>
<DT><B>PROMPT_COMMAND</B>
<DD>
If this array variable is set,
If this variable is set, and is an array,
the value of each set element is executed as a command
prior to issuing each primary prompt.
If this is not set, but
<B>PROMPT_COMMAND</B>
is set to a value, its value is used as a command to execute instead.
If this is set but not an array variable,
its value is used as a command to execute instead.
<DT><B>PROMPT_DIRTRIM</B>
<DD>
@@ -7392,11 +7394,11 @@ replaced with an ellipsis when displaying possible completions.
This determines when the user is queried about viewing
the number of possible completions
generated by the <B>possible-completions</B> command.
It may be set to any integer value greater than or equal to
zero. If the number of possible completions is greater than
or equal to the value of this variable, the user is asked whether
or not he wishes to view them; otherwise they are simply listed
on the terminal.
It may be set to any integer value greater than or equal to zero.
If the number of possible completions is greater than
or equal to the value of this variable,
readline will ask whether or not the user wishes to view them;
otherwise they are simply listed on the terminal.
<DT><B>convert-meta (On)</B>
<DD>
@@ -11307,6 +11309,8 @@ If <I>name</I> is -, the set of shell options is made local to the function
in which <B>local</B> is invoked: shell options changed using the
<B>set</B> builtin inside the function are restored to their original values
when the function returns.
The restore is effected as if a series of <B>set</B> commands were executed
to restore the values that were in place before the function.
With no operands,
<B>local</B>
@@ -11765,7 +11769,9 @@ Read input from file descriptor <I>fd</I>.
If no
<I>names</I>
are supplied, the line read is assigned to the variable
are supplied, the line read,
without the ending delimiter but otherwise unmodified,
is assigned to the variable
<FONT SIZE=-1><B>REPLY</B>.
</FONT>
@@ -13944,6 +13950,11 @@ so seeding the random number generator by assigning a value to
</FONT>
will produce the same sequence as in bash-5.0
<DT>*<DD>
If the command hash table is empty, bash versions prior to bash-5.1
printed an informational message to that effect, even when producing
output that can be reused as input. Bash-5.1 suppresses that message
when the <B>-l</B> option is supplied.
</DL></DL>
@@ -14241,7 +14252,7 @@ There may be only one active coprocess at a time.
<HR>
<TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>GNU Bash 5.1<TH ALIGN=CENTER width=33%>2020 June 5<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash 5.1<TH ALIGN=CENTER width=33%>2020 August 25<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -14348,6 +14359,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 10 June 2020 12:00:48 EDT
Time: 07 September 2020 09:52:27 EDT
</BODY>
</HTML>
doc/bash.info
+213 -197
View File
@@ -2,9 +2,9 @@ This is bash.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, 5 June 2020).
Bash shell (version 5.1, 25 August 2020).
This is Edition 5.1, last updated 5 June 2020, of 'The GNU Bash
This is Edition 5.1, last updated 25 August 2020, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.1.
Copyright (C) 1988-2018 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, 5 June 2020). The Bash home page is
Bash shell (version 5.1, 25 August 2020). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.1, last updated 5 June 2020, of 'The GNU Bash
This is Edition 5.1, last updated 25 August 2020, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.1.
Bash contains features that appear in other popular shells, and some
@@ -2322,7 +2322,7 @@ file descriptor greater than 10 and assign it to {VARNAME}. If >&- or
<&- is preceded by {VARNAME}, the value of VARNAME defines the file
descriptor to close. If {VARNAME} is supplied, the redirection persists
beyond the scope of the command, allowing the shell programmer to manage
the file descriptor himself.
the file descriptor's lifetime manually.
In the following descriptions, if the file descriptor number is
omitted, and the first character of the redirection operator is '<', the
@@ -3202,12 +3202,12 @@ standard.
Shift the positional parameters to the left by N. The positional
parameters from N+1 ... '$#' are renamed to '$1' ... '$#'-N.
Parameters represented by the numbers '$#' to '$#'-N+1 are unset.
N must be a non-negative number less than or equal to '$#'. If N
is zero or greater than '$#', the positional parameters are not
changed. If N is not supplied, it is assumed to be 1. The return
status is zero unless N is greater than '$#' or less than zero,
non-zero otherwise.
Parameters represented by the numbers '$#' down to '$#'-N+1 are
unset. N must be a non-negative number less than or equal to '$#'.
If N is zero or greater than '$#', the positional parameters are
not changed. If N is not supplied, it is assumed to be 1. The
return status is zero unless N is greater than '$#' or less than
zero, non-zero otherwise.
'test'
'['
@@ -3746,9 +3746,11 @@ standard.
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 return status
is zero unless 'local' is used outside a function, an invalid NAME
is supplied, or NAME is a readonly variable.
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]
@@ -3866,13 +3868,7 @@ standard.
line into words using the same rules the shell uses for expansion
(described above in *note Word Splitting::). The backslash
character '\' may be used to remove any special meaning for the
next character read and for line continuation. If no names are
supplied, the line read is assigned to the variable 'REPLY'. The
exit status is zero, unless end-of-file is encountered, 'read'
times out (in which case the status is greater than 128), a
variable assignment error (such as assigning to a readonly
variable) occurs, or an invalid file descriptor is supplied as the
argument to '-u'.
next character read and for line continuation.
Options, if supplied, have the following meanings:
@@ -3944,6 +3940,14 @@ standard.
'-u FD'
Read input from file descriptor FD.
If no NAMEs are supplied, the line read, without the ending
delimiter but otherwise unmodified, is assigned to the variable
'REPLY'. The exit status is zero, unless end-of-file is
encountered, 'read' times out (in which case the status is greater
than 128), a variable assignment error (such as assigning to a
readonly variable) occurs, or an invalid file descriptor is
supplied as the argument to '-u'.
'readarray'
readarray [-d DELIM] [-n COUNT] [-O ORIGIN] [-s COUNT]
[-t] [-u FD] [-C CALLBACK] [-c QUANTUM] [ARRAY]
@@ -4746,11 +4750,6 @@ This builtin allows you to change additional shell optional behavior.
If set, the 'echo' builtin expands backslash-escape sequences
by default.
The return status when listing options is zero if all OPTNAMES are
enabled, non-zero otherwise. When setting or unsetting options,
the return status is zero unless an OPTNAME is not a valid shell
option.

File: bash.info, Node: Special Builtins, Prev: Modifying Shell Behavior, Up: Shell Builtin Commands
@@ -5423,11 +5422,11 @@ Variables::).
The process ID of the shell's parent process. This variable is
readonly.
'PROMPT_COMMANDS'
If this array variable is set, the value of each set element is
interpreted as a command to execute before printing the primary
prompt ('$PS1'). If this is not set, but 'PROMPT_COMMAND' is set
to a value, its value is used as a command to execute instead.
'PROMPT_COMMAND'
If this variable is set, and is an array, the value of each set
element is interpreted as a command to execute before printing the
primary prompt ('$PS1'). If this is set but not an array variable,
its value is used as a command to execute instead.
'PROMPT_DIRTRIM'
If set to a number greater than zero, the value is used as the
@@ -7032,6 +7031,10 @@ required for bash-5.1 and later versions.
previous versions, so seeding the random number generator by
assigning a value to 'RANDOM' will produce the same sequence
as in bash-5.0
* If the command hash table is empty, Bash versions prior to
bash-5.1 printed an informational message to that effect, even
when producing output that can be reused as input. Bash-5.1
suppresses that message when the '-l' option is supplied.

File: bash.info, Node: Job Control, Next: Command Line Editing, Prev: Bash Features, Up: Top
@@ -7698,11 +7701,11 @@ Variable Settings
The number of possible completions that determines when the
user is asked whether the list of possibilities should be
displayed. If the number of possible completions is greater
than this value, Readline will ask the user whether or not he
wishes to view them; otherwise, they are simply listed. This
variable must be set to an integer value greater than or equal
to 0. A negative value means Readline should never ask. The
default limit is '100'.
than or equal to this value, Readline will ask whether or not
the user wishes to view them; otherwise, they are simply
listed. This variable must be set to an integer value greater
than or equal to 0. A negative value means Readline should
never ask. The default limit is '100'.
'convert-meta'
If set to 'on', Readline will convert characters with the
@@ -8229,8 +8232,8 @@ variable assignment, and conditional syntax.
# rather than as meta-prefixed characters
set output-meta on
# if there are more than 150 possible completions for
# a word, ask the user if he wants to see all of them
# if there are 150 or more possible completions for a word,
# ask whether or not the user wants to see all of them
set completion-query-items 150
# For FTP
@@ -8358,10 +8361,14 @@ File: bash.info, Node: Commands For History, Next: Commands For Text, Prev: C
'reverse-search-history (C-r)'
Search backward starting at the current line and moving 'up'
through the history as necessary. This is an incremental search.
This command sets the region to the matched text and activates the
mark.
'forward-search-history (C-s)'
Search forward starting at the current line and moving 'down'
through the history as necessary. This is an incremental search.
This command sets the region to the matched text and activates the
mark.
'non-incremental-reverse-search-history (M-p)'
Search backward starting at the current line and moving 'up'
@@ -8469,6 +8476,11 @@ File: bash.info, Node: Commands For Text, Next: Commands For Killing, Prev: C
was bound to 'self-insert' instead of executing any editing
commands.
Bracketed paste sets the region (the characters between point and
the mark) to the inserted text. It uses the concept of an _active
mark_: when the mark is active, Readline redisplay uses the
terminal's standout mode to denote the region.
'transpose-chars (C-t)'
Drag the character before the cursor forward over the character at
the cursor, moving the cursor forward as well. If the insertion
@@ -8513,10 +8525,14 @@ File: bash.info, Node: Commands For Killing, Next: Numeric Arguments, Prev: C
-------------------------
'kill-line (C-k)'
Kill the text from point to the end of the line.
Kill the text from point to the end of the line. With a negative
numeric argument, kill backward from the cursor to the beginning of
the current line.
'backward-kill-line (C-x Rubout)'
Kill backward from the cursor to the beginning of the current line.
With a negative numeric argument, kill forward from the cursor to
the end of the current line.
'unix-line-discard (C-u)'
Kill backward from the cursor to the beginning of the current line.
@@ -11284,17 +11300,17 @@ D.1 Index of Shell Builtin Commands
(line 58)
* let: Bash Builtins. (line 350)
* local: Bash Builtins. (line 358)
* logout: Bash Builtins. (line 372)
* mapfile: Bash Builtins. (line 377)
* logout: Bash Builtins. (line 374)
* mapfile: Bash Builtins. (line 379)
* popd: Directory Stack Builtins.
(line 35)
* printf: Bash Builtins. (line 423)
* printf: Bash Builtins. (line 425)
* pushd: Directory Stack Builtins.
(line 53)
* pwd: Bourne Shell Builtins.
(line 207)
* read: Bash Builtins. (line 472)
* readarray: Bash Builtins. (line 566)
* read: Bash Builtins. (line 474)
* readarray: Bash Builtins. (line 570)
* readonly: Bourne Shell Builtins.
(line 217)
* return: Bourne Shell Builtins.
@@ -11303,7 +11319,7 @@ D.1 Index of Shell Builtin Commands
* shift: Bourne Shell Builtins.
(line 257)
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 575)
* source: Bash Builtins. (line 579)
* suspend: Job Control Builtins.
(line 113)
* test: Bourne Shell Builtins.
@@ -11312,12 +11328,12 @@ D.1 Index of Shell Builtin Commands
(line 349)
* trap: Bourne Shell Builtins.
(line 355)
* type: Bash Builtins. (line 580)
* typeset: Bash Builtins. (line 612)
* ulimit: Bash Builtins. (line 618)
* type: Bash Builtins. (line 584)
* typeset: Bash Builtins. (line 616)
* ulimit: Bash Builtins. (line 622)
* umask: Bourne Shell Builtins.
(line 404)
* unalias: Bash Builtins. (line 721)
* unalias: Bash Builtins. (line 725)
* unset: Bourne Shell Builtins.
(line 422)
* wait: Job Control Builtins.
@@ -11551,7 +11567,7 @@ D.3 Parameter and Variable Index
* PIPESTATUS: Bash Variables. (line 553)
* POSIXLY_CORRECT: Bash Variables. (line 558)
* PPID: Bash Variables. (line 568)
* PROMPT_COMMANDS: Bash Variables. (line 572)
* PROMPT_COMMAND: Bash Variables. (line 572)
* PROMPT_DIRTRIM: Bash Variables. (line 578)
* PS0: Bash Variables. (line 584)
* PS1: Bourne Shell Variables.
@@ -11612,16 +11628,16 @@ D.4 Function Index
* backward-char (C-b): Commands For Moving. (line 15)
* backward-delete-char (Rubout): Commands For Text. (line 17)
* backward-kill-line (C-x Rubout): Commands For Killing.
(line 9)
(line 11)
* backward-kill-word (M-<DEL>): Commands For Killing.
(line 24)
(line 28)
* backward-word (M-b): Commands For Moving. (line 22)
* beginning-of-history (M-<): Commands For History.
(line 20)
* beginning-of-line (C-a): Commands For Moving. (line 6)
* bracketed-paste-begin (): Commands For Text. (line 33)
* call-last-kbd-macro (C-x e): Keyboard Macros. (line 13)
* capitalize-word (M-c): Commands For Text. (line 61)
* capitalize-word (M-c): Commands For Text. (line 66)
* character-search (C-]): Miscellaneous Commands.
(line 42)
* character-search-backward (M-C-]): Miscellaneous Commands.
@@ -11643,24 +11659,24 @@ D.4 Function Index
* complete-variable (M-$): Commands For Completion.
(line 64)
* copy-backward-word (): Commands For Killing.
(line 65)
(line 69)
* copy-forward-word (): Commands For Killing.
(line 70)
(line 74)
* copy-region-as-kill (): Commands For Killing.
(line 61)
(line 65)
* dabbrev-expand (): Commands For Completion.
(line 95)
* delete-char (C-d): Commands For Text. (line 12)
* delete-char-or-list (): Commands For Completion.
(line 43)
* delete-horizontal-space (): Commands For Killing.
(line 53)
(line 57)
* digit-argument (M-0, M-1, ... M--): Numeric Arguments. (line 6)
* display-shell-version (C-x C-v): Miscellaneous Commands.
(line 110)
* do-lowercase-version (M-A, M-B, M-X, ...): Miscellaneous Commands.
(line 14)
* downcase-word (M-l): Commands For Text. (line 57)
* downcase-word (M-l): Commands For Text. (line 62)
* dump-functions (): Miscellaneous Commands.
(line 74)
* dump-macros (): Miscellaneous Commands.
@@ -11681,7 +11697,7 @@ D.4 Function Index
* forward-backward-delete-char (): Commands For Text. (line 21)
* forward-char (C-f): Commands For Moving. (line 12)
* forward-search-history (C-s): Commands For History.
(line 31)
(line 33)
* forward-word (M-f): Commands For Moving. (line 18)
* glob-complete-word (M-g): Miscellaneous Commands.
(line 92)
@@ -11694,13 +11710,13 @@ D.4 Function Index
* history-expand-line (M-^): Miscellaneous Commands.
(line 118)
* history-search-backward (): Commands For History.
(line 53)
(line 57)
* history-search-forward (): Commands For History.
(line 47)
(line 51)
* history-substring-search-backward (): Commands For History.
(line 65)
(line 69)
* history-substring-search-forward (): Commands For History.
(line 59)
(line 63)
* insert-comment (M-#): Miscellaneous Commands.
(line 61)
* insert-completions (M-*): Commands For Completion.
@@ -11710,11 +11726,11 @@ D.4 Function Index
* kill-line (C-k): Commands For Killing.
(line 6)
* kill-region (): Commands For Killing.
(line 57)
(line 61)
* kill-whole-line (): Commands For Killing.
(line 15)
* kill-word (M-d): Commands For Killing.
(line 19)
* kill-word (M-d): Commands For Killing.
(line 23)
* magic-space (): Miscellaneous Commands.
(line 121)
* menu-complete (): Commands For Completion.
@@ -11725,12 +11741,12 @@ D.4 Function Index
(line 17)
* next-screen-line (): Commands For Moving. (line 41)
* non-incremental-forward-search-history (M-n): Commands For History.
(line 41)
(line 45)
* non-incremental-reverse-search-history (M-p): Commands For History.
(line 35)
(line 39)
* operate-and-get-next (C-o): Commands For History.
(line 92)
* overwrite-mode (): Commands For Text. (line 65)
(line 96)
* overwrite-mode (): Commands For Text. (line 70)
* possible-command-completions (C-x !): Commands For Completion.
(line 86)
* possible-completions (M-?): Commands For Completion.
@@ -11761,40 +11777,40 @@ D.4 Function Index
* set-mark (C-@): Miscellaneous Commands.
(line 33)
* shell-backward-kill-word (): Commands For Killing.
(line 33)
(line 37)
* shell-backward-word (M-C-b): Commands For Moving. (line 30)
* shell-expand-line (M-C-e): Miscellaneous Commands.
(line 113)
* shell-forward-word (M-C-f): Commands For Moving. (line 26)
* shell-kill-word (M-C-d): Commands For Killing.
(line 28)
(line 32)
* shell-transpose-words (M-C-t): Commands For Killing.
(line 37)
(line 41)
* skip-csi-sequence (): Miscellaneous Commands.
(line 52)
* start-kbd-macro (C-x (): Keyboard Macros. (line 6)
* tilde-expand (M-&): Miscellaneous Commands.
(line 30)
* transpose-chars (C-t): Commands For Text. (line 42)
* transpose-words (M-t): Commands For Text. (line 48)
* transpose-chars (C-t): Commands For Text. (line 47)
* transpose-words (M-t): Commands For Text. (line 53)
* undo (C-_ or C-x C-u): Miscellaneous Commands.
(line 23)
* universal-argument (): Numeric Arguments. (line 10)
* unix-filename-rubout (): Commands For Killing.
(line 48)
(line 52)
* unix-line-discard (C-u): Commands For Killing.
(line 12)
(line 16)
* unix-word-rubout (C-w): Commands For Killing.
(line 44)
* upcase-word (M-u): Commands For Text. (line 53)
(line 48)
* upcase-word (M-u): Commands For Text. (line 58)
* yank (C-y): Commands For Killing.
(line 75)
(line 79)
* yank-last-arg (M-. or M-_): Commands For History.
(line 80)
(line 84)
* yank-nth-arg (M-C-y): Commands For History.
(line 71)
(line 75)
* yank-pop (M-y): Commands For Killing.
(line 78)
(line 82)

File: bash.info, Node: Concept Index, Prev: Function Index, Up: Indexes
@@ -11963,66 +11979,66 @@ 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 Character14454
Node: Single Quotes14939
Node: Double Quotes15287
Node: ANSI-C Quoting16565
Node: Locale Translation17824
Node: Comments18977
Node: Shell Commands19595
Node: Reserved Words20533
Node: Simple Commands21289
Node: Pipelines21943
Node: Lists24875
Node: Compound Commands26666
Node: Looping Constructs27678
Node: Conditional Constructs30173
Node: Command Grouping41744
Node: Coprocesses43223
Node: GNU Parallel45126
Node: Shell Functions49427
Node: Shell Parameters56634
Node: Positional Parameters61047
Node: Special Parameters61947
Node: Shell Expansions65171
Node: Brace Expansion67294
Node: Tilde Expansion70017
Node: Shell Parameter Expansion72634
Node: Command Substitution87763
Node: Arithmetic Expansion89118
Node: Process Substitution90050
Node: Word Splitting91170
Node: Filename Expansion93114
Node: Pattern Matching95663
Node: Quote Removal99649
Node: Redirections99944
Node: Executing Commands109502
Node: Simple Command Expansion110172
Node: Command Search and Execution112126
Node: Command Execution Environment114502
Node: Environment117486
Node: Exit Status119145
Node: Signals120815
Node: Shell Scripts122782
Node: Shell Builtin Commands125794
Node: Bourne Shell Builtins127832
Node: Bash Builtins148756
Node: Modifying Shell Behavior178486
Node: The Set Builtin178831
Node: The Shopt Builtin189244
Node: Special Builtins204380
Node: Shell Variables205359
Node: Bourne Shell Variables205796
Node: Bash Variables207900
Node: Top893
Node: Introduction2809
Node: What is Bash?3025
Node: What is a shell?4139
Node: Definitions6677
Node: Basic Shell Features9628
Node: Shell Syntax10847
Node: Shell Operation11873
Node: Quoting13166
Node: Escape Character14466
Node: Single Quotes14951
Node: Double Quotes15299
Node: ANSI-C Quoting16577
Node: Locale Translation17836
Node: Comments18989
Node: Shell Commands19607
Node: Reserved Words20545
Node: Simple Commands21301
Node: Pipelines21955
Node: Lists24887
Node: Compound Commands26678
Node: Looping Constructs27690
Node: Conditional Constructs30185
Node: Command Grouping41756
Node: Coprocesses43235
Node: GNU Parallel45138
Node: Shell Functions49439
Node: Shell Parameters56646
Node: Positional Parameters61059
Node: Special Parameters61959
Node: Shell Expansions65183
Node: Brace Expansion67306
Node: Tilde Expansion70029
Node: Shell Parameter Expansion72646
Node: Command Substitution87775
Node: Arithmetic Expansion89130
Node: Process Substitution90062
Node: Word Splitting91182
Node: Filename Expansion93126
Node: Pattern Matching95675
Node: Quote Removal99661
Node: Redirections99956
Node: Executing Commands109526
Node: Simple Command Expansion110196
Node: Command Search and Execution112150
Node: Command Execution Environment114526
Node: Environment117510
Node: Exit Status119169
Node: Signals120839
Node: Shell Scripts122806
Node: Shell Builtin Commands125818
Node: Bourne Shell Builtins127856
Node: Bash Builtins148785
Node: Modifying Shell Behavior178720
Node: The Set Builtin179065
Node: The Shopt Builtin189478
Node: Special Builtins204388
Node: Shell Variables205367
Node: Bourne Shell Variables205804
Node: Bash Variables207908
Node: Bash Features240478
Node: Invoking Bash241491
Node: Bash Startup Files247504
@@ -12040,60 +12056,60 @@ Node: Controlling the Prompt277893
Node: The Restricted Shell280843
Node: Bash POSIX Mode283437
Node: Shell Compatibility Mode294473
Node: Job Control300848
Node: Job Control Basics301308
Node: Job Control Builtins306304
Node: Job Control Variables311704
Node: Command Line Editing312860
Node: Introduction and Notation314531
Node: Readline Interaction316154
Node: Readline Bare Essentials317345
Node: Readline Movement Commands319128
Node: Readline Killing Commands320088
Node: Readline Arguments322006
Node: Searching323050
Node: Readline Init File325236
Node: Readline Init File Syntax326495
Node: Conditional Init Constructs347025
Node: Sample Init File351221
Node: Bindable Readline Commands354338
Node: Commands For Moving355542
Node: Commands For History357593
Node: Commands For Text362220
Node: Commands For Killing365608
Node: Numeric Arguments368423
Node: Commands For Completion369562
Node: Keyboard Macros373753
Node: Miscellaneous Commands374440
Node: Readline vi Mode380124
Node: Programmable Completion381031
Node: Programmable Completion Builtins388811
Node: A Programmable Completion Example399506
Node: Using History Interactively404753
Node: Bash History Facilities405437
Node: Bash History Builtins408442
Node: History Interaction413171
Node: Event Designators416791
Node: Word Designators418145
Node: Modifiers419905
Node: Installing Bash421716
Node: Basic Installation422853
Node: Compilers and Options426111
Node: Compiling For Multiple Architectures426852
Node: Installation Names428545
Node: Specifying the System Type429363
Node: Sharing Defaults430079
Node: Operation Controls430752
Node: Optional Features431710
Node: Reporting Bugs442228
Node: Major Differences From The Bourne Shell443422
Node: GNU Free Documentation License460274
Node: Indexes485451
Node: Builtin Index485905
Node: Reserved Word Index492732
Node: Variable Index495180
Node: Function Index511077
Node: Concept Index524587
Node: Job Control301129
Node: Job Control Basics301589
Node: Job Control Builtins306585
Node: Job Control Variables311985
Node: Command Line Editing313141
Node: Introduction and Notation314812
Node: Readline Interaction316435
Node: Readline Bare Essentials317626
Node: Readline Movement Commands319409
Node: Readline Killing Commands320369
Node: Readline Arguments322287
Node: Searching323331
Node: Readline Init File325517
Node: Readline Init File Syntax326776
Node: Conditional Init Constructs347315
Node: Sample Init File351511
Node: Bindable Readline Commands354635
Node: Commands For Moving355839
Node: Commands For History357890
Node: Commands For Text362683
Node: Commands For Killing366332
Node: Numeric Arguments369365
Node: Commands For Completion370504
Node: Keyboard Macros374695
Node: Miscellaneous Commands375382
Node: Readline vi Mode381066
Node: Programmable Completion381973
Node: Programmable Completion Builtins389753
Node: A Programmable Completion Example400448
Node: Using History Interactively405695
Node: Bash History Facilities406379
Node: Bash History Builtins409384
Node: History Interaction414113
Node: Event Designators417733
Node: Word Designators419087
Node: Modifiers420847
Node: Installing Bash422658
Node: Basic Installation423795
Node: Compilers and Options427053
Node: Compiling For Multiple Architectures427794
Node: Installation Names429487
Node: Specifying the System Type430305
Node: Sharing Defaults431021
Node: Operation Controls431694
Node: Optional Features432652
Node: Reporting Bugs443170
Node: Major Differences From The Bourne Shell444364
Node: GNU Free Documentation License461216
Node: Indexes486393
Node: Builtin Index486847
Node: Reserved Word Index493674
Node: Variable Index496122
Node: Function Index512019
Node: Concept Index525529

End Tag Table
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bash.ps
+1242 -1225
View File
File diff suppressed because it is too large Load Diff
doc/bashbug.0
+4 -3
View File
@@ -29,9 +29,10 @@ EENNVVIIRROONNMMEENNTT
EEDDIITTOORR Specifies the preferred editor. If EEDDIITTOORR is not set, bbaasshhbbuugg
attempts to locate a number of alternative editors, including
eemmaaccss, and defaults to vvii.
eemmaaccss. If bbaasshhbbuugg cannot locate any of the alternative editors,
it attempts to execute vvii.
HHOOMMEE Directory in which the failed bug report is saved if the mail
HHOOMMEE Directory in which the failed bug report is saved if the mail
fails.
TTMMPPDDIIRR Directory in which to create temporary files and directories.
@@ -48,4 +49,4 @@ AAUUTTHHOORRSS
GNU Bash-4.4 2016 February 15 BASHBUG(1)
GNU Bash 5.1 2020 August 1 BASHBUG(1)
doc/bashbug.1
+6 -4
View File
@@ -5,9 +5,9 @@
.\" Case Western Reserve University
.\" chet@po.cwru.edu
.\"
.\" Last Change: Mon Feb 15 14:42:40 EST 2016
.\" Last Change: Sun Aug 2 15:39:07 EDT 2020
.\"
.TH BASHBUG 1 "2016 February 15" "GNU Bash-4.4"
.TH BASHBUG 1 "2020 August 1" "GNU Bash 5.1"
.SH NAME
bashbug \- report a bug in bash
.SH SYNOPSIS
@@ -44,8 +44,10 @@ Specifies the preferred editor. If
is not set,
.B bashbug
attempts to locate a number of alternative editors, including
.BR emacs ,
and defaults to \fBvi\fP.
.BR emacs .
If
.B bashbug
cannot locate any of the alternative editors, it attempts to execute \fBvi\fP.
.TP
.B HOME
Directory in which the failed bug report is saved if the mail fails.
doc/bashbug.ps
+19 -16
View File
@@ -1,10 +1,10 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.3
%%CreationDate: Mon Mar 28 15:34:55 2016
%%Creator: groff version 1.22.4
%%CreationDate: Fri Aug 7 11:58:10 2020
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
%%DocumentSuppliedResources: procset grops 1.22 3
%%DocumentSuppliedResources: procset grops 1.22 4
%%Pages: 1
%%PageOrder: Ascend
%%DocumentMedia: Default 612 792 0 () ()
@@ -14,7 +14,7 @@
%%PageMedia: Default
%%EndDefaults
%%BeginProlog
%%BeginResource: procset grops 1.22 3
%%BeginResource: procset grops 1.22 4
%!PS-Adobe-3.0 Resource-ProcSet
/setpacking where{
pop
@@ -275,20 +275,23 @@ E(vironment v)-.4 E(ariables if the)-.25 E 2.5(ye)-.15 G(xist:)-2.65 E
F2(EDIT)108 300 Q(OR)-.18 E F0 .327(Speci\214es the preferred editor)144
312 R 2.827(.I)-.55 G(f)-2.827 E F4(EDIT)2.827 E(OR)-.162 E F0 .327
(is not set,)2.577 F F2(bashb)2.827 E(ug)-.2 E F0 .328
(attempts to locate a number of alter)2.827 F(-)-.2 E(nati)144 324 Q .3
-.15(ve e)-.25 H(ditors, including).15 E F2(emacs)2.5 E F0 2.5(,a)C
(nd def)-2.5 E(aults to)-.1 E F2(vi)2.5 E F0(.)A F2(HOME)108 340.8 Q F0
(Directory in which the f)144 352.8 Q(ailed b)-.1 E(ug report is sa)-.2
E -.15(ve)-.2 G 2.5(di).15 G 2.5(ft)-2.5 G(he mail f)-2.5 E(ails.)-.1 E
F2(TMPDIR)108 369.6 Q F0
(attempts to locate a number of alter)2.827 F(-)-.2 E(nati)144 324 Q
1.925 -.15(ve e)-.25 H 1.625(ditors, including).15 F F2(emacs)4.125 E F0
6.625(.I)C(f)-6.625 E F2(bashb)4.125 E(ug)-.2 E F0 1.625
(cannot locate an)4.125 F 4.125(yo)-.15 G 4.125(ft)-4.125 G 1.625
(he alternati)-4.125 F 1.925 -.15(ve e)-.25 H 1.625(ditors, it at-).15 F
(tempts to e)144 336 Q -.15(xe)-.15 G(cute).15 E F2(vi)2.5 E F0(.)A F2
(HOME)108 352.8 Q F0(Directory in which the f)144 364.8 Q(ailed b)-.1 E
(ug report is sa)-.2 E -.15(ve)-.2 G 2.5(di).15 G 2.5(ft)-2.5 G
(he mail f)-2.5 E(ails.)-.1 E F2(TMPDIR)108 381.6 Q F0
(Directory in which to create temporary \214les and directories.)144
381.6 Q F1(SEE ALSO)72 398.4 Q F3(bash)108 410.4 Q F0(\(1\))A F1 -.548
(AU)72 427.2 S(THORS).548 E F0(Brian F)108 439.2 Q(ox, Free Softw)-.15 E
(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108 451.2 Q(g)-.18 E
(Chet Rame)108 468 Q 1.3 -.65(y, C)-.15 H(ase W).65 E(estern Reserv)-.8
393.6 Q F1(SEE ALSO)72 410.4 Q F3(bash)108 422.4 Q F0(\(1\))A F1 -.548
(AU)72 439.2 S(THORS).548 E F0(Brian F)108 451.2 Q(ox, Free Softw)-.15 E
(are F)-.1 E(oundation)-.15 E(bfox@gnu.or)108 463.2 Q(g)-.18 E
(Chet Rame)108 480 Q 1.3 -.65(y, C)-.15 H(ase W).65 E(estern Reserv)-.8
E 2.5(eU)-.15 G(ni)-2.5 E -.15(ve)-.25 G(rsity).15 E(chet@po.cwru.edu)
108 480 Q(GNU Bash-4.4)72 768 Q(2016 February 15)138.46 E(1)193.45 E 0
Cg EP
108 492 Q(GNU Bash 5.1)72 768 Q(2020 August 1)145.395 E(1)199.555 E 0 Cg
EP
%%Trailer
end
%%EOF
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.html
+44 -30
View File
@@ -1,9 +1,9 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This text is a brief description of the features that are present in
the Bash shell (version 5.1, 5 June 2020).
the Bash shell (version 5.1, 25 August 2020).
This is Edition 5.1, last updated 5 June 2020,
This is Edition 5.1, last updated 25 August 2020,
of The GNU Bash Reference Manual,
for Bash, Version 5.1.
@@ -275,10 +275,10 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Previou
<span id="Bash-Features-1"></span><h1 class="top">Bash Features</h1>
<p>This text is a brief description of the features that are present in
the Bash shell (version 5.1, 5 June 2020).
the Bash shell (version 5.1, 25 August 2020).
The Bash home page is <a href="http://www.gnu.org/software/bash/">http://www.gnu.org/software/bash/</a>.
</p>
<p>This is Edition 5.1, last updated 5 June 2020,
<p>This is Edition 5.1, last updated 25 August 2020,
of <cite>The GNU Bash Reference Manual</cite>,
for <code>Bash</code>, Version 5.1.
</p>
@@ -3229,7 +3229,7 @@ by {<var>varname</var>}, the value of <var>varname</var> defines the file
descriptor to close.
If {<var>varname</var>} is supplied, the redirection persists beyond
the scope of the command, allowing the shell programmer to manage
the file descriptor himself.
the file descriptor&rsquo;s lifetime manually.
</p>
<p>In the following descriptions, if the file descriptor number is
omitted, and the first character of the redirection operator is
@@ -4322,7 +4322,7 @@ and not during the execution of a script by <code>.</code> or <code>source</code
<p>Shift the positional parameters to the left by <var>n</var>.
The positional parameters from <var>n</var>+1 &hellip; <code>$#</code> are
renamed to <code>$1</code> &hellip; <code>$#</code>-<var>n</var>.
Parameters represented by the numbers <code>$#</code> to <code>$#</code>-<var>n</var>+1
Parameters represented by the numbers <code>$#</code> down to <code>$#</code>-<var>n</var>+1
are unset.
<var>n</var> must be a non-negative number less than or equal to <code>$#</code>.
If <var>n</var> is zero or greater than <code>$#</code>, the positional parameters
@@ -5040,6 +5040,8 @@ If <var>name</var> is &lsquo;<samp>-</samp>&rsquo;, the set of shell options is
function in which <code>local</code> is invoked: shell options changed using
the <code>set</code> builtin inside the function are restored to their original
values when the function returns.
The restore is effected as if a series of <code>set</code> commands were executed
to restore the values that were in place before the function.
The return status is zero unless <code>local</code> is used outside
a function, an invalid <var>name</var> is supplied, or <var>name</var> is a
readonly variable.
@@ -5197,12 +5199,6 @@ are used to split the line into words using the same rules the shell
uses for expansion (described above in <a href="#Word-Splitting">Word Splitting</a>).
The backslash character &lsquo;<samp>\</samp>&rsquo; may be used to remove any special
meaning for the next character read and for line continuation.
If no names are supplied, the line read is assigned to the
variable <code>REPLY</code>.
The exit status is zero, unless end-of-file is encountered, <code>read</code>
times out (in which case the status is greater than 128),
a variable assignment error (such as assigning to a readonly variable) occurs,
or an invalid file descriptor is supplied as the argument to <samp>-u</samp>.
</p>
<p>Options, if supplied, have the following meanings:
</p>
@@ -5290,6 +5286,15 @@ The exit status is greater than 128 if the timeout is exceeded.
</p></dd>
</dl>
<p>If no <var>name</var>s are supplied, the line read,
without the ending delimiter but otherwise unmodified,
is assigned to the
variable <code>REPLY</code>.
The exit status is zero, unless end-of-file is encountered, <code>read</code>
times out (in which case the status is greater than 128),
a variable assignment error (such as assigning to a readonly variable) occurs,
or an invalid file descriptor is supplied as the argument to <samp>-u</samp>.
</p>
</dd>
<dt><code>readarray</code></dt>
<dd><span id="index-readarray"></span>
@@ -6289,12 +6294,7 @@ by default.
</p>
</dd>
</dl>
<p>The return status when listing options is zero if all <var>optnames</var>
are enabled, non-zero otherwise.
When setting or unsetting options, the return status is zero unless an
<var>optname</var> is not a valid shell option.
</p></dd>
</dd>
</dl>
<hr>
@@ -7322,15 +7322,14 @@ not already set.
is readonly.
</p>
</dd>
<dt><code>PROMPT_COMMANDS</code>
<span id="index-PROMPT_005fCOMMANDS"></span>
<dt><code>PROMPT_COMMAND</code>
<span id="index-PROMPT_005fCOMMAND"></span>
</dt>
<dd><p>If this array variable is set,
<dd><p>If this variable is set, and is an array,
the value of each set element is interpreted as a command to execute
before printing the primary prompt (<code>$PS1</code>).
If this is not set, but
<code>PROMPT_COMMAND</code>
is set to a value, its value is used as a command to execute instead.
If this is set but not an array variable,
its value is used as a command to execute instead.
</p>
</dd>
<dt><code>PROMPT_DIRTRIM</code>
@@ -9347,6 +9346,10 @@ more randomness. If the shell compatibility level is set to 50 or
lower, it reverts to the method from bash-5.0 and previous versions,
so seeding the random number generator by assigning a value to
<code>RANDOM</code> will produce the same sequence as in bash-5.0
</li><li> If the command hash table is empty, Bash versions prior to bash-5.1
printed an informational message to that effect, even when producing
output that can be reused as input. Bash-5.1 suppresses that message
when the <samp>-l</samp> option is supplied.
</li></ul>
</dd>
</dl>
@@ -10218,9 +10221,9 @@ replaced with an ellipsis when displaying possible completions.
<dd><span id="index-completion_002dquery_002ditems"></span>
<p>The number of possible completions that determines when the user is
asked whether the list of possibilities should be displayed.
If the number of possible completions is greater than this value,
Readline will ask the user whether or not he wishes to view
them; otherwise, they are simply listed.
If the number of possible completions is greater than or equal to this value,
Readline will ask whether or not the user wishes to view them;
otherwise, they are simply listed.
This variable must be set to an integer value greater than or equal to 0.
A negative value means Readline should never ask.
The default limit is <code>100</code>.
@@ -10907,8 +10910,8 @@ set convert-meta off
# rather than as meta-prefixed characters
set output-meta on
# if there are more than 150 possible completions for
# a word, ask the user if he wants to see all of them
# if there are 150 or more possible completions for a word,
# ask whether or not the user wants to see all of them
set completion-query-items 150
# For FTP
@@ -11108,6 +11111,7 @@ being entered.
</dt>
<dd><p>Search backward starting at the current line and moving &lsquo;up&rsquo; through
the history as necessary. This is an incremental search.
This command sets the region to the matched text and activates the mark.
</p>
</dd>
<dt><code>forward-search-history (C-s)</code>
@@ -11115,6 +11119,7 @@ the history as necessary. This is an incremental search.
</dt>
<dd><p>Search forward starting at the current line and moving &lsquo;down&rsquo; through
the history as necessary. This is an incremental search.
This command sets the region to the matched text and activates the mark.
</p>
</dd>
<dt><code>non-incremental-reverse-search-history (M-p)</code>
@@ -11281,6 +11286,11 @@ each character as if it had been read from the keyboard. The characters
are inserted as if each one was bound to <code>self-insert</code> instead of
executing any editing commands.
</p>
<p>Bracketed paste sets the region (the characters between point and the mark)
to the inserted text. It uses the concept of an <em>active mark</em>: when the
mark is active, Readline redisplay uses the terminal&rsquo;s standout mode to
denote the region.
</p>
</dd>
<dt><code>transpose-chars (C-t)</code>
<span id="index-transpose_002dchars-_0028C_002dt_0029"></span>
@@ -11354,12 +11364,16 @@ Next: <a href="#Numeric-Arguments" accesskey="n" rel="next">Numeric Arguments</a
<span id="index-kill_002dline-_0028C_002dk_0029"></span>
</dt>
<dd><p>Kill the text from point to the end of the line.
With a negative numeric argument, kill backward from the cursor to the
beginning of the current line.
</p>
</dd>
<dt><code>backward-kill-line (C-x Rubout)</code>
<span id="index-backward_002dkill_002dline-_0028C_002dx-Rubout_0029"></span>
</dt>
<dd><p>Kill backward from the cursor to the beginning of the current line.
With a negative numeric argument, kill forward from the cursor to the
end of the current line.
</p>
</dd>
<dt><code>unix-line-discard (C-u)</code>
@@ -15230,7 +15244,7 @@ Next: <a href="#Function-Index" accesskey="n" rel="next">Function Index</a>, Pre
<tr><td></td><td valign="top"><a href="#index-PIPESTATUS"><code>PIPESTATUS</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-POSIXLY_005fCORRECT"><code>POSIXLY_CORRECT</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-PPID"><code>PPID</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-PROMPT_005fCOMMANDS"><code>PROMPT_COMMANDS</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-PROMPT_005fCOMMAND"><code>PROMPT_COMMAND</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-PROMPT_005fDIRTRIM"><code>PROMPT_DIRTRIM</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-PS0"><code>PS0</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-PS1"><code>PS1</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bourne-Shell-Variables">Bourne Shell Variables</a></td></tr>
doc/bashref.info
+213 -197
View File
@@ -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, 5 June 2020).
Bash shell (version 5.1, 25 August 2020).
This is Edition 5.1, last updated 5 June 2020, of 'The GNU Bash
This is Edition 5.1, last updated 25 August 2020, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.1.
Copyright (C) 1988-2018 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, 5 June 2020). The Bash home page is
Bash shell (version 5.1, 25 August 2020). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.1, last updated 5 June 2020, of 'The GNU Bash
This is Edition 5.1, last updated 25 August 2020, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.1.
Bash contains features that appear in other popular shells, and some
@@ -2322,7 +2322,7 @@ file descriptor greater than 10 and assign it to {VARNAME}. If >&- or
<&- is preceded by {VARNAME}, the value of VARNAME defines the file
descriptor to close. If {VARNAME} is supplied, the redirection persists
beyond the scope of the command, allowing the shell programmer to manage
the file descriptor himself.
the file descriptor's lifetime manually.
In the following descriptions, if the file descriptor number is
omitted, and the first character of the redirection operator is '<', the
@@ -3202,12 +3202,12 @@ standard.
Shift the positional parameters to the left by N. The positional
parameters from N+1 ... '$#' are renamed to '$1' ... '$#'-N.
Parameters represented by the numbers '$#' to '$#'-N+1 are unset.
N must be a non-negative number less than or equal to '$#'. If N
is zero or greater than '$#', the positional parameters are not
changed. If N is not supplied, it is assumed to be 1. The return
status is zero unless N is greater than '$#' or less than zero,
non-zero otherwise.
Parameters represented by the numbers '$#' down to '$#'-N+1 are
unset. N must be a non-negative number less than or equal to '$#'.
If N is zero or greater than '$#', the positional parameters are
not changed. If N is not supplied, it is assumed to be 1. The
return status is zero unless N is greater than '$#' or less than
zero, non-zero otherwise.
'test'
'['
@@ -3746,9 +3746,11 @@ standard.
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 return status
is zero unless 'local' is used outside a function, an invalid NAME
is supplied, or NAME is a readonly variable.
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]
@@ -3866,13 +3868,7 @@ standard.
line into words using the same rules the shell uses for expansion
(described above in *note Word Splitting::). The backslash
character '\' may be used to remove any special meaning for the
next character read and for line continuation. If no names are
supplied, the line read is assigned to the variable 'REPLY'. The
exit status is zero, unless end-of-file is encountered, 'read'
times out (in which case the status is greater than 128), a
variable assignment error (such as assigning to a readonly
variable) occurs, or an invalid file descriptor is supplied as the
argument to '-u'.
next character read and for line continuation.
Options, if supplied, have the following meanings:
@@ -3944,6 +3940,14 @@ standard.
'-u FD'
Read input from file descriptor FD.
If no NAMEs are supplied, the line read, without the ending
delimiter but otherwise unmodified, is assigned to the variable
'REPLY'. The exit status is zero, unless end-of-file is
encountered, 'read' times out (in which case the status is greater
than 128), a variable assignment error (such as assigning to a
readonly variable) occurs, or an invalid file descriptor is
supplied as the argument to '-u'.
'readarray'
readarray [-d DELIM] [-n COUNT] [-O ORIGIN] [-s COUNT]
[-t] [-u FD] [-C CALLBACK] [-c QUANTUM] [ARRAY]
@@ -4746,11 +4750,6 @@ This builtin allows you to change additional shell optional behavior.
If set, the 'echo' builtin expands backslash-escape sequences
by default.
The return status when listing options is zero if all OPTNAMES are
enabled, non-zero otherwise. When setting or unsetting options,
the return status is zero unless an OPTNAME is not a valid shell
option.

File: bashref.info, Node: Special Builtins, Prev: Modifying Shell Behavior, Up: Shell Builtin Commands
@@ -5423,11 +5422,11 @@ Variables::).
The process ID of the shell's parent process. This variable is
readonly.
'PROMPT_COMMANDS'
If this array variable is set, the value of each set element is
interpreted as a command to execute before printing the primary
prompt ('$PS1'). If this is not set, but 'PROMPT_COMMAND' is set
to a value, its value is used as a command to execute instead.
'PROMPT_COMMAND'
If this variable is set, and is an array, the value of each set
element is interpreted as a command to execute before printing the
primary prompt ('$PS1'). If this is set but not an array variable,
its value is used as a command to execute instead.
'PROMPT_DIRTRIM'
If set to a number greater than zero, the value is used as the
@@ -7032,6 +7031,10 @@ required for bash-5.1 and later versions.
previous versions, so seeding the random number generator by
assigning a value to 'RANDOM' will produce the same sequence
as in bash-5.0
* If the command hash table is empty, Bash versions prior to
bash-5.1 printed an informational message to that effect, even
when producing output that can be reused as input. Bash-5.1
suppresses that message when the '-l' option is supplied.

File: bashref.info, Node: Job Control, Next: Command Line Editing, Prev: Bash Features, Up: Top
@@ -7698,11 +7701,11 @@ Variable Settings
The number of possible completions that determines when the
user is asked whether the list of possibilities should be
displayed. If the number of possible completions is greater
than this value, Readline will ask the user whether or not he
wishes to view them; otherwise, they are simply listed. This
variable must be set to an integer value greater than or equal
to 0. A negative value means Readline should never ask. The
default limit is '100'.
than or equal to this value, Readline will ask whether or not
the user wishes to view them; otherwise, they are simply
listed. This variable must be set to an integer value greater
than or equal to 0. A negative value means Readline should
never ask. The default limit is '100'.
'convert-meta'
If set to 'on', Readline will convert characters with the
@@ -8229,8 +8232,8 @@ variable assignment, and conditional syntax.
# rather than as meta-prefixed characters
set output-meta on
# if there are more than 150 possible completions for
# a word, ask the user if he wants to see all of them
# if there are 150 or more possible completions for a word,
# ask whether or not the user wants to see all of them
set completion-query-items 150
# For FTP
@@ -8358,10 +8361,14 @@ File: bashref.info, Node: Commands For History, Next: Commands For Text, Prev
'reverse-search-history (C-r)'
Search backward starting at the current line and moving 'up'
through the history as necessary. This is an incremental search.
This command sets the region to the matched text and activates the
mark.
'forward-search-history (C-s)'
Search forward starting at the current line and moving 'down'
through the history as necessary. This is an incremental search.
This command sets the region to the matched text and activates the
mark.
'non-incremental-reverse-search-history (M-p)'
Search backward starting at the current line and moving 'up'
@@ -8469,6 +8476,11 @@ File: bashref.info, Node: Commands For Text, Next: Commands For Killing, Prev
was bound to 'self-insert' instead of executing any editing
commands.
Bracketed paste sets the region (the characters between point and
the mark) to the inserted text. It uses the concept of an _active
mark_: when the mark is active, Readline redisplay uses the
terminal's standout mode to denote the region.
'transpose-chars (C-t)'
Drag the character before the cursor forward over the character at
the cursor, moving the cursor forward as well. If the insertion
@@ -8513,10 +8525,14 @@ File: bashref.info, Node: Commands For Killing, Next: Numeric Arguments, Prev
-------------------------
'kill-line (C-k)'
Kill the text from point to the end of the line.
Kill the text from point to the end of the line. With a negative
numeric argument, kill backward from the cursor to the beginning of
the current line.
'backward-kill-line (C-x Rubout)'
Kill backward from the cursor to the beginning of the current line.
With a negative numeric argument, kill forward from the cursor to
the end of the current line.
'unix-line-discard (C-u)'
Kill backward from the cursor to the beginning of the current line.
@@ -11284,17 +11300,17 @@ D.1 Index of Shell Builtin Commands
(line 58)
* let: Bash Builtins. (line 350)
* local: Bash Builtins. (line 358)
* logout: Bash Builtins. (line 372)
* mapfile: Bash Builtins. (line 377)
* logout: Bash Builtins. (line 374)
* mapfile: Bash Builtins. (line 379)
* popd: Directory Stack Builtins.
(line 35)
* printf: Bash Builtins. (line 423)
* printf: Bash Builtins. (line 425)
* pushd: Directory Stack Builtins.
(line 53)
* pwd: Bourne Shell Builtins.
(line 207)
* read: Bash Builtins. (line 472)
* readarray: Bash Builtins. (line 566)
* read: Bash Builtins. (line 474)
* readarray: Bash Builtins. (line 570)
* readonly: Bourne Shell Builtins.
(line 217)
* return: Bourne Shell Builtins.
@@ -11303,7 +11319,7 @@ D.1 Index of Shell Builtin Commands
* shift: Bourne Shell Builtins.
(line 257)
* shopt: The Shopt Builtin. (line 9)
* source: Bash Builtins. (line 575)
* source: Bash Builtins. (line 579)
* suspend: Job Control Builtins.
(line 113)
* test: Bourne Shell Builtins.
@@ -11312,12 +11328,12 @@ D.1 Index of Shell Builtin Commands
(line 349)
* trap: Bourne Shell Builtins.
(line 355)
* type: Bash Builtins. (line 580)
* typeset: Bash Builtins. (line 612)
* ulimit: Bash Builtins. (line 618)
* type: Bash Builtins. (line 584)
* typeset: Bash Builtins. (line 616)
* ulimit: Bash Builtins. (line 622)
* umask: Bourne Shell Builtins.
(line 404)
* unalias: Bash Builtins. (line 721)
* unalias: Bash Builtins. (line 725)
* unset: Bourne Shell Builtins.
(line 422)
* wait: Job Control Builtins.
@@ -11551,7 +11567,7 @@ D.3 Parameter and Variable Index
* PIPESTATUS: Bash Variables. (line 553)
* POSIXLY_CORRECT: Bash Variables. (line 558)
* PPID: Bash Variables. (line 568)
* PROMPT_COMMANDS: Bash Variables. (line 572)
* PROMPT_COMMAND: Bash Variables. (line 572)
* PROMPT_DIRTRIM: Bash Variables. (line 578)
* PS0: Bash Variables. (line 584)
* PS1: Bourne Shell Variables.
@@ -11612,16 +11628,16 @@ D.4 Function Index
* backward-char (C-b): Commands For Moving. (line 15)
* backward-delete-char (Rubout): Commands For Text. (line 17)
* backward-kill-line (C-x Rubout): Commands For Killing.
(line 9)
(line 11)
* backward-kill-word (M-<DEL>): Commands For Killing.
(line 24)
(line 28)
* backward-word (M-b): Commands For Moving. (line 22)
* beginning-of-history (M-<): Commands For History.
(line 20)
* beginning-of-line (C-a): Commands For Moving. (line 6)
* bracketed-paste-begin (): Commands For Text. (line 33)
* call-last-kbd-macro (C-x e): Keyboard Macros. (line 13)
* capitalize-word (M-c): Commands For Text. (line 61)
* capitalize-word (M-c): Commands For Text. (line 66)
* character-search (C-]): Miscellaneous Commands.
(line 42)
* character-search-backward (M-C-]): Miscellaneous Commands.
@@ -11643,24 +11659,24 @@ D.4 Function Index
* complete-variable (M-$): Commands For Completion.
(line 64)
* copy-backward-word (): Commands For Killing.
(line 65)
(line 69)
* copy-forward-word (): Commands For Killing.
(line 70)
(line 74)
* copy-region-as-kill (): Commands For Killing.
(line 61)
(line 65)
* dabbrev-expand (): Commands For Completion.
(line 95)
* delete-char (C-d): Commands For Text. (line 12)
* delete-char-or-list (): Commands For Completion.
(line 43)
* delete-horizontal-space (): Commands For Killing.
(line 53)
(line 57)
* digit-argument (M-0, M-1, ... M--): Numeric Arguments. (line 6)
* display-shell-version (C-x C-v): Miscellaneous Commands.
(line 110)
* do-lowercase-version (M-A, M-B, M-X, ...): Miscellaneous Commands.
(line 14)
* downcase-word (M-l): Commands For Text. (line 57)
* downcase-word (M-l): Commands For Text. (line 62)
* dump-functions (): Miscellaneous Commands.
(line 74)
* dump-macros (): Miscellaneous Commands.
@@ -11681,7 +11697,7 @@ D.4 Function Index
* forward-backward-delete-char (): Commands For Text. (line 21)
* forward-char (C-f): Commands For Moving. (line 12)
* forward-search-history (C-s): Commands For History.
(line 31)
(line 33)
* forward-word (M-f): Commands For Moving. (line 18)
* glob-complete-word (M-g): Miscellaneous Commands.
(line 92)
@@ -11694,13 +11710,13 @@ D.4 Function Index
* history-expand-line (M-^): Miscellaneous Commands.
(line 118)
* history-search-backward (): Commands For History.
(line 53)
(line 57)
* history-search-forward (): Commands For History.
(line 47)
(line 51)
* history-substring-search-backward (): Commands For History.
(line 65)
(line 69)
* history-substring-search-forward (): Commands For History.
(line 59)
(line 63)
* insert-comment (M-#): Miscellaneous Commands.
(line 61)
* insert-completions (M-*): Commands For Completion.
@@ -11710,11 +11726,11 @@ D.4 Function Index
* kill-line (C-k): Commands For Killing.
(line 6)
* kill-region (): Commands For Killing.
(line 57)
(line 61)
* kill-whole-line (): Commands For Killing.
(line 15)
* kill-word (M-d): Commands For Killing.
(line 19)
* kill-word (M-d): Commands For Killing.
(line 23)
* magic-space (): Miscellaneous Commands.
(line 121)
* menu-complete (): Commands For Completion.
@@ -11725,12 +11741,12 @@ D.4 Function Index
(line 17)
* next-screen-line (): Commands For Moving. (line 41)
* non-incremental-forward-search-history (M-n): Commands For History.
(line 41)
(line 45)
* non-incremental-reverse-search-history (M-p): Commands For History.
(line 35)
(line 39)
* operate-and-get-next (C-o): Commands For History.
(line 92)
* overwrite-mode (): Commands For Text. (line 65)
(line 96)
* overwrite-mode (): Commands For Text. (line 70)
* possible-command-completions (C-x !): Commands For Completion.
(line 86)
* possible-completions (M-?): Commands For Completion.
@@ -11761,40 +11777,40 @@ D.4 Function Index
* set-mark (C-@): Miscellaneous Commands.
(line 33)
* shell-backward-kill-word (): Commands For Killing.
(line 33)
(line 37)
* shell-backward-word (M-C-b): Commands For Moving. (line 30)
* shell-expand-line (M-C-e): Miscellaneous Commands.
(line 113)
* shell-forward-word (M-C-f): Commands For Moving. (line 26)
* shell-kill-word (M-C-d): Commands For Killing.
(line 28)
(line 32)
* shell-transpose-words (M-C-t): Commands For Killing.
(line 37)
(line 41)
* skip-csi-sequence (): Miscellaneous Commands.
(line 52)
* start-kbd-macro (C-x (): Keyboard Macros. (line 6)
* tilde-expand (M-&): Miscellaneous Commands.
(line 30)
* transpose-chars (C-t): Commands For Text. (line 42)
* transpose-words (M-t): Commands For Text. (line 48)
* transpose-chars (C-t): Commands For Text. (line 47)
* transpose-words (M-t): Commands For Text. (line 53)
* undo (C-_ or C-x C-u): Miscellaneous Commands.
(line 23)
* universal-argument (): Numeric Arguments. (line 10)
* unix-filename-rubout (): Commands For Killing.
(line 48)
(line 52)
* unix-line-discard (C-u): Commands For Killing.
(line 12)
(line 16)
* unix-word-rubout (C-w): Commands For Killing.
(line 44)
* upcase-word (M-u): Commands For Text. (line 53)
(line 48)
* upcase-word (M-u): Commands For Text. (line 58)
* yank (C-y): Commands For Killing.
(line 75)
(line 79)
* yank-last-arg (M-. or M-_): Commands For History.
(line 80)
(line 84)
* yank-nth-arg (M-C-y): Commands For History.
(line 71)
(line 75)
* yank-pop (M-y): Commands For Killing.
(line 78)
(line 82)

File: bashref.info, Node: Concept Index, Prev: Function Index, Up: Indexes
@@ -11963,66 +11979,66 @@ 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 Character14454
Node: Single Quotes14939
Node: Double Quotes15287
Node: ANSI-C Quoting16565
Node: Locale Translation17824
Node: Comments18977
Node: Shell Commands19595
Node: Reserved Words20533
Node: Simple Commands21289
Node: Pipelines21943
Node: Lists24875
Node: Compound Commands26666
Node: Looping Constructs27678
Node: Conditional Constructs30173
Node: Command Grouping41744
Node: Coprocesses43223
Node: GNU Parallel45126
Node: Shell Functions49427
Node: Shell Parameters56634
Node: Positional Parameters61047
Node: Special Parameters61947
Node: Shell Expansions65171
Node: Brace Expansion67294
Node: Tilde Expansion70017
Node: Shell Parameter Expansion72634
Node: Command Substitution87763
Node: Arithmetic Expansion89118
Node: Process Substitution90050
Node: Word Splitting91170
Node: Filename Expansion93114
Node: Pattern Matching95663
Node: Quote Removal99649
Node: Redirections99944
Node: Executing Commands109502
Node: Simple Command Expansion110172
Node: Command Search and Execution112126
Node: Command Execution Environment114502
Node: Environment117486
Node: Exit Status119145
Node: Signals120815
Node: Shell Scripts122782
Node: Shell Builtin Commands125794
Node: Bourne Shell Builtins127832
Node: Bash Builtins148756
Node: Modifying Shell Behavior178486
Node: The Set Builtin178831
Node: The Shopt Builtin189244
Node: Special Builtins204380
Node: Shell Variables205359
Node: Bourne Shell Variables205796
Node: Bash Variables207900
Node: Top893
Node: Introduction2809
Node: What is Bash?3025
Node: What is a shell?4139
Node: Definitions6677
Node: Basic Shell Features9628
Node: Shell Syntax10847
Node: Shell Operation11873
Node: Quoting13166
Node: Escape Character14466
Node: Single Quotes14951
Node: Double Quotes15299
Node: ANSI-C Quoting16577
Node: Locale Translation17836
Node: Comments18989
Node: Shell Commands19607
Node: Reserved Words20545
Node: Simple Commands21301
Node: Pipelines21955
Node: Lists24887
Node: Compound Commands26678
Node: Looping Constructs27690
Node: Conditional Constructs30185
Node: Command Grouping41756
Node: Coprocesses43235
Node: GNU Parallel45138
Node: Shell Functions49439
Node: Shell Parameters56646
Node: Positional Parameters61059
Node: Special Parameters61959
Node: Shell Expansions65183
Node: Brace Expansion67306
Node: Tilde Expansion70029
Node: Shell Parameter Expansion72646
Node: Command Substitution87775
Node: Arithmetic Expansion89130
Node: Process Substitution90062
Node: Word Splitting91182
Node: Filename Expansion93126
Node: Pattern Matching95675
Node: Quote Removal99661
Node: Redirections99956
Node: Executing Commands109526
Node: Simple Command Expansion110196
Node: Command Search and Execution112150
Node: Command Execution Environment114526
Node: Environment117510
Node: Exit Status119169
Node: Signals120839
Node: Shell Scripts122806
Node: Shell Builtin Commands125818
Node: Bourne Shell Builtins127856
Node: Bash Builtins148785
Node: Modifying Shell Behavior178720
Node: The Set Builtin179065
Node: The Shopt Builtin189478
Node: Special Builtins204388
Node: Shell Variables205367
Node: Bourne Shell Variables205804
Node: Bash Variables207908
Node: Bash Features240478
Node: Invoking Bash241491
Node: Bash Startup Files247504
@@ -12040,60 +12056,60 @@ Node: Controlling the Prompt277893
Node: The Restricted Shell280843
Node: Bash POSIX Mode283437
Node: Shell Compatibility Mode294473
Node: Job Control300848
Node: Job Control Basics301308
Node: Job Control Builtins306304
Node: Job Control Variables311704
Node: Command Line Editing312860
Node: Introduction and Notation314531
Node: Readline Interaction316154
Node: Readline Bare Essentials317345
Node: Readline Movement Commands319128
Node: Readline Killing Commands320088
Node: Readline Arguments322006
Node: Searching323050
Node: Readline Init File325236
Node: Readline Init File Syntax326495
Node: Conditional Init Constructs347025
Node: Sample Init File351221
Node: Bindable Readline Commands354338
Node: Commands For Moving355542
Node: Commands For History357593
Node: Commands For Text362220
Node: Commands For Killing365608
Node: Numeric Arguments368423
Node: Commands For Completion369562
Node: Keyboard Macros373753
Node: Miscellaneous Commands374440
Node: Readline vi Mode380124
Node: Programmable Completion381031
Node: Programmable Completion Builtins388811
Node: A Programmable Completion Example399506
Node: Using History Interactively404753
Node: Bash History Facilities405437
Node: Bash History Builtins408442
Node: History Interaction413171
Node: Event Designators416791
Node: Word Designators418145
Node: Modifiers419905
Node: Installing Bash421716
Node: Basic Installation422853
Node: Compilers and Options426111
Node: Compiling For Multiple Architectures426852
Node: Installation Names428545
Node: Specifying the System Type429363
Node: Sharing Defaults430079
Node: Operation Controls430752
Node: Optional Features431710
Node: Reporting Bugs442228
Node: Major Differences From The Bourne Shell443422
Node: GNU Free Documentation License460274
Node: Indexes485451
Node: Builtin Index485905
Node: Reserved Word Index492732
Node: Variable Index495180
Node: Function Index511077
Node: Concept Index524587
Node: Job Control301129
Node: Job Control Basics301589
Node: Job Control Builtins306585
Node: Job Control Variables311985
Node: Command Line Editing313141
Node: Introduction and Notation314812
Node: Readline Interaction316435
Node: Readline Bare Essentials317626
Node: Readline Movement Commands319409
Node: Readline Killing Commands320369
Node: Readline Arguments322287
Node: Searching323331
Node: Readline Init File325517
Node: Readline Init File Syntax326776
Node: Conditional Init Constructs347315
Node: Sample Init File351511
Node: Bindable Readline Commands354635
Node: Commands For Moving355839
Node: Commands For History357890
Node: Commands For Text362683
Node: Commands For Killing366332
Node: Numeric Arguments369365
Node: Commands For Completion370504
Node: Keyboard Macros374695
Node: Miscellaneous Commands375382
Node: Readline vi Mode381066
Node: Programmable Completion381973
Node: Programmable Completion Builtins389753
Node: A Programmable Completion Example400448
Node: Using History Interactively405695
Node: Bash History Facilities406379
Node: Bash History Builtins409384
Node: History Interaction414113
Node: Event Designators417733
Node: Word Designators419087
Node: Modifiers420847
Node: Installing Bash422658
Node: Basic Installation423795
Node: Compilers and Options427053
Node: Compiling For Multiple Architectures427794
Node: Installation Names429487
Node: Specifying the System Type430305
Node: Sharing Defaults431021
Node: Operation Controls431694
Node: Optional Features432652
Node: Reporting Bugs443170
Node: Major Differences From The Bourne Shell444364
Node: GNU Free Documentation License461216
Node: Indexes486393
Node: Builtin Index486847
Node: Reserved Word Index493674
Node: Variable Index496122
Node: Function Index512019
Node: Concept Index525529

End Tag Table
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+1988 -1951
View File
File diff suppressed because it is too large Load Diff
doc/bashref.texi
+22 -19
View File
@@ -2727,7 +2727,7 @@ by @{@var{varname}@}, the value of @var{varname} defines the file
descriptor to close.
If @{@var{varname}@} is supplied, the redirection persists beyond
the scope of the command, allowing the shell programmer to manage
the file descriptor himself.
the file descriptor's lifetime manually.
In the following descriptions, if the file descriptor number is
omitted, and the first character of the redirection operator is
@@ -3787,7 +3787,7 @@ shift [@var{n}]
Shift the positional parameters to the left by @var{n}.
The positional parameters from @var{n}+1 @dots{} @code{$#} are
renamed to @code{$1} @dots{} @code{$#}-@var{n}.
Parameters represented by the numbers @code{$#} to @code{$#}-@var{n}+1
Parameters represented by the numbers @code{$#} down to @code{$#}-@var{n}+1
are unset.
@var{n} must be a non-negative number less than or equal to @code{$#}.
If @var{n} is zero or greater than @code{$#}, the positional parameters
@@ -4440,6 +4440,8 @@ If @var{name} is @samp{-}, the set of shell options is made local to the
function in which @code{local} is invoked: shell options changed using
the @code{set} builtin inside the function are restored to their original
values when the function returns.
The restore is effected as if a series of @code{set} commands were executed
to restore the values that were in place before the function.
The return status is zero unless @code{local} is used outside
a function, an invalid @var{name} is supplied, or @var{name} is a
readonly variable.
@@ -4584,12 +4586,6 @@ are used to split the line into words using the same rules the shell
uses for expansion (described above in @ref{Word Splitting}).
The backslash character @samp{\} may be used to remove any special
meaning for the next character read and for line continuation.
If no names are supplied, the line read is assigned to the
variable @env{REPLY}.
The exit status is zero, unless end-of-file is encountered, @code{read}
times out (in which case the status is greater than 128),
a variable assignment error (such as assigning to a readonly variable) occurs,
or an invalid file descriptor is supplied as the argument to @option{-u}.
Options, if supplied, have the following meanings:
@@ -4666,6 +4662,15 @@ The exit status is greater than 128 if the timeout is exceeded.
Read input from file descriptor @var{fd}.
@end table
If no @var{name}s are supplied, the line read,
without the ending delimiter but otherwise unmodified,
is assigned to the
variable @env{REPLY}.
The exit status is zero, unless end-of-file is encountered, @code{read}
times out (in which case the status is greater than 128),
a variable assignment error (such as assigning to a readonly variable) occurs,
or an invalid file descriptor is supplied as the argument to @option{-u}.
@item readarray
@btindex readarray
@example
@@ -5529,12 +5534,6 @@ If set, the @code{echo} builtin expands backslash-escape sequences
by default.
@end table
@noindent
The return status when listing options is zero if all @var{optnames}
are enabled, non-zero otherwise.
When setting or unsetting options, the return status is zero unless an
@var{optname} is not a valid shell option.
@end table
@node Special Builtins
@@ -6284,13 +6283,12 @@ not already set.
The process @sc{id} of the shell's parent process. This variable
is readonly.
@item PROMPT_COMMANDS
If this array variable is set,
@item PROMPT_COMMAND
If this variable is set, and is an array,
the value of each set element is interpreted as a command to execute
before printing the primary prompt (@env{$PS1}).
If this is not set, but
@env{PROMPT_COMMAND}
is set to a value, its value is used as a command to execute instead.
If this is set but not an array variable,
its value is used as a command to execute instead.
@item PROMPT_DIRTRIM
If set to a number greater than zero, the value is used as the number of
@@ -8164,6 +8162,11 @@ more randomness. If the shell compatibility level is set to 50 or
lower, it reverts to the method from bash-5.0 and previous versions,
so seeding the random number generator by assigning a value to
@env{RANDOM} will produce the same sequence as in bash-5.0
@item
If the command hash table is empty, Bash versions prior to bash-5.1
printed an informational message to that effect, even when producing
output that can be reused as input. Bash-5.1 suppresses that message
when the @option{-l} option is supplied.
@end itemize
@end table
doc/builtins.0
+444 -436
View File
File diff suppressed because it is too large Load Diff
doc/builtins.ps
+1002 -993
View File
File diff suppressed because it is too large Load Diff
doc/rbash.ps
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.4
%%CreationDate: Wed Jun 10 12:00:37 2020
%%CreationDate: Mon Sep 7 09:52:16 2020
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.22 4
doc/version.texi
+3 -3
View File
@@ -2,10 +2,10 @@
Copyright (C) 1988-2020 Free Software Foundation, Inc.
@end ignore
@set LASTCHANGE Fri Jun 5 14:48:45 EDT 2020
@set LASTCHANGE Tue Aug 25 09:58:38 EDT 2020
@set EDITION 5.1
@set VERSION 5.1
@set UPDATED 5 June 2020
@set UPDATED-MONTH June 2020
@set UPDATED 25 August 2020
@set UPDATED-MONTH August 2020