diff options
Diffstat (limited to 'doc/gawk.texi')
| -rw-r--r-- | doc/gawk.texi | 45 |
1 files changed, 35 insertions, 10 deletions
diff --git a/doc/gawk.texi b/doc/gawk.texi index d6db2018..f2b455b4 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -1731,6 +1731,16 @@ another key, at the same time. For example, a @kbd{Ctrl-d} is typed by first pressing and holding the @kbd{CONTROL} key, next pressing the @kbd{d} key and finally releasing both keys. +@ifset FOR_PRINT +@quotation NOTE +Notes of interest look like this. +@end quotation + +@quotation CAUTION +Cautionary or warning notes look like this. +@end quotation +@end ifset + @c fakenode --- for prepinfo @unnumberedsubsec Dark Corners @cindex Kernighan, Brian @@ -9022,6 +9032,8 @@ and then to print the multibyte encoding of that character. Similarly, when printing a numeric value, @command{gawk} allows the value to be within the numeric range of values that can be held in a wide character. +If the conversion to multibyte encoding fails, @command{gawk} +uses the low eight bits of the value as the character to print. Other @command{awk} versions generally restrict themselves to printing the first byte of a string or to numeric values within the range of @@ -16619,13 +16631,14 @@ Return the cosine of @var{x}, with @var{x} in radians. @cindex div Perform integer division, similar to the standard C function of the same name. First, truncate @code{numerator} and @code{denominator} -to integers. Clear the @code{result} array, and then set -@code{result["quotient"]} to the result of @samp{numerator / denominator}, -truncated to an integer, and set @code{result["remainder"]} to the result -of @samp{numerator % denominator}, truncated to an integer. -This function is primarily intended for use with arbitrary length -integers; it avoids creating MPFR arbitrary precision floating-point -values (@pxref{Arbitrary Precision Integers}). +towards zero, creating integer values. Clear the @code{result} +array, and then set @code{result["quotient"]} to the result of +@samp{numerator / denominator}, truncated towards zero to an integer, +and set @code{result["remainder"]} to the result of @samp{numerator % +denominator}, truncated towards zero to an integer. This function is +primarily intended for use with arbitrary length integers; it avoids +creating MPFR arbitrary precision floating-point values (@pxref{Arbitrary +Precision Integers}). This function is a @code{gawk} extension. It is not available in compatibility mode (@pxref{Options}). @@ -21325,7 +21338,9 @@ to either update @code{ARGIND} on your own or modify this code as appropriate. The @code{rewind()} function also relies on the @code{nextfile} keyword -(@pxref{Nextfile Statement}). +(@pxref{Nextfile Statement}). Because of this, you should not call it +from an @code{ENDFILE} rule. (This isn't necessary anyway, since as soon +as an @code{ENDFILE} rule finishes @command{gawk} goes to the next file!) @node File Checking @subsection Checking for Readable @value{DDF}s @@ -31871,8 +31886,8 @@ need to test for a @code{NULL} value. @command{gawk} sets @code{*errcode} to zero, so there is no need to set it unless an error occurs. If an error does occur, the function should return @code{EOF} and set -@code{*errcode} to a non-zero value. In that case, if @code{*errcode} -does not equal @minus{}1, @command{gawk} automatically updates +@code{*errcode} to a value greater than zero. In that case, if @code{*errcode} +does not equal zero, @command{gawk} automatically updates the @code{ERRNO} variable based on the value of @code{*errcode}. (In general, setting @samp{*errcode = errno} should do the right thing.) @@ -35377,6 +35392,16 @@ GCC for VAX and Alpha has not been tested for a while. @end itemize +@item +Support for the following obsolete systems was removed from the code +and the documentation for @command{gawk} @value{PVERSION} 4.1: + +@c nested table +@itemize @value{MINUS} +@item +Ultrix +@end itemize + @end itemize @c XXX ADD MORE STUFF HERE |