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

commit bash-20111229 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2012-01-09 08:37:11 -05:00
parent eb4206df36
commit 45c0f7f8e8
38 changed files with 22796 additions and 18994 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/bash.html
+83 -32
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2011 September 25<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2011 December 24<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -37,7 +37,7 @@ bash - GNU Bourne-Again SHell
<B>bash</B>
[options]
[file]
[command_string | file]
<A NAME="lbAD">&nbsp;</A>
<H3>COPYRIGHT</H3>
@@ -76,17 +76,17 @@ interprets the following options when it is invoked:
<DL COMPACT>
<DT><B>-c</B><I> string</I>
<DT><B>-c</B>
<DD>
If the
<B>-c</B>
option is present, then commands are read from
<I>string</I>.
option is present, then commands are read from the first non-option argument
<I>command_string</I>.
If there are arguments after the
<I>string</I>,
<I>command_string</I>,
they are assigned to the positional parameters, starting with
<B>$0</B>.
@@ -955,6 +955,10 @@ is enabled, the match is performed without regard to the case
of alphabetic characters.
Any part of the pattern may be quoted to force the quoted portion
to be matched as a string.
Bracket expressions in regular expressions must be treated carefully,
since normal quoting characters lose their meanings between brackets.
If the pattern is stored in a shell variable, quoting the variable
expansion forces the entire pattern to be matched as a string.
Substrings matched by parenthesized subexpressions within the regular
expression are saved in the array variable
<FONT SIZE=-1><B>BASH_REMATCH</B>.
@@ -2417,6 +2421,7 @@ upon receipt of a
An array variable from which <B>bash</B> reads the possible completions
generated by a shell function invoked by the programmable completion
facility (see <B>Programmable Completion</B> below).
Each array element contains one possible completion.
<DT><B>EMACS</B>
<DD>
@@ -2530,10 +2535,14 @@ command history is not saved when an interactive shell exits.
<DD>
The maximum number of lines contained in the history file. When this
variable is assigned a value, the history file is truncated, if
necessary, by removing the oldest entries,
to contain no more than that number of lines. The default
value is 500. The history file is also truncated to this size after
necessary,
to contain no more than that number of lines by removing the oldest entries.
The history file is also truncated to this size after
writing it when an interactive shell exits.
If the value is 0, the history file is truncated to zero size.
Non-numeric values and numeric values less than zero inhibit truncation.
The shell sets the default value to the value of <B>HISTSIZE</B>
after reading any startup files.
<DT><B>HISTIGNORE</B>
<DD>
@@ -2561,7 +2570,11 @@ The number of commands to remember in the command history (see
<FONT SIZE=-1><B>HISTORY</B>
</FONT>
below). The default value is 500.
below).
If the value is 0, commands are not saved in the history list.
Numeric values less than zero result in every command being saved
on the history list (there is no limit).
The shell sets the default value to 500 after reading any startup files.
<DT><B>HISTTIMEFORMAT</B>
<DD>
@@ -3720,6 +3733,9 @@ array in turn, and the expansion is the resultant list.
This expansion modifies the case of alphabetic characters in <I>parameter</I>.
The <I>pattern</I> is expanded to produce a pattern just as in
pathname expansion.
Each character in the expanded value of <I>parameter</I> is tested against
<I>pattern</I>, and, if it matches the pattern, its case is converted.
The pattern should not attempt to match more than one character.
The <B>^</B> operator converts lowercase letters matching <I>pattern</I>
to uppercase; the <B>,</B> operator converts matching uppercase letters
to lowercase.
@@ -7613,6 +7629,10 @@ and store the definition.
<DD>
Re-execute the last keyboard macro defined, by making the characters
in the macro appear as if typed at the keyboard.
<B>print-last-kbd-macro ()</B>
Print the last keyboard macro defined in a format suitable for the
<I>inputrc</I> file.
</DL>
<A NAME="lbCU">&nbsp;</A>
@@ -7879,10 +7899,12 @@ and
</FONT>
variables are also set.
When the function or command is invoked, the first argument is the
name of the command whose arguments are being completed, the
second argument is the word being completed, and the third argument
is the word preceding the word being completed on the current command line.
When the function or command is invoked,
the first argument (<B>$1</B>) is the name of the command whose arguments are
being completed,
the second argument (<B>$2</B>) is the word being completed,
and the third argument (<B>$3</B>) is the word preceding the word being
completed on the current command line.
No filtering of the generated completions against the word being completed
is performed; the function or command has complete freedom in generating
the matches.
@@ -7895,7 +7917,7 @@ It must put the possible completions in the
<FONT SIZE=-1><B>COMPREPLY</B>
</FONT>
array variable.
array variable, one per array element.
<P>
Next, any command specified with the <B>-C</B> option is invoked
@@ -8041,6 +8063,8 @@ the number of lines specified by the value of
<FONT SIZE=-1><B>HISTFILESIZE</B>.
</FONT>
If <B>HISTFILESIZE</B> is unset, or set to null, a non-numeric value,
or a numeric value less than zero, the history file is not truncated.
When the history file is read,
lines beginning with the history comment character followed immediately
by a digit are interpreted as timestamps for the preceding history line.
@@ -8094,7 +8118,8 @@ lines. If
<FONT SIZE=-1><B>HISTFILESIZE</B>
</FONT>
is not set, no truncation is performed.
is unset, or set to null, a non-numeric value,
or a numeric value less than zero, the history file is not truncated.
<P>
The builtin command
@@ -8309,7 +8334,7 @@ history list starting with
<DT><B>!?</B><I>string</I><B>[?]</B>
<DD>
Refer to the most recent command preceding the current postition in the
Refer to the most recent command preceding the current position in the
history list containing
<I>string</I>.
@@ -8631,7 +8656,7 @@ is not present, the shell's notion of the <I>current job</I> is used.
returns 0 unless run when job control is disabled or, when run with
job control enabled, any specified <I>jobspec</I> was not found
or was started without job control.
<DT><B>bind</B> [<B>-m</B> <I>keymap</I>] [<B>-lpsvPSV</B>]<DD>
<DT><B>bind</B> [<B>-m</B> <I>keymap</I>] [<B>-lpsvPSVX</B>]<DD>
<DT><B>bind</B> [<B>-m</B> <I>keymap</I>] [<B>-q</B> <I>function</I>] [<B>-u</B> <I>function</I>] [<B>-r</B> <I>keyseq</I>]<DD>
<DT><B>bind</B> [<B>-m</B> <I>keymap</I>] <B>-f</B> <I>filename</I><DD>
@@ -8746,6 +8771,11 @@ or
</FONT>
those new values will be reflected in the editing state.
<DT><B>-X</B>
<DD>
List all key sequences bound to shell commands and the associated commands
in a format that can be reused as input.
</DL>
<P>
@@ -8801,21 +8831,25 @@ The return value is 0 unless the shell is not executing a subroutine
call or <I>expr</I> does not correspond to a valid position in the
call stack.
<DT><B>cd</B> [<B>-L</B>|[<B>-P</B> [<B>-e</B>]]] [<I>dir</I>]<DD>
Change the current directory to <I>dir</I>. The variable
Change the current directory to <I>dir</I>.
if <I>dir</I> is not supplied, the value of the
<FONT SIZE=-1><B>HOME</B>
</FONT>
is the
default
<I>dir</I>.
shell variable is the default.
Any additional arguments following <I>dir</I> are ignored.
The variable
<FONT SIZE=-1><B>CDPATH</B>
</FONT>
defines the search path for the directory containing
<I>dir</I>.
<I>dir</I>:
each directory name in
<FONT SIZE=-1><B>CDPATH</B>
</FONT>
is searched for <I>dir</I>.
Alternative directory names in
<FONT SIZE=-1><B>CDPATH</B>
@@ -8835,8 +8869,9 @@ then
is not used. The
<B>-P</B>
option says to use the physical directory structure instead of
following symbolic links (see also the
option causes <B>cd</B> to use the physical directory structure
by resolving symbolic links while traversing <I>dir</I> and
before processing instances of <I>..</I> in <I>dir</I> (see also the
<B>-P</B>
option to the
@@ -8845,7 +8880,11 @@ option to the
builtin command); the
<B>-L</B>
option forces symbolic links to be followed.
option forces symbolic links to be followed by resolving the link
after processing instances of <I>..</I> in <I>dir</I>.
If <I>..</I> appears in <I>dir</I>, it is processed by removing the
immediately previous pathname component from <I>dir</I>, back to a slash
or the beginning of <I>dir</I>.
If the
<B>-e</B>
@@ -9015,6 +9054,11 @@ Tell readline that the compspec generates filenames, so it can perform any
filename-specific processing (like adding a slash to directory names,
quoting special characters, or suppressing trailing spaces).
Intended to be used with shell functions.
<DT><B>noquote</B>
<DD>
Tell readline not to quote the completed words if they are filenames
(quoting filenames is the default).
<DT><B>nospace</B>
<DD>
@@ -9141,6 +9185,12 @@ used as the possible completions.
<DT><B>-F</B> <I>function</I><DD>
The shell function <I>function</I> is executed in the current shell
environment.
When the function is executed,
the first argument (<B>$1</B>) is the name of the command whose arguments are
being completed,
the second argument (<B>$2</B>) is the word being completed,
and the third argument (<B>$3</B>) is the word preceding the word being
completed on the current command line.
When it finishes, the possible completions are retrieved from the value
of the
<FONT SIZE=-1><B>COMPREPLY</B>
@@ -10767,8 +10817,9 @@ are supplied, the line read is assigned to the variable
</FONT>
The return code is zero, unless end-of-file is encountered, <B>read</B>
times out (in which case the return code is greater than 128), or an
invalid file descriptor is supplied as the argument to <B>-u</B>.
times out (in which case the return code is greater than 128),
a variable assignment error (such as assigning to a readonly variable) occurs,
or an invalid file descriptor is supplied as the argument to <B>-u</B>.
</DL>
<DT><B>readonly</B> [<B>-aAf</B>] [<B>-p</B>] [<I>name</I>[=<I>word</I>] ...]<DD>
@@ -11274,7 +11325,7 @@ default when the shell is interactive.
<DT><B>-P</B>
<DD>
If set, the shell does not follow symbolic links when executing
If set, the shell does not resolve symbolic links when executing
commands such as
<B>cd</B>
@@ -12848,7 +12899,7 @@ There may be only one active coprocess at a time.
<HR>
<TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>GNU Bash 4.2<TH ALIGN=CENTER width=33%>2011 September 25<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash 4.2<TH ALIGN=CENTER width=33%>2011 December 24<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -12954,6 +13005,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 24 October 2011 08:43:51 EDT
Time: 29 December 2011 15:07:27 EST
</BODY>
</HTML>