diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 49 | ||||
| -rw-r--r-- | doc/gawk.texi | 10 | ||||
| -rw-r--r-- | doc/gawktexi.in | 10 |
4 files changed, 41 insertions, 32 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 679e1bea..f4a6f19b 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2015-03-27 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: Minor edits. + 2015-03-24 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Minor fixes from Antonio Colombo and new exercise diff --git a/doc/gawk.info b/doc/gawk.info index 6b107344..d0312ec6 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -5451,11 +5451,12 @@ how `awk' works. encounters the end of the file. If there is some error in getting a record, such as a file that cannot be opened, then `getline' returns -1. In this case, `gawk' sets the variable `ERRNO' to a string -describing the error that occurred. If `ERRNO' indicates that the I/O -operation may be retried, and `PROCINFO["input", "RETRY"]' is set, then --2 will be returned instead of -1, and further calls to `getline' may -be attemped. *Note Retrying Input::, for further information about -this feature. +describing the error that occurred. + + If `ERRNO' indicates that the I/O operation may be retried, and +`PROCINFO["INPUT", "RETRY"]' is set, then `getline' returns -2 instead +of -1, and further calls to `getline' may be attemped. *Note Retrying +Input::, for further information about this feature. In the following examples, COMMAND stands for a string value that represents a shell command. @@ -5999,16 +6000,16 @@ This minor node describes a feature that is specific to `gawk'. `getline' returns -1, and subsequent attempts to read from that file result in an end-of-file indication. However, you may optionally instruct `gawk' to allow I/O to be retried when certain errors are -encountered by setting setting a special element in the `PROCINFO' -array (*note Auto-set::): +encountered by setting a special element in the `PROCINFO' array (*note +Auto-set::): PROCINFO["INPUT_NAME", "RETRY"] = 1 When this element exists, `gawk' checks the value of the system `errno' variable when an I/O error occurs. If `errno' indicates a subsequent I/O attempt may succeed, `getline' instead returns -2 and -further calls to `getline' may succeed. This applies to `errno' values -`EAGAIN', `EWOULDBLOCK', `EINTR', or `ETIMEDOUT'. +further calls to `getline' may succeed. This applies to the `errno' +values `EAGAIN', `EWOULDBLOCK', `EINTR', or `ETIMEDOUT'. This feature is useful in conjunction with `PROCINFO["INPUT_NAME", "READ_TIMEOUT"]' or situations where a file descriptor has been @@ -34981,21 +34982,21 @@ Ref: Splitting By Content-Footnote-1236687 Node: Multiple Line236850 Ref: Multiple Line-Footnote-1242731 Node: Getline242910 -Node: Plain Getline245376 -Node: Getline/Variable248016 -Node: Getline/File249165 -Node: Getline/Variable/File250550 -Ref: Getline/Variable/File-Footnote-1252153 -Node: Getline/Pipe252240 -Node: Getline/Variable/Pipe254918 -Node: Getline/Coprocess256049 -Node: Getline/Variable/Coprocess257313 -Node: Getline Notes258052 -Node: Getline Summary260846 -Ref: table-getline-variants261258 -Node: Read Timeout262087 -Ref: Read Timeout-Footnote-1265990 -Node: Retrying Input266048 +Node: Plain Getline245380 +Node: Getline/Variable248020 +Node: Getline/File249169 +Node: Getline/Variable/File250554 +Ref: Getline/Variable/File-Footnote-1252157 +Node: Getline/Pipe252244 +Node: Getline/Variable/Pipe254922 +Node: Getline/Coprocess256053 +Node: Getline/Variable/Coprocess257317 +Node: Getline Notes258056 +Node: Getline Summary260850 +Ref: table-getline-variants261262 +Node: Read Timeout262091 +Ref: Read Timeout-Footnote-1265994 +Node: Retrying Input266052 Node: Command-line directories267238 Node: Input Summary268145 Node: Input Exercises271530 diff --git a/doc/gawk.texi b/doc/gawk.texi index 0c21d923..e9d987f0 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -8115,9 +8115,11 @@ it encounters the end of the file. If there is some error in getting a record, such as a file that cannot be opened, then @code{getline} returns @minus{}1. In this case, @command{gawk} sets the variable @code{ERRNO} to a string describing the error that occurred. + If @code{ERRNO} indicates that the I/O operation may be -retried, and @code{PROCINFO["input", "RETRY"]} is set, then @minus{}2 -will be returned instead of @minus{}1, and further calls to @code{getline} +retried, and @code{PROCINFO["@var{input}", "RETRY"]} is set, +then @code{getline} returns @minus{}2 +instead of @minus{}1, and further calls to @code{getline} may be attemped. @DBXREF{Retrying Input} for further information about this feature. @@ -8797,7 +8799,7 @@ When @command{gawk} encounters an error while reading input, by default @code{getline} returns @minus{}1, and subsequent attempts to read from that file result in an end-of-file indication. However, you may optionally instruct @command{gawk} to allow I/O to be retried when -certain errors are encountered by setting setting a special element in +certain errors are encountered by setting a special element in the @code{PROCINFO} array (@pxref{Auto-set}): @example @@ -8808,7 +8810,7 @@ When this element exists, @command{gawk} checks the value of the system @code{errno} variable when an I/O error occurs. If @code{errno} indicates a subsequent I/O attempt may succeed, @code{getline} instead returns @minus{}2 and -further calls to @code{getline} may succeed. This applies to @code{errno} +further calls to @code{getline} may succeed. This applies to the @code{errno} values @code{EAGAIN}, @code{EWOULDBLOCK}, @code{EINTR}, or @code{ETIMEDOUT}. This feature is useful in conjunction with diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 7aa427aa..178444a4 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -7715,9 +7715,11 @@ it encounters the end of the file. If there is some error in getting a record, such as a file that cannot be opened, then @code{getline} returns @minus{}1. In this case, @command{gawk} sets the variable @code{ERRNO} to a string describing the error that occurred. + If @code{ERRNO} indicates that the I/O operation may be -retried, and @code{PROCINFO["input", "RETRY"]} is set, then @minus{}2 -will be returned instead of @minus{}1, and further calls to @code{getline} +retried, and @code{PROCINFO["@var{input}", "RETRY"]} is set, +then @code{getline} returns @minus{}2 +instead of @minus{}1, and further calls to @code{getline} may be attemped. @DBXREF{Retrying Input} for further information about this feature. @@ -8397,7 +8399,7 @@ When @command{gawk} encounters an error while reading input, by default @code{getline} returns @minus{}1, and subsequent attempts to read from that file result in an end-of-file indication. However, you may optionally instruct @command{gawk} to allow I/O to be retried when -certain errors are encountered by setting setting a special element in +certain errors are encountered by setting a special element in the @code{PROCINFO} array (@pxref{Auto-set}): @example @@ -8408,7 +8410,7 @@ When this element exists, @command{gawk} checks the value of the system @code{errno} variable when an I/O error occurs. If @code{errno} indicates a subsequent I/O attempt may succeed, @code{getline} instead returns @minus{}2 and -further calls to @code{getline} may succeed. This applies to @code{errno} +further calls to @code{getline} may succeed. This applies to the @code{errno} values @code{EAGAIN}, @code{EWOULDBLOCK}, @code{EINTR}, or @code{ETIMEDOUT}. This feature is useful in conjunction with |