pmodules/bash
0
0
Fork 0
mirror of https://https.git.savannah.gnu.org/git/bash.git synced 2026-06-23 22:07:58 +02:00
Code Issues Packages Projects Releases Wiki Activity

commit bash-20100115 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2011-12-12 21:52:41 -05:00
parent 1665e22a82
commit 5cdaaf76ec
31 changed files with 11109 additions and 8737 deletions
Download Patch File Download Diff File Expand all files Collapse all files
CWRU/CWRU.chlog
+12
View File
@@ -9360,3 +9360,15 @@ parse.y
- change mk_alexpansion to not append a space to an alias
expansion ending with a newline. Works with shell_getc
1/11
----
lib/glob/Makefile.in
- add dependencies on shell.h and pathnames.h. From Mike Frysinger
<vapier@gentoo.org>
1/15
----
doc/{bash.1,{bashref,version}.texi},lib/readine/doc/rluser.texi
- some typo fixes from Aharon Robbins <arnold@skeeve.com>
- added descriptions of ENV, COPROC, and MAPFILE variables
- added descriptions of READLINE_LINE and READLINE_POINT
MANIFEST
+1
View File
@@ -685,6 +685,7 @@ examples/functions/which f
examples/functions/xalias.bash f
examples/functions/xfind.bash f
examples/scripts/adventure.sh f
examples/scripts/bash-hexdump.sh f
examples/scripts/bcsh.sh f
examples/scripts/cat.sh f
examples/scripts/center f
doc/Makefile.in
+1 -1
View File
@@ -161,7 +161,7 @@ html: ${HTMLFILES}
pdf: ${PDFFILES}
bashref.dvi: $(BASHREF_FILES) $(HSUSER) $(RLUSER)
${SET_TEXINPUTS} $(TEXI2DVI) $(srcdir)/bashref.texi
${SET_TEXINPUTS} $(TEXI2DVI) $(srcdir)/bashref.texi || { ${RM} $@ ; exit 1; }
bashref.info: $(BASHREF_FILES) $(HSUSER) $(RLUSER)
$(MAKEINFO) --no-split -I$(TEXINPUTDIR) $(srcdir)/bashref.texi
doc/bash.0
+90 -72
View File
@@ -712,8 +712,8 @@ PPAARRAAMMEETTEERRSS
that do not require bbaasshh to be re-initialized.
BBAASSHH__AALLIIAASSEESS
An associative array variable whose members correspond to the
internal list of aliases as maintained by the aalliiaass builtin Ele-
ments added to this array appear in the alias list; unsetting
internal list of aliases as maintained by the aalliiaass builtin.
Elements added to this array appear in the alias list; unsetting
array elements cause aliases to be removed from the alias list.
BBAASSHH__AARRGGCC
An array variable whose values are the number of parameters in
@@ -832,6 +832,10 @@ PPAARRAAMMEETTEERRSS
tions invoked by the programmable completion facilities (see
PPrrooggrraammmmaabbllee CCoommpplleettiioonn below).
CCOOPPRROOCC An array variable (see AArrrraayyss below) created to hold the file
descriptors for output from and input to an unnamed coprocess
(see CCoopprroocceesssseess above).
DDIIRRSSTTAACCKK
An array variable (see AArrrraayyss below) containing the current con-
tents of the directory stack. Directories appear in the stack
@@ -885,24 +889,28 @@ PPAARRAAMMEETTEERRSS
type on which bbaasshh is executing, in the standard GNU _c_p_u_-_c_o_m_-
_p_a_n_y_-_s_y_s_t_e_m format. The default is system-dependent.
MMAAPPFFIILLEE
An array variable (see AArrrraayyss below) created to hold the text
read by the mmaappffiillee builtin when no variable name is supplied.
OOLLDDPPWWDD The previous working directory as set by the ccdd command.
OOPPTTAARRGG The value of the last option argument processed by the ggeettooppttss
OOPPTTAARRGG The value of the last option argument processed by the ggeettooppttss
builtin command (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below).
OOPPTTIINNDD The index of the next argument to be processed by the ggeettooppttss
OOPPTTIINNDD The index of the next argument to be processed by the ggeettooppttss
builtin command (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below).
OOSSTTYYPPEE Automatically set to a string that describes the operating sys-
tem on which bbaasshh is executing. The default is system-depen-
OOSSTTYYPPEE Automatically set to a string that describes the operating sys-
tem on which bbaasshh is executing. The default is system-depen-
dent.
PPIIPPEESSTTAATTUUSS
An array variable (see AArrrraayyss below) containing a list of exit
status values from the processes in the most-recently-executed
An array variable (see AArrrraayyss below) containing a list of exit
status values from the processes in the most-recently-executed
foreground pipeline (which may contain only a single command).
PPPPIIDD The process ID of the shell's parent. This variable is read-
PPPPIIDD The process ID of the shell's parent. This variable is read-
only.
PPWWDD The current working directory as set by the ccdd command.
@@ -910,27 +918,35 @@ PPAARRAAMMEETTEERRSS
RRAANNDDOOMM Each time this parameter is referenced, a random integer between
0 and 32767 is generated. The sequence of random numbers may be
initialized by assigning a value to RRAANNDDOOMM. If RRAANNDDOOMM is unset,
it loses its special properties, even if it is subsequently
it loses its special properties, even if it is subsequently
reset.
RREEPPLLYY Set to the line of input read by the rreeaadd builtin command when
RREEAADDLLIINNEE__LLIINNEE
The contents of the rreeaaddlliinnee line buffer, for use with "bind -x"
(see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below).
RREEAADDLLIINNEE__PPOOIINNTT
The position of the insertion point in the rreeaaddlliinnee line buffer,
for use with "bind -x" (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below).
RREEPPLLYY Set to the line of input read by the rreeaadd builtin command when
no arguments are supplied.
SSEECCOONNDDSS
Each time this parameter is referenced, the number of seconds
since shell invocation is returned. If a value is assigned to
SSEECCOONNDDSS, the value returned upon subsequent references is the
number of seconds since the assignment plus the value assigned.
Each time this parameter is referenced, the number of seconds
since shell invocation is returned. If a value is assigned to
SSEECCOONNDDSS, the value returned upon subsequent references is the
number of seconds since the assignment plus the value assigned.
If SSEECCOONNDDSS is unset, it loses its special properties, even if it
is subsequently reset.
SSHHEELLLLOOPPTTSS
A colon-separated list of enabled shell options. Each word in
the list is a valid argument for the --oo option to the sseett
A colon-separated list of enabled shell options. Each word in
the list is a valid argument for the --oo option to the sseett
builtin command (see SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS below). The options
appearing in SSHHEELLLLOOPPTTSS are those reported as _o_n by sseett --oo. If
this variable is in the environment when bbaasshh starts up, each
shell option in the list will be enabled before reading any
appearing in SSHHEELLLLOOPPTTSS are those reported as _o_n by sseett --oo. If
this variable is in the environment when bbaasshh starts up, each
shell option in the list will be enabled before reading any
startup files. This variable is read-only.
SSHHLLVVLL Incremented by one each time an instance of bbaasshh is started.
@@ -938,20 +954,16 @@ PPAARRAAMMEETTEERRSS
UUIIDD Expands to the user ID of the current user, initialized at shell
startup. This variable is readonly.
The following variables are used by the shell. In some cases, bbaasshh
The following variables are used by the shell. In some cases, bbaasshh
assigns a default value to a variable; these cases are noted below.
BBAASSHH__EENNVV
If this parameter is set when bbaasshh is executing a shell script,
its value is interpreted as a filename containing commands to
If this parameter is set when bbaasshh is executing a shell script,
its value is interpreted as a filename containing commands to
initialize the shell, as in _~_/_._b_a_s_h_r_c. The value of BBAASSHH__EENNVV is
subjected to parameter expansion, command substitution, and
arithmetic expansion before being interpreted as a file name.
subjected to parameter expansion, command substitution, and
arithmetic expansion before being interpreted as a file name.
PPAATTHH is not used to search for the resultant file name.
CCDDPPAATTHH The search path for the ccdd command. This is a colon-separated
list of directories in which the shell looks for destination
directories specified by the ccdd command. A sample value is
".:~:/usr".
BBAASSHH__XXTTRRAACCEEFFDD
If set to an integer corresponding to a valid file descriptor,
bbaasshh will write the trace output generated when _s_e_t _-_x is
@@ -961,17 +973,23 @@ PPAARRAAMMEETTEERRSS
output to be sent to the standard error. Note that setting
BBAASSHH__XXTTRRAACCEEFFDD to 2 (the standard error file descriptor) and then
unsetting it will result in the standard error being closed.
CCDDPPAATTHH The search path for the ccdd command. This is a colon-separated
list of directories in which the shell looks for destination
directories specified by the ccdd command. A sample value is
".:~:/usr".
CCOOLLUUMMNNSS
Used by the sseelleecctt builtin command to determine the terminal
width when printing selection lists. Automatically set upon
receipt of a SIGWINCH.
Used by the sseelleecctt builtin command to determine the terminal
width when printing selection lists. Automatically set upon
receipt of a SSIIGGWWIINNCCHH.
CCOOMMPPRREEPPLLYY
An array variable from which bbaasshh reads the possible completions
generated by a shell function invoked by the programmable com-
generated by a shell function invoked by the programmable com-
pletion facility (see PPrrooggrraammmmaabbllee CCoommpplleettiioonn below).
EEMMAACCSS If bbaasshh finds this variable in the environment when the shell
starts with value "t", it assumes that the shell is running in
EEMMAACCSS If bbaasshh finds this variable in the environment when the shell
starts with value "t", it assumes that the shell is running in
an emacs shell buffer and disables line editing.
EENNVV Similar to BBAASSHH__EENNVV; used when the shell is invoked in POSIX
mode.
FFCCEEDDIITT The default editor for the ffcc builtin command.
FFIIGGNNOORREE
A colon-separated list of suffixes to ignore when performing
@@ -1545,7 +1563,7 @@ EEXXPPAANNSSIIOONN
operator converts matching uppercase letters to lowercase. The
^^^^ and ,,,, expansions convert each matched character in the
expanded value; the ^^ and ,, expansions match and convert only
the first character in the expanded value.. If _p_a_t_t_e_r_n is omit-
the first character in the expanded value. If _p_a_t_t_e_r_n is omit-
ted, it is treated like a ??, which matches every character. If
_p_a_r_a_m_e_t_e_r is @@ or **, the case modification operation is applied
to each positional parameter in turn, and the expansion is the
@@ -2157,26 +2175,26 @@ CCOONNDDIITTIIOONNAALL EEXXPPRREESSSSIIOONNSS
True if _f_i_l_e exists and is writable.
--xx _f_i_l_e
True if _f_i_l_e exists and is executable.
--OO _f_i_l_e
True if _f_i_l_e exists and is owned by the effective user id.
--GG _f_i_l_e
True if _f_i_l_e exists and is owned by the effective group id.
--LL _f_i_l_e
True if _f_i_l_e exists and is a symbolic link.
--SS _f_i_l_e
True if _f_i_l_e exists and is a socket.
--NN _f_i_l_e
True if _f_i_l_e exists and has been modified since it was last
read.
_f_i_l_e_1 -nntt _f_i_l_e_2
True if _f_i_l_e_1 is newer (according to modification date) than
_f_i_l_e_2, or if _f_i_l_e_1 exists and _f_i_l_e_2 does not.
_f_i_l_e_1 -oott _f_i_l_e_2
True if _f_i_l_e_1 is older than _f_i_l_e_2, or if _f_i_l_e_2 exists and _f_i_l_e_1
does not.
--OO _f_i_l_e
True if _f_i_l_e exists and is owned by the effective user id.
--SS _f_i_l_e
True if _f_i_l_e exists and is a socket.
_f_i_l_e_1 --eeff _f_i_l_e_2
True if _f_i_l_e_1 and _f_i_l_e_2 refer to the same device and inode num-
bers.
_f_i_l_e_1 -nntt _f_i_l_e_2
True if _f_i_l_e_1 is newer (according to modification date) than
_f_i_l_e_2, or if _f_i_l_e_1 exists and _f_i_l_e_2 does not.
_f_i_l_e_1 -oott _f_i_l_e_2
True if _f_i_l_e_1 is older than _f_i_l_e_2, or if _f_i_l_e_2 exists and _f_i_l_e_1
does not.
--oo _o_p_t_n_a_m_e
True if shell option _o_p_t_n_a_m_e is enabled. See the list of
options under the description of the --oo option to the sseett
@@ -3785,7 +3803,7 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
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-
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-
plied as _e_x_p_r, ccaalllleerr displays the line number, subroutine name,
@@ -3938,23 +3956,29 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
vvaarriiaabbllee
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
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 it finishes, the possible com-
pletions are retrieved from the value of the CCOOMMPPRREEPPLLYY
array variable.
--GG _g_l_o_b_p_a_t
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-
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-
pleted.
--CC _c_o_m_m_a_n_d
_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 it finishes, the possible com-
pletions are retrieved from the value of the CCOOMMPPRREEPPLLYY
array variable.
--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.
It is applied to the list of possible completions gener-
@@ -3962,12 +3986,6 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
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.
--PP _p_r_e_f_i_x
_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.
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-
@@ -3977,7 +3995,7 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
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-execution completion if no _n_a_m_es
_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
@@ -3988,9 +4006,9 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
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, an
attempt is made to modify the options for a _n_a_m_e for which no comple-
tion specification exists, or an output error occurs.
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
@@ -4057,7 +4075,7 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
an array variable, or an attempt is made to display a non-exis-
tent function with --ff.
ddiirrss [[++_n]] [[--_n]] [[--ccppllvv]]
ddiirrss [[++_n]] [[--_n]] [[--ccllppvv]]
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
@@ -4353,10 +4371,10 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
The first form lists the active jobs. The options have the fol-
lowing meanings:
--ll List process IDs in addition to the normal information.
--nn Display information only about jobs that have changed
status since the user was last notified of their status.
--pp List only the process ID of the job's process group
leader.
--nn Display information only about jobs that have changed
status since the user was last notified of their status.
--rr Restrict output to running jobs.
--ss Restrict output to stopped jobs.
@@ -4903,7 +4921,7 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
(( _c_o_m_m_a_n_d )) inherit the DDEEBBUUGG and RREETTUURRNN traps.
66.. Error tracing is enabled: command substitution,
shell functions, and subshells invoked with ((
_c_o_m_m_a_n_d )) inherit the EERRRROORR trap.
_c_o_m_m_a_n_d )) inherit the EERRRR trap.
eexxttgglloobb If set, the extended pattern matching features described
above under PPaatthhnnaammee EExxppaannssiioonn are enabled.
eexxttqquuoottee
@@ -5090,7 +5108,7 @@ SSHHEELLLL BBUUIILLTTIINN CCOOMMMMAANNDDSS
causes the shell to print a list of signal names and their cor-
responding numbers. Each _s_i_g_s_p_e_c is either a signal name
defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are
case insensitive and the SIG prefix is optional.
case insensitive and the SSIIGG prefix is optional.
If a _s_i_g_s_p_e_c is EEXXIITT (0) the command _a_r_g is executed on exit
from the shell. If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is exe-
@@ -5310,7 +5328,7 @@ BBUUGG RREEPPOORRTTSS
If you find a bug in bbaasshh,, you should report it. But first, you should
make sure that it really is a bug, and that it appears in the latest
version of bbaasshh. The latest version is always available from
_f_t_p_:_/_/_f_t_p_._g_n_u_._o_r_g_/_p_u_b_/_b_a_s_h_/.
_f_t_p_:_/_/_f_t_p_._g_n_u_._o_r_g_/_p_u_b_/_g_n_u_/_b_a_s_h_/.
Once you have determined that a bug actually exists, use the _b_a_s_h_b_u_g
command to submit a bug report. If you have a fix, you are encouraged
@@ -5355,4 +5373,4 @@ BBUUGGSS
GNU Bash-4.1 2009 December 29 BASH(1)
GNU Bash-4.1 2010 January 15 BASH(1)
doc/bash.1
+89 -52
View File
@@ -5,12 +5,12 @@
.\" Case Western Reserve University
.\" chet@po.cwru.edu
.\"
.\" Last Change: Tue Dec 29 15:36:16 EST 2009
.\" Last Change: Fri Jan 15 10:50:42 EST 2010
.\"
.\" bash_builtins, strip all but Built-Ins section
.if \n(zZ=1 .ig zZ
.if \n(zY=1 .ig zY
.TH BASH 1 "2009 December 29" "GNU Bash-4.1"
.TH BASH 1 "2010 January 15" "GNU Bash-4.1"
.\"
.\" There's some problem with having a `@'
.\" in a tagged paragraph with the BSD man macros.
@@ -1358,7 +1358,7 @@ that do not require \fBbash\fP to be re-initialized.
.TP
.B BASH_ALIASES
An associative array variable whose members correspond to the internal
list of aliases as maintained by the \fBalias\fP builtin
list of aliases as maintained by the \fBalias\fP builtin.
Elements added to this array appear in the alias list; unsetting array
elements cause aliases to be removed from the alias list.
.TP
@@ -1544,6 +1544,11 @@ This variable is available only in shell functions invoked by the
programmable completion facilities (see \fBProgrammable Completion\fP
below).
.TP
.B COPROC
An array variable (see \fBArrays\fP below) created to hold the file descriptors
for output from and input to an unnamed coprocess (see \fBCoprocesses\fP
above).
.TP
.B DIRSTACK
An array variable (see
.B Arrays
@@ -1638,6 +1643,10 @@ type on which
is executing, in the standard GNU \fIcpu-company-system\fP format.
The default is system-dependent.
.TP
.B MAPFILE
An array variable (see \fBArrays\fP below) created to hold the text
read by the \fBmapfile\fP builtin when no variable name is supplied.
.TP
.B OLDPWD
The previous working directory as set by the
.B cd
@@ -1694,6 +1703,28 @@ If
is unset, it loses its special properties, even if it is
subsequently reset.
.TP
.B READLINE_LINE
The contents of the
.B readline
line buffer, for use with
.if t \f(CWbind -x\fP
.if n "bind -x"
(see
.SM
.B "SHELL BUILTIN COMMANDS"
below).
.TP
.B READLINE_POINT
The position of the insertion point in the
.B readline
line buffer, for use with
.if t \f(CWbind -x\fP
.if n "bind -x"
(see
.SM
.B "SHELL BUILTIN COMMANDS"
below).
.TP
.B REPLY
Set to the line of input read by the
.B read
@@ -1766,18 +1797,6 @@ expansion before being interpreted as a file name.
.B PATH
is not used to search for the resultant file name.
.TP
.B CDPATH
The search path for the
.B cd
command.
This is a colon-separated list of directories in which the shell looks
for destination directories specified by the
.B cd
command.
A sample value is
.if t \f(CW".:~:/usr"\fP.
.if n ".:~:/usr".
.TP
.B BASH_XTRACEFD
If set to an integer corresponding to a valid file descriptor, \fBbash\fP
will write the trace output generated when
@@ -1800,6 +1819,18 @@ to 2 (the standard error file
descriptor) and then unsetting it will result in the standard error
being closed.
.TP
.B CDPATH
The search path for the
.B cd
command.
This is a colon-separated list of directories in which the shell looks
for destination directories specified by the
.B cd
command.
A sample value is
.if t \f(CW".:~:/usr"\fP.
.if n ".:~:/usr".
.TP
.B COLUMNS
Used by the \fBselect\fP builtin command to determine the terminal width
when printing selection lists. Automatically set upon receipt of a
@@ -1819,6 +1850,12 @@ with value
it assumes that the shell is running in an emacs shell buffer and disables
line editing.
.TP
.B ENV
Similar to
.SM
.BR BASH_ENV ;
used when the shell is invoked in POSIX mode.
.TP
.B FCEDIT
The default editor for the
.B fc
@@ -2844,7 +2881,7 @@ to uppercase; the \fB,\fP operator converts matching uppercase letters
to lowercase.
The \fB^^\fP and \fB,,\fP expansions convert each matched character in the
expanded value; the \fB^\fP and \fB,\fP expansions match and convert only
the first character in the expanded value..
the first character in the expanded value.
If \fIpattern\fP is omitted, it is treated like a \fB?\fP, which matches
every character.
If
@@ -3950,20 +3987,24 @@ True if \fIfile\fP exists and is writable.
.B \-x \fIfile\fP
True if \fIfile\fP exists and is executable.
.TP
.B \-O \fIfile\fP
True if \fIfile\fP exists and is owned by the effective user id.
.TP
.B \-G \fIfile\fP
True if \fIfile\fP exists and is owned by the effective group id.
.TP
.B \-L \fIfile\fP
True if \fIfile\fP exists and is a symbolic link.
.TP
.B \-N \fIfile\fP
True if \fIfile\fP exists and has been modified since it was last read.
.TP
.B \-O \fIfile\fP
True if \fIfile\fP exists and is owned by the effective user id.
.TP
.B \-S \fIfile\fP
True if \fIfile\fP exists and is a socket.
.TP
.B \-N \fIfile\fP
True if \fIfile\fP exists and has been modified since it was last read.
\fIfile1\fP \fB\-ef\fP \fIfile2\fP
True if \fIfile1\fP and \fIfile2\fP refer to the same device and
inode numbers.
.TP
\fIfile1\fP \-\fBnt\fP \fIfile2\fP
True if \fIfile1\fP is newer (according to modification date) than \fIfile2\fP,
@@ -3973,10 +4014,6 @@ or if \fIfile1\fP exists and \fPfile2\fP does not.
True if \fIfile1\fP is older than \fIfile2\fP, or if \fIfile2\fP exists
and \fIfile1\fP does not.
.TP
\fIfile1\fP \fB\-ef\fP \fIfile2\fP
True if \fIfile1\fP and \fIfile2\fP refer to the same device and
inode numbers.
.TP
.B \-o \fIoptname\fP
True if shell option
.I optname
@@ -6657,7 +6694,7 @@ is not a shell builtin command.
.TP
\fBcaller\fP [\fIexpr\fP]
Returns the context of any active subroutine call (a shell function or
a script executed with the \fB.\fP or \fBsource\fP builtins.
a script executed with the \fB.\fP or \fBsource\fP builtins).
Without \fIexpr\fP, \fBcaller\fP displays the line number and source
filename of the current subroutine call.
If a non-negative integer is supplied as \fIexpr\fP, \fBcaller\fP
@@ -6928,18 +6965,6 @@ User names. May also be specified as \fB\-u\fP.
Names of all shell variables. May also be specified as \fB\-v\fP.
.RE
.TP 8
\fB\-G\fP \fIglobpat\fP
The pathname expansion pattern \fIglobpat\fP is expanded to generate
the possible completions.
.TP 8
\fB\-W\fP \fIwordlist\fP
The \fIwordlist\fP is split using the characters in the
.SM
.B IFS
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 completed.
.TP 8
\fB\-C\fP \fIcommand\fP
\fIcommand\fP is executed in a subshell environment, and its output is
used as the possible completions.
@@ -6953,13 +6978,9 @@ of the
.B COMPREPLY
array variable.
.TP 8
\fB\-X\fP \fIfilterpat\fP
\fIfilterpat\fP is a pattern as used for pathname expansion.
It is applied to the list of possible completions generated by the
preceding options and arguments, and each completion matching
\fIfilterpat\fP is removed from the list.
A leading \fB!\fP in \fIfilterpat\fP negates the pattern; in this
case, any completion not matching \fIfilterpat\fP is removed.
\fB\-G\fP \fIglobpat\fP
The pathname expansion pattern \fIglobpat\fP is expanded to generate
the possible completions.
.TP 8
\fB\-P\fP \fIprefix\fP
\fIprefix\fP is added at the beginning of each possible completion
@@ -6968,6 +6989,22 @@ after all other options have been applied.
\fB\-S\fP \fIsuffix\fP
\fIsuffix\fP is appended to each possible completion
after all other options have been applied.
.TP 8
\fB\-W\fP \fIwordlist\fP
The \fIwordlist\fP is split using the characters in the
.SM
.B IFS
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 completed.
.TP 8
\fB\-X\fP \fIfilterpat\fP
\fIfilterpat\fP is a pattern as used for pathname expansion.
It is applied to the list of possible completions generated by the
preceding options and arguments, and each completion matching
\fIfilterpat\fP is removed from the list.
A leading \fB!\fP in \fIfilterpat\fP negates the pattern; in this
case, any completion not matching \fIfilterpat\fP is removed.
.PD
.PP
The return value is true unless an invalid option is supplied, an option
@@ -6980,7 +7017,7 @@ an error occurs adding a completion specification.
\fBcompopt\fP [\fB\-o\fP \fIoption\fP] [\fB\-DE\fP] [\fB+o\fP \fIoption\fP] [\fIname\fP]
Modify completion options for each \fIname\fP according to the
\fIoption\fPs, or for the
currently-executing100 completion if no \fIname\fPs are supplied.
currently-executing completion if no \fIname\fPs are supplied.
If no \fIoption\fPs are given, display the completion options for each
\fIname\fP or the current completion.
The possible values of \fIoption\fP are those valid for the \fBcomplete\fP
@@ -7121,7 +7158,7 @@ an attempt is made to turn off array status for an array variable,
or an attempt is made to display a non-existent function with \fB\-f\fP.
.RE
.TP
.B dirs [+\fIn\fP] [\-\fIn\fP] [\fB\-cplv\fP]
.B dirs [+\fIn\fP] [\-\fIn\fP] [\fB\-clpv\fP]
Without options, displays the list of currently remembered directories.
The default display is on a single line with directory names separated
by spaces.
@@ -7770,14 +7807,14 @@ meanings:
List process IDs
in addition to the normal information.
.TP
.B \-p
List only the process ID of the job's process group
leader.
.TP
.B \-n
Display information only about jobs that have changed status since
the user was last notified of their status.
.TP
.B \-p
List only the process ID of the job's process group
leader.
.TP
.B \-r
Restrict output to running jobs.
.TP
@@ -8829,7 +8866,7 @@ subshells invoked with \fB(\fP \fIcommand\fP \fB)\fP inherit the
.B 6.
Error tracing is enabled: command substitution, shell functions, and
subshells invoked with \fB(\fP \fIcommand\fP \fB)\fP inherit the
\fBERROR\fP trap.
\fBERR\fP trap.
.RE
.TP 8
.B extglob
doc/bash.html
+114 -63
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2009 December 29<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2010 January 15<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -1768,7 +1768,7 @@ that do not require <B>bash</B> to be re-initialized.
<DD>
An associative array variable whose members correspond to the internal
list of aliases as maintained by the <B>alias</B> builtin
list of aliases as maintained by the <B>alias</B> builtin.
Elements added to this array appear in the alias list; unsetting array
elements cause aliases to be removed from the alias list.
<DT><B>BASH_ARGC</B>
@@ -1995,6 +1995,12 @@ as described above.
This variable is available only in shell functions invoked by the
programmable completion facilities (see <B>Programmable Completion</B>
below).
<DT><B>COPROC</B>
<DD>
An array variable (see <B>Arrays</B> below) created to hold the file descriptors
for output from and input to an unnamed coprocess (see <B>Coprocesses</B>
above).
<DT><B>DIRSTACK</B>
<DD>
@@ -2111,6 +2117,11 @@ type on which
is executing, in the standard GNU <I>cpu-company-system</I> format.
The default is system-dependent.
<DT><B>MAPFILE</B>
<DD>
An array variable (see <B>Arrays</B> below) created to hold the text
read by the <B>mapfile</B> builtin when no variable name is supplied.
<DT><B>OLDPWD</B>
<DD>
@@ -2185,6 +2196,34 @@ If
</FONT>
is unset, it loses its special properties, even if it is
subsequently reset.
<DT><B>READLINE_LINE</B>
<DD>
The contents of the
<B>readline</B>
line buffer, for use with
<TT>bind -x</TT>
(see
<FONT SIZE=-1><B>SHELL BUILTIN COMMANDS</B>
</FONT>
below).
<DT><B>READLINE_POINT</B>
<DD>
The position of the insertion point in the
<B>readline</B>
line buffer, for use with
<TT>bind -x</TT>
(see
<FONT SIZE=-1><B>SHELL BUILTIN COMMANDS</B>
</FONT>
below).
<DT><B>REPLY</B>
<DD>
@@ -2281,21 +2320,6 @@ expansion before being interpreted as a file name.
</FONT>
is not used to search for the resultant file name.
<DT><B>CDPATH</B>
<DD>
The search path for the
<B>cd</B>
command.
This is a colon-separated list of directories in which the shell looks
for destination directories specified by the
<B>cd</B>
command.
A sample value is
<TT>&quot;.:~:/usr&quot;</TT>.
<DT><B>BASH_XTRACEFD</B>
<DD>
@@ -2322,11 +2346,29 @@ Note that setting
to 2 (the standard error file
descriptor) and then unsetting it will result in the standard error
being closed.
<DT><B>CDPATH</B>
<DD>
The search path for the
<B>cd</B>
command.
This is a colon-separated list of directories in which the shell looks
for destination directories specified by the
<B>cd</B>
command.
A sample value is
<TT>&quot;.:~:/usr&quot;</TT>.
<DT><B>COLUMNS</B>
<DD>
Used by the <B>select</B> builtin command to determine the terminal width
when printing selection lists. Automatically set upon receipt of a SIGWINCH.
when printing selection lists. Automatically set upon receipt of a
<FONT SIZE=-1><B>SIGWINCH</B>.
</FONT>
<DT><B>COMPREPLY</B>
<DD>
@@ -2342,6 +2384,14 @@ with value
it assumes that the shell is running in an emacs shell buffer and disables
line editing.
<DT><B>ENV</B>
<DD>
Similar to
<FONT SIZE=-1><B>BASH_ENV</B>;
</FONT>
used when the shell is invoked in POSIX mode.
<DT><B>FCEDIT</B>
<DD>
@@ -3610,7 +3660,7 @@ to uppercase; the <B>,</B> operator converts matching uppercase letters
to lowercase.
The <B>^^</B> and <B>,,</B> expansions convert each matched character in the
expanded value; the <B>^</B> and <B>,</B> expansions match and convert only
the first character in the expanded value..
the first character in the expanded value.
If <I>pattern</I> is omitted, it is treated like a <B>?</B>, which matches
every character.
If
@@ -5103,10 +5153,6 @@ True if <I>file</I> exists and is writable.
<DD>
True if <I>file</I> exists and is executable.
<DT><B>-O </B><I>file</I>
<DD>
True if <I>file</I> exists and is owned by the effective user id.
<DT><B>-G </B><I>file</I>
<DD>
@@ -5115,23 +5161,27 @@ True if <I>file</I> exists and is owned by the effective group id.
<DD>
True if <I>file</I> exists and is a symbolic link.
<DT><B>-S </B><I>file</I>
<DD>
True if <I>file</I> exists and is a socket.
<DT><B>-N </B><I>file</I>
<DD>
True if <I>file</I> exists and has been modified since it was last read.
<DT><B>-O </B><I>file</I>
<DD>
True if <I>file</I> exists and is owned by the effective user id.
<DT><B>-S </B><I>file</I>
<DD>
True if <I>file</I> exists and is a socket.
<DT><I>file1</I> <B>-ef</B> <I>file2</I><DD>
True if <I>file1</I> and <I>file2</I> refer to the same device and
inode numbers.
<DT><I>file1</I> -<B>nt</B> <I>file2</I><DD>
True if <I>file1</I> is newer (according to modification date) than <I>file2</I>,
or if <I>file1</I> exists and file2 does not.
<DT><I>file1</I> -<B>ot</B> <I>file2</I><DD>
True if <I>file1</I> is older than <I>file2</I>, or if <I>file2</I> exists
and <I>file1</I> does not.
<DT><I>file1</I> <B>-ef</B> <I>file2</I><DD>
True if <I>file1</I> and <I>file2</I> refer to the same device and
inode numbers.
<DT><B>-o </B><I>optname</I>
<DD>
@@ -8596,7 +8646,7 @@ The return status is false if
is not a shell builtin command.
<DT><B>caller</B> [<I>expr</I>]<DD>
Returns the context of any active subroutine call (a shell function or
a script executed with the <B>.</B> or <B>source</B> builtins.
a script executed with the <B>.</B> or <B>source</B> builtins).
Without <I>expr</I>, <B>caller</B> displays the line number and source
filename of the current subroutine call.
If a non-negative integer is supplied as <I>expr</I>, <B>caller</B>
@@ -8931,17 +8981,6 @@ User names. May also be specified as <B>-u</B>.
Names of all shell variables. May also be specified as <B>-v</B>.
</DL></DL>
<DT><B>-G</B> <I>globpat</I><DD>
The pathname expansion pattern <I>globpat</I> is expanded to generate
the possible completions.
<DT><B>-W</B> <I>wordlist</I><DD>
The <I>wordlist</I> is split using the characters in the
<FONT SIZE=-1><B>IFS</B>
</FONT>
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 completed.
<DT><B>-C</B> <I>command</I><DD>
<I>command</I> is executed in a subshell environment, and its output is
used as the possible completions.
@@ -8954,6 +8993,23 @@ of the
</FONT>
array variable.
<DT><B>-G</B> <I>globpat</I><DD>
The pathname expansion pattern <I>globpat</I> is expanded to generate
the possible completions.
<DT><B>-P</B> <I>prefix</I><DD>
<I>prefix</I> is added at the beginning of each possible completion
after all other options have been applied.
<DT><B>-S</B> <I>suffix</I><DD>
<I>suffix</I> is appended to each possible completion
after all other options have been applied.
<DT><B>-W</B> <I>wordlist</I><DD>
The <I>wordlist</I> is split using the characters in the
<FONT SIZE=-1><B>IFS</B>
</FONT>
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 completed.
<DT><B>-X</B> <I>filterpat</I><DD>
<I>filterpat</I> is a pattern as used for pathname expansion.
It is applied to the list of possible completions generated by the
@@ -8961,12 +9017,6 @@ preceding options and arguments, and each completion matching
<I>filterpat</I> is removed from the list.
A leading <B>!</B> in <I>filterpat</I> negates the pattern; in this
case, any completion not matching <I>filterpat</I> is removed.
<DT><B>-P</B> <I>prefix</I><DD>
<I>prefix</I> is added at the beginning of each possible completion
after all other options have been applied.
<DT><B>-S</B> <I>suffix</I><DD>
<I>suffix</I> is appended to each possible completion
after all other options have been applied.
</DL>
<P>
@@ -8981,7 +9031,7 @@ an error occurs adding a completion specification.
<DT><B>compopt</B> [<B>-o</B> <I>option</I>] [<B>-DE</B>] [<B>+o</B> <I>option</I>] [<I>name</I>]<DD>
Modify completion options for each <I>name</I> according to the
<I>option</I>s, or for the
currently-execution completion if no <I>name</I>s are supplied.
currently-executing completion if no <I>name</I>s are supplied.
If no <I>option</I>s are given, display the completion options for each
<I>name</I> or the current completion.
The possible values of <I>option</I> are those valid for the <B>complete</B>
@@ -8992,13 +9042,10 @@ on a command for which no completion has previously been defined.
The <B>-E</B> option indicates that the remaining options should
apply to ``empty'' command completion; that is, completion attempted on a
blank line.
</DL>
<P>
The return value is true unless an invalid option is supplied, an attempt
is made to modify the options for a <I>name</I> for which no completion
specification exists, or an output error occurs.
<DL COMPACT>
<DT><B>continue</B> [<I>n</I>]<DD>
Resume the next iteration of the enclosing
<B>for</B>,
@@ -9153,7 +9200,7 @@ 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 <B>-f</B>.
</DL>
<DT><B>dirs [+</B><I>n</I>] [-<I>n</I>] [<B>-cplv</B>]
<DT><B>dirs [+</B><I>n</I>] [-<I>n</I>] [<B>-clpv</B>]
<DD>
Without options, displays the list of currently remembered directories.
@@ -9954,16 +10001,16 @@ meanings:
<DD>
List process IDs
in addition to the normal information.
<DT><B>-p</B>
<DD>
List only the process ID of the job's process group
leader.
<DT><B>-n</B>
<DD>
Display information only about jobs that have changed status since
the user was last notified of their status.
<DT><B>-p</B>
<DD>
List only the process ID of the job's process group
leader.
<DT><B>-r</B>
<DD>
@@ -11311,7 +11358,7 @@ subshells invoked with <B>(</B> <I>command</I> <B>)</B> inherit the
<DD>
Error tracing is enabled: command substitution, shell functions, and
subshells invoked with <B>(</B> <I>command</I> <B>)</B> inherit the
<B>ERROR</B> trap.
<B>ERR</B> trap.
</DL></DL>
<DT><B>extglob</B>
@@ -11715,7 +11762,11 @@ Each
is either
a signal name defined in &lt;<I>signal.h</I>&gt;, or a signal number.
Signal names are case insensitive and the SIG prefix is optional.
Signal names are case insensitive and the
<FONT SIZE=-1><B>SIG</B>
</FONT>
prefix is optional.
<P>
@@ -12375,7 +12426,7 @@ version of
<B>bash</B>.
The latest version is always available from
<I><A HREF="ftp://ftp.gnu.org/pub/bash/">ftp://ftp.gnu.org/pub/bash/</A></I>.
<I><A HREF="ftp://ftp.gnu.org/pub/gnu/bash/">ftp://ftp.gnu.org/pub/gnu/bash/</A></I>.
<P>
Once you have determined that a bug actually exists, use the
@@ -12460,7 +12511,7 @@ There may be only one active coprocess at a time.
<HR>
<TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>GNU Bash-4.1<TH ALIGN=CENTER width=33%>2009 December 29<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash-4.1<TH ALIGN=CENTER width=33%>2010 January 15<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -12566,6 +12617,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 30 December 2009 13:07:38 EST
Time: 15 January 2010 11:58:10 EST
</BODY>
</HTML>
doc/bash.pdf
BIN
View File
Binary file not shown.
doc/bash.ps
+5085 -5056
View File
File diff suppressed because it is too large Load Diff
doc/bashref.dvi
BIN
View File
Binary file not shown.
doc/bashref.html
+821 -763
View File
File diff suppressed because it is too large Load Diff
doc/bashref.info
+246 -210
View File
@@ -2,9 +2,9 @@ This is bashref.info, produced by makeinfo version 4.13 from
/Users/chet/src/bash/src/doc/bashref.texi.
This text is a brief description of the features that are present in
the Bash shell (version 4.1, 23 December 2009).
the Bash shell (version 4.1, 15 January 2010).
This is Edition 4.1, last updated 23 December 2009, of `The GNU Bash
This is Edition 4.1, last updated 15 January 2010, of `The GNU Bash
Reference Manual', for `Bash', Version 4.1.
Copyright (C) 1988-2009 Free Software Foundation, Inc.
@@ -38,9 +38,9 @@ Bash Features
*************
This text is a brief description of the features that are present in
the Bash shell (version 4.1, 23 December 2009).
the Bash shell (version 4.1, 15 January 2010).
This is Edition 4.1, last updated 23 December 2009, of `The GNU Bash
This is Edition 4.1, last updated 15 January 2010, of `The GNU Bash
Reference Manual', for `Bash', Version 4.1.
Bash contains features that appear in other popular shells, and some
@@ -3787,6 +3787,17 @@ This builtin allows you to change additional shell optional behavior.
respect to quoted arguments to the conditional command's =~
operator.
`compat32'
If set, Bash changes its behavior to that of version 3.2 with
respect to locale-specific string comparison when using the
conditional command's < and > operators.
`compat40'
If set, Bash changes its behavior to that of version 4.0 with
respect to locale-specific string comparison when using the
conditional command's < and > operators and the effect of
interrupting a command list.
`dirspell'
If set, Bash attempts spelling correction on directory names
during word completion if the directory name initially
@@ -3833,7 +3844,7 @@ This builtin allows you to change additional shell optional behavior.
6. Error tracing is enabled: command substitution, shell
functions, and subshells invoked with `( COMMAND )'
inherit the `ERROR' trap.
inherit the `ERR' trap.
`extglob'
If set, the extended pattern matching features described above
@@ -4264,6 +4275,10 @@ Variables::).
generated by a shell function invoked by the programmable
completion facility (*note Programmable Completion::).
`COPROC'
An array variable created to hold the file descriptors for output
from and input to an unnamed coprocess (*note Coprocesses::).
`DIRSTACK'
An array variable containing the current contents of the directory
stack. Directories appear in the stack in the order they are
@@ -4279,6 +4294,10 @@ Variables::).
starts with value `t', it assumes that the shell is running in an
emacs shell buffer and disables line editing.
`ENV'
Similar to `BASH_ENV'; used when the shell is invoked in POSIX
Mode (*note Bash POSIX Mode::).
`EUID'
The numeric effective user id of the current user. This variable
is readonly.
@@ -4474,6 +4493,10 @@ Variables::).
variable is unset, or set to a value that is not a number greater
than or equal to zero, the shell disables mail checking.
`MAPFILE'
An array variable created to hold the text read by the `mapfile'
builtin when no variable name is supplied.
`OLDPWD'
The previous working directory as set by the `cd' builtin.
@@ -4531,6 +4554,14 @@ Variables::).
and 32767 is generated. Assigning a value to this variable seeds
the random number generator.
`READLINE_LINE'
The contents of the Readline line buffer, for use with `bind -x'
(*note Bash Builtins::).
`READLINE_POINT'
The position of the insertion point in the Readline line buffer,
for use with `bind -x' (*note Bash Builtins::).
`REPLY'
The default variable for the `read' builtin.
@@ -5105,20 +5136,23 @@ link itself.
`-x FILE'
True if FILE exists and is executable.
`-O FILE'
True if FILE exists and is owned by the effective user id.
`-G FILE'
True if FILE exists and is owned by the effective group id.
`-L FILE'
True if FILE exists and is a symbolic link.
`-N FILE'
True if FILE exists and has been modified since it was last read.
`-O FILE'
True if FILE exists and is owned by the effective user id.
`-S FILE'
True if FILE exists and is a socket.
`-N FILE'
True if FILE exists and has been modified since it was last read.
`FILE1 -ef FILE2'
True if FILE1 and FILE2 refer to the same device and inode numbers.
`FILE1 -nt FILE2'
True if FILE1 is newer (according to modification date) than
@@ -5128,9 +5162,6 @@ link itself.
True if FILE1 is older than FILE2, or if FILE2 exists and FILE1
does not.
`FILE1 -ef FILE2'
True if FILE1 and FILE2 refer to the same device and inode numbers.
`-o OPTNAME'
True if shell option OPTNAME is enabled. The list of options
appears in the description of the `-o' option to the `set' builtin
@@ -7825,16 +7856,6 @@ completion facilities.
Names of all shell variables. May also be specified as
`-v'.
`-G GLOBPAT'
The filename expansion pattern GLOBPAT is expanded to generate
the possible completions.
`-W WORDLIST'
The WORDLIST is split using the characters in the `IFS'
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 completed.
`-C COMMAND'
COMMAND is executed in a subshell environment, and its output
is used as the possible completions.
@@ -7844,13 +7865,9 @@ completion facilities.
environment. When it finishes, the possible completions are
retrieved from the value of the `COMPREPLY' array variable.
`-X FILTERPAT'
FILTERPAT is a pattern as used for filename expansion. It is
applied to the list of possible completions generated by the
preceding options and arguments, and each completion matching
FILTERPAT is removed from the list. A leading `!' in
FILTERPAT negates the pattern; in this case, any completion
not matching FILTERPAT is removed.
`-G GLOBPAT'
The filename expansion pattern GLOBPAT is expanded to generate
the possible completions.
`-P PREFIX'
PREFIX is added at the beginning of each possible completion
@@ -7860,6 +7877,20 @@ completion facilities.
SUFFIX is appended to each possible completion after all
other options have been applied.
`-W WORDLIST'
The WORDLIST is split using the characters in the `IFS'
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 completed.
`-X FILTERPAT'
FILTERPAT is a pattern as used for filename expansion. It is
applied to the list of possible completions generated by the
preceding options and arguments, and each completion matching
FILTERPAT is removed from the list. A leading `!' in
FILTERPAT negates the pattern; in this case, any completion
not matching FILTERPAT is removed.
The return value is true unless an invalid option is supplied, an
option other than `-p' or `-r' is supplied without a NAME
argument, an attempt is made to remove a completion specification
@@ -7869,7 +7900,7 @@ completion facilities.
`compopt'
`compopt' [-o OPTION] [-DE] [+o OPTION] [NAME]
Modify completion options for each NAME according to the OPTIONs,
or for the currently-execution completion if no NAMEs are supplied.
or for the currently-executing completion if no NAMEs are supplied.
If no OPTIONs are given, display the completion options for each
NAME or the current completion. The possible values of OPTION are
those valid for the `complete' builtin described above. The `-D'
@@ -9834,66 +9865,69 @@ D.3 Parameter and Variable Index
* COMPREPLY: Bash Variables. (line 193)
* convert-meta: Readline Init File Syntax.
(line 77)
* DIRSTACK: Bash Variables. (line 198)
* COPROC: Bash Variables. (line 198)
* DIRSTACK: Bash Variables. (line 202)
* disable-completion: Readline Init File Syntax.
(line 83)
* editing-mode: Readline Init File Syntax.
(line 88)
* EMACS: Bash Variables. (line 208)
* EMACS: Bash Variables. (line 212)
* enable-keypad: Readline Init File Syntax.
(line 99)
* EUID: Bash Variables. (line 213)
* ENV: Bash Variables. (line 217)
* EUID: Bash Variables. (line 221)
* expand-tilde: Readline Init File Syntax.
(line 110)
* FCEDIT: Bash Variables. (line 217)
* FIGNORE: Bash Variables. (line 221)
* FUNCNAME: Bash Variables. (line 227)
* GLOBIGNORE: Bash Variables. (line 236)
* GROUPS: Bash Variables. (line 242)
* histchars: Bash Variables. (line 248)
* HISTCMD: Bash Variables. (line 263)
* HISTCONTROL: Bash Variables. (line 268)
* HISTFILE: Bash Variables. (line 284)
* HISTFILESIZE: Bash Variables. (line 288)
* HISTIGNORE: Bash Variables. (line 296)
* FCEDIT: Bash Variables. (line 225)
* FIGNORE: Bash Variables. (line 229)
* FUNCNAME: Bash Variables. (line 235)
* GLOBIGNORE: Bash Variables. (line 244)
* GROUPS: Bash Variables. (line 250)
* histchars: Bash Variables. (line 256)
* HISTCMD: Bash Variables. (line 271)
* HISTCONTROL: Bash Variables. (line 276)
* HISTFILE: Bash Variables. (line 292)
* HISTFILESIZE: Bash Variables. (line 296)
* HISTIGNORE: Bash Variables. (line 304)
* history-preserve-point: Readline Init File Syntax.
(line 114)
* history-size: Readline Init File Syntax.
(line 120)
* HISTSIZE: Bash Variables. (line 315)
* HISTTIMEFORMAT: Bash Variables. (line 319)
* HISTSIZE: Bash Variables. (line 323)
* HISTTIMEFORMAT: Bash Variables. (line 327)
* HOME: Bourne Shell Variables.
(line 13)
* horizontal-scroll-mode: Readline Init File Syntax.
(line 125)
* HOSTFILE: Bash Variables. (line 328)
* HOSTNAME: Bash Variables. (line 339)
* HOSTTYPE: Bash Variables. (line 342)
* HOSTFILE: Bash Variables. (line 336)
* HOSTNAME: Bash Variables. (line 347)
* HOSTTYPE: Bash Variables. (line 350)
* IFS: Bourne Shell Variables.
(line 18)
* IGNOREEOF: Bash Variables. (line 345)
* IGNOREEOF: Bash Variables. (line 353)
* input-meta: Readline Init File Syntax.
(line 132)
* INPUTRC: Bash Variables. (line 355)
* INPUTRC: Bash Variables. (line 363)
* isearch-terminators: Readline Init File Syntax.
(line 139)
* keymap: Readline Init File Syntax.
(line 146)
* LANG: Bash Variables. (line 359)
* LC_ALL: Bash Variables. (line 363)
* LC_COLLATE: Bash Variables. (line 367)
* LC_CTYPE: Bash Variables. (line 374)
* LANG: Bash Variables. (line 367)
* LC_ALL: Bash Variables. (line 371)
* LC_COLLATE: Bash Variables. (line 375)
* LC_CTYPE: Bash Variables. (line 382)
* LC_MESSAGES <1>: Locale Translation. (line 11)
* LC_MESSAGES: Bash Variables. (line 379)
* LC_NUMERIC: Bash Variables. (line 383)
* LINENO: Bash Variables. (line 387)
* LINES: Bash Variables. (line 391)
* MACHTYPE: Bash Variables. (line 396)
* LC_MESSAGES: Bash Variables. (line 387)
* LC_NUMERIC: Bash Variables. (line 391)
* LINENO: Bash Variables. (line 395)
* LINES: Bash Variables. (line 399)
* MACHTYPE: Bash Variables. (line 404)
* MAIL: Bourne Shell Variables.
(line 22)
* MAILCHECK: Bash Variables. (line 400)
* MAILCHECK: Bash Variables. (line 408)
* MAILPATH: Bourne Shell Variables.
(line 27)
* MAPFILE: Bash Variables. (line 416)
* mark-modified-lines: Readline Init File Syntax.
(line 159)
* mark-symlinked-directories: Readline Init File Syntax.
@@ -9902,39 +9936,41 @@ D.3 Parameter and Variable Index
(line 169)
* meta-flag: Readline Init File Syntax.
(line 132)
* OLDPWD: Bash Variables. (line 408)
* OLDPWD: Bash Variables. (line 420)
* OPTARG: Bourne Shell Variables.
(line 34)
* OPTERR: Bash Variables. (line 411)
* OPTERR: Bash Variables. (line 423)
* OPTIND: Bourne Shell Variables.
(line 38)
* OSTYPE: Bash Variables. (line 415)
* OSTYPE: Bash Variables. (line 427)
* output-meta: Readline Init File Syntax.
(line 176)
* page-completions: Readline Init File Syntax.
(line 181)
* PATH: Bourne Shell Variables.
(line 42)
* PIPESTATUS: Bash Variables. (line 418)
* POSIXLY_CORRECT: Bash Variables. (line 423)
* PPID: Bash Variables. (line 432)
* PROMPT_COMMAND: Bash Variables. (line 436)
* PROMPT_DIRTRIM: Bash Variables. (line 440)
* PIPESTATUS: Bash Variables. (line 430)
* POSIXLY_CORRECT: Bash Variables. (line 435)
* PPID: Bash Variables. (line 444)
* PROMPT_COMMAND: Bash Variables. (line 448)
* PROMPT_DIRTRIM: Bash Variables. (line 452)
* PS1: Bourne Shell Variables.
(line 48)
* PS2: Bourne Shell Variables.
(line 53)
* PS3: Bash Variables. (line 446)
* PS4: Bash Variables. (line 451)
* PWD: Bash Variables. (line 457)
* RANDOM: Bash Variables. (line 460)
* REPLY: Bash Variables. (line 465)
* PS3: Bash Variables. (line 458)
* PS4: Bash Variables. (line 463)
* PWD: Bash Variables. (line 469)
* RANDOM: Bash Variables. (line 472)
* READLINE_LINE: Bash Variables. (line 477)
* READLINE_POINT: Bash Variables. (line 481)
* REPLY: Bash Variables. (line 485)
* revert-all-at-newline: Readline Init File Syntax.
(line 191)
* SECONDS: Bash Variables. (line 468)
* SHELL: Bash Variables. (line 474)
* SHELLOPTS: Bash Variables. (line 479)
* SHLVL: Bash Variables. (line 488)
* SECONDS: Bash Variables. (line 488)
* SHELL: Bash Variables. (line 494)
* SHELLOPTS: Bash Variables. (line 499)
* SHLVL: Bash Variables. (line 508)
* show-all-if-ambiguous: Readline Init File Syntax.
(line 197)
* show-all-if-unmodified: Readline Init File Syntax.
@@ -9943,10 +9979,10 @@ D.3 Parameter and Variable Index
(line 212)
* TEXTDOMAIN: Locale Translation. (line 11)
* TEXTDOMAINDIR: Locale Translation. (line 11)
* TIMEFORMAT: Bash Variables. (line 493)
* TMOUT: Bash Variables. (line 531)
* TMPDIR: Bash Variables. (line 543)
* UID: Bash Variables. (line 547)
* TIMEFORMAT: Bash Variables. (line 513)
* TMOUT: Bash Variables. (line 551)
* TMPDIR: Bash Variables. (line 563)
* UID: Bash Variables. (line 567)
* visible-stats: Readline Init File Syntax.
(line 225)
@@ -10217,132 +10253,132 @@ D.5 Concept Index

Tag Table:
Node: Top1346
Node: Introduction3185
Node: What is Bash?3413
Node: What is a shell?4526
Node: Definitions7066
Node: Basic Shell Features9984
Node: Shell Syntax11203
Node: Shell Operation12233
Node: Quoting13527
Node: Escape Character14830
Node: Single Quotes15315
Node: Double Quotes15663
Node: ANSI-C Quoting16788
Node: Locale Translation17773
Node: Comments18669
Node: Shell Commands19287
Node: Simple Commands20111
Node: Pipelines20742
Node: Lists22998
Node: Compound Commands24727
Node: Looping Constructs25531
Node: Conditional Constructs27986
Node: Command Grouping36099
Node: Coprocesses37578
Node: Shell Functions39222
Node: Shell Parameters43776
Node: Positional Parameters46192
Node: Special Parameters47092
Node: Shell Expansions50056
Node: Brace Expansion51981
Node: Tilde Expansion54736
Node: Shell Parameter Expansion57087
Node: Command Substitution65988
Node: Arithmetic Expansion67321
Node: Process Substitution68171
Node: Word Splitting69221
Node: Filename Expansion70844
Node: Pattern Matching72983
Node: Quote Removal76622
Node: Redirections76917
Node: Executing Commands85442
Node: Simple Command Expansion86112
Node: Command Search and Execution88042
Node: Command Execution Environment90379
Node: Environment93365
Node: Exit Status95025
Node: Signals96646
Node: Shell Scripts98614
Node: Shell Builtin Commands101132
Node: Bourne Shell Builtins103160
Node: Bash Builtins120536
Node: Modifying Shell Behavior145364
Node: The Set Builtin145709
Node: The Shopt Builtin155233
Node: Special Builtins166095
Node: Shell Variables167074
Node: Bourne Shell Variables167514
Node: Bash Variables169495
Node: Bash Features192981
Node: Invoking Bash193864
Node: Bash Startup Files199673
Node: Interactive Shells204685
Node: What is an Interactive Shell?205095
Node: Is this Shell Interactive?205744
Node: Interactive Shell Behavior206559
Node: Bash Conditional Expressions209839
Node: Shell Arithmetic213488
Node: Aliases216234
Node: Arrays218806
Node: The Directory Stack222764
Node: Directory Stack Builtins223478
Node: Printing a Prompt226370
Node: The Restricted Shell229122
Node: Bash POSIX Mode230954
Node: Job Control239011
Node: Job Control Basics239471
Node: Job Control Builtins244188
Node: Job Control Variables248552
Node: Command Line Editing249710
Node: Introduction and Notation251277
Node: Readline Interaction252899
Node: Readline Bare Essentials254090
Node: Readline Movement Commands255879
Node: Readline Killing Commands256844
Node: Readline Arguments258764
Node: Searching259808
Node: Readline Init File261994
Node: Readline Init File Syntax263141
Node: Conditional Init Constructs277628
Node: Sample Init File280161
Node: Bindable Readline Commands283278
Node: Commands For Moving284485
Node: Commands For History285629
Node: Commands For Text288784
Node: Commands For Killing291457
Node: Numeric Arguments293908
Node: Commands For Completion295047
Node: Keyboard Macros299007
Node: Miscellaneous Commands299578
Node: Readline vi Mode305384
Node: Programmable Completion306298
Node: Programmable Completion Builtins313504
Node: Using History Interactively322640
Node: Bash History Facilities323324
Node: Bash History Builtins326238
Node: History Interaction330095
Node: Event Designators332800
Node: Word Designators333815
Node: Modifiers335454
Node: Installing Bash336858
Node: Basic Installation337995
Node: Compilers and Options340687
Node: Compiling For Multiple Architectures341428
Node: Installation Names343092
Node: Specifying the System Type343910
Node: Sharing Defaults344626
Node: Operation Controls345299
Node: Optional Features346257
Node: Reporting Bugs355816
Node: Major Differences From The Bourne Shell357017
Node: GNU Free Documentation License373704
Node: Indexes398900
Node: Builtin Index399354
Node: Reserved Word Index406181
Node: Variable Index408629
Node: Function Index420722
Node: Concept Index427731
Node: Top1344
Node: Introduction3181
Node: What is Bash?3409
Node: What is a shell?4522
Node: Definitions7062
Node: Basic Shell Features9980
Node: Shell Syntax11199
Node: Shell Operation12229
Node: Quoting13523
Node: Escape Character14826
Node: Single Quotes15311
Node: Double Quotes15659
Node: ANSI-C Quoting16784
Node: Locale Translation17769
Node: Comments18665
Node: Shell Commands19283
Node: Simple Commands20107
Node: Pipelines20738
Node: Lists22994
Node: Compound Commands24723
Node: Looping Constructs25527
Node: Conditional Constructs27982
Node: Command Grouping36095
Node: Coprocesses37574
Node: Shell Functions39218
Node: Shell Parameters43772
Node: Positional Parameters46188
Node: Special Parameters47088
Node: Shell Expansions50052
Node: Brace Expansion51977
Node: Tilde Expansion54732
Node: Shell Parameter Expansion57083
Node: Command Substitution65984
Node: Arithmetic Expansion67317
Node: Process Substitution68167
Node: Word Splitting69217
Node: Filename Expansion70840
Node: Pattern Matching72979
Node: Quote Removal76618
Node: Redirections76913
Node: Executing Commands85438
Node: Simple Command Expansion86108
Node: Command Search and Execution88038
Node: Command Execution Environment90375
Node: Environment93361
Node: Exit Status95021
Node: Signals96642
Node: Shell Scripts98610
Node: Shell Builtin Commands101128
Node: Bourne Shell Builtins103156
Node: Bash Builtins120532
Node: Modifying Shell Behavior145360
Node: The Set Builtin145705
Node: The Shopt Builtin155229
Node: Special Builtins166563
Node: Shell Variables167542
Node: Bourne Shell Variables167982
Node: Bash Variables169963
Node: Bash Features194096
Node: Invoking Bash194979
Node: Bash Startup Files200788
Node: Interactive Shells205800
Node: What is an Interactive Shell?206210
Node: Is this Shell Interactive?206859
Node: Interactive Shell Behavior207674
Node: Bash Conditional Expressions210954
Node: Shell Arithmetic214603
Node: Aliases217349
Node: Arrays219921
Node: The Directory Stack223879
Node: Directory Stack Builtins224593
Node: Printing a Prompt227485
Node: The Restricted Shell230237
Node: Bash POSIX Mode232069
Node: Job Control240126
Node: Job Control Basics240586
Node: Job Control Builtins245303
Node: Job Control Variables249667
Node: Command Line Editing250825
Node: Introduction and Notation252392
Node: Readline Interaction254014
Node: Readline Bare Essentials255205
Node: Readline Movement Commands256994
Node: Readline Killing Commands257959
Node: Readline Arguments259879
Node: Searching260923
Node: Readline Init File263109
Node: Readline Init File Syntax264256
Node: Conditional Init Constructs278743
Node: Sample Init File281276
Node: Bindable Readline Commands284393
Node: Commands For Moving285600
Node: Commands For History286744
Node: Commands For Text289899
Node: Commands For Killing292572
Node: Numeric Arguments295023
Node: Commands For Completion296162
Node: Keyboard Macros300122
Node: Miscellaneous Commands300693
Node: Readline vi Mode306499
Node: Programmable Completion307413
Node: Programmable Completion Builtins314619
Node: Using History Interactively323755
Node: Bash History Facilities324439
Node: Bash History Builtins327353
Node: History Interaction331210
Node: Event Designators333915
Node: Word Designators334930
Node: Modifiers336569
Node: Installing Bash337973
Node: Basic Installation339110
Node: Compilers and Options341802
Node: Compiling For Multiple Architectures342543
Node: Installation Names344207
Node: Specifying the System Type345025
Node: Sharing Defaults345741
Node: Operation Controls346414
Node: Optional Features347372
Node: Reporting Bugs356931
Node: Major Differences From The Bourne Shell358132
Node: GNU Free Documentation License374819
Node: Indexes400015
Node: Builtin Index400469
Node: Reserved Word Index407296
Node: Variable Index409744
Node: Function Index422202
Node: Concept Index429211

End Tag Table
doc/bashref.log
+11 -27
View File
@@ -1,4 +1,4 @@
This is TeX, Version 3.141592 (Web2C 7.5.4) (format=tex 2008.12.11) 29 DEC 2009 15:59
This is TeX, Version 3.141592 (Web2C 7.5.4) (format=tex 2008.12.11) 15 JAN 2010 14:35
**/Users/chet/src/bash/src/doc/bashref.texi
(/Users/chet/src/bash/src/doc/bashref.texi (./texinfo.tex
Loading texinfo [version 2009-01-18.17]:
@@ -219,25 +219,9 @@ rs@texttt ] [-p @textttsl prompt@texttt ] [-t @textttsl time-
.@texttt a
.etc.
[47] [48] [49] [50] [51] [52] [53] [54] [55]
Underfull \hbox (badness 2573) in paragraph at lines 4414--4418
[]@textrm Error trac-ing is en-abled: com-mand sub-sti-tu-tion, shell
@hbox(7.60416+2.12917)x433.62, glue set 2.95305
.@glue(@leftskip) 137.31363
.@hbox(7.05666+0.0)x0.0, glue set - 15.74411fil
..@glue 0.0 plus 1.0fil minus 1.0fil
..@textrm 6
..@textrm .
..@kern 7.22743
.@textrm E
.@textrm r
.@textrm r
.etc.
[56] [57] [58] Chapter 5 [59] [60] [61] [62] [63] [64] [65] [66] [67] [68]
[69] Chapter 6 [70]
Overfull \hbox (51.96864pt too wide) in paragraph at lines 5282--5282
[47] [48] [49] [50] [51] [52] [53] [54] [55] [56] [57] [58] Chapter 5 [59]
[60] [61] [62] [63] [64] [65] [66] [67] [68] [69] Chapter 6 [70]
Overfull \hbox (51.96864pt too wide) in paragraph at lines 5313--5313
[]@texttt bash [long-opt] [-ir] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@t
exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -250,7 +234,7 @@ exttt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
.etc.
Overfull \hbox (76.23077pt too wide) in paragraph at lines 5283--5283
Overfull \hbox (76.23077pt too wide) in paragraph at lines 5314--5314
[]@texttt bash [long-opt] [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@texttt
] [-O @textttsl shopt_option@texttt ] -c @textttsl string @texttt [@textttsl ar
-
@@ -264,7 +248,7 @@ Overfull \hbox (76.23077pt too wide) in paragraph at lines 5283--5283
.etc.
Overfull \hbox (34.72258pt too wide) in paragraph at lines 5284--5284
Overfull \hbox (34.72258pt too wide) in paragraph at lines 5315--5315
[]@texttt bash [long-opt] -s [-abefhkmnptuvxdBCDHP] [-o @textttsl op-tion@text
tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
@@ -277,7 +261,7 @@ tt ] [-O @textttsl shopt_option@texttt ] [@textttsl ar-
.etc.
[71] [72]
Underfull \hbox (badness 2245) in paragraph at lines 5458--5460
Underfull \hbox (badness 2245) in paragraph at lines 5489--5491
[]@textrm When a lo-gin shell ex-its, Bash reads and ex-e-cutes com-mands from
the file
@@ -290,7 +274,7 @@ the file
.etc.
[73] [74] [75] [76] [77] [78] [79] [80] [81] [82] [83] [84] [85] [86]
Underfull \hbox (badness 2521) in paragraph at lines 6606--6609
Underfull \hbox (badness 2521) in paragraph at lines 6637--6640
@textrm `@texttt --enable-strict-posix-default[]@textrm '[] to @texttt configur
e[] @textrm when build-ing (see Sec-tion 10.8
@@ -358,7 +342,7 @@ Underfull \hbox (badness 2753) in paragraph at lines 1899--1902
[119]) (/Users/chet/src/bash/src/lib/readline/doc/hsuser.texi Chapter 9
[120] [121] [122] [123] [124]) Chapter 10 [125] [126] [127] [128] [129]
Underfull \hbox (badness 2772) in paragraph at lines 7207--7211
Underfull \hbox (badness 2772) in paragraph at lines 7238--7242
[]@textrm Enable sup-port for large files (@texttt http://www.sas.com/standard
s/large_
@@ -378,10 +362,10 @@ s/large_
Here is how much of TeX's memory you used:
2078 strings out of 97980
28503 string characters out of 1221004
65672 words of memory out of 1500000
65670 words of memory out of 1500000
2894 multiletter control sequences out of 10000+50000
32127 words of font info for 112 fonts, out of 1200000 for 2000
51 hyphenation exceptions out of 8191
16i,6n,14p,315b,699s stack positions out of 5000i,500n,6000p,200000b,5000s
Output written on bashref.dvi (164 pages, 663456 bytes).
Output written on bashref.dvi (164 pages, 666524 bytes).
doc/bashref.pdf
BIN
View File
Binary file not shown.
doc/bashref.ps
+1196 -1152
View File
File diff suppressed because it is too large Load Diff
doc/bashref.texi
+32 -12
View File
@@ -4425,7 +4425,7 @@ subshells invoked with @code{( @var{command} )} inherit the
@item
Error tracing is enabled: command substitution, shell functions, and
subshells invoked with @code{( @var{command} )} inherit the
@code{ERROR} trap.
@code{ERR} trap.
@end enumerate
@item extglob
@@ -4883,6 +4883,10 @@ An array variable from which Bash reads the possible completions
generated by a shell function invoked by the programmable completion
facility (@pxref{Programmable Completion}).
@item COPROC
An array variable created to hold the file descriptors
for output from and input to an unnamed coprocess (@pxref{Coprocesses}).
@item DIRSTACK
An array variable containing the current contents of the directory stack.
Directories appear in the stack in the order they are displayed by the
@@ -4899,6 +4903,10 @@ If Bash finds this variable in the environment when the shell
starts with value @samp{t}, it assumes that the shell is running in an
emacs shell buffer and disables line editing.
@item ENV
Similar to @code{BASH_ENV}; used when the shell is invoked in
@sc{posix} Mode (@pxref{Bash POSIX Mode}).
@item EUID
The numeric effective user id of the current user. This variable
is readonly.
@@ -5105,6 +5113,10 @@ for mail, the shell does so before displaying the primary prompt.
If this variable is unset, or set to a value that is not a number
greater than or equal to zero, the shell disables mail checking.
@item MAPFILE
An array variable created to hold the text read by the
@code{mapfile} builtin when no variable name is supplied.
@item OLDPWD
The previous working directory as set by the @code{cd} builtin.
@@ -5167,6 +5179,14 @@ Each time this parameter is referenced, a random integer
between 0 and 32767 is generated. Assigning a value to this
variable seeds the random number generator.
@item READLINE_LINE
The contents of the Readline line buffer, for use
with @samp{bind -x} (@pxref{Bash Builtins}).
@item READLINE_POINT
The position of the insertion point in the Readline line buffer, for use
with @samp{bind -x} (@pxref{Bash Builtins}).
@item REPLY
The default variable for the @code{read} builtin.
@@ -5788,20 +5808,24 @@ True if @var{file} exists and is writable.
@item -x @var{file}
True if @var{file} exists and is executable.
@item -O @var{file}
True if @var{file} exists and is owned by the effective user id.
@item -G @var{file}
True if @var{file} exists and is owned by the effective group id.
@item -L @var{file}
True if @var{file} exists and is a symbolic link.
@item -N @var{file}
True if @var{file} exists and has been modified since it was last read.
@item -O @var{file}
True if @var{file} exists and is owned by the effective user id.
@item -S @var{file}
True if @var{file} exists and is a socket.
@item -N @var{file}
True if @var{file} exists and has been modified since it was last read.
@item @var{file1} -ef @var{file2}
True if @var{file1} and @var{file2} refer to the same device and
inode numbers.
@item @var{file1} -nt @var{file2}
True if @var{file1} is newer (according to modification date)
@@ -5811,10 +5835,6 @@ than @var{file2}, or if @var{file1} exists and @var{file2} does not.
True if @var{file1} is older than @var{file2},
or if @var{file2} exists and @var{file1} does not.
@item @var{file1} -ef @var{file2}
True if @var{file1} and @var{file2} refer to the same device and
inode numbers.
@item -o @var{optname}
True if shell option @var{optname} is enabled.
The list of options appears in the description of the @option{-o}
@@ -6471,7 +6491,7 @@ during command lookup.
@item
If a @sc{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,
the @sc{posix} standard, and include things like passing incorrect options,
redirection errors, variable assignment errors for assignments preceding
the command name, and so on.
@@ -7280,7 +7300,7 @@ Include support for the @code{[[} conditional command.
(@pxref{Conditional Constructs}).
@item --enable-cond-regexp
Include support for matching POSIX regular expressions using the
Include support for matching @sc{posix} regular expressions using the
@samp{=~} binary operator in the @code{[[} conditional command.
(@pxref{Conditional Constructs}).
doc/bashref.vr
+14 -9
View File
@@ -46,8 +46,10 @@
\entry{COMP_WORDBREAKS}{64}{\code {COMP_WORDBREAKS}}
\entry{COMP_WORDS}{64}{\code {COMP_WORDS}}
\entry{COMPREPLY}{65}{\code {COMPREPLY}}
\entry{COPROC}{65}{\code {COPROC}}
\entry{DIRSTACK}{65}{\code {DIRSTACK}}
\entry{EMACS}{65}{\code {EMACS}}
\entry{ENV}{65}{\code {ENV}}
\entry{EUID}{65}{\code {EUID}}
\entry{FCEDIT}{65}{\code {FCEDIT}}
\entry{FIGNORE}{65}{\code {FIGNORE}}
@@ -61,7 +63,7 @@
\entry{HISTFILESIZE}{66}{\code {HISTFILESIZE}}
\entry{HISTIGNORE}{66}{\code {HISTIGNORE}}
\entry{HISTSIZE}{66}{\code {HISTSIZE}}
\entry{HISTTIMEFORMAT}{66}{\code {HISTTIMEFORMAT}}
\entry{HISTTIMEFORMAT}{67}{\code {HISTTIMEFORMAT}}
\entry{HOSTFILE}{67}{\code {HOSTFILE}}
\entry{HOSTNAME}{67}{\code {HOSTNAME}}
\entry{HOSTTYPE}{67}{\code {HOSTTYPE}}
@@ -73,10 +75,11 @@
\entry{LC_CTYPE}{67}{\code {LC_CTYPE}}
\entry{LC_MESSAGES}{67}{\code {LC_MESSAGES}}
\entry{LC_NUMERIC}{67}{\code {LC_NUMERIC}}
\entry{LINENO}{67}{\code {LINENO}}
\entry{LINES}{67}{\code {LINES}}
\entry{MACHTYPE}{67}{\code {MACHTYPE}}
\entry{LINENO}{68}{\code {LINENO}}
\entry{LINES}{68}{\code {LINES}}
\entry{MACHTYPE}{68}{\code {MACHTYPE}}
\entry{MAILCHECK}{68}{\code {MAILCHECK}}
\entry{MAPFILE}{68}{\code {MAPFILE}}
\entry{OLDPWD}{68}{\code {OLDPWD}}
\entry{OPTERR}{68}{\code {OPTERR}}
\entry{OSTYPE}{68}{\code {OSTYPE}}
@@ -86,16 +89,18 @@
\entry{PROMPT_COMMAND}{68}{\code {PROMPT_COMMAND}}
\entry{PROMPT_DIRTRIM}{68}{\code {PROMPT_DIRTRIM}}
\entry{PS3}{68}{\code {PS3}}
\entry{PS4}{68}{\code {PS4}}
\entry{PWD}{68}{\code {PWD}}
\entry{RANDOM}{68}{\code {RANDOM}}
\entry{REPLY}{68}{\code {REPLY}}
\entry{PS4}{69}{\code {PS4}}
\entry{PWD}{69}{\code {PWD}}
\entry{RANDOM}{69}{\code {RANDOM}}
\entry{READLINE_LINE}{69}{\code {READLINE_LINE}}
\entry{READLINE_POINT}{69}{\code {READLINE_POINT}}
\entry{REPLY}{69}{\code {REPLY}}
\entry{SECONDS}{69}{\code {SECONDS}}
\entry{SHELL}{69}{\code {SHELL}}
\entry{SHELLOPTS}{69}{\code {SHELLOPTS}}
\entry{SHLVL}{69}{\code {SHLVL}}
\entry{TIMEFORMAT}{69}{\code {TIMEFORMAT}}
\entry{TMOUT}{69}{\code {TMOUT}}
\entry{TMOUT}{70}{\code {TMOUT}}
\entry{TMPDIR}{70}{\code {TMPDIR}}
\entry{UID}{70}{\code {UID}}
\entry{auto_resume}{92}{\code {auto_resume}}
doc/bashref.vrs
+14 -9
View File
@@ -53,6 +53,7 @@
\entry {\code {completion-query-items}}{97}
\entry {\code {COMPREPLY}}{65}
\entry {\code {convert-meta}}{98}
\entry {\code {COPROC}}{65}
\initial {D}
\entry {\code {DIRSTACK}}{65}
\entry {\code {disable-completion}}{98}
@@ -60,6 +61,7 @@
\entry {\code {editing-mode}}{98}
\entry {\code {EMACS}}{65}
\entry {\code {enable-keypad}}{98}
\entry {\code {ENV}}{65}
\entry {\code {EUID}}{65}
\entry {\code {expand-tilde}}{98}
\initial {F}
@@ -79,7 +81,7 @@
\entry {\code {history-preserve-point}}{98}
\entry {\code {history-size}}{98}
\entry {\code {HISTSIZE}}{66}
\entry {\code {HISTTIMEFORMAT}}{66}
\entry {\code {HISTTIMEFORMAT}}{67}
\entry {\code {HOME}}{61}
\entry {\code {horizontal-scroll-mode}}{98}
\entry {\code {HOSTFILE}}{67}
@@ -100,13 +102,14 @@
\entry {\code {LC_CTYPE}}{67}
\entry {\code {LC_MESSAGES}}{7, 67}
\entry {\code {LC_NUMERIC}}{67}
\entry {\code {LINENO}}{67}
\entry {\code {LINES}}{67}
\entry {\code {LINENO}}{68}
\entry {\code {LINES}}{68}
\initial {M}
\entry {\code {MACHTYPE}}{67}
\entry {\code {MACHTYPE}}{68}
\entry {\code {MAIL}}{61}
\entry {\code {MAILCHECK}}{68}
\entry {\code {MAILPATH}}{61}
\entry {\code {MAPFILE}}{68}
\entry {\code {mark-modified-lines}}{99}
\entry {\code {mark-symlinked-directories}}{99}
\entry {\code {match-hidden-files}}{99}
@@ -129,11 +132,13 @@
\entry {\code {PS1}}{61}
\entry {\code {PS2}}{61}
\entry {\code {PS3}}{68}
\entry {\code {PS4}}{68}
\entry {\code {PWD}}{68}
\entry {\code {PS4}}{69}
\entry {\code {PWD}}{69}
\initial {R}
\entry {\code {RANDOM}}{68}
\entry {\code {REPLY}}{68}
\entry {\code {RANDOM}}{69}
\entry {\code {READLINE_LINE}}{69}
\entry {\code {READLINE_POINT}}{69}
\entry {\code {REPLY}}{69}
\entry {\code {revert-all-at-newline}}{100}
\initial {S}
\entry {\code {SECONDS}}{69}
@@ -147,7 +152,7 @@
\entry {\code {TEXTDOMAIN}}{7}
\entry {\code {TEXTDOMAINDIR}}{7}
\entry {\code {TIMEFORMAT}}{69}
\entry {\code {TMOUT}}{69}
\entry {\code {TMOUT}}{70}
\entry {\code {TMPDIR}}{70}
\initial {U}
\entry {\code {UID}}{70}
doc/builtins.0
+24 -24
View File
@@ -129,7 +129,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
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-
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-
plied as _e_x_p_r, ccaalllleerr displays the line number, subroutine name,
@@ -282,23 +282,29 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
vvaarriiaabbllee
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
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 it finishes, the possible com-
pletions are retrieved from the value of the CCOOMMPPRREEPPLLYY
array variable.
--GG _g_l_o_b_p_a_t
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-
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-
pleted.
--CC _c_o_m_m_a_n_d
_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 it finishes, the possible com-
pletions are retrieved from the value of the CCOOMMPPRREEPPLLYY
array variable.
--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.
It is applied to the list of possible completions gener-
@@ -306,12 +312,6 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
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.
--PP _p_r_e_f_i_x
_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.
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-
@@ -321,7 +321,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
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-execution completion if no _n_a_m_es
_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
@@ -332,9 +332,9 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
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, an
attempt is made to modify the options for a _n_a_m_e for which no comple-
tion specification exists, or an output error occurs.
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
@@ -401,7 +401,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
an array variable, or an attempt is made to display a non-exis-
tent function with --ff.
ddiirrss [[++_n]] [[--_n]] [[--ccppllvv]]
ddiirrss [[++_n]] [[--_n]] [[--ccllppvv]]
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
@@ -697,10 +697,10 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
The first form lists the active jobs. The options have the fol-
lowing meanings:
--ll List process IDs in addition to the normal information.
--nn Display information only about jobs that have changed
status since the user was last notified of their status.
--pp List only the process ID of the job's process group
leader.
--nn Display information only about jobs that have changed
status since the user was last notified of their status.
--rr Restrict output to running jobs.
--ss Restrict output to stopped jobs.
@@ -1247,7 +1247,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
(( _c_o_m_m_a_n_d )) inherit the DDEEBBUUGG and RREETTUURRNN traps.
66.. Error tracing is enabled: command substitution,
shell functions, and subshells invoked with ((
_c_o_m_m_a_n_d )) inherit the EERRRROORR trap.
_c_o_m_m_a_n_d )) inherit the EERRRR trap.
eexxttgglloobb If set, the extended pattern matching features described
above under PPaatthhnnaammee EExxppaannssiioonn are enabled.
eexxttqquuoottee
@@ -1434,7 +1434,7 @@ BBAASSHH BBUUIILLTTIINN CCOOMMMMAANNDDSS
causes the shell to print a list of signal names and their cor-
responding numbers. Each _s_i_g_s_p_e_c is either a signal name
defined in <_s_i_g_n_a_l_._h>, or a signal number. Signal names are
case insensitive and the SIG prefix is optional.
case insensitive and the SSIIGG prefix is optional.
If a _s_i_g_s_p_e_c is EEXXIITT (0) the command _a_r_g is executed on exit
from the shell. If a _s_i_g_s_p_e_c is DDEEBBUUGG, the command _a_r_g is exe-
doc/builtins.ps
+101 -100
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Wed Dec 30 13:07:37 2009
%%CreationDate: Fri Jan 15 11:36:45 2010
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%+ font Times-Italic
@@ -443,9 +443,9 @@ E F1(shell\255b)2.84 E(uiltin)-.2 E F0(is not a shell b)2.74 E
2.754(ya)-.15 G(cti)-2.754 E .554 -.15(ve s)-.25 H .254
(ubroutine call \(a shell function or a script e).15 F -.15(xe)-.15 G
.254(cuted with the).15 F F2(.)2.753 E F0(or)2.753 E F2(sour)144 535.2 Q
(ce)-.18 E F0 -.2(bu)3.062 G 3.062(iltins. W).2 F(ithout)-.4 E F1 -.2
(ex)3.062 G(pr).2 E F0(,)A F2(caller)3.062 E F0 .562
(displays the line number and source \214lename of the current)3.062 F
(ce)-.18 E F0 -.2(bu)2.824 G 2.824(iltins\). W).2 F(ithout)-.4 E F1 -.2
(ex)2.824 G(pr).2 E F0(,)A F2(caller)2.824 E F0 .324
(displays the line number and source \214lename of the current)2.824 F
.254(subroutine call.)144 547.2 R .254(If a non-ne)5.254 F -.05(ga)-.15
G(ti).05 E .554 -.15(ve i)-.25 H(nte).15 E .253(ger is supplied as)-.15
F F1 -.2(ex)2.753 G(pr).2 E F0(,)A F2(caller)2.753 E F0 .253
@@ -663,52 +663,52 @@ F0(option to the)2.5 E F1(set)2.5 E F0 -.2(bu)2.5 G(iltin.).2 E F1
.15 E F1(user)184 588 Q F0(User names.)21.67 E
(May also be speci\214ed as)5 E F1<ad75>2.5 E F0(.)A F1 -.1(va)184 600 S
(riable).1 E F0(Names of all shell v)5.1 E 2.5(ariables. May)-.25 F
(also be speci\214ed as)2.5 E F1<ad76>2.5 E F0(.)A F1<ad47>144 612 Q F2
(globpat)2.5 E F0 1.007(The pathname e)184 624 R 1.007(xpansion pattern)
-.15 F F2(globpat)3.507 E F0 1.007(is e)3.507 F 1.008
(xpanded to generate the possible comple-)-.15 F(tions.)184 636 Q F1
<ad57>144 648 Q F2(wor)2.5 E(dlist)-.37 E F0(The)184 660 Q F2(wor)3.64 E
(dlist)-.37 E F0 1.14(is split using the characters in the)3.64 F F3
(IFS)3.64 E F0 1.139(special v)3.39 F 1.139(ariable as delimiters, and)
-.25 F 2.007(each resultant w)184 672 R 2.007(ord is e)-.1 F 4.507
(xpanded. The)-.15 F 2.008(possible completions are the members of the)
4.507 F(resultant list which match the w)184 684 Q(ord being completed.)
-.1 E F1<ad43>144 696 Q F2(command)2.5 E(command)184 708 Q F0 1.056
(is e)3.556 F -.15(xe)-.15 G 1.056(cuted in a subshell en).15 F 1.056
(also be speci\214ed as)2.5 E F1<ad76>2.5 E F0(.)A F1<ad43>144 612 Q F2
(command)2.5 E(command)184 624 Q F0 1.055(is e)3.555 F -.15(xe)-.15 G
1.055(cuted in a subshell en).15 F 1.056
(vironment, and its output is used as the possible)-.4 F(completions.)
184 720 Q(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(4)203.725 E 0 Cg
EP
184 636 Q F1<ad46>144 648 Q F2(function)2.5 E F0 1.181
(The shell function)184 660 R F2(function)3.681 E F0 1.181(is e)3.681 F
-.15(xe)-.15 G 1.181(cuted in the current shell en).15 F 3.68
(vironment. When)-.4 F 1.18(it \214n-)3.68 F .932
(ishes, the possible completions are retrie)184 672 R -.15(ve)-.25 G
3.432(df).15 G .932(rom the v)-3.432 F .932(alue of the)-.25 F F3
(COMPREPL)3.432 E(Y)-.828 E F0(array)3.182 E -.25(va)184 684 S(riable.)
.25 E F1<ad47>144 696 Q F2(globpat)2.5 E F0 1.008(The pathname e)184 708
R 1.008(xpansion pattern)-.15 F F2(globpat)3.507 E F0 1.007(is e)3.507 F
1.007(xpanded to generate the possible comple-)-.15 F(tions.)184 720 Q
(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(4)203.725 E 0 Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF -.35(BA)72 48 S(SH_B).35 E(UIL)-.1 E 290.48
(TINS\(1\) B)-.92 F(ASH_B)-.35 E(UIL)-.1 E(TINS\(1\))-.92 E/F1 10
/Times-Bold@0 SF<ad46>144 84 Q/F2 10/Times-Italic@0 SF(function)2.5 E F0
1.18(The shell function)184 96 R F2(function)3.68 E F0 1.181(is e)3.681
F -.15(xe)-.15 G 1.181(cuted in the current shell en).15 F 3.681
(vironment. When)-.4 F 1.181(it \214n-)3.681 F .932
(ishes, the possible completions are retrie)184 108 R -.15(ve)-.25 G
3.432(df).15 G .932(rom the v)-3.432 F .932(alue of the)-.25 F/F3 9
/Times-Bold@0 SF(COMPREPL)3.431 E(Y)-.828 E F0(array)3.181 E -.25(va)184
120 S(riable.).25 E F1<ad58>144 132 Q F2(\214lterpat)2.5 E(\214lterpat)
184 144 Q F0 .455(is a pattern as used for pathname e)2.955 F 2.956
(xpansion. It)-.15 F .456(is applied to the list of possible)2.956 F
1.596(completions generated by the preceding options and ar)184 156 R
1.596(guments, and each completion)-.18 F(matching)184 168 Q F2
(\214lterpat)3.204 E F0 .704(is remo)3.204 F -.15(ve)-.15 G 3.204(df).15
G .704(rom the list.)-3.204 F 3.204(Al)5.704 G(eading)-3.204 E F1(!)
3.204 E F0(in)3.204 E F2(\214lterpat)3.205 E F0(ne)3.205 E -.05(ga)-.15
G .705(tes the pattern;).05 F(in this case, an)184 180 Q 2.5(yc)-.15 G
(ompletion not matching)-2.5 E F2(\214lterpat)2.5 E F0(is remo)2.5 E
-.15(ve)-.15 G(d.).15 E F1<ad50>144 192 Q F2(pr)2.5 E(e\214x)-.37 E(pr)
184 204 Q(e\214x)-.37 E F0 .535(is added at the be)3.035 F .534
/Times-Bold@0 SF<ad50>144 84 Q/F2 10/Times-Italic@0 SF(pr)2.5 E(e\214x)
-.37 E(pr)184 96 Q(e\214x)-.37 E F0 .534(is added at the be)3.034 F .534
(ginning of each possible completion after all other options ha)-.15 F
-.15(ve)-.2 G(been applied.)184 216 Q F1<ad53>144 228 Q F2(suf)2.5 E
-.15(ve)-.2 G(been applied.)184 108 Q F1<ad53>144 120 Q F2(suf)2.5 E
2.81(\214x suf)-.18 F<8c78>-.18 E F0
(is appended to each possible completion after all other options ha)2.5
E .3 -.15(ve b)-.2 H(een applied.).15 E .466(The return v)144 244.8 R
.466(alue is true unless an in)-.25 F -.25(va)-.4 G .466
E .3 -.15(ve b)-.2 H(een applied.).15 E F1<ad57>144 132 Q F2(wor)2.5 E
(dlist)-.37 E F0(The)184 144 Q F2(wor)3.64 E(dlist)-.37 E F0 1.14
(is split using the characters in the)3.64 F/F3 9/Times-Bold@0 SF(IFS)
3.64 E F0 1.139(special v)3.39 F 1.139(ariable as delimiters, and)-.25 F
2.007(each resultant w)184 156 R 2.007(ord is e)-.1 F 4.507
(xpanded. The)-.15 F 2.008(possible completions are the members of the)
4.507 F(resultant list which match the w)184 168 Q(ord being completed.)
-.1 E F1<ad58>144 180 Q F2(\214lterpat)2.5 E(\214lterpat)184 192 Q F0
.456(is a pattern as used for pathname e)2.956 F 2.956(xpansion. It)-.15
F .455(is applied to the list of possible)2.956 F 1.596
(completions generated by the preceding options and ar)184 204 R 1.596
(guments, and each completion)-.18 F(matching)184 216 Q F2(\214lterpat)
3.205 E F0 .705(is remo)3.205 F -.15(ve)-.15 G 3.205(df).15 G .704
(rom the list.)-3.205 F 3.204(Al)5.704 G(eading)-3.204 E F1(!)3.204 E F0
(in)3.204 E F2(\214lterpat)3.204 E F0(ne)3.204 E -.05(ga)-.15 G .704
(tes the pattern;).05 F(in this case, an)184 228 Q 2.5(yc)-.15 G
(ompletion not matching)-2.5 E F2(\214lterpat)2.5 E F0(is remo)2.5 E
-.15(ve)-.15 G(d.).15 E .466(The return v)144 244.8 R .466
(alue is true unless an in)-.25 F -.25(va)-.4 G .466
(lid option is supplied, an option other than).25 F F1<ad70>2.967 E F0
(or)2.967 E F1<ad72>2.967 E F0 .467(is sup-)2.967 F 1.362
(plied without a)144 256.8 R F2(name)3.862 E F0(ar)3.862 E 1.361
@@ -720,7 +720,7 @@ F1(compopt)108 285.6 Q F0([)2.5 E F1<ad6f>A F2(option)2.5 E F0 2.5(][)C
F1(\255DE)-2.5 E F0 2.5(][)C F1(+o)-2.5 E F2(option)2.5 E F0 2.5(][)C F2
(name)-2.5 E F0(])A .447(Modify completion options for each)144 297.6 R
F2(name)2.947 E F0 .447(according to the)2.947 F F2(option)2.947 E F0
.447(s, or for the currently-e)B -.15(xe)-.15 G(cution).15 E .726
.447(s, or for the currently-e)B -.15(xe)-.15 G(cuting).15 E .726
(completion if no)144 309.6 R F2(name)3.226 E F0 3.226(sa)C .726
(re supplied.)-3.226 F .725(If no)5.725 F F2(option)3.225 E F0 3.225(sa)
C .725(re gi)-3.225 F -.15(ve)-.25 G .725
@@ -738,74 +738,75 @@ no)-3.727 F 2.178(completion has pre)144 357.6 R 2.178
(option indicates that the remaining options)4.677 F(should apply to `)
144 369.6 Q(`empty')-.74 E 2.5('c)-.74 G
(ommand completion; that is, completion attempted on a blank line.)-2.5
E .327(The return v)108 386.4 R .327(alue is true unless an in)-.25 F
-.25(va)-.4 G .327
(lid option is supplied, an attempt is made to modify the options for a)
.25 F F2(name)108 398.4 Q F0(for which no completion speci\214cation e)
2.5 E(xists, or an output error occurs.)-.15 E F1(continue)108 415.2 Q
F0([)2.5 E F2(n)A F0(])A 1.754(Resume the ne)144 427.2 R 1.754
E 1.387(The return v)144 393.6 R 1.387(alue is true unless an in)-.25 F
-.25(va)-.4 G 1.388
(lid option is supplied, an attempt is made to modify the).25 F
(options for a)144 405.6 Q F2(name)2.5 E F0
(for which no completion speci\214cation e)2.5 E
(xists, or an output error occurs.)-.15 E F1(continue)108 422.4 Q F0([)
2.5 E F2(n)A F0(])A 1.754(Resume the ne)144 434.4 R 1.754
(xt iteration of the enclosing)-.15 F F1 -.25(fo)4.254 G(r).25 E F0(,)A
F1(while)4.254 E F0(,)A F1(until)4.254 E F0 4.254(,o)C(r)-4.254 E F1
(select)4.254 E F0 4.253(loop. If)4.254 F F2(n)4.613 E F0 1.753
(is speci\214ed,)4.493 F 1.208(resume at the)144 439.2 R F2(n)3.709 E F0
(is speci\214ed,)4.493 F 1.208(resume at the)144 446.4 R F2(n)3.709 E F0
1.209(th enclosing loop.)B F2(n)6.569 E F0 1.209(must be)3.949 F/F4 10
/Symbol SF<b3>3.709 E F0 3.709(1. If)3.709 F F2(n)4.069 E F0 1.209
(is greater than the number of enclosing)3.949 F .514
(loops, the last enclosing loop \(the `)144 451.2 R(`top-le)-.74 E -.15
(loops, the last enclosing loop \(the `)144 458.4 R(`top-le)-.74 E -.15
(ve)-.25 G(l').15 E 3.014('l)-.74 G .514(oop\) is resumed.)-3.014 F .513
(The return v)5.513 F .513(alue is 0 unless)-.25 F F2(n)3.013 E F0(is)
3.013 E(not greater than or equal to 1.)144 463.2 Q F1(declar)108 480 Q
(e)-.18 E F0([)2.5 E F1(\255aAfFilrtux)A F0 2.5(][)C F1<ad70>-2.5 E F0
3.013 E(not greater than or equal to 1.)144 470.4 Q F1(declar)108 487.2
Q(e)-.18 E F0([)2.5 E F1(\255aAfFilrtux)A F0 2.5(][)C F1<ad70>-2.5 E F0
2.5(][)C F2(name)-2.5 E F0([=)A F2(value)A F0 2.5(].)C(..])-2.5 E F1
(typeset)108 492 Q F0([)2.5 E F1(\255aAfFilrtux)A F0 2.5(][)C F1<ad70>
(typeset)108 499.2 Q F0([)2.5 E F1(\255aAfFilrtux)A F0 2.5(][)C F1<ad70>
-2.5 E F0 2.5(][)C F2(name)-2.5 E F0([=)A F2(value)A F0 2.5(].)C(..])
-2.5 E 1.264(Declare v)144 504 R 1.264(ariables and/or gi)-.25 F 1.564
-2.5 E 1.264(Declare v)144 511.2 R 1.264(ariables and/or gi)-.25 F 1.564
-.15(ve t)-.25 H 1.264(hem attrib).15 F 3.765(utes. If)-.2 F(no)3.765 E
F2(name)3.765 E F0 3.765(sa)C 1.265(re gi)-3.765 F -.15(ve)-.25 G 3.765
(nt).15 G 1.265(hen display the v)-3.765 F 1.265(alues of)-.25 F -.25
(va)144 516 S 3.483(riables. The).25 F F1<ad70>3.483 E F0 .983
(va)144 523.2 S 3.483(riables. The).25 F F1<ad70>3.483 E F0 .983
(option will display the attrib)3.483 F .983(utes and v)-.2 F .982
(alues of each)-.25 F F2(name)3.482 E F0 5.982(.W).18 G(hen)-5.982 E F1
<ad70>3.482 E F0 .982(is used)3.482 F(with)144 528 Q F2(name)3.579 E F0
(ar)3.579 E 1.079(guments, additional options are ignored.)-.18 F(When)
6.079 E F1<ad70>3.579 E F0 1.079(is supplied without)3.579 F F2(name)
3.58 E F0(ar)3.58 E(gu-)-.18 E .151(ments, it will display the attrib)
144 540 R .151(utes and v)-.2 F .151(alues of all v)-.25 F .15
(ariables ha)-.25 F .15(ving the attrib)-.2 F .15
(utes speci\214ed by the)-.2 F .046(additional options.)144 552 R .046
(If no other options are supplied with)5.046 F F1<ad70>2.547 E F0(,)A F1
(declar)2.547 E(e)-.18 E F0 .047(will display the attrib)2.547 F .047
(utes and)-.2 F -.25(va)144 564 S 1.363(lues of all shell v).25 F 3.863
(ariables. The)-.25 F F1<ad66>3.863 E F0 1.362
(option will restrict the display to shell functions.)3.863 F(The)6.362
E F1<ad46>3.862 E F0 2.422(option inhibits the display of function de\
\214nitions; only the function name and attrib)144 576 R 2.423(utes are)
-.2 F 2.664(printed. If)144 588 R(the)2.664 E F1(extdeb)2.664 E(ug)-.2 E
F0 .164(shell option is enabled using)2.664 F F1(shopt)2.664 E F0 2.664
(,t)C .163(he source \214le name and line number)-2.664 F 1.382
(where the function is de\214ned are displayed as well.)144 600 R(The)
6.382 E F1<ad46>3.882 E F0 1.382(option implies)3.882 F F1<ad66>3.882 E
F0 6.382(.T)C 1.382(he follo)-6.382 F(wing)-.25 E .794
(options can be used to restrict output to v)144 612 R .794
<ad70>3.482 E F0 .982(is used)3.482 F(with)144 535.2 Q F2(name)3.579 E
F0(ar)3.579 E 1.079(guments, additional options are ignored.)-.18 F
(When)6.079 E F1<ad70>3.579 E F0 1.079(is supplied without)3.579 F F2
(name)3.58 E F0(ar)3.58 E(gu-)-.18 E .151
(ments, it will display the attrib)144 547.2 R .151(utes and v)-.2 F
.151(alues of all v)-.25 F .15(ariables ha)-.25 F .15(ving the attrib)
-.2 F .15(utes speci\214ed by the)-.2 F .046(additional options.)144
559.2 R .046(If no other options are supplied with)5.046 F F1<ad70>2.547
E F0(,)A F1(declar)2.547 E(e)-.18 E F0 .047(will display the attrib)
2.547 F .047(utes and)-.2 F -.25(va)144 571.2 S 1.363
(lues of all shell v).25 F 3.863(ariables. The)-.25 F F1<ad66>3.863 E F0
1.362(option will restrict the display to shell functions.)3.863 F(The)
6.362 E F1<ad46>3.862 E F0 2.422(option inhibits the display of functio\
n de\214nitions; only the function name and attrib)144 583.2 R 2.423
(utes are)-.2 F 2.664(printed. If)144 595.2 R(the)2.664 E F1(extdeb)
2.664 E(ug)-.2 E F0 .164(shell option is enabled using)2.664 F F1(shopt)
2.664 E F0 2.664(,t)C .163(he source \214le name and line number)-2.664
F 1.382(where the function is de\214ned are displayed as well.)144 607.2
R(The)6.382 E F1<ad46>3.882 E F0 1.382(option implies)3.882 F F1<ad66>
3.882 E F0 6.382(.T)C 1.382(he follo)-6.382 F(wing)-.25 E .794
(options can be used to restrict output to v)144 619.2 R .794
(ariables with the speci\214ed attrib)-.25 F .793(ute or to gi)-.2 F
1.093 -.15(ve v)-.25 H(ariables)-.1 E(attrib)144 624 Q(utes:)-.2 E F1
<ad61>144 636 Q F0(Each)25.3 E F2(name)2.5 E F0(is an inde)2.5 E -.15
1.093 -.15(ve v)-.25 H(ariables)-.1 E(attrib)144 631.2 Q(utes:)-.2 E F1
<ad61>144 643.2 Q F0(Each)25.3 E F2(name)2.5 E F0(is an inde)2.5 E -.15
(xe)-.15 G 2.5(da).15 G(rray v)-2.5 E(ariable \(see)-.25 E F1(Arrays)2.5
E F0(abo)2.5 E -.15(ve)-.15 G(\).).15 E F1<ad41>144 648 Q F0(Each)23.08
E F2(name)2.5 E F0(is an associati)2.5 E .3 -.15(ve a)-.25 H(rray v).15
E(ariable \(see)-.25 E F1(Arrays)2.5 E F0(abo)2.5 E -.15(ve)-.15 G(\).)
.15 E F1<ad66>144 660 Q F0(Use function names only)26.97 E(.)-.65 E F1
<ad69>144 672 Q F0 .557(The v)27.52 F .558
E F0(abo)2.5 E -.15(ve)-.15 G(\).).15 E F1<ad41>144 655.2 Q F0(Each)
23.08 E F2(name)2.5 E F0(is an associati)2.5 E .3 -.15(ve a)-.25 H
(rray v).15 E(ariable \(see)-.25 E F1(Arrays)2.5 E F0(abo)2.5 E -.15(ve)
-.15 G(\).).15 E F1<ad66>144 667.2 Q F0(Use function names only)26.97 E
(.)-.65 E F1<ad69>144 679.2 Q F0 .557(The v)27.52 F .558
(ariable is treated as an inte)-.25 F .558(ger; arithmetic e)-.15 F -.25
(va)-.25 G .558(luation \(see).25 F F3 .558(ARITHMETIC EV)3.058 F(ALU)
-1.215 E(A-)-.54 E(TION)180 684 Q F0(abo)2.25 E -.15(ve)-.15 G 2.5(\)i)
.15 G 2.5(sp)-2.5 G(erformed when the v)-2.5 E(ariable is assigned a v)
-.25 E(alue.)-.25 E F1<ad6c>144 696 Q F0 .91(When the v)27.52 F .909
(ariable is assigned a v)-.25 F .909(alue, all upper)-.25 F .909
(-case characters are con)-.2 F -.15(ve)-.4 G .909(rted to lo).15 F(wer)
-.25 E(-)-.2 E 2.5(case. The)180 708 R(upper)2.5 E(-case attrib)-.2 E
(ute is disabled.)-.2 E(GNU Bash-4.0)72 768 Q(2004 Apr 20)148.735 E(5)
203.725 E 0 Cg EP
-1.215 E(A-)-.54 E(TION)180 691.2 Q F0(abo)2.25 E -.15(ve)-.15 G 2.5
(\)i).15 G 2.5(sp)-2.5 G(erformed when the v)-2.5 E
(ariable is assigned a v)-.25 E(alue.)-.25 E F1<ad6c>144 703.2 Q F0 .91
(When the v)27.52 F .909(ariable is assigned a v)-.25 F .909
(alue, all upper)-.25 F .909(-case characters are con)-.2 F -.15(ve)-.4
G .909(rted to lo).15 F(wer)-.25 E(-)-.2 E 2.5(case. The)180 715.2 R
(upper)2.5 E(-case attrib)-.2 E(ute is disabled.)-.2 E(GNU Bash-4.0)72
768 Q(2004 Apr 20)148.735 E(5)203.725 E 0 Cg EP
%%Page: 6 6
%%BeginPageSetup
BP
@@ -856,7 +857,7 @@ F 2.671(fr)-.25 G .171(eadonly status for a readonly v)-2.671 F .172
-.25 G .96(rray status for an array v)-3.46 F .96
(ariable, or an attempt is made to display a)-.25 F(non-e)144 280.8 Q
(xistent function with)-.15 E F1<ad66>2.5 E F0(.)A F1(dirs [+)108 297.6
Q F2(n)A F1 2.5(][)C<ad>-2.5 E F2(n)A F1 2.5(][)C(\255cplv])-2.5 E F0
Q F2(n)A F1 2.5(][)C<ad>-2.5 E F2(n)A F1 2.5(][)C(\255clpv])-2.5 E F0
-.4(Wi)144 309.6 S .328
(thout options, displays the list of currently remembered directories.)
.4 F .329(The def)5.329 F .329(ault display is on a)-.1 F 1.238
@@ -1334,11 +1335,11 @@ F0 2.5(][)C F2(jobspec)A F0(... ])2.5 E F3(jobs \255x)108 172.8 Q F2
(obs. The).15 F(options ha)2.5 E .3 -.15(ve t)-.2 H(he follo).15 E
(wing meanings:)-.25 E F3<ad6c>144 196.8 Q F0
(List process IDs in addition to the normal information.)27.52 E F3
<ad70>144 208.8 Q F0(List only the process ID of the job')24.74 E 2.5
(sp)-.55 G(rocess group leader)-2.5 E(.)-.55 E F3<ad6e>144 220.8 Q F0
.194(Display information only about jobs that ha)24.74 F .494 -.15(ve c)
-.2 H .193(hanged status since the user w).15 F .193(as last noti-)-.1 F
(\214ed of their status.)180 232.8 Q F3<ad72>144 244.8 Q F0
<ad6e>144 208.8 Q F0 .194(Display information only about jobs that ha)
24.74 F .494 -.15(ve c)-.2 H .193(hanged status since the user w).15 F
.193(as last noti-)-.1 F(\214ed of their status.)180 220.8 Q F3<ad70>144
232.8 Q F0(List only the process ID of the job')24.74 E 2.5(sp)-.55 G
(rocess group leader)-2.5 E(.)-.55 E F3<ad72>144 244.8 Q F0
(Restrict output to running jobs.)25.86 E F3<ad73>144 256.8 Q F0
(Restrict output to stopped jobs.)26.41 E(If)144 273.6 Q F2(jobspec)
4.553 E F0 .313(is gi)3.123 F -.15(ve)-.25 G .313
@@ -2156,8 +2157,8 @@ F1(DEB)4.167 E(UG)-.1 E F0 1.667(trap returns a non-zero v)4.167 F 1.667
184 192 Q F0 .805(Error tracing is enabled:)28.5 F .804
(command substitution, shell functions, and subshells)5.805 F(in)220 204
Q -.2(vo)-.4 G -.1(ke).2 G 2.5(dw).1 G(ith)-2.5 E F1(\()2.5 E F3
(command)2.5 E F1(\))2.5 E F0(inherit the)2.5 E F1(ERR)2.5 E(OR)-.3 E F0
(trap.)2.5 E F1(extglob)144 216 Q F0 .4(If set, the e)8.89 F .4
(command)2.5 E F1(\))2.5 E F0(inherit the)2.5 E F1(ERR)2.5 E F0(trap.)
2.5 E F1(extglob)144 216 Q F0 .4(If set, the e)8.89 F .4
(xtended pattern matching features described abo)-.15 F .7 -.15(ve u)
-.15 H(nder).15 E F1 -.1(Pa)2.9 G .4(thname Expan-).1 F(sion)184 228 Q
F0(are enabled.)2.5 E F1(extquote)144 240 Q F0 2.473(If set,)184 252 R
@@ -2407,8 +2408,8 @@ to print a list of signal names and their corresponding num-)2.83 F
4.311(bers. Each)144 501.6 R F4(sigspec)4.651 E F0 1.811
(is either a signal name de\214ned in <)4.621 F F4(signal.h)A F0 1.81
(>, or a signal number)B 6.81(.S)-.55 G(ignal)-6.81 E
(names are case insensiti)144 513.6 Q .3 -.15(ve a)-.25 H
(nd the SIG pre\214x is optional.).15 E 1.648(If a)144 531.6 R F4
(names are case insensiti)144 513.6 Q .3 -.15(ve a)-.25 H(nd the).15 E
F2(SIG)2.5 E F0(pre\214x is optional.)2.25 E 1.648(If a)144 531.6 R F4
(sigspec)4.488 E F0(is)4.458 E F2(EXIT)4.148 E F0 1.648
(\(0\) the command)3.898 F F4(ar)4.479 E(g)-.37 E F0 1.649(is e)4.369 F
-.15(xe)-.15 G 1.649(cuted on e).15 F 1.649(xit from the shell.)-.15 F
doc/rbash.ps
+1 -1
View File
@@ -1,6 +1,6 @@
%!PS-Adobe-3.0
%%Creator: groff version 1.19.2
%%CreationDate: Wed Dec 30 13:07:37 2009
%%CreationDate: Fri Jan 15 11:36:45 2010
%%DocumentNeededResources: font Times-Roman
%%+ font Times-Bold
%%DocumentSuppliedResources: procset grops 1.19 2
doc/version.texi
+4 -4
View File
@@ -1,10 +1,10 @@
@ignore
Copyright (C) 1988-2009 Free Software Foundation, Inc.
Copyright (C) 1988-2010 Free Software Foundation, Inc.
@end ignore
@set LASTCHANGE Wed Dec 23 16:29:41 EST 2009
@set LASTCHANGE Fri Jan 15 10:50:20 EST 2010
@set EDITION 4.1
@set VERSION 4.1
@set UPDATED 23 December 2009
@set UPDATED-MONTH December 2009
@set UPDATED 15 January 2010
@set UPDATED-MONTH January 2010
examples/scripts/bash-hexdump.sh
+69
View File
@@ -0,0 +1,69 @@
#From: "dennis" <dennis@netstrata.com>
#To: <bash-maintainers@gnu.org>
#Subject: New example script: bash-hexdump
#Date: Mon, 4 Jan 2010 22:48:19 -0700
#Message-ID: <6dbec42d$64fcdbd2$4a32cf2d$@com>
#I've written a script that functions like "hexdump -C" or "hd". If you'd
#like to include it in a future distribution of example Bash scripts, I have
#included it here:
#!/bin/bash
# bash-hexdump# pure Bash, no externals
# by Dennis Williamson - 2010-01-04
# in response to
http://stackoverflow.com/questions/2003803/show-hexadecimal-numbers-of-a-fil
e
# usage: bash-hexdump file
saveIFS="$IFS"
IFS="" # disables interpretation of \t, \n and space
saveLANG="$LANG"
LANG=C # allows characters > 0x7F
bytecount=0
valcount=0
printf "%08x " $bytecount
while read -d '' -r -n 1 char # -d '' allows newlines, -r allows \
do
((bytecount++)) # for information about the apostrophe in this printf
command, see #
http://www.opengroup.org/onlinepubs/009695399/utilities/printf.html
printf -v val "%02x" "'$char"
echo -n "$val "
((valcount++))
if [[ "$val" < 20 || "$val" > 7e ]]
then
string+="." # show unprintable characters as a dot
else
string+=$char
fi
if (( bytecount % 8 == 0 )) # add a space down the middle
then
echo -n " "
fi
if (( bytecount % 16 == 0 )) # print 16 values per line
then
echo "|$string|"
string=''
valcount=0
printf "%08x " $bytecount
fi
done < "$1"
if [[ "$string" != "" ]] # if the last line wasn't full, pad it
out
then
length=${#string}
if (( length > 7 ))
then
((length--))
fi
(( length += (16 - valcount) * 3 + 4))
printf "%${length}s\n" "|$string|"
printf "%08x " $bytecount
fi
echo
LANG="$saveLANG";
IFS="$saveIFS"
exit 0
lib/glob/Makefile.in
+4
View File
@@ -119,6 +119,9 @@ realclean distclean maintainer-clean: clean
mostlyclean: clean
-( cd doc && $(MAKE) $(MFLAGS) $@ )
${BUILD_DIR}/pathnames.h: ${BUILD_DIR}/config.h ${BUILD_DIR}/Makefile Makefile
-( cd ${BUILD_DIR} && ${MAKE} ${MFLAGS} pathnames.h )
######################################################################
# #
# Dependencies for the object files which make up this library. #
@@ -137,6 +140,7 @@ strmatch.o: $(BUILD_DIR)/config.h
strmatch.o: $(BASHINCDIR)/stdc.h
glob.o: $(BUILD_DIR)/config.h
glob.o: $(topdir)/shell.h $(BUILD_DIR)/pathnames.h
glob.o: $(topdir)/bashtypes.h $(BASHINCDIR)/ansi_stdlib.h $(topdir)/bashansi.h
glob.o: $(BASHINCDIR)/posixstat.h $(BASHINCDIR)/memalloc.h
glob.o: strmatch.h glob.h
lib/readline/complete.c
+9 -9
View File
@@ -1,6 +1,6 @@
/* complete.c -- filename completion for readline. */
/* Copyright (C) 1987-2009 Free Software Foundation, Inc.
/* Copyright (C) 1987-2010 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.
@@ -2304,14 +2304,14 @@ rl_old_menu_complete (count, invoking_key)
if (matches == 0 || postprocess_matches (&matches, matching_filenames) == 0)
{
rl_ding ();
rl_ding ();
FREE (matches);
matches = (char **)0;
FREE (orig_text);
orig_text = (char *)0;
completion_changed_buffer = 0;
RL_UNSETSTATE(RL_STATE_COMPLETING);
return (0);
completion_changed_buffer = 0;
RL_UNSETSTATE(RL_STATE_COMPLETING);
return (0);
}
RL_UNSETSTATE(RL_STATE_COMPLETING);
@@ -2428,14 +2428,14 @@ rl_menu_complete (count, ignore)
if (matches == 0 || postprocess_matches (&matches, matching_filenames) == 0)
{
rl_ding ();
rl_ding ();
FREE (matches);
matches = (char **)0;
FREE (orig_text);
orig_text = (char *)0;
completion_changed_buffer = 0;
RL_UNSETSTATE(RL_STATE_COMPLETING);
return (0);
completion_changed_buffer = 0;
RL_UNSETSTATE(RL_STATE_COMPLETING);
return (0);
}
RL_UNSETSTATE(RL_STATE_COMPLETING);
lib/readline/complete.c~
+2530
View File
File diff suppressed because it is too large Load Diff
lib/readline/doc/rluser.texi
+19 -19
View File
@@ -1933,17 +1933,6 @@ User names. May also be specified as @option{-u}.
Names of all shell variables. May also be specified as @option{-v}.
@end table
@item -G @var{globpat}
The filename expansion pattern @var{globpat} is expanded to generate
the possible completions.
@item -W @var{wordlist}
The @var{wordlist} is split using the characters in the
@env{IFS} 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 completed.
@item -C @var{command}
@var{command} is executed in a subshell environment, and its output is
used as the possible completions.
@@ -1954,13 +1943,9 @@ environment.
When it finishes, the possible completions are retrieved from the value
of the @env{COMPREPLY} array variable.
@item -X @var{filterpat}
@var{filterpat} is a pattern as used for filename expansion.
It is applied to the list of possible completions generated by the
preceding options and arguments, and each completion matching
@var{filterpat} is removed from the list.
A leading @samp{!} in @var{filterpat} negates the pattern; in this
case, any completion not matching @var{filterpat} is removed.
@item -G @var{globpat}
The filename expansion pattern @var{globpat} is expanded to generate
the possible completions.
@item -P @var{prefix}
@var{prefix} is added at the beginning of each possible completion
@@ -1969,6 +1954,21 @@ after all other options have been applied.
@item -S @var{suffix}
@var{suffix} is appended to each possible completion
after all other options have been applied.
@item -W @var{wordlist}
The @var{wordlist} is split using the characters in the
@env{IFS} 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 completed.
@item -X @var{filterpat}
@var{filterpat} is a pattern as used for filename expansion.
It is applied to the list of possible completions generated by the
preceding options and arguments, and each completion matching
@var{filterpat} is removed from the list.
A leading @samp{!} in @var{filterpat} negates the pattern; in this
case, any completion not matching @var{filterpat} is removed.
@end table
The return value is true unless an invalid option is supplied, an option
@@ -1983,7 +1983,7 @@ an error occurs adding a completion specification.
@code{compopt} [-o @var{option}] [-DE] [+o @var{option}] [@var{name}]
@end example
Modify completion options for each @var{name} according to the
@var{option}s, or for the currently-execution completion if no @var{name}s
@var{option}s, or for the currently-executing completion if no @var{name}s
are supplied.
If no @var{option}s are given, display the completion options for each
@var{name} or the current completion.
parse.y
+1 -1
View File
@@ -1,6 +1,6 @@
/* parse.y - Yacc grammar for bash. */
/* Copyright (C) 1989-2009 Free Software Foundation, Inc.
/* Copyright (C) 1989-2010 Free Software Foundation, Inc.
This file is part of GNU Bash, the Bourne Again SHell.
patchlevel.h
+1 -1
View File
@@ -25,6 +25,6 @@
regexp `^#define[ ]*PATCHLEVEL', since that's what support/mkversion.sh
looks for to find the patch level (for the sccs version string). */
#define PATCHLEVEL 0
#define PATCHLEVEL 2
#endif /* _PATCHLEVEL_H_ */
patchlevel.h~
+30
View File
@@ -0,0 +1,30 @@
/* patchlevel.h -- current bash patch level */
/* Copyright (C) 2001-2009 Free Software Foundation, Inc.
This file is part of GNU Bash, the Bourne Again SHell.
Bash is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
Bash is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with Bash. If not, see <http://www.gnu.org/licenses/>.
*/
#if !defined (_PATCHLEVEL_H_)
#define _PATCHLEVEL_H_
/* It's important that there be no other strings in this file that match the
regexp `^#define[ ]*PATCHLEVEL', since that's what support/mkversion.sh
looks for to find the patch level (for the sccs version string). */
#define PATCHLEVEL 1
#endif /* _PATCHLEVEL_H_ */
po/id.po
+589 -1152
View File
File diff suppressed because it is too large Load Diff
variables.c
+1
View File
@@ -1309,6 +1309,7 @@ get_random (var)
rv = get_random_number ();
last_random_value = rv;
fprintf(stderr, "get_random: rv = %d\n", rv);
p = itos (rv);
FREE (value_cell (var));