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

commit bash-20150821 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2015-09-01 14:44:52 -04:00
parent f2d7e1a3bc
commit d7935593ab
56 changed files with 8050 additions and 7726 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CHANGES
+1 -1
View File
@@ -236,7 +236,7 @@ www. Fixes for upper and lower-casing multibyte characters, some locales have
bytes.
xxx. Fixed a bug that caused the ERR trap in a shell function to have the
right value for $LINENO.
wrong value for $LINENO.
yyy. Fixed a bug that resulted in incorrect quoting of regexps for the =~
operator when an open brace appears without a close brace.
CWRU/CWRU.chlog
+81
View File
@@ -9385,3 +9385,84 @@ doc/{bash.1,bashref.texi}
configure.ac,Makefile.in,builtins/Makefile.in
- loadablesdir: set in configure, substitute into Makefiles. Reserved
for future use
8/18
----
subst.c
- shell_expand_word_list: if make_internal_declare fails, make sure to
propagate that error return back and make the assignment statement fail.
Fixes seg fault reported by Sergey Tselikh <stselikh@gmail.com>
8/20
----
builtins/declare.def
- declare_internal: made a slight tweak to the warning message about
quoted compound assignments by printing it only if the array (indexed
or assoc) does not already exist
8/21
----
braces.c
- mkseq: call strvec_dispose before throw_to_top_level if we saw SIGINT
to avoid a memory leak
trap.c
- maybe_set_return_trap: set the RETURN trap to string if it's not already
trapped, in the same way as the debug and error traps
execute_cmd.c
- execute_function: use maybe_set_return_trap to allow functions to set
return traps that persist across calls even if function tracing is
enabled
lib/readline/input.c
- rl_gather_tyi: make sure errno reset to 0 after select call, for
ioctl and read
- rl_gather_tyi: if read returns -1/EIO, return -1
- rl_read_key: if rl_gather_tyi returns -1/EIO, return READERR if in
RL_STATE_READCMD (reading command in readline_internal_char), EOF
if not (like rl_getc). Continue to return '\n' on other errors;
rl_done = 1 in any case. Fix for issue reported by
Lubomir Rintel <lkundrak@v3.sk>
lib/readline/{misc,text,vi_mode}.c
- fix return values from rl_read_key to handle < 0
8/22
----
parse.y
- parsing_redirection: macro that expands to true if the last read
token (always passed as an argument) is a redirection token that
will leave us reading a word that's the target of the redirection
- command_token_position: make sure that even if the parser state
indicates we are reading a simple command (PST_REDIRLIST), we do
not perform alias expansion on a WORD that is part of a redirection,
using parsing_redirection() to do so. Fixes but reported to Red Hat
by Robert Alm Nilsson <rorialni@gmail.com>
https://bugzilla.redhat.com/show_bug.cgi?id=795795
builtins/declare.def
- declare_internal: only print the warning now if the variable is not
already an array or if we are not creating an array with -a or -A,
cuts down the spurious warnings
- declare_internal: even if the rhs of the assignment looks like a
compound array, if we're not assigning to an existing array or we're
not creating an array, make it an array subscript assignment. This
means things like declare a[1]='(foo)' and a[1]='(foo)' behave
identically
builtins/help.def
- wdispcolumn: change use of displen and add new dispchars variable to
deal with locales where each wide character does not take up one
column position. Fix for bug reported by Mingye (Arthur) Wang
<arthur200126@hotmail.com>
8/23
----
sig.c
- sigint_sighandler: if we get a SIGINT while this_shell_builtin ==
wait_builtin, perform the special handling only if wait_intr_flag
is non-zero, don't just use it to set wait_sigint_received. This
makes sure we run bashline_set_event_hook. Fixes bug reported by
isabella parakiss <izaberina@gmail.com>
MANIFEST
+2
View File
@@ -853,6 +853,7 @@ tests/assoc4.sub f
tests/assoc5.sub f
tests/assoc6.sub f
tests/assoc7.sub f
tests/assoc8.sub f
tests/braces.tests f
tests/braces.right f
tests/builtins.tests f
@@ -938,6 +939,7 @@ tests/errors2.sub f
tests/errors3.sub f
tests/errors4.sub f
tests/errors5.sub f
tests/errors6.sub f
tests/execscript f
tests/exec.right f
tests/exec1.sub f 755
braces.c
+6 -1
View File
@@ -420,7 +420,12 @@ mkseq (start, end, incr, type, width)
do
{
#if defined (SHELL)
QUIT; /* XXX - memory leak here */
if (ISINTERRUPT)
{
strvec_dispose (result);
result = (char **)NULL;
}
QUIT;
#endif
if (type == ST_INT)
result[i++] = t = itos (n);
builtins/complete.def
+1 -1
View File
@@ -654,7 +654,7 @@ print_cmd_completions (list)
$BUILTIN compgen
$DEPENDS_ON PROGRAMMABLE_COMPLETION
$FUNCTION compgen_builtin
$SHORT_DOC compgen [-abcdefgjksuv] [-o option] [-A action] [-G globpat] [-W wordlist] [-F function] [-C command] [-X filterpat] [-P prefix] [-S suffix] [word]
$SHORT_DOC compgen [-abcdefgjksuv] [-o option] [-A action] [-G globpat] [-W wordlist] [-F function] [-C command] [-X filterpat] [-P prefix] [-S suffix] [word]
Display possible completions depending on the options.
Intended to be used from within a shell function generating possible
builtins/declare.def
+13 -6
View File
@@ -289,7 +289,7 @@ declare_internal (list, local_var)
int offset, aflags, wflags;
#if defined (ARRAY_VARS)
int making_array_special, compound_array_assign, simple_array_assign;
int var_exists, array_exists, array_subscript_assignment;
int var_exists, array_exists, creating_array, array_subscript_assignment;
#endif
name = savestring (list->word->word);
@@ -351,7 +351,7 @@ declare_internal (list, local_var)
}
#if defined (ARRAY_VARS)
var_exists = array_exists = 0;
var_exists = array_exists = creating_array = 0;
compound_array_assign = simple_array_assign = 0;
array_subscript_assignment = 0;
subscript_start = (char *)NULL;
@@ -526,6 +526,7 @@ declare_internal (list, local_var)
#if defined (ARRAY_VARS)
var_exists = var != 0;
array_exists = var && (array_p (var) || assoc_p (var));
creating_array = flags_on & (att_array|att_assoc);
#endif
if (var == 0)
@@ -601,9 +602,9 @@ declare_internal (list, local_var)
#if defined (ARRAY_VARS)
/* make declare a[2]=foo as similar to a[2]=foo as possible if
a is already an array or assoc variable. */
if (array_subscript_assignment && array_exists && (flags_on & (att_array|att_assoc)) == 0)
if (array_subscript_assignment && array_exists && creating_array == 0)
simple_array_assign = 1;
else if ((making_array_special || (flags_on & (att_array|att_assoc)) || array_p (var) || assoc_p (var)) && offset)
else if ((making_array_special || creating_array || array_exists) && offset)
{
int vlen;
vlen = STRLEN (value);
@@ -611,8 +612,14 @@ declare_internal (list, local_var)
if (shell_compatibility_level > 43 && (wflags & W_COMPASSIGN) == 0 &&
value[0] == '(' && value[vlen-1] == ')')
{
internal_warning (_("%s: quoted compound array assignment deprecated"), list->word->word);
compound_array_assign = 1;
/* The warning is only printed when using compound assignment
to an array variable that doesn't already exist. We use
creating_array to allow things like
declare -a foo$bar='(abc)' to work. */
if (array_exists == 0 && creating_array == 0)
internal_warning (_("%s: quoted compound array assignment deprecated"), list->word->word);
compound_array_assign = array_exists || creating_array;
simple_array_assign = making_array_special;
}
else if (value[0] == '(' && value[vlen-1] == ')' && (shell_compatibility_level < 44 || (wflags & W_COMPASSIGN)))
compound_array_assign = 1;
builtins/help.def
+26 -14
View File
@@ -374,7 +374,7 @@ dispcolumn (i, buf, bufsize, width, height)
int width, height;
{
int j;
int displen;
int dispcols;
char *helpdoc;
/* first column */
@@ -391,9 +391,9 @@ dispcolumn (i, buf, bufsize, width, height)
return;
}
displen = strlen (buf);
dispcols = strlen (buf);
/* two spaces */
for (j = displen; j < width; j++)
for (j = dispcols; j < width; j++)
putc (' ', stdout);
/* second column */
@@ -416,7 +416,7 @@ wdispcolumn (i, buf, bufsize, width, height)
int width, height;
{
int j;
int displen;
int dispcols, dispchars;
char *helpdoc;
wchar_t *wcstr;
size_t slen, n;
@@ -446,13 +446,18 @@ wdispcolumn (i, buf, bufsize, width, height)
if (wcstr[j] == L'\n' || wcstr[j] == L'\t')
wcstr[j] = L' ';
displen = wcsnwidth (wcstr+1, slen, width - 2) + 1; /* +1 for ' ' or '*' */
/* dispchars == number of characters that will be displayed */
dispchars = wcsnwidth (wcstr+1, slen, width - 2);
/* dispcols == number of columns required to display DISPCHARS */
dispcols = wcswidth (wcstr+1, dispchars) + 1; /* +1 for ' ' or '*' */
wcstr[0] = (shell_builtins[i].flags & BUILTIN_ENABLED) ? L' ' : L'*';
/* This assumes each wide char takes up one column position when displayed */
wcstr[width - 2] = L'>'; /* indicate truncation */
wcstr[width - 1] = L'\0';
if (dispcols >= width-2)
{
wcstr[dispchars] = L'>'; /* indicate truncation */
wcstr[dispchars+1] = L'\0';
}
printf ("%ls", wcstr);
if (((i << 1) >= num_shell_builtins) || (i+height >= num_shell_builtins))
@@ -463,7 +468,7 @@ wdispcolumn (i, buf, bufsize, width, height)
}
/* at least one space */
for (j = displen; j < width; j++)
for (j = dispcols; j < width; j++)
putc (' ', stdout);
/* second column */
@@ -488,13 +493,20 @@ wdispcolumn (i, buf, bufsize, width, height)
if (wcstr[j] == L'\n' || wcstr[j] == L'\t')
wcstr[j] = L' ';
displen = wcsnwidth (wcstr+1, slen, width - 2);
/* dispchars == number of characters that will be displayed */
dispchars = wcsnwidth (wcstr+1, slen, width - 2);
dispcols = wcswidth (wcstr+1, dispchars) + 1; /* +1 for ' ' or '*' */
wcstr[0] = (shell_builtins[i+height].flags & BUILTIN_ENABLED) ? L' ' : L'*';
/* This assumes each wide char takes up one column position when displayed */
wcstr[width - 3] = L'>'; /* indicate truncation */
wcstr[width - 2] = L'\0';
/* The dispchars-1 is there for terminals that behave strangely when you
have \n in the nth column for terminal width n; this is what bash-4.3
did. */
if (dispcols >= width - 2)
{
wcstr[dispchars-1] = L'>'; /* indicate truncation */
wcstr[dispchars] = L'\0';
}
printf ("%ls\n", wcstr);
doc/bash.0
+243 -237
View File
@@ -221,7 +221,7 @@ DDEEFFIINNIITTIIOONNSS
mmeettaacchhaarraacctteerr
A character that, when unquoted, separates words. One of the
following:
|| && ;; (( )) << >> ssppaaccee ttaabb
|| && ;; (( )) << >> ssppaaccee ttaabb nneewwlliinnee
ccoonnttrrooll ooppeerraattoorr
A _t_o_k_e_n that performs a control function. It is one of the fol-
lowing symbols:
@@ -824,6 +824,10 @@ PPAARRAAMMEETTEERRSS
($${{BBAASSHH__SSOOUURRCCEE[[_$_i_+_1]]}}) where $${{FFUUNNCCNNAAMMEE[[_$_i]]}} was called (or
$${{BBAASSHH__LLIINNEENNOO[[_$_i_-_1]]}} if referenced within another shell func-
tion). Use LLIINNEENNOO to obtain the current line number.
BBAASSHH__LLOOAADDAABBLLEESS__PPAATTHH
A colon-separated list of directories in which the shell looks
for dynamically loadable builtins specified by the eennaabbllee com-
mand.
BBAASSHH__RREEMMAATTCCHH
An array variable whose members are assigned by the ==~~ binary
operator to the [[[[ conditional command. The element with index
@@ -915,9 +919,9 @@ PPAARRAAMMEETTEERRSS
is the name of any currently-executing shell function. The bot-
tom-most element (the one with the highest index) is "main".
This variable exists only when a shell function is executing.
Assignments to FFUUNNCCNNAAMMEE have no effect and return an error sta-
tus. If FFUUNNCCNNAAMMEE is unset, it loses its special properties,
even if it is subsequently reset.
Assignments to FFUUNNCCNNAAMMEE have no effect. If FFUUNNCCNNAAMMEE is unset,
it loses its special properties, even if it is subsequently
reset.
This variable can be used with BBAASSHH__LLIINNEENNOO and BBAASSHH__SSOOUURRCCEE.
Each element of FFUUNNCCNNAAMMEE has corresponding elements in
@@ -927,9 +931,9 @@ PPAARRAAMMEETTEERRSS
ccaalllleerr builtin displays the current call stack using this infor-
mation.
GGRROOUUPPSS An array variable containing the list of groups of which the
current user is a member. Assignments to GGRROOUUPPSS have no effect
and return an error status. If GGRROOUUPPSS is unset, it loses its
special properties, even if it is subsequently reset.
current user is a member. Assignments to GGRROOUUPPSS have no effect.
If GGRROOUUPPSS is unset, it loses its special properties, even if it
is subsequently reset.
HHIISSTTCCMMDD
The history number, or index in the history list, of the current
command. If HHIISSTTCCMMDD is unset, it loses its special properties,
@@ -3979,55 +3983,56 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
Unless otherwise noted, each builtin command documented in this section
as accepting options preceded by -- accepts ---- to signify the end of the
options. The ::, ttrruuee, ffaallssee, and tteesstt builtins do not accept options
and do not treat ---- specially. The eexxiitt, llooggoouutt, bbrreeaakk, ccoonnttiinnuuee, lleett,
and sshhiifftt builtins accept and process arguments beginning with -- with-
out requiring ----. Other builtins that accept arguments but are not
specified as accepting options interpret arguments beginning with -- as
invalid options and require ---- to prevent this interpretation.
and do not treat ---- specially. The eexxiitt, llooggoouutt, rreettuurrnn, bbrreeaakk, ccoonn--
ttiinnuuee, lleett, and sshhiifftt builtins accept and process arguments beginning
with -- without requiring ----. Other builtins that accept arguments but
are not specified as accepting options interpret arguments beginning
with -- as invalid options and require ---- to prevent this interpreta-
tion.
:: [_a_r_g_u_m_e_n_t_s]
No effect; the command does nothing beyond expanding _a_r_g_u_m_e_n_t_s
No effect; the command does nothing beyond expanding _a_r_g_u_m_e_n_t_s
and performing any specified redirections. The return status is
zero.
.. _f_i_l_e_n_a_m_e [_a_r_g_u_m_e_n_t_s]
ssoouurrccee _f_i_l_e_n_a_m_e [_a_r_g_u_m_e_n_t_s]
Read and execute commands from _f_i_l_e_n_a_m_e in the current shell
environment and return the exit status of the last command exe-
cuted from _f_i_l_e_n_a_m_e. If _f_i_l_e_n_a_m_e does not contain a slash,
filenames in PPAATTHH are used to find the directory containing
Read and execute commands from _f_i_l_e_n_a_m_e in the current shell
environment and return the exit status of the last command exe-
cuted from _f_i_l_e_n_a_m_e. If _f_i_l_e_n_a_m_e does not contain a slash,
filenames in PPAATTHH are used to find the directory containing
_f_i_l_e_n_a_m_e. The file searched for in PPAATTHH need not be executable.
When bbaasshh is not in _p_o_s_i_x _m_o_d_e, the current directory is
searched if no file is found in PPAATTHH. If the ssoouurrcceeppaatthh option
to the sshhoopptt builtin command is turned off, the PPAATTHH is not
searched. If any _a_r_g_u_m_e_n_t_s are supplied, they become the posi-
tional parameters when _f_i_l_e_n_a_m_e is executed. Otherwise the
positional parameters are unchanged. If the --TT option is
enabled, ssoouurrccee inherits any trap on DDEEBBUUGG; if it is not, any
DDEEBBUUGG trap string is saved and restored around the call to
ssoouurrccee, and ssoouurrccee unsets the DDEEBBUUGG trap while it executes. If
--TT is not set, and the sourced file changes the DDEEBBUUGG trap, the
new value is retained when ssoouurrccee completes. The return status
When bbaasshh is not in _p_o_s_i_x _m_o_d_e, the current directory is
searched if no file is found in PPAATTHH. If the ssoouurrcceeppaatthh option
to the sshhoopptt builtin command is turned off, the PPAATTHH is not
searched. If any _a_r_g_u_m_e_n_t_s are supplied, they become the posi-
tional parameters when _f_i_l_e_n_a_m_e is executed. Otherwise the
positional parameters are unchanged. If the --TT option is
enabled, ssoouurrccee inherits any trap on DDEEBBUUGG; if it is not, any
DDEEBBUUGG trap string is saved and restored around the call to
ssoouurrccee, and ssoouurrccee unsets the DDEEBBUUGG trap while it executes. If
--TT is not set, and the sourced file changes the DDEEBBUUGG trap, the
new value is retained when ssoouurrccee completes. The return status
is the status of the last command exited within the script (0 if
no commands are executed), and false if _f_i_l_e_n_a_m_e is not found or
cannot be read.
aalliiaass [--pp] [_n_a_m_e[=_v_a_l_u_e] ...]
AAlliiaass with no arguments or with the --pp option prints the list of
aliases in the form aalliiaass _n_a_m_e=_v_a_l_u_e on standard output. When
arguments are supplied, an alias is defined for each _n_a_m_e whose
_v_a_l_u_e is given. A trailing space in _v_a_l_u_e causes the next word
aliases in the form aalliiaass _n_a_m_e=_v_a_l_u_e on standard output. When
arguments are supplied, an alias is defined for each _n_a_m_e whose
_v_a_l_u_e is given. A trailing space in _v_a_l_u_e causes the next word
to be checked for alias substitution when the alias is expanded.
For each _n_a_m_e in the argument list for which no _v_a_l_u_e is sup-
plied, the name and value of the alias is printed. AAlliiaass
returns true unless a _n_a_m_e is given for which no alias has been
For each _n_a_m_e in the argument list for which no _v_a_l_u_e is sup-
plied, the name and value of the alias is printed. AAlliiaass
returns true unless a _n_a_m_e is given for which no alias has been
defined.
bbgg [_j_o_b_s_p_e_c ...]
Resume each suspended job _j_o_b_s_p_e_c in the background, as if it
Resume each suspended job _j_o_b_s_p_e_c in the background, as if it
had been started with &&. If _j_o_b_s_p_e_c is not present, the shell's
notion of the _c_u_r_r_e_n_t _j_o_b is used. bbgg _j_o_b_s_p_e_c returns 0 unless
run when job control is disabled or, when run with job control
enabled, any specified _j_o_b_s_p_e_c was not found or was started
notion of the _c_u_r_r_e_n_t _j_o_b is used. bbgg _j_o_b_s_p_e_c returns 0 unless
run when job control is disabled or, when run with job control
enabled, any specified _j_o_b_s_p_e_c was not found or was started
without job control.
bbiinndd [--mm _k_e_y_m_a_p] [--llppssvvPPSSVVXX]
@@ -4036,28 +4041,28 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
bbiinndd [--mm _k_e_y_m_a_p] --xx _k_e_y_s_e_q:_s_h_e_l_l_-_c_o_m_m_a_n_d
bbiinndd [--mm _k_e_y_m_a_p] _k_e_y_s_e_q:_f_u_n_c_t_i_o_n_-_n_a_m_e
bbiinndd [--mm _k_e_y_m_a_p] _k_e_y_s_e_q:_r_e_a_d_l_i_n_e_-_c_o_m_m_a_n_d
Display current rreeaaddlliinnee key and function bindings, bind a key
sequence to a rreeaaddlliinnee function or macro, or set a rreeaaddlliinnee
variable. Each non-option argument is a command as it would
appear in _._i_n_p_u_t_r_c, but each binding or command must be passed
as a separate argument; e.g., '"\C-x\C-r": re-read-init-file'.
Display current rreeaaddlliinnee key and function bindings, bind a key
sequence to a rreeaaddlliinnee function or macro, or set a rreeaaddlliinnee
variable. Each non-option argument is a command as it would
appear in _._i_n_p_u_t_r_c, but each binding or command must be passed
as a separate argument; e.g., '"\C-x\C-r": re-read-init-file'.
Options, if supplied, have the following meanings:
--mm _k_e_y_m_a_p
Use _k_e_y_m_a_p as the keymap to be affected by the subsequent
bindings. Acceptable _k_e_y_m_a_p names are _e_m_a_c_s_, _e_m_a_c_s_-_s_t_a_n_-
_d_a_r_d_, _e_m_a_c_s_-_m_e_t_a_, _e_m_a_c_s_-_c_t_l_x_, _v_i_, _v_i_-_m_o_v_e_, _v_i_-_c_o_m_m_a_n_d,
and _v_i_-_i_n_s_e_r_t. _v_i is equivalent to _v_i_-_c_o_m_m_a_n_d; _e_m_a_c_s is
_d_a_r_d_, _e_m_a_c_s_-_m_e_t_a_, _e_m_a_c_s_-_c_t_l_x_, _v_i_, _v_i_-_m_o_v_e_, _v_i_-_c_o_m_m_a_n_d,
and _v_i_-_i_n_s_e_r_t. _v_i is equivalent to _v_i_-_c_o_m_m_a_n_d; _e_m_a_c_s is
equivalent to _e_m_a_c_s_-_s_t_a_n_d_a_r_d.
--ll List the names of all rreeaaddlliinnee functions.
--pp Display rreeaaddlliinnee function names and bindings in such a
--pp Display rreeaaddlliinnee function names and bindings in such a
way that they can be re-read.
--PP List current rreeaaddlliinnee function names and bindings.
--ss Display rreeaaddlliinnee key sequences bound to macros and the
strings they output in such a way that they can be re-
--ss Display rreeaaddlliinnee key sequences bound to macros and the
strings they output in such a way that they can be re-
read.
--SS Display rreeaaddlliinnee key sequences bound to macros and the
--SS Display rreeaaddlliinnee key sequences bound to macros and the
strings they output.
--vv Display rreeaaddlliinnee variable names and values in such a way
--vv Display rreeaaddlliinnee variable names and values in such a way
that they can be re-read.
--VV List current rreeaaddlliinnee variable names and values.
--ff _f_i_l_e_n_a_m_e
@@ -4069,174 +4074,174 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
--rr _k_e_y_s_e_q
Remove any current binding for _k_e_y_s_e_q.
--xx _k_e_y_s_e_q::_s_h_e_l_l_-_c_o_m_m_a_n_d
Cause _s_h_e_l_l_-_c_o_m_m_a_n_d to be executed whenever _k_e_y_s_e_q is
entered. When _s_h_e_l_l_-_c_o_m_m_a_n_d is executed, the shell sets
the RREEAADDLLIINNEE__LLIINNEE variable to the contents of the rreeaadd--
lliinnee line buffer and the RREEAADDLLIINNEE__PPOOIINNTT variable to the
Cause _s_h_e_l_l_-_c_o_m_m_a_n_d to be executed whenever _k_e_y_s_e_q is
entered. When _s_h_e_l_l_-_c_o_m_m_a_n_d is executed, the shell sets
the RREEAADDLLIINNEE__LLIINNEE variable to the contents of the rreeaadd--
lliinnee line buffer and the RREEAADDLLIINNEE__PPOOIINNTT variable to the
current location of the insertion point. If the executed
command changes the value of RREEAADDLLIINNEE__LLIINNEE or RREEAADD--
LLIINNEE__PPOOIINNTT, those new values will be reflected in the
command changes the value of RREEAADDLLIINNEE__LLIINNEE or RREEAADD--
LLIINNEE__PPOOIINNTT, those new values will be reflected in the
editing state.
--XX List all key sequences bound to shell commands and the
associated commands in a format that can be reused as
--XX List all key sequences bound to shell commands and the
associated commands in a format that can be reused as
input.
The return value is 0 unless an unrecognized option is given or
The return value is 0 unless an unrecognized option is given or
an error occurred.
bbrreeaakk [_n]
Exit from within a ffoorr, wwhhiillee, uunnttiill, or sseelleecctt loop. If _n is
specified, break _n levels. _n must be >= 1. If _n is greater
than the number of enclosing loops, all enclosing loops are
exited. The return value is 0 unless _n is not greater than or
Exit from within a ffoorr, wwhhiillee, uunnttiill, or sseelleecctt loop. If _n is
specified, break _n levels. _n must be >= 1. If _n is greater
than the number of enclosing loops, all enclosing loops are
exited. The return value is 0 unless _n is not greater than or
equal to 1.
bbuuiillttiinn _s_h_e_l_l_-_b_u_i_l_t_i_n [_a_r_g_u_m_e_n_t_s]
Execute the specified shell builtin, passing it _a_r_g_u_m_e_n_t_s, and
Execute the specified shell builtin, passing it _a_r_g_u_m_e_n_t_s, and
return its exit status. This is useful when defining a function
whose name is the same as a shell builtin, retaining the func-
whose name is the same as a shell builtin, retaining the func-
tionality of the builtin within the function. The ccdd builtin is
commonly redefined this way. The return status is false if
commonly redefined this way. The return status is false if
_s_h_e_l_l_-_b_u_i_l_t_i_n is not a shell builtin command.
ccaalllleerr [_e_x_p_r]
Returns the context of any active subroutine call (a shell func-
tion or a script executed with the .. or ssoouurrccee builtins). With-
out _e_x_p_r, ccaalllleerr displays the line number and source filename of
the current subroutine call. If a non-negative integer is sup-
the current subroutine call. If a non-negative integer is sup-
plied as _e_x_p_r, ccaalllleerr displays the line number, subroutine name,
and source file corresponding to that position in the current
execution call stack. This extra information may be used, for
example, to print a stack trace. The current frame is frame 0.
The return value is 0 unless the shell is not executing a sub-
routine call or _e_x_p_r does not correspond to a valid position in
and source file corresponding to that position in the current
execution call stack. This extra information may be used, for
example, to print a stack trace. The current frame is frame 0.
The return value is 0 unless the shell is not executing a sub-
routine call or _e_x_p_r does not correspond to a valid position in
the call stack.
ccdd [--LL|[--PP [--ee]] [-@]] [_d_i_r]
Change the current directory to _d_i_r. if _d_i_r is not supplied,
the value of the HHOOMMEE shell variable is the default. Any addi-
Change the current directory to _d_i_r. if _d_i_r is not supplied,
the value of the HHOOMMEE shell variable is the default. Any addi-
tional arguments following _d_i_r are ignored. The variable CCDDPPAATTHH
defines the search path for the directory containing _d_i_r: each
directory name in CCDDPPAATTHH is searched for _d_i_r. Alternative
directory names in CCDDPPAATTHH are separated by a colon (:). A null
directory name in CCDDPPAATTHH is the same as the current directory,
defines the search path for the directory containing _d_i_r: each
directory name in CCDDPPAATTHH is searched for _d_i_r. Alternative
directory names in CCDDPPAATTHH are separated by a colon (:). A null
directory name in CCDDPPAATTHH is the same as the current directory,
i.e., ``..''. If _d_i_r begins with a slash (/), then CCDDPPAATTHH is not
used. The --PP option causes ccdd to use the physical directory
structure by resolving symbolic links while traversing _d_i_r and
used. The --PP option causes ccdd to use the physical directory
structure by resolving symbolic links while traversing _d_i_r and
before processing instances of _._. in _d_i_r (see also the --PP option
to the sseett builtin command); the --LL option forces symbolic links
to be followed by resolving the link after processing instances
to be followed by resolving the link after processing instances
of _._. in _d_i_r. If _._. appears in _d_i_r, it is processed by removing
the immediately previous pathname component from _d_i_r, back to a
slash or the beginning of _d_i_r. If the --ee option is supplied
with --PP, and the current working directory cannot be success-
fully determined after a successful directory change, ccdd will
return an unsuccessful status. On systems that support it, the
--@@ option presents the extended attributes associated with a
file as a directory. An argument of -- is converted to $$OOLLDDPPWWDD
the immediately previous pathname component from _d_i_r, back to a
slash or the beginning of _d_i_r. If the --ee option is supplied
with --PP, and the current working directory cannot be success-
fully determined after a successful directory change, ccdd will
return an unsuccessful status. On systems that support it, the
--@@ option presents the extended attributes associated with a
file as a directory. An argument of -- is converted to $$OOLLDDPPWWDD
before the directory change is attempted. If a non-empty direc-
tory name from CCDDPPAATTHH is used, or if -- is the first argument,
tory name from CCDDPPAATTHH is used, or if -- is the first argument,
and the directory change is successful, the absolute pathname of
the new working directory is written to the standard output.
The return value is true if the directory was successfully
the new working directory is written to the standard output.
The return value is true if the directory was successfully
changed; false otherwise.
ccoommmmaanndd [--ppVVvv] _c_o_m_m_a_n_d [_a_r_g ...]
Run _c_o_m_m_a_n_d with _a_r_g_s suppressing the normal shell function
Run _c_o_m_m_a_n_d with _a_r_g_s suppressing the normal shell function
lookup. Only builtin commands or commands found in the PPAATTHH are
executed. If the --pp option is given, the search for _c_o_m_m_a_n_d is
performed using a default value for PPAATTHH that is guaranteed to
find all of the standard utilities. If either the --VV or --vv
executed. If the --pp option is given, the search for _c_o_m_m_a_n_d is
performed using a default value for PPAATTHH that is guaranteed to
find all of the standard utilities. If either the --VV or --vv
option is supplied, a description of _c_o_m_m_a_n_d is printed. The --vv
option causes a single word indicating the command or filename
option causes a single word indicating the command or filename
used to invoke _c_o_m_m_a_n_d to be displayed; the --VV option produces a
more verbose description. If the --VV or --vv option is supplied,
the exit status is 0 if _c_o_m_m_a_n_d was found, and 1 if not. If
more verbose description. If the --VV or --vv option is supplied,
the exit status is 0 if _c_o_m_m_a_n_d was found, and 1 if not. If
neither option is supplied and an error occurred or _c_o_m_m_a_n_d can-
not be found, the exit status is 127. Otherwise, the exit sta-
not be found, the exit status is 127. Otherwise, the exit sta-
tus of the ccoommmmaanndd builtin is the exit status of _c_o_m_m_a_n_d.
ccoommppggeenn [_o_p_t_i_o_n] [_w_o_r_d]
Generate possible completion matches for _w_o_r_d according to the
_o_p_t_i_o_ns, which may be any option accepted by the ccoommpplleettee
builtin with the exception of --pp and --rr, and write the matches
to the standard output. When using the --FF or --CC options, the
various shell variables set by the programmable completion
Generate possible completion matches for _w_o_r_d according to the
_o_p_t_i_o_ns, which may be any option accepted by the ccoommpplleettee
builtin with the exception of --pp and --rr, and write the matches
to the standard output. When using the --FF or --CC options, the
various shell variables set by the programmable completion
facilities, while available, will not have useful values.
The matches will be generated in the same way as if the program-
mable completion code had generated them directly from a comple-
tion specification with the same flags. If _w_o_r_d is specified,
tion specification with the same flags. If _w_o_r_d is specified,
only those completions matching _w_o_r_d will be displayed.
The return value is true unless an invalid option is supplied,
The return value is true unless an invalid option is supplied,
or no matches were generated.
ccoommpplleettee [--aabbccddeeffggjjkkssuuvv] [--oo _c_o_m_p_-_o_p_t_i_o_n] [--DDEE] [--AA _a_c_t_i_o_n] [--GG _g_l_o_b_-
ccoommpplleettee [--aabbccddeeffggjjkkssuuvv] [--oo _c_o_m_p_-_o_p_t_i_o_n] [--DDEE] [--AA _a_c_t_i_o_n] [--GG _g_l_o_b_-
_p_a_t] [--WW _w_o_r_d_l_i_s_t] [--FF _f_u_n_c_t_i_o_n] [--CC _c_o_m_m_a_n_d]
[--XX _f_i_l_t_e_r_p_a_t] [--PP _p_r_e_f_i_x] [--SS _s_u_f_f_i_x] _n_a_m_e [_n_a_m_e _._._.]
ccoommpplleettee --pprr [--DDEE] [_n_a_m_e ...]
Specify how arguments to each _n_a_m_e should be completed. If the
--pp option is supplied, or if no options are supplied, existing
completion specifications are printed in a way that allows them
Specify how arguments to each _n_a_m_e should be completed. If the
--pp option is supplied, or if no options are supplied, existing
completion specifications are printed in a way that allows them
to be reused as input. The --rr option removes a completion spec-
ification for each _n_a_m_e, or, if no _n_a_m_es are supplied, all com-
ification for each _n_a_m_e, or, if no _n_a_m_es are supplied, all com-
pletion specifications. The --DD option indicates that the
remaining options and actions should apply to the ``default''
command completion; that is, completion attempted on a command
for which no completion has previously been defined. The --EE
option indicates that the remaining options and actions should
apply to ``empty'' command completion; that is, completion
remaining options and actions should apply to the ``default''
command completion; that is, completion attempted on a command
for which no completion has previously been defined. The --EE
option indicates that the remaining options and actions should
apply to ``empty'' command completion; that is, completion
attempted on a blank line.
The process of applying these completion specifications when
word completion is attempted is described above under PPrrooggrraamm--
The process of applying these completion specifications when
word completion is attempted is described above under PPrrooggrraamm--
mmaabbllee CCoommpplleettiioonn.
Other options, if specified, have the following meanings. The
arguments to the --GG, --WW, and --XX options (and, if necessary, the
--PP and --SS options) should be quoted to protect them from expan-
Other options, if specified, have the following meanings. The
arguments to the --GG, --WW, and --XX options (and, if necessary, the
--PP and --SS options) should be quoted to protect them from expan-
sion before the ccoommpplleettee builtin is invoked.
--oo _c_o_m_p_-_o_p_t_i_o_n
The _c_o_m_p_-_o_p_t_i_o_n controls several aspects of the comp-
spec's behavior beyond the simple generation of comple-
The _c_o_m_p_-_o_p_t_i_o_n controls several aspects of the comp-
spec's behavior beyond the simple generation of comple-
tions. _c_o_m_p_-_o_p_t_i_o_n may be one of:
bbaasshhddeeffaauulltt
Perform the rest of the default bbaasshh completions
if the compspec generates no matches.
ddeeffaauulltt Use readline's default filename completion if
ddeeffaauulltt Use readline's default filename completion if
the compspec generates no matches.
ddiirrnnaammeess
Perform directory name completion if the comp-
Perform directory name completion if the comp-
spec generates no matches.
ffiilleennaammeess
Tell readline that the compspec generates file-
names, so it can perform any filename-specific
processing (like adding a slash to directory
names, quoting special characters, or suppress-
ing trailing spaces). Intended to be used with
Tell readline that the compspec generates file-
names, so it can perform any filename-specific
processing (like adding a slash to directory
names, quoting special characters, or suppress-
ing trailing spaces). Intended to be used with
shell functions.
nnooqquuoottee Tell readline not to quote the completed words
if they are filenames (quoting filenames is the
nnooqquuoottee Tell readline not to quote the completed words
if they are filenames (quoting filenames is the
default).
nnoossoorrtt Tell readline not to sort the list of possible
nnoossoorrtt Tell readline not to sort the list of possible
completions alphabetically.
nnoossppaaccee Tell readline not to append a space (the
default) to words completed at the end of the
nnoossppaaccee Tell readline not to append a space (the
default) to words completed at the end of the
line.
pplluussddiirrss
After any matches defined by the compspec are
generated, directory name completion is
attempted and any matches are added to the
After any matches defined by the compspec are
generated, directory name completion is
attempted and any matches are added to the
results of the other actions.
--AA _a_c_t_i_o_n
The _a_c_t_i_o_n may be one of the following to generate a
The _a_c_t_i_o_n may be one of the following to generate a
list of possible completions:
aalliiaass Alias names. May also be specified as --aa.
aarrrraayyvvaarr
Array variable names.
bbiinnddiinngg RReeaaddlliinnee key binding names.
bbuuiillttiinn Names of shell builtin commands. May also be
bbuuiillttiinn Names of shell builtin commands. May also be
specified as --bb.
ccoommmmaanndd Command names. May also be specified as --cc.
ddiirreeccttoorryy
@@ -4244,7 +4249,7 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
ddiissaabblleedd
Names of disabled shell builtins.
eennaabblleedd Names of enabled shell builtins.
eexxppoorrtt Names of exported shell variables. May also be
eexxppoorrtt Names of exported shell variables. May also be
specified as --ee.
ffiillee File names. May also be specified as --ff.
ffuunnccttiioonn
@@ -4253,17 +4258,17 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
hheellppttooppiicc
Help topics as accepted by the hheellpp builtin.
hhoossttnnaammee
Hostnames, as taken from the file specified by
Hostnames, as taken from the file specified by
the HHOOSSTTFFIILLEE shell variable.
jjoobb Job names, if job control is active. May also
jjoobb Job names, if job control is active. May also
be specified as --jj.
kkeeyywwoorrdd Shell reserved words. May also be specified as
kkeeyywwoorrdd Shell reserved words. May also be specified as
--kk.
rruunnnniinngg Names of running jobs, if job control is active.
sseerrvviiccee Service names. May also be specified as --ss.
sseettoopptt Valid arguments for the --oo option to the sseett
sseettoopptt Valid arguments for the --oo option to the sseett
builtin.
sshhoopptt Shell option names as accepted by the sshhoopptt
sshhoopptt Shell option names as accepted by the sshhoopptt
builtin.
ssiiggnnaall Signal names.
ssttooppppeedd Names of stopped jobs, if job control is active.
@@ -4272,148 +4277,149 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
Names of all shell variables. May also be spec-
ified as --vv.
--CC _c_o_m_m_a_n_d
_c_o_m_m_a_n_d is executed in a subshell environment, and its
_c_o_m_m_a_n_d is executed in a subshell environment, and its
output is used as the possible completions.
--FF _f_u_n_c_t_i_o_n
The shell function _f_u_n_c_t_i_o_n is executed in the current
shell environment. When the function is executed, the
first argument ($$11) is the name of the command whose
arguments are being completed, the second argument ($$22)
The shell function _f_u_n_c_t_i_o_n is executed in the current
shell environment. When the function is executed, the
first argument ($$11) is the name of the command whose
arguments are being completed, the second argument ($$22)
is the word being completed, and the third argument ($$33)
is the word preceding the word being completed on the
current command line. When it finishes, the possible
completions are retrieved from the value of the CCOOMMPPRREE--
is the word preceding the word being completed on the
current command line. When it finishes, the possible
completions are retrieved from the value of the CCOOMMPPRREE--
PPLLYY array variable.
--GG _g_l_o_b_p_a_t
The pathname expansion pattern _g_l_o_b_p_a_t is expanded to
The pathname expansion pattern _g_l_o_b_p_a_t is expanded to
generate the possible completions.
--PP _p_r_e_f_i_x
_p_r_e_f_i_x is added at the beginning of each possible com-
_p_r_e_f_i_x is added at the beginning of each possible com-
pletion after all other options have been applied.
--SS _s_u_f_f_i_x
_s_u_f_f_i_x is appended to each possible completion after all
other options have been applied.
--WW _w_o_r_d_l_i_s_t
The _w_o_r_d_l_i_s_t is split using the characters in the IIFFSS
special variable as delimiters, and each resultant word
is expanded. The possible completions are the members
of the resultant list which match the word being com-
The _w_o_r_d_l_i_s_t is split using the characters in the IIFFSS
special variable as delimiters, and each resultant word
is expanded. The possible completions are the members
of the resultant list which match the word being com-
pleted.
--XX _f_i_l_t_e_r_p_a_t
_f_i_l_t_e_r_p_a_t is a pattern as used for pathname expansion.
_f_i_l_t_e_r_p_a_t is a pattern as used for pathname expansion.
It is applied to the list of possible completions gener-
ated by the preceding options and arguments, and each
completion matching _f_i_l_t_e_r_p_a_t is removed from the list.
A leading !! in _f_i_l_t_e_r_p_a_t negates the pattern; in this
ated by the preceding options and arguments, and each
completion matching _f_i_l_t_e_r_p_a_t is removed from the list.
A leading !! in _f_i_l_t_e_r_p_a_t negates the pattern; in this
case, any completion not matching _f_i_l_t_e_r_p_a_t is removed.
The return value is true unless an invalid option is supplied,
an option other than --pp or --rr is supplied without a _n_a_m_e argu-
ment, an attempt is made to remove a completion specification
The return value is true unless an invalid option is supplied,
an option other than --pp or --rr is supplied without a _n_a_m_e argu-
ment, an attempt is made to remove a completion specification
for a _n_a_m_e for which no specification exists, or an error occurs
adding a completion specification.
ccoommppoopptt [--oo _o_p_t_i_o_n] [--DDEE] [++oo _o_p_t_i_o_n] [_n_a_m_e]
Modify completion options for each _n_a_m_e according to the
_o_p_t_i_o_ns, or for the currently-executing completion if no _n_a_m_es
are supplied. If no _o_p_t_i_o_ns are given, display the completion
options for each _n_a_m_e or the current completion. The possible
values of _o_p_t_i_o_n are those valid for the ccoommpplleettee builtin
described above. The --DD option indicates that the remaining
_o_p_t_i_o_ns, or for the currently-executing completion if no _n_a_m_es
are supplied. If no _o_p_t_i_o_ns are given, display the completion
options for each _n_a_m_e or the current completion. The possible
values of _o_p_t_i_o_n are those valid for the ccoommpplleettee builtin
described above. The --DD option indicates that the remaining
options should apply to the ``default'' command completion; that
is, completion attempted on a command for which no completion
has previously been defined. The --EE option indicates that the
remaining options should apply to ``empty'' command completion;
is, completion attempted on a command for which no completion
has previously been defined. The --EE option indicates that the
remaining options should apply to ``empty'' command completion;
that is, completion attempted on a blank line.
The return value is true unless an invalid option is supplied,
The return value is true unless an invalid option is supplied,
an attempt is made to modify the options for a _n_a_m_e for which no
completion specification exists, or an output error occurs.
ccoonnttiinnuuee [_n]
Resume the next iteration of the enclosing ffoorr, wwhhiillee, uunnttiill, or
sseelleecctt loop. If _n is specified, resume at the _nth enclosing
loop. _n must be >= 1. If _n is greater than the number of
enclosing loops, the last enclosing loop (the ``top-level''
sseelleecctt loop. If _n is specified, resume at the _nth enclosing
loop. _n must be >= 1. If _n is greater than the number of
enclosing loops, the last enclosing loop (the ``top-level''
loop) is resumed. The return value is 0 unless _n is not greater
than or equal to 1.
ddeeccllaarree [--aaAAffFFggiillnnrrttuuxx] [--pp] [_n_a_m_e[=_v_a_l_u_e] ...]
ttyyppeesseett [--aaAAffFFggiillnnrrttuuxx] [--pp] [_n_a_m_e[=_v_a_l_u_e] ...]
Declare variables and/or give them attributes. If no _n_a_m_es are
given then display the values of variables. The --pp option will
Declare variables and/or give them attributes. If no _n_a_m_es are
given then display the values of variables. The --pp option will
display the attributes and values of each _n_a_m_e. When --pp is used
with _n_a_m_e arguments, additional options, other than --ff and --FF,
are ignored. When --pp is supplied without _n_a_m_e arguments, it
will display the attributes and values of all variables having
with _n_a_m_e arguments, additional options, other than --ff and --FF,
are ignored. When --pp is supplied without _n_a_m_e arguments, it
will display the attributes and values of all variables having
the attributes specified by the additional options. If no other
options are supplied with --pp, ddeeccllaarree will display the
attributes and values of all shell variables. The --ff option
will restrict the display to shell functions. The --FF option
inhibits the display of function definitions; only the function
name and attributes are printed. If the eexxttddeebbuugg shell option
is enabled using sshhoopptt, the source file name and line number
where the function is defined are displayed as well. The --FF
option implies --ff. The --gg option forces variables to be created
or modified at the global scope, even when ddeeccllaarree is executed
in a shell function. It is ignored in all other cases. The
following options can be used to restrict output to variables
with the specified attribute or to give variables attributes:
--aa Each _n_a_m_e is an indexed array variable (see AArrrraayyss
options are supplied with --pp, ddeeccllaarree will display the
attributes and values of all shell variables. The --ff option
will restrict the display to shell functions. The --FF option
inhibits the display of function definitions; only the function
name and attributes are printed. If the eexxttddeebbuugg shell option
is enabled using sshhoopptt, the source file name and line number
where each _n_a_m_e is defined are displayed as well. The --FF option
implies --ff. The --gg option forces variables to be created or
modified at the global scope, even when ddeeccllaarree is executed in a
shell function. It is ignored in all other cases. The follow-
ing options can be used to restrict output to variables with the
specified attribute or to give variables attributes:
--aa Each _n_a_m_e is an indexed array variable (see AArrrraayyss
above).
--AA Each _n_a_m_e is an associative array variable (see AArrrraayyss
--AA Each _n_a_m_e is an associative array variable (see AArrrraayyss
above).
--ff Use function names only.
--ii The variable is treated as an integer; arithmetic evalua-
tion (see AARRIITTHHMMEETTIICC EEVVAALLUUAATTIIOONN above) is performed when
tion (see AARRIITTHHMMEETTIICC EEVVAALLUUAATTIIOONN above) is performed when
the variable is assigned a value.
--ll When the variable is assigned a value, all upper-case
characters are converted to lower-case. The upper-case
--ll When the variable is assigned a value, all upper-case
characters are converted to lower-case. The upper-case
attribute is disabled.
--nn Give each _n_a_m_e the _n_a_m_e_r_e_f attribute, making it a name
reference to another variable. That other variable is
defined by the value of _n_a_m_e. All references, assign-
ments, and attribute modifications to _n_a_m_e, except for
changing the --nn attribute itself, are performed on the
variable referenced by _n_a_m_e's value. The nameref
--nn Give each _n_a_m_e the _n_a_m_e_r_e_f attribute, making it a name
reference to another variable. That other variable is
defined by the value of _n_a_m_e. All references, assign-
ments, and attribute modifications to _n_a_m_e, except for
changing the --nn attribute itself, are performed on the
variable referenced by _n_a_m_e's value. The nameref
attribute cannot be applied to array variables.
--rr Make _n_a_m_es readonly. These names cannot then be assigned
values by subsequent assignment statements or unset.
--tt Give each _n_a_m_e the _t_r_a_c_e attribute. Traced functions
inherit the DDEEBBUUGG and RREETTUURRNN traps from the calling
shell. The trace attribute has no special meaning for
--tt Give each _n_a_m_e the _t_r_a_c_e attribute. Traced functions
inherit the DDEEBBUUGG and RREETTUURRNN traps from the calling
shell. The trace attribute has no special meaning for
variables.
--uu When the variable is assigned a value, all lower-case
characters are converted to upper-case. The lower-case
--uu When the variable is assigned a value, all lower-case
characters are converted to upper-case. The lower-case
attribute is disabled.
--xx Mark _n_a_m_es for export to subsequent commands via the
--xx Mark _n_a_m_es for export to subsequent commands via the
environment.
Using `+' instead of `-' turns off the attribute instead, with
Using `+' instead of `-' turns off the attribute instead, with
the exceptions that ++aa may not be used to destroy an array vari-
able and ++rr will not remove the readonly attribute. When used
able and ++rr will not remove the readonly attribute. When used
in a function, ddeeccllaarree and ttyyppeesseett make each _n_a_m_e local, as with
the llooccaall command, unless the --gg option is supplied. If a vari-
able name is followed by =_v_a_l_u_e, the value of the variable is
set to _v_a_l_u_e. When using --aa or --AA and the compound assignment
syntax to create array variables, additional attributes do not
able name is followed by =_v_a_l_u_e, the value of the variable is
set to _v_a_l_u_e. When using --aa or --AA and the compound assignment
syntax to create array variables, additional attributes do not
take effect until subsequent assignments. The return value is 0
unless an invalid option is encountered, an attempt is made to
define a function using ``-f foo=bar'', an attempt is made to
assign a value to a readonly variable, an attempt is made to
assign a value to an array variable without using the compound
assignment syntax (see AArrrraayyss above), one of the _n_a_m_e_s is not a
valid shell variable name, an attempt is made to turn off read-
only status for a readonly variable, an attempt is made to turn
unless an invalid option is encountered, an attempt is made to
define a function using ``-f foo=bar'', an attempt is made to
assign a value to a readonly variable, an attempt is made to
assign a value to an array variable without using the compound
assignment syntax (see AArrrraayyss above), one of the _n_a_m_e_s is not a
valid shell variable name, an attempt is made to turn off read-
only status for a readonly variable, an attempt is made to turn
off array status for an array variable, or an attempt is made to
display a non-existent function with --ff.
ddiirrss [[--ccllppvv]] [[++_n]] [[--_n]]
Without options, displays the list of currently remembered
directories. The default display is on a single line with
directory names separated by spaces. Directories are added to
the list with the ppuusshhdd command; the ppooppdd command removes
entries from the list.
Without options, displays the list of currently remembered
directories. The default display is on a single line with
directory names separated by spaces. Directories are added to
the list with the ppuusshhdd command; the ppooppdd command removes
entries from the list. The current directory is always the
first directory in the stack.
--cc Clears the directory stack by deleting all of the
entries.
--ll Produces a listing using full pathnames; the default
@@ -4867,12 +4873,12 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
ppuusshhdd [--nn] [_d_i_r]
Adds a directory to the top of the directory stack, or rotates
the stack, making the new top of the stack the current working
directory. With no arguments, exchanges the top two directories
and returns 0, unless the directory stack is empty. Arguments,
if supplied, have the following meanings:
--nn Suppresses the normal change of directory when adding
directories to the stack, so that only the stack is
manipulated.
directory. With no arguments, ppuusshhdd exchanges the top two
directories and returns 0, unless the directory stack is empty.
Arguments, if supplied, have the following meanings:
--nn Suppresses the normal change of directory when rotating
or adding directories to the stack, so that only the
stack is manipulated.
++_n Rotates the stack so that the _nth directory (counting
from the left of the list shown by ddiirrss, starting with
zero) is at the top.
@@ -5848,4 +5854,4 @@ BBUUGGSS
GNU Bash 4.4 2015 June 11 BASH(1)
GNU Bash 4.4 2015 August 15 BASH(1)
doc/bash.1
+1
View File
@@ -7706,6 +7706,7 @@ Directories are added to the list with the
command; the
.B popd
command removes entries from the list.
The current directory is always the first directory in the stack.
.RS
.PD 0
.TP
doc/bash.html
+22 -12
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2015 June 11<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2015 August 15<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -622,7 +622,7 @@ A character that, when unquoted, separates words. One of the following:
<DL COMPACT><DT><DD>
<P>
<B>| &amp; ; ( ) &lt; &gt; space tab</B>
<B>| &amp; ; ( ) &lt; &gt; space tab newline</B>
</DL>
@@ -1950,6 +1950,14 @@ Use
</FONT>
to obtain the current line number.
<DT><B>BASH_LOADABLES_PATH</B>
<DD>
A colon-separated list of directories in which the shell looks for
dynamically loadable builtins specified by the
<B>enable</B>
command.
<DT><B>BASH_REMATCH</B>
<DD>
@@ -2148,7 +2156,7 @@ Assignments to
<FONT SIZE=-1><B>FUNCNAME</B>
</FONT>
have no effect and return an error status.
have no effect.
If
<FONT SIZE=-1><B>FUNCNAME</B>
@@ -2175,7 +2183,7 @@ Assignments to
<FONT SIZE=-1><B>GROUPS</B>
</FONT>
have no effect and return an error status.
have no effect.
If
<FONT SIZE=-1><B>GROUPS</B>
@@ -8919,7 +8927,8 @@ accepts
to signify the end of the options.
The <B>:</B>, <B>true</B>, <B>false</B>, and <B>test</B> builtins
do not accept options and do not treat <B>--</B> specially.
The <B>exit</B>, <B>logout</B>, <B>break</B>, <B>continue</B>, <B>let</B>,
The <B>exit</B>, <B>logout</B>, <B>return</B>,
<B>break</B>, <B>continue</B>, <B>let</B>,
and <B>shift</B> builtins accept and process arguments beginning with
<B>-</B> without requiring <B>--</B>.
Other builtins that accept arguments but are not specified as accepting
@@ -9679,8 +9688,8 @@ The
option inhibits the display of function definitions; only the
function name and attributes are printed.
If the <B>extdebug</B> shell option is enabled using <B>shopt</B>,
the source file name and line number where the function is defined
are displayed as well. The
the source file name and line number where each <I>name</I>
is defined are displayed as well. The
<B>-F</B>
option implies
@@ -9817,6 +9826,7 @@ command; the
<B>popd</B>
command removes entries from the list.
The current directory is always the first directory in the stack.
<DL COMPACT><DT><DD>
<DL COMPACT>
@@ -11001,7 +11011,7 @@ The return value is zero on success, non-zero on failure.
Adds a directory to the top of the directory stack, or rotates
the stack, making the new top of the stack the current working
directory. With no arguments, exchanges the top two directories
directory. With no arguments, <B>pushd</B> exchanges the top two directories
and returns 0, unless the directory stack is empty.
Arguments, if supplied, have the following meanings:
<DL COMPACT><DT><DD>
@@ -11010,8 +11020,8 @@ Arguments, if supplied, have the following meanings:
<DT><B>-n</B>
<DD>
Suppresses the normal change of directory when adding directories
to the stack, so that only the stack is manipulated.
Suppresses the normal change of directory when rotating or
adding directories to the stack, so that only the stack is manipulated.
<DT><B>+</B><I>n</I><DD>
Rotates the stack so that the <I>n</I>th directory
(counting from the left of the list shown by
@@ -13377,7 +13387,7 @@ There may be only one active coprocess at a time.
<HR>
<TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>GNU Bash 4.4<TH ALIGN=CENTER width=33%>2015 June 11<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash 4.4<TH ALIGN=CENTER width=33%>2015 August 15<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -13483,6 +13493,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 July 2015 10:23:17 EDT
Time: 18 August 2015 16:27:16 EDT
</BODY>
</HTML>
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bash.ps
+2938 -2928
View File
File diff suppressed because it is too large Load Diff
doc/bashref.aux
+55 -55
View File
@@ -216,22 +216,22 @@
@xrdef{Controlling the Prompt-pg}{92}
@xrdef{The Restricted Shell-title}{The Restricted Shell}
@xrdef{The Restricted Shell-snt}{Section@tie 6.10}
@xrdef{The Restricted Shell-pg}{93}
@xrdef{Bash POSIX Mode-title}{Bash POSIX Mode}
@xrdef{Bash POSIX Mode-snt}{Section@tie 6.11}
@xrdef{The Restricted Shell-pg}{93}
@xrdef{Bash POSIX Mode-pg}{94}
@xrdef{Job Control-title}{Job Control}
@xrdef{Job Control-snt}{Chapter@tie 7}
@xrdef{Job Control Basics-title}{Job Control Basics}
@xrdef{Job Control Basics-snt}{Section@tie 7.1}
@xrdef{Job Control-pg}{97}
@xrdef{Job Control Basics-pg}{97}
@xrdef{Job Control-pg}{98}
@xrdef{Job Control Basics-pg}{98}
@xrdef{Job Control Builtins-title}{Job Control Builtins}
@xrdef{Job Control Builtins-snt}{Section@tie 7.2}
@xrdef{Job Control Builtins-pg}{98}
@xrdef{Job Control Builtins-pg}{99}
@xrdef{Job Control Variables-title}{Job Control Variables}
@xrdef{Job Control Variables-snt}{Section@tie 7.3}
@xrdef{Job Control Variables-pg}{100}
@xrdef{Job Control Variables-pg}{101}
@xrdef{Command Line Editing-title}{Command Line Editing}
@xrdef{Command Line Editing-snt}{Chapter@tie 8}
@xrdef{Introduction and Notation-title}{Introduction to Line Editing}
@@ -240,145 +240,145 @@
@xrdef{Readline Interaction-snt}{Section@tie 8.2}
@xrdef{Readline Bare Essentials-title}{Readline Bare Essentials}
@xrdef{Readline Bare Essentials-snt}{Section@tie 8.2.1}
@xrdef{Command Line Editing-pg}{101}
@xrdef{Introduction and Notation-pg}{101}
@xrdef{Readline Interaction-pg}{101}
@xrdef{Command Line Editing-pg}{102}
@xrdef{Introduction and Notation-pg}{102}
@xrdef{Readline Interaction-pg}{102}
@xrdef{Readline Movement Commands-title}{Readline Movement Commands}
@xrdef{Readline Movement Commands-snt}{Section@tie 8.2.2}
@xrdef{Readline Killing Commands-title}{Readline Killing Commands}
@xrdef{Readline Killing Commands-snt}{Section@tie 8.2.3}
@xrdef{Readline Bare Essentials-pg}{102}
@xrdef{Readline Movement Commands-pg}{102}
@xrdef{Readline Bare Essentials-pg}{103}
@xrdef{Readline Movement Commands-pg}{103}
@xrdef{Readline Arguments-title}{Readline Arguments}
@xrdef{Readline Arguments-snt}{Section@tie 8.2.4}
@xrdef{Searching-title}{Searching for Commands in the History}
@xrdef{Searching-snt}{Section@tie 8.2.5}
@xrdef{Readline Killing Commands-pg}{103}
@xrdef{Readline Arguments-pg}{103}
@xrdef{Searching-pg}{103}
@xrdef{Readline Killing Commands-pg}{104}
@xrdef{Readline Arguments-pg}{104}
@xrdef{Searching-pg}{104}
@xrdef{Readline Init File-title}{Readline Init File}
@xrdef{Readline Init File-snt}{Section@tie 8.3}
@xrdef{Readline Init File Syntax-title}{Readline Init File Syntax}
@xrdef{Readline Init File Syntax-snt}{Section@tie 8.3.1}
@xrdef{Readline Init File-pg}{104}
@xrdef{Readline Init File Syntax-pg}{104}
@xrdef{Readline Init File-pg}{105}
@xrdef{Readline Init File Syntax-pg}{105}
@xrdef{Conditional Init Constructs-title}{Conditional Init Constructs}
@xrdef{Conditional Init Constructs-snt}{Section@tie 8.3.2}
@xrdef{Conditional Init Constructs-pg}{112}
@xrdef{Conditional Init Constructs-pg}{113}
@xrdef{Sample Init File-title}{Sample Init File}
@xrdef{Sample Init File-snt}{Section@tie 8.3.3}
@xrdef{Sample Init File-pg}{113}
@xrdef{Sample Init File-pg}{114}
@xrdef{Bindable Readline Commands-title}{Bindable Readline Commands}
@xrdef{Bindable Readline Commands-snt}{Section@tie 8.4}
@xrdef{Commands For Moving-title}{Commands For Moving}
@xrdef{Commands For Moving-snt}{Section@tie 8.4.1}
@xrdef{Commands For History-title}{Commands For Manipulating The History}
@xrdef{Commands For History-snt}{Section@tie 8.4.2}
@xrdef{Bindable Readline Commands-pg}{116}
@xrdef{Commands For Moving-pg}{116}
@xrdef{Commands For History-pg}{117}
@xrdef{Bindable Readline Commands-pg}{117}
@xrdef{Commands For Moving-pg}{117}
@xrdef{Commands For History-pg}{118}
@xrdef{Commands For Text-title}{Commands For Changing Text}
@xrdef{Commands For Text-snt}{Section@tie 8.4.3}
@xrdef{Commands For Text-pg}{118}
@xrdef{Commands For Text-pg}{119}
@xrdef{Commands For Killing-title}{Killing And Yanking}
@xrdef{Commands For Killing-snt}{Section@tie 8.4.4}
@xrdef{Commands For Killing-pg}{119}
@xrdef{Commands For Killing-pg}{120}
@xrdef{Numeric Arguments-title}{Specifying Numeric Arguments}
@xrdef{Numeric Arguments-snt}{Section@tie 8.4.5}
@xrdef{Commands For Completion-title}{Letting Readline Type For You}
@xrdef{Commands For Completion-snt}{Section@tie 8.4.6}
@xrdef{Numeric Arguments-pg}{121}
@xrdef{Commands For Completion-pg}{121}
@xrdef{Numeric Arguments-pg}{122}
@xrdef{Commands For Completion-pg}{122}
@xrdef{Keyboard Macros-title}{Keyboard Macros}
@xrdef{Keyboard Macros-snt}{Section@tie 8.4.7}
@xrdef{Miscellaneous Commands-title}{Some Miscellaneous Commands}
@xrdef{Miscellaneous Commands-snt}{Section@tie 8.4.8}
@xrdef{Keyboard Macros-pg}{123}
@xrdef{Miscellaneous Commands-pg}{123}
@xrdef{Keyboard Macros-pg}{124}
@xrdef{Miscellaneous Commands-pg}{124}
@xrdef{Readline vi Mode-title}{Readline vi Mode}
@xrdef{Readline vi Mode-snt}{Section@tie 8.5}
@xrdef{Programmable Completion-title}{Programmable Completion}
@xrdef{Programmable Completion-snt}{Section@tie 8.6}
@xrdef{Readline vi Mode-pg}{125}
@xrdef{Programmable Completion-pg}{126}
@xrdef{Readline vi Mode-pg}{126}
@xrdef{Programmable Completion-pg}{127}
@xrdef{Programmable Completion Builtins-title}{Programmable Completion Builtins}
@xrdef{Programmable Completion Builtins-snt}{Section@tie 8.7}
@xrdef{Programmable Completion Builtins-pg}{128}
@xrdef{Programmable Completion Builtins-pg}{129}
@xrdef{A Programmable Completion Example-title}{A Programmable Completion Example}
@xrdef{A Programmable Completion Example-snt}{Section@tie 8.8}
@xrdef{A Programmable Completion Example-pg}{131}
@xrdef{A Programmable Completion Example-pg}{132}
@xrdef{Using History Interactively-title}{Using History Interactively}
@xrdef{Using History Interactively-snt}{Chapter@tie 9}
@xrdef{Bash History Facilities-title}{Bash History Facilities}
@xrdef{Bash History Facilities-snt}{Section@tie 9.1}
@xrdef{Bash History Builtins-title}{Bash History Builtins}
@xrdef{Bash History Builtins-snt}{Section@tie 9.2}
@xrdef{Using History Interactively-pg}{134}
@xrdef{Bash History Facilities-pg}{134}
@xrdef{Bash History Builtins-pg}{134}
@xrdef{Using History Interactively-pg}{135}
@xrdef{Bash History Facilities-pg}{135}
@xrdef{Bash History Builtins-pg}{135}
@xrdef{History Interaction-title}{History Expansion}
@xrdef{History Interaction-snt}{Section@tie 9.3}
@xrdef{Event Designators-title}{Event Designators}
@xrdef{Event Designators-snt}{Section@tie 9.3.1}
@xrdef{History Interaction-pg}{136}
@xrdef{Event Designators-pg}{136}
@xrdef{History Interaction-pg}{137}
@xrdef{Event Designators-pg}{137}
@xrdef{Word Designators-title}{Word Designators}
@xrdef{Word Designators-snt}{Section@tie 9.3.2}
@xrdef{Word Designators-pg}{137}
@xrdef{Word Designators-pg}{138}
@xrdef{Modifiers-title}{Modifiers}
@xrdef{Modifiers-snt}{Section@tie 9.3.3}
@xrdef{Modifiers-pg}{138}
@xrdef{Modifiers-pg}{139}
@xrdef{Installing Bash-title}{Installing Bash}
@xrdef{Installing Bash-snt}{Chapter@tie 10}
@xrdef{Basic Installation-title}{Basic Installation}
@xrdef{Basic Installation-snt}{Section@tie 10.1}
@xrdef{Compilers and Options-title}{Compilers and Options}
@xrdef{Compilers and Options-snt}{Section@tie 10.2}
@xrdef{Installing Bash-pg}{139}
@xrdef{Basic Installation-pg}{139}
@xrdef{Installing Bash-pg}{140}
@xrdef{Basic Installation-pg}{140}
@xrdef{Compiling For Multiple Architectures-title}{Compiling For Multiple Architectures}
@xrdef{Compiling For Multiple Architectures-snt}{Section@tie 10.3}
@xrdef{Installation Names-title}{Installation Names}
@xrdef{Installation Names-snt}{Section@tie 10.4}
@xrdef{Specifying the System Type-title}{Specifying the System Type}
@xrdef{Specifying the System Type-snt}{Section@tie 10.5}
@xrdef{Compilers and Options-pg}{140}
@xrdef{Compiling For Multiple Architectures-pg}{140}
@xrdef{Installation Names-pg}{140}
@xrdef{Specifying the System Type-pg}{140}
@xrdef{Compilers and Options-pg}{141}
@xrdef{Compiling For Multiple Architectures-pg}{141}
@xrdef{Installation Names-pg}{141}
@xrdef{Specifying the System Type-pg}{141}
@xrdef{Sharing Defaults-title}{Sharing Defaults}
@xrdef{Sharing Defaults-snt}{Section@tie 10.6}
@xrdef{Operation Controls-title}{Operation Controls}
@xrdef{Operation Controls-snt}{Section@tie 10.7}
@xrdef{Optional Features-title}{Optional Features}
@xrdef{Optional Features-snt}{Section@tie 10.8}
@xrdef{Sharing Defaults-pg}{141}
@xrdef{Operation Controls-pg}{141}
@xrdef{Optional Features-pg}{141}
@xrdef{Sharing Defaults-pg}{142}
@xrdef{Operation Controls-pg}{142}
@xrdef{Optional Features-pg}{142}
@xrdef{Reporting Bugs-title}{Reporting Bugs}
@xrdef{Reporting Bugs-snt}{Appendix@tie @char65{}}
@xrdef{Reporting Bugs-pg}{146}
@xrdef{Reporting Bugs-pg}{147}
@xrdef{Major Differences From The Bourne Shell-title}{Major Differences From The Bourne Shell}
@xrdef{Major Differences From The Bourne Shell-snt}{Appendix@tie @char66{}}
@xrdef{Major Differences From The Bourne Shell-pg}{147}
@xrdef{Major Differences From The Bourne Shell-pg}{148}
@xrdef{GNU Free Documentation License-title}{GNU Free Documentation License}
@xrdef{GNU Free Documentation License-snt}{Appendix@tie @char67{}}
@xrdef{GNU Free Documentation License-pg}{153}
@xrdef{GNU Free Documentation License-pg}{154}
@xrdef{Indexes-title}{Indexes}
@xrdef{Indexes-snt}{Appendix@tie @char68{}}
@xrdef{Builtin Index-title}{Index of Shell Builtin Commands}
@xrdef{Builtin Index-snt}{Section@tie @char68.1}
@xrdef{Indexes-pg}{161}
@xrdef{Builtin Index-pg}{161}
@xrdef{Indexes-pg}{162}
@xrdef{Builtin Index-pg}{162}
@xrdef{Reserved Word Index-title}{Index of Shell Reserved Words}
@xrdef{Reserved Word Index-snt}{Section@tie @char68.2}
@xrdef{Variable Index-title}{Parameter and Variable Index}
@xrdef{Variable Index-snt}{Section@tie @char68.3}
@xrdef{Reserved Word Index-pg}{162}
@xrdef{Variable Index-pg}{162}
@xrdef{Reserved Word Index-pg}{163}
@xrdef{Variable Index-pg}{163}
@xrdef{Function Index-title}{Function Index}
@xrdef{Function Index-snt}{Section@tie @char68.4}
@xrdef{Function Index-pg}{164}
@xrdef{Function Index-pg}{165}
@xrdef{Concept Index-title}{Concept Index}
@xrdef{Concept Index-snt}{Section@tie @char68.5}
@xrdef{Concept Index-pg}{166}
@xrdef{Concept Index-pg}{167}
doc/bashref.bt
+12 -12
View File
@@ -45,15 +45,15 @@
\entry{dirs}{91}{\code {dirs}}
\entry{popd}{91}{\code {popd}}
\entry{pushd}{91}{\code {pushd}}
\entry{bg}{98}{\code {bg}}
\entry{fg}{98}{\code {fg}}
\entry{jobs}{98}{\code {jobs}}
\entry{kill}{99}{\code {kill}}
\entry{wait}{99}{\code {wait}}
\entry{disown}{99}{\code {disown}}
\entry{suspend}{99}{\code {suspend}}
\entry{compgen}{128}{\code {compgen}}
\entry{complete}{128}{\code {complete}}
\entry{compopt}{131}{\code {compopt}}
\entry{fc}{134}{\code {fc}}
\entry{history}{135}{\code {history}}
\entry{bg}{99}{\code {bg}}
\entry{fg}{99}{\code {fg}}
\entry{jobs}{99}{\code {jobs}}
\entry{kill}{100}{\code {kill}}
\entry{wait}{100}{\code {wait}}
\entry{disown}{100}{\code {disown}}
\entry{suspend}{100}{\code {suspend}}
\entry{compgen}{129}{\code {compgen}}
\entry{complete}{129}{\code {complete}}
\entry{compopt}{132}{\code {compopt}}
\entry{fc}{135}{\code {fc}}
\entry{history}{136}{\code {history}}
doc/bashref.bts
+12 -12
View File
@@ -7,7 +7,7 @@
\initial {A}
\entry {\code {alias}}{48}
\initial {B}
\entry {\code {bg}}{98}
\entry {\code {bg}}{99}
\entry {\code {bind}}{48}
\entry {\code {break}}{42}
\entry {\code {builtin}}{49}
@@ -15,14 +15,14 @@
\entry {\code {caller}}{50}
\entry {\code {cd}}{42}
\entry {\code {command}}{50}
\entry {\code {compgen}}{128}
\entry {\code {complete}}{128}
\entry {\code {compopt}}{131}
\entry {\code {compgen}}{129}
\entry {\code {complete}}{129}
\entry {\code {compopt}}{132}
\entry {\code {continue}}{42}
\initial {D}
\entry {\code {declare}}{50}
\entry {\code {dirs}}{91}
\entry {\code {disown}}{99}
\entry {\code {disown}}{100}
\initial {E}
\entry {\code {echo}}{52}
\entry {\code {enable}}{52}
@@ -31,18 +31,18 @@
\entry {\code {exit}}{43}
\entry {\code {export}}{43}
\initial {F}
\entry {\code {fc}}{134}
\entry {\code {fg}}{98}
\entry {\code {fc}}{135}
\entry {\code {fg}}{99}
\initial {G}
\entry {\code {getopts}}{43}
\initial {H}
\entry {\code {hash}}{44}
\entry {\code {help}}{53}
\entry {\code {history}}{135}
\entry {\code {history}}{136}
\initial {J}
\entry {\code {jobs}}{98}
\entry {\code {jobs}}{99}
\initial {K}
\entry {\code {kill}}{99}
\entry {\code {kill}}{100}
\initial {L}
\entry {\code {let}}{53}
\entry {\code {local}}{53}
@@ -64,7 +64,7 @@
\entry {\code {shift}}{45}
\entry {\code {shopt}}{63}
\entry {\code {source}}{57}
\entry {\code {suspend}}{99}
\entry {\code {suspend}}{100}
\initial {T}
\entry {\code {test}}{45}
\entry {\code {times}}{47}
@@ -77,4 +77,4 @@
\entry {\code {unalias}}{58}
\entry {\code {unset}}{48}
\initial {W}
\entry {\code {wait}}{99}
\entry {\code {wait}}{100}
doc/bashref.cp
+27 -27
View File
@@ -89,30 +89,30 @@
\entry{prompting}{92}{prompting}
\entry{restricted shell}{93}{restricted shell}
\entry{POSIX Mode}{94}{POSIX Mode}
\entry{job control}{97}{job control}
\entry{foreground}{97}{foreground}
\entry{background}{97}{background}
\entry{suspending jobs}{97}{suspending jobs}
\entry{Readline, how to use}{100}{Readline, how to use}
\entry{interaction, readline}{101}{interaction, readline}
\entry{notation, readline}{102}{notation, readline}
\entry{command editing}{102}{command editing}
\entry{editing command lines}{102}{editing command lines}
\entry{killing text}{103}{killing text}
\entry{yanking text}{103}{yanking text}
\entry{kill ring}{103}{kill ring}
\entry{initialization file, readline}{104}{initialization file, readline}
\entry{variables, readline}{105}{variables, readline}
\entry{programmable completion}{126}{programmable completion}
\entry{completion builtins}{128}{completion builtins}
\entry{History, how to use}{133}{History, how to use}
\entry{command history}{134}{command history}
\entry{history list}{134}{history list}
\entry{history builtins}{134}{history builtins}
\entry{history expansion}{136}{history expansion}
\entry{event designators}{136}{event designators}
\entry{history events}{136}{history events}
\entry{installation}{139}{installation}
\entry{configuration}{139}{configuration}
\entry{Bash installation}{139}{Bash installation}
\entry{Bash configuration}{139}{Bash configuration}
\entry{job control}{98}{job control}
\entry{foreground}{98}{foreground}
\entry{background}{98}{background}
\entry{suspending jobs}{98}{suspending jobs}
\entry{Readline, how to use}{101}{Readline, how to use}
\entry{interaction, readline}{102}{interaction, readline}
\entry{notation, readline}{103}{notation, readline}
\entry{command editing}{103}{command editing}
\entry{editing command lines}{103}{editing command lines}
\entry{killing text}{104}{killing text}
\entry{yanking text}{104}{yanking text}
\entry{kill ring}{104}{kill ring}
\entry{initialization file, readline}{105}{initialization file, readline}
\entry{variables, readline}{106}{variables, readline}
\entry{programmable completion}{127}{programmable completion}
\entry{completion builtins}{129}{completion builtins}
\entry{History, how to use}{134}{History, how to use}
\entry{command history}{135}{command history}
\entry{history list}{135}{history list}
\entry{history builtins}{135}{history builtins}
\entry{history expansion}{137}{history expansion}
\entry{event designators}{137}{event designators}
\entry{history events}{137}{history events}
\entry{installation}{140}{installation}
\entry{configuration}{140}{configuration}
\entry{Bash installation}{140}{Bash installation}
\entry{Bash configuration}{140}{Bash configuration}
doc/bashref.cps
+27 -27
View File
@@ -5,17 +5,17 @@
\entry {arithmetic, shell}{87}
\entry {arrays}{89}
\initial {B}
\entry {background}{97}
\entry {Bash configuration}{139}
\entry {Bash installation}{139}
\entry {background}{98}
\entry {Bash configuration}{140}
\entry {Bash installation}{140}
\entry {Bourne shell}{5}
\entry {brace expansion}{21}
\entry {builtin}{3}
\initial {C}
\entry {command editing}{102}
\entry {command editing}{103}
\entry {command execution}{37}
\entry {command expansion}{36}
\entry {command history}{134}
\entry {command history}{135}
\entry {command search}{37}
\entry {command substitution}{29}
\entry {command timing}{8}
@@ -28,17 +28,17 @@
\entry {commands, shell}{8}
\entry {commands, simple}{8}
\entry {comments, shell}{7}
\entry {completion builtins}{128}
\entry {configuration}{139}
\entry {completion builtins}{129}
\entry {configuration}{140}
\entry {control operator}{3}
\entry {coprocess}{15}
\initial {D}
\entry {directory stack}{90}
\initial {E}
\entry {editing command lines}{102}
\entry {editing command lines}{103}
\entry {environment}{38}
\entry {evaluation, arithmetic}{87}
\entry {event designators}{136}
\entry {event designators}{137}
\entry {execution environment}{37}
\entry {exit status}{3, 39}
\entry {expansion}{21}
@@ -54,27 +54,27 @@
\entry {field}{3}
\entry {filename}{3}
\entry {filename expansion}{30}
\entry {foreground}{97}
\entry {foreground}{98}
\entry {functions, shell}{17}
\initial {H}
\entry {history builtins}{134}
\entry {history events}{136}
\entry {history expansion}{136}
\entry {history list}{134}
\entry {History, how to use}{133}
\entry {history builtins}{135}
\entry {history events}{137}
\entry {history expansion}{137}
\entry {history list}{135}
\entry {History, how to use}{134}
\initial {I}
\entry {identifier}{3}
\entry {initialization file, readline}{104}
\entry {installation}{139}
\entry {interaction, readline}{101}
\entry {initialization file, readline}{105}
\entry {installation}{140}
\entry {interaction, readline}{102}
\entry {interactive shell}{82, 83}
\entry {internationalization}{7}
\initial {J}
\entry {job}{3}
\entry {job control}{3, 97}
\entry {job control}{3, 98}
\initial {K}
\entry {kill ring}{103}
\entry {killing text}{103}
\entry {kill ring}{104}
\entry {killing text}{104}
\initial {L}
\entry {localization}{7}
\entry {login shell}{82}
@@ -84,7 +84,7 @@
\initial {N}
\entry {name}{3}
\entry {native languages}{7}
\entry {notation, readline}{102}
\entry {notation, readline}{103}
\initial {O}
\entry {operator, shell}{3}
\initial {P}
@@ -100,13 +100,13 @@
\entry {process group}{3}
\entry {process group ID}{3}
\entry {process substitution}{30}
\entry {programmable completion}{126}
\entry {programmable completion}{127}
\entry {prompting}{92}
\initial {Q}
\entry {quoting}{6}
\entry {quoting, ANSI}{6}
\initial {R}
\entry {Readline, how to use}{100}
\entry {Readline, how to use}{101}
\entry {redirection}{32}
\entry {reserved word}{3}
\entry {restricted shell}{93}
@@ -121,16 +121,16 @@
\entry {signal handling}{39}
\entry {special builtin}{4, 68}
\entry {startup files}{82}
\entry {suspending jobs}{97}
\entry {suspending jobs}{98}
\initial {T}
\entry {tilde expansion}{22}
\entry {token}{4}
\entry {translation, native languages}{7}
\initial {V}
\entry {variable, shell}{18}
\entry {variables, readline}{105}
\entry {variables, readline}{106}
\initial {W}
\entry {word}{4}
\entry {word splitting}{30}
\initial {Y}
\entry {yanking text}{103}
\entry {yanking text}{104}
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.fn
+108 -108
View File
@@ -1,108 +1,108 @@
\entry{beginning-of-line (C-a)}{116}{\code {beginning-of-line (C-a)}}
\entry{end-of-line (C-e)}{116}{\code {end-of-line (C-e)}}
\entry{forward-char (C-f)}{116}{\code {forward-char (C-f)}}
\entry{backward-char (C-b)}{116}{\code {backward-char (C-b)}}
\entry{forward-word (M-f)}{116}{\code {forward-word (M-f)}}
\entry{backward-word (M-b)}{116}{\code {backward-word (M-b)}}
\entry{shell-forward-word ()}{116}{\code {shell-forward-word ()}}
\entry{shell-backward-word ()}{116}{\code {shell-backward-word ()}}
\entry{clear-screen (C-l)}{116}{\code {clear-screen (C-l)}}
\entry{redraw-current-line ()}{116}{\code {redraw-current-line ()}}
\entry{accept-line (Newline or Return)}{117}{\code {accept-line (Newline or Return)}}
\entry{previous-history (C-p)}{117}{\code {previous-history (C-p)}}
\entry{next-history (C-n)}{117}{\code {next-history (C-n)}}
\entry{beginning-of-history (M-<)}{117}{\code {beginning-of-history (M-<)}}
\entry{end-of-history (M->)}{117}{\code {end-of-history (M->)}}
\entry{reverse-search-history (C-r)}{117}{\code {reverse-search-history (C-r)}}
\entry{forward-search-history (C-s)}{117}{\code {forward-search-history (C-s)}}
\entry{non-incremental-reverse-search-history (M-p)}{117}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-forward-search-history (M-n)}{117}{\code {non-incremental-forward-search-history (M-n)}}
\entry{history-search-forward ()}{117}{\code {history-search-forward ()}}
\entry{history-search-backward ()}{117}{\code {history-search-backward ()}}
\entry{history-substr-search-forward ()}{117}{\code {history-substr-search-forward ()}}
\entry{history-substr-search-backward ()}{118}{\code {history-substr-search-backward ()}}
\entry{yank-nth-arg (M-C-y)}{118}{\code {yank-nth-arg (M-C-y)}}
\entry{yank-last-arg (M-. or M-_)}{118}{\code {yank-last-arg (M-. or M-_)}}
\entry{end-of-file (usually C-d)}{118}{\code {\i {end-of-file} (usually C-d)}}
\entry{delete-char (C-d)}{118}{\code {delete-char (C-d)}}
\entry{backward-delete-char (Rubout)}{118}{\code {backward-delete-char (Rubout)}}
\entry{forward-backward-delete-char ()}{118}{\code {forward-backward-delete-char ()}}
\entry{quoted-insert (C-q or C-v)}{118}{\code {quoted-insert (C-q or C-v)}}
\entry{self-insert (a, b, A, 1, !, ...{})}{119}{\code {self-insert (a, b, A, 1, !, \dots {})}}
\entry{bracketed-paste-begin ()}{119}{\code {bracketed-paste-begin ()}}
\entry{transpose-chars (C-t)}{119}{\code {transpose-chars (C-t)}}
\entry{transpose-words (M-t)}{119}{\code {transpose-words (M-t)}}
\entry{upcase-word (M-u)}{119}{\code {upcase-word (M-u)}}
\entry{downcase-word (M-l)}{119}{\code {downcase-word (M-l)}}
\entry{capitalize-word (M-c)}{119}{\code {capitalize-word (M-c)}}
\entry{overwrite-mode ()}{119}{\code {overwrite-mode ()}}
\entry{kill-line (C-k)}{119}{\code {kill-line (C-k)}}
\entry{backward-kill-line (C-x Rubout)}{119}{\code {backward-kill-line (C-x Rubout)}}
\entry{unix-line-discard (C-u)}{120}{\code {unix-line-discard (C-u)}}
\entry{kill-whole-line ()}{120}{\code {kill-whole-line ()}}
\entry{kill-word (M-d)}{120}{\code {kill-word (M-d)}}
\entry{backward-kill-word (M-DEL)}{120}{\code {backward-kill-word (M-\key {DEL})}}
\entry{shell-kill-word ()}{120}{\code {shell-kill-word ()}}
\entry{shell-backward-kill-word ()}{120}{\code {shell-backward-kill-word ()}}
\entry{unix-word-rubout (C-w)}{120}{\code {unix-word-rubout (C-w)}}
\entry{unix-filename-rubout ()}{120}{\code {unix-filename-rubout ()}}
\entry{delete-horizontal-space ()}{120}{\code {delete-horizontal-space ()}}
\entry{kill-region ()}{120}{\code {kill-region ()}}
\entry{copy-region-as-kill ()}{120}{\code {copy-region-as-kill ()}}
\entry{copy-backward-word ()}{120}{\code {copy-backward-word ()}}
\entry{copy-forward-word ()}{120}{\code {copy-forward-word ()}}
\entry{yank (C-y)}{120}{\code {yank (C-y)}}
\entry{yank-pop (M-y)}{120}{\code {yank-pop (M-y)}}
\entry{digit-argument (M-0, M-1, ...{} M--)}{121}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
\entry{universal-argument ()}{121}{\code {universal-argument ()}}
\entry{complete (TAB)}{121}{\code {complete (\key {TAB})}}
\entry{possible-completions (M-?)}{121}{\code {possible-completions (M-?)}}
\entry{insert-completions (M-*)}{121}{\code {insert-completions (M-*)}}
\entry{menu-complete ()}{121}{\code {menu-complete ()}}
\entry{menu-complete-backward ()}{121}{\code {menu-complete-backward ()}}
\entry{delete-char-or-list ()}{122}{\code {delete-char-or-list ()}}
\entry{complete-filename (M-/)}{122}{\code {complete-filename (M-/)}}
\entry{possible-filename-completions (C-x /)}{122}{\code {possible-filename-completions (C-x /)}}
\entry{complete-username (M-~)}{122}{\code {complete-username (M-~)}}
\entry{possible-username-completions (C-x ~)}{122}{\code {possible-username-completions (C-x ~)}}
\entry{complete-variable (M-$)}{122}{\code {complete-variable (M-$)}}
\entry{possible-variable-completions (C-x $)}{122}{\code {possible-variable-completions (C-x $)}}
\entry{complete-hostname (M-@)}{122}{\code {complete-hostname (M-@)}}
\entry{possible-hostname-completions (C-x @)}{122}{\code {possible-hostname-completions (C-x @)}}
\entry{complete-command (M-!)}{122}{\code {complete-command (M-!)}}
\entry{possible-command-completions (C-x !)}{122}{\code {possible-command-completions (C-x !)}}
\entry{dynamic-complete-history (M-TAB)}{122}{\code {dynamic-complete-history (M-\key {TAB})}}
\entry{dabbrev-expand ()}{122}{\code {dabbrev-expand ()}}
\entry{complete-into-braces (M-|a)}{122}{\code {complete-into-braces (M-{\tt \char 123})}}
\entry{start-kbd-macro (C-x ()}{123}{\code {start-kbd-macro (C-x ()}}
\entry{end-kbd-macro (C-x ))}{123}{\code {end-kbd-macro (C-x ))}}
\entry{call-last-kbd-macro (C-x e)}{123}{\code {call-last-kbd-macro (C-x e)}}
\entry{print-last-kbd-macro ()}{123}{\code {print-last-kbd-macro ()}}
\entry{re-read-init-file (C-x C-r)}{123}{\code {re-read-init-file (C-x C-r)}}
\entry{abort (C-g)}{123}{\code {abort (C-g)}}
\entry{do-uppercase-version (M-a, M-b, M-x, ...{})}{123}{\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}
\entry{prefix-meta (ESC)}{123}{\code {prefix-meta (\key {ESC})}}
\entry{undo (C-_ or C-x C-u)}{123}{\code {undo (C-_ or C-x C-u)}}
\entry{revert-line (M-r)}{123}{\code {revert-line (M-r)}}
\entry{tilde-expand (M-&)}{123}{\code {tilde-expand (M-&)}}
\entry{set-mark (C-@)}{123}{\code {set-mark (C-@)}}
\entry{exchange-point-and-mark (C-x C-x)}{123}{\code {exchange-point-and-mark (C-x C-x)}}
\entry{character-search (C-])}{123}{\code {character-search (C-])}}
\entry{character-search-backward (M-C-])}{124}{\code {character-search-backward (M-C-])}}
\entry{skip-csi-sequence ()}{124}{\code {skip-csi-sequence ()}}
\entry{insert-comment (M-#)}{124}{\code {insert-comment (M-#)}}
\entry{dump-functions ()}{124}{\code {dump-functions ()}}
\entry{dump-variables ()}{124}{\code {dump-variables ()}}
\entry{dump-macros ()}{124}{\code {dump-macros ()}}
\entry{glob-complete-word (M-g)}{124}{\code {glob-complete-word (M-g)}}
\entry{glob-expand-word (C-x *)}{124}{\code {glob-expand-word (C-x *)}}
\entry{glob-list-expansions (C-x g)}{125}{\code {glob-list-expansions (C-x g)}}
\entry{display-shell-version (C-x C-v)}{125}{\code {display-shell-version (C-x C-v)}}
\entry{shell-expand-line (M-C-e)}{125}{\code {shell-expand-line (M-C-e)}}
\entry{history-expand-line (M-^)}{125}{\code {history-expand-line (M-^)}}
\entry{magic-space ()}{125}{\code {magic-space ()}}
\entry{alias-expand-line ()}{125}{\code {alias-expand-line ()}}
\entry{history-and-alias-expand-line ()}{125}{\code {history-and-alias-expand-line ()}}
\entry{insert-last-argument (M-. or M-_)}{125}{\code {insert-last-argument (M-. or M-_)}}
\entry{operate-and-get-next (C-o)}{125}{\code {operate-and-get-next (C-o)}}
\entry{edit-and-execute-command (C-xC-e)}{125}{\code {edit-and-execute-command (C-xC-e)}}
\entry{beginning-of-line (C-a)}{117}{\code {beginning-of-line (C-a)}}
\entry{end-of-line (C-e)}{117}{\code {end-of-line (C-e)}}
\entry{forward-char (C-f)}{117}{\code {forward-char (C-f)}}
\entry{backward-char (C-b)}{117}{\code {backward-char (C-b)}}
\entry{forward-word (M-f)}{117}{\code {forward-word (M-f)}}
\entry{backward-word (M-b)}{117}{\code {backward-word (M-b)}}
\entry{shell-forward-word ()}{117}{\code {shell-forward-word ()}}
\entry{shell-backward-word ()}{117}{\code {shell-backward-word ()}}
\entry{clear-screen (C-l)}{117}{\code {clear-screen (C-l)}}
\entry{redraw-current-line ()}{117}{\code {redraw-current-line ()}}
\entry{accept-line (Newline or Return)}{118}{\code {accept-line (Newline or Return)}}
\entry{previous-history (C-p)}{118}{\code {previous-history (C-p)}}
\entry{next-history (C-n)}{118}{\code {next-history (C-n)}}
\entry{beginning-of-history (M-<)}{118}{\code {beginning-of-history (M-<)}}
\entry{end-of-history (M->)}{118}{\code {end-of-history (M->)}}
\entry{reverse-search-history (C-r)}{118}{\code {reverse-search-history (C-r)}}
\entry{forward-search-history (C-s)}{118}{\code {forward-search-history (C-s)}}
\entry{non-incremental-reverse-search-history (M-p)}{118}{\code {non-incremental-reverse-search-history (M-p)}}
\entry{non-incremental-forward-search-history (M-n)}{118}{\code {non-incremental-forward-search-history (M-n)}}
\entry{history-search-forward ()}{118}{\code {history-search-forward ()}}
\entry{history-search-backward ()}{118}{\code {history-search-backward ()}}
\entry{history-substr-search-forward ()}{118}{\code {history-substr-search-forward ()}}
\entry{history-substr-search-backward ()}{119}{\code {history-substr-search-backward ()}}
\entry{yank-nth-arg (M-C-y)}{119}{\code {yank-nth-arg (M-C-y)}}
\entry{yank-last-arg (M-. or M-_)}{119}{\code {yank-last-arg (M-. or M-_)}}
\entry{end-of-file (usually C-d)}{119}{\code {\i {end-of-file} (usually C-d)}}
\entry{delete-char (C-d)}{119}{\code {delete-char (C-d)}}
\entry{backward-delete-char (Rubout)}{119}{\code {backward-delete-char (Rubout)}}
\entry{forward-backward-delete-char ()}{119}{\code {forward-backward-delete-char ()}}
\entry{quoted-insert (C-q or C-v)}{119}{\code {quoted-insert (C-q or C-v)}}
\entry{self-insert (a, b, A, 1, !, ...{})}{120}{\code {self-insert (a, b, A, 1, !, \dots {})}}
\entry{bracketed-paste-begin ()}{120}{\code {bracketed-paste-begin ()}}
\entry{transpose-chars (C-t)}{120}{\code {transpose-chars (C-t)}}
\entry{transpose-words (M-t)}{120}{\code {transpose-words (M-t)}}
\entry{upcase-word (M-u)}{120}{\code {upcase-word (M-u)}}
\entry{downcase-word (M-l)}{120}{\code {downcase-word (M-l)}}
\entry{capitalize-word (M-c)}{120}{\code {capitalize-word (M-c)}}
\entry{overwrite-mode ()}{120}{\code {overwrite-mode ()}}
\entry{kill-line (C-k)}{120}{\code {kill-line (C-k)}}
\entry{backward-kill-line (C-x Rubout)}{120}{\code {backward-kill-line (C-x Rubout)}}
\entry{unix-line-discard (C-u)}{121}{\code {unix-line-discard (C-u)}}
\entry{kill-whole-line ()}{121}{\code {kill-whole-line ()}}
\entry{kill-word (M-d)}{121}{\code {kill-word (M-d)}}
\entry{backward-kill-word (M-DEL)}{121}{\code {backward-kill-word (M-\key {DEL})}}
\entry{shell-kill-word ()}{121}{\code {shell-kill-word ()}}
\entry{shell-backward-kill-word ()}{121}{\code {shell-backward-kill-word ()}}
\entry{unix-word-rubout (C-w)}{121}{\code {unix-word-rubout (C-w)}}
\entry{unix-filename-rubout ()}{121}{\code {unix-filename-rubout ()}}
\entry{delete-horizontal-space ()}{121}{\code {delete-horizontal-space ()}}
\entry{kill-region ()}{121}{\code {kill-region ()}}
\entry{copy-region-as-kill ()}{121}{\code {copy-region-as-kill ()}}
\entry{copy-backward-word ()}{121}{\code {copy-backward-word ()}}
\entry{copy-forward-word ()}{121}{\code {copy-forward-word ()}}
\entry{yank (C-y)}{121}{\code {yank (C-y)}}
\entry{yank-pop (M-y)}{121}{\code {yank-pop (M-y)}}
\entry{digit-argument (M-0, M-1, ...{} M--)}{122}{\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}
\entry{universal-argument ()}{122}{\code {universal-argument ()}}
\entry{complete (TAB)}{122}{\code {complete (\key {TAB})}}
\entry{possible-completions (M-?)}{122}{\code {possible-completions (M-?)}}
\entry{insert-completions (M-*)}{122}{\code {insert-completions (M-*)}}
\entry{menu-complete ()}{122}{\code {menu-complete ()}}
\entry{menu-complete-backward ()}{122}{\code {menu-complete-backward ()}}
\entry{delete-char-or-list ()}{123}{\code {delete-char-or-list ()}}
\entry{complete-filename (M-/)}{123}{\code {complete-filename (M-/)}}
\entry{possible-filename-completions (C-x /)}{123}{\code {possible-filename-completions (C-x /)}}
\entry{complete-username (M-~)}{123}{\code {complete-username (M-~)}}
\entry{possible-username-completions (C-x ~)}{123}{\code {possible-username-completions (C-x ~)}}
\entry{complete-variable (M-$)}{123}{\code {complete-variable (M-$)}}
\entry{possible-variable-completions (C-x $)}{123}{\code {possible-variable-completions (C-x $)}}
\entry{complete-hostname (M-@)}{123}{\code {complete-hostname (M-@)}}
\entry{possible-hostname-completions (C-x @)}{123}{\code {possible-hostname-completions (C-x @)}}
\entry{complete-command (M-!)}{123}{\code {complete-command (M-!)}}
\entry{possible-command-completions (C-x !)}{123}{\code {possible-command-completions (C-x !)}}
\entry{dynamic-complete-history (M-TAB)}{123}{\code {dynamic-complete-history (M-\key {TAB})}}
\entry{dabbrev-expand ()}{123}{\code {dabbrev-expand ()}}
\entry{complete-into-braces (M-|a)}{123}{\code {complete-into-braces (M-{\tt \char 123})}}
\entry{start-kbd-macro (C-x ()}{124}{\code {start-kbd-macro (C-x ()}}
\entry{end-kbd-macro (C-x ))}{124}{\code {end-kbd-macro (C-x ))}}
\entry{call-last-kbd-macro (C-x e)}{124}{\code {call-last-kbd-macro (C-x e)}}
\entry{print-last-kbd-macro ()}{124}{\code {print-last-kbd-macro ()}}
\entry{re-read-init-file (C-x C-r)}{124}{\code {re-read-init-file (C-x C-r)}}
\entry{abort (C-g)}{124}{\code {abort (C-g)}}
\entry{do-uppercase-version (M-a, M-b, M-x, ...{})}{124}{\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}
\entry{prefix-meta (ESC)}{124}{\code {prefix-meta (\key {ESC})}}
\entry{undo (C-_ or C-x C-u)}{124}{\code {undo (C-_ or C-x C-u)}}
\entry{revert-line (M-r)}{124}{\code {revert-line (M-r)}}
\entry{tilde-expand (M-&)}{124}{\code {tilde-expand (M-&)}}
\entry{set-mark (C-@)}{124}{\code {set-mark (C-@)}}
\entry{exchange-point-and-mark (C-x C-x)}{124}{\code {exchange-point-and-mark (C-x C-x)}}
\entry{character-search (C-])}{124}{\code {character-search (C-])}}
\entry{character-search-backward (M-C-])}{125}{\code {character-search-backward (M-C-])}}
\entry{skip-csi-sequence ()}{125}{\code {skip-csi-sequence ()}}
\entry{insert-comment (M-#)}{125}{\code {insert-comment (M-#)}}
\entry{dump-functions ()}{125}{\code {dump-functions ()}}
\entry{dump-variables ()}{125}{\code {dump-variables ()}}
\entry{dump-macros ()}{125}{\code {dump-macros ()}}
\entry{glob-complete-word (M-g)}{125}{\code {glob-complete-word (M-g)}}
\entry{glob-expand-word (C-x *)}{125}{\code {glob-expand-word (C-x *)}}
\entry{glob-list-expansions (C-x g)}{126}{\code {glob-list-expansions (C-x g)}}
\entry{display-shell-version (C-x C-v)}{126}{\code {display-shell-version (C-x C-v)}}
\entry{shell-expand-line (M-C-e)}{126}{\code {shell-expand-line (M-C-e)}}
\entry{history-expand-line (M-^)}{126}{\code {history-expand-line (M-^)}}
\entry{magic-space ()}{126}{\code {magic-space ()}}
\entry{alias-expand-line ()}{126}{\code {alias-expand-line ()}}
\entry{history-and-alias-expand-line ()}{126}{\code {history-and-alias-expand-line ()}}
\entry{insert-last-argument (M-. or M-_)}{126}{\code {insert-last-argument (M-. or M-_)}}
\entry{operate-and-get-next (C-o)}{126}{\code {operate-and-get-next (C-o)}}
\entry{edit-and-execute-command (C-xC-e)}{126}{\code {edit-and-execute-command (C-xC-e)}}
doc/bashref.fns
+108 -108
View File
@@ -1,128 +1,128 @@
\initial {A}
\entry {\code {abort (C-g)}}{123}
\entry {\code {accept-line (Newline or Return)}}{117}
\entry {\code {alias-expand-line ()}}{125}
\entry {\code {abort (C-g)}}{124}
\entry {\code {accept-line (Newline or Return)}}{118}
\entry {\code {alias-expand-line ()}}{126}
\initial {B}
\entry {\code {backward-char (C-b)}}{116}
\entry {\code {backward-delete-char (Rubout)}}{118}
\entry {\code {backward-kill-line (C-x Rubout)}}{119}
\entry {\code {backward-kill-word (M-\key {DEL})}}{120}
\entry {\code {backward-word (M-b)}}{116}
\entry {\code {beginning-of-history (M-<)}}{117}
\entry {\code {beginning-of-line (C-a)}}{116}
\entry {\code {bracketed-paste-begin ()}}{119}
\entry {\code {backward-char (C-b)}}{117}
\entry {\code {backward-delete-char (Rubout)}}{119}
\entry {\code {backward-kill-line (C-x Rubout)}}{120}
\entry {\code {backward-kill-word (M-\key {DEL})}}{121}
\entry {\code {backward-word (M-b)}}{117}
\entry {\code {beginning-of-history (M-<)}}{118}
\entry {\code {beginning-of-line (C-a)}}{117}
\entry {\code {bracketed-paste-begin ()}}{120}
\initial {C}
\entry {\code {call-last-kbd-macro (C-x e)}}{123}
\entry {\code {capitalize-word (M-c)}}{119}
\entry {\code {character-search (C-])}}{123}
\entry {\code {character-search-backward (M-C-])}}{124}
\entry {\code {clear-screen (C-l)}}{116}
\entry {\code {complete (\key {TAB})}}{121}
\entry {\code {complete-command (M-!)}}{122}
\entry {\code {complete-filename (M-/)}}{122}
\entry {\code {complete-hostname (M-@)}}{122}
\entry {\code {complete-into-braces (M-{\tt \char 123})}}{122}
\entry {\code {complete-username (M-~)}}{122}
\entry {\code {complete-variable (M-$)}}{122}
\entry {\code {copy-backward-word ()}}{120}
\entry {\code {copy-forward-word ()}}{120}
\entry {\code {copy-region-as-kill ()}}{120}
\entry {\code {call-last-kbd-macro (C-x e)}}{124}
\entry {\code {capitalize-word (M-c)}}{120}
\entry {\code {character-search (C-])}}{124}
\entry {\code {character-search-backward (M-C-])}}{125}
\entry {\code {clear-screen (C-l)}}{117}
\entry {\code {complete (\key {TAB})}}{122}
\entry {\code {complete-command (M-!)}}{123}
\entry {\code {complete-filename (M-/)}}{123}
\entry {\code {complete-hostname (M-@)}}{123}
\entry {\code {complete-into-braces (M-{\tt \char 123})}}{123}
\entry {\code {complete-username (M-~)}}{123}
\entry {\code {complete-variable (M-$)}}{123}
\entry {\code {copy-backward-word ()}}{121}
\entry {\code {copy-forward-word ()}}{121}
\entry {\code {copy-region-as-kill ()}}{121}
\initial {D}
\entry {\code {dabbrev-expand ()}}{122}
\entry {\code {delete-char (C-d)}}{118}
\entry {\code {delete-char-or-list ()}}{122}
\entry {\code {delete-horizontal-space ()}}{120}
\entry {\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{121}
\entry {\code {display-shell-version (C-x C-v)}}{125}
\entry {\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}{123}
\entry {\code {downcase-word (M-l)}}{119}
\entry {\code {dump-functions ()}}{124}
\entry {\code {dump-macros ()}}{124}
\entry {\code {dump-variables ()}}{124}
\entry {\code {dynamic-complete-history (M-\key {TAB})}}{122}
\entry {\code {dabbrev-expand ()}}{123}
\entry {\code {delete-char (C-d)}}{119}
\entry {\code {delete-char-or-list ()}}{123}
\entry {\code {delete-horizontal-space ()}}{121}
\entry {\code {digit-argument (\kbd {M-0}, \kbd {M-1}, \dots {} \kbd {M--})}}{122}
\entry {\code {display-shell-version (C-x C-v)}}{126}
\entry {\code {do-uppercase-version (M-a, M-b, M-\var {x}, \dots {})}}{124}
\entry {\code {downcase-word (M-l)}}{120}
\entry {\code {dump-functions ()}}{125}
\entry {\code {dump-macros ()}}{125}
\entry {\code {dump-variables ()}}{125}
\entry {\code {dynamic-complete-history (M-\key {TAB})}}{123}
\initial {E}
\entry {\code {edit-and-execute-command (C-xC-e)}}{125}
\entry {\code {end-kbd-macro (C-x ))}}{123}
\entry {\code {\i {end-of-file} (usually C-d)}}{118}
\entry {\code {end-of-history (M->)}}{117}
\entry {\code {end-of-line (C-e)}}{116}
\entry {\code {exchange-point-and-mark (C-x C-x)}}{123}
\entry {\code {edit-and-execute-command (C-xC-e)}}{126}
\entry {\code {end-kbd-macro (C-x ))}}{124}
\entry {\code {\i {end-of-file} (usually C-d)}}{119}
\entry {\code {end-of-history (M->)}}{118}
\entry {\code {end-of-line (C-e)}}{117}
\entry {\code {exchange-point-and-mark (C-x C-x)}}{124}
\initial {F}
\entry {\code {forward-backward-delete-char ()}}{118}
\entry {\code {forward-char (C-f)}}{116}
\entry {\code {forward-search-history (C-s)}}{117}
\entry {\code {forward-word (M-f)}}{116}
\entry {\code {forward-backward-delete-char ()}}{119}
\entry {\code {forward-char (C-f)}}{117}
\entry {\code {forward-search-history (C-s)}}{118}
\entry {\code {forward-word (M-f)}}{117}
\initial {G}
\entry {\code {glob-complete-word (M-g)}}{124}
\entry {\code {glob-expand-word (C-x *)}}{124}
\entry {\code {glob-list-expansions (C-x g)}}{125}
\entry {\code {glob-complete-word (M-g)}}{125}
\entry {\code {glob-expand-word (C-x *)}}{125}
\entry {\code {glob-list-expansions (C-x g)}}{126}
\initial {H}
\entry {\code {history-and-alias-expand-line ()}}{125}
\entry {\code {history-expand-line (M-^)}}{125}
\entry {\code {history-search-backward ()}}{117}
\entry {\code {history-search-forward ()}}{117}
\entry {\code {history-substr-search-backward ()}}{118}
\entry {\code {history-substr-search-forward ()}}{117}
\entry {\code {history-and-alias-expand-line ()}}{126}
\entry {\code {history-expand-line (M-^)}}{126}
\entry {\code {history-search-backward ()}}{118}
\entry {\code {history-search-forward ()}}{118}
\entry {\code {history-substr-search-backward ()}}{119}
\entry {\code {history-substr-search-forward ()}}{118}
\initial {I}
\entry {\code {insert-comment (M-#)}}{124}
\entry {\code {insert-completions (M-*)}}{121}
\entry {\code {insert-last-argument (M-. or M-_)}}{125}
\entry {\code {insert-comment (M-#)}}{125}
\entry {\code {insert-completions (M-*)}}{122}
\entry {\code {insert-last-argument (M-. or M-_)}}{126}
\initial {K}
\entry {\code {kill-line (C-k)}}{119}
\entry {\code {kill-region ()}}{120}
\entry {\code {kill-whole-line ()}}{120}
\entry {\code {kill-word (M-d)}}{120}
\entry {\code {kill-line (C-k)}}{120}
\entry {\code {kill-region ()}}{121}
\entry {\code {kill-whole-line ()}}{121}
\entry {\code {kill-word (M-d)}}{121}
\initial {M}
\entry {\code {magic-space ()}}{125}
\entry {\code {menu-complete ()}}{121}
\entry {\code {menu-complete-backward ()}}{121}
\entry {\code {magic-space ()}}{126}
\entry {\code {menu-complete ()}}{122}
\entry {\code {menu-complete-backward ()}}{122}
\initial {N}
\entry {\code {next-history (C-n)}}{117}
\entry {\code {non-incremental-forward-search-history (M-n)}}{117}
\entry {\code {non-incremental-reverse-search-history (M-p)}}{117}
\entry {\code {next-history (C-n)}}{118}
\entry {\code {non-incremental-forward-search-history (M-n)}}{118}
\entry {\code {non-incremental-reverse-search-history (M-p)}}{118}
\initial {O}
\entry {\code {operate-and-get-next (C-o)}}{125}
\entry {\code {overwrite-mode ()}}{119}
\entry {\code {operate-and-get-next (C-o)}}{126}
\entry {\code {overwrite-mode ()}}{120}
\initial {P}
\entry {\code {possible-command-completions (C-x !)}}{122}
\entry {\code {possible-completions (M-?)}}{121}
\entry {\code {possible-filename-completions (C-x /)}}{122}
\entry {\code {possible-hostname-completions (C-x @)}}{122}
\entry {\code {possible-username-completions (C-x ~)}}{122}
\entry {\code {possible-variable-completions (C-x $)}}{122}
\entry {\code {prefix-meta (\key {ESC})}}{123}
\entry {\code {previous-history (C-p)}}{117}
\entry {\code {print-last-kbd-macro ()}}{123}
\entry {\code {possible-command-completions (C-x !)}}{123}
\entry {\code {possible-completions (M-?)}}{122}
\entry {\code {possible-filename-completions (C-x /)}}{123}
\entry {\code {possible-hostname-completions (C-x @)}}{123}
\entry {\code {possible-username-completions (C-x ~)}}{123}
\entry {\code {possible-variable-completions (C-x $)}}{123}
\entry {\code {prefix-meta (\key {ESC})}}{124}
\entry {\code {previous-history (C-p)}}{118}
\entry {\code {print-last-kbd-macro ()}}{124}
\initial {Q}
\entry {\code {quoted-insert (C-q or C-v)}}{118}
\entry {\code {quoted-insert (C-q or C-v)}}{119}
\initial {R}
\entry {\code {re-read-init-file (C-x C-r)}}{123}
\entry {\code {redraw-current-line ()}}{116}
\entry {\code {reverse-search-history (C-r)}}{117}
\entry {\code {revert-line (M-r)}}{123}
\entry {\code {re-read-init-file (C-x C-r)}}{124}
\entry {\code {redraw-current-line ()}}{117}
\entry {\code {reverse-search-history (C-r)}}{118}
\entry {\code {revert-line (M-r)}}{124}
\initial {S}
\entry {\code {self-insert (a, b, A, 1, !, \dots {})}}{119}
\entry {\code {set-mark (C-@)}}{123}
\entry {\code {shell-backward-kill-word ()}}{120}
\entry {\code {shell-backward-word ()}}{116}
\entry {\code {shell-expand-line (M-C-e)}}{125}
\entry {\code {shell-forward-word ()}}{116}
\entry {\code {shell-kill-word ()}}{120}
\entry {\code {skip-csi-sequence ()}}{124}
\entry {\code {start-kbd-macro (C-x ()}}{123}
\entry {\code {self-insert (a, b, A, 1, !, \dots {})}}{120}
\entry {\code {set-mark (C-@)}}{124}
\entry {\code {shell-backward-kill-word ()}}{121}
\entry {\code {shell-backward-word ()}}{117}
\entry {\code {shell-expand-line (M-C-e)}}{126}
\entry {\code {shell-forward-word ()}}{117}
\entry {\code {shell-kill-word ()}}{121}
\entry {\code {skip-csi-sequence ()}}{125}
\entry {\code {start-kbd-macro (C-x ()}}{124}
\initial {T}
\entry {\code {tilde-expand (M-&)}}{123}
\entry {\code {transpose-chars (C-t)}}{119}
\entry {\code {transpose-words (M-t)}}{119}
\entry {\code {tilde-expand (M-&)}}{124}
\entry {\code {transpose-chars (C-t)}}{120}
\entry {\code {transpose-words (M-t)}}{120}
\initial {U}
\entry {\code {undo (C-_ or C-x C-u)}}{123}
\entry {\code {universal-argument ()}}{121}
\entry {\code {unix-filename-rubout ()}}{120}
\entry {\code {unix-line-discard (C-u)}}{120}
\entry {\code {unix-word-rubout (C-w)}}{120}
\entry {\code {upcase-word (M-u)}}{119}
\entry {\code {undo (C-_ or C-x C-u)}}{124}
\entry {\code {universal-argument ()}}{122}
\entry {\code {unix-filename-rubout ()}}{121}
\entry {\code {unix-line-discard (C-u)}}{121}
\entry {\code {unix-word-rubout (C-w)}}{121}
\entry {\code {upcase-word (M-u)}}{120}
\initial {Y}
\entry {\code {yank (C-y)}}{120}
\entry {\code {yank-last-arg (M-. or M-_)}}{118}
\entry {\code {yank-nth-arg (M-C-y)}}{118}
\entry {\code {yank-pop (M-y)}}{120}
\entry {\code {yank (C-y)}}{121}
\entry {\code {yank-last-arg (M-. or M-_)}}{119}
\entry {\code {yank-nth-arg (M-C-y)}}{119}
\entry {\code {yank-pop (M-y)}}{121}
doc/bashref.html
+911 -895
View File
File diff suppressed because it is too large Load Diff
doc/bashref.info
+283 -277
View File
@@ -1,10 +1,10 @@
This is bashref.info, produced by makeinfo version 5.2 from
This is bashref.info, produced by makeinfo version 6.0 from
bashref.texi.
This text is a brief description of the features that are present in the
Bash shell (version 4.4, 11 June 2015).
Bash shell (version 4.4, 15 August 2015).
This is Edition 4.4, last updated 11 June 2015, of 'The GNU Bash
This is Edition 4.4, last updated 15 August 2015, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Copyright (C) 1988-2014 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 4.4, 11 June 2015). The Bash home page is
Bash shell (version 4.4, 15 August 2015). The Bash home page is
<http://www.gnu.org/software/bash/>.
This is Edition 4.4, last updated 11 June 2015, of 'The GNU Bash
This is Edition 4.4, last updated 15 August 2015, of 'The GNU Bash
Reference Manual', for 'Bash', Version 4.4.
Bash contains features that appear in other popular shells, and some
@@ -199,8 +199,8 @@ These definitions are used throughout the remainder of this manual.
'metacharacter'
A character that, when unquoted, separates words. A metacharacter
is a 'blank' or one of the following characters: '|', '&', ';',
'(', ')', '<', or '>'.
is a 'space', 'tab', 'newline', or one of the following characters:
'|', '&', ';', '(', ')', '<', or '>'.
'name'
A 'word' consisting solely of letters, numbers, and underscores,
@@ -2765,11 +2765,11 @@ Completion Builtins::).
Unless otherwise noted, each builtin command documented as accepting
options preceded by '-' accepts '--' to signify the end of the options.
The ':', 'true', 'false', and 'test' builtins do not accept options and
do not treat '--' specially. The 'exit', 'logout', 'break', 'continue',
'let', and 'shift' builtins accept and process arguments beginning with
'-' without requiring '--'. Other builtins that accept arguments but
are not specified as accepting options interpret arguments beginning
with '-' as invalid options and require '--' to prevent this
do not treat '--' specially. The 'exit', 'logout', 'return', 'break',
'continue', 'let', and 'shift' builtins accept and process arguments
beginning with '-' without requiring '--'. Other builtins that accept
arguments but are not specified as accepting options interpret arguments
beginning with '-' as invalid options and require '--' to prevent this
interpretation.

@@ -3368,8 +3368,8 @@ standard.
The '-F' option inhibits the display of function definitions; only
the function name and attributes are printed. If the 'extdebug'
shell option is enabled using 'shopt' (*note The Shopt Builtin::),
the source file name and line number where the function is defined
are displayed as well. '-F' implies '-f'.
the source file name and line number where each NAME is defined are
displayed as well. '-F' implies '-f'.
The '-g' option forces variables to be created or modified at the
global scope, even when 'declare' is executed in a shell function.
@@ -4737,6 +4737,10 @@ Variables::).
'${BASH_LINENO[$i-1]}' if referenced within another shell
function). Use 'LINENO' to obtain the current line number.
'BASH_LOADABLES_PATH'
A colon-separated list of directories in which the shell looks for
dynamically loadable builtins specified by the 'enable' command.
'BASH_REMATCH'
An array variable whose members are assigned by the '=~' binary
operator to the '[[' conditional command (*note Conditional
@@ -4912,9 +4916,8 @@ Variables::).
the name of any currently-executing shell function. The
bottom-most element (the one with the highest index) is '"main"'.
This variable exists only when a shell function is executing.
Assignments to 'FUNCNAME' have no effect and return an error
status. If 'FUNCNAME' is unset, it loses its special properties,
even if it is subsequently reset.
Assignments to 'FUNCNAME' have no effect. If 'FUNCNAME' is unset,
it loses its special properties, even if it is subsequently reset.
This variable can be used with 'BASH_LINENO' and 'BASH_SOURCE'.
Each element of 'FUNCNAME' has corresponding elements in
@@ -4937,9 +4940,9 @@ Variables::).
'GROUPS'
An array variable containing the list of groups of which the
current user is a member. Assignments to 'GROUPS' have no effect
and return an error status. If 'GROUPS' is unset, it loses its
special properties, even if it is subsequently reset.
current user is a member. Assignments to 'GROUPS' have no effect.
If 'GROUPS' is unset, it loses its special properties, even if it
is subsequently reset.
'histchars'
Up to three characters which control history expansion, quick
@@ -6083,7 +6086,8 @@ The directory stack is a list of recently-visited directories. The
'pushd' builtin adds directories to the stack as it changes the current
directory, and the 'popd' builtin removes specified directories from the
stack and changes the current directory to the directory removed. The
'dirs' builtin displays the contents of the directory stack.
'dirs' builtin displays the contents of the directory stack. The
current directory is always the "top" of the directory stack.
The contents of the directory stack are also visible as the value of
the 'DIRSTACK' shell variable.
@@ -6099,7 +6103,8 @@ File: bashref.info, Node: Directory Stack Builtins, Up: The Directory Stack
Display the list of currently remembered directories. Directories
are added to the list with the 'pushd' command; the 'popd' command
removes directories from the list.
removes directories from the list. The current directory is always
the first directory in the stack.
'-c'
Clears the directory stack by deleting all of the elements.
@@ -6124,12 +6129,10 @@ File: bashref.info, Node: Directory Stack Builtins, Up: The Directory Stack
'popd'
popd [-n] [+N | -N]
Remove the top entry from the directory stack, and 'cd' to the new
top directory. When no arguments are given, 'popd' removes the top
directory from the stack and performs a 'cd' to the new top
directory. The elements are numbered from 0 starting at the first
directory listed with 'dirs'; that is, 'popd' is equivalent to
'popd +0'.
When no arguments are given, 'popd' removes the top directory from
the stack and performs a 'cd' to the new top directory. The
elements are numbered from 0 starting at the first directory listed
with 'dirs'; that is, 'popd' is equivalent to 'popd +0'.
'-n'
Suppresses the normal change of directory when removing
@@ -6147,11 +6150,11 @@ File: bashref.info, Node: Directory Stack Builtins, Up: The Directory Stack
Save the current directory on the top of the directory stack and
then 'cd' to DIR. With no arguments, 'pushd' exchanges the top two
directories.
directories and makes the new top the current directory.
'-n'
Suppresses the normal change of directory when adding
directories to the stack, so that only the stack is
Suppresses the normal change of directory when rotating or
adding directories to the stack, so that only the stack is
manipulated.
'+N'
Brings the Nth directory (counting from the left of the list
@@ -6162,9 +6165,9 @@ File: bashref.info, Node: Directory Stack Builtins, Up: The Directory Stack
printed by 'dirs', starting with zero) to the top of the list
by rotating the stack.
'DIR'
Makes the current working directory be the top of the stack,
making it the new current directory as if it had been supplied
as an argument to the 'cd' builtin.
Makes DIR be the top of the stack, making it the new current
directory as if it had been supplied as an argument to the
'cd' builtin.

File: bashref.info, Node: Controlling the Prompt, Next: The Restricted Shell, Prev: The Directory Stack, Up: Bash Features
@@ -6356,143 +6359,145 @@ startup files.
14. Non-interactive shells exit if a syntax error in an arithmetic
expansion results in an invalid expression.
15. Non-interactive shells exit if there is a syntax error in a script
15. Non-interactive shells exit on word expansion errors.
16. 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.
16. Redirection operators do not perform filename expansion on the
17. Redirection operators do not perform filename expansion on the
word in the redirection unless the shell is interactive.
17. Redirection operators do not perform word splitting on the word in
18. Redirection operators do not perform word splitting on the word in
the redirection.
18. Function names must be valid shell 'name's. That is, they may not
19. 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.
19. Function names may not be the same as one of the POSIX special
20. Function names may not be the same as one of the POSIX special
builtins.
20. POSIX special builtins are found before shell functions during
21. POSIX special builtins are found before shell functions during
command lookup.
21. Literal tildes that appear as the first character in elements of
22. Literal tildes that appear as the first character in elements of
the 'PATH' variable are not expanded as described above under *note
Tilde Expansion::.
22. The 'time' reserved word may be used by itself as a command. When
23. 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.
23. When parsing and expanding a ${...} expansion that appears within
24. 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.
24. The parser does not recognize 'time' as a reserved word if the
25. The parser does not recognize 'time' as a reserved word if the
next token begins with a '-'.
25. If a POSIX special builtin returns an error status, a
26. 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.
26. A non-interactive shell exits with an error status if a variable
27. 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.
27. A non-interactive shell exits with an error status if a variable
28. 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.
28. A non-interactive shell exits with an error status if the
29. 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.
29. Process substitution is not available.
30. Process substitution is not available.
30. While variable indirection is available, it may not be applied to
31. While variable indirection is available, it may not be applied to
the '#' and '?' special parameters.
31. Assignment statements preceding POSIX special builtins persist in
32. Assignment statements preceding POSIX special builtins persist in
the shell environment after the builtin completes.
32. Assignment statements preceding shell function calls persist in
33. Assignment statements preceding shell function calls persist in
the shell environment after the function returns, as if a POSIX
special builtin command had been executed.
33. The 'export' and 'readonly' builtin commands display their output
34. The 'export' and 'readonly' builtin commands display their output
in the format required by POSIX.
34. The 'trap' builtin displays signal names without the leading
35. The 'trap' builtin displays signal names without the leading
'SIG'.
35. The 'trap' builtin doesn't check the first argument for a possible
36. 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.
36. The '.' and 'source' builtins do not search the current directory
37. The '.' and 'source' builtins do not search the current directory
for the filename argument if it is not found by searching 'PATH'.
37. Subshells spawned to execute command substitutions inherit the
38. Subshells spawned to execute command substitutions inherit the
value of the '-e' option from the parent shell. When not in POSIX
mode, Bash clears the '-e' option in such subshells.
38. Alias expansion is always enabled, even in non-interactive shells.
39. Alias expansion is always enabled, even in non-interactive shells.
39. When the 'alias' builtin displays alias definitions, it does not
40. When the 'alias' builtin displays alias definitions, it does not
display them with a leading 'alias ' unless the '-p' option is
supplied.
40. When the 'set' builtin is invoked without options, it does not
41. When the 'set' builtin is invoked without options, it does not
display shell function names and definitions.
41. When the 'set' builtin is invoked without options, it displays
42. 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.
42. When the 'cd' builtin is invoked in LOGICAL mode, and the pathname
43. 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.
43. The 'pwd' builtin verifies that the value it prints is the same as
44. 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.
44. When listing the history, the 'fc' builtin does not include an
45. When listing the history, the 'fc' builtin does not include an
indication of whether or not a history entry has been modified.
45. The default editor used by 'fc' is 'ed'.
46. The default editor used by 'fc' is 'ed'.
46. The 'type' and 'command' builtins will not report a non-executable
47. 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'.
47. The 'vi' editing mode will invoke the 'vi' editor directly when
48. The 'vi' editing mode will invoke the 'vi' editor directly when
the 'v' command is run, instead of checking '$VISUAL' and
'$EDITOR'.
48. When the 'xpg_echo' option is enabled, Bash does not attempt to
49. 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.
49. The 'ulimit' builtin uses a block size of 512 bytes for the '-c'
50. The 'ulimit' builtin uses a block size of 512 bytes for the '-c'
and '-f' options.
50. The arrival of 'SIGCHLD' when a trap is set on 'SIGCHLD' does not
51. 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.
51. The 'read' builtin may be interrupted by a signal for which a trap
52. 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.
@@ -10594,10 +10599,10 @@ D.1 Index of Shell Builtin Commands
* logout: Bash Builtins. (line 363)
* mapfile: Bash Builtins. (line 368)
* popd: Directory Stack Builtins.
(line 34)
(line 35)
* printf: Bash Builtins. (line 413)
* pushd: Directory Stack Builtins.
(line 54)
(line 53)
* pwd: Bourne Shell Builtins.
(line 205)
* read: Bash Builtins. (line 458)
@@ -10713,12 +10718,13 @@ D.3 Parameter and Variable Index
* BASH_ENV: Bash Variables. (line 84)
* BASH_EXECUTION_STRING: Bash Variables. (line 90)
* BASH_LINENO: Bash Variables. (line 93)
* BASH_REMATCH: Bash Variables. (line 101)
* BASH_SOURCE: Bash Variables. (line 109)
* BASH_SUBSHELL: Bash Variables. (line 116)
* BASH_VERSINFO: Bash Variables. (line 121)
* BASH_VERSION: Bash Variables. (line 144)
* BASH_XTRACEFD: Bash Variables. (line 147)
* BASH_LOADABLES_PATH: Bash Variables. (line 101)
* BASH_REMATCH: Bash Variables. (line 105)
* BASH_SOURCE: Bash Variables. (line 113)
* BASH_SUBSHELL: Bash Variables. (line 120)
* BASH_VERSINFO: Bash Variables. (line 125)
* BASH_VERSION: Bash Variables. (line 148)
* BASH_XTRACEFD: Bash Variables. (line 151)
* bell-style: Readline Init File Syntax.
(line 38)
* bind-tty-special-chars: Readline Init File Syntax.
@@ -10727,12 +10733,12 @@ D.3 Parameter and Variable Index
(line 50)
* CDPATH: Bourne Shell Variables.
(line 9)
* CHILD_MAX: Bash Variables. (line 158)
* CHILD_MAX: Bash Variables. (line 162)
* colored-completion-prefix: Readline Init File Syntax.
(line 55)
* colored-stats: Readline Init File Syntax.
(line 62)
* COLUMNS: Bash Variables. (line 165)
* COLUMNS: Bash Variables. (line 169)
* comment-begin: Readline Init File Syntax.
(line 68)
* completion-display-width: Readline Init File Syntax.
@@ -10745,87 +10751,87 @@ D.3 Parameter and Variable Index
(line 91)
* completion-query-items: Readline Init File Syntax.
(line 98)
* COMPREPLY: Bash Variables. (line 217)
* COMP_CWORD: Bash Variables. (line 171)
* COMP_KEY: Bash Variables. (line 200)
* COMP_LINE: Bash Variables. (line 177)
* COMP_POINT: Bash Variables. (line 182)
* COMP_TYPE: Bash Variables. (line 190)
* COMP_WORDBREAKS: Bash Variables. (line 204)
* COMP_WORDS: Bash Variables. (line 210)
* COMPREPLY: Bash Variables. (line 221)
* COMP_CWORD: Bash Variables. (line 175)
* COMP_KEY: Bash Variables. (line 204)
* COMP_LINE: Bash Variables. (line 181)
* COMP_POINT: Bash Variables. (line 186)
* COMP_TYPE: Bash Variables. (line 194)
* COMP_WORDBREAKS: Bash Variables. (line 208)
* COMP_WORDS: Bash Variables. (line 214)
* convert-meta: Readline Init File Syntax.
(line 108)
* COPROC: Bash Variables. (line 223)
* DIRSTACK: Bash Variables. (line 227)
* COPROC: Bash Variables. (line 227)
* DIRSTACK: Bash Variables. (line 231)
* disable-completion: Readline Init File Syntax.
(line 114)
* echo-control-characters: Readline Init File Syntax.
(line 135)
* editing-mode: Readline Init File Syntax.
(line 119)
* EMACS: Bash Variables. (line 237)
* EMACS: Bash Variables. (line 241)
* emacs-mode-string: Readline Init File Syntax.
(line 125)
* enable-bracketed-paste: Readline Init File Syntax.
(line 140)
* enable-keypad: Readline Init File Syntax.
(line 148)
* ENV: Bash Variables. (line 242)
* EUID: Bash Variables. (line 246)
* EXECIGNORE: Bash Variables. (line 250)
* ENV: Bash Variables. (line 246)
* EUID: Bash Variables. (line 250)
* EXECIGNORE: Bash Variables. (line 254)
* expand-tilde: Readline Init File Syntax.
(line 159)
* FCEDIT: Bash Variables. (line 260)
* FIGNORE: Bash Variables. (line 264)
* FUNCNAME: Bash Variables. (line 270)
* FUNCNEST: Bash Variables. (line 288)
* GLOBIGNORE: Bash Variables. (line 293)
* GROUPS: Bash Variables. (line 299)
* histchars: Bash Variables. (line 305)
* HISTCMD: Bash Variables. (line 320)
* HISTCONTROL: Bash Variables. (line 325)
* HISTFILE: Bash Variables. (line 341)
* HISTFILESIZE: Bash Variables. (line 345)
* HISTIGNORE: Bash Variables. (line 356)
* FCEDIT: Bash Variables. (line 264)
* FIGNORE: Bash Variables. (line 268)
* FUNCNAME: Bash Variables. (line 274)
* FUNCNEST: Bash Variables. (line 291)
* GLOBIGNORE: Bash Variables. (line 296)
* GROUPS: Bash Variables. (line 302)
* histchars: Bash Variables. (line 308)
* HISTCMD: Bash Variables. (line 323)
* HISTCONTROL: Bash Variables. (line 328)
* HISTFILE: Bash Variables. (line 344)
* HISTFILESIZE: Bash Variables. (line 348)
* HISTIGNORE: Bash Variables. (line 359)
* history-preserve-point: Readline Init File Syntax.
(line 163)
* history-size: Readline Init File Syntax.
(line 169)
* HISTSIZE: Bash Variables. (line 375)
* HISTTIMEFORMAT: Bash Variables. (line 382)
* HISTSIZE: Bash Variables. (line 378)
* HISTTIMEFORMAT: Bash Variables. (line 385)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 176)
* HOSTFILE: Bash Variables. (line 390)
* HOSTNAME: Bash Variables. (line 401)
* HOSTTYPE: Bash Variables. (line 404)
* HOSTFILE: Bash Variables. (line 393)
* HOSTNAME: Bash Variables. (line 404)
* HOSTTYPE: Bash Variables. (line 407)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 407)
* IGNOREEOF: Bash Variables. (line 410)
* input-meta: Readline Init File Syntax.
(line 183)
* INPUTRC: Bash Variables. (line 417)
* INPUTRC: Bash Variables. (line 420)
* isearch-terminators: Readline Init File Syntax.
(line 190)
* keymap: Readline Init File Syntax.
(line 197)
* LANG: Bash Variables. (line 421)
* LC_ALL: Bash Variables. (line 425)
* LC_COLLATE: Bash Variables. (line 429)
* LC_CTYPE: Bash Variables. (line 436)
* LANG: Bash Variables. (line 424)
* LC_ALL: Bash Variables. (line 428)
* LC_COLLATE: Bash Variables. (line 432)
* LC_CTYPE: Bash Variables. (line 439)
* LC_MESSAGES: Locale Translation. (line 11)
* LC_MESSAGES <1>: Bash Variables. (line 441)
* LC_NUMERIC: Bash Variables. (line 445)
* LINENO: Bash Variables. (line 449)
* LINES: Bash Variables. (line 453)
* MACHTYPE: Bash Variables. (line 459)
* LC_MESSAGES <1>: Bash Variables. (line 444)
* LC_NUMERIC: Bash Variables. (line 448)
* LINENO: Bash Variables. (line 452)
* LINES: Bash Variables. (line 456)
* MACHTYPE: Bash Variables. (line 462)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 463)
* MAILCHECK: Bash Variables. (line 466)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 471)
* MAPFILE: Bash Variables. (line 474)
* mark-modified-lines: Readline Init File Syntax.
(line 226)
* mark-symlinked-directories: Readline Init File Syntax.
@@ -10836,41 +10842,41 @@ D.3 Parameter and Variable Index
(line 243)
* meta-flag: Readline Init File Syntax.
(line 183)
* OLDPWD: Bash Variables. (line 475)
* OLDPWD: Bash Variables. (line 478)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 478)
* OPTERR: Bash Variables. (line 481)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 482)
* OSTYPE: Bash Variables. (line 485)
* output-meta: Readline Init File Syntax.
(line 248)
* page-completions: Readline Init File Syntax.
(line 253)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 485)
* POSIXLY_CORRECT: Bash Variables. (line 490)
* PPID: Bash Variables. (line 499)
* PROMPT_COMMAND: Bash Variables. (line 503)
* PROMPT_DIRTRIM: Bash Variables. (line 507)
* PIPESTATUS: Bash Variables. (line 488)
* POSIXLY_CORRECT: Bash Variables. (line 493)
* PPID: Bash Variables. (line 502)
* PROMPT_COMMAND: Bash Variables. (line 506)
* PROMPT_DIRTRIM: Bash Variables. (line 510)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 513)
* PS4: Bash Variables. (line 518)
* PWD: Bash Variables. (line 524)
* RANDOM: Bash Variables. (line 527)
* READLINE_LINE: Bash Variables. (line 532)
* READLINE_POINT: Bash Variables. (line 536)
* REPLY: Bash Variables. (line 540)
* PS3: Bash Variables. (line 516)
* PS4: Bash Variables. (line 521)
* PWD: Bash Variables. (line 527)
* RANDOM: Bash Variables. (line 530)
* READLINE_LINE: Bash Variables. (line 535)
* READLINE_POINT: Bash Variables. (line 539)
* REPLY: Bash Variables. (line 543)
* revert-all-at-newline: Readline Init File Syntax.
(line 263)
* SECONDS: Bash Variables. (line 543)
* SHELL: Bash Variables. (line 549)
* SHELLOPTS: Bash Variables. (line 554)
* SHLVL: Bash Variables. (line 563)
* SECONDS: Bash Variables. (line 546)
* SHELL: Bash Variables. (line 552)
* SHELLOPTS: Bash Variables. (line 557)
* SHLVL: Bash Variables. (line 566)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 269)
* show-all-if-unmodified: Readline Init File Syntax.
@@ -10881,10 +10887,10 @@ D.3 Parameter and Variable Index
(line 290)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 568)
* TMOUT: Bash Variables. (line 606)
* TMPDIR: Bash Variables. (line 618)
* UID: Bash Variables. (line 622)
* TIMEFORMAT: Bash Variables. (line 571)
* TMOUT: Bash Variables. (line 609)
* TMPDIR: Bash Variables. (line 621)
* UID: Bash Variables. (line 625)
* vi-cmd-mode-string: Readline Init File Syntax.
(line 303)
* vi-ins-mode-string: Readline Init File Syntax.
@@ -11252,134 +11258,134 @@ D.5 Concept Index

Tag Table:
Node: Top889
Node: Introduction2801
Node: What is Bash?3017
Node: What is a shell?4131
Node: Definitions6669
Node: Basic Shell Features9588
Node: Shell Syntax10807
Node: Shell Operation11833
Node: Quoting13126
Node: Escape Character14426
Node: Single Quotes14911
Node: Double Quotes15259
Node: ANSI-C Quoting16384
Node: Locale Translation17613
Node: Comments18509
Node: Shell Commands19127
Node: Simple Commands19999
Node: Pipelines20630
Node: Lists23373
Node: Compound Commands25102
Node: Looping Constructs26105
Node: Conditional Constructs28568
Node: Command Grouping39489
Node: Coprocesses40968
Node: GNU Parallel42800
Node: Shell Functions46773
Node: Shell Parameters51979
Node: Positional Parameters56381
Node: Special Parameters57281
Node: Shell Expansions60618
Node: Brace Expansion62555
Node: Tilde Expansion65336
Node: Shell Parameter Expansion67684
Node: Command Substitution81791
Node: Arithmetic Expansion83121
Node: Process Substitution84053
Node: Word Splitting85097
Node: Filename Expansion86745
Node: Pattern Matching89029
Node: Quote Removal92727
Node: Redirections93022
Node: Executing Commands102245
Node: Simple Command Expansion102915
Node: Command Search and Execution104845
Node: Command Execution Environment107181
Node: Environment110165
Node: Exit Status111824
Node: Signals113494
Node: Shell Scripts115461
Node: Shell Builtin Commands117976
Node: Bourne Shell Builtins120000
Node: Bash Builtins140602
Node: Modifying Shell Behavior169196
Node: The Set Builtin169541
Node: The Shopt Builtin179954
Node: Special Builtins194583
Node: Shell Variables195562
Node: Bourne Shell Variables195999
Node: Bash Variables198030
Node: Bash Features225430
Node: Invoking Bash226329
Node: Bash Startup Files232278
Node: Interactive Shells237381
Node: What is an Interactive Shell?237791
Node: Is this Shell Interactive?238440
Node: Interactive Shell Behavior239255
Node: Bash Conditional Expressions242554
Node: Shell Arithmetic246555
Node: Aliases249332
Node: Arrays251880
Node: The Directory Stack256964
Node: Directory Stack Builtins257681
Node: Controlling the Prompt260640
Node: The Restricted Shell263386
Node: Bash POSIX Mode265211
Node: Job Control274805
Node: Job Control Basics275265
Node: Job Control Builtins279984
Node: Job Control Variables284455
Node: Command Line Editing285611
Node: Introduction and Notation287282
Node: Readline Interaction288905
Node: Readline Bare Essentials290096
Node: Readline Movement Commands291879
Node: Readline Killing Commands292839
Node: Readline Arguments294757
Node: Searching295801
Node: Readline Init File297987
Node: Readline Init File Syntax299134
Node: Conditional Init Constructs318859
Node: Sample Init File321384
Node: Bindable Readline Commands324501
Node: Commands For Moving325705
Node: Commands For History326848
Node: Commands For Text331137
Node: Commands For Killing334526
Node: Numeric Arguments337007
Node: Commands For Completion338146
Node: Keyboard Macros342337
Node: Miscellaneous Commands343024
Node: Readline vi Mode348828
Node: Programmable Completion349735
Node: Programmable Completion Builtins357196
Node: A Programmable Completion Example367082
Node: Using History Interactively372334
Node: Bash History Facilities373018
Node: Bash History Builtins376017
Node: History Interaction380014
Node: Event Designators382720
Node: Word Designators383939
Node: Modifiers385576
Node: Installing Bash386978
Node: Basic Installation388115
Node: Compilers and Options390806
Node: Compiling For Multiple Architectures391547
Node: Installation Names393210
Node: Specifying the System Type394028
Node: Sharing Defaults394744
Node: Operation Controls395417
Node: Optional Features396375
Node: Reporting Bugs406632
Node: Major Differences From The Bourne Shell407826
Node: GNU Free Documentation License424678
Node: Indexes449855
Node: Builtin Index450309
Node: Reserved Word Index457136
Node: Variable Index459584
Node: Function Index474824
Node: Concept Index488044
Node: Top893
Node: Introduction2809
Node: What is Bash?3025
Node: What is a shell?4139
Node: Definitions6677
Node: Basic Shell Features9615
Node: Shell Syntax10834
Node: Shell Operation11860
Node: Quoting13153
Node: Escape Character14453
Node: Single Quotes14938
Node: Double Quotes15286
Node: ANSI-C Quoting16411
Node: Locale Translation17640
Node: Comments18536
Node: Shell Commands19154
Node: Simple Commands20026
Node: Pipelines20657
Node: Lists23400
Node: Compound Commands25129
Node: Looping Constructs26132
Node: Conditional Constructs28595
Node: Command Grouping39516
Node: Coprocesses40995
Node: GNU Parallel42827
Node: Shell Functions46800
Node: Shell Parameters52006
Node: Positional Parameters56408
Node: Special Parameters57308
Node: Shell Expansions60645
Node: Brace Expansion62582
Node: Tilde Expansion65363
Node: Shell Parameter Expansion67711
Node: Command Substitution81818
Node: Arithmetic Expansion83148
Node: Process Substitution84080
Node: Word Splitting85124
Node: Filename Expansion86772
Node: Pattern Matching89056
Node: Quote Removal92754
Node: Redirections93049
Node: Executing Commands102272
Node: Simple Command Expansion102942
Node: Command Search and Execution104872
Node: Command Execution Environment107208
Node: Environment110192
Node: Exit Status111851
Node: Signals113521
Node: Shell Scripts115488
Node: Shell Builtin Commands118003
Node: Bourne Shell Builtins120037
Node: Bash Builtins140639
Node: Modifying Shell Behavior169230
Node: The Set Builtin169575
Node: The Shopt Builtin179988
Node: Special Builtins194617
Node: Shell Variables195596
Node: Bourne Shell Variables196033
Node: Bash Variables198064
Node: Bash Features225569
Node: Invoking Bash226468
Node: Bash Startup Files232417
Node: Interactive Shells237520
Node: What is an Interactive Shell?237930
Node: Is this Shell Interactive?238579
Node: Interactive Shell Behavior239394
Node: Bash Conditional Expressions242693
Node: Shell Arithmetic246694
Node: Aliases249471
Node: Arrays252019
Node: The Directory Stack257103
Node: Directory Stack Builtins257887
Node: Controlling the Prompt260855
Node: The Restricted Shell263601
Node: Bash POSIX Mode265426
Node: Job Control275081
Node: Job Control Basics275541
Node: Job Control Builtins280260
Node: Job Control Variables284731
Node: Command Line Editing285887
Node: Introduction and Notation287558
Node: Readline Interaction289181
Node: Readline Bare Essentials290372
Node: Readline Movement Commands292155
Node: Readline Killing Commands293115
Node: Readline Arguments295033
Node: Searching296077
Node: Readline Init File298263
Node: Readline Init File Syntax299410
Node: Conditional Init Constructs319135
Node: Sample Init File321660
Node: Bindable Readline Commands324777
Node: Commands For Moving325981
Node: Commands For History327124
Node: Commands For Text331413
Node: Commands For Killing334802
Node: Numeric Arguments337283
Node: Commands For Completion338422
Node: Keyboard Macros342613
Node: Miscellaneous Commands343300
Node: Readline vi Mode349104
Node: Programmable Completion350011
Node: Programmable Completion Builtins357472
Node: A Programmable Completion Example367358
Node: Using History Interactively372610
Node: Bash History Facilities373294
Node: Bash History Builtins376293
Node: History Interaction380290
Node: Event Designators382996
Node: Word Designators384215
Node: Modifiers385852
Node: Installing Bash387254
Node: Basic Installation388391
Node: Compilers and Options391082
Node: Compiling For Multiple Architectures391823
Node: Installation Names393486
Node: Specifying the System Type394304
Node: Sharing Defaults395020
Node: Operation Controls395693
Node: Optional Features396651
Node: Reporting Bugs406908
Node: Major Differences From The Bourne Shell408102
Node: GNU Free Documentation License424954
Node: Indexes450131
Node: Builtin Index450585
Node: Reserved Word Index457412
Node: Variable Index459860
Node: Function Index475173
Node: Concept Index488393

End Tag Table
doc/bashref.log
+65 -31
View File
@@ -1,10 +1,8 @@
This is pdfTeX, Version 3.14159265-2.6-1.40.15 (TeX Live 2014/MacPorts 2014_9) (preloaded format=etex 2014.11.4) 10 JUL 2015 10:23
This is pdfTeX, Version 3.14159265-2.6-1.40.16 (TeX Live 2015/MacPorts 2015_2) (preloaded format=pdftex 2015.7.15) 18 AUG 2015 16:27
entering extended mode
restricted \write18 enabled.
file:line:error style messages enabled.
%&-line parsing enabled.
**\catcode126=12 \def\normaltilde{~}\catcode126=13 \let~\normaltilde \input /u
sr/homes/chet/src/bash/src/doc/bashref.texi
**/usr/homes/chet/src/bash/src/doc/bashref.texi
(/usr/homes/chet/src/bash/src/doc/bashref.texi (./texinfo.tex
Loading texinfo [version 2013-09-11.11]:
\bindingoffset=\dimen16
@@ -181,11 +179,13 @@ texinfo.tex: doing @include of version.texi
\openout9 = `bashref.rw'.
] [2] (./bashref.toc [-1] [-2] [-3])
[-4] Chapter 1
{/opt/local/var/db/texmf/fonts/map/pdftex/updmap/pdftex.map}] [2] (./bashref.to
c [-1] [-2] [-3]) [-4] (./bashref.toc)
(./bashref.toc) Chapter 1
\openout0 = `bashref.toc'.
Chapter 2 [1] [2] [3] Chapter 3 [4] [5] [6] [7] [8] [9] [10]
Chapter 2 [1] [2] [3] Chapter 3 [4] [5] [6] [7]
[8] [9] [10]
Overfull \hbox (38.26587pt too wide) in paragraph at lines 866--866
[]@texttt case @textttsl word @texttt in [ [(] @textttsl pat-tern @texttt [| @
textttsl pattern@texttt ][]) @textttsl command-list @texttt ;;][] esac[]
@@ -240,7 +240,7 @@ arallel -k traceroute[]
[16] [17] [18] [19] [20] [21] [22] [23] [24] [25] [26] [27] [28] [29] [30]
[31] [32] [33] [34] [35] [36] [37] [38] [39] Chapter 4 [40] [41] [42] [43]
[44] [45] [46] [47] [48] [49] [50] [51] [52] [53]
Overfull \hbox (26.76846pt too wide) in paragraph at lines 4240--4240
Overfull \hbox (26.76846pt too wide) in paragraph at lines 4241--4241
[]@texttt mapfile [-d @textttsl de-lim@texttt ] [-n @textttsl count@texttt ] [
-O @textttsl ori-gin@texttt ] [-s @textttsl count@texttt ] [-t] [-u @textttsl f
d@texttt ][]
@@ -254,7 +254,7 @@ d@texttt ][]
.etc.
[54] [55]
Overfull \hbox (38.26584pt too wide) in paragraph at lines 4442--4442
Overfull \hbox (38.26584pt too wide) in paragraph at lines 4443--4443
[]@texttt readarray [-d @textttsl de-lim@texttt ] [-n @textttsl count@texttt ]
[-O @textttsl ori-gin@texttt ] [-s @textttsl count@texttt ] [-t] [-u @textttsl
fd@texttt ][]
@@ -269,7 +269,7 @@ Overfull \hbox (38.26584pt too wide) in paragraph at lines 4442--4442
[56] [57] [58] [59] [60] [61] [62] [63] [64] [65] [66] [67] Chapter 5 [68]
[69] [70] [71] [72] [73] [74] [75] [76] [77] [78] Chapter 6 [79]
Overfull \hbox (49.43388pt too wide) in paragraph at lines 6102--6102
Overfull \hbox (49.43388pt too wide) in paragraph at lines 6108--6108
[]@texttt bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@t
exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -282,7 +282,7 @@ exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
.etc.
Overfull \hbox (72.42863pt too wide) in paragraph at lines 6103--6103
Overfull \hbox (72.42863pt too wide) in paragraph at lines 6109--6109
[]@texttt bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@texttt
] [-O @textttsl shopt_option@texttt ] -c @textttsl string @texttt [@textttsl ar
-
@@ -296,7 +296,7 @@ Overfull \hbox (72.42863pt too wide) in paragraph at lines 6103--6103
.etc.
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6104--6104
Overfull \hbox (32.18782pt too wide) in paragraph at lines 6110--6110
[]@texttt bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@text
tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -309,12 +309,12 @@ tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
.etc.
[80] [81] [82] [83] [84] [85] [86] [87] [88] [89] [90] [91] [92] [93] [94]
[95] Chapter 7 [96] [97] [98] [99]
[95] Chapter 7 [96] [97] [98] [99] [100]
texinfo.tex: doing @include of rluser.texi
(/usr/homes/chet/src/bash/src/lib/readline/doc/rluser.texi Chapter 8 [100]
[101] [102] [103] [104] [105] [106] [107] [108] [109] [110]
(/usr/homes/chet/src/bash/src/lib/readline/doc/rluser.texi Chapter 8 [101]
[102] [103] [104] [105] [106] [107] [108] [109] [110] [111]
Underfull \hbox (badness 7540) in paragraph at lines 794--800
[]@textrm In the above ex-am-ple, @textttsl C-u[] @textrm is bound to the func
-tion
@@ -340,7 +340,7 @@ e func-tion
.@texttt v
.etc.
[111] [112] [113]
[112] [113] [114]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 989--989
[]@texttt Meta-Control-h: backward-kill-word Text after the function name is i
gnored[]
@@ -353,8 +353,8 @@ gnored[]
.@texttt t
.etc.
[114] [115] [116] [117] [118] [119] [120] [121] [122] [123] [124] [125]
[126] [127] [128] [129] [130] [131]
[115] [116] [117] [118] [119] [120] [121] [122] [123] [124] [125] [126]
[127] [128] [129] [130] [131] [132]
Overfull \hbox (26.43913pt too wide) in paragraph at lines 2225--2225
[] @texttt # Tilde expansion, with side effect of expanding tilde to full p
athname[]
@@ -367,25 +367,59 @@ athname[]
.@penalty 10000
.etc.
[132])
[133])
texinfo.tex: doing @include of hsuser.texi
(/usr/homes/chet/src/bash/src/lib/readline/doc/hsuser.texi Chapter 9
[133] [134] [135] [136] [137]) Chapter 10 [138] [139] [140] [141] [142]
[143] [144] Appendix A [145] Appendix B [146] [147] [148] [149] [150] [151]
Appendix C [152]
[134] [135] [136] [137] [138]) Chapter 10 [139] [140] [141] [142] [143]
[144] [145] Appendix A [146] Appendix B [147] [148] [149] [150] [151] [152]
Appendix C [153]
texinfo.tex: doing @include of fdl.texi
(./fdl.texi [153] [154] [155] [156] [157] [158] [159])
Appendix D [160] (./bashref.bts) [161] (./bashref.rws) (./bashref.vrs [162]
[163]) (./bashref.fns [164] [165]) (./bashref.cps [166] [167]) [168] )
(./fdl.texi [154] [155] [156] [157] [158] [159] [160])
Appendix D [161] (./bashref.bts) [162] (./bashref.rws) (./bashref.vrs [163]
[164]) (./bashref.fns
Overfull \vbox (6.27478pt too high) has occurred while \output is active
\vbox(43.69023+2.0)x207.80492
.\glue(\topskip) 26.12001
.\hbox(9.87999+0.0)x207.80492, glue set 195.57158fil
..\secrm A
..\glue 0.0 plus 1.0fil minus 1.0fil
.\penalty 10000
.\glue 3.46501 plus 1.05006
.\glue 0.0 plus 1.0
.etc.
[165] [166]) (./bashref.cps [167] [168]) [169] )
Here is how much of TeX's memory you used:
2209 strings out of 497120
30319 string characters out of 6207257
78069 words of memory out of 5000000
3358 multiletter control sequences out of 15000+600000
2746 strings out of 497110
37299 string characters out of 6206875
156141 words of memory out of 5000000
3523 multiletter control sequences out of 15000+600000
32896 words of font info for 113 fonts, out of 8000000 for 9000
51 hyphenation exceptions out of 8191
16i,6n,16p,394b,683s stack positions out of 5000i,500n,10000p,200000b,80000s
16i,6n,16p,319b,967s 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></opt/local/share/texmf-texlive/fonts/type
1/public/amsfonts/cm/cmcsc10.pfb></opt/local/share/texmf-texlive/fonts/type1/pu
blic/amsfonts/cm/cmmi10.pfb></opt/local/share/texmf-texlive/fonts/type1/public/
amsfonts/cm/cmmi12.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfo
nts/cm/cmmi9.pfb></opt/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm
/cmr10.pfb></opt/local/share/texmf-texlive/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/type1/public/amsfonts/cm/cmsltt10.pfb></op
t/local/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmsy10.pfb></opt/loc
al/share/texmf-texlive/fonts/type1/public/amsfonts/cm/cmti10.pfb></opt/local/sh
are/texmf-texlive/fonts/type1/public/amsfonts/cm/cmtt10.pfb></opt/local/share/t
exmf-texlive/fonts/type1/public/amsfonts/cm/cmtt12.pfb></opt/local/share/texmf-
texlive/fonts/type1/public/amsfonts/cm/cmtt9.pfb></opt/local/share/texmf-texliv
e/fonts/type1/public/cm-super/sfrm1095.pfb>
Output written on bashref.pdf (175 pages, 729236 bytes).
PDF statistics:
2553 PDF objects out of 2984 (max. 8388607)
2334 compressed objects within 24 object streams
301 named destinations out of 1000 (max. 500000)
1125 words of extra memory for PDF output out of 10000 (max. 10000000)
Output written on bashref.dvi (174 pages, 735276 bytes).
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+1501 -1488
View File
File diff suppressed because it is too large Load Diff
doc/bashref.texi
+1
View File
@@ -7017,6 +7017,7 @@ dirs [-clpv] [+@var{N} | -@var{N}]
Display the list of currently remembered directories. Directories
are added to the list with the @code{pushd} command; the
@code{popd} command removes directories from the list.
The current directory is always the first directory in the stack.
@table @code
@item -c
doc/bashref.toc
+55 -55
View File
@@ -82,58 +82,58 @@
@numsecentry{Controlling the Prompt}{6.9}{Controlling the Prompt}{92}
@numsecentry{The Restricted Shell}{6.10}{The Restricted Shell}{93}
@numsecentry{Bash POSIX Mode}{6.11}{Bash POSIX Mode}{94}
@numchapentry{Job Control}{7}{Job Control}{97}
@numsecentry{Job Control Basics}{7.1}{Job Control Basics}{97}
@numsecentry{Job Control Builtins}{7.2}{Job Control Builtins}{98}
@numsecentry{Job Control Variables}{7.3}{Job Control Variables}{100}
@numchapentry{Command Line Editing}{8}{Command Line Editing}{101}
@numsecentry{Introduction to Line Editing}{8.1}{Introduction and Notation}{101}
@numsecentry{Readline Interaction}{8.2}{Readline Interaction}{101}
@numsubsecentry{Readline Bare Essentials}{8.2.1}{Readline Bare Essentials}{102}
@numsubsecentry{Readline Movement Commands}{8.2.2}{Readline Movement Commands}{102}
@numsubsecentry{Readline Killing Commands}{8.2.3}{Readline Killing Commands}{103}
@numsubsecentry{Readline Arguments}{8.2.4}{Readline Arguments}{103}
@numsubsecentry{Searching for Commands in the History}{8.2.5}{Searching}{103}
@numsecentry{Readline Init File}{8.3}{Readline Init File}{104}
@numsubsecentry{Readline Init File Syntax}{8.3.1}{Readline Init File Syntax}{104}
@numsubsecentry{Conditional Init Constructs}{8.3.2}{Conditional Init Constructs}{112}
@numsubsecentry{Sample Init File}{8.3.3}{Sample Init File}{113}
@numsecentry{Bindable Readline Commands}{8.4}{Bindable Readline Commands}{116}
@numsubsecentry{Commands For Moving}{8.4.1}{Commands For Moving}{116}
@numsubsecentry{Commands For Manipulating The History}{8.4.2}{Commands For History}{117}
@numsubsecentry{Commands For Changing Text}{8.4.3}{Commands For Text}{118}
@numsubsecentry{Killing And Yanking}{8.4.4}{Commands For Killing}{119}
@numsubsecentry{Specifying Numeric Arguments}{8.4.5}{Numeric Arguments}{121}
@numsubsecentry{Letting Readline Type For You}{8.4.6}{Commands For Completion}{121}
@numsubsecentry{Keyboard Macros}{8.4.7}{Keyboard Macros}{123}
@numsubsecentry{Some Miscellaneous Commands}{8.4.8}{Miscellaneous Commands}{123}
@numsecentry{Readline vi Mode}{8.5}{Readline vi Mode}{125}
@numsecentry{Programmable Completion}{8.6}{Programmable Completion}{126}
@numsecentry{Programmable Completion Builtins}{8.7}{Programmable Completion Builtins}{128}
@numsecentry{A Programmable Completion Example}{8.8}{A Programmable Completion Example}{131}
@numchapentry{Using History Interactively}{9}{Using History Interactively}{134}
@numsecentry{Bash History Facilities}{9.1}{Bash History Facilities}{134}
@numsecentry{Bash History Builtins}{9.2}{Bash History Builtins}{134}
@numsecentry{History Expansion}{9.3}{History Interaction}{136}
@numsubsecentry{Event Designators}{9.3.1}{Event Designators}{136}
@numsubsecentry{Word Designators}{9.3.2}{Word Designators}{137}
@numsubsecentry{Modifiers}{9.3.3}{Modifiers}{138}
@numchapentry{Installing Bash}{10}{Installing Bash}{139}
@numsecentry{Basic Installation}{10.1}{Basic Installation}{139}
@numsecentry{Compilers and Options}{10.2}{Compilers and Options}{140}
@numsecentry{Compiling For Multiple Architectures}{10.3}{Compiling For Multiple Architectures}{140}
@numsecentry{Installation Names}{10.4}{Installation Names}{140}
@numsecentry{Specifying the System Type}{10.5}{Specifying the System Type}{140}
@numsecentry{Sharing Defaults}{10.6}{Sharing Defaults}{141}
@numsecentry{Operation Controls}{10.7}{Operation Controls}{141}
@numsecentry{Optional Features}{10.8}{Optional Features}{141}
@appentry{Reporting Bugs}{A}{Reporting Bugs}{146}
@appentry{Major Differences From The Bourne Shell}{B}{Major Differences From The Bourne Shell}{147}
@appsecentry{Implementation Differences From The SVR4.2 Shell}{B.1}{}{151}
@appentry{GNU Free Documentation License}{C}{GNU Free Documentation License}{153}
@appentry{Indexes}{D}{Indexes}{161}
@appsecentry{Index of Shell Builtin Commands}{D.1}{Builtin Index}{161}
@appsecentry{Index of Shell Reserved Words}{D.2}{Reserved Word Index}{162}
@appsecentry{Parameter and Variable Index}{D.3}{Variable Index}{162}
@appsecentry{Function Index}{D.4}{Function Index}{164}
@appsecentry{Concept Index}{D.5}{Concept Index}{166}
@numchapentry{Job Control}{7}{Job Control}{98}
@numsecentry{Job Control Basics}{7.1}{Job Control Basics}{98}
@numsecentry{Job Control Builtins}{7.2}{Job Control Builtins}{99}
@numsecentry{Job Control Variables}{7.3}{Job Control Variables}{101}
@numchapentry{Command Line Editing}{8}{Command Line Editing}{102}
@numsecentry{Introduction to Line Editing}{8.1}{Introduction and Notation}{102}
@numsecentry{Readline Interaction}{8.2}{Readline Interaction}{102}
@numsubsecentry{Readline Bare Essentials}{8.2.1}{Readline Bare Essentials}{103}
@numsubsecentry{Readline Movement Commands}{8.2.2}{Readline Movement Commands}{103}
@numsubsecentry{Readline Killing Commands}{8.2.3}{Readline Killing Commands}{104}
@numsubsecentry{Readline Arguments}{8.2.4}{Readline Arguments}{104}
@numsubsecentry{Searching for Commands in the History}{8.2.5}{Searching}{104}
@numsecentry{Readline Init File}{8.3}{Readline Init File}{105}
@numsubsecentry{Readline Init File Syntax}{8.3.1}{Readline Init File Syntax}{105}
@numsubsecentry{Conditional Init Constructs}{8.3.2}{Conditional Init Constructs}{113}
@numsubsecentry{Sample Init File}{8.3.3}{Sample Init File}{114}
@numsecentry{Bindable Readline Commands}{8.4}{Bindable Readline Commands}{117}
@numsubsecentry{Commands For Moving}{8.4.1}{Commands For Moving}{117}
@numsubsecentry{Commands For Manipulating The History}{8.4.2}{Commands For History}{118}
@numsubsecentry{Commands For Changing Text}{8.4.3}{Commands For Text}{119}
@numsubsecentry{Killing And Yanking}{8.4.4}{Commands For Killing}{120}
@numsubsecentry{Specifying Numeric Arguments}{8.4.5}{Numeric Arguments}{122}
@numsubsecentry{Letting Readline Type For You}{8.4.6}{Commands For Completion}{122}
@numsubsecentry{Keyboard Macros}{8.4.7}{Keyboard Macros}{124}
@numsubsecentry{Some Miscellaneous Commands}{8.4.8}{Miscellaneous Commands}{124}
@numsecentry{Readline vi Mode}{8.5}{Readline vi Mode}{126}
@numsecentry{Programmable Completion}{8.6}{Programmable Completion}{127}
@numsecentry{Programmable Completion Builtins}{8.7}{Programmable Completion Builtins}{129}
@numsecentry{A Programmable Completion Example}{8.8}{A Programmable Completion Example}{132}
@numchapentry{Using History Interactively}{9}{Using History Interactively}{135}
@numsecentry{Bash History Facilities}{9.1}{Bash History Facilities}{135}
@numsecentry{Bash History Builtins}{9.2}{Bash History Builtins}{135}
@numsecentry{History Expansion}{9.3}{History Interaction}{137}
@numsubsecentry{Event Designators}{9.3.1}{Event Designators}{137}
@numsubsecentry{Word Designators}{9.3.2}{Word Designators}{138}
@numsubsecentry{Modifiers}{9.3.3}{Modifiers}{139}
@numchapentry{Installing Bash}{10}{Installing Bash}{140}
@numsecentry{Basic Installation}{10.1}{Basic Installation}{140}
@numsecentry{Compilers and Options}{10.2}{Compilers and Options}{141}
@numsecentry{Compiling For Multiple Architectures}{10.3}{Compiling For Multiple Architectures}{141}
@numsecentry{Installation Names}{10.4}{Installation Names}{141}
@numsecentry{Specifying the System Type}{10.5}{Specifying the System Type}{141}
@numsecentry{Sharing Defaults}{10.6}{Sharing Defaults}{142}
@numsecentry{Operation Controls}{10.7}{Operation Controls}{142}
@numsecentry{Optional Features}{10.8}{Optional Features}{142}
@appentry{Reporting Bugs}{A}{Reporting Bugs}{147}
@appentry{Major Differences From The Bourne Shell}{B}{Major Differences From The Bourne Shell}{148}
@appsecentry{Implementation Differences From The SVR4.2 Shell}{B.1}{}{152}
@appentry{GNU Free Documentation License}{C}{GNU Free Documentation License}{154}
@appentry{Indexes}{D}{Indexes}{162}
@appsecentry{Index of Shell Builtin Commands}{D.1}{Builtin Index}{162}
@appsecentry{Index of Shell Reserved Words}{D.2}{Reserved Word Index}{163}
@appsecentry{Parameter and Variable Index}{D.3}{Variable Index}{163}
@appsecentry{Function Index}{D.4}{Function Index}{165}
@appsecentry{Concept Index}{D.5}{Concept Index}{167}
doc/bashref.vr
+42 -41
View File
@@ -41,6 +41,7 @@
\entry{BASH_ENV}{71}{\code {BASH_ENV}}
\entry{BASH_EXECUTION_STRING}{71}{\code {BASH_EXECUTION_STRING}}
\entry{BASH_LINENO}{71}{\code {BASH_LINENO}}
\entry{BASH_LOADABLES_PATH}{71}{\code {BASH_LOADABLES_PATH}}
\entry{BASH_REMATCH}{71}{\code {BASH_REMATCH}}
\entry{BASH_SOURCE}{71}{\code {BASH_SOURCE}}
\entry{BASH_SUBSHELL}{71}{\code {BASH_SUBSHELL}}
@@ -116,44 +117,44 @@
\entry{TMOUT}{79}{\code {TMOUT}}
\entry{TMPDIR}{79}{\code {TMPDIR}}
\entry{UID}{79}{\code {UID}}
\entry{auto_resume}{100}{\code {auto_resume}}
\entry{bell-style}{105}{\code {bell-style}}
\entry{bind-tty-special-chars}{105}{\code {bind-tty-special-chars}}
\entry{blink-matching-paren}{105}{\code {blink-matching-paren}}
\entry{colored-completion-prefix}{105}{\code {colored-completion-prefix}}
\entry{colored-stats}{105}{\code {colored-stats}}
\entry{comment-begin}{105}{\code {comment-begin}}
\entry{completion-display-width}{105}{\code {completion-display-width}}
\entry{completion-ignore-case}{106}{\code {completion-ignore-case}}
\entry{completion-map-case}{106}{\code {completion-map-case}}
\entry{completion-prefix-display-length}{106}{\code {completion-prefix-display-length}}
\entry{completion-query-items}{106}{\code {completion-query-items}}
\entry{convert-meta}{106}{\code {convert-meta}}
\entry{disable-completion}{106}{\code {disable-completion}}
\entry{editing-mode}{106}{\code {editing-mode}}
\entry{emacs-mode-string}{106}{\code {emacs-mode-string}}
\entry{echo-control-characters}{107}{\code {echo-control-characters}}
\entry{enable-bracketed-paste}{107}{\code {enable-bracketed-paste}}
\entry{enable-keypad}{107}{\code {enable-keypad}}
\entry{expand-tilde}{107}{\code {expand-tilde}}
\entry{history-preserve-point}{107}{\code {history-preserve-point}}
\entry{history-size}{107}{\code {history-size}}
\entry{horizontal-scroll-mode}{107}{\code {horizontal-scroll-mode}}
\entry{input-meta}{107}{\code {input-meta}}
\entry{meta-flag}{107}{\code {meta-flag}}
\entry{isearch-terminators}{108}{\code {isearch-terminators}}
\entry{keymap}{108}{\code {keymap}}
\entry{mark-modified-lines}{108}{\code {mark-modified-lines}}
\entry{mark-symlinked-directories}{108}{\code {mark-symlinked-directories}}
\entry{match-hidden-files}{108}{\code {match-hidden-files}}
\entry{menu-complete-display-prefix}{109}{\code {menu-complete-display-prefix}}
\entry{output-meta}{109}{\code {output-meta}}
\entry{page-completions}{109}{\code {page-completions}}
\entry{revert-all-at-newline}{109}{\code {revert-all-at-newline}}
\entry{show-all-if-ambiguous}{109}{\code {show-all-if-ambiguous}}
\entry{show-all-if-unmodified}{109}{\code {show-all-if-unmodified}}
\entry{show-mode-in-prompt}{109}{\code {show-mode-in-prompt}}
\entry{skip-completed-text}{109}{\code {skip-completed-text}}
\entry{vi-cmd-mode-string}{110}{\code {vi-cmd-mode-string}}
\entry{vi-ins-mode-string}{110}{\code {vi-ins-mode-string}}
\entry{visible-stats}{110}{\code {visible-stats}}
\entry{auto_resume}{101}{\code {auto_resume}}
\entry{bell-style}{106}{\code {bell-style}}
\entry{bind-tty-special-chars}{106}{\code {bind-tty-special-chars}}
\entry{blink-matching-paren}{106}{\code {blink-matching-paren}}
\entry{colored-completion-prefix}{106}{\code {colored-completion-prefix}}
\entry{colored-stats}{106}{\code {colored-stats}}
\entry{comment-begin}{106}{\code {comment-begin}}
\entry{completion-display-width}{106}{\code {completion-display-width}}
\entry{completion-ignore-case}{107}{\code {completion-ignore-case}}
\entry{completion-map-case}{107}{\code {completion-map-case}}
\entry{completion-prefix-display-length}{107}{\code {completion-prefix-display-length}}
\entry{completion-query-items}{107}{\code {completion-query-items}}
\entry{convert-meta}{107}{\code {convert-meta}}
\entry{disable-completion}{107}{\code {disable-completion}}
\entry{editing-mode}{107}{\code {editing-mode}}
\entry{emacs-mode-string}{107}{\code {emacs-mode-string}}
\entry{echo-control-characters}{108}{\code {echo-control-characters}}
\entry{enable-bracketed-paste}{108}{\code {enable-bracketed-paste}}
\entry{enable-keypad}{108}{\code {enable-keypad}}
\entry{expand-tilde}{108}{\code {expand-tilde}}
\entry{history-preserve-point}{108}{\code {history-preserve-point}}
\entry{history-size}{108}{\code {history-size}}
\entry{horizontal-scroll-mode}{108}{\code {horizontal-scroll-mode}}
\entry{input-meta}{108}{\code {input-meta}}
\entry{meta-flag}{108}{\code {meta-flag}}
\entry{isearch-terminators}{109}{\code {isearch-terminators}}
\entry{keymap}{109}{\code {keymap}}
\entry{mark-modified-lines}{109}{\code {mark-modified-lines}}
\entry{mark-symlinked-directories}{109}{\code {mark-symlinked-directories}}
\entry{match-hidden-files}{109}{\code {match-hidden-files}}
\entry{menu-complete-display-prefix}{110}{\code {menu-complete-display-prefix}}
\entry{output-meta}{110}{\code {output-meta}}
\entry{page-completions}{110}{\code {page-completions}}
\entry{revert-all-at-newline}{110}{\code {revert-all-at-newline}}
\entry{show-all-if-ambiguous}{110}{\code {show-all-if-ambiguous}}
\entry{show-all-if-unmodified}{110}{\code {show-all-if-unmodified}}
\entry{show-mode-in-prompt}{110}{\code {show-mode-in-prompt}}
\entry{skip-completed-text}{110}{\code {skip-completed-text}}
\entry{vi-cmd-mode-string}{111}{\code {vi-cmd-mode-string}}
\entry{vi-ins-mode-string}{111}{\code {vi-ins-mode-string}}
\entry{visible-stats}{111}{\code {visible-stats}}
doc/bashref.vrs
+42 -41
View File
@@ -26,7 +26,7 @@
\initial {0}
\entry {\code {0}}{21}
\initial {A}
\entry {\code {auto_resume}}{100}
\entry {\code {auto_resume}}{101}
\initial {B}
\entry {\code {BASH}}{69}
\entry {\code {BASH_ALIASES}}{70}
@@ -38,6 +38,7 @@
\entry {\code {BASH_ENV}}{71}
\entry {\code {BASH_EXECUTION_STRING}}{71}
\entry {\code {BASH_LINENO}}{71}
\entry {\code {BASH_LOADABLES_PATH}}{71}
\entry {\code {BASH_REMATCH}}{71}
\entry {\code {BASH_SOURCE}}{71}
\entry {\code {BASH_SUBSHELL}}{71}
@@ -46,16 +47,16 @@
\entry {\code {BASH_XTRACEFD}}{72}
\entry {\code {BASHOPTS}}{70}
\entry {\code {BASHPID}}{70}
\entry {\code {bell-style}}{105}
\entry {\code {bind-tty-special-chars}}{105}
\entry {\code {blink-matching-paren}}{105}
\entry {\code {bell-style}}{106}
\entry {\code {bind-tty-special-chars}}{106}
\entry {\code {blink-matching-paren}}{106}
\initial {C}
\entry {\code {CDPATH}}{69}
\entry {\code {CHILD_MAX}}{72}
\entry {\code {colored-completion-prefix}}{105}
\entry {\code {colored-stats}}{105}
\entry {\code {colored-completion-prefix}}{106}
\entry {\code {colored-stats}}{106}
\entry {\code {COLUMNS}}{72}
\entry {\code {comment-begin}}{105}
\entry {\code {comment-begin}}{106}
\entry {\code {COMP_CWORD}}{72}
\entry {\code {COMP_KEY}}{73}
\entry {\code {COMP_LINE}}{72}
@@ -63,28 +64,28 @@
\entry {\code {COMP_TYPE}}{73}
\entry {\code {COMP_WORDBREAKS}}{73}
\entry {\code {COMP_WORDS}}{73}
\entry {\code {completion-display-width}}{105}
\entry {\code {completion-ignore-case}}{106}
\entry {\code {completion-map-case}}{106}
\entry {\code {completion-prefix-display-length}}{106}
\entry {\code {completion-query-items}}{106}
\entry {\code {completion-display-width}}{106}
\entry {\code {completion-ignore-case}}{107}
\entry {\code {completion-map-case}}{107}
\entry {\code {completion-prefix-display-length}}{107}
\entry {\code {completion-query-items}}{107}
\entry {\code {COMPREPLY}}{73}
\entry {\code {convert-meta}}{106}
\entry {\code {convert-meta}}{107}
\entry {\code {COPROC}}{73}
\initial {D}
\entry {\code {DIRSTACK}}{73}
\entry {\code {disable-completion}}{106}
\entry {\code {disable-completion}}{107}
\initial {E}
\entry {\code {echo-control-characters}}{107}
\entry {\code {editing-mode}}{106}
\entry {\code {echo-control-characters}}{108}
\entry {\code {editing-mode}}{107}
\entry {\code {emacs-mode-string}}{107}
\entry {\code {EMACS}}{73}
\entry {\code {emacs-mode-string}}{106}
\entry {\code {enable-bracketed-paste}}{107}
\entry {\code {enable-keypad}}{107}
\entry {\code {enable-bracketed-paste}}{108}
\entry {\code {enable-keypad}}{108}
\entry {\code {ENV}}{73}
\entry {\code {EUID}}{73}
\entry {\code {EXECIGNORE}}{73}
\entry {\code {expand-tilde}}{107}
\entry {\code {expand-tilde}}{108}
\initial {F}
\entry {\code {FCEDIT}}{74}
\entry {\code {FIGNORE}}{74}
@@ -100,23 +101,23 @@
\entry {\code {HISTFILE}}{75}
\entry {\code {HISTFILESIZE}}{75}
\entry {\code {HISTIGNORE}}{75}
\entry {\code {history-preserve-point}}{107}
\entry {\code {history-size}}{107}
\entry {\code {history-preserve-point}}{108}
\entry {\code {history-size}}{108}
\entry {\code {HISTSIZE}}{75}
\entry {\code {HISTTIMEFORMAT}}{75}
\entry {\code {HOME}}{69}
\entry {\code {horizontal-scroll-mode}}{107}
\entry {\code {horizontal-scroll-mode}}{108}
\entry {\code {HOSTFILE}}{76}
\entry {\code {HOSTNAME}}{76}
\entry {\code {HOSTTYPE}}{76}
\initial {I}
\entry {\code {IFS}}{69}
\entry {\code {IGNOREEOF}}{76}
\entry {\code {input-meta}}{107}
\entry {\code {input-meta}}{108}
\entry {\code {INPUTRC}}{76}
\entry {\code {isearch-terminators}}{108}
\entry {\code {isearch-terminators}}{109}
\initial {K}
\entry {\code {keymap}}{108}
\entry {\code {keymap}}{109}
\initial {L}
\entry {\code {LANG}}{76}
\entry {\code {LC_ALL}}{76}
@@ -132,20 +133,20 @@
\entry {\code {MAILCHECK}}{77}
\entry {\code {MAILPATH}}{69}
\entry {\code {MAPFILE}}{77}
\entry {\code {mark-modified-lines}}{108}
\entry {\code {mark-symlinked-directories}}{108}
\entry {\code {match-hidden-files}}{108}
\entry {\code {menu-complete-display-prefix}}{109}
\entry {\code {meta-flag}}{107}
\entry {\code {mark-modified-lines}}{109}
\entry {\code {mark-symlinked-directories}}{109}
\entry {\code {match-hidden-files}}{109}
\entry {\code {menu-complete-display-prefix}}{110}
\entry {\code {meta-flag}}{108}
\initial {O}
\entry {\code {OLDPWD}}{77}
\entry {\code {OPTARG}}{69}
\entry {\code {OPTERR}}{77}
\entry {\code {OPTIND}}{69}
\entry {\code {OSTYPE}}{77}
\entry {\code {output-meta}}{109}
\entry {\code {output-meta}}{110}
\initial {P}
\entry {\code {page-completions}}{109}
\entry {\code {page-completions}}{110}
\entry {\code {PATH}}{69}
\entry {\code {PIPESTATUS}}{77}
\entry {\code {POSIXLY_CORRECT}}{77}
@@ -162,16 +163,16 @@
\entry {\code {READLINE_LINE}}{78}
\entry {\code {READLINE_POINT}}{78}
\entry {\code {REPLY}}{78}
\entry {\code {revert-all-at-newline}}{109}
\entry {\code {revert-all-at-newline}}{110}
\initial {S}
\entry {\code {SECONDS}}{78}
\entry {\code {SHELL}}{78}
\entry {\code {SHELLOPTS}}{78}
\entry {\code {SHLVL}}{78}
\entry {\code {show-all-if-ambiguous}}{109}
\entry {\code {show-all-if-unmodified}}{109}
\entry {\code {show-mode-in-prompt}}{109}
\entry {\code {skip-completed-text}}{109}
\entry {\code {show-all-if-ambiguous}}{110}
\entry {\code {show-all-if-unmodified}}{110}
\entry {\code {show-mode-in-prompt}}{110}
\entry {\code {skip-completed-text}}{110}
\initial {T}
\entry {\code {TEXTDOMAIN}}{7}
\entry {\code {TEXTDOMAINDIR}}{7}
@@ -181,6 +182,6 @@
\initial {U}
\entry {\code {UID}}{79}
\initial {V}
\entry {\code {vi-cmd-mode-string}}{110}
\entry {\code {vi-ins-mode-string}}{110}
\entry {\code {visible-stats}}{110}
\entry {\code {vi-cmd-mode-string}}{111}
\entry {\code {vi-ins-mode-string}}{111}
\entry {\code {visible-stats}}{111}
doc/builtins.0
+231 -229
View File
@@ -15,55 +15,56 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
Unless otherwise noted, each builtin command documented in this section
as accepting options preceded by -- accepts ---- to signify the end of the
options. The ::, ttrruuee, ffaallssee, and tteesstt builtins do not accept options
and do not treat ---- specially. The eexxiitt, llooggoouutt, bbrreeaakk, ccoonnttiinnuuee, lleett,
and sshhiifftt builtins accept and process arguments beginning with -- with-
out requiring ----. Other builtins that accept arguments but are not
specified as accepting options interpret arguments beginning with -- as
invalid options and require ---- to prevent this interpretation.
and do not treat ---- specially. The eexxiitt, llooggoouutt, rreettuurrnn, bbrreeaakk, ccoonn--
ttiinnuuee, lleett, and sshhiifftt builtins accept and process arguments beginning
with -- without requiring ----. Other builtins that accept arguments but
are not specified as accepting options interpret arguments beginning
with -- as invalid options and require ---- to prevent this interpreta-
tion.
:: [_a_r_g_u_m_e_n_t_s]
No effect; the command does nothing beyond expanding _a_r_g_u_m_e_n_t_s
No effect; the command does nothing beyond expanding _a_r_g_u_m_e_n_t_s
and performing any specified redirections. The return status is
zero.
.. _f_i_l_e_n_a_m_e [_a_r_g_u_m_e_n_t_s]
ssoouurrccee _f_i_l_e_n_a_m_e [_a_r_g_u_m_e_n_t_s]
Read and execute commands from _f_i_l_e_n_a_m_e in the current shell
environment and return the exit status of the last command exe-
cuted from _f_i_l_e_n_a_m_e. If _f_i_l_e_n_a_m_e does not contain a slash,
filenames in PPAATTHH are used to find the directory containing
Read and execute commands from _f_i_l_e_n_a_m_e in the current shell
environment and return the exit status of the last command exe-
cuted from _f_i_l_e_n_a_m_e. If _f_i_l_e_n_a_m_e does not contain a slash,
filenames in PPAATTHH are used to find the directory containing
_f_i_l_e_n_a_m_e. The file searched for in PPAATTHH need not be executable.
When bbaasshh is not in _p_o_s_i_x _m_o_d_e, the current directory is
searched if no file is found in PPAATTHH. If the ssoouurrcceeppaatthh option
to the sshhoopptt builtin command is turned off, the PPAATTHH is not
searched. If any _a_r_g_u_m_e_n_t_s are supplied, they become the posi-
tional parameters when _f_i_l_e_n_a_m_e is executed. Otherwise the
positional parameters are unchanged. If the --TT option is
enabled, ssoouurrccee inherits any trap on DDEEBBUUGG; if it is not, any
DDEEBBUUGG trap string is saved and restored around the call to
ssoouurrccee, and ssoouurrccee unsets the DDEEBBUUGG trap while it executes. If
--TT is not set, and the sourced file changes the DDEEBBUUGG trap, the
new value is retained when ssoouurrccee completes. The return status
When bbaasshh is not in _p_o_s_i_x _m_o_d_e, the current directory is
searched if no file is found in PPAATTHH. If the ssoouurrcceeppaatthh option
to the sshhoopptt builtin command is turned off, the PPAATTHH is not
searched. If any _a_r_g_u_m_e_n_t_s are supplied, they become the posi-
tional parameters when _f_i_l_e_n_a_m_e is executed. Otherwise the
positional parameters are unchanged. If the --TT option is
enabled, ssoouurrccee inherits any trap on DDEEBBUUGG; if it is not, any
DDEEBBUUGG trap string is saved and restored around the call to
ssoouurrccee, and ssoouurrccee unsets the DDEEBBUUGG trap while it executes. If
--TT is not set, and the sourced file changes the DDEEBBUUGG trap, the
new value is retained when ssoouurrccee completes. The return status
is the status of the last command exited within the script (0 if
no commands are executed), and false if _f_i_l_e_n_a_m_e is not found or
cannot be read.
aalliiaass [--pp] [_n_a_m_e[=_v_a_l_u_e] ...]
AAlliiaass with no arguments or with the --pp option prints the list of
aliases in the form aalliiaass _n_a_m_e=_v_a_l_u_e on standard output. When
arguments are supplied, an alias is defined for each _n_a_m_e whose
_v_a_l_u_e is given. A trailing space in _v_a_l_u_e causes the next word
aliases in the form aalliiaass _n_a_m_e=_v_a_l_u_e on standard output. When
arguments are supplied, an alias is defined for each _n_a_m_e whose
_v_a_l_u_e is given. A trailing space in _v_a_l_u_e causes the next word
to be checked for alias substitution when the alias is expanded.
For each _n_a_m_e in the argument list for which no _v_a_l_u_e is sup-
plied, the name and value of the alias is printed. AAlliiaass
returns true unless a _n_a_m_e is given for which no alias has been
For each _n_a_m_e in the argument list for which no _v_a_l_u_e is sup-
plied, the name and value of the alias is printed. AAlliiaass
returns true unless a _n_a_m_e is given for which no alias has been
defined.
bbgg [_j_o_b_s_p_e_c ...]
Resume each suspended job _j_o_b_s_p_e_c in the background, as if it
Resume each suspended job _j_o_b_s_p_e_c in the background, as if it
had been started with &&. If _j_o_b_s_p_e_c is not present, the shell's
notion of the _c_u_r_r_e_n_t _j_o_b is used. bbgg _j_o_b_s_p_e_c returns 0 unless
run when job control is disabled or, when run with job control
enabled, any specified _j_o_b_s_p_e_c was not found or was started
notion of the _c_u_r_r_e_n_t _j_o_b is used. bbgg _j_o_b_s_p_e_c returns 0 unless
run when job control is disabled or, when run with job control
enabled, any specified _j_o_b_s_p_e_c was not found or was started
without job control.
bbiinndd [--mm _k_e_y_m_a_p] [--llppssvvPPSSVVXX]
@@ -72,28 +73,28 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
bbiinndd [--mm _k_e_y_m_a_p] --xx _k_e_y_s_e_q:_s_h_e_l_l_-_c_o_m_m_a_n_d
bbiinndd [--mm _k_e_y_m_a_p] _k_e_y_s_e_q:_f_u_n_c_t_i_o_n_-_n_a_m_e
bbiinndd [--mm _k_e_y_m_a_p] _k_e_y_s_e_q:_r_e_a_d_l_i_n_e_-_c_o_m_m_a_n_d
Display current rreeaaddlliinnee key and function bindings, bind a key
sequence to a rreeaaddlliinnee function or macro, or set a rreeaaddlliinnee
variable. Each non-option argument is a command as it would
appear in _._i_n_p_u_t_r_c, but each binding or command must be passed
as a separate argument; e.g., '"\C-x\C-r": re-read-init-file'.
Display current rreeaaddlliinnee key and function bindings, bind a key
sequence to a rreeaaddlliinnee function or macro, or set a rreeaaddlliinnee
variable. Each non-option argument is a command as it would
appear in _._i_n_p_u_t_r_c, but each binding or command must be passed
as a separate argument; e.g., '"\C-x\C-r": re-read-init-file'.
Options, if supplied, have the following meanings:
--mm _k_e_y_m_a_p
Use _k_e_y_m_a_p as the keymap to be affected by the subsequent
bindings. Acceptable _k_e_y_m_a_p names are _e_m_a_c_s_, _e_m_a_c_s_-_s_t_a_n_-
_d_a_r_d_, _e_m_a_c_s_-_m_e_t_a_, _e_m_a_c_s_-_c_t_l_x_, _v_i_, _v_i_-_m_o_v_e_, _v_i_-_c_o_m_m_a_n_d,
and _v_i_-_i_n_s_e_r_t. _v_i is equivalent to _v_i_-_c_o_m_m_a_n_d; _e_m_a_c_s is
_d_a_r_d_, _e_m_a_c_s_-_m_e_t_a_, _e_m_a_c_s_-_c_t_l_x_, _v_i_, _v_i_-_m_o_v_e_, _v_i_-_c_o_m_m_a_n_d,
and _v_i_-_i_n_s_e_r_t. _v_i is equivalent to _v_i_-_c_o_m_m_a_n_d; _e_m_a_c_s is
equivalent to _e_m_a_c_s_-_s_t_a_n_d_a_r_d.
--ll List the names of all rreeaaddlliinnee functions.
--pp Display rreeaaddlliinnee function names and bindings in such a
--pp Display rreeaaddlliinnee function names and bindings in such a
way that they can be re-read.
--PP List current rreeaaddlliinnee function names and bindings.
--ss Display rreeaaddlliinnee key sequences bound to macros and the
strings they output in such a way that they can be re-
--ss Display rreeaaddlliinnee key sequences bound to macros and the
strings they output in such a way that they can be re-
read.
--SS Display rreeaaddlliinnee key sequences bound to macros and the
--SS Display rreeaaddlliinnee key sequences bound to macros and the
strings they output.
--vv Display rreeaaddlliinnee variable names and values in such a way
--vv Display rreeaaddlliinnee variable names and values in such a way
that they can be re-read.
--VV List current rreeaaddlliinnee variable names and values.
--ff _f_i_l_e_n_a_m_e
@@ -105,174 +106,174 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
--rr _k_e_y_s_e_q
Remove any current binding for _k_e_y_s_e_q.
--xx _k_e_y_s_e_q::_s_h_e_l_l_-_c_o_m_m_a_n_d
Cause _s_h_e_l_l_-_c_o_m_m_a_n_d to be executed whenever _k_e_y_s_e_q is
entered. When _s_h_e_l_l_-_c_o_m_m_a_n_d is executed, the shell sets
the RREEAADDLLIINNEE__LLIINNEE variable to the contents of the rreeaadd--
lliinnee line buffer and the RREEAADDLLIINNEE__PPOOIINNTT variable to the
Cause _s_h_e_l_l_-_c_o_m_m_a_n_d to be executed whenever _k_e_y_s_e_q is
entered. When _s_h_e_l_l_-_c_o_m_m_a_n_d is executed, the shell sets
the RREEAADDLLIINNEE__LLIINNEE variable to the contents of the rreeaadd--
lliinnee line buffer and the RREEAADDLLIINNEE__PPOOIINNTT variable to the
current location of the insertion point. If the executed
command changes the value of RREEAADDLLIINNEE__LLIINNEE or RREEAADD--
LLIINNEE__PPOOIINNTT, those new values will be reflected in the
command changes the value of RREEAADDLLIINNEE__LLIINNEE or RREEAADD--
LLIINNEE__PPOOIINNTT, those new values will be reflected in the
editing state.
--XX List all key sequences bound to shell commands and the
associated commands in a format that can be reused as
--XX List all key sequences bound to shell commands and the
associated commands in a format that can be reused as
input.
The return value is 0 unless an unrecognized option is given or
The return value is 0 unless an unrecognized option is given or
an error occurred.
bbrreeaakk [_n]
Exit from within a ffoorr, wwhhiillee, uunnttiill, or sseelleecctt loop. If _n is
specified, break _n levels. _n must be >= 1. If _n is greater
than the number of enclosing loops, all enclosing loops are
exited. The return value is 0 unless _n is not greater than or
Exit from within a ffoorr, wwhhiillee, uunnttiill, or sseelleecctt loop. If _n is
specified, break _n levels. _n must be >= 1. If _n is greater
than the number of enclosing loops, all enclosing loops are
exited. The return value is 0 unless _n is not greater than or
equal to 1.
bbuuiillttiinn _s_h_e_l_l_-_b_u_i_l_t_i_n [_a_r_g_u_m_e_n_t_s]
Execute the specified shell builtin, passing it _a_r_g_u_m_e_n_t_s, and
Execute the specified shell builtin, passing it _a_r_g_u_m_e_n_t_s, and
return its exit status. This is useful when defining a function
whose name is the same as a shell builtin, retaining the func-
whose name is the same as a shell builtin, retaining the func-
tionality of the builtin within the function. The ccdd builtin is
commonly redefined this way. The return status is false if
commonly redefined this way. The return status is false if
_s_h_e_l_l_-_b_u_i_l_t_i_n is not a shell builtin command.
ccaalllleerr [_e_x_p_r]
Returns the context of any active subroutine call (a shell func-
tion or a script executed with the .. or ssoouurrccee builtins). With-
out _e_x_p_r, ccaalllleerr displays the line number and source filename of
the current subroutine call. If a non-negative integer is sup-
the current subroutine call. If a non-negative integer is sup-
plied as _e_x_p_r, ccaalllleerr displays the line number, subroutine name,
and source file corresponding to that position in the current
execution call stack. This extra information may be used, for
example, to print a stack trace. The current frame is frame 0.
The return value is 0 unless the shell is not executing a sub-
routine call or _e_x_p_r does not correspond to a valid position in
and source file corresponding to that position in the current
execution call stack. This extra information may be used, for
example, to print a stack trace. The current frame is frame 0.
The return value is 0 unless the shell is not executing a sub-
routine call or _e_x_p_r does not correspond to a valid position in
the call stack.
ccdd [--LL|[--PP [--ee]] [-@]] [_d_i_r]
Change the current directory to _d_i_r. if _d_i_r is not supplied,
the value of the HHOOMMEE shell variable is the default. Any addi-
Change the current directory to _d_i_r. if _d_i_r is not supplied,
the value of the HHOOMMEE shell variable is the default. Any addi-
tional arguments following _d_i_r are ignored. The variable CCDDPPAATTHH
defines the search path for the directory containing _d_i_r: each
directory name in CCDDPPAATTHH is searched for _d_i_r. Alternative
directory names in CCDDPPAATTHH are separated by a colon (:). A null
directory name in CCDDPPAATTHH is the same as the current directory,
defines the search path for the directory containing _d_i_r: each
directory name in CCDDPPAATTHH is searched for _d_i_r. Alternative
directory names in CCDDPPAATTHH are separated by a colon (:). A null
directory name in CCDDPPAATTHH is the same as the current directory,
i.e., ``..''. If _d_i_r begins with a slash (/), then CCDDPPAATTHH is not
used. The --PP option causes ccdd to use the physical directory
structure by resolving symbolic links while traversing _d_i_r and
used. The --PP option causes ccdd to use the physical directory
structure by resolving symbolic links while traversing _d_i_r and
before processing instances of _._. in _d_i_r (see also the --PP option
to the sseett builtin command); the --LL option forces symbolic links
to be followed by resolving the link after processing instances
to be followed by resolving the link after processing instances
of _._. in _d_i_r. If _._. appears in _d_i_r, it is processed by removing
the immediately previous pathname component from _d_i_r, back to a
slash or the beginning of _d_i_r. If the --ee option is supplied
with --PP, and the current working directory cannot be success-
fully determined after a successful directory change, ccdd will
return an unsuccessful status. On systems that support it, the
--@@ option presents the extended attributes associated with a
file as a directory. An argument of -- is converted to $$OOLLDDPPWWDD
the immediately previous pathname component from _d_i_r, back to a
slash or the beginning of _d_i_r. If the --ee option is supplied
with --PP, and the current working directory cannot be success-
fully determined after a successful directory change, ccdd will
return an unsuccessful status. On systems that support it, the
--@@ option presents the extended attributes associated with a
file as a directory. An argument of -- is converted to $$OOLLDDPPWWDD
before the directory change is attempted. If a non-empty direc-
tory name from CCDDPPAATTHH is used, or if -- is the first argument,
tory name from CCDDPPAATTHH is used, or if -- is the first argument,
and the directory change is successful, the absolute pathname of
the new working directory is written to the standard output.
The return value is true if the directory was successfully
the new working directory is written to the standard output.
The return value is true if the directory was successfully
changed; false otherwise.
ccoommmmaanndd [--ppVVvv] _c_o_m_m_a_n_d [_a_r_g ...]
Run _c_o_m_m_a_n_d with _a_r_g_s suppressing the normal shell function
Run _c_o_m_m_a_n_d with _a_r_g_s suppressing the normal shell function
lookup. Only builtin commands or commands found in the PPAATTHH are
executed. If the --pp option is given, the search for _c_o_m_m_a_n_d is
performed using a default value for PPAATTHH that is guaranteed to
find all of the standard utilities. If either the --VV or --vv
executed. If the --pp option is given, the search for _c_o_m_m_a_n_d is
performed using a default value for PPAATTHH that is guaranteed to
find all of the standard utilities. If either the --VV or --vv
option is supplied, a description of _c_o_m_m_a_n_d is printed. The --vv
option causes a single word indicating the command or filename
option causes a single word indicating the command or filename
used to invoke _c_o_m_m_a_n_d to be displayed; the --VV option produces a
more verbose description. If the --VV or --vv option is supplied,
the exit status is 0 if _c_o_m_m_a_n_d was found, and 1 if not. If
more verbose description. If the --VV or --vv option is supplied,
the exit status is 0 if _c_o_m_m_a_n_d was found, and 1 if not. If
neither option is supplied and an error occurred or _c_o_m_m_a_n_d can-
not be found, the exit status is 127. Otherwise, the exit sta-
not be found, the exit status is 127. Otherwise, the exit sta-
tus of the ccoommmmaanndd builtin is the exit status of _c_o_m_m_a_n_d.
ccoommppggeenn [_o_p_t_i_o_n] [_w_o_r_d]
Generate possible completion matches for _w_o_r_d according to the
_o_p_t_i_o_ns, which may be any option accepted by the ccoommpplleettee
builtin with the exception of --pp and --rr, and write the matches
to the standard output. When using the --FF or --CC options, the
various shell variables set by the programmable completion
Generate possible completion matches for _w_o_r_d according to the
_o_p_t_i_o_ns, which may be any option accepted by the ccoommpplleettee
builtin with the exception of --pp and --rr, and write the matches
to the standard output. When using the --FF or --CC options, the
various shell variables set by the programmable completion
facilities, while available, will not have useful values.
The matches will be generated in the same way as if the program-
mable completion code had generated them directly from a comple-
tion specification with the same flags. If _w_o_r_d is specified,
tion specification with the same flags. If _w_o_r_d is specified,
only those completions matching _w_o_r_d will be displayed.
The return value is true unless an invalid option is supplied,
The return value is true unless an invalid option is supplied,
or no matches were generated.
ccoommpplleettee [--aabbccddeeffggjjkkssuuvv] [--oo _c_o_m_p_-_o_p_t_i_o_n] [--DDEE] [--AA _a_c_t_i_o_n] [--GG _g_l_o_b_-
ccoommpplleettee [--aabbccddeeffggjjkkssuuvv] [--oo _c_o_m_p_-_o_p_t_i_o_n] [--DDEE] [--AA _a_c_t_i_o_n] [--GG _g_l_o_b_-
_p_a_t] [--WW _w_o_r_d_l_i_s_t] [--FF _f_u_n_c_t_i_o_n] [--CC _c_o_m_m_a_n_d]
[--XX _f_i_l_t_e_r_p_a_t] [--PP _p_r_e_f_i_x] [--SS _s_u_f_f_i_x] _n_a_m_e [_n_a_m_e _._._.]
ccoommpplleettee --pprr [--DDEE] [_n_a_m_e ...]
Specify how arguments to each _n_a_m_e should be completed. If the
--pp option is supplied, or if no options are supplied, existing
completion specifications are printed in a way that allows them
Specify how arguments to each _n_a_m_e should be completed. If the
--pp option is supplied, or if no options are supplied, existing
completion specifications are printed in a way that allows them
to be reused as input. The --rr option removes a completion spec-
ification for each _n_a_m_e, or, if no _n_a_m_es are supplied, all com-
ification for each _n_a_m_e, or, if no _n_a_m_es are supplied, all com-
pletion specifications. The --DD option indicates that the
remaining options and actions should apply to the ``default''
command completion; that is, completion attempted on a command
for which no completion has previously been defined. The --EE
option indicates that the remaining options and actions should
apply to ``empty'' command completion; that is, completion
remaining options and actions should apply to the ``default''
command completion; that is, completion attempted on a command
for which no completion has previously been defined. The --EE
option indicates that the remaining options and actions should
apply to ``empty'' command completion; that is, completion
attempted on a blank line.
The process of applying these completion specifications when
word completion is attempted is described above under PPrrooggrraamm--
The process of applying these completion specifications when
word completion is attempted is described above under PPrrooggrraamm--
mmaabbllee CCoommpplleettiioonn.
Other options, if specified, have the following meanings. The
arguments to the --GG, --WW, and --XX options (and, if necessary, the
--PP and --SS options) should be quoted to protect them from expan-
Other options, if specified, have the following meanings. The
arguments to the --GG, --WW, and --XX options (and, if necessary, the
--PP and --SS options) should be quoted to protect them from expan-
sion before the ccoommpplleettee builtin is invoked.
--oo _c_o_m_p_-_o_p_t_i_o_n
The _c_o_m_p_-_o_p_t_i_o_n controls several aspects of the comp-
spec's behavior beyond the simple generation of comple-
The _c_o_m_p_-_o_p_t_i_o_n controls several aspects of the comp-
spec's behavior beyond the simple generation of comple-
tions. _c_o_m_p_-_o_p_t_i_o_n may be one of:
bbaasshhddeeffaauulltt
Perform the rest of the default bbaasshh completions
if the compspec generates no matches.
ddeeffaauulltt Use readline's default filename completion if
ddeeffaauulltt Use readline's default filename completion if
the compspec generates no matches.
ddiirrnnaammeess
Perform directory name completion if the comp-
Perform directory name completion if the comp-
spec generates no matches.
ffiilleennaammeess
Tell readline that the compspec generates file-
names, so it can perform any filename-specific
processing (like adding a slash to directory
names, quoting special characters, or suppress-
ing trailing spaces). Intended to be used with
Tell readline that the compspec generates file-
names, so it can perform any filename-specific
processing (like adding a slash to directory
names, quoting special characters, or suppress-
ing trailing spaces). Intended to be used with
shell functions.
nnooqquuoottee Tell readline not to quote the completed words
if they are filenames (quoting filenames is the
nnooqquuoottee Tell readline not to quote the completed words
if they are filenames (quoting filenames is the
default).
nnoossoorrtt Tell readline not to sort the list of possible
nnoossoorrtt Tell readline not to sort the list of possible
completions alphabetically.
nnoossppaaccee Tell readline not to append a space (the
default) to words completed at the end of the
nnoossppaaccee Tell readline not to append a space (the
default) to words completed at the end of the
line.
pplluussddiirrss
After any matches defined by the compspec are
generated, directory name completion is
attempted and any matches are added to the
After any matches defined by the compspec are
generated, directory name completion is
attempted and any matches are added to the
results of the other actions.
--AA _a_c_t_i_o_n
The _a_c_t_i_o_n may be one of the following to generate a
The _a_c_t_i_o_n may be one of the following to generate a
list of possible completions:
aalliiaass Alias names. May also be specified as --aa.
aarrrraayyvvaarr
Array variable names.
bbiinnddiinngg RReeaaddlliinnee key binding names.
bbuuiillttiinn Names of shell builtin commands. May also be
bbuuiillttiinn Names of shell builtin commands. May also be
specified as --bb.
ccoommmmaanndd Command names. May also be specified as --cc.
ddiirreeccttoorryy
@@ -280,7 +281,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
ddiissaabblleedd
Names of disabled shell builtins.
eennaabblleedd Names of enabled shell builtins.
eexxppoorrtt Names of exported shell variables. May also be
eexxppoorrtt Names of exported shell variables. May also be
specified as --ee.
ffiillee File names. May also be specified as --ff.
ffuunnccttiioonn
@@ -289,17 +290,17 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
hheellppttooppiicc
Help topics as accepted by the hheellpp builtin.
hhoossttnnaammee
Hostnames, as taken from the file specified by
Hostnames, as taken from the file specified by
the HHOOSSTTFFIILLEE shell variable.
jjoobb Job names, if job control is active. May also
jjoobb Job names, if job control is active. May also
be specified as --jj.
kkeeyywwoorrdd Shell reserved words. May also be specified as
kkeeyywwoorrdd Shell reserved words. May also be specified as
--kk.
rruunnnniinngg Names of running jobs, if job control is active.
sseerrvviiccee Service names. May also be specified as --ss.
sseettoopptt Valid arguments for the --oo option to the sseett
sseettoopptt Valid arguments for the --oo option to the sseett
builtin.
sshhoopptt Shell option names as accepted by the sshhoopptt
sshhoopptt Shell option names as accepted by the sshhoopptt
builtin.
ssiiggnnaall Signal names.
ssttooppppeedd Names of stopped jobs, if job control is active.
@@ -308,148 +309,149 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
Names of all shell variables. May also be spec-
ified as --vv.
--CC _c_o_m_m_a_n_d
_c_o_m_m_a_n_d is executed in a subshell environment, and its
_c_o_m_m_a_n_d is executed in a subshell environment, and its
output is used as the possible completions.
--FF _f_u_n_c_t_i_o_n
The shell function _f_u_n_c_t_i_o_n is executed in the current
shell environment. When the function is executed, the
first argument ($$11) is the name of the command whose
arguments are being completed, the second argument ($$22)
The shell function _f_u_n_c_t_i_o_n is executed in the current
shell environment. When the function is executed, the
first argument ($$11) is the name of the command whose
arguments are being completed, the second argument ($$22)
is the word being completed, and the third argument ($$33)
is the word preceding the word being completed on the
current command line. When it finishes, the possible
completions are retrieved from the value of the CCOOMMPPRREE--
is the word preceding the word being completed on the
current command line. When it finishes, the possible
completions are retrieved from the value of the CCOOMMPPRREE--
PPLLYY array variable.
--GG _g_l_o_b_p_a_t
The pathname expansion pattern _g_l_o_b_p_a_t is expanded to
The pathname expansion pattern _g_l_o_b_p_a_t is expanded to
generate the possible completions.
--PP _p_r_e_f_i_x
_p_r_e_f_i_x is added at the beginning of each possible com-
_p_r_e_f_i_x is added at the beginning of each possible com-
pletion after all other options have been applied.
--SS _s_u_f_f_i_x
_s_u_f_f_i_x is appended to each possible completion after all
other options have been applied.
--WW _w_o_r_d_l_i_s_t
The _w_o_r_d_l_i_s_t is split using the characters in the IIFFSS
special variable as delimiters, and each resultant word
is expanded. The possible completions are the members
of the resultant list which match the word being com-
The _w_o_r_d_l_i_s_t is split using the characters in the IIFFSS
special variable as delimiters, and each resultant word
is expanded. The possible completions are the members
of the resultant list which match the word being com-
pleted.
--XX _f_i_l_t_e_r_p_a_t
_f_i_l_t_e_r_p_a_t is a pattern as used for pathname expansion.
_f_i_l_t_e_r_p_a_t is a pattern as used for pathname expansion.
It is applied to the list of possible completions gener-
ated by the preceding options and arguments, and each
completion matching _f_i_l_t_e_r_p_a_t is removed from the list.
A leading !! in _f_i_l_t_e_r_p_a_t negates the pattern; in this
ated by the preceding options and arguments, and each
completion matching _f_i_l_t_e_r_p_a_t is removed from the list.
A leading !! in _f_i_l_t_e_r_p_a_t negates the pattern; in this
case, any completion not matching _f_i_l_t_e_r_p_a_t is removed.
The return value is true unless an invalid option is supplied,
an option other than --pp or --rr is supplied without a _n_a_m_e argu-
ment, an attempt is made to remove a completion specification
The return value is true unless an invalid option is supplied,
an option other than --pp or --rr is supplied without a _n_a_m_e argu-
ment, an attempt is made to remove a completion specification
for a _n_a_m_e for which no specification exists, or an error occurs
adding a completion specification.
ccoommppoopptt [--oo _o_p_t_i_o_n] [--DDEE] [++oo _o_p_t_i_o_n] [_n_a_m_e]
Modify completion options for each _n_a_m_e according to the
_o_p_t_i_o_ns, or for the currently-executing completion if no _n_a_m_es
are supplied. If no _o_p_t_i_o_ns are given, display the completion
options for each _n_a_m_e or the current completion. The possible
values of _o_p_t_i_o_n are those valid for the ccoommpplleettee builtin
described above. The --DD option indicates that the remaining
_o_p_t_i_o_ns, or for the currently-executing completion if no _n_a_m_es
are supplied. If no _o_p_t_i_o_ns are given, display the completion
options for each _n_a_m_e or the current completion. The possible
values of _o_p_t_i_o_n are those valid for the ccoommpplleettee builtin
described above. The --DD option indicates that the remaining
options should apply to the ``default'' command completion; that
is, completion attempted on a command for which no completion
has previously been defined. The --EE option indicates that the
remaining options should apply to ``empty'' command completion;
is, completion attempted on a command for which no completion
has previously been defined. The --EE option indicates that the
remaining options should apply to ``empty'' command completion;
that is, completion attempted on a blank line.
The return value is true unless an invalid option is supplied,
The return value is true unless an invalid option is supplied,
an attempt is made to modify the options for a _n_a_m_e for which no
completion specification exists, or an output error occurs.
ccoonnttiinnuuee [_n]
Resume the next iteration of the enclosing ffoorr, wwhhiillee, uunnttiill, or
sseelleecctt loop. If _n is specified, resume at the _nth enclosing
loop. _n must be >= 1. If _n is greater than the number of
enclosing loops, the last enclosing loop (the ``top-level''
sseelleecctt loop. If _n is specified, resume at the _nth enclosing
loop. _n must be >= 1. If _n is greater than the number of
enclosing loops, the last enclosing loop (the ``top-level''
loop) is resumed. The return value is 0 unless _n is not greater
than or equal to 1.
ddeeccllaarree [--aaAAffFFggiillnnrrttuuxx] [--pp] [_n_a_m_e[=_v_a_l_u_e] ...]
ttyyppeesseett [--aaAAffFFggiillnnrrttuuxx] [--pp] [_n_a_m_e[=_v_a_l_u_e] ...]
Declare variables and/or give them attributes. If no _n_a_m_es are
given then display the values of variables. The --pp option will
Declare variables and/or give them attributes. If no _n_a_m_es are
given then display the values of variables. The --pp option will
display the attributes and values of each _n_a_m_e. When --pp is used
with _n_a_m_e arguments, additional options, other than --ff and --FF,
are ignored. When --pp is supplied without _n_a_m_e arguments, it
will display the attributes and values of all variables having
with _n_a_m_e arguments, additional options, other than --ff and --FF,
are ignored. When --pp is supplied without _n_a_m_e arguments, it
will display the attributes and values of all variables having
the attributes specified by the additional options. If no other
options are supplied with --pp, ddeeccllaarree will display the
attributes and values of all shell variables. The --ff option
will restrict the display to shell functions. The --FF option
inhibits the display of function definitions; only the function
name and attributes are printed. If the eexxttddeebbuugg shell option
is enabled using sshhoopptt, the source file name and line number
where the function is defined are displayed as well. The --FF
option implies --ff. The --gg option forces variables to be created
or modified at the global scope, even when ddeeccllaarree is executed
in a shell function. It is ignored in all other cases. The
following options can be used to restrict output to variables
with the specified attribute or to give variables attributes:
--aa Each _n_a_m_e is an indexed array variable (see AArrrraayyss
options are supplied with --pp, ddeeccllaarree will display the
attributes and values of all shell variables. The --ff option
will restrict the display to shell functions. The --FF option
inhibits the display of function definitions; only the function
name and attributes are printed. If the eexxttddeebbuugg shell option
is enabled using sshhoopptt, the source file name and line number
where each _n_a_m_e is defined are displayed as well. The --FF option
implies --ff. The --gg option forces variables to be created or
modified at the global scope, even when ddeeccllaarree is executed in a
shell function. It is ignored in all other cases. The follow-
ing options can be used to restrict output to variables with the
specified attribute or to give variables attributes:
--aa Each _n_a_m_e is an indexed array variable (see AArrrraayyss
above).
--AA Each _n_a_m_e is an associative array variable (see AArrrraayyss
--AA Each _n_a_m_e is an associative array variable (see AArrrraayyss
above).
--ff Use function names only.
--ii The variable is treated as an integer; arithmetic evalua-
tion (see AARRIITTHHMMEETTIICC EEVVAALLUUAATTIIOONN above) is performed when
tion (see AARRIITTHHMMEETTIICC EEVVAALLUUAATTIIOONN above) is performed when
the variable is assigned a value.
--ll When the variable is assigned a value, all upper-case
characters are converted to lower-case. The upper-case
--ll When the variable is assigned a value, all upper-case
characters are converted to lower-case. The upper-case
attribute is disabled.
--nn Give each _n_a_m_e the _n_a_m_e_r_e_f attribute, making it a name
reference to another variable. That other variable is
defined by the value of _n_a_m_e. All references, assign-
ments, and attribute modifications to _n_a_m_e, except for
changing the --nn attribute itself, are performed on the
variable referenced by _n_a_m_e's value. The nameref
--nn Give each _n_a_m_e the _n_a_m_e_r_e_f attribute, making it a name
reference to another variable. That other variable is
defined by the value of _n_a_m_e. All references, assign-
ments, and attribute modifications to _n_a_m_e, except for
changing the --nn attribute itself, are performed on the
variable referenced by _n_a_m_e's value. The nameref
attribute cannot be applied to array variables.
--rr Make _n_a_m_es readonly. These names cannot then be assigned
values by subsequent assignment statements or unset.
--tt Give each _n_a_m_e the _t_r_a_c_e attribute. Traced functions
inherit the DDEEBBUUGG and RREETTUURRNN traps from the calling
shell. The trace attribute has no special meaning for
--tt Give each _n_a_m_e the _t_r_a_c_e attribute. Traced functions
inherit the DDEEBBUUGG and RREETTUURRNN traps from the calling
shell. The trace attribute has no special meaning for
variables.
--uu When the variable is assigned a value, all lower-case
characters are converted to upper-case. The lower-case
--uu When the variable is assigned a value, all lower-case
characters are converted to upper-case. The lower-case
attribute is disabled.
--xx Mark _n_a_m_es for export to subsequent commands via the
--xx Mark _n_a_m_es for export to subsequent commands via the
environment.
Using `+' instead of `-' turns off the attribute instead, with
Using `+' instead of `-' turns off the attribute instead, with
the exceptions that ++aa may not be used to destroy an array vari-
able and ++rr will not remove the readonly attribute. When used
able and ++rr will not remove the readonly attribute. When used
in a function, ddeeccllaarree and ttyyppeesseett make each _n_a_m_e local, as with
the llooccaall command, unless the --gg option is supplied. If a vari-
able name is followed by =_v_a_l_u_e, the value of the variable is
set to _v_a_l_u_e. When using --aa or --AA and the compound assignment
syntax to create array variables, additional attributes do not
able name is followed by =_v_a_l_u_e, the value of the variable is
set to _v_a_l_u_e. When using --aa or --AA and the compound assignment
syntax to create array variables, additional attributes do not
take effect until subsequent assignments. The return value is 0
unless an invalid option is encountered, an attempt is made to
define a function using ``-f foo=bar'', an attempt is made to
assign a value to a readonly variable, an attempt is made to
assign a value to an array variable without using the compound
assignment syntax (see AArrrraayyss above), one of the _n_a_m_e_s is not a
valid shell variable name, an attempt is made to turn off read-
only status for a readonly variable, an attempt is made to turn
unless an invalid option is encountered, an attempt is made to
define a function using ``-f foo=bar'', an attempt is made to
assign a value to a readonly variable, an attempt is made to
assign a value to an array variable without using the compound
assignment syntax (see AArrrraayyss above), one of the _n_a_m_e_s is not a
valid shell variable name, an attempt is made to turn off read-
only status for a readonly variable, an attempt is made to turn
off array status for an array variable, or an attempt is made to
display a non-existent function with --ff.
ddiirrss [[--ccllppvv]] [[++_n]] [[--_n]]
Without options, displays the list of currently remembered
directories. The default display is on a single line with
directory names separated by spaces. Directories are added to
the list with the ppuusshhdd command; the ppooppdd command removes
entries from the list.
Without options, displays the list of currently remembered
directories. The default display is on a single line with
directory names separated by spaces. Directories are added to
the list with the ppuusshhdd command; the ppooppdd command removes
entries from the list. The current directory is always the
first directory in the stack.
--cc Clears the directory stack by deleting all of the
entries.
--ll Produces a listing using full pathnames; the default
@@ -903,12 +905,12 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
ppuusshhdd [--nn] [_d_i_r]
Adds a directory to the top of the directory stack, or rotates
the stack, making the new top of the stack the current working
directory. With no arguments, exchanges the top two directories
and returns 0, unless the directory stack is empty. Arguments,
if supplied, have the following meanings:
--nn Suppresses the normal change of directory when adding
directories to the stack, so that only the stack is
manipulated.
directory. With no arguments, ppuusshhdd exchanges the top two
directories and returns 0, unless the directory stack is empty.
Arguments, if supplied, have the following meanings:
--nn Suppresses the normal change of directory when rotating
or adding directories to the stack, so that only the
stack is manipulated.
++_n Rotates the stack so that the _nth directory (counting
from the left of the list shown by ddiirrss, starting with
zero) is at the top.
doc/builtins.ps
+1098 -1096
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.3
%%CreationDate: Fri Jul 10 10:23:01 2015
%%CreationDate: Tue Aug 18 16:26:51 2015
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.22 3
execute_cmd.c
+1 -1
View File
@@ -4626,7 +4626,7 @@ execute_function (var, words, flags, fds_to_close, async, subshell)
{
return_trap = savestring (return_trap);
add_unwind_protect (xfree, return_trap);
add_unwind_protect (set_return_trap, return_trap);
add_unwind_protect (maybe_set_return_trap, return_trap);
}
restore_default_signal (RETURN_TRAP);
}
lib/readline/input.c
+5 -3
View File
@@ -1,6 +1,6 @@
/* input.c -- character input functions for readline. */
/* Copyright (C) 1994-2013 Free Software Foundation, Inc.
/* Copyright (C) 1994-2015 Free Software Foundation, Inc.
This file is part of the GNU Readline Library (Readline), a library
for reading lines of text with interactive input and history editing.
@@ -216,8 +216,8 @@ rl_gather_tyi ()
#endif
result = -1;
#if defined (FIONREAD)
errno = 0;
#if defined (FIONREAD)
result = ioctl (tty, FIONREAD, &chars_avail);
if (result == -1 && errno == EIO)
return -1;
@@ -236,6 +236,8 @@ rl_gather_tyi ()
fcntl (tty, F_SETFL, tem);
if (chars_avail == -1 && errno == EAGAIN)
return 0;
if (chars_avail == -1 && errno == EIO)
return -1;
if (chars_avail == 0) /* EOF */
{
rl_stuff_char (EOF);
@@ -464,7 +466,7 @@ rl_read_key ()
if ((r = rl_gather_tyi ()) < 0) /* XXX - EIO */
{
rl_done = 1;
return ('\n');
return (errno == EIO ? (RL_ISSTATE (RL_STATE_READCMD) ? READERR : EOF) : '\n');
}
else if (r > 0) /* read something */
continue;
lib/readline/misc.c
+3 -1
View File
@@ -128,7 +128,7 @@ _rl_arg_dispatch (cxt, c)
/* If we see a key bound to `universal-argument' after seeing digits,
it ends the argument but is otherwise ignored. */
if (_rl_keymap[c].type == ISFUNC && _rl_keymap[c].function == rl_universal_argument)
if (c >= 0 && _rl_keymap[c].type == ISFUNC && _rl_keymap[c].function == rl_universal_argument)
{
if ((cxt & NUM_SAWDIGITS) == 0)
{
@@ -268,6 +268,8 @@ _rl_arg_callback (cxt)
int c, r;
c = _rl_arg_getchar ();
if (c < 0)
return (1); /* EOF */
if (_rl_argcxt & NUM_READONE)
{
lib/readline/text.c
+3 -1
View File
@@ -610,7 +610,7 @@ rl_skip_csi_sequence (count, key)
while (ch >= 0x20 && ch < 0x40);
RL_UNSETSTATE (RL_STATE_MOREINPUT);
return 0;
return (ch < 0);
}
int
@@ -622,6 +622,8 @@ rl_arrow_keys (count, c)
RL_SETSTATE(RL_STATE_MOREINPUT);
ch = rl_read_key ();
RL_UNSETSTATE(RL_STATE_MOREINPUT);
if (ch < 0)
return (1);
switch (_rl_to_upper (ch))
{
lib/readline/vi_mode.c
+2 -2
View File
@@ -1280,8 +1280,8 @@ _rl_vi_domove_callback (m)
int c, r;
m->motion = c = rl_vi_domove_getchar (m);
/* XXX - what to do if this returns -1? Should we return 1 for eof to
callback code? */
if (c < 0)
return 1; /* EOF */
r = rl_domove_read_callback (m);
return ((r == 0) ? r : 1); /* normalize return values */
locale.c
+1 -1
View File
@@ -309,7 +309,7 @@ get_locale_var (var)
locale = lc_all;
if (locale == 0 || *locale == 0)
locale = get_string_value (var); /* XXX - mem leak? */
locale = get_string_value (var); /* XXX - no mem leak */
if (locale == 0 || *locale == 0)
locale = lang;
if (locale == 0 || *locale == 0)
parse.y
+19 -2
View File
@@ -1,6 +1,6 @@
/* parse.y - Yacc grammar for bash. */
/* Copyright (C) 1989-2012 Free Software Foundation, Inc.
/* Copyright (C) 1989-2015 Free Software Foundation, Inc.
This file is part of GNU Bash, the Bourne Again SHell.
@@ -2710,10 +2710,27 @@ gather_here_documents ()
brace partner. */
static int open_brace_count;
/* In the following three macros, `token' is always last_read_token */
/* Are we in the middle of parsing a redirection where we are about to read
a word? This is used to make sure alias expansion doesn't happen in the
middle of a redirection, even though we're parsing a simple command. */
#define parsing_redirection(token) \
(token == '<' || token == '>' || \
token == GREATER_GREATER || token == GREATER_BAR || \
token == LESS_GREATER || token == LESS_LESS_MINUS || \
token == LESS_LESS || token == LESS_LESS_LESS || \
token == LESS_AND || token == GREATER_AND || token == AND_GREATER)
/* Is `token' one that will allow a WORD to be read in a command position?
We can read a simple command name on which we should attempt alias expansion
or we can read an assignment statement. */
#define command_token_position(token) \
(((token) == ASSIGNMENT_WORD) || (parser_state&PST_REDIRLIST) || \
(((token) == ASSIGNMENT_WORD) || \
((parser_state&PST_REDIRLIST) && parsing_redirection(token) == 0) || \
((token) != SEMI_SEMI && (token) != SEMI_AND && (token) != SEMI_SEMI_AND && reserved_word_acceptable(token)))
/* Are we in a position where we can read an assignment statement? */
#define assignment_acceptable(token) \
(command_token_position(token) && ((parser_state & PST_CASEPAT) == 0))
quit.h
+2
View File
@@ -50,6 +50,8 @@ extern volatile sig_atomic_t terminating_signal;
#define ADDINTERRUPT interrupt_state++
#define DELINTERRUPT interrupt_state--
#define ISINTERRUPT interrupt_state != 0
/* The same sort of thing, this time just for signals that would ordinarily
cause the shell to terminate. */
shell.c
+3
View File
@@ -1917,6 +1917,9 @@ show_shell_usage (fp, extra)
fprintf (fp, _("Type `%s -c \"help set\"' for more information about shell options.\n"), shell_name);
fprintf (fp, _("Type `%s -c help' for more information about shell builtin commands.\n"), shell_name);
fprintf (fp, _("Use the `bashbug' command to report bugs.\n"));
fprintf (fp, "\n");
fprintf (fp, _("bash home page: <http://www.gnu.org/software/bash>\n"));
fprintf (fp, _("General help using GNU software: <http://www.gnu.org/gethelp/>\n"));
}
}
sig.c
+4 -4
View File
@@ -612,12 +612,12 @@ sigint_sighandler (sig)
ADDINTERRUPT;
/* We will get here in interactive shells with job control active; allow
an interactive wait to be interrupted. */
if (this_shell_builtin && this_shell_builtin == wait_builtin)
an interactive wait to be interrupted. wait_intr_flag is only set during
the execution of the wait builtin and when wait_intr_buf is valid. */
if (wait_intr_flag)
{
last_command_exit_value = 128 + sig;
if (wait_intr_flag)
wait_signal_received = sig;
wait_signal_received = sig;
SIGRETURN (0);
}
subst.c
+8 -2
View File
@@ -6160,7 +6160,6 @@ parameter_brace_expand_word (name, var_is_special, quoted, pflags, indp)
else if (valid_array_reference (name, 0))
{
expand_arrayref:
/* XXX - does this leak if name[@] or name[*]? */
if (pflags & PF_ASSIGNRHS)
{
var = array_variable_part (name, &tt, (int *)0);
@@ -10138,7 +10137,14 @@ shell_expand_word_list (tlist, eflags)
opts[opti] = '\0';
if (opti > 0)
make_internal_declare (tlist->word->word, opts);
{
t = make_internal_declare (tlist->word->word, opts);
if (t != EXECUTION_SUCCESS)
{
last_command_exit_value = t;
exp_jump_to_top_level (DISCARD);
}
}
t = do_word_assignment (tlist->word, 0);
if (t == 0)
support/bashbug.sh
+1
View File
@@ -266,6 +266,7 @@ esac
${RMAIL} $SMARGS < "$TEMPFILE1" || {
cat "$TEMPFILE1" >> $HOME/dead.bashbug
echo "$0: mail to ${BUGADDR} failed: report saved in $HOME/dead.bashbug" >&2
echo "$0: please send it manually to ${BUGADDR}" >&2
}
exit 0
tests/assoc.right
+2
View File
@@ -195,3 +195,5 @@ declare -A assoc=([0]="assoc" )
assoc
declare -A assoc=([two]="twoless" [three]="three" [one]="onemore" )
declare -Ar assoc=([two]="twoless" [three]="three" [one]="onemore" )
./assoc8.sub: line 3: warning: arrfoo=([x]=y): quoted compound array assignment deprecated
./assoc8.sub: line 7: warning: b=([bar]=baz): quoted compound array assignment deprecated
tests/assoc.tests
+2
View File
@@ -205,3 +205,5 @@ declare -p assoc
readonly -A assoc
declare -p assoc
${THIS_SH} ./assoc8.sub
tests/assoc8.sub
+7
View File
@@ -0,0 +1,7 @@
# warnings introduced beginning with bash-4.4-alpha
var=foo; declare -A "arr$var=([x]=y)"
key1=foo key2=bar
declare -A a=([foo]='([bar]=baz)') "b=${a[$key1]}"
tests/errors.right
+22 -1
View File
@@ -122,4 +122,25 @@ after readonly assignment
./errors5.sub: line 7: array: unbound variable
./errors5.sub: line 10: 7: unbound variable
./errors5.sub: line 11: 7: unbound variable
./errors.tests: line 275: `!!': not a valid identifier
/usr/local/build/chet/bash/bash-current/bash: ${x!y}: bad substitution
after 1: 1
/usr/local/build/chet/bash/bash-current/bash: ${#+}: bad substitution
after 2: 1
/usr/local/build/chet/bash/bash-current/bash: ${#foo%}: bad substitution
after 3: 1
/usr/local/build/chet/bash/bash-current/bash: ${b[ ]}: bad substitution
array after 1: 1
/usr/local/build/chet/bash/bash-current/bash: ${v[ ]}: bad substitution
array after 2: 1
./errors6.sub: line 18: ${-3}: bad substitution
./errors6.sub: line 19: -3: bad substitution
after indir: 1
/usr/local/build/chet/bash/bash-current/bash: ${x!y}: bad substitution
/usr/local/build/chet/bash/bash-current/bash: ${#+}: bad substitution
/usr/local/build/chet/bash/bash-current/bash: ${#foo%}: bad substitution
/usr/local/build/chet/bash/bash-current/bash: ${b[ ]}: bad substitution
/usr/local/build/chet/bash/bash-current/bash: ${v[ ]}: bad substitution
./errors6.sub: line 18: ${-3}: bad substitution
./errors6.sub: line 19: -3: bad substitution
after indir: 1
./errors.tests: line 278: `!!': not a valid identifier
tests/errors.tests
+3
View File
@@ -267,6 +267,9 @@ ${THIS_SH} -o posix ./errors4.sub
${THIS_SH} ./errors5.sub
${THIS_SH} ./errors6.sub
THIS_SH="${THIS_SH} -o posix" ${THIS_SH} ./errors6.sub
# this must be last!
# in posix mode, a function name must be a valid identifier
# this can't go in posix2.tests, since it causes the shell to exit
tests/errors6.sub
+20
View File
@@ -0,0 +1,20 @@
# problems with non-fatal expansion errors through bash-4.3
: ${THIS_SH:=./bash}
${THIS_SH} -c 'echo ${x!y} second
echo after 1: $?'
${THIS_SH} -c 'echo ${#+} second
echo after 2: $?'
${THIS_SH} -c 'echo ${#foo%} second
echo after 3: $?'
${THIS_SH} -c 'b[0]=4 ; echo ${b[ ]}
echo array after 1: $?'
${THIS_SH} -c 'typeset -A v ; v["0"]=one ; echo ${v[ ]}
echo array after 2: $?'
echo ${-3}
x=-3; echo ${!x}
echo after indir: $?
tests/varenv.right
+2
View File
@@ -61,6 +61,8 @@ FIN: asdf fdsa, asdf fdsa
g: v = , w =
f: v = , w =
FIN: v = two, w = one
./varenv4.sub: line 54: bbb: unique: cannot convert indexed to associative array
after bbb: 1
declare -Ar FOOBAR=([foo]="bar" )
declare -Ar FOOBAR=([foo]="bar" )
declare -ar FOOBAR2=([0]="bar")
tests/varenv4.sub
+14
View File
@@ -42,3 +42,17 @@ g()
f
echo FIN: v = $v, w = $w
# problem with error return propagation through bash-4.3
unset -f aaa bbb
unset unique
aaa() {
declare -g -a unique=()
}
bbb() {
declare -g -A unique=()
}
aaa
bbb
echo after bbb: $?
trap.c
+7
View File
@@ -621,6 +621,13 @@ set_return_trap (command)
set_signal (RETURN_TRAP, command);
}
void
maybe_set_return_trap (command)
char *command;
{
trap_if_untrapped (RETURN_TRAP, command);
}
#ifdef INCLUDE_UNUSED
void
set_sigint_trap (command)
trap.h
+1
View File
@@ -76,6 +76,7 @@ extern void set_return_trap __P((char *));
extern void maybe_set_debug_trap __P((char *));
extern void maybe_set_error_trap __P((char *));
extern void maybe_set_return_trap __P((char *));
extern void set_sigint_trap __P((char *));
extern void set_signal __P((int, char *));
variables.c
+3 -3
View File
@@ -2219,9 +2219,9 @@ get_variable_value (var)
/* Return the string value of a variable. Return NULL if the variable
doesn't exist. Don't cons a new string. This is a potential memory
leak if the variable is found in the temporary environment. Since
functions and variables have separate name spaces, returns NULL if
var_name is a shell function only. */
leak if the variable is found in the temporary environment, but doesn't
leak in practice. Since functions and variables have separate name
spaces, returns NULL if var_name is a shell function only. */
char *
get_string_value (var_name)
const char *var_name;
version.c
+2 -2
View File
@@ -1,6 +1,6 @@
/* version.c -- distribution and version numbers. */
/* Copyright (C) 1989-2014 Free Software Foundation, Inc.
/* Copyright (C) 1989-2015 Free Software Foundation, Inc.
This file is part of GNU Bash, the Bourne Again SHell.
@@ -43,7 +43,7 @@ const char * const release_status = (char *)0;
#endif
const char * const sccs_version = SCCSVERSION;
const char * const bash_copyright = N_("Copyright (C) 2014 Free Software Foundation, Inc.");
const char * const bash_copyright = N_("Copyright (C) 2015 Free Software Foundation, Inc.");
const char * const bash_license = N_("License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>\n");
/* If == 31, shell compatible with bash-3.1, == 32 with bash-3.2, and so on */