From 77b3aacbdfa8786847658c972b7cac45e1988c29 Mon Sep 17 00:00:00 2001 From: Chet Ramey Date: Thu, 3 Jan 2013 10:46:55 -0500 Subject: commit bash-20121214 snapshot --- doc/bash.1 | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) (limited to 'doc/bash.1') diff --git a/doc/bash.1 b/doc/bash.1 index b1f9fff6..c8c1328e 100644 --- a/doc/bash.1 +++ b/doc/bash.1 @@ -5,12 +5,12 @@ .\" Case Western Reserve University .\" chet@po.cwru.edu .\" -.\" Last Change: Sat Nov 24 15:07:12 EST 2012 +.\" Last Change: Sat Dec 15 17:50:05 EST 2012 .\" .\" bash_builtins, strip all but Built-Ins section .if \n(zZ=1 .ig zZ .if \n(zY=1 .ig zY -.TH BASH 1 "2012 November 24" "GNU Bash 4.2" +.TH BASH 1 "2012 December 15" "GNU Bash 4.2" .\" .\" There's some problem with having a `@' .\" in a tagged paragraph with the BSD man macros. @@ -949,6 +949,8 @@ available as the value of the variable \fINAME\fP_PID. The \fBwait\fP builtin command may be used to wait for the coprocess to terminate. .PP +Since the coprocess is created as an asynchronous command, +the \fBcoproc\fP command always returns success. The return status of a coprocess is the exit status of \fIcommand\fP. .SS Shell Function Definitions .PP @@ -8413,10 +8415,13 @@ causes \fBprintf\fP to output the corresponding .TP .B %(\fIdatefmt\fP)T causes \fBprintf\fP to output the date-time string resulting from using -\fIdatefmt\fP as a format string for \fIstrftime\fP(3). The corresponding -\fIargument\fP is an integer representing the number of seconds since the -epoch. Two special argument values may be used: -1 represents the current +\fIdatefmt\fP as a format string for \fIstrftime\fP(3). +The corresponding \fIargument\fP is an integer representing the number of +seconds since the epoch. +Two special argument values may be used: -1 represents the current time, and -2 represents the time the shell was invoked. +If no argument is specified, conversion behaves as if -1 had been given. +This is an exception to the usual \fBprintf\fP behavior. .PD .PP Arguments to non-string format specifiers are treated as C constants, @@ -8584,14 +8589,17 @@ not echoed. .TP .B \-t \fItimeout\fP Cause \fBread\fP to time out and return failure if a complete line of -input is not read within \fItimeout\fP seconds. +input (or a specified number of characters) +is not read within \fItimeout\fP seconds. \fItimeout\fP may be a decimal number with a fractional portion following the decimal point. This option is only effective if \fBread\fP is reading input from a terminal, pipe, or other special file; it has no effect when reading from regular files. +If \fBread\fP times out, \fBread\fP saves any partial input read into +the specified variable \fIname\fP. If \fItimeout\fP is 0, \fBread\fP returns immediately, without trying to -read any data. The exit statis is 0 if input is available on +read any data. The exit status is 0 if input is available on the specified file descriptor, non-zero otherwise. The exit status is greater than 128 if the timeout is exceeded. .TP -- cgit v1.2.1