diff options
Diffstat (limited to 'doc/bash.html')
| -rw-r--r-- | doc/bash.html | 86 |
1 files changed, 66 insertions, 20 deletions
diff --git a/doc/bash.html b/doc/bash.html index 11b794f0..963448ee 100644 --- a/doc/bash.html +++ b/doc/bash.html @@ -3,7 +3,7 @@ </HEAD> <BODY><TABLE WIDTH=100%> <TR> -<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2008 February 22<TH ALIGN=RIGHT width=33%>BASH(1) +<TH ALIGN=LEFT width=33%>BASH(1)<TH ALIGN=CENTER width=33%>2008 April 5<TH ALIGN=RIGHT width=33%>BASH(1) </TR> </TABLE> <BR><A HREF="#index">Index</A> @@ -798,13 +798,9 @@ command to terminate in turn. The return status is the exit status of the last command executed. <P> -The control operators -<B>&&</B> - -and -<B>||</B> - -denote AND lists and OR lists, respectively. +AND and OR lists are sequences of one of more pipelines separated by the +<B>&&</B> and <B>||</B> control operators, respectively. +AND and OR lists are executed with left associativity. An AND list has the form <DL COMPACT><DT><DD> <P> @@ -838,7 +834,8 @@ An OR list has the form is executed if and only if <I>command1</I> -returns a non-zero exit status. The return status of +returns a non-zero exit status. +The return status of AND and OR lists is the exit status of the last command executed in the list. <A NAME="lbAO"> </A> @@ -1632,14 +1629,14 @@ Expands to the full file name used to invoke this instance of <DT><B>BASHPID</B> <DD> -Expands to the process id of the current bash process. +Expands to the process id of the current <B>bash</B> process. This differs from <B>$$</B> under certain circumstances, such as subshells -that do not require bash to be re-initialized. +that do not require <B>bash</B> to be re-initialized. <DT><B>BASH_ARGC</B> <DD> An array variable whose values are the number of parameters in each -frame of the current bash execution call stack. +frame of the current <B>bash</B> execution call stack. The number of parameters to the current subroutine (shell function or script executed with <B>.</B> or <B>source</B>) is at the top of the stack. @@ -1656,7 +1653,7 @@ builtin below) <DT><B>BASH_ARGV</B> <DD> -An array variable containing all of the parameters in the current bash +An array variable containing all of the parameters in the current <B>bash</B> execution call stack. The final parameter of the last subroutine call is at the top of the stack; the first parameter of the initial call is at the bottom. When a subroutine is executed, the parameters supplied @@ -6130,6 +6127,11 @@ attempts word completion. If set to <B>on</B>, the history code attempts to place point at the same location on each history line retrieved with <B>previous-history</B> or <B>next-history</B>. +<DT><B>history-size (0)</B> + +<DD> +Set the maximum number of history entries saved in the history list. If +set to zero, the number of entries in the history list is not limited. <DT><B>horizontal-scroll-mode (Off)</B> <DD> @@ -8390,6 +8392,21 @@ a <I>name</I> for which no specification exists, or an error occurs adding a completion specification. </DL> +<DT><B>compopt</B> [<B>-o</B> <I>option</I>] [<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. +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> +builtin described above. +</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>, @@ -8432,7 +8449,16 @@ option will display the attributes and values of each When <B>-p</B> -is used, additional options are ignored. +is used with <I>name</I> arguments, additional options are ignored. +When +<B>-p</B> + +is supplied without <I>name</I> arguments, it will display the attributes +and values of all variables having the attributes specified by the +additional options. +If no other options are supplied with <B>-p</B>, <B>declare</B> will display +the attributes and values of all shell variables. The <B>-f</B> option +will restrict the display to shell functions. The <B>-F</B> @@ -9619,7 +9645,7 @@ option is used, the pathname printed may contain symbolic links. The return status is 0 unless an error occurs while reading the name of the current directory or an invalid option is supplied. -<DT><B>read</B> [<B>-ers</B>] [<B>-a</B> <I>aname</I>] [<B>-d</B> <I>delim</I>] [<B>-n</B> <I>nchars</I>] [<B>-p</B> <I>prompt</I>] [<B>-t</B> <I>timeout</I>] [<B>-u</B> <I>fd</I>] [<I>name</I> ...]<DD> +<DT><B>read</B> [<B>-ers</B>] [<B>-a</B> <I>aname</I>] [<B>-d</B> <I>delim</I>] [- <I>text</I>] [<B>-n</B> <I>nchars</I>] [<B>-p</B> <I>prompt</I>] [<B>-t</B> <I>timeout</I>] [<B>-u</B> <I>fd</I>] [<I>name</I> ...]<DD> One line is read from the standard input, or from the file descriptor <I>fd</I> supplied as an argument to the <B>-u</B> option, and the first word is assigned to the first @@ -9674,6 +9700,14 @@ is coming from a terminal, </FONT> above) is used to obtain the line. +<DT><B>-i </B><I>text</I> + +<DD> +If +<B>readline</B> + +is being used to read the line, <I>text</I> is placed into the editing +buffer before editing begins. <DT><B>-n </B><I>nchars</I> <DD> @@ -10367,7 +10401,7 @@ longer exists, a normal path search is performed. <DT><B>checkjobs</B> <DD> -If set, bash lists the status of any stopped and running jobs before +If set, <B>bash</B> lists the status of any stopped and running jobs before exiting an interactive shell. If any jobs are running, this causes the exit to be deferred until a second exit is attempted without an intervening command (see <B>JOB CONTROL</B> above). The shell always @@ -11047,7 +11081,7 @@ option suppresses shell function lookup, as with the <B>command</B> builtin. returns true if any of the arguments are found, false if none are found. -<DT><B>ulimit</B> [<B>-SHacdefilmnpqrstuvx</B> [<I>limit</I>]]<DD> +<DT><B>ulimit</B> [<B>-HSTabcdefilmnpqrstuvx</B> [<I>limit</I>]]<DD> Provides control over the resources available to the shell and to processes started by it, on systems that allow such control. The <B>-H</B> and <B>-S</B> options specify that the hard or soft limit is @@ -11084,6 +11118,10 @@ Other options are interpreted as follows: <DD> All current limits are reported +<DT><B>-b</B> + +<DD> +The maximum socket buffer size <DT><B>-c</B> <DD> @@ -11149,6 +11187,10 @@ The maximum amount of virtual memory available to the shell <DD> The maximum number of file locks +<DT><B>-T</B> + +<DD> +The maximum number of threads </DL> <P> @@ -11171,7 +11213,11 @@ which is in seconds, which is in units of 512-byte blocks, and -<B>-n</B> +<B>-T</B>, + +<B>-b</B>, + +<B>-n</B>, and <B>-u</B>, @@ -11571,7 +11617,7 @@ Array variables may not (yet) be exported. <HR> <TABLE WIDTH=100%> <TR> -<TH ALIGN=LEFT width=33%>GNU Bash-3.2<TH ALIGN=CENTER width=33%>2008 February 22<TH ALIGN=RIGHT width=33%>BASH(1) +<TH ALIGN=LEFT width=33%>GNU Bash-3.2<TH ALIGN=CENTER width=33%>2008 April 5<TH ALIGN=RIGHT width=33%>BASH(1) </TR> </TABLE> <HR> @@ -11675,6 +11721,6 @@ Array variables may not (yet) be exported. </DL> <HR> This document was created by man2html from bash.1.<BR> -Time: 04 March 2008 08:38:15 EST +Time: 08 April 2008 09:50:33 EDT </BODY> </HTML> |