Doc updates, add spell check for man page.

10 files changed, 418 insertions, 108 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index f8c5f300..647f2a64 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,10 +1,21 @@
+2019-02-03         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* Makefile.am (EXTRA_DIST): Add wordlist3.
+	(spellmanpage): New target.
+	(spell): Add spellmanpage to the list.
+	* wordlist1: Updated.
+	* wordlist3: New file.
+	* awkcard.in: Finish cleanups.
+	* gawk.1: Ditto.
+	* gawktexi.in: Fix small typo.
+
 2019-02-01         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* awkcard.in: Start on cleanup edits.
 	* gawk.1: Ditto.
 	* gawktexi.in: Credit Nelson Beebe with gawk's current
 	random number generator.
-	* (gawk.texi, gawk.info): Brought back into sync.
+	* gawk.texi, gawk.info: Brought back into sync.
 
 2019-01-28         Arnold D. Robbins     <arnold@skeeve.com>
 
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 0b9316bc..1e5d86ac 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -48,7 +48,7 @@ EXTRA_DIST = ChangeLog ChangeLog.0 README.card ad.block setter.outline \
 	lflashlight-small.xpic lflashlight.eps lflashlight.pdf \
 	rflashlight-small.xpic rflashlight.eps rflashlight.pdf \
 	statist.jpg statist.eps statist.pdf \
-	wordlist wordlist2 \
+	wordlist wordlist2 wordlist3 \
 	bc_notes
 
 # Get rid of generated files when cleaning
@@ -109,7 +109,7 @@ awkcard.nc: $(CARDFILES)
 awkcard.pdf: awkcard.ps
 	ps2pdf awkcard.ps awkcard.pdf
 
-spell: spellmanual spellworkflow
+spell: spellmanual spellworkflow spellmanpage
 
 spellmanual:
 	@echo ==== gawktexi.in ====;
@@ -120,3 +120,8 @@ spellworkflow:
 	@echo ==== gawkworkflow.texi ====
 	export LC_ALL=C ; spell "$(srcdir)"/gawkworkflow.texi | \
 	sort -u | comm -23 - "$(srcdir)"/wordlist2
+
+spellmanpage:
+	@echo ==== gawk.1 ====
+	export LC_ALL=C ; spell "$(srcdir)"/gawk.1 | \
+	sort -u | comm -23 - "$(srcdir)"/wordlist3
diff --git a/doc/Makefile.in b/doc/Makefile.in
index 2d028bf3..2c4c6d2e 100644
--- a/doc/Makefile.in
+++ b/doc/Makefile.in
@@ -376,7 +376,7 @@ EXTRA_DIST = ChangeLog ChangeLog.0 README.card ad.block setter.outline \
 	lflashlight-small.xpic lflashlight.eps lflashlight.pdf \
 	rflashlight-small.xpic rflashlight.eps rflashlight.pdf \
 	statist.jpg statist.eps statist.pdf \
-	wordlist wordlist2 \
+	wordlist wordlist2 wordlist3 \
 	bc_notes
 
 
@@ -926,7 +926,7 @@ awkcard.nc: $(CARDFILES)
 awkcard.pdf: awkcard.ps
 	ps2pdf awkcard.ps awkcard.pdf
 
-spell: spellmanual spellworkflow
+spell: spellmanual spellworkflow spellmanpage
 
 spellmanual:
 	@echo ==== gawktexi.in ====;
@@ -938,6 +938,11 @@ spellworkflow:
 	export LC_ALL=C ; spell "$(srcdir)"/gawkworkflow.texi | \
 	sort -u | comm -23 - "$(srcdir)"/wordlist2
 
+spellmanpage:
+	@echo ==== gawk.1 ====
+	export LC_ALL=C ; spell "$(srcdir)"/gawk.1 | \
+	sort -u | comm -23 - "$(srcdir)"/wordlist3
+
 # Tell versions [3.59,3.63) of GNU make to not export all variables.
 # Otherwise a system limit (for SysV at least) may be exceeded.
 .NOEXPORT:
diff --git a/doc/awkcard.in b/doc/awkcard.in
index 9638c444..14e69fac 100644
--- a/doc/awkcard.in
+++ b/doc/awkcard.in
@@ -1158,14 +1158,14 @@ lp8 lp8 lp8 lp8.
 .ES
 .fi
 \*(CDThe environment variable \*(FCAWKPATH\fP specifies a search path to use
-when finding source files named with the \*(FC\-f\fP
-option.
+when finding source files named with the \*(FC\-f\fP and \*(FC\-i\fP
+options.
 The default path is
 \*(FC".:/usr/local/share/awk"\*(FR.
 .\" if this variable does not exist.
 .\" (The actual directory may vary,
 .\" depending upon how \*(GK was built and installed.)
-If a file name given to the \*(FC\-f\fP option contains a ``/'' character,
+If a source file name contains a ``/'' character,
 no path search is performed.
 .sp .5
 The variable \*(FCAWKLIBPATH\fP
@@ -1304,7 +1304,7 @@ The left identifier is the namespace and the right one
 is the variable within it.
 All non-qualified names are treated as if in the
 ``current'' namespace; the default namespace is \*(FCawk\fP.
-However, simple identifiers consisting solely of upper-case
+However, simple identifiers consisting solely of uppercase
 letters are forced into the
 \*(FCawk\fP
 namespace.
@@ -1390,7 +1390,7 @@ If no \*(FIfile\fP, or if
 .ti -.2i
 \*(FCprint\fP
 .br
-Print the current record. Terminate output record
+Print \*(FC$0\*(FR. Terminate the output record
 with \*(FCORS\fP.
 .ti -.2i
 \*(FCprint \*(FIexpr-list\*(FR
@@ -1467,25 +1467,25 @@ the error.\*(CX
 accept the following conversion specification formats:
 .sp .5
 .nf
-\*(CB\*(FC%a\fP, \*(FC%A\fP	A C99 floating point hexadecimal number\*(CD
-\*(FC%c\fP		An \s-1ASCII\s+1 character
-\*(FC%d\fP, \*(FC%i\fP	A decimal number (the integer part)
+\*(CB\*(FC%a\fP, \*(FC%A\fP	A C99 floating point hexadecimal number.\*(CD
+\*(FC%c\fP		An \s-1ASCII\s+1 character.
+\*(FC%d\fP, \*(FC%i\fP	A decimal number (the integer part).
 \*(FC%e\fP		A floating point number of the form
-		\*(FC[\-]d.dddddde[+\^\-]dd\*(FR
-\*(FC%E\fP		Like \*(FC%e\fP, but use \*(FCE\fP instead of \*(FCe\*(FR
+		\*(FC[\-]d.dddddde[+\^\-]dd\*(FR.
+\*(FC%E\fP		Like \*(FC%e\fP, but use \*(FCE\fP instead of \*(FCe\*(FR.
 \*(FC%f\fP		A floating point number of the form
-		\*(FC[\-]ddd.dddddd\*(FR
+		\*(FC[\-]ddd.dddddd\*(FR.
 \*(FC%F\fP		Like \*(FC%f\fP, but use capital letters for infinity and
 		not-a-number values.
 \*(FC%g\fP		Use \*(FC%e\fP or \*(FC%f\fP, whichever is shorter, with
-		nonsignificant zeros suppressed
-\*(FC%G\fP		Like \*(FC%g\fP, but use \*(FC%E\fP instead of \*(FC%e\*(FR
-\*(FC%o\fP		An unsigned octal integer
-\*(FC%u\fP		An unsigned decimal integer
-\*(FC%s\fP		A character string
-\*(FC%x\fP		An unsigned hexadecimal integer
-\*(FC%X\fP		Like \*(FC%x\fP, but use \*(FCABCDEF\fP for 10\(en15
-\*(FC%%\fP		A literal \*(FC%\fP; no argument is converted
+		nonsignificant zeros suppressed.
+\*(FC%G\fP		Like \*(FC%g\fP, but use \*(FC%E\fP instead of \*(FC%e\*(FR.
+\*(FC%o\fP		An unsigned octal integer.
+\*(FC%u\fP		An unsigned decimal integer.
+\*(FC%s\fP		A character string.
+\*(FC%x\fP		An unsigned hexadecimal integer.
+\*(FC%X\fP		Like \*(FC%x\fP, but use \*(FCABCDEF\fP for 10\(en15.
+\*(FC%%\fP		A literal \*(FC%\fP; no argument is converted.
 .sp .5
 .fi
 Optional, additional parameters may lie between the \*(FC%\fP
@@ -1654,7 +1654,7 @@ expand;
 l lw(1.9i).
 \*(CD\*(FCatan2(\*(FIy\*(FC, \*(FIx\*(FC)\*(FR	The arctangent of \*(FIy/x\fP in radians.
 \*(FCcos(\*(FIexpr\*(FC)\*(FR	The cosine of \*(FIexpr\fP, which is in radians.
-\*(FCexp(\*(FIexpr\*(FC)\*(FR	The exponential function (\*(FIe \*(FC^ \*(FIx\*(FR).
+\*(FCexp(\*(FIexpr\*(FC)\*(FR	The exponential function (\*(FIe\|\*(FC^\|\*(FIx\*(FR).
 \*(FCint(\*(FIexpr\*(FC)\*(FR	Truncate to integer.
 .\" \*(CB\*(FCintdiv(\*(FIn\*(FR\*(FC,\*(FI d\*(FR\*(FC,\*(FI r\*(FR\*(FC)\*(FR	T{
 .\" Return result of integer division in \*(FIr\*(FR.\*(CD
@@ -1745,9 +1745,9 @@ is placed in \*(FIa\*(FC[0]\*(FR.  If there were parenthesized
 subexpressions, the matching texts are placed
 in \*(FIa\*(FC[1]\*(FR, \*(FIa\*(FC[2]\*(FR, and so on.
 Subscripts
-\*(FCa[\*(FIn\^\*(FC, "start"]\*(FR,
+\*(FIa\*(FC[\*(FIn\^\*(FC, "start"]\*(FR,
 and
-\*(FCa[\*(FIn\^\*(FC, "length"]\*(FR
+\*(FIa\*(FC[\*(FIn\^\*(FC, "length"]\*(FR
 provide the starting index in the string and length,
 respectively, of each matching substring.\*(CD
 .ti -.2i
@@ -1759,8 +1759,8 @@ and the array \*(FIseps\fP of separator strings
 using the regular expression \*(FIr\*(FR,
 and return the number of fields.
 Element values are the portions of \*(FIs\fP that matched \*(FIr\fP.
-The value of \*(FIseps\fP[\*(FIi\fP] is the separator that appeared in
-front of \*(FIa\fP[\*(FIi\fP+1].
+The value of \*(FIseps\*(FC[\*(FIi\^\fP]\*(FR is the separator that appeared in
+front of \*(FIa\*(FC[\*(FIi\fP+1]\*(FR.
 If \*(FIr\fP is omitted, use \*(FCFPAT\fP instead.
 Clear the arrays \*(FIa\fP and \*(FIseps\fP first.
 Splitting behaves identically to field splitting with \*(FCFPAT\fP.\*(CD
@@ -1798,7 +1798,7 @@ treat it as an octal number.
 If \*(FIs\*(FR begins with a leading \*(FC0x\*(FR
 or \*(FC0X\*(FR, treat
 \*(FIs\*(FR as a hexadecimal number. Otherwise,
-treat the number as decimal.\*(CD
+treat \*(FIs\*(FR as decimal.\*(CD
 .ti -.2i
 \*(FCsub(\*(FIr\*(FC, \*(FIs \*(FR[\*(FC, \*(FIt\*(FR]\*(FC)\*(FR
 .br
diff --git a/doc/gawk.1 b/doc/gawk.1
index 1349a488..550976f4 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -13,7 +13,7 @@
 .		if \w'\(rq' .ds rq "\(rq
 .	\}
 .\}
-.TH GAWK 1 "Jan 27 2019" "Free Software Foundation" "Utility Commands"
+.TH GAWK 1 "Feb 03 2019" "Free Software Foundation" "Utility Commands"
 .SH NAME
 gawk \- pattern scanning and processing language
 .SH SYNOPSIS
@@ -51,7 +51,7 @@ The command line consists of options to
 itself, the \*(AK program text (if not supplied via the
 .B \-f
 or
-.B \-i
+.B \-\^\-include
 options), and values to be made
 available in the
 .B ARGC
@@ -85,7 +85,9 @@ AWK source code and then prompts for debugging commands.
 .I Gawk
 can only debug AWK program source provided with the
 .B \-f
-option.
+and
+.B \-\^\-include
+options.
 The debugger is documented in \*(EP.
 .SH OPTION FORMAT
 .PP
@@ -134,7 +136,7 @@ Multiple
 options may be used.
 Files read with
 .B \-f
-are treated as if they begin with an implict \fB@namespace "awk"\fR statement.
+are treated as if they begin with an implicit \fB@namespace "awk"\fR statement.
 .TP
 .PD 0
 .BI \-F " fs"
@@ -252,13 +254,13 @@ as \*(AK program source code.
 This option allows the easy intermixing of library functions (used via the
 .B \-f
 and
-.B \-i
+.B \-\^\-include
 options) with source code entered on the command line.
 It is intended primarily for medium to large \*(AK programs used
 in shell scripts.
 Each argument supplied via
 .B \-e
-is treated as if it begins with an implict \fB@namespace "awk"\fR statement.
+is treated as if it begins with an implicit \fB@namespace "awk"\fR statement.
 .TP
 .PD 0
 .BI "\-E " file
@@ -317,8 +319,8 @@ suffix.  The file will be loaded only
 once (i.e., duplicates are eliminated), and the code does not constitute
 the main program source.
 Files read with
-.B \-i
-are treated as if they begin with an implict \fB@namespace "awk"\fR statement.
+.B \-\^\-include
+are treated as if they begin with an implicit \fB@namespace "awk"\fR statement.
 .TP
 .PD 0
 .BI "\-l " lib
@@ -361,7 +363,7 @@ actually invalid are issued. (This is not fully implemented yet.)
 Force arbitrary precision arithmetic on numbers. This option has
 no effect if
 .I gawk
-is not compiled to use the GNU MPFR and MP libraries.
+is not compiled to use the GNU MPFR and GMP libraries.
 (In such a case,
 .I gawk
 issues a warning.)
@@ -419,7 +421,7 @@ is provided,
 uses a file named
 .B awkprof.out
 in the current directory.
-Implies
+This option implies
 .BR \-\^\-no\-optimize .
 .TP
 .PD 0
@@ -444,7 +446,7 @@ The default is
 .BR awkprof.out .
 The profile contains execution counts of each statement in the program
 in the left margin and function call counts for each user-defined function.
-Implies
+This option implies
 .BR \-\^\-no\-optimize .
 .TP
 .PD 0
@@ -502,7 +504,7 @@ Interval expressions were not traditionally available in the
 and
 .I egrep
 consistent with each other.
-They are enabled by default, but this option remains for use with
+They are enabled by default, but this option remains for use together with
 .BR \-\^\-traditional .
 .TP
 .PD 0
@@ -623,14 +625,14 @@ In addition, lines beginning with
 may be used to include other source files into your program,
 making library use even easier.  This is equivalent
 to using the
-.B \-i
+.B \-\^\-include
 option.
 .PP
 Lines beginning with
 .B @load
 may be used to load extension functions into your program.  This is equivalent
 to using the
-.B \-l
+.B \-\^\-load
 option.
 .PP
 The environment variable
@@ -639,7 +641,7 @@ specifies a search path to use when finding source files named with
 the
 .B \-f
 and
-.B \-i
+.B \-\^\-include
 options.  If this variable does not exist, the default path is
 \fB".:/usr/local/share/awk"\fR.
 (The actual directory may vary, depending upon how
@@ -653,7 +655,7 @@ The environment variable
 .B AWKLIBPATH
 specifies a search path to use when finding source files named with
 the
-.B \-l
+.B \-\^\-load
 option.  If this variable does not exist, the default path is
 \fB"/usr/local/lib/gawk"\fR.
 (The actual directory may vary, depending upon how
@@ -862,7 +864,8 @@ Each field in the input record may be referenced by its position:
 .BR $2 ,
 and so on.
 .B $0
-is the whole record.
+is the whole record,
+including leading and trailing whitespace.
 Fields need not be referenced by constants:
 .RS
 .PP
@@ -881,7 +884,7 @@ is set to the total number of fields in the input record.
 .PP
 References to non-existent fields (i.e., fields after
 .BR $NF )
-produce the null-string.  However, assigning to a non-existent field
+produce the null string.  However, assigning to a non-existent field
 (e.g.,
 .BR "$(NF+2) = 5" )
 increases the value of
@@ -1020,9 +1023,9 @@ When set,
 .I gawk
 parses the input into fields, where the fields match the
 regular expression, instead of using the
-value of the
+value of
 .B FS
-variable as the field separator.
+as the field separator.
 See
 .BR Fields ,
 above.
@@ -1199,7 +1202,7 @@ The identifier is a built-in function.
 The identifier is an extension function loaded via
 .B @load
 or
-.BR \-l .
+.BR \-\^\-load .
 .TP
 \fB"scalar"\fR
 The identifier is a scalar.
@@ -1213,40 +1216,49 @@ doesn't know yet).
 The identifier is a user-defined function.
 .RE
 .TP
+\fBPROCINFO["pgrpid"]\fP
+The value of the
+.IR getpgrp (2)
+system call.
+.TP
+\fBPROCINFO["pid"]\fP
+The value of the
+.IR getpid (2)
+system call.
+.TP
 \fBPROCINFO["platform"]\fP
 A string indicating the platform for which
 .I gawk
 was compiled.  It is one of:
 .RS
 .TP
-\fB"vms"\fR
-OpenVMS or Vax/VMS.
+\fB"cygwin"\fR, \fB"djgpp"\fR, \fB"mingw"\fR
+Microsoft Windows, using either Cygwin, DJGPP, or MinGW, respectively.
 .TP
 \fB"macosx"\fR
 Mac OS X.
 .TP
-\fB"cygwin"\fR, \fB"djgpp"\fR, \fB"mingw"\fR
-Microsoft Windows, using either Cygwin, DJGPP, or MinGW, respectively.
-.TP
 \fB"os2"\fR
 OS/2.
 .TP
 \fB"posix"\fR
 GNU/Linux and legacy Unix systems.
-.RE
-.TP
-\fBPROCINFO["pgrpid"]\fP
-The process group ID of the current process.
 .TP
-\fBPROCINFO["pid"]\fP
-The process ID of the current process.
+\fB"vms"\fR
+OpenVMS or Vax/VMS.
+.RE
 .TP
 \fBPROCINFO["ppid"]\fP
-The parent process ID of the current process.
+The value of the
+.IR getppid (2)
+system call.
 .TP
 \fBPROCINFO["strftime"]\fP
 The default time format string for
 .BR strftime() .
+Changing its value affects how
+.B strftime()
+formats time values when called with no arguments.
 .TP
 \fBPROCINFO["uid"]\fP
 The value of the
@@ -1254,7 +1266,7 @@ The value of the
 system call.
 .TP
 \fBPROCINFO["version"]\fP
-the version of
+The version of
 .IR gawk .
 .PP
 The following elements are present if loading dynamic
@@ -1271,7 +1283,7 @@ compiled into
 .IR gawk\^ :
 .TP
 \fBPROCINFO["gmp_version"]\fP
-The version of the GNU MP library used for arbitrary precision
+The version of the GNU GMP library used for arbitrary precision
 number support in
 .IR gawk .
 .TP
@@ -1328,7 +1340,7 @@ An I/O error that may be retried is one where
 has the value EAGAIN, EWOULDBLOCK, EINTR, or ETIMEDOUT.
 This may be useful in conjunction with
 \fBPROCINFO["\fIinput\^\fB", "READ_TIMEOUT"]\fR
-or situations where a file descriptor has been configured to behave in a
+or in situations where a file descriptor has been configured to behave in a
 non-blocking fashion.
 .TP
 \fBPROCINFO["sorted_in"]\fP
@@ -1377,13 +1389,26 @@ depending on how the elements of the array are to be ordered.
 .B ROUNDMODE
 The rounding mode to use for arbitrary precision arithmetic on
 numbers, by default \fB"N"\fR (IEEE-754 roundTiesToEven mode).
-The accepted values are
-\fB"N"\fR or \fB"n"\fR for roundTiesToEven,
-\fB"U"\fR or \fB"u"\fR for roundTowardPositive,
-\fB"D"\fR or \fB"d"\fR for roundTowardNegative,
-\fB"Z"\fR or \fB"z"\fR for roundTowardZero,
-and if your version of GNU MPFR library supports it,
-\fB"A"\fR or \fB"a"\fR for rounding away from zero.
+The accepted values are:
+.RS
+.TP
+\fB"A"\fR or \fB"a"\fR
+for rounding away from zero.
+This one is only available if your version of
+the GNU MPFR library supports it.
+.TP "\w'\fB\(dqD\(dq\fR or \fB\(dqd\(dq\fR'u+1n"
+\fB"D"\fR or \fB"d"\fR
+for roundTowardNegative.
+.TP
+\fB"N"\fR or \fB"n"\fR
+for roundTiesToEven.
+.TP
+\fB"U"\fR or \fB"u"\fR
+for roundTowardPositive.
+.TP
+\fB"Z"\fR or \fB"z"\fR
+for roundTowardZero.
+.RE
 .TP
 .B RS
 The input record separator, by default a newline.
@@ -1409,7 +1434,7 @@ The length of the string matched by
 \-1 if no match.
 .TP
 .B SUBSEP
-The character used to separate multiple subscripts in array
+The string used to separate multiple subscripts in array
 elements, by default \fB"\e034"\fR.
 .TP
 .B SYMTAB
@@ -1547,7 +1572,7 @@ identifier is the variable within it.
 All simple (non-qualified) names are considered to be in the
 ``current'' namespace; the default namespace is
 .BR awk .
-However, simple identifiers consisting solely of upper-case
+However, simple identifiers consisting solely of uppercase
 letters are forced into the
 .B awk
 namespace, even if the current namespace is different.
@@ -1828,8 +1853,8 @@ patterns cannot have missing action parts.
 .B BEGINFILE
 and
 .B ENDFILE
-are additional special patterns whose bodies are executed
-before reading the first record of each command line input file
+are additional special patterns whose actions are executed
+before reading the first record of each command-line input file
 and after reading the last record of each file.
 Inside the
 .B BEGINFILE
@@ -1909,6 +1934,7 @@ Matches the end of a string.
 A character list: matches any of the characters
 .IR abc.\|.\|. .
 You may include a range of characters by separating them with a dash.
+To include a literal dash in the list, put it first or last.
 .TP
 \fB[^\fIabc.\|.\|.\fB]\fR
 A negated character list: matches any character except
@@ -2308,7 +2334,7 @@ It must be a string value, either
 .B getline
 Set
 .B $0
-from next input record; set
+from the next input record; set
 .BR NF ,
 .BR NR ,
 .BR FNR ,
@@ -2317,7 +2343,7 @@ from next input record; set
 .BI "getline <" file
 Set
 .B $0
-from next record of
+from the next record of
 .IR file ;
 set
 .BR NF ,
@@ -2326,7 +2352,7 @@ set
 .BI getline " var"
 Set
 .I var
-from next input record; set
+from the next input record; set
 .BR NR ,
 .BR FNR ,
 .BR RT .
@@ -2334,14 +2360,14 @@ from next input record; set
 .BI getline " var" " <" file
 Set
 .I var
-from next record of
+from the next record of
 .IR file ;
 set
 .BR RT .
 .TP
 \fIcommand\fB | getline \fR[\fIvar\fR]
 Run
-.I command
+.IR command ,
 piping the output either into
 .B $0
 or
@@ -2362,34 +2388,34 @@ as above, and
 Coprocesses are a
 .I gawk
 extension.
-.RI ( command
+.RI "(The " command
 can also be a socket.  See the subsection
 .BR "Special File Names" ,
 below.)
 .TP
 .B next
-Stop processing the current input record.  The next input record
-is read and processing starts over with the first pattern in the
+Stop processing the current input record.
+Read the next input record
+and start processing over with the first pattern in the
 \*(AK program.
 Upon reaching the end of the input data,
-.I gawk
-executes any
+execute any
 .B END
 rule(s).
 .TP
 .B "nextfile"
 Stop processing the current input file.  The next input record read
 comes from the next input file.
+Update
 .B FILENAME
 and
-.B ARGIND
-are updated,
+.BR ARGIND ,
+reset
 .B FNR
-is reset to 1, and processing starts over with the first pattern in the
+to 1, and start processing over with the first pattern in the
 \*(AK program.
 Upon reaching the end of the input data,
-.I gawk
-executes any
+execute any
 .B ENDFILE
 and
 .B END
@@ -2445,14 +2471,14 @@ and
 .BR printf .
 .TP
 .BI "print .\|.\|. >>" " file"
-Appends output to the
+Append output to the
 .IR file .
 .TP
 .BI "print .\|.\|. |" " command"
-Writes on a pipe.
+Write on a pipe.
 .TP
 .BI "print .\|.\|. |&" " command"
-Sends data to a coprocess or socket.
+Send data to a coprocess or socket.
 (See also the subsection
 .BR "Special File Names" ,
 below.)
@@ -2685,8 +2711,9 @@ of significant digits.  For the
 and
 .B %X
 formats, it specifies the minimum number of
-digits to print.  For
-.BR %s ,
+digits to print.  For the
+.B %s 
+format,
 it specifies the maximum number of
 characters from the string that should be printed.
 .PP
@@ -2796,6 +2823,9 @@ to force an IPv6 connection.
 Plain
 .B /inet
 uses the system default (most likely IPv4).
+Usable only with the
+.B |&
+two-way I/O operator.
 .TP
 .PD 0
 .BI /inet/udp/ lport / rhost / rport
@@ -3355,15 +3385,15 @@ Return the bitwise XOR of the values provided in the argument list.
 There must be at least two.
 .PP
 .SS Type Functions
-The following function is for use with multidimensional arrays.
+The following functions provide type related information about
+their arguments.
 .TP
 \fBisarray(\fIx\fB)\fR
 Return true if
 .I x
 is an array, false otherwise.
-.PP
-You can tell the type of any variable or array element with the
-following function:
+This function is mainly for use with the elements of multidimensional arrays
+and with function parameters.
 .TP
 \fBtypeof(\fIx\fB)\fR
 Return a string indicating the type of
@@ -3676,7 +3706,7 @@ was changed to match its documentation, the
 .B \-v
 option for assigning variables before program execution was added to
 accommodate applications that depended upon the old behavior.
-(This feature was agreed upon by both the Bell Laboratories
+(This feature was agreed upon by both the Bell Laboratories developers
 and the \*(GN developers.)
 .PP
 When processing arguments,
@@ -4008,7 +4038,7 @@ environment variable can be used to provide a list of directories that
 .I gawk
 searches when looking for files named via the
 .BR \-f ,
-.RB \-\^\-file ,
+.BR \-\^\-file ,
 .B \-i
 and
 .B \-\^\-include
@@ -4039,7 +4069,7 @@ For connection to a remote host via socket,
 .B GAWK_SOCK_RETRIES
 controls the number of retries, and
 .B GAWK_MSEC_SLEEP
-and the interval between retries.
+the interval between retries.
 The interval is in milliseconds. On systems that do not support
 .IR usleep (3),
 the value is rounded up to an integral number of seconds.
@@ -4152,7 +4182,11 @@ post a bug report in
 While the
 .I gawk
 developers occasionally read this newsgroup, posting bug reports there
-is an unreliable way to report bugs.  Instead, please use the electronic mail
+is an unreliable way to report bugs.
+Similarly, do
+.B NOT
+use a web forum (such as Stack Overflow) for reporting bugs.
+Instead, please use the electronic mail
 addresses given above.
 Really.
 .PP
diff --git a/doc/gawk.info b/doc/gawk.info
index ba02f4f0..7fa1e6ae 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -7741,7 +7741,7 @@ Other Versions::) elide the backslash and newline, as in C:
    In POSIX mode (*note Options::), 'gawk' does not allow escaped
 newlines.  Otherwise, it behaves as just described.
 
-   Brian Kernighan's 'awk' and Busybox 'awk' remove the backslash but
+   Brian Kernighan's 'awk' and BusyBox 'awk' remove the backslash but
 leave the newline intact, as part of the string:
 
      $ nawk 'BEGIN { print "hello, \
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 6fed73a5..e1140eaa 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -11129,7 +11129,7 @@ $ @kbd{gawk 'BEGIN @{ print "hello, \}
 In POSIX mode (@pxref{Options}), @command{gawk} does not
 allow escaped newlines.  Otherwise, it behaves as just described.
 
-Brian Kernighan's @command{awk} and Busybox @command{awk}
+Brian Kernighan's @command{awk} and BusyBox @command{awk}
 remove the backslash but leave the newline
 intact, as part of the string:
 
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index bd8471b5..b24324ac 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -10614,7 +10614,7 @@ $ @kbd{gawk 'BEGIN @{ print "hello, \}
 In POSIX mode (@pxref{Options}), @command{gawk} does not
 allow escaped newlines.  Otherwise, it behaves as just described.
 
-Brian Kernighan's @command{awk} and Busybox @command{awk}
+Brian Kernighan's @command{awk} and BusyBox @command{awk}
 remove the backslash but leave the newline
 intact, as part of the string:
 
diff --git a/doc/wordlist b/doc/wordlist
index d87a1b1b..a07d666e 100644
--- a/doc/wordlist
+++ b/doc/wordlist
@@ -710,6 +710,7 @@ beginfile
 begpat
 behaviour
 bellcore
+benhoyt
 beslab
 bf
 bfoo
@@ -1115,6 +1116,8 @@ gmplib
 gmx
 gnubin
 gnv
+goawk
+golang
 goldberg
 goodie
 goto
@@ -1604,6 +1607,7 @@ qsort
 quanstro
 quicksort
 quiktrim
+quux
 rab
 radians
 raincloud
@@ -1677,6 +1681,7 @@ sbcglobal
 sbin
 sbuf
 sc
+scanf
 scl
 scm
 scottd
@@ -1688,6 +1693,7 @@ seps
 setchapternewpage
 setenv
 setfilename
+setlinebuf
 settitle
 sf
 shar
@@ -1728,11 +1734,13 @@ sqrt
 srand
 src
 ssize
+stackoverflow
 stackptr
 standalone
 stat
 statdata
 statfunc
+std
 stdbuf
 stddef
 stderr
diff --git a/doc/wordlist3 b/doc/wordlist3
new file mode 100644
index 00000000..62e3e613
--- /dev/null
+++ b/doc/wordlist3
@@ -0,0 +1,247 @@
+AB
+ABCDEF
+API
+ARGC
+ARGIND
+ARGV
+AWK
+AWKLIBPATH
+AWKPATH
+Ab
+Aho
+BEGINFILE
+BEL
+BINMODE
+CGI
+CONVFMT
+Coprocesses
+Cygwin
+DD
+DJGPP
+DST
+EAGAIN
+EINTR
+ENDFILE
+ERRNO
+ESC
+ETIMEDOUT
+EWOULDBLOCK
+FIELDWIDTHS
+FNR
+FPAT
+FS
+FUNCTAB
+Fenlason
+GMP
+HH
+IGNORECASE
+IPv
+ISBN
+LC
+Localizable
+MKS
+MPFR
+MSEC
+MinGW
+NF
+NR
+OFMT
+OFS
+ORS
+OpenVMS
+PREC
+PROCINFO
+RLENGTH
+ROUNDMODE
+RSTART
+RT
+Regexp
+Retryable
+SIGHUP
+SIGUSR
+SS
+SUBSEP
+SYMTAB
+TEXTDOMAIN
+TP
+Trueman
+UTC
+Weinberger
+YYYY
+Za
+aB
+ab
+abc
+abcdef
+alnum
+api
+argv
+arnold
+asc
+asort
+asorti
+atan
+awk
+awkprof
+awkvars
+bignum
+bindtextdomain
+builtin
+ch
+cmd
+cmp
+cntrl
+comp
+compl
+coprocess
+coprocesses
+cos
+cygwin
+datespec
+dcgettext
+dcngettext
+dd
+ddd
+dddddd
+denom
+desc
+dev
+djgpp
+dl
+ds
+eB
+eS
+eW
+ea
+eb
+ec
+ef
+egid
+egrep
+en
+er
+errno
+euid
+ev
+ew
+exp
+expr
+ey
+fclose
+fd
+fflush
+fmt
+foo
+formfeed
+fs
+func
+gen
+gensub
+getegid
+geteuid
+getgid
+getgroups
+getline
+getpgrp
+getpid
+getppid
+gettext
+getuid
+gid
+gmo
+gmp
+gsub
+hhhh
+html
+https
+ind
+inet
+int
+intdiv
+isarray
+lang
+lc
+localizable
+logdir
+lport
+lq
+lshift
+macosx
+metacharacter
+metacharacters
+min
+mingw
+mktime
+monde
+mpfr
+multibyte
+myfunc
+myhome
+myprog
+nextfile
+nlines
+nmap
+nonsignificant
+nonwhitespace
+num
+org
+os
+parsedebug
+patsplit
+pclose
+pgrpid
+pid
+posix
+ppid
+pre
+prec
+printf
+pty
+punct
+rand
+regex
+regexp
+resplit
+rhost
+roundTiesToEven
+roundTowardNegative
+roundTowardPositive
+roundTowardZero
+rport
+rq
+rshift
+rw
+sed
+seps
+sprintf
+srand
+stderr
+stdin
+stdout
+str
+strftime
+strnum
+strtod
+strtonum
+subarray
+substr
+systime
+tcp
+tolower
+toupper
+typeof
+udp
+uid
+uintmax
+usleep
+usr
+utc
+val
+var
+vars
+vms
+wr
+www
+xdigit
+xor
+zero'th