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

commit bash-20041122 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2011-12-03 13:40:08 -05:00
parent f75912ae36
commit eb2bb5621f
36 changed files with 12861 additions and 12273 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/bash.html
+52 -19
View File
@@ -2,7 +2,7 @@
<TITLE>BASH(1) Manual Page</TITLE>
</HEAD>
<BODY><TABLE WIDTH=100%>
<TH ALIGN=LEFT>BASH(1)<TH ALIGN=CENTER>2004 Sep 17<TH ALIGN=RIGHT>BASH(1)
<TH ALIGN=LEFT>BASH(1)<TH ALIGN=CENTER>2004 Nov 22<TH ALIGN=RIGHT>BASH(1)
</TABLE>
<BR><A HREF="#index">Index</A>
<HR>
@@ -131,7 +131,7 @@ when invoking an interactive shell.
<DD>
A list of all double-quoted strings preceded by <B>$</B>
is printed on the standard ouput.
is printed on the standard output.
These are the strings that
are subject to language translation when the current locale
is not <B>C</B> or <B>POSIX</B>.
@@ -1230,7 +1230,7 @@ below).
Words of the form <B>$</B>'<I>string</I>' are treated specially. The
word expands to <I>string</I>, with backslash-escaped characters replaced
as specifed by the ANSI C standard. Backslash escape sequences, if
as specified by the ANSI C standard. Backslash escape sequences, if
present, are decoded as follows:
<DL COMPACT><DT><DD>
@@ -1403,6 +1403,22 @@ and
<B>local</B>
builtin commands.
<P>
In the context where an assignment statement is assigning a value
to a shell variable or array index, the += operator can be used to
append to or add to the variable's previous value.
When += is applied to a variable for which the integer attribute has been
set, <I>value</I> is evaluated as an arithmetic expression and added to the
variable's current value, which is also evaluated.
When += is applied to an array variable using compound assignment (see
<B>Arrays</B>
below), the
variable's value is not unset (as it is when using =), and new values are
appended to the array beginning at one greater than the array's maximum index.
When applied to a string-valued variable, <I>value</I> is expanded and
appended to the variable's value.
<A NAME="lbAT">&nbsp;</A>
<H3>Positional Parameters</H3>
@@ -2534,10 +2550,7 @@ job identifier (see
</FONT>
below). If set to any other value, the supplied string must
be a prefix of a stopped job's name; this provides functionality
analogous to the
<B>%</B>
job identifier.
analogous to the <B>%</B><I>string</I> job identifier.
<DT><B>histchars</B>
<DD>
@@ -2893,7 +2906,7 @@ Each variable assignment is checked for unquoted tilde-prefixes immediately
following a
<B>:</B>
or
or the first
<B>=</B>.
In these cases, tilde expansion is also performed.
@@ -2924,7 +2937,7 @@ interpreted as part of the name.
When braces are used, the matching ending brace is the first `<B>}</B>'
not escaped by a backslash or within a quoted string, and not within an
embedded arithmetic expansion, command substitution, or paramter
embedded arithmetic expansion, command substitution, or parameter
expansion.
<P>
@@ -3037,6 +3050,10 @@ parameters beginning at <I>offset</I>.
If <I>parameter</I> is an array name indexed by @ or *,
the result is the <I>length</I>
members of the array beginning with ${<I>parameter</I>[<I>offset</I>]}.
A negative <I>offset</I> is taken relative to one greater than the maximum
index of the specified array.
Note that a negative offset must be separated from the colon by at least
one space to avoid being confused with the :- expansion.
Substring indexing is zero-based unless the positional parameters
are used, in which case the indexing starts at 1.
<DT>${<B>!</B><I>prefix</I><B>*</B>}<DD>
@@ -3668,7 +3685,7 @@ Matches zero or more occurrences of the given patterns
<DT><B>+(</B><I>pattern-list</I><B>)</B><DD>
Matches one or more occurrences of the given patterns
<DT><B>@(</B><I>pattern-list</I><B>)</B><DD>
Matches exactly one of the given patterns
Matches one of the given patterns
<DT><B>!(</B><I>pattern-list</I><B>)</B><DD>
Matches anything except one of the given patterns
</DL></DL>
@@ -3801,6 +3818,11 @@ a UDP connection to the corresponding socket.
<P>
A failure to open or create a file causes the redirection to fail.
<P>
Redirections using file descriptors greater than 9 should be used with
care, as they may conflict with file descriptors the shell uses
internally.
<A NAME="lbBI">&nbsp;</A>
<H3>Redirecting Input</H3>
@@ -4485,7 +4507,7 @@ If <I>base#</I> is omitted, then base 10 is used.
The digits greater than 9 are represented by the lowercase letters,
the uppercase letters, @, and _, in that order.
If <I>base</I> is less than or equal to 36, lowercase and uppercase
letters may be used interchangably to represent numbers between 10
letters may be used interchangeably to represent numbers between 10
and 35.
<P>
@@ -5275,6 +5297,8 @@ command), the current job is always flagged with a
and the previous job with a
<B>-</B>.
A single % (with no accompanying job specification) also refers to the
current job.
<P>
Simply naming a job can be used to bring it into the
@@ -5886,6 +5910,12 @@ Controls what happens when readline wants to ring the terminal bell.
If set to <B>none</B>, readline never rings the bell. If set to
<B>visible</B>, readline uses a visible bell if one is available.
If set to <B>audible</B>, readline attempts to ring the terminal's bell.
<DT><B>bind-tty-special-chars (On)</B>
<DD>
If set to <B>On</B>, readline attempts to bind the control characters
treated specially by the kernel's terminal driver to their readline
equivalents.
<DT><B>comment-begin (``#'')</B>
<DD>
@@ -5957,7 +5987,7 @@ attempts word completion.
<DD>
If set to <B>on</B>, the history code attempts to place point at the
same location on each history line retrived with <B>previous-history</B>
same location on each history line retrieved with <B>previous-history</B>
or <B>next-history</B>.
<DT><B>horizontal-scroll-mode (Off)</B>
@@ -6338,6 +6368,8 @@ With an argument
insert the <I>n</I>th word from the previous command (the words
in the previous command begin with word 0). A negative argument
inserts the <I>n</I>th word from the end of the previous command.
Once the argument <I>n</I> is computed, the argument is extracted
as if the &quot;!<I>n</I>&quot; history expansion had been specified.
<DT><B>yank-last-arg (M-., M-_)</B>
<DD>
@@ -6346,6 +6378,8 @@ the previous history entry). With an argument,
behave exactly like <B>yank-nth-arg</B>.
Successive calls to <B>yank-last-arg</B> move back through the history
list, inserting the last argument of each line in turn.
The history expansion facilities are used to extract the last argument,
as if the &quot;!$&quot; history expansion had been specified.
<DT><B>shell-expand-line (M-C-e)</B>
<DD>
@@ -6882,7 +6916,7 @@ of an <I>inputrc</I> file.
<DD>
Print all of the readline key sequences bound to macros and the
strings they ouput. If a numeric argument is supplied,
strings they output. If a numeric argument is supplied,
the output is formatted in such a way that it can be made part
of an <I>inputrc</I> file.
<DT><B>display-shell-version (C-x C-v)</B>
@@ -10940,8 +10974,7 @@ Read-only variables may not be unset.
If
<B>-f</B>
is specifed,
each
is specified, each
<I>name</I>
refers to a shell function, and the function definition
@@ -10976,9 +11009,9 @@ subsequently reset. The exit status is true unless a
<I>name</I>
is readonly.
<DT><B>wait</B> [<I>n</I>]<DD>
Wait for the specified process and return its termination
status.
<DT><B>wait</B> [<I>n ...</I>]<DD>
Wait for each specified process and return its termination status.
Each
<I>n</I>
may be a process
@@ -11373,6 +11406,6 @@ Array variables may not (yet) be exported.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 21 September 2004 11:57:09 EDT
Time: 22 November 2004 12:04:08 EST
</BODY>
</HTML>