diff options
author | Chet Ramey <chet.ramey@case.edu> | 2011-12-07 09:21:08 -0500 |
---|---|---|
committer | Chet Ramey <chet.ramey@case.edu> | 2011-12-07 09:21:08 -0500 |
commit | 6fbe76202c7f75931aa84702136d879525963857 (patch) | |
tree | 2eb782bcabae64738952681593e60529365108d2 /doc | |
parent | d356441fc69cf21730db35ed8ed63d6e210af762 (diff) | |
download | bash-6fbe76202c7f75931aa84702136d879525963857.tar.gz |
commit bash-20080327 snapshot
Diffstat (limited to 'doc')
-rw-r--r-- | doc/bash.1 | 50 | ||||
-rw-r--r-- | doc/bash.1~ | 72 | ||||
-rw-r--r-- | doc/bashref.texi | 31 | ||||
-rw-r--r-- | doc/bashref.texi~ | 31 | ||||
-rw-r--r-- | doc/version.texi | 6 | ||||
-rw-r--r-- | doc/version.texi~ | 8 |
6 files changed, 151 insertions, 47 deletions
@@ -5,12 +5,12 @@ .\" Case Western Reserve University .\" chet@po.cwru.edu .\" -.\" Last Change: Fri Feb 22 21:45:32 EST 2008 +.\" Last Change: Thu Mar 27 22:15:12 EDT 2008 .\" .\" bash_builtins, strip all but Built-Ins section .if \n(zZ=1 .ig zZ .if \n(zY=1 .ig zY -.TH BASH 1 "2008 February 22" "GNU Bash-3.2" +.TH BASH 1 "2008 March 27" "GNU Bash-3.2" .\" .\" There's some problem with having a `@' .\" in a tagged paragraph with the BSD man macros. @@ -594,11 +594,9 @@ are executed sequentially; the shell waits for each command to terminate in turn. The return status is the exit status of the last command executed. .PP -The control operators -.B && -and -.B \(bv\(bv -denote AND lists and OR lists, respectively. +AND and OR lists are sequences of one of more pipelines separated by the +\fB&&\fP and \fB\(bv\(bv\fP control operators, respectively. +AND and OR lists are executed with left associativity. An AND list has the form .RS .PP @@ -620,7 +618,8 @@ An OR list has the form .I command2 is executed if and only if .I command1 -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. .SS Compound Commands @@ -6495,6 +6494,19 @@ a \fIname\fP for which no specification exists, or an error occurs adding a completion specification. .RE .TP +\fBcompopt\fP [\fB\-o\fP \fIoption\fP] [\fB+o\fP \fIoption\fP] [\fIname\fP] +Modify completion options for each \fIname\fP according to the +\fIoption\fPs, or for the +currently-execution 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 +builtin described above. +.PP +The return value is true unless an invalid option is supplied, an attempt +is made to modify the options for a \fIname\fP for which no completion +specification exists, or an output error occurs. +.TP \fBcontinue\fP [\fIn\fP] Resume the next iteration of the enclosing .BR for , @@ -6528,7 +6540,15 @@ option will display the attributes and values of each .IR name . When .B \-p -is used, additional options are ignored. +is used with \fIname\fP arguments, additional options are ignored. +When +.B \-p +is supplied without \fIname\fP 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 \fB\-p\fP, \fBdeclare\fP will display +the attributes and values of all shell variables. The \fB\-f\fP option +will restrict the display to shell functions. The .B \-F option inhibits the display of function definitions; only the @@ -8609,7 +8629,7 @@ option suppresses shell function lookup, as with the \fBcommand\fP builtin. returns true if any of the arguments are found, false if none are found. .TP -\fBulimit\fP [\fB\-SHacdefilmnpqrstuvx\fP [\fIlimit\fP]] +\fBulimit\fP [\fB\-HSTabcdefilmnpqrstuvx\fP [\fIlimit\fP]] Provides control over the resources available to the shell and to processes started by it, on systems that allow such control. The \fB\-H\fP and \fB\-S\fP options specify that the hard or soft limit is @@ -8640,6 +8660,9 @@ Other options are interpreted as follows: .B \-a All current limits are reported .TP +.B \-b +The maximum socket buffer size +.TP .B \-c The maximum size of core files created .TP @@ -8688,6 +8711,9 @@ The maximum amount of virtual memory available to the shell .TP .B \-x The maximum number of file locks +.TP +.B \-T +The maximum number of threads .PD .PP If @@ -8703,7 +8729,9 @@ which is in seconds, .BR \-p , which is in units of 512-byte blocks, and -.B \-n +.BR \-T , +.BR \-b , +.BR \-n , and .BR \-u , which are unscaled values. diff --git a/doc/bash.1~ b/doc/bash.1~ index c7349b04..c6df3dee 100644 --- a/doc/bash.1~ +++ b/doc/bash.1~ @@ -5,12 +5,12 @@ .\" Case Western Reserve University .\" chet@po.cwru.edu .\" -.\" Last Change: Wed Dec 5 22:08:48 EST 2007 +.\" Last Change: Thu Mar 27 22:15:12 EDT 2008 .\" .\" bash_builtins, strip all but Built-Ins section .if \n(zZ=1 .ig zZ .if \n(zY=1 .ig zY -.TH BASH 1 "2007 December 5" "GNU Bash-3.2" +.TH BASH 1 "2008 March 27" "GNU Bash-3.2" .\" .\" There's some problem with having a `@' .\" in a tagged paragraph with the BSD man macros. @@ -50,8 +50,8 @@ bash \- GNU Bourne-Again SHell [options] [file] .SH COPYRIGHT -.if n Bash is Copyright (C) 1989-2007 by the Free Software Foundation, Inc. -.if t Bash is Copyright \(co 1989-2007 by the Free Software Foundation, Inc. +.if n Bash is Copyright (C) 1989-2008 by the Free Software Foundation, Inc. +.if t Bash is Copyright \(co 1989-2008 by the Free Software Foundation, Inc. .SH DESCRIPTION .B Bash is an \fBsh\fR-compatible command language interpreter that @@ -594,11 +594,9 @@ are executed sequentially; the shell waits for each command to terminate in turn. The return status is the exit status of the last command executed. .PP -The control operators -.B && -and -.B \(bv\(bv -denote AND lists and OR lists, respectively. +AND and OR lists are sequences of one of more pipelines separated by the +\fB&&\fP and \fB\(bv\(bv\fP control operators, respectively. +AND and OR lists are executed with left associativity. An AND list has the form .RS .PP @@ -620,7 +618,8 @@ An OR list has the form .I command2 is executed if and only if .I command1 -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. .SS Compound Commands @@ -1188,7 +1187,7 @@ expand to nothing (i.e., they are removed). Expands to the number of positional parameters in decimal. .TP .B ? -Expands to the status of the most recently executed foreground +Expands to the exit status of the most recently executed foreground pipeline. .TP .B \- @@ -1249,13 +1248,13 @@ Expands to the full file name used to invoke this instance of .BR bash . .TP .B BASHPID -Expands to the process id of the current bash process. +Expands to the process id of the current \fBbash\fP process. This differs from \fB$$\fP under certain circumstances, such as subshells -that do not require bash to be re-initialized. +that do not require \fBbash\fP to be re-initialized. .TP .B BASH_ARGC An array variable whose values are the number of parameters in each -frame of the current bash execution call stack. +frame of the current \fBbash\fP execution call stack. The number of parameters to the current subroutine (shell function or script executed with \fB.\fP or \fBsource\fP) is at the top of the stack. @@ -1269,7 +1268,7 @@ option to the builtin below) .TP .B BASH_ARGV -An array variable containing all of the parameters in the current bash +An array variable containing all of the parameters in the current \fBbash\fP 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 @@ -6495,6 +6494,19 @@ a \fIname\fP for which no specification exists, or an error occurs adding a completion specification. .RE .TP +\fBcompopt\fP [\fB\-o\fP \fIoption\fP] [\fB+o\fP \fIoption\fP] [\fIname\fP] +Modify completion options for each \fIname\fP according to the +\fIoption\fPs, or for the +currently-execution 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 +builtin described above. +.PP +The return value is true unless an invalid option is supplied, an attempt +is made to modify the options for a \fIname\fP for which no completion +specification exists, or an output error occurs. +.TP \fBcontinue\fP [\fIn\fP] Resume the next iteration of the enclosing .BR for , @@ -6528,7 +6540,15 @@ option will display the attributes and values of each .IR name . When .B \-p -is used, additional options are ignored. +is used with \fIname\fP arguments, additional options are ignored. +When +.B \-p +is supplied without \fIname\fP 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 \fB\-p\fP, \fBdeclare\fP will display +the attributes and values of all shell variables. The \fB\-f\fP option +will restrict the display to shell functions. The .B \-F option inhibits the display of function definitions; only the @@ -8068,7 +8088,7 @@ table exists before trying to execute it. If a hashed command no longer exists, a normal path search is performed. .TP 8 .B checkjobs -If set, bash lists the status of any stopped and running jobs before +If set, \fBbash\fP 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 \fBJOB CONTROL\fP above). The shell always @@ -8090,6 +8110,12 @@ attempts to save all lines of a multiple-line command in the same history entry. This allows easy re-editing of multi-line commands. .TP 8 +.B compat31 +If set, +.B bash +changes its behavior to that of version 3.1 with respect to quoted +arguments to the conditional command's =~ operator. +.TP 8 .B dotglob If set, .B bash @@ -8603,7 +8629,7 @@ option suppresses shell function lookup, as with the \fBcommand\fP builtin. returns true if any of the arguments are found, false if none are found. .TP -\fBulimit\fP [\fB\-SHacdefilmnpqrstuvx\fP [\fIlimit\fP]] +\fBulimit\fP [\fB\-HSTabcdefilmnpqrstuvx\fP [\fIlimit\fP]] Provides control over the resources available to the shell and to processes started by it, on systems that allow such control. The \fB\-H\fP and \fB\-S\fP options specify that the hard or soft limit is @@ -8634,6 +8660,9 @@ Other options are interpreted as follows: .B \-a All current limits are reported .TP +.B \-b +The maximum socket buffer size +.TP .B \-c The maximum size of core files created .TP @@ -8682,6 +8711,9 @@ The maximum amount of virtual memory available to the shell .TP .B \-x The maximum number of file locks +.TP +.B \-T +The maximum number of threads .PD .PP If @@ -8697,7 +8729,9 @@ which is in seconds, .BR \-p , which is in units of 512-byte blocks, and -.B \-n +.BR \-T , +.BR \-b , +.BR \-n , and .BR \-u , which are unscaled values. diff --git a/doc/bashref.texi b/doc/bashref.texi index 9b4e0194..a7571020 100644 --- a/doc/bashref.texi +++ b/doc/bashref.texi @@ -681,8 +681,11 @@ Commands separated by a @samp{;} are executed sequentially; the shell waits for each command to terminate in turn. The return status is the exit status of the last command executed. -The control operators @samp{&&} and @samp{||} -denote @sc{and} lists and @sc{or} lists, respectively. +@sc{and} and @sc{or} lists are sequences of one or more pipelines +separated by the control operators @samp{&&} and @samp{||}, +respectively. @sc{and} and @sc{or} lists are executed with left +associativity. + An @sc{and} list has the form @example @var{command1} && @var{command2} @@ -3262,7 +3265,16 @@ are given, then display the values of variables instead. The @option{-p} option will display the attributes and values of each @var{name}. -When @option{-p} is used, additional options are ignored. +When @option{-p} is used with @var{name} arguments, additional options +are ignored. + +When @option{-p} is supplied without @var{name} arguments, @code{declare} +will display the attributes and values of all variables having the +attributes specified by the additional options. +If no other options are supplied with @option{-p}, @code{declare} will +display the attributes and values of all shell variables. The @option{-f} +option will restrict the display to shell functions. + The @option{-F} option inhibits the display of function definitions; only the function name and attributes are printed. If the @code{extdebug} shell option is enabled using @code{shopt} @@ -3596,7 +3608,7 @@ builtin command. @item ulimit @btindex ulimit @example -ulimit [-acdefilmnpqrstuvxSH] [@var{limit}] +ulimit [-abcdefilmnpqrstuvxHST] [@var{limit}] @end example @code{ulimit} provides control over the resources available to processes started by the shell, on systems that allow such control. If an @@ -3611,6 +3623,9 @@ Change and report the hard limit associated with a resource. @item -a All current limits are reported. +@item -b +The maximum socket buffer size. + @item -c The maximum size of core files created. @@ -3659,6 +3674,9 @@ The maximum amount of virtual memory available to the process. @item -x The maximum number of file locks. +@item -T +The maximum number of threads. + @end table If @var{limit} is given, it is the new value of the specified resource; @@ -7049,8 +7067,9 @@ the @code{bind} builtin. @item Bash provides a programmable word completion mechanism -(@pxref{Programmable Completion}), and two builtin commands, -@code{complete} and @code{compgen}, to manipulate it. +(@pxref{Programmable Completion}), and builtin commands +@code{complete}, @code{compgen}, and @code{compopt}, to +manipulate it. @item Bash has command history (@pxref{Bash History Facilities}) and the diff --git a/doc/bashref.texi~ b/doc/bashref.texi~ index a95a33b1..e58e6706 100644 --- a/doc/bashref.texi~ +++ b/doc/bashref.texi~ @@ -681,8 +681,11 @@ Commands separated by a @samp{;} are executed sequentially; the shell waits for each command to terminate in turn. The return status is the exit status of the last command executed. -The control operators @samp{&&} and @samp{||} -denote @sc{and} lists and @sc{or} lists, respectively. +@sc{and} and @sc{or} lists are sequences of one or more pipelines +separated by the control operators @samp{&&} and @samp{||}, +respectively. @sc{and} and @sc{or} lists are executed with left +associativity. + An @sc{and} list has the form @example @var{command1} && @var{command2} @@ -3262,7 +3265,16 @@ are given, then display the values of variables instead. The @option{-p} option will display the attributes and values of each @var{name}. -When @option{-p} is used, additional options are ignored. +When @option{-p} is used with @var{name} arguments, additional options +are ignored. + +When @option{-p} is supplied without @var{name} arguments, @code{declare} +will display the attributes and values of all variables having the +attributes specified by the additional options. +If no other options are supplied with @option{-p}, @code{declare} will +display the attributes and values of all shell variables. The @option{-f} +option will restrict the display to shell functions. + The @option{-F} option inhibits the display of function definitions; only the function name and attributes are printed. If the @code{extdebug} shell option is enabled using @code{shopt} @@ -3596,7 +3608,7 @@ builtin command. @item ulimit @btindex ulimit @example -ulimit [-acdefilmnpqrstuvxSH] [@var{limit}] +ulimit [-abcdefilmnpqrstuvxHST] [@var{limit}] @end example @code{ulimit} provides control over the resources available to processes started by the shell, on systems that allow such control. If an @@ -3611,6 +3623,9 @@ Change and report the hard limit associated with a resource. @item -a All current limits are reported. +@item -b +The maximum socket buffer size. + @item -c The maximum size of core files created. @@ -3659,6 +3674,9 @@ The maximum amount of virtual memory available to the process. @item -x The maximum number of file locks. +@item -T +The maximum number of threads. + @end table If @var{limit} is given, it is the new value of the specified resource; @@ -4060,6 +4078,11 @@ attempts to save all lines of a multiple-line command in the same history entry. This allows easy re-editing of multi-line commands. +@item compat31 +If set, Bash +changes its behavior to that of version 3.1 with respect to quoted +arguments to the conditional command's =~ operator. + @item dotglob If set, Bash includes filenames beginning with a `.' in the results of filename expansion. diff --git a/doc/version.texi b/doc/version.texi index 2a7c6985..02791e7e 100644 --- a/doc/version.texi +++ b/doc/version.texi @@ -2,9 +2,9 @@ Copyright (C) 1988-2008 Free Software Foundation, Inc. @end ignore -@set LASTCHANGE Fri Feb 22 21:45:01 EST 2008 +@set LASTCHANGE Thu Mar 27 22:19:20 EDT 2008 @set EDITION 3.2 @set VERSION 3.2 -@set UPDATED 22 February 2008 -@set UPDATED-MONTH February 2008 +@set UPDATED 27 March 2008 +@set UPDATED-MONTH March 2008 diff --git a/doc/version.texi~ b/doc/version.texi~ index f8155d4a..f1722f78 100644 --- a/doc/version.texi~ +++ b/doc/version.texi~ @@ -1,10 +1,10 @@ @ignore -Copyright (C) 1988-2007 Free Software Foundation, Inc. +Copyright (C) 1988-2008 Free Software Foundation, Inc. @end ignore -@set LASTCHANGE Fri Dec 14 23:10:36 EST 2007 +@set LASTCHANGE Fri Feb 22 21:45:01 EST 2008 @set EDITION 3.2 @set VERSION 3.2 -@set UPDATED 14 December 2007 -@set UPDATED-MONTH December 2007 +@set UPDATED 27 March 2008 +@set UPDATED-MONTH March 2008 |