Move to gawk-3.1.3.

1 files changed, 23 insertions, 3 deletions

diff --git a/doc/gawk.1 b/doc/gawk.1
index 40dd3030..8545fd4d 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -14,7 +14,7 @@
 .		if \w'\(rq' .ds rq "\(rq
 .	\}
 .\}
-.TH GAWK 1 "February 3 2003" "Free Software Foundation" "Utility Commands"
+.TH GAWK 1 "June 25 2003" "Free Software Foundation" "Utility Commands"
 .SH NAME
 gawk \- pattern scanning and processing language
 .SH SYNOPSIS
@@ -1678,6 +1678,7 @@ as follows:
 \fBdo \fIstatement \fBwhile (\fIcondition\fB)\fR
 \fBfor (\fIexpr1\fB; \fIexpr2\fB; \fIexpr3\fB) \fIstatement\fR
 \fBfor (\fIvar \fBin\fI array\fB) \fIstatement\fR
+.\" \fBswitch (\fIexpression\fB) { \fBcase [\fIvalue\fB|\fIregex\fB] : \fIstatement \fBdefault: \fIstatement \fB}\fR
 \fBbreak\fR
 \fBcontinue\fR
 \fBdelete \fIarray\^\fB[\^\fIindex\^\fB]\fR
@@ -1928,6 +1929,22 @@ A single
 .B %
 character; no argument is converted.
 .PP
+.BR NOTE :
+When using the integer format-control letters for values that are
+outside the range of a C
+.B long
+integer,
+.I gawk
+switches to the
+.B %g
+format specifier. If
+.B \-\^\-lint
+is provided on the command line
+.I gawk
+warns about this.  Other versions of
+.I awk
+may print invalid values or do something else entirely.
+.PP
 Optional, additional parameters may lie between the
 .B %
 and the control letter:
@@ -2193,7 +2210,10 @@ Truncates to integer.
 The natural logarithm function.
 .TP
 .B rand()
-Returns a random number between 0 and 1.
+Returns a random number
+.IR N ,
+between 0 and 1,
+such that 0 \(<= \fIN\fP < 1.
 .TP
 .BI sin( expr )
 Returns the sine of
@@ -3319,7 +3339,7 @@ and Martin Brown provided the BeOS port.
 .SH VERSION INFORMATION
 This man page documents
 .IR gawk ,
-version 3.1.0.
+version 3.1.3.
 .SH BUG REPORTS
 If you find a bug in
 .IR gawk ,