changes for the shopt compatNN options

This commit is contained in:
Chet Ramey
2022-02-15 11:52:30 -05:00
parent bf09dfc08d
commit 6d69b62547
23 changed files with 5363 additions and 5092 deletions
+15
View File
@@ -3169,3 +3169,18 @@ lib/readline/doc/{rluser.texi,readline.3},doc/bash.1
bindable readline variables
- enable-active-region: document using active-region-start-color to
highlight the text in the region
2/11
----
parse.y
- read_token,read_token_word: make sure characters read by shell_getc
are protected by appropriate calls to MBTEST when testing for shell
metacharacters and operators
2/14
----
builtins/shopt.def
- set_compatibility_level: if the current compatibility level is outside
the range of the compatNN options, just leave it alone when
unsetting one of the options (which by definition was already
unset). Fixes issue reported by Mihai Moldovan <ionic@ionic.de>
+10 -1
View File
@@ -646,9 +646,14 @@ set_compatibility_level (option_name, mode)
char *option_name;
int mode;
{
int ind;
int ind, oldval;
char *rhs;
/* If we're unsetting one of the compatibility options, make sure the
current value is in the range of the compatNN space. */
if (mode == 0)
oldval = shell_compatibility_level;
/* If we're setting something, redo some of the work we did above in
toggle_shopt(). Unset everything and reset the appropriate option
based on OPTION_NAME. */
@@ -676,6 +681,8 @@ set_compatibility_level (option_name, mode)
shell_compatibility_level = 43;
else if (shopt_compat44)
shell_compatibility_level = 44;
else if (oldval > 44 && shell_compatibility_level < DEFAULT_COMPAT_LEVEL)
;
else
shell_compatibility_level = DEFAULT_COMPAT_LEVEL;
@@ -698,6 +705,8 @@ set_compatibility_opts ()
switch (shell_compatibility_level)
{
case DEFAULT_COMPAT_LEVEL:
case 51: /* completeness */
case 50:
break;
case 44:
shopt_compat44 = 1; break;
+83 -59
View File
@@ -715,7 +715,7 @@ PPAARRAAMMEETTEERRSS
or add to the variable's previous value. This includes arguments to
builtin commands such as ddeeccllaarree that accept assignment statements
(_d_e_c_l_a_r_a_t_i_o_n commands). When += is applied to a variable for which the
_i_n_t_e_g_e_r attribute has been set, _v_a_l_u_e is evaluated as an arithmetic ex-
iinntteeggeerr attribute has been set, _v_a_l_u_e is evaluated as an arithmetic ex-
pression and added to the variable's current value, which is also eval-
uated. When += is applied to an array variable using compound assign-
ment (see AArrrraayyss below), the variable's value is not unset (as it is
@@ -1120,8 +1120,8 @@ PPAARRAAMMEETTEERRSS
value that is not one of the valid compatibility levels, the
shell prints an error message and sets the compatibility level
to the default for the current version. The valid values corre-
spond to the compatibility levels described below under BBSSHHEELLLL--
COMPATIBILITYMMOODDEE. For example, 4.2 and 42 are valid values
spond to the compatibility levels described below under SSHHEELLLL
CCOOMMPPAATTIIBBIILLIITTYY MMOODDEE. For example, 4.2 and 42 are valid values
that correspond to the ccoommppaatt4422 sshhoopptt option and set the compat-
ibility level to 42. The current version is also a valid value.
BBAASSHH__EENNVV
@@ -3276,75 +3276,98 @@ RREEAADDLLIINNEE
sitive), and "1" are equivalent to OOnn. All other values are equivalent
to OOffff. The variables and their default values are:
aaccttiivvee--rreeggiioonn--ssttaarrtt--ccoolloorr
A string variable that controls the text color and background
when displaying the text in the active region (see the descrip-
tion of eennaabbllee--aaccttiivvee--rreeggiioonn below). This string must not take
up any physical character positions on the display, so it should
consist only of terminal escape sequences. It is output to the
terminal before displaying the text in the active region. This
variable is reset to the default value whenever the terminal
type changes. The default value is the string that puts the
terminal in standout mode, as obtained from the terminal's ter-
minfo description. A sample value might be "\e[01;33m".
aaccttiivvee--rreeggiioonn--eenndd--ccoolloorr
A string variable that "undoes" the effects of aaccttiivvee--rree--
ggiioonn--ssttaarrtt--ccoolloorr and restores "normal" terminal display appear-
ance after displaying text in the active region. This string
must not take up any physical character positions on the dis-
play, so it should consist only of terminal escape sequences.
It is output to the terminal after displaying the text in the
active region. This variable is reset to the default value
whenever the terminal type changes. The default value is the
string that restores the terminal from standout mode, as ob-
tained from the terminal's terminfo description. A sample value
might be "\e[0m".
bbeellll--ssttyyllee ((aauuddiibbllee))
Controls what happens when readline wants to ring the terminal
Controls what happens when readline wants to ring the terminal
bell. If set to nnoonnee, readline never rings the bell. If set to
vviissiibbllee, readline uses a visible bell if one is available. If
vviissiibbllee, readline uses a visible bell if one is available. If
set to aauuddiibbllee, readline attempts to ring the terminal's bell.
bbiinndd--ttttyy--ssppeecciiaall--cchhaarrss ((OOnn))
If set to OOnn, readline attempts to bind the control characters
If set to OOnn, readline attempts to bind the control characters
treated specially by the kernel's terminal driver to their read-
line equivalents.
bblliinnkk--mmaattcchhiinngg--ppaarreenn ((OOffff))
If set to OOnn, readline attempts to briefly move the cursor to an
opening parenthesis when a closing parenthesis is inserted.
ccoolloorreedd--ccoommpplleettiioonn--pprreeffiixx ((OOffff))
If set to OOnn, when listing completions, readline displays the
If set to OOnn, when listing completions, readline displays the
common prefix of the set of possible completions using a differ-
ent color. The color definitions are taken from the value of
ent color. The color definitions are taken from the value of
the LLSS__CCOOLLOORRSS environment variable. If there is a color defini-
tion in $$LLSS__CCOOLLOORRSS for the custom suffix "readline-colored-com-
pletion-prefix", readline uses this color for the common prefix
tion in $$LLSS__CCOOLLOORRSS for the custom suffix "readline-colored-com-
pletion-prefix", readline uses this color for the common prefix
instead of its default.
ccoolloorreedd--ssttaattss ((OOffff))
If set to OOnn, readline displays possible completions using dif-
ferent colors to indicate their file type. The color defini-
tions are taken from the value of the LLSS__CCOOLLOORRSS environment
If set to OOnn, readline displays possible completions using dif-
ferent colors to indicate their file type. The color defini-
tions are taken from the value of the LLSS__CCOOLLOORRSS environment
variable.
ccoommmmeenntt--bbeeggiinn ((````##''''))
The string that is inserted when the readline iinnsseerrtt--ccoommmmeenntt
The string that is inserted when the readline iinnsseerrtt--ccoommmmeenntt
command is executed. This command is bound to MM--## in emacs mode
and to ## in vi command mode.
ccoommpplleettiioonn--ddiissppllaayy--wwiiddtthh ((--11))
The number of screen columns used to display possible matches
when performing completion. The value is ignored if it is less
than 0 or greater than the terminal screen width. A value of 0
will cause matches to be displayed one per line. The default
The number of screen columns used to display possible matches
when performing completion. The value is ignored if it is less
than 0 or greater than the terminal screen width. A value of 0
will cause matches to be displayed one per line. The default
value is -1.
ccoommpplleettiioonn--iiggnnoorree--ccaassee ((OOffff))
If set to OOnn, readline performs filename matching and completion
in a case-insensitive fashion.
ccoommpplleettiioonn--mmaapp--ccaassee ((OOffff))
If set to OOnn, and ccoommpplleettiioonn--iiggnnoorree--ccaassee is enabled, readline
treats hyphens (_-) and underscores (__) as equivalent when per-
If set to OOnn, and ccoommpplleettiioonn--iiggnnoorree--ccaassee is enabled, readline
treats hyphens (_-) and underscores (__) as equivalent when per-
forming case-insensitive filename matching and completion.
ccoommpplleettiioonn--pprreeffiixx--ddiissppllaayy--lleennggtthh ((00))
The length in characters of the common prefix of a list of pos-
sible completions that is displayed without modification. When
set to a value greater than zero, common prefixes longer than
this value are replaced with an ellipsis when displaying possi-
The length in characters of the common prefix of a list of pos-
sible completions that is displayed without modification. When
set to a value greater than zero, common prefixes longer than
this value are replaced with an ellipsis when displaying possi-
ble completions.
ccoommpplleettiioonn--qquueerryy--iitteemmss ((110000))
This determines when the user is queried about viewing the num-
ber of possible completions generated by the ppoossssiibbllee--ccoommppllee--
ttiioonnss 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, readline
will ask whether or not the user wishes to view them; otherwise
they are simply listed on the terminal. A zero value means
This determines when the user is queried about viewing the num-
ber of possible completions generated by the ppoossssiibbllee--ccoommppllee--
ttiioonnss 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, readline
will ask whether or not the user wishes to view them; otherwise
they are simply listed on the terminal. A zero value means
readline should never ask; negative values are treated as zero.
ccoonnvveerrtt--mmeettaa ((OOnn))
If set to OOnn, readline will convert characters with the eighth
If set to OOnn, readline will convert characters with the eighth
bit set to an ASCII key sequence by stripping the eighth bit and
prefixing an escape character (in effect, using escape as the
_m_e_t_a _p_r_e_f_i_x). The default is _O_n, but readline will set it to
prefixing an escape character (in effect, using escape as the
_m_e_t_a _p_r_e_f_i_x). The default is _O_n, but readline will set it to
_O_f_f if the locale contains eight-bit characters.
ddiissaabbllee--ccoommpplleettiioonn ((OOffff))
If set to OOnn, readline will inhibit word completion. Completion
characters will be inserted into the line as if they had been
characters will be inserted into the line as if they had been
mapped to sseellff--iinnsseerrtt.
eecchhoo--ccoonnttrrooll--cchhaarraacctteerrss ((OOnn))
When set to OOnn, on operating systems that indicate they support
When set to OOnn, on operating systems that indicate they support
it, readline echoes a character corresponding to a signal gener-
ated from the keyboard.
eeddiittiinngg--mmooddee ((eemmaaccss))
@@ -3352,24 +3375,25 @@ RREEAADDLLIINNEE
ilar to _E_m_a_c_s or _v_i. eeddiittiinngg--mmooddee can be set to either eemmaaccss or
vvii.
eemmaaccss--mmooddee--ssttrriinngg ((@@))
If the _s_h_o_w_-_m_o_d_e_-_i_n_-_p_r_o_m_p_t variable is enabled, this string is
If the _s_h_o_w_-_m_o_d_e_-_i_n_-_p_r_o_m_p_t variable is enabled, this string is
displayed immediately before the last line of the primary prompt
when emacs editing mode is active. The value is expanded like a
key binding, so the standard set of meta- and control prefixes
and backslash escape sequences is available. Use the \1 and \2
escapes to begin and end sequences of non-printing characters,
which can be used to embed a terminal control sequence into the
key binding, so the standard set of meta- and control prefixes
and backslash escape sequences is available. Use the \1 and \2
escapes to begin and end sequences of non-printing characters,
which can be used to embed a terminal control sequence into the
mode string.
eennaabbllee--aaccttiivvee--rreeggiioonn ((OOnn))
The _p_o_i_n_t is the current cursor position, and _m_a_r_k refers to a
saved cursor position. The text between the point and mark is
referred to as the _r_e_g_i_o_n. When this variable is set to _O_n,
readline allows certain commands to designate the region as _a_c_-
_t_i_v_e. When the region is active, readline highlights the text
in the region using the terminal's standout mode. The active
region shows the text inserted by bracketed-paste and any match-
ing text found by incremental and non-incremental history
searches.
The _p_o_i_n_t is the current cursor position, and _m_a_r_k refers to a
saved cursor position. The text between the point and mark is
referred to as the _r_e_g_i_o_n. When this variable is set to _O_n,
readline allows certain commands to designate the region as _a_c_-
_t_i_v_e. When the region is active, readline highlights the text
in the region using the value of the aaccttiivvee--rreeggiioonn--ssttaarrtt--ccoolloorr,
which defaults to the string that enables the terminal's stand-
out mode. The active region shows the text inserted by brack-
eted-paste and any matching text found by incremental and non-
incremental history searches.
eennaabbllee--bbrraacckkeetteedd--ppaassttee ((OOnn))
When set to OOnn, readline will configure the terminal in a way
that will enable it to insert each paste into the editing buffer
@@ -6335,14 +6359,14 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
exit status of the last process or job waited for.
SSHHEELLLL CCOOMMPPAATTIIBBIILLIITTYY MMOODDEE
Bash-4.0 introduced the concept of a `shell compatibility level', spec-
ified as a set of options to the shopt builtin ccoommppaatt3311, ccoommppaatt3322, ccoomm--
ppaatt4400, ccoommppaatt4411, and so on). There is only one current compatibility
level -- each option is mutually exclusive. The compatibility level is
intended to allow users to select behavior from previous versions that
is incompatible with newer versions while they migrate scripts to use
current features and behavior. It's intended to be a temporary solu-
tion.
Bash-4.0 introduced the concept of a _s_h_e_l_l _c_o_m_p_a_t_i_b_i_l_i_t_y _l_e_v_e_l, speci-
fied as a set of options to the shopt builtin ( ccoommppaatt3311, ccoommppaatt3322,
ccoommppaatt4400, ccoommppaatt4411, and so on). There is only one current compatibil-
ity level -- each option is mutually exclusive. The compatibility
level is intended to allow users to select behavior from previous ver-
sions that is incompatible with newer versions while they migrate
scripts to use current features and behavior. It's intended to be a
temporary solution.
This section does not mention behavior that is standard for a particu-
lar version (e.g., setting ccoommppaatt3322 means that quoting the rhs of the
@@ -6607,4 +6631,4 @@ BBUUGGSS
GNU Bash 5.2 2022 January 17 BASH(1)
GNU Bash 5.2 2022 February 10 BASH(1)
+5 -5
View File
@@ -5918,7 +5918,7 @@ The variables and their default values are:
.PP
.PD 0
.TP
.B active-region-start-color
.B active\-region\-start\-color
A string variable that controls the text color and background when displaying
the text in the active region (see the description of
\fBenable\-active\-region\fP below).
@@ -5928,10 +5928,10 @@ It is output to the terminal before displaying the text in the active region.
This variable is reset to the default value whenever the terminal type changes.
The default value is the string that puts the terminal in standout mode,
as obtained from the terminal's terminfo description.
A sample value might be \f(CW\ee[01;33m\fP.
A sample value might be \f(CW"\ee[01;33m"\fP.
.TP
.B active-region-end-color
A string variable that "undoes" the effects of \fBactive-region-start-color\fP
.B active\-region\-end\-color
A string variable that "undoes" the effects of \fBactive\-region\-start\-color\fP
and restores "normal" terminal display appearance after displaying text
in the active region.
This string must not take up any physical character positions on the display,
@@ -5940,7 +5940,7 @@ It is output to the terminal after displaying the text in the active region.
This variable is reset to the default value whenever the terminal type changes.
The default value is the string that restores the terminal from standout mode,
as obtained from the terminal's terminfo description.
A sample value might be \f(CW\ee[0m\fP.
A sample value might be \f(CW"\ee[0m"\fP.
.TP
.B bell\-style (audible)
Controls what happens when readline wants to ring the terminal bell.
+35 -7
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2022 January 17<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2022 February 10<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -1680,7 +1680,7 @@ to a shell variable or array index, the += operator can be used to
append to or add to the variable's previous value.
This includes arguments to builtin commands such as <B>declare</B> that
accept assignment statements (<I>declaration</I> commands).
When += is applied to a variable for which the <I>integer</I> attribute has been
When += is applied to a variable for which the <B>integer</B> attribute has been
set, <I>value</I> is evaluated as an arithmetic expression and added to the
variable's current value, which is also evaluated.
When += is applied to an array variable using compound assignment (see
@@ -2660,7 +2660,7 @@ 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
<FONT SIZE=-1><B>BSHELL</B>COMPATIBILITY<B>MODE</B>.
<FONT SIZE=-1><B>SHELL COMPATIBILITY MODE</B>.
</FONT>
For example, 4.2 and 42 are valid values that correspond
@@ -7536,6 +7536,32 @@ The variables and their default values are:
<DL COMPACT>
<DT><B>active-region-start-color </B>
<DD>
A string variable that controls the text color and background when displaying
the text in the active region (see the description of
<B>enable-active-region</B> below).
This string must not take up any physical character positions on the display,
so it should consist only of terminal escape sequences.
It is output to the terminal before displaying the text in the active region.
This variable is reset to the default value whenever the terminal type changes.
The default value is the string that puts the terminal in standout mode,
as obtained from the terminal's terminfo description.
A sample value might be <TT>&quot;\e[01;33m&quot;</TT>.
<DT><B>active-region-end-color </B>
<DD>
A string variable that &quot;undoes&quot; the effects of <B>active-region-start-color</B>
and restores &quot;normal&quot; terminal display appearance after displaying text
in the active region.
This string must not take up any physical character positions on the display,
so it should consist only of terminal escape sequences.
It is output to the terminal after displaying the text in the active region.
This variable is reset to the default value whenever the terminal type changes.
The default value is the string that restores the terminal from standout mode,
as obtained from the terminal's terminfo description.
A sample value might be <TT>&quot;\e[0m&quot;</TT>.
<DT><B>bell-style (audible)</B>
<DD>
@@ -7679,6 +7705,8 @@ The text between the point and mark is referred to as the <I>region</I>.
When this variable is set to <I>On</I>, readline allows certain commands
to designate the region as <I>active</I>.
When the region is active, readline highlights the text in the region using
the value of the <B>active-region-start-color</B>, which defaults to the
string that enables
the terminal's standout mode.
The active region shows the text inserted by bracketed-paste and any
matching text found by incremental and non-incremental history searches.
@@ -14088,8 +14116,8 @@ process or job waited for.
<A NAME="lbDC">&nbsp;</A>
<H3>SHELL COMPATIBILITY MODE</H3>
Bash-4.0 introduced the concept of a `shell compatibility level', specified
as a set of options to the shopt builtin
Bash-4.0 introduced the concept of a <I>shell compatibility level</I>,
specified as a set of options to the shopt builtin (
<B>compat31</B>,
<B>compat32</B>,
@@ -14626,7 +14654,7 @@ There may be only one active coprocess at a time.
<HR>
<TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>GNU Bash 5.2<TH ALIGN=CENTER width=33%>2022 January 17<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash 5.2<TH ALIGN=CENTER width=33%>2022 February 10<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -14733,6 +14761,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 18 January 2022 10:57:39 EST
Time: 11 February 2022 09:18:02 EST
</BODY>
</HTML>
+196 -158
View File
@@ -1,12 +1,12 @@
This is bash.info, produced by makeinfo version 6.8 from bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 5.2, 17 January 2022).
Bash shell (version 5.2, 5 February 2022).
This is Edition 5.2, last updated 17 January 2022, of 'The GNU Bash
This is Edition 5.2, last updated 5 February 2022, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.2.
Copyright (C) 1988-2021 Free Software Foundation, Inc.
Copyright (C) 1988-2022 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU Free Documentation License,
@@ -26,10 +26,10 @@ Bash Features
*************
This text is a brief description of the features that are present in the
Bash shell (version 5.2, 17 January 2022). The Bash home page is
Bash shell (version 5.2, 5 February 2022). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.2, last updated 17 January 2022, of 'The GNU Bash
This is Edition 5.2, last updated 5 February 2022, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.2.
Bash contains features that appear in other popular shells, and some
@@ -7028,73 +7028,80 @@ startup files.
7. Reserved words appearing in a context where reserved words are
recognized do not undergo alias expansion.
8. The POSIX 'PS1' and 'PS2' expansions of '!' to the history number
8. Alias expansion is performed when initially parsing a command
substitution. The default mode generally defers it, when enabled,
until the command substitution is executed. This means that
command substitution will not expand aliases that are defined after
the command substitution is initially parsed (e.g., as part of a
function definition).
9. The POSIX 'PS1' and 'PS2' expansions of '!' to the history number
and '!!' to '!' are enabled, and parameter expansion is performed
on the values of 'PS1' and 'PS2' regardless of the setting of the
'promptvars' option.
9. The POSIX startup files are executed ('$ENV') rather than the
10. The POSIX startup files are executed ('$ENV') rather than the
normal Bash files.
10. Tilde expansion is only performed on assignments preceding a
11. Tilde expansion is only performed on assignments preceding a
command name, rather than on all assignment statements on the line.
11. The default history file is '~/.sh_history' (this is the default
12. The default history file is '~/.sh_history' (this is the default
value of '$HISTFILE').
12. Redirection operators do not perform filename expansion on the
13. Redirection operators do not perform filename expansion on the
word in the redirection unless the shell is interactive.
13. Redirection operators do not perform word splitting on the word in
14. Redirection operators do not perform word splitting on the word in
the redirection.
14. Function names must be valid shell 'name's. That is, they may not
15. Function names must be valid shell 'name's. That is, they may not
contain characters other than letters, digits, and underscores, and
may not start with a digit. Declaring a function with an invalid
name causes a fatal syntax error in non-interactive shells.
15. Function names may not be the same as one of the POSIX special
16. Function names may not be the same as one of the POSIX special
builtins.
16. POSIX special builtins are found before shell functions during
17. POSIX special builtins are found before shell functions during
command lookup.
17. When printing shell function definitions (e.g., by 'type'), Bash
18. When printing shell function definitions (e.g., by 'type'), Bash
does not print the 'function' keyword.
18. Literal tildes that appear as the first character in elements of
19. Literal tildes that appear as the first character in elements of
the 'PATH' variable are not expanded as described above under *note
Tilde Expansion::.
19. The 'time' reserved word may be used by itself as a command. When
20. The 'time' reserved word may be used by itself as a command. When
used in this way, it displays timing statistics for the shell and
its completed children. The 'TIMEFORMAT' variable controls the
format of the timing information.
20. When parsing and expanding a ${...} expansion that appears within
21. When parsing and expanding a ${...} expansion that appears within
double quotes, single quotes are no longer special and cannot be
used to quote a closing brace or other special character, unless
the operator is one of those defined to perform pattern removal.
In this case, they do not have to appear as matched pairs.
21. The parser does not recognize 'time' as a reserved word if the
22. The parser does not recognize 'time' as a reserved word if the
next token begins with a '-'.
22. The '!' character does not introduce history expansion within a
23. The '!' character does not introduce history expansion within a
double-quoted string, even if the 'histexpand' option is enabled.
23. If a POSIX special builtin returns an error status, a
24. If a POSIX special builtin returns an error status, a
non-interactive shell exits. The fatal errors are those listed in
the POSIX standard, and include things like passing incorrect
options, redirection errors, variable assignment errors for
assignments preceding the command name, and so on.
24. A non-interactive shell exits with an error status if a variable
25. A non-interactive shell exits with an error status if a variable
assignment error occurs when no command name follows the assignment
statements. A variable assignment error occurs, for example, when
trying to assign a value to a readonly variable.
25. A non-interactive shell exits with an error status if a variable
26. A non-interactive shell exits with an error status if a variable
assignment error occurs in an assignment statement preceding a
special builtin, but not with any other simple command. For any
other simple command, the shell aborts execution of that command,
@@ -7102,133 +7109,133 @@ startup files.
perform any further processing of the command in which the error
occurred").
26. A non-interactive shell exits with an error status if the
27. A non-interactive shell exits with an error status if the
iteration variable in a 'for' statement or the selection variable
in a 'select' statement is a readonly variable.
27. Non-interactive shells exit if FILENAME in '.' FILENAME is not
28. Non-interactive shells exit if FILENAME in '.' FILENAME is not
found.
28. Non-interactive shells exit if a syntax error in an arithmetic
29. Non-interactive shells exit if a syntax error in an arithmetic
expansion results in an invalid expression.
29. Non-interactive shells exit if a parameter expansion error occurs.
30. Non-interactive shells exit if a parameter expansion error occurs.
30. Non-interactive shells exit if there is a syntax error in a script
31. Non-interactive shells exit if there is a syntax error in a script
read with the '.' or 'source' builtins, or in a string processed by
the 'eval' builtin.
31. While variable indirection is available, it may not be applied to
32. While variable indirection is available, it may not be applied to
the '#' and '?' special parameters.
32. When expanding the '*' special parameter in a pattern context
33. When expanding the '*' special parameter in a pattern context
where the expansion is double-quoted does not treat the '$*' as if
it were double-quoted.
33. Assignment statements preceding POSIX special builtins persist in
34. Assignment statements preceding POSIX special builtins persist in
the shell environment after the builtin completes.
34. The 'command' builtin does not prevent builtins that take
35. The 'command' builtin does not prevent builtins that take
assignment statements as arguments from expanding them as
assignment statements; when not in POSIX mode, assignment builtins
lose their assignment statement expansion properties when preceded
by 'command'.
35. The 'bg' builtin uses the required format to describe each job
36. The 'bg' builtin uses the required format to describe each job
placed in the background, which does not include an indication of
whether the job is the current or previous job.
36. The output of 'kill -l' prints all the signal names on a single
37. The output of 'kill -l' prints all the signal names on a single
line, separated by spaces, without the 'SIG' prefix.
37. The 'kill' builtin does not accept signal names with a 'SIG'
38. The 'kill' builtin does not accept signal names with a 'SIG'
prefix.
38. The 'export' and 'readonly' builtin commands display their output
39. The 'export' and 'readonly' builtin commands display their output
in the format required by POSIX.
39. The 'trap' builtin displays signal names without the leading
40. The 'trap' builtin displays signal names without the leading
'SIG'.
40. The 'trap' builtin doesn't check the first argument for a possible
41. The 'trap' builtin doesn't check the first argument for a possible
signal specification and revert the signal handling to the original
disposition if it is, unless that argument consists solely of
digits and is a valid signal number. If users want to reset the
handler for a given signal to the original disposition, they should
use '-' as the first argument.
41. 'trap -p' displays signals whose dispositions are set to SIG_DFL
42. 'trap -p' displays signals whose dispositions are set to SIG_DFL
and those that were ignored when the shell started.
42. The '.' and 'source' builtins do not search the current directory
43. The '.' and 'source' builtins do not search the current directory
for the filename argument if it is not found by searching 'PATH'.
43. Enabling POSIX mode has the effect of setting the
44. Enabling POSIX mode has the effect of setting the
'inherit_errexit' option, so subshells spawned to execute command
substitutions inherit the value of the '-e' option from the parent
shell. When the 'inherit_errexit' option is not enabled, Bash
clears the '-e' option in such subshells.
44. Enabling POSIX mode has the effect of setting the 'shift_verbose'
45. Enabling POSIX mode has the effect of setting the 'shift_verbose'
option, so numeric arguments to 'shift' that exceed the number of
positional parameters will result in an error message.
45. When the 'alias' builtin displays alias definitions, it does not
46. When the 'alias' builtin displays alias definitions, it does not
display them with a leading 'alias ' unless the '-p' option is
supplied.
46. When the 'set' builtin is invoked without options, it does not
47. When the 'set' builtin is invoked without options, it does not
display shell function names and definitions.
47. When the 'set' builtin is invoked without options, it displays
48. When the 'set' builtin is invoked without options, it displays
variable values without quotes, unless they contain shell
metacharacters, even if the result contains nonprinting characters.
48. When the 'cd' builtin is invoked in logical mode, and the pathname
49. When the 'cd' builtin is invoked in logical mode, and the pathname
constructed from '$PWD' and the directory name supplied as an
argument does not refer to an existing directory, 'cd' will fail
instead of falling back to physical mode.
49. When the 'cd' builtin cannot change a directory because the length
50. When the 'cd' builtin cannot change a directory because the length
of the pathname constructed from '$PWD' and the directory name
supplied as an argument exceeds 'PATH_MAX' when all symbolic links
are expanded, 'cd' will fail instead of attempting to use only the
supplied directory name.
50. The 'pwd' builtin verifies that the value it prints is the same as
51. The 'pwd' builtin verifies that the value it prints is the same as
the current directory, even if it is not asked to check the file
system with the '-P' option.
51. When listing the history, the 'fc' builtin does not include an
52. When listing the history, the 'fc' builtin does not include an
indication of whether or not a history entry has been modified.
52. The default editor used by 'fc' is 'ed'.
53. The default editor used by 'fc' is 'ed'.
53. The 'type' and 'command' builtins will not report a non-executable
54. The 'type' and 'command' builtins will not report a non-executable
file as having been found, though the shell will attempt to execute
such a file if it is the only so-named file found in '$PATH'.
54. The 'vi' editing mode will invoke the 'vi' editor directly when
55. The 'vi' editing mode will invoke the 'vi' editor directly when
the 'v' command is run, instead of checking '$VISUAL' and
'$EDITOR'.
55. When the 'xpg_echo' option is enabled, Bash does not attempt to
56. When the 'xpg_echo' option is enabled, Bash does not attempt to
interpret any arguments to 'echo' as options. Each argument is
displayed, after escape characters are converted.
56. The 'ulimit' builtin uses a block size of 512 bytes for the '-c'
57. The 'ulimit' builtin uses a block size of 512 bytes for the '-c'
and '-f' options.
57. The arrival of 'SIGCHLD' when a trap is set on 'SIGCHLD' does not
58. The arrival of 'SIGCHLD' when a trap is set on 'SIGCHLD' does not
interrupt the 'wait' builtin and cause it to return immediately.
The trap command is run once for each child that exits.
58. The 'read' builtin may be interrupted by a signal for which a trap
59. The 'read' builtin may be interrupted by a signal for which a trap
has been set. If Bash receives a trapped signal while executing
'read', the trap handler executes and 'read' returns an exit status
greater than 128.
59. Bash removes an exited background process's status from the list
60. Bash removes an exited background process's status from the list
of such statuses after the 'wait' builtin is used to obtain it.
There is other POSIX behavior that Bash does not implement by default
@@ -7251,7 +7258,7 @@ File: bash.info, Node: Shell Compatibility Mode, Prev: Bash POSIX Mode, Up: B
6.12 Shell Compatibility Mode
=============================
Bash-4.0 introduced the concept of a 'shell compatibility level',
Bash-4.0 introduced the concept of a "shell compatibility level",
specified as a set of options to the shopt builtin ('compat31',
'compat32', 'compat40', 'compat41', and so on). There is only one
current compatibility level - each option is mutually exclusive. The
@@ -8001,6 +8008,32 @@ Variable Settings
A great deal of run-time behavior is changeable with the following
variables.
'active-region-start-color'
A string variable that controls the text color and background
when displaying the text in the active region (see the
description of 'enable-active-region' below). This string
must not take up any physical character positions on the
display, so it should consist only of terminal escape
sequences. It is output to the terminal before displaying the
text in the active region. This variable is reset to the
default value whenever the terminal type changes. The default
value is the string that puts the terminal in standout mode,
as obtained from the terminal's terminfo description. A
sample value might be '\e[01;33m'.
'active-region-end-color'
A string variable that "undoes" the effects of
'active-region-start-color' and restores "normal" terminal
display appearance after displaying text in the active region.
This string must not take up any physical character positions
on the display, so it should consist only of terminal escape
sequences. It is output to the terminal after displaying the
text in the active region. This variable is reset to the
default value whenever the terminal type changes. The default
value is the string that restores the terminal from standout
mode, as obtained from the terminal's terminfo description. A
sample value might be '\e[0m'.
'bell-style'
Controls what happens when Readline wants to ring the terminal
bell. If set to 'none', Readline never rings the bell. If
@@ -8116,10 +8149,11 @@ Variable Settings
"region". When this variable is set to 'On', Readline allows
certain commands to designate the region as "active". When
the region is active, Readline highlights the text in the
region using the terminal's standout mode. The active region
shows the text inserted by bracketed-paste and any matching
text found by incremental and non-incremental history
searches. The default is 'On'.
region using the value of the 'active-region-start-color',
which defaults to the string that enables the terminal's
standout mode. The active region shows the text inserted by
bracketed-paste and any matching text found by incremental and
non-incremental history searches. The default is 'On'.
'enable-bracketed-paste'
When set to 'On', Readline will configure the terminal in a
@@ -11855,6 +11889,10 @@ D.3 Parameter and Variable Index
* ?: Special Parameters. (line 42)
* @: Special Parameters. (line 22)
* _: Bash Variables. (line 13)
* active-region-end-color: Readline Init File Syntax.
(line 51)
* active-region-start-color: Readline Init File Syntax.
(line 38)
* auto_resume: Job Control Variables.
(line 6)
* BASH: Bash Variables. (line 23)
@@ -11878,31 +11916,31 @@ D.3 Parameter and Variable Index
* BASH_VERSION: Bash Variables. (line 181)
* BASH_XTRACEFD: Bash Variables. (line 184)
* bell-style: Readline Init File Syntax.
(line 38)
(line 64)
* bind-tty-special-chars: Readline Init File Syntax.
(line 45)
(line 71)
* blink-matching-paren: Readline Init File Syntax.
(line 50)
(line 76)
* CDPATH: Bourne Shell Variables.
(line 9)
* CHILD_MAX: Bash Variables. (line 195)
* colored-completion-prefix: Readline Init File Syntax.
(line 55)
(line 81)
* colored-stats: Readline Init File Syntax.
(line 65)
(line 91)
* COLUMNS: Bash Variables. (line 202)
* comment-begin: Readline Init File Syntax.
(line 71)
(line 97)
* completion-display-width: Readline Init File Syntax.
(line 76)
(line 102)
* completion-ignore-case: Readline Init File Syntax.
(line 83)
(line 109)
* completion-map-case: Readline Init File Syntax.
(line 88)
(line 114)
* completion-prefix-display-length: Readline Init File Syntax.
(line 94)
(line 120)
* completion-query-items: Readline Init File Syntax.
(line 101)
(line 127)
* COMPREPLY: Bash Variables. (line 254)
* COMP_CWORD: Bash Variables. (line 208)
* COMP_KEY: Bash Variables. (line 237)
@@ -11912,31 +11950,31 @@ D.3 Parameter and Variable Index
* COMP_WORDBREAKS: Bash Variables. (line 241)
* COMP_WORDS: Bash Variables. (line 247)
* convert-meta: Readline Init File Syntax.
(line 112)
(line 138)
* COPROC: Bash Variables. (line 260)
* DIRSTACK: Bash Variables. (line 264)
* disable-completion: Readline Init File Syntax.
(line 120)
(line 146)
* echo-control-characters: Readline Init File Syntax.
(line 125)
(line 151)
* editing-mode: Readline Init File Syntax.
(line 130)
(line 156)
* EMACS: Bash Variables. (line 274)
* emacs-mode-string: Readline Init File Syntax.
(line 136)
(line 162)
* enable-active-region: Readline Init File Syntax.
(line 146)
(line 172)
* enable-bracketed-paste: Readline Init File Syntax.
(line 158)
(line 185)
* enable-keypad: Readline Init File Syntax.
(line 166)
(line 193)
* ENV: Bash Variables. (line 279)
* EPOCHREALTIME: Bash Variables. (line 284)
* EPOCHSECONDS: Bash Variables. (line 292)
* EUID: Bash Variables. (line 299)
* EXECIGNORE: Bash Variables. (line 303)
* expand-tilde: Readline Init File Syntax.
(line 177)
(line 204)
* FCEDIT: Bash Variables. (line 316)
* FIGNORE: Bash Variables. (line 320)
* FUNCNAME: Bash Variables. (line 326)
@@ -11950,15 +11988,15 @@ D.3 Parameter and Variable Index
* HISTFILESIZE: Bash Variables. (line 402)
* HISTIGNORE: Bash Variables. (line 413)
* history-preserve-point: Readline Init File Syntax.
(line 181)
(line 208)
* history-size: Readline Init File Syntax.
(line 187)
(line 214)
* HISTSIZE: Bash Variables. (line 433)
* HISTTIMEFORMAT: Bash Variables. (line 440)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 196)
(line 223)
* HOSTFILE: Bash Variables. (line 448)
* HOSTNAME: Bash Variables. (line 459)
* HOSTTYPE: Bash Variables. (line 462)
@@ -11966,13 +12004,13 @@ D.3 Parameter and Variable Index
(line 18)
* IGNOREEOF: Bash Variables. (line 465)
* input-meta: Readline Init File Syntax.
(line 205)
(line 232)
* INPUTRC: Bash Variables. (line 475)
* INSIDE_EMACS: Bash Variables. (line 479)
* isearch-terminators: Readline Init File Syntax.
(line 213)
(line 240)
* keymap: Readline Init File Syntax.
(line 220)
(line 247)
* LANG: Creating Internationalized Scripts.
(line 51)
* LANG <1>: Bash Variables. (line 485)
@@ -11994,15 +12032,15 @@ D.3 Parameter and Variable Index
(line 27)
* MAPFILE: Bash Variables. (line 540)
* mark-modified-lines: Readline Init File Syntax.
(line 250)
(line 277)
* mark-symlinked-directories: Readline Init File Syntax.
(line 255)
(line 282)
* match-hidden-files: Readline Init File Syntax.
(line 260)
(line 287)
* menu-complete-display-prefix: Readline Init File Syntax.
(line 267)
(line 294)
* meta-flag: Readline Init File Syntax.
(line 205)
(line 232)
* OLDPWD: Bash Variables. (line 544)
* OPTARG: Bourne Shell Variables.
(line 34)
@@ -12011,9 +12049,9 @@ D.3 Parameter and Variable Index
(line 38)
* OSTYPE: Bash Variables. (line 551)
* output-meta: Readline Init File Syntax.
(line 272)
(line 299)
* page-completions: Readline Init File Syntax.
(line 278)
(line 305)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 554)
@@ -12036,19 +12074,19 @@ D.3 Parameter and Variable Index
* READLINE_POINT: Bash Variables. (line 626)
* REPLY: Bash Variables. (line 630)
* revert-all-at-newline: Readline Init File Syntax.
(line 288)
(line 315)
* SECONDS: Bash Variables. (line 633)
* SHELL: Bash Variables. (line 642)
* SHELLOPTS: Bash Variables. (line 647)
* SHLVL: Bash Variables. (line 656)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 294)
(line 321)
* show-all-if-unmodified: Readline Init File Syntax.
(line 300)
(line 327)
* show-mode-in-prompt: Readline Init File Syntax.
(line 309)
(line 336)
* skip-completed-text: Readline Init File Syntax.
(line 315)
(line 342)
* SRANDOM: Bash Variables. (line 661)
* TEXTDOMAIN: Creating Internationalized Scripts.
(line 51)
@@ -12059,11 +12097,11 @@ D.3 Parameter and Variable Index
* TMPDIR: Bash Variables. (line 720)
* UID: Bash Variables. (line 724)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 328)
(line 355)
* vi-ins-mode-string: Readline Init File Syntax.
(line 339)
(line 366)
* visible-stats: Readline Init File Syntax.
(line 350)
(line 377)

File: bash.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -12519,61 +12557,61 @@ Node: Directory Stack Builtins288570
Node: Controlling the Prompt292827
Node: The Restricted Shell295789
Node: Bash POSIX Mode298396
Node: Shell Compatibility Mode309666
Node: Job Control317692
Node: Job Control Basics318149
Node: Job Control Builtins323148
Node: Job Control Variables328545
Node: Command Line Editing329698
Node: Introduction and Notation331366
Node: Readline Interaction332986
Node: Readline Bare Essentials334174
Node: Readline Movement Commands335954
Node: Readline Killing Commands336911
Node: Readline Arguments338826
Node: Searching339867
Node: Readline Init File342050
Node: Readline Init File Syntax343308
Node: Conditional Init Constructs364793
Node: Sample Init File368986
Node: Bindable Readline Commands372107
Node: Commands For Moving373308
Node: Commands For History375356
Node: Commands For Text380347
Node: Commands For Killing383993
Node: Numeric Arguments387023
Node: Commands For Completion388159
Node: Keyboard Macros392347
Node: Miscellaneous Commands393031
Node: Readline vi Mode398967
Node: Programmable Completion399871
Node: Programmable Completion Builtins407648
Node: A Programmable Completion Example418340
Node: Using History Interactively423584
Node: Bash History Facilities424265
Node: Bash History Builtins427267
Node: History Interaction432272
Node: Event Designators435889
Node: Word Designators437240
Node: Modifiers438997
Node: Installing Bash440805
Node: Basic Installation441939
Node: Compilers and Options445658
Node: Compiling For Multiple Architectures446396
Node: Installation Names448086
Node: Specifying the System Type450192
Node: Sharing Defaults450905
Node: Operation Controls451575
Node: Optional Features452530
Node: Reporting Bugs463745
Node: Major Differences From The Bourne Shell465017
Node: GNU Free Documentation License481864
Node: Indexes507038
Node: Builtin Index507489
Node: Reserved Word Index514313
Node: Variable Index516758
Node: Function Index533247
Node: Concept Index547028
Node: Shell Compatibility Mode310043
Node: Job Control318069
Node: Job Control Basics318526
Node: Job Control Builtins323525
Node: Job Control Variables328922
Node: Command Line Editing330075
Node: Introduction and Notation331743
Node: Readline Interaction333363
Node: Readline Bare Essentials334551
Node: Readline Movement Commands336331
Node: Readline Killing Commands337288
Node: Readline Arguments339203
Node: Searching340244
Node: Readline Init File342427
Node: Readline Init File Syntax343685
Node: Conditional Init Constructs366808
Node: Sample Init File371001
Node: Bindable Readline Commands374122
Node: Commands For Moving375323
Node: Commands For History377371
Node: Commands For Text382362
Node: Commands For Killing386008
Node: Numeric Arguments389038
Node: Commands For Completion390174
Node: Keyboard Macros394362
Node: Miscellaneous Commands395046
Node: Readline vi Mode400982
Node: Programmable Completion401886
Node: Programmable Completion Builtins409663
Node: A Programmable Completion Example420355
Node: Using History Interactively425599
Node: Bash History Facilities426280
Node: Bash History Builtins429282
Node: History Interaction434287
Node: Event Designators437904
Node: Word Designators439255
Node: Modifiers441012
Node: Installing Bash442820
Node: Basic Installation443954
Node: Compilers and Options447673
Node: Compiling For Multiple Architectures448411
Node: Installation Names450101
Node: Specifying the System Type452207
Node: Sharing Defaults452920
Node: Operation Controls453590
Node: Optional Features454545
Node: Reporting Bugs465760
Node: Major Differences From The Bourne Shell467032
Node: GNU Free Documentation License483879
Node: Indexes509053
Node: Builtin Index509504
Node: Reserved Word Index516328
Node: Variable Index518773
Node: Function Index535544
Node: Concept Index549325

End Tag Table
+3781 -3735
View File
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -270,7 +270,7 @@
@xrdef{Readline Init File Syntax-pg}{119}
@xrdef{Conditional Init Constructs-title}{Conditional Init Constructs}
@xrdef{Conditional Init Constructs-snt}{Section@tie 8.3.2}
@xrdef{Conditional Init Constructs-pg}{127}
@xrdef{Conditional Init Constructs-pg}{128}
@xrdef{Sample Init File-title}{Sample Init File}
@xrdef{Sample Init File-snt}{Section@tie 8.3.3}
@xrdef{Sample Init File-pg}{129}
BIN
View File
Binary file not shown.
+43 -7
View File
@@ -4,13 +4,13 @@
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!-- This text is a brief description of the features that are present in
the Bash shell (version 5.2, 17 January 2022).
the Bash shell (version 5.2, 5 February 2022).
This is Edition 5.2, last updated 17 January 2022,
This is Edition 5.2, last updated 5 February 2022,
of The GNU Bash Reference Manual,
for Bash, Version 5.2.
Copyright (C) 1988-2021 Free Software Foundation, Inc.
Copyright (C) 1988-2022 Free Software Foundation, Inc.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
@@ -77,10 +77,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.2, 17 January 2022).
the Bash shell (version 5.2, 5 February 2022).
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.2, last updated 17 January 2022,
<p>This is Edition 5.2, last updated 5 February 2022,
of <cite>The GNU Bash Reference Manual</cite>,
for <code>Bash</code>, Version 5.2.
</p>
@@ -9122,6 +9122,12 @@ example, <code>SIGTSTP</code>.
</li><li> Reserved words appearing in a context where reserved words are recognized
do not undergo alias expansion.
</li><li> Alias expansion is performed when initially parsing a command substitution.
The default mode generally defers it, when enabled, until the command
substitution is executed. This means that command substitution will not
expand aliases that are defined after the command substitution is initially
parsed (e.g., as part of a function definition).
</li><li> The <small>POSIX</small> <code>PS1</code> and <code>PS2</code> expansions of &lsquo;<samp>!</samp>&rsquo; to
the history number and &lsquo;<samp>!!</samp>&rsquo; to &lsquo;<samp>!</samp>&rsquo; are enabled,
and parameter expansion is performed on the values of <code>PS1</code> and
@@ -9358,8 +9364,8 @@ Previous: <a href="#Bash-POSIX-Mode" accesskey="p" rel="prev">Bash POSIX Mode</a
<span id="index-Compatibility-Level"></span>
<span id="index-Compatibility-Mode"></span>
<p>Bash-4.0 introduced the concept of a &lsquo;shell compatibility level&rsquo;, specified
as a set of options to the shopt builtin
<p>Bash-4.0 introduced the concept of a <em>shell compatibility level</em>,
specified as a set of options to the shopt builtin
(<code>compat31</code>,
<code>compat32</code>,
<code>compat40</code>,
@@ -10313,6 +10319,32 @@ variables.
</p>
<span id="index-variables_002c-readline"></span>
<dl compact="compact">
<dt id='index-active_002dregion_002dstart_002dcolor'><span><code>active-region-start-color</code><a href='#index-active_002dregion_002dstart_002dcolor' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>A string variable that controls the text color and background when displaying
the text in the active region (see the description of
<code>enable-active-region</code> below).
This string must not take up any physical character positions on the display,
so it should consist only of terminal escape sequences.
It is output to the terminal before displaying the text in the active region.
This variable is reset to the default value whenever the terminal type changes.
The default value is the string that puts the terminal in standout mode,
as obtained from the terminal&rsquo;s terminfo description.
A sample value might be &lsquo;<samp>\e[01;33m</samp>&rsquo;.
</p>
</dd>
<dt id='index-active_002dregion_002dend_002dcolor'><span><code>active-region-end-color</code><a href='#index-active_002dregion_002dend_002dcolor' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>A string variable that &quot;undoes&quot; the effects of <code>active-region-start-color</code>
and restores &quot;normal&quot; terminal display appearance after displaying text
in the active region.
This string must not take up any physical character positions on the display,
so it should consist only of terminal escape sequences.
It is output to the terminal after displaying the text in the active region.
This variable is reset to the default value whenever the terminal type changes.
The default value is the string that restores the terminal from standout mode,
as obtained from the terminal&rsquo;s terminfo description.
A sample value might be &lsquo;<samp>\e[0m</samp>&rsquo;.
</p>
</dd>
<dt id='index-bell_002dstyle'><span><code>bell-style</code><a href='#index-bell_002dstyle' class='copiable-anchor'> &para;</a></span></dt>
<dd><p>Controls what happens when Readline wants to ring the terminal bell.
If set to &lsquo;<samp>none</samp>&rsquo;, Readline never rings the bell. If set to
@@ -10446,6 +10478,8 @@ The text between the point and mark is referred to as the <em>region</em>.
When this variable is set to &lsquo;<samp>On</samp>&rsquo;, Readline allows certain commands
to designate the region as <em>active</em>.
When the region is active, Readline highlights the text in the region using
the value of the <code>active-region-start-color</code>, which defaults to the
string that enables
the terminal&rsquo;s standout mode.
The active region shows the text inserted by bracketed-paste and any
matching text found by incremental and non-incremental history searches.
@@ -15149,6 +15183,8 @@ Next: <a href="#Function-Index" accesskey="n" rel="next">Function Index</a>, Pre
<tr><td></td><td valign="top"><a href="#index-_005f"><code>_</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Bash-Variables">Bash Variables</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Variable-Index_vr_letter-A">A</th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-active_002dregion_002dend_002dcolor"><code>active-region-end-color</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Readline-Init-File-Syntax">Readline Init File Syntax</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-active_002dregion_002dstart_002dcolor"><code>active-region-start-color</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Readline-Init-File-Syntax">Readline Init File Syntax</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-auto_005fresume"><code>auto_resume</code></a>:</td><td>&nbsp;</td><td valign="top"><a href="#Job-Control-Variables">Job Control Variables</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th id="Variable-Index_vr_letter-B">B</th><td></td><td></td></tr>
+121 -90
View File
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 6.8 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 5.2, 1 February 2022).
Bash shell (version 5.2, 5 February 2022).
This is Edition 5.2, last updated 1 February 2022, of 'The GNU Bash
This is Edition 5.2, last updated 5 February 2022, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.2.
Copyright (C) 1988-2022 Free Software Foundation, Inc.
@@ -27,10 +27,10 @@ Bash Features
*************
This text is a brief description of the features that are present in the
Bash shell (version 5.2, 1 February 2022). The Bash home page is
Bash shell (version 5.2, 5 February 2022). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 5.2, last updated 1 February 2022, of 'The GNU Bash
This is Edition 5.2, last updated 5 February 2022, of 'The GNU Bash
Reference Manual', for 'Bash', Version 5.2.
Bash contains features that appear in other popular shells, and some
@@ -7259,7 +7259,7 @@ File: bashref.info, Node: Shell Compatibility Mode, Prev: Bash POSIX Mode, Up
6.12 Shell Compatibility Mode
=============================
Bash-4.0 introduced the concept of a 'shell compatibility level',
Bash-4.0 introduced the concept of a "shell compatibility level",
specified as a set of options to the shopt builtin ('compat31',
'compat32', 'compat40', 'compat41', and so on). There is only one
current compatibility level - each option is mutually exclusive. The
@@ -8009,6 +8009,32 @@ Variable Settings
A great deal of run-time behavior is changeable with the following
variables.
'active-region-start-color'
A string variable that controls the text color and background
when displaying the text in the active region (see the
description of 'enable-active-region' below). This string
must not take up any physical character positions on the
display, so it should consist only of terminal escape
sequences. It is output to the terminal before displaying the
text in the active region. This variable is reset to the
default value whenever the terminal type changes. The default
value is the string that puts the terminal in standout mode,
as obtained from the terminal's terminfo description. A
sample value might be '\e[01;33m'.
'active-region-end-color'
A string variable that "undoes" the effects of
'active-region-start-color' and restores "normal" terminal
display appearance after displaying text in the active region.
This string must not take up any physical character positions
on the display, so it should consist only of terminal escape
sequences. It is output to the terminal after displaying the
text in the active region. This variable is reset to the
default value whenever the terminal type changes. The default
value is the string that restores the terminal from standout
mode, as obtained from the terminal's terminfo description. A
sample value might be '\e[0m'.
'bell-style'
Controls what happens when Readline wants to ring the terminal
bell. If set to 'none', Readline never rings the bell. If
@@ -8124,10 +8150,11 @@ Variable Settings
"region". When this variable is set to 'On', Readline allows
certain commands to designate the region as "active". When
the region is active, Readline highlights the text in the
region using the terminal's standout mode. The active region
shows the text inserted by bracketed-paste and any matching
text found by incremental and non-incremental history
searches. The default is 'On'.
region using the value of the 'active-region-start-color',
which defaults to the string that enables the terminal's
standout mode. The active region shows the text inserted by
bracketed-paste and any matching text found by incremental and
non-incremental history searches. The default is 'On'.
'enable-bracketed-paste'
When set to 'On', Readline will configure the terminal in a
@@ -11863,6 +11890,10 @@ D.3 Parameter and Variable Index
* ?: Special Parameters. (line 42)
* @: Special Parameters. (line 22)
* _: Bash Variables. (line 13)
* active-region-end-color: Readline Init File Syntax.
(line 51)
* active-region-start-color: Readline Init File Syntax.
(line 38)
* auto_resume: Job Control Variables.
(line 6)
* BASH: Bash Variables. (line 23)
@@ -11886,31 +11917,31 @@ D.3 Parameter and Variable Index
* BASH_VERSION: Bash Variables. (line 181)
* BASH_XTRACEFD: Bash Variables. (line 184)
* bell-style: Readline Init File Syntax.
(line 38)
(line 64)
* bind-tty-special-chars: Readline Init File Syntax.
(line 45)
(line 71)
* blink-matching-paren: Readline Init File Syntax.
(line 50)
(line 76)
* CDPATH: Bourne Shell Variables.
(line 9)
* CHILD_MAX: Bash Variables. (line 195)
* colored-completion-prefix: Readline Init File Syntax.
(line 55)
(line 81)
* colored-stats: Readline Init File Syntax.
(line 65)
(line 91)
* COLUMNS: Bash Variables. (line 202)
* comment-begin: Readline Init File Syntax.
(line 71)
(line 97)
* completion-display-width: Readline Init File Syntax.
(line 76)
(line 102)
* completion-ignore-case: Readline Init File Syntax.
(line 83)
(line 109)
* completion-map-case: Readline Init File Syntax.
(line 88)
(line 114)
* completion-prefix-display-length: Readline Init File Syntax.
(line 94)
(line 120)
* completion-query-items: Readline Init File Syntax.
(line 101)
(line 127)
* COMPREPLY: Bash Variables. (line 254)
* COMP_CWORD: Bash Variables. (line 208)
* COMP_KEY: Bash Variables. (line 237)
@@ -11920,31 +11951,31 @@ D.3 Parameter and Variable Index
* COMP_WORDBREAKS: Bash Variables. (line 241)
* COMP_WORDS: Bash Variables. (line 247)
* convert-meta: Readline Init File Syntax.
(line 112)
(line 138)
* COPROC: Bash Variables. (line 260)
* DIRSTACK: Bash Variables. (line 264)
* disable-completion: Readline Init File Syntax.
(line 120)
(line 146)
* echo-control-characters: Readline Init File Syntax.
(line 125)
(line 151)
* editing-mode: Readline Init File Syntax.
(line 130)
(line 156)
* EMACS: Bash Variables. (line 274)
* emacs-mode-string: Readline Init File Syntax.
(line 136)
(line 162)
* enable-active-region: Readline Init File Syntax.
(line 146)
(line 172)
* enable-bracketed-paste: Readline Init File Syntax.
(line 158)
(line 185)
* enable-keypad: Readline Init File Syntax.
(line 166)
(line 193)
* ENV: Bash Variables. (line 279)
* EPOCHREALTIME: Bash Variables. (line 284)
* EPOCHSECONDS: Bash Variables. (line 292)
* EUID: Bash Variables. (line 299)
* EXECIGNORE: Bash Variables. (line 303)
* expand-tilde: Readline Init File Syntax.
(line 177)
(line 204)
* FCEDIT: Bash Variables. (line 316)
* FIGNORE: Bash Variables. (line 320)
* FUNCNAME: Bash Variables. (line 326)
@@ -11958,15 +11989,15 @@ D.3 Parameter and Variable Index
* HISTFILESIZE: Bash Variables. (line 402)
* HISTIGNORE: Bash Variables. (line 413)
* history-preserve-point: Readline Init File Syntax.
(line 181)
(line 208)
* history-size: Readline Init File Syntax.
(line 187)
(line 214)
* HISTSIZE: Bash Variables. (line 433)
* HISTTIMEFORMAT: Bash Variables. (line 440)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 196)
(line 223)
* HOSTFILE: Bash Variables. (line 448)
* HOSTNAME: Bash Variables. (line 459)
* HOSTTYPE: Bash Variables. (line 462)
@@ -11974,13 +12005,13 @@ D.3 Parameter and Variable Index
(line 18)
* IGNOREEOF: Bash Variables. (line 465)
* input-meta: Readline Init File Syntax.
(line 205)
(line 232)
* INPUTRC: Bash Variables. (line 475)
* INSIDE_EMACS: Bash Variables. (line 479)
* isearch-terminators: Readline Init File Syntax.
(line 213)
(line 240)
* keymap: Readline Init File Syntax.
(line 220)
(line 247)
* LANG: Creating Internationalized Scripts.
(line 51)
* LANG <1>: Bash Variables. (line 485)
@@ -12002,15 +12033,15 @@ D.3 Parameter and Variable Index
(line 27)
* MAPFILE: Bash Variables. (line 540)
* mark-modified-lines: Readline Init File Syntax.
(line 250)
(line 277)
* mark-symlinked-directories: Readline Init File Syntax.
(line 255)
(line 282)
* match-hidden-files: Readline Init File Syntax.
(line 260)
(line 287)
* menu-complete-display-prefix: Readline Init File Syntax.
(line 267)
(line 294)
* meta-flag: Readline Init File Syntax.
(line 205)
(line 232)
* OLDPWD: Bash Variables. (line 544)
* OPTARG: Bourne Shell Variables.
(line 34)
@@ -12019,9 +12050,9 @@ D.3 Parameter and Variable Index
(line 38)
* OSTYPE: Bash Variables. (line 551)
* output-meta: Readline Init File Syntax.
(line 272)
(line 299)
* page-completions: Readline Init File Syntax.
(line 278)
(line 305)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 554)
@@ -12044,19 +12075,19 @@ D.3 Parameter and Variable Index
* READLINE_POINT: Bash Variables. (line 626)
* REPLY: Bash Variables. (line 630)
* revert-all-at-newline: Readline Init File Syntax.
(line 288)
(line 315)
* SECONDS: Bash Variables. (line 633)
* SHELL: Bash Variables. (line 642)
* SHELLOPTS: Bash Variables. (line 647)
* SHLVL: Bash Variables. (line 656)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 294)
(line 321)
* show-all-if-unmodified: Readline Init File Syntax.
(line 300)
(line 327)
* show-mode-in-prompt: Readline Init File Syntax.
(line 309)
(line 336)
* skip-completed-text: Readline Init File Syntax.
(line 315)
(line 342)
* SRANDOM: Bash Variables. (line 661)
* TEXTDOMAIN: Creating Internationalized Scripts.
(line 51)
@@ -12067,11 +12098,11 @@ D.3 Parameter and Variable Index
* TMPDIR: Bash Variables. (line 720)
* UID: Bash Variables. (line 724)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 328)
(line 355)
* vi-ins-mode-string: Readline Init File Syntax.
(line 339)
(line 366)
* visible-stats: Readline Init File Syntax.
(line 350)
(line 377)

File: bashref.info, Node: Function Index, Next: Concept Index, Prev: Variable Index, Up: Indexes
@@ -12542,46 +12573,46 @@ Node: Readline Arguments339470
Node: Searching340514
Node: Readline Init File342700
Node: Readline Init File Syntax343961
Node: Conditional Init Constructs365449
Node: Sample Init File369645
Node: Bindable Readline Commands372769
Node: Commands For Moving373973
Node: Commands For History376024
Node: Commands For Text381018
Node: Commands For Killing384667
Node: Numeric Arguments387700
Node: Commands For Completion388839
Node: Keyboard Macros393030
Node: Miscellaneous Commands393717
Node: Readline vi Mode399656
Node: Programmable Completion400563
Node: Programmable Completion Builtins408343
Node: A Programmable Completion Example419038
Node: Using History Interactively424285
Node: Bash History Facilities424969
Node: Bash History Builtins427974
Node: History Interaction432982
Node: Event Designators436602
Node: Word Designators437956
Node: Modifiers439716
Node: Installing Bash441527
Node: Basic Installation442664
Node: Compilers and Options446386
Node: Compiling For Multiple Architectures447127
Node: Installation Names448820
Node: Specifying the System Type450929
Node: Sharing Defaults451645
Node: Operation Controls452318
Node: Optional Features453276
Node: Reporting Bugs464494
Node: Major Differences From The Bourne Shell465769
Node: GNU Free Documentation License482619
Node: Indexes507796
Node: Builtin Index508250
Node: Reserved Word Index515077
Node: Variable Index517525
Node: Function Index534017
Node: Concept Index547801
Node: Conditional Init Constructs367087
Node: Sample Init File371283
Node: Bindable Readline Commands374407
Node: Commands For Moving375611
Node: Commands For History377662
Node: Commands For Text382656
Node: Commands For Killing386305
Node: Numeric Arguments389338
Node: Commands For Completion390477
Node: Keyboard Macros394668
Node: Miscellaneous Commands395355
Node: Readline vi Mode401294
Node: Programmable Completion402201
Node: Programmable Completion Builtins409981
Node: A Programmable Completion Example420676
Node: Using History Interactively425923
Node: Bash History Facilities426607
Node: Bash History Builtins429612
Node: History Interaction434620
Node: Event Designators438240
Node: Word Designators439594
Node: Modifiers441354
Node: Installing Bash443165
Node: Basic Installation444302
Node: Compilers and Options448024
Node: Compiling For Multiple Architectures448765
Node: Installation Names450458
Node: Specifying the System Type452567
Node: Sharing Defaults453283
Node: Operation Controls453956
Node: Optional Features454914
Node: Reporting Bugs466132
Node: Major Differences From The Bourne Shell467407
Node: GNU Free Documentation License484257
Node: Indexes509434
Node: Builtin Index509888
Node: Reserved Word Index516715
Node: Variable Index519163
Node: Function Index535937
Node: Concept Index549721

End Tag Table
+30 -48
View File
@@ -1,9 +1,12 @@
This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2021/MacPorts 2021.58693_0) (preloaded format=pdftex 2021.10.21) 18 JAN 2022 10:57
This is pdfTeX, Version 3.141592653-2.6-1.40.22 (TeX Live 2021/MacPorts 2021.58693_1) (preloaded format=etex 2021.10.21) 11 FEB 2022 09:17
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
%&-line parsing enabled.
**/usr/local/src/chet/src/bash/src/doc/bashref.texi
(/usr/local/src/chet/src/bash/src/doc/bashref.texi (./texinfo.tex
**\nonstopmode \input /usr/local/src/chet/src/bash/src/doc/bashref.texi \input
/usr/local/src/chet/src/bash/src/doc/bashref.texi
(/usr/local/src/chet/src/bash/src/doc/bashref.texi
(/Users/chet/src/bash/src/doc/texinfo.tex
Loading texinfo [version 2015-11-22.14]:
\outerhsize=\dimen16
\outervsize=\dimen17
@@ -159,24 +162,24 @@ This is `epsf.tex' v2.7.4 <14 February 2011>
texinfo.tex: doing @include of version.texi
(./version.texi) [1{/opt/local/var/db/texmf/fonts/map/pdftex/updmap/pdftex.map}
] [2] (./bashref.toc [-1] [-2] [-3]) [-4] (./bashref.toc) (./bashref.toc)
Chapter 1
(/Users/chet/src/bash/src/doc/version.texi) [1] [2]
(/Users/chet/src/bash/src/doc/bashref.toc [-1] [-2] [-3]) [-4] Chapter 1
\openout0 = `bashref.toc'.
(./bashref.aux)
(/Users/chet/src/bash/src/doc/bashref.aux)
\openout1 = `bashref.aux'.
Chapter 2 [1] [2]
@cpindfile=@write2
\openout2 = `bashref.cp'.
[3] Chapter 3 [4] [5] [6] [7]
[3] Chapter 3
[4] [5] [6] [7]
@vrindfile=@write3
\openout3 = `bashref.vr'.
[8]
[8]
Overfull \hbox (3.12749pt too wide) in paragraph at lines 723--724
@texttt coproc[]|
@@ -256,8 +259,8 @@ texinfo.tex: doing @include of rluser.texi
(/usr/local/src/chet/src/bash/src/lib/readline/doc/rluser.texi Chapter 8
[115] [116] [117] [118] [119] [120] [121] [122] [123] [124] [125]
Underfull \hbox (badness 7540) in paragraph at lines 831--837
[115] [116] [117] [118] [119] [120] [121] [122] [123] [124] [125] [126]
Underfull \hbox (badness 7540) in paragraph at lines 859--865
[]@textrm In the ex-am-ple above, @textttsl C-u[] @textrm is bound to the func
-tion
@@ -270,7 +273,7 @@ Underfull \hbox (badness 7540) in paragraph at lines 831--837
.etc.
Underfull \hbox (badness 10000) in paragraph at lines 831--837
Underfull \hbox (badness 10000) in paragraph at lines 859--865
@texttt universal-argument[]@textrm , @textttsl M-DEL[] @textrm is bound to th
e func-tion
@@ -282,8 +285,8 @@ e func-tion
.@texttt v
.etc.
[126] [127] [128] [129]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 1065--1065
[127] [128] [129]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 1093--1093
[]@texttt Meta-Control-h: backward-kill-word Text after the function name is i
gnored[]
@@ -301,7 +304,7 @@ gnored[]
[132] [133] [134] [135] [136] [137] [138] [139] [140] [141]
[142] [143] [144]
Overfull \hbox (15.27109pt too wide) in paragraph at lines 2090--2090
Overfull \hbox (15.27109pt too wide) in paragraph at lines 2118--2118
[]@texttt complete [-abcdefgjksuv] [-o @textttsl comp-option@texttt ] [-DEI] [
-A @textttsl ac-tion@texttt ] [-
@@ -320,7 +323,7 @@ texinfo.tex: doing @include of hsuser.texi
(/usr/local/src/chet/src/bash/src/lib/readline/doc/hsuser.texi Chapter 9
[150] [151] [152] [153] [154] [155]) Chapter 10 [156] [157] [158] [159]
[160]
Underfull \hbox (badness 10000) in paragraph at lines 9318--9327
Underfull \hbox (badness 10000) in paragraph at lines 9325--9334
[]@textrm All of the fol-low-ing op-tions ex-cept for `@texttt alt-array-implem
entation[]@textrm '[],
@@ -333,7 +336,7 @@ entation[]@textrm '[],
.etc.
Underfull \hbox (badness 10000) in paragraph at lines 9318--9327
Underfull \hbox (badness 10000) in paragraph at lines 9325--9334
@textrm `@texttt disabled-builtins[]@textrm '[], `@texttt direxpand-default[]@t
extrm '[], `@texttt strict-posix-default[]@textrm '[], and
@@ -349,37 +352,16 @@ extrm '[], `@texttt strict-posix-default[]@textrm '[], and
[170] [171] Appendix C [172]
texinfo.tex: doing @include of fdl.texi
(./fdl.texi [173] [174] [175] [176] [177] [178]
[179]) Appendix D [180] [181] [182] [183] [184] [185] [186] [187] [188]
[189] )
(/Users/chet/src/bash/src/doc/fdl.texi [173]
[174] [175] [176] [177] [178] [179]) Appendix D [180] [181] [182] [183]
[184] [185] [186] [187] [188] [189] )
Here is how much of TeX's memory you used:
4093 strings out of 497086
46984 string characters out of 6206519
140410 words of memory out of 5000000
4867 multiletter control sequences out of 15000+600000
3531 strings out of 497096
40156 string characters out of 6206922
87691 words of memory out of 5000000
4700 multiletter control sequences out of 15000+600000
34315 words of font info for 116 fonts, out of 8000000 for 9000
51 hyphenation exceptions out of 8191
16i,6n,16p,323b,978s stack positions out of 5000i,500n,10000p,200000b,80000s
{/opt/local/share/texmf-texlive/fonts/enc/dvips/cm-super/cm-super-t1.enc
}</opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmbx12.pfb></op
t/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmcsc10.pfb></opt/lo
cal/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi10.pfb></opt/local/s
hare/texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi12.pfb></opt/local/share/
texmf-texlive/fonts/type1/public/amsfonts/cm/cmmi9.pfb></opt/local/share/texmf-
texlive/fonts/type1/public/amsfonts/cm/cmr10.pfb></opt/local/share/texmf-texliv
e/fonts/type1/public/amsfonts/cm/cmr9.pfb></opt/local/share/texmf-texlive/fonts
/type1/public/amsfonts/cm/cmsl10.pfb></opt/local/share/texmf-texlive/fonts/type
1/public/amsfonts/cm/cmsltt10.pfb></opt/local/share/texmf-texlive/fonts/type1/p
ublic/amsfonts/cm/cmsy10.pfb></opt/local/share/texmf-texlive/fonts/type1/public
/amsfonts/cm/cmti10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsf
onts/cm/cmtt10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/
cm/cmtt12.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cm
tt9.pfb></opt/local/share/texmf-texlive/fonts/type1/public/cm-super/sfrm1095.pf
b></opt/local/share/texmf-texlive/fonts/type1/public/cm-super/sfrm1440.pfb>
Output written on bashref.pdf (195 pages, 791026 bytes).
PDF statistics:
2743 PDF objects out of 2984 (max. 8388607)
2501 compressed objects within 26 object streams
323 named destinations out of 1000 (max. 500000)
1141 words of extra memory for PDF output out of 10000 (max. 10000000)
16i,6n,16p,400b,942s stack positions out of 5000i,500n,10000p,200000b,80000s
Output written on bashref.dvi (195 pages, 819604 bytes).
+957 -902
View File
File diff suppressed because it is too large Load Diff
+1 -1
View File
@@ -98,7 +98,7 @@
@numsubsecentry{Searching for Commands in the History}{8.2.5}{Searching}{118}
@numsecentry{Readline Init File}{8.3}{Readline Init File}{119}
@numsubsecentry{Readline Init File Syntax}{8.3.1}{Readline Init File Syntax}{119}
@numsubsecentry{Conditional Init Constructs}{8.3.2}{Conditional Init Constructs}{127}
@numsubsecentry{Conditional Init Constructs}{8.3.2}{Conditional Init Constructs}{128}
@numsubsecentry{Sample Init File}{8.3.3}{Sample Init File}{129}
@numsecentry{Bindable Readline Commands}{8.4}{Bindable Readline Commands}{132}
@numsubsecentry{Commands For Moving}{8.4.1}{Commands For Moving}{132}
+22 -20
View File
@@ -128,44 +128,46 @@
\entry{TMPDIR}{89}{\code {TMPDIR}}
\entry{UID}{89}{\code {UID}}
\entry{auto_resume}{115}{\code {auto_resume}}
\entry{active-region-start-color}{120}{\code {active-region-start-color}}
\entry{active-region-end-color}{120}{\code {active-region-end-color}}
\entry{bell-style}{120}{\code {bell-style}}
\entry{bind-tty-special-chars}{120}{\code {bind-tty-special-chars}}
\entry{blink-matching-paren}{120}{\code {blink-matching-paren}}
\entry{colored-completion-prefix}{120}{\code {colored-completion-prefix}}
\entry{colored-stats}{120}{\code {colored-stats}}
\entry{comment-begin}{120}{\code {comment-begin}}
\entry{blink-matching-paren}{121}{\code {blink-matching-paren}}
\entry{colored-completion-prefix}{121}{\code {colored-completion-prefix}}
\entry{colored-stats}{121}{\code {colored-stats}}
\entry{comment-begin}{121}{\code {comment-begin}}
\entry{completion-display-width}{121}{\code {completion-display-width}}
\entry{completion-ignore-case}{121}{\code {completion-ignore-case}}
\entry{completion-map-case}{121}{\code {completion-map-case}}
\entry{completion-prefix-display-length}{121}{\code {completion-prefix-display-length}}
\entry{completion-query-items}{121}{\code {completion-query-items}}
\entry{convert-meta}{121}{\code {convert-meta}}
\entry{disable-completion}{121}{\code {disable-completion}}
\entry{echo-control-characters}{121}{\code {echo-control-characters}}
\entry{editing-mode}{121}{\code {editing-mode}}
\entry{convert-meta}{122}{\code {convert-meta}}
\entry{disable-completion}{122}{\code {disable-completion}}
\entry{echo-control-characters}{122}{\code {echo-control-characters}}
\entry{editing-mode}{122}{\code {editing-mode}}
\entry{emacs-mode-string}{122}{\code {emacs-mode-string}}
\entry{enable-active-region}{122}{\code {enable-active-region}}
\entry{enable-bracketed-paste}{122}{\code {enable-bracketed-paste}}
\entry{enable-keypad}{122}{\code {enable-keypad}}
\entry{expand-tilde}{122}{\code {expand-tilde}}
\entry{history-preserve-point}{122}{\code {history-preserve-point}}
\entry{enable-bracketed-paste}{123}{\code {enable-bracketed-paste}}
\entry{enable-keypad}{123}{\code {enable-keypad}}
\entry{expand-tilde}{123}{\code {expand-tilde}}
\entry{history-preserve-point}{123}{\code {history-preserve-point}}
\entry{history-size}{123}{\code {history-size}}
\entry{horizontal-scroll-mode}{123}{\code {horizontal-scroll-mode}}
\entry{input-meta}{123}{\code {input-meta}}
\entry{meta-flag}{123}{\code {meta-flag}}
\entry{isearch-terminators}{123}{\code {isearch-terminators}}
\entry{keymap}{123}{\code {keymap}}
\entry{isearch-terminators}{124}{\code {isearch-terminators}}
\entry{keymap}{124}{\code {keymap}}
\entry{mark-modified-lines}{124}{\code {mark-modified-lines}}
\entry{mark-symlinked-directories}{124}{\code {mark-symlinked-directories}}
\entry{match-hidden-files}{124}{\code {match-hidden-files}}
\entry{menu-complete-display-prefix}{124}{\code {menu-complete-display-prefix}}
\entry{output-meta}{124}{\code {output-meta}}
\entry{page-completions}{124}{\code {page-completions}}
\entry{revert-all-at-newline}{124}{\code {revert-all-at-newline}}
\entry{menu-complete-display-prefix}{125}{\code {menu-complete-display-prefix}}
\entry{output-meta}{125}{\code {output-meta}}
\entry{page-completions}{125}{\code {page-completions}}
\entry{revert-all-at-newline}{125}{\code {revert-all-at-newline}}
\entry{show-all-if-ambiguous}{125}{\code {show-all-if-ambiguous}}
\entry{show-all-if-unmodified}{125}{\code {show-all-if-unmodified}}
\entry{show-mode-in-prompt}{125}{\code {show-mode-in-prompt}}
\entry{skip-completed-text}{125}{\code {skip-completed-text}}
\entry{vi-cmd-mode-string}{125}{\code {vi-cmd-mode-string}}
\entry{vi-ins-mode-string}{125}{\code {vi-ins-mode-string}}
\entry{vi-cmd-mode-string}{126}{\code {vi-cmd-mode-string}}
\entry{vi-ins-mode-string}{126}{\code {vi-ins-mode-string}}
\entry{visible-stats}{126}{\code {visible-stats}}
+22 -20
View File
@@ -26,6 +26,8 @@
\initial {0}
\entry{\code {0}}{23}
\initial {A}
\entry{\code {active-region-end-color}}{120}
\entry{\code {active-region-start-color}}{120}
\entry{\code {auto_resume}}{115}
\initial {B}
\entry{\code {BASH}}{78}
@@ -50,14 +52,14 @@
\entry{\code {BASHPID}}{78}
\entry{\code {bell-style}}{120}
\entry{\code {bind-tty-special-chars}}{120}
\entry{\code {blink-matching-paren}}{120}
\entry{\code {blink-matching-paren}}{121}
\initial {C}
\entry{\code {CDPATH}}{77}
\entry{\code {CHILD_MAX}}{81}
\entry{\code {colored-completion-prefix}}{120}
\entry{\code {colored-stats}}{120}
\entry{\code {colored-completion-prefix}}{121}
\entry{\code {colored-stats}}{121}
\entry{\code {COLUMNS}}{81}
\entry{\code {comment-begin}}{120}
\entry{\code {comment-begin}}{121}
\entry{\code {COMP_CWORD}}{81}
\entry{\code {COMP_KEY}}{81}
\entry{\code {COMP_LINE}}{81}
@@ -71,25 +73,25 @@
\entry{\code {completion-prefix-display-length}}{121}
\entry{\code {completion-query-items}}{121}
\entry{\code {COMPREPLY}}{82}
\entry{\code {convert-meta}}{121}
\entry{\code {convert-meta}}{122}
\entry{\code {COPROC}}{82}
\initial {D}
\entry{\code {DIRSTACK}}{82}
\entry{\code {disable-completion}}{121}
\entry{\code {disable-completion}}{122}
\initial {E}
\entry{\code {echo-control-characters}}{121}
\entry{\code {editing-mode}}{121}
\entry{\code {echo-control-characters}}{122}
\entry{\code {editing-mode}}{122}
\entry{\code {emacs-mode-string}}{122}
\entry{\code {EMACS}}{82}
\entry{\code {enable-active-region}}{122}
\entry{\code {enable-bracketed-paste}}{122}
\entry{\code {enable-keypad}}{122}
\entry{\code {enable-bracketed-paste}}{123}
\entry{\code {enable-keypad}}{123}
\entry{\code {ENV}}{82}
\entry{\code {EPOCHREALTIME}}{82}
\entry{\code {EPOCHSECONDS}}{82}
\entry{\code {EUID}}{82}
\entry{\code {EXECIGNORE}}{82}
\entry{\code {expand-tilde}}{122}
\entry{\code {expand-tilde}}{123}
\initial {F}
\entry{\code {FCEDIT}}{83}
\entry{\code {FIGNORE}}{83}
@@ -105,7 +107,7 @@
\entry{\code {HISTFILE}}{84}
\entry{\code {HISTFILESIZE}}{84}
\entry{\code {HISTIGNORE}}{84}
\entry{\code {history-preserve-point}}{122}
\entry{\code {history-preserve-point}}{123}
\entry{\code {history-size}}{123}
\entry{\code {HISTSIZE}}{84}
\entry{\code {HISTTIMEFORMAT}}{84}
@@ -120,9 +122,9 @@
\entry{\code {input-meta}}{123}
\entry{\code {INPUTRC}}{85}
\entry{\code {INSIDE_EMACS}}{85}
\entry{\code {isearch-terminators}}{123}
\entry{\code {isearch-terminators}}{124}
\initial {K}
\entry{\code {keymap}}{123}
\entry{\code {keymap}}{124}
\initial {L}
\entry{\code {LANG}}{8, 85}
\entry{\code {LC_ALL}}{85}
@@ -142,7 +144,7 @@
\entry{\code {mark-modified-lines}}{124}
\entry{\code {mark-symlinked-directories}}{124}
\entry{\code {match-hidden-files}}{124}
\entry{\code {menu-complete-display-prefix}}{124}
\entry{\code {menu-complete-display-prefix}}{125}
\entry{\code {meta-flag}}{123}
\initial {O}
\entry{\code {OLDPWD}}{86}
@@ -150,9 +152,9 @@
\entry{\code {OPTERR}}{86}
\entry{\code {OPTIND}}{77}
\entry{\code {OSTYPE}}{86}
\entry{\code {output-meta}}{124}
\entry{\code {output-meta}}{125}
\initial {P}
\entry{\code {page-completions}}{124}
\entry{\code {page-completions}}{125}
\entry{\code {PATH}}{77}
\entry{\code {PIPESTATUS}}{86}
\entry{\code {POSIXLY_CORRECT}}{86}
@@ -172,7 +174,7 @@
\entry{\code {READLINE_MARK}}{87}
\entry{\code {READLINE_POINT}}{87}
\entry{\code {REPLY}}{87}
\entry{\code {revert-all-at-newline}}{124}
\entry{\code {revert-all-at-newline}}{125}
\initial {S}
\entry{\code {SECONDS}}{87}
\entry{\code {SHELL}}{87}
@@ -192,6 +194,6 @@
\initial {U}
\entry{\code {UID}}{89}
\initial {V}
\entry{\code {vi-cmd-mode-string}}{125}
\entry{\code {vi-ins-mode-string}}{125}
\entry{\code {vi-cmd-mode-string}}{126}
\entry{\code {vi-ins-mode-string}}{126}
\entry{\code {visible-stats}}{126}
+8 -8
View File
@@ -1939,14 +1939,14 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
exit status of the last process or job waited for.
SSHHEELLLL CCOOMMPPAATTIIBBIILLIITTYY MMOODDEE
Bash-4.0 introduced the concept of a `shell compatibility level', spec-
ified as a set of options to the shopt builtin ccoommppaatt3311, ccoommppaatt3322, ccoomm--
ppaatt4400, ccoommppaatt4411, and so on). There is only one current compatibility
level -- each option is mutually exclusive. The compatibility level is
intended to allow users to select behavior from previous versions that
is incompatible with newer versions while they migrate scripts to use
current features and behavior. It's intended to be a temporary solu-
tion.
Bash-4.0 introduced the concept of a _s_h_e_l_l _c_o_m_p_a_t_i_b_i_l_i_t_y _l_e_v_e_l, speci-
fied as a set of options to the shopt builtin ( ccoommppaatt3311, ccoommppaatt3322,
ccoommppaatt4400, ccoommppaatt4411, and so on). There is only one current compatibil-
ity level -- each option is mutually exclusive. The compatibility
level is intended to allow users to select behavior from previous ver-
sions that is incompatible with newer versions while they migrate
scripts to use current features and behavior. It's intended to be a
temporary solution.
This section does not mention behavior that is standard for a particu-
lar version (e.g., setting ccoommppaatt3322 means that quoting the rhs of the
+11 -12
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.4
%%CreationDate: Tue Jan 18 10:57:20 2022
%%CreationDate: Fri Feb 11 09:17:45 2022
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
@@ -3221,17 +3221,16 @@ E F2(id)3.083 E F0 3.083(sa)C .583(re supplied, an)-3.083 F 3.083(yj)
(Otherwise, the return status is the e)5 E
(xit status of the last process or job w)-.15 E(aited for)-.1 E(.)-.55 E
/F5 10.95/Times-Bold@0 SF(SHELL COMP)72 576 Q -1.04(AT)-.81 G
(IBILITY MODE)1.04 E F0 .912
(Bash-4.0 introduced the concept of a `shell compatibility le)108 588 R
-.15(ve)-.25 G .912(l', speci\214ed as a set of options to the shopt).15
F -.2(bu)108 600 S(iltin).2 E F1(compat31)3.377 E F0(,)A F1(compat32)
3.377 E F0(,)A F1(compat40)3.377 E F0(,)A F1(compat41)3.377 E F0 3.378
(,a)C .878(nd so on\).)-3.378 F .878
(There is only one current compatibility)5.878 F(le)108 612 Q -.15(ve)
-.25 G 3.254(l-).15 G 3.254(-e)-3.254 G .754(ach option is mutually e)
-3.254 F(xclusi)-.15 E -.15(ve)-.25 G 5.754(.T).15 G .754
(he compatibility le)-5.754 F -.15(ve)-.25 G 3.253(li).15 G 3.253(si)
-3.253 G .753(ntended to allo)-3.253 F 3.253(wu)-.25 G .753
(IBILITY MODE)1.04 E F0 1.355(Bash-4.0 introduced the concept of a)108
588 R F2 1.355(shell compatibility le)3.855 F(vel)-.15 E F0 3.855(,s)C
1.354(peci\214ed as a set of options to the shopt)-3.855 F -.2(bu)108
600 S .398(iltin \().2 F F1(compat31)2.898 E F0(,)A F1(compat32)2.898 E
F0(,)A F1(compat40)2.898 E F0(,)A F1(compat41)2.898 E F0 2.898(,a)C .399
(nd so on\).)-2.898 F .399(There is only one current compatibility)5.399
F(le)108 612 Q -.15(ve)-.25 G 3.254(l-).15 G 3.254(-e)-3.254 G .754
(ach option is mutually e)-3.254 F(xclusi)-.15 E -.15(ve)-.25 G 5.754
(.T).15 G .754(he compatibility le)-5.754 F -.15(ve)-.25 G 3.253(li).15
G 3.253(si)-3.253 G .753(ntended to allo)-3.253 F 3.253(wu)-.25 G .753
(sers to select be-)-3.253 F(ha)108 624 Q 1.083(vior from pre)-.2 F
1.083(vious v)-.25 F 1.083(ersions that is incompatible with ne)-.15 F
1.083(wer v)-.25 F 1.083(ersions while the)-.15 F 3.584(ym)-.15 G 1.084
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.22.4
%%CreationDate: Tue Jan 18 10:57:20 2022
%%CreationDate: Fri Feb 11 09:17:45 2022
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.22 4
+5 -1
View File
@@ -415,6 +415,8 @@ extern int locale_utf8locale; /* XXX */
_i = is_basic (*((_src) + (_si))); \
if (_i) \
mblength = 1; \
else if (locale_utf8locale && (((_src)[_si] & 0x80) == 0)) \
mblength = (_src)[_si] != 0; \
else \
{ \
state_bak = state; \
@@ -531,7 +533,9 @@ extern int locale_utf8locale; /* XXX */
i = is_basic (*((_src) + (_si))); \
if (i) \
mblength = 1; \
else \
else if (locale_utf8locale && (((_src)[_si] & 0x80) == 0)) \
mblength = (_src)[_si] != 0; \
else \
{ \
state_bak = state; \
mblength = mbrlen ((_src) + (_si), (_srcsize) - (_si), &state); \
+5 -5
View File
@@ -339,7 +339,7 @@ The variables and their default values are:
.PP
.PD 0
.TP
.B active-region-start-color
.B active\-region\-start\-color
A string variable that controls the text color and background when displaying
the text in the active region (see the description of
\fBenable\-active\-region\fP below).
@@ -349,10 +349,10 @@ It is output to the terminal before displaying the text in the active region.
This variable is reset to the default value whenever the terminal type changes.
The default value is the string that puts the terminal in standout mode,
as obtained from the terminal's terminfo description.
A sample value might be \f(CW\ee[01;33m\fP.
A sample value might be \f(CW"\ee[01;33m"\fP.
.TP
.B active-region-end-color
A string variable that "undoes" the effects of \fBactive-region-start-color\fP
.B active\-region\-end\-color
A string variable that "undoes" the effects of \fBactive\-region\-start\-color\fP
and restores "normal" terminal display appearance after displaying text
in the active region.
This string must not take up any physical character positions on the display,
@@ -361,7 +361,7 @@ It is output to the terminal after displaying the text in the active region.
This variable is reset to the default value whenever the terminal type changes.
The default value is the string that restores the terminal from standout mode,
as obtained from the terminal's terminfo description.
A sample value might be \f(CW\ee[0m\fP.
A sample value might be \f(CW"\ee[0m\fP".
.TP
.B bell\-style (audible)
Controls what happens when readline wants to ring the terminal bell.
+10 -10
View File
@@ -3399,7 +3399,7 @@ read_token (command)
character = '\n'; /* this will take the next if statement and return. */
}
if (character == '\n')
if MBTEST(character == '\n')
{
/* If we're about to return an unquoted newline, we can go and collect
the text of any pending here document. */
@@ -3440,7 +3440,7 @@ read_token (command)
else
peek_char = shell_getc (1);
if (character == peek_char)
if MBTEST(character == peek_char)
{
switch (character)
{
@@ -3669,7 +3669,7 @@ parse_matched_pair (qc, open, close, lenp, flags)
}
/* Possible reprompting. */
if (ch == '\n' && SHOULD_PROMPT ())
if MBTEST(ch == '\n' && SHOULD_PROMPT ())
prompt_again (0);
/* Don't bother counting parens or doing anything else if in a comment
@@ -3680,7 +3680,7 @@ parse_matched_pair (qc, open, close, lenp, flags)
RESIZE_MALLOCED_BUFFER (ret, retind, 1, retsize, 64);
ret[retind++] = ch;
if (ch == '\n')
if MBTEST(ch == '\n')
tflags &= ~LEX_INCOMMENT;
continue;
@@ -3696,7 +3696,7 @@ parse_matched_pair (qc, open, close, lenp, flags)
{
tflags &= ~LEX_PASSNEXT;
/* XXX - PST_NOEXPAND? */
if (qc != '\'' && ch == '\n') /* double-quoted \<newline> disappears. */
if MBTEST(qc != '\'' && ch == '\n') /* double-quoted \<newline> disappears. */
{
if (retind > 0)
retind--; /* swallow previously-added backslash */
@@ -4807,7 +4807,7 @@ read_token_word (character)
/* Backslash-newline is ignored in all cases except
when quoted with single quotes. */
if (peek_char == '\n')
if MBTEST(peek_char == '\n')
{
character = '\n';
goto next_character;
@@ -4817,7 +4817,7 @@ read_token_word (character)
shell_ungetc (peek_char);
/* If the next character is to be quoted, note it now. */
if (cd == 0 || cd == '`' ||
if MBTEST(cd == 0 || cd == '`' ||
(cd == '"' && peek_char >= 0 && (sh_syntaxtab[peek_char] & CBSDQUOTE)))
pass_next_character++;
@@ -4902,7 +4902,7 @@ read_token_word (character)
/* If the delimiter character is not single quote, parse some of
the shell expansions that must be read as a single word. */
if (shellexp (character))
if MBTEST(shellexp (character))
{
peek_char = shell_getc (1);
/* $(...), <(...), >(...), $((...)), ${...}, and $[...] constructs */
@@ -5082,7 +5082,7 @@ read_token_word (character)
}
got_character:
if (character == CTLESC || character == CTLNUL)
if MBTEST(character == CTLESC || character == CTLNUL)
{
RESIZE_MALLOCED_BUFFER (token, token_index, 2, token_buffer_size,
TOKEN_DEFAULT_GROW_SIZE);
@@ -5196,7 +5196,7 @@ got_token:
yylval.word = the_word;
/* should we check that quoted == 0 as well? */
if (token[0] == '{' && token[token_index-1] == '}' &&
if MBTEST(token[0] == '{' && token[token_index-1] == '}' &&
(character == '<' || character == '>'))
{
/* can use token; already copied to the_word */
+1 -1
View File
@@ -1,4 +1,4 @@
BUILD_DIR=/usr/local/build/bash/bash-current
BUILD_DIR=/usr/local/build/chet/bash/bash-current
THIS_SH=$BUILD_DIR/bash
PATH=$PATH:$BUILD_DIR