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

commit bash-20100722 snapshot

Browse Source
This commit is contained in:
Chet Ramey
2011-12-12 22:03:26 -05:00
parent e054386f3f
commit 9ec5ed6640
69 changed files with 15989 additions and 9437 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/bash.html
+45 -14
View File
@@ -3,7 +3,7 @@
</HEAD>
<BODY><TABLE WIDTH=100%>
<TR>
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2010 June 12<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2010 July 21<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<BR><A HREF="#index">Index</A>
@@ -736,6 +736,8 @@ reserved word precedes a pipeline, the elapsed as well as user and
system time consumed by its execution are reported when the pipeline
terminates.
The <B>-p</B> option changes the output format to that specified by POSIX.
When the shell is in <I>posix mode</I>, it does not recognize
<B>time</B> as a reserved word if the next token begins with a `-'.
The
<FONT SIZE=-1><B>TIMEFORMAT</B>
@@ -1214,7 +1216,10 @@ A shell function is an object that is called like a simple command and
executes a compound command with a new set of positional parameters.
Shell functions are declared as follows:
<DL COMPACT>
<DT>[ <B>function</B> ] <I>name</I> () <I>compound-command</I> [<I>redirection</I>]<DD>
<DT><I>name</I> () <I>compound-command</I> [<I>redirection</I>]<DD>
<DT><B>function</B> <I>name</I> [()] <I>compound-command</I> [<I>redirection</I>]<DD>
This defines a function named <I>name</I>.
The reserved word <B>function</B> is optional.
If the <B>function</B> reserved word is supplied, the parentheses are optional.
@@ -1856,15 +1861,16 @@ The command argument to the <B>-c</B> invocation option.
<DD>
An array variable whose members are the line numbers in source files
corresponding to each member of
<FONT SIZE=-1><B>FUNCNAME</B>.
where each corresponding member of
<FONT SIZE=-1><B>FUNCNAME</B>
</FONT>
was invoked.
<B>${BASH_LINENO[</B><I>$i</I><B>]}</B> is the line number in the source
file where <B>${FUNCNAME[</B><I>$i</I><B>]}</B> was called
file (<B>${BASH_SOURCE[</B><I>$i+1</I><B>]}</B>) where
<B>${FUNCNAME[</B><I>$i</I><B>]}</B> was called
(or <B>${BASH_LINENO[</B><I>$i-1</I><B>]}</B> if referenced within another
shell function).
The corresponding source file name is <B>${BASH_SOURCE[</B><I>$i</I><B>]}</B>.
Use
<FONT SIZE=-1><B>LINENO</B>
@@ -1883,12 +1889,16 @@ This variable is read-only.
<DT><B>BASH_SOURCE</B>
<DD>
An array variable whose members are the source filenames corresponding
to the elements in the
An array variable whose members are the source filenames
where the corresponding shell function names in the
<FONT SIZE=-1><B>FUNCNAME</B>
</FONT>
array variable.
array variable are defined.
The shell function
<B>${FUNCNAME[</B><I>$i</I><B>]}</B> is defined in the file
<B>${BASH_SOURCE[</B><I>$i</I><B>]}</B> and called from
<B>${BASH_SOURCE[</B><I>$i+1</I><B>]}</B>.
<DT><B>BASH_SUBSHELL</B>
<DD>
@@ -2057,7 +2067,7 @@ An array variable containing the names of all shell functions
currently in the execution call stack.
The element with index 0 is the name of any currently-executing
shell function.
The bottom-most element is
The bottom-most element (the one with the highest index) is
<TT>&quot;main&quot;</TT>.
This variable exists only when a shell function is executing.
@@ -2072,6 +2082,17 @@ If
</FONT>
is unset, it loses its special properties, even if it is
subsequently reset.
<P>
This variable can be used with <B>BASH_LINENO</B> and <B>BASH_SOURCE</B>.
Each element of <B>FUNCNAME</B> has corresponding elements in
<B>BASH_LINENO</B> and <B>BASH_SOURCE</B> to describe the call stack.
For instance, <B>${FUNCNAME[</B><I>$i</I><B>]}</B> was called from the file
<B>${BASH_SOURCE[</B><I>$i+1</I><B>]}</B> at line number
<B>${BASH_LINENO[</B><I>$i</I><B>]}</B>.
The <B>caller</B> builtin displays the current call stack using this
information.
<DT><B>GROUPS</B>
<DD>
@@ -4976,8 +4997,10 @@ shell's children.
Care should be taken in cases where this may cause a problem.
<P>
Functions may be recursive. No limit is imposed on the number
of recursive calls.
Functions may be recursive.
The <B>FUNCNEST</B> variable may be used to limit the depth of the
function call stack and restrict the number of function invocations.
By default, no limit is imposed on the number of recursive calls.
<A NAME="lbBV">&nbsp;</A>
<H3>ARITHMETIC EVALUATION</H3>
@@ -9402,6 +9425,9 @@ backspace
suppress further output
<DT><B>\e</B>
<DD>
<DT><B>\E</B>
<DD>
an escape character
<DT><B>\f</B>
@@ -11585,6 +11611,11 @@ line to be ignored in an interactive shell (see
</FONT>
above). This option is enabled by default.
<DT><B>lastpipe</B>
<DD>
If set, and job control is not active, the shell runs the last command of
a pipeline not executed in the background in the current shell environment.
<DT><B>lithist</B>
<DD>
@@ -12629,7 +12660,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%>2010 June 12<TH ALIGN=RIGHT width=33%>BASH(1)
<TH ALIGN=LEFT width=33%>GNU Bash-4.2<TH ALIGN=CENTER width=33%>2010 July 21<TH ALIGN=RIGHT width=33%>BASH(1)
</TR>
</TABLE>
<HR>
@@ -12735,6 +12766,6 @@ There may be only one active coprocess at a time.
</DL>
<HR>
This document was created by man2html from bash.1.<BR>
Time: 29 June 2010 14:02:49 EDT
Time: 21 July 2010 08:54:57 EDT
</BODY>
</HTML>