|author||Warner Losh <imp@FreeBSD.org>||2021-07-20 02:10:22 +0000|
|committer||Warner Losh <imp@FreeBSD.org>||2021-07-20 04:33:26 +0000|
awk: Add more details top the FS variable
The current description of the FS is true, but only part of the truth. Add information about single characters and note that FS="" is undefined by the standard, though the two other awk implenetations (mawk and gawk) also have this interpretation. PR: 226112 Sponsored by: Netflix
1 files changed, 19 insertions, 2 deletions
diff --git a/usr.bin/awk/awk.1 b/usr.bin/awk/awk.1
index 4be4b96cabce..b85efe9d87cd 100644
@@ -131,8 +131,9 @@ and newlines are used as field separators
This is convenient when working with multi-line records.
An input line is normally made up of fields separated by whitespace,
-or by the regular expression
-.Va FS .
+or by the extended regular expression
+as described below.
The fields are denoted
.Va $1 , $2 , ... ,
@@ -141,6 +142,22 @@ refers to the entire line.
is null, the input line is split into one field per character.
+While both gawk and mawk have the same behavior, it is unspecified in the
+is a single space, then leading and trailing blank and newline characters are
+Fields are delimited by one or more blank or newline characters.
+A blank character is a space or a tab.
+is a single character, other than space, fields are delimited by each single
+occurrence of that character.
+variable defaults to a single space.
Normally, any number of blanks separate fields.
In order to set the field separator to a single blank, use the