Module Name: src
Committed By: christos
Date: Tue Dec 17 18:35:57 UTC 2019
Modified Files:
src/external/historical/nawk/bin: awk.1
Log Message:
Sync with upstream.
To generate a diff of this commit:
cvs rdiff -u -r1.5 -r1.6 src/external/historical/nawk/bin/awk.1
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/external/historical/nawk/bin/awk.1
diff -u src/external/historical/nawk/bin/awk.1:1.5 src/external/historical/nawk/bin/awk.1:1.6
--- src/external/historical/nawk/bin/awk.1:1.5 Tue May 23 10:11:08 2017
+++ src/external/historical/nawk/bin/awk.1 Tue Dec 17 13:35:57 2019
@@ -1,28 +1,5 @@
-.\" $NetBSD: awk.1,v 1.5 2017/05/23 14:11:08 abhinav Exp $
-.\"
-.\" Copyright (C) Lucent Technologies 1997
-.\" All Rights Reserved
-.\"
-.\" Permission to use, copy, modify, and distribute this software and
-.\" its documentation for any purpose and without fee is hereby
-.\" granted, provided that the above copyright notice appear in all
-.\" copies and that both that the copyright notice and this
-.\" permission notice and warranty disclaimer appear in supporting
-.\" documentation, and that the name Lucent Technologies or any of
-.\" its entities not be used in advertising or publicity pertaining
-.\" to distribution of the software without specific, written prior
-.\" permission.
-.\"
-.\" LUCENT DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
-.\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
-.\" IN NO EVENT SHALL LUCENT OR ANY OF ITS ENTITIES BE LIABLE FOR ANY
-.\" SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER
-.\" IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
-.\" ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
-.\" THIS SOFTWARE.
-.\"
-.Dd May 18, 2017
+.\" $NetBSD: awk.1,v 1.6 2019/12/17 18:35:57 christos Exp $
+.Dd December 19, 2019
.Dt AWK 1
.Os
.Sh NAME
@@ -34,7 +11,7 @@
.Op Fl v Ar var=value
.Op Fl safe
.Op Fl d Ns Op Ar N
-.Op Ar prog | Fl f Ar filename
+.Op Ar prog | Fl f Ar progfile
.Ar
.Nm
.Fl version
@@ -53,7 +30,7 @@ for lines that match any of a set of pat
.Ar prog
or in one or more files
specified as
-.Fl f Ar filename .
+.Fl f Ar progfile .
With each pattern
there can be an associated action that will be performed
when a line of a
@@ -71,6 +48,19 @@ of the form
.Ar var=value
is treated as an assignment, not a filename,
and is executed at the time it would have been opened if it were a filename.
+The option
+.Fl v
+followed by
+.Ar var=value
+is an assignment to be done before
+.Ar prog
+is executed; any number of
+.Fl v
+options may be present.
+The
+.Fl F Ar fs
+option defines the input field separator to be the regular expression
+.Ar fs .
.Pp
The options are as follows:
.Bl -tag -width indent
@@ -223,7 +213,7 @@ Assignment and Operator-Assignment
.Ss Control Statements
The control statements are as follows:
.Pp
-.Bl -hang -offset indent -width indent -compact
+.Bl -tag -width indent
.It Ic if \&( Ar expression Ic \&) Ar statement Bq Ic else Ar statement
.It Ic while \&( Ar expression Ic \&) Ar statement
.It Ic for \&( Ar expression Ic \&; Ar expression Ic \&; \
@@ -232,12 +222,21 @@ Ar expression Ic \&) Ar statement
.It Ic do Ar statement Ic while \&( Ar expression Ic \&)
.It Ic break
.It Ic continue
+.It Ic \&{ Ar [ statement ... ] Ic \&}
+.It Ic Ar expression
+Commonly var = expression
+.It Ic return Bq Ar expression
+.It Ic next
+Skip remaining patterns on this input line
+.It Ic nextfile
+Skip rest of this file, open next, start at top
.It Ic delete Va array Bq Ar expression
+Delete an array element
.It Ic delete Va array
+Delete all elements of an array
.It Ic exit Bq Ar expression
+Exit immediately; status is
.Ar expression
-.It Ic return Bq Ar expression
-.It Ic \&{ Ar [ statement ... ] Ic \&}
.El
.Ss I/O Statements
The input/output statements are as follows:
@@ -280,10 +279,6 @@ each call of
.Ic getline
returns the next line of output from
.Ar expr .
-.It Ic next
-Skip remaining patterns on this input line.
-.It Ic nextfile
-Skip rest of this file, open next, start at top.
.It Ic print Bo Ar expr-list Bc Bq Ic \*[Gt] Ar file
The
.Ic print
@@ -743,3 +738,5 @@ to force it to be treated as a string co
.Pp
The scope rules for variables in functions are a botch;
the syntax is worse.
+.Pp
+Only eight-bit characters sets are handled correctly.
