aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gawk.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/gawk.1')
-rw-r--r--doc/gawk.126
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 ,