[src/trunk]: src/external/historical/nawk/bin awk(1): document what assigning...

[uwe <uwe%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/846cf160b0f6
branches:  trunk
changeset: 368313:846cf160b0f6
user:      uwe <uwe%NetBSD.org@localhost>
date:      Tue Jul 05 13:21:38 2022 +0000

description:
awk(1): document what assigning to $0 and $<n> does

diffstat:

 external/historical/nawk/bin/awk.1 |  18 +++++++++++++-----
 1 files changed, 13 insertions(+), 5 deletions(-)

diffs (38 lines):

diff -r 5db66374ab9a -r 846cf160b0f6 external/historical/nawk/bin/awk.1
--- a/external/historical/nawk/bin/awk.1        Tue Jul 05 13:05:20 2022 +0000
+++ b/external/historical/nawk/bin/awk.1        Tue Jul 05 13:21:38 2022 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: awk.1,v 1.14 2022/07/05 13:05:20 uwe Exp $
+.\"    $NetBSD: awk.1,v 1.15 2022/07/05 13:21:38 uwe Exp $
 .\"
 .\" Copyright (C) Lucent Technologies 1997
 .\" All Rights Reserved
@@ -130,16 +130,24 @@
 .Pp
 An input line is normally made up of fields separated by white space,
 or by regular expression
-.Va FS .
+.Va FS
+built-in variable is set to.
+If
+.Va FS
+is null, the input line is split into one field per character.
 The fields are denoted
 .Va $1 ,
 .Va $2 ,
 \&..., while
 .Va $0
 refers to the entire line.
-If
-.Va FS
-is null, the input line is split into one field per character.
+Setting any other field causes the re-evaluation of
+.Li $ Ns Va 0
+Assigning to
+.Li $ Ns Va 0
+shall reset the values of all other fields and the
+.Va NF
+built-in variable.
 .Pp
 A pattern-action statement has the form
 .Lp