Merge branch 'gawk-4.1-stable'

4 files changed, 211 insertions, 210 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index dc2c6484..b2257736 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2014-09-30         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in: More fixes after reading through the MS.
+
 2014-09-29         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in: More fixes after reading through the MS.
diff --git a/doc/gawk.info b/doc/gawk.info
index 326c80cf..47cbde92 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -27004,7 +27004,7 @@ This appendix provides instructions for installing `gawk' on the
 various platforms that are supported by the developers.  The primary
 developer supports GNU/Linux (and Unix), whereas the other ports are
 contributed.  *Note Bugs::, for the electronic mail addresses of the
-people who did the respective ports.
+people who maintain the respective ports.
 
 * Menu:
 
@@ -27295,12 +27295,12 @@ Unix-derived systems, GNU/Linux, BSD-based systems, and the Cygwin
 environment for MS-Windows.
 
    After you have extracted the `gawk' distribution, `cd' to
-`gawk-4.1.2'.  Like most GNU software, `gawk' is configured
-automatically for your system by running the `configure' program.  This
-program is a Bourne shell script that is generated automatically using
-GNU Autoconf.  (The Autoconf software is described fully starting with
-*note (Autoconf)Top:: autoconf,Autoconf--Generating Automatic
-Configuration Scripts.)
+`gawk-4.1.2'.  As with most GNU software, you configure `gawk' for your
+system by running the `configure' program.  This program is a Bourne
+shell script that is generated automatically using GNU Autoconf.  (The
+Autoconf software is described fully starting with *note
+(Autoconf)Top:: autoconf,Autoconf--Generating Automatic Configuration
+Scripts.)
 
    To configure `gawk', simply run `configure':
 
@@ -27363,8 +27363,8 @@ command line when compiling `gawk' from scratch, including:
      User-modified::) has no effect on the running `awk' program.
 
      When used with GCC's automatic dead-code-elimination, this option
-     cuts almost 200K bytes off the size of the `gawk' executable on
-     GNU/Linux x86 systems.  Results on other systems and with other
+     cuts almost 23K bytes off the size of the `gawk' executable on
+     GNU/Linux x86_64 systems.  Results on other systems and with other
      compilers are likely to vary.  Using this option may bring you
      some slight performance improvement.
 
@@ -27450,10 +27450,10 @@ File: gawk.info,  Node: PC Installation,  Next: VMS Installation,  Up: Non-Unix
 B.3.1 Installation on PC Operating Systems
 ------------------------------------------
 
-This minor node covers installation and usage of `gawk' on x86 machines
-running MS-DOS, any version of MS-Windows, or OS/2.  In this minor
-node, the term "Windows32" refers to any of Microsoft
-Windows-95/98/ME/NT/2000/XP/Vista/7/8.
+This minor node covers installation and usage of `gawk' on Intel
+architecture machines running MS-DOS, any version of MS-Windows, or
+OS/2.  In this minor node, the term "Windows32" refers to any of
+Microsoft Windows-95/98/ME/NT/2000/XP/Vista/7/8.
 
    The limitations of MS-DOS (and MS-DOS shells under the other
 operating systems) has meant that various "DOS extenders" are often
@@ -27538,7 +27538,7 @@ MS-DOS and Windows32 versions.  A list of targets is printed if the
 `gawk' using the DJGPP tools, enter `make djgpp'.  (The DJGPP tools
 needed for the build may be found at
 `ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/'.)  To build a native
-MS-Windows binary of `gawk', type `make mingw32'.
+MS-Windows binary of `gawk' using the MinGW tools, type `make mingw32'.
 
    The 32 bit EMX version of `gawk' works "out of the box" under OS/2.
 However, it is highly recommended to use GCC 2.95.3 for the compilation.
@@ -27630,8 +27630,8 @@ Networking::).  EMX (OS/2 only) supports at least the `|&' operator.
    The MS-DOS and MS-Windows versions of `gawk' search for program
 files as described in *note AWKPATH Variable::.  However, semicolons
 (rather than colons) separate elements in the `AWKPATH' variable.  If
-`AWKPATH' is not set or is empty, then the default search path for
-MS-Windows and MS-DOS versions is `.;c:/lib/awk;c:/gnu/lib/awk'.
+`AWKPATH' is not set or is empty, then the default search path is
+`.;c:/lib/awk;c:/gnu/lib/awk'.
 
    The search path for OS/2 (32 bit, EMX) is determined by the prefix
 directory (most likely `/usr' or `c:/usr') that has been specified as
@@ -27655,10 +27655,10 @@ programs) silently translate end-of-line `\r\n' to `\n' on input and
 `\n' to `\r\n' on output.  A special `BINMODE' variable (c.e.)  allows
 control over these translations and is interpreted as follows:
 
-   * If `BINMODE' is `"r"', or one, then binary mode is set on read
+   * If `BINMODE' is `"r"' or one, then binary mode is set on read
      (i.e., no translations on reads).
 
-   * If `BINMODE' is `"w"', or two, then binary mode is set on write
+   * If `BINMODE' is `"w"' or two, then binary mode is set on write
      (i.e., no translations on writes).
 
    * If `BINMODE' is `"rw"' or `"wr"' or three, binary mode is set for
@@ -27725,7 +27725,7 @@ same as for a Unix system:
      tar -xvpzf gawk-4.1.2.tar.gz
      cd gawk-4.1.2
      ./configure
-     make
+     make && make check
 
    When compared to GNU/Linux on the same system, the `configure' step
 on Cygwin takes considerably longer.  However, it does finish, and then
@@ -27748,8 +27748,8 @@ translation of `"\r\n"', since it won't.
 
 File: gawk.info,  Node: VMS Installation,  Prev: PC Installation,  Up: Non-Unix Installation
 
-B.3.2 How to Compile and Install `gawk' on Vax/VMS and OpenVMS
---------------------------------------------------------------
+B.3.2 Compiling and Installing `gawk' on Vax/VMS and OpenVMS
+------------------------------------------------------------
 
 This node describes how to compile and install `gawk' under VMS.  The
 older designation "VMS" is used throughout to refer to OpenVMS.
@@ -27940,12 +27940,12 @@ If any other dash-type options (or multiple parameters such as data
 files to process) are present, there is no ambiguity and `--' can be
 omitted.
 
-   The `exit' value is a Unix-style value and is encoded to a VMS exit
+   The `exit' value is a Unix-style value and is encoded into a VMS exit
 status value when the program exits.
 
    The VMS severity bits will be set based on the `exit' value.  A
 failure is indicated by 1 and VMS sets the `ERROR' status.  A fatal
-error is indicated by 2 and VMS will set the `FATAL' status.  All other
+error is indicated by 2 and VMS sets the `FATAL' status.  All other
 values will have the `SUCCESS' status.  The exit value is encoded to
 comply with VMS coding standards and will have the `C_FACILITY_NO' of
 `0x350000' with the constant `0xA000' added to the number shifted over
@@ -27958,9 +27958,9 @@ by 3 bits to make room for the severity codes.
 A C program that uses `exec()' to call `gawk' will get the original
 Unix-style exit value.
 
-   Older versions of `gawk' treated a Unix exit code 0 as 1, a failure
-as 2, a fatal error as 4, and passed all the other numbers through.
-This violated the VMS exit status coding requirements.
+   Older versions of `gawk' for VMS treated a Unix exit code 0 as 1, a
+failure as 2, a fatal error as 4, and passed all the other numbers
+through.  This violated the VMS exit status coding requirements.
 
    VAX/VMS floating point uses unbiased rounding. *Note Round
 Function::.
@@ -27991,8 +27991,8 @@ reorganized to supply individual PCSI packages for each component.  See
    The normal build procedure for `gawk' produces a program that is
 suitable for use with GNV.
 
-   The `vms/gawk_build_steps.txt' in the source documents the procedure
-for building a VMS PCSI kit that is compatible with GNV.
+   The `vms/gawk_build_steps.txt' in the distribution documents the
+procedure for building a VMS PCSI kit that is compatible with GNV.
 
 
 File: gawk.info,  Node: VMS Old Gawk,  Prev: VMS GNV,  Up: VMS Installation
@@ -28021,11 +28021,11 @@ B.4 Reporting Problems and Bugs
 please report it to the developers; we cannot promise to do anything
 but we might well want to fix it.
 
-   Before reporting a bug, make sure you have actually found a real bug.
-Carefully reread the documentation and see if it really says you can do
-what you're trying to do.  If it's not clear whether you should be able
-to do something or not, report that too; it's a bug in the
-documentation!
+   Before reporting a bug, please make sure you have actually found a
+real bug.  Carefully reread the documentation and see if it really says
+you can do what you're trying to do.  If it's not clear whether you
+should be able to do something or not, report that too; it's a bug in
+the documentation!
 
    Before reporting a bug or trying to fix it yourself, try to isolate
 it to the smallest possible `awk' program and input data file that
@@ -28041,17 +28041,17 @@ get this information with the command `gawk --version'.
    Once you have a precise problem, send email to <bug-gawk@gnu.org>.
 
    The `gawk' maintainers subscribe to this address and thus they will
-receive your bug report.  If necessary, the primary maintainer can be
-reached directly at <arnold@skeeve.com>.  The bug reporting address is
-preferred since the email list is archived at the GNU Project.  _All
-email should be in English. This is the only language understood in
-common by all the maintainers._
+receive your bug report.  Although you can send mail to the maintainers
+directly, the bug reporting address is preferred since the email list
+is archived at the GNU Project.  _All email must be in English. This is
+the only language understood in common by all the maintainers._
 
      CAUTION: Do _not_ try to report bugs in `gawk' by posting to the
      Usenet/Internet newsgroup `comp.lang.awk'.  While the `gawk'
      developers do occasionally read this newsgroup, there is no
      guarantee that we will see your posting.  The steps described
-     above are the official recognized ways for reporting bugs.  Really.
+     above are the only official recognized way for reporting bugs.
+     Really.
 
      NOTE: Many distributions of GNU/Linux and the various BSD-based
      operating systems have their own bug reporting systems.  If you
@@ -28060,25 +28060,26 @@ common by all the maintainers._
 
      This is for two reasons.  First, while some distributions forward
      bug reports "upstream" to the GNU mailing list, many don't, so
-     there is a good chance that the `gawk'  maintainer won't even see
+     there is a good chance that the `gawk'  maintainers won't even see
      the bug report!  Second, mail to the GNU list is archived, and
      having everything at the GNU project keeps things self-contained
-     and not dependant on other web sites.
+     and not dependant on other organizations.
 
    Non-bug suggestions are always welcome as well.  If you have
 questions about things that are unclear in the documentation or are
-just obscure features, ask me; I will try to help you out, although I
-may not have the time to fix the problem.  You can send me electronic
-mail at the Internet address noted previously.
+just obscure features, ask on the bug list; we will try to help you out
+if we can.
 
    If you find bugs in one of the non-Unix ports of `gawk', please send
-an electronic mail message to the person who maintains that port.  They
-are named in the following list, as well as in the `README' file in the
-`gawk' distribution.  Information in the `README' file should be
-considered authoritative if it conflicts with this Info file.
+an electronic mail message to the bug list, with a copy to the person
+who maintains that port.  They are named in the following list, as well
+as in the `README' file in the `gawk' distribution.  Information in the
+`README' file should be considered authoritative if it conflicts with
+this Info file.
 
-   The people maintaining the non-Unix ports of `gawk' are as follows:
+   The people maintaining the various `gawk' ports are:
 
+Unix and POSIX systems  Arnold Robbins, <arnold@skeeve.com>.
 MS-DOS with DJGPP       Scott Deifik, <scottd.mail@sbcglobal.net>.
 MS-Windows with MinGW   Eli Zaretskii, <eliz@gnu.org>.
 OS/2                    Andreas Buening, <andreas.buening@nexgo.de>.
@@ -28170,9 +28171,9 @@ Unix `awk'
 `pawk'
      Nelson H.F. Beebe at the University of Utah has modified BWK `awk'
      to provide timing and profiling information.  It is different from
-     `gawk' with the `--profile' option.  (*note Profiling::), in that
-     it uses CPU-based profiling, not line-count profiling.  You may
-     find it at either
+     `gawk' with the `--profile' option (*note Profiling::), in that it
+     uses CPU-based profiling, not line-count profiling.  You may find
+     it at either
      `ftp://ftp.math.utah.edu/pub/pawk/pawk-20030606.tar.gz' or
      `http://www.math.utah.edu/pub/pawk/pawk-20030606.tar.gz'.
 
@@ -28188,11 +28189,11 @@ Busybox Awk
 The OpenSolaris POSIX `awk'
      The versions of `awk' in `/usr/xpg4/bin' and `/usr/xpg6/bin' on
      Solaris are more-or-less POSIX-compliant.  They are based on the
-     `awk' from Mortice Kern Systems for PCs.  This author was able to
-     make this code compile and work under GNU/Linux with 1-2 hours of
-     work.  Making it more generally portable (using GNU Autoconf
-     and/or Automake) would take more work, and this has not been done,
-     at least to our knowledge.
+     `awk' from Mortice Kern Systems for PCs.  We were able to make
+     this code compile and work under GNU/Linux with 1-2 hours of work.
+     Making it more generally portable (using GNU Autoconf and/or
+     Automake) would take more work, and this has not been done, at
+     least to our knowledge.
 
      The source code used to be available from the OpenSolaris web site.
      However, that project was ended and the web site shut down.
@@ -31843,7 +31844,7 @@ Index
 * common extensions, RS as a regexp:     gawk split records.  (line   6)
 * common extensions, single character fields: Single Character Fields.
                                                               (line   6)
-* comp.lang.awk newsgroup:               Bugs.                (line  39)
+* comp.lang.awk newsgroup:               Bugs.                (line  38)
 * comparison expressions:                Typing and Comparison.
                                                               (line   9)
 * comparison expressions, as patterns:   Expression Patterns. (line  14)
@@ -33586,7 +33587,7 @@ Index
 * RLENGTH variable:                      Auto-set.            (line 259)
 * RLENGTH variable, match() function and: String Functions.   (line 227)
 * Robbins, Arnold <1>:                   Future Extensions.   (line   6)
-* Robbins, Arnold <2>:                   Bugs.                (line  32)
+* Robbins, Arnold <2>:                   Bugs.                (line  71)
 * Robbins, Arnold <3>:                   Contributors.        (line 144)
 * Robbins, Arnold <4>:                   General Data Types.  (line   6)
 * Robbins, Arnold <5>:                   Alarm Program.       (line   6)
@@ -34643,64 +34644,64 @@ Ref: Ranges and Locales-Footnote-31076872
 Node: Contributors1077093
 Node: History summary1082633
 Node: Installation1084002
-Node: Gawk Distribution1084953
-Node: Getting1085437
-Node: Extracting1086261
-Node: Distribution contents1087903
-Node: Unix Installation1093673
-Node: Quick Installation1094290
-Node: Additional Configuration Options1096732
-Node: Configuration Philosophy1098470
-Node: Non-Unix Installation1100821
-Node: PC Installation1101279
-Node: PC Binary Installation1102590
-Node: PC Compiling1104438
-Ref: PC Compiling-Footnote-11107437
-Node: PC Testing1107542
-Node: PC Using1108718
-Node: Cygwin1112870
-Node: MSYS1113679
-Node: VMS Installation1114177
-Node: VMS Compilation1114973
-Ref: VMS Compilation-Footnote-11116195
-Node: VMS Dynamic Extensions1116253
-Node: VMS Installation Details1117626
-Node: VMS Running1119878
-Node: VMS GNV1122712
-Node: VMS Old Gawk1123435
-Node: Bugs1123905
-Node: Other Versions1127909
-Node: Installation summary1134133
-Node: Notes1135189
-Node: Compatibility Mode1136054
-Node: Additions1136836
-Node: Accessing The Source1137761
-Node: Adding Code1139197
-Node: New Ports1145369
-Node: Derived Files1149850
-Ref: Derived Files-Footnote-11155325
-Ref: Derived Files-Footnote-21155359
-Ref: Derived Files-Footnote-31155955
-Node: Future Extensions1156069
-Node: Implementation Limitations1156675
-Node: Extension Design1157923
-Node: Old Extension Problems1159077
-Ref: Old Extension Problems-Footnote-11160594
-Node: Extension New Mechanism Goals1160651
-Ref: Extension New Mechanism Goals-Footnote-11164011
-Node: Extension Other Design Decisions1164200
-Node: Extension Future Growth1166308
-Node: Old Extension Mechanism1167144
-Node: Notes summary1168906
-Node: Basic Concepts1170092
-Node: Basic High Level1170773
-Ref: figure-general-flow1171045
-Ref: figure-process-flow1171644
-Ref: Basic High Level-Footnote-11174873
-Node: Basic Data Typing1175058
-Node: Glossary1178386
-Node: Copying1203544
-Node: GNU Free Documentation License1241100
-Node: Index1266236
+Node: Gawk Distribution1084958
+Node: Getting1085442
+Node: Extracting1086266
+Node: Distribution contents1087908
+Node: Unix Installation1093678
+Node: Quick Installation1094295
+Node: Additional Configuration Options1096726
+Node: Configuration Philosophy1098466
+Node: Non-Unix Installation1100817
+Node: PC Installation1101275
+Node: PC Binary Installation1102601
+Node: PC Compiling1104449
+Ref: PC Compiling-Footnote-11107470
+Node: PC Testing1107575
+Node: PC Using1108751
+Node: Cygwin1112866
+Node: MSYS1113689
+Node: VMS Installation1114187
+Node: VMS Compilation1114979
+Ref: VMS Compilation-Footnote-11116201
+Node: VMS Dynamic Extensions1116259
+Node: VMS Installation Details1117632
+Node: VMS Running1119884
+Node: VMS GNV1122725
+Node: VMS Old Gawk1123454
+Node: Bugs1123924
+Node: Other Versions1127888
+Node: Installation summary1134101
+Node: Notes1135157
+Node: Compatibility Mode1136022
+Node: Additions1136804
+Node: Accessing The Source1137729
+Node: Adding Code1139165
+Node: New Ports1145337
+Node: Derived Files1149818
+Ref: Derived Files-Footnote-11155293
+Ref: Derived Files-Footnote-21155327
+Ref: Derived Files-Footnote-31155923
+Node: Future Extensions1156037
+Node: Implementation Limitations1156643
+Node: Extension Design1157891
+Node: Old Extension Problems1159045
+Ref: Old Extension Problems-Footnote-11160562
+Node: Extension New Mechanism Goals1160619
+Ref: Extension New Mechanism Goals-Footnote-11163979
+Node: Extension Other Design Decisions1164168
+Node: Extension Future Growth1166276
+Node: Old Extension Mechanism1167112
+Node: Notes summary1168874
+Node: Basic Concepts1170060
+Node: Basic High Level1170741
+Ref: figure-general-flow1171013
+Ref: figure-process-flow1171612
+Ref: Basic High Level-Footnote-11174841
+Node: Basic Data Typing1175026
+Node: Glossary1178354
+Node: Copying1203512
+Node: GNU Free Documentation License1241068
+Node: Index1266204
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index fd411745..ac34949a 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -36747,7 +36747,7 @@ various platforms that are supported by the developers.  The primary
 developer supports GNU/Linux (and Unix), whereas the other ports are
 contributed.
 @xref{Bugs},
-for the electronic mail addresses of the people who did
+for the electronic mail addresses of the people who maintain
 the respective ports.
 
 @menu
@@ -37066,11 +37066,10 @@ Unix-derived systems, GNU/Linux, BSD-based systems, and the Cygwin
 environment for MS-Windows.
 
 After you have extracted the @command{gawk} distribution, @command{cd}
-to @file{gawk-@value{VERSION}.@value{PATCHLEVEL}}.  Like most GNU software,
-@command{gawk} is configured
-automatically for your system by running the @command{configure} program.
-This program is a Bourne shell script that is generated automatically using
-GNU Autoconf.
+to @file{gawk-@value{VERSION}.@value{PATCHLEVEL}}.  As with most GNU
+software, you configure @command{gawk} for your system by running the
+@command{configure} program.  This program is a Bourne shell script that
+is generated automatically using GNU Autoconf.
 @ifnotinfo
 (The Autoconf software is
 described fully in
@@ -37165,8 +37164,8 @@ Similarly, setting the @code{LINT} variable
 has no effect on the running @command{awk} program.
 
 When used with GCC's automatic dead-code-elimination, this option
-cuts almost 200K bytes off the size of the @command{gawk}
-executable on GNU/Linux x86 systems.  Results on other systems and
+cuts almost 23K bytes off the size of the @command{gawk}
+executable on GNU/Linux x86_64 systems.  Results on other systems and
 with other compilers are likely to vary.
 Using this option may bring you some slight performance improvement.
 
@@ -37259,7 +37258,8 @@ various non-Unix systems.
 
 @cindex PC operating systems@comma{} @command{gawk} on, installing
 @cindex operating systems, PC@comma{} @command{gawk} on, installing
-This @value{SECTION} covers installation and usage of @command{gawk} on x86 machines
+This @value{SECTION} covers installation and usage of @command{gawk}
+on Intel architecture machines
 @ifclear FOR_PRINT
 running MS-DOS, any version of MS-Windows, or OS/2.
 @end ifclear
@@ -37361,7 +37361,8 @@ MS-DOS and Windows32 versions.  A list of targets is printed if the
 build @command{gawk} using the DJGPP tools, enter @samp{make djgpp}.
 (The DJGPP tools needed for the build may be found at
 @uref{ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/}.)  To build a
-native MS-Windows binary of @command{gawk}, type @samp{make mingw32}.
+native MS-Windows binary of @command{gawk} using the MinGW tools,
+type @samp{make mingw32}.
 
 @ifclear FOR_PRINT
 @cindex compiling @command{gawk} with EMX for OS/2
@@ -37491,8 +37492,7 @@ The MS-DOS and MS-Windows versions of @command{gawk} search for
 program files as described in @ref{AWKPATH Variable}.  However,
 semicolons (rather than colons) separate elements in the @env{AWKPATH}
 variable.  If @env{AWKPATH} is not set or is empty, then the default
-search path for MS-Windows and MS-DOS versions is
-@samp{@w{.;c:/lib/awk;c:/gnu/lib/awk}}.
+search path is @samp{@w{.;c:/lib/awk;c:/gnu/lib/awk}}.
 
 @ifclear FOR_PRINT
 @cindex @command{gawk}, OS/2 version of
@@ -37537,12 +37537,12 @@ allows control over these translations and is interpreted as follows:
 
 @itemize @value{BULLET}
 @item
-If @code{BINMODE} is @code{"r"}, or one,
+If @code{BINMODE} is @code{"r"} or one,
 then
 binary mode is set on read (i.e., no translations on reads).
 
 @item
-If @code{BINMODE} is @code{"w"}, or two,
+If @code{BINMODE} is @code{"w"} or two,
 then
 binary mode is set on write (i.e., no translations on writes).
 
@@ -37630,7 +37630,7 @@ same as for a Unix system:
 tar -xvpzf gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz
 cd gawk-@value{VERSION}.@value{PATCHLEVEL}
 ./configure
-make
+make && make check
 @end example
 
 When compared to GNU/Linux on the same system, the @samp{configure}
@@ -37649,7 +37649,7 @@ been ported to MS-Windows that expect @command{gawk} to do automatic
 translation of @code{"\r\n"}, since it won't.
 
 @node VMS Installation
-@appendixsubsec How to Compile and Install @command{gawk} on Vax/VMS and OpenVMS
+@appendixsubsec Compiling and Installing @command{gawk} on Vax/VMS and OpenVMS
 
 @c based on material from Pat Rankin <rankin@eql.caltech.edu>
 @c now rankin@pactechdata.com
@@ -37866,12 +37866,12 @@ other dash-type options (or multiple parameters such as @value{DF}s to
 process) are present, there is no ambiguity and @option{--} can be omitted.
 
 @cindex exit status, of VMS
-The @code{exit} value is a Unix-style value and is encoded to a VMS exit
+The @code{exit} value is a Unix-style value and is encoded into a VMS exit
 status value when the program exits.
 
 The VMS severity bits will be set based on the @code{exit} value.
 A failure is indicated by 1 and VMS sets the @code{ERROR} status.
-A fatal error is indicated by 2 and VMS will set the @code{FATAL} status.
+A fatal error is indicated by 2 and VMS sets the @code{FATAL} status.
 All other values will have the @code{SUCCESS} status.  The exit value is
 encoded to comply with VMS coding standards and will have the
 @code{C_FACILITY_NO} of @code{0x350000} with the constant @code{0xA000}
@@ -37887,7 +37887,7 @@ unix_status = (vms_status .and. &x7f8) / 8
 A C program that uses @code{exec()} to call @command{gawk} will get the original
 Unix-style exit value.
 
-Older versions of @command{gawk} treated a Unix exit code 0 as 1, a failure
+Older versions of @command{gawk} for VMS treated a Unix exit code 0 as 1, a failure
 as 2, a fatal error as 4, and passed all the other numbers through.
 This violated the VMS exit status coding requirements.
 
@@ -37921,7 +37921,7 @@ See @w{@uref{https://sourceforge.net/p/gnv/wiki/InstallingGNVPackages/}.}
 The normal build procedure for @command{gawk} produces a program that
 is suitable for use with GNV.
 
-The @file{vms/gawk_build_steps.txt} in the source documents the procedure
+The @file{vms/gawk_build_steps.txt} in the distribution documents the procedure
 for building a VMS PCSI kit that is compatible with GNV.
 
 @ignore
@@ -37994,7 +37994,7 @@ If you have problems with @command{gawk} or think that you have found a bug,
 please report it to the developers; we cannot promise to do anything
 but we might well want to fix it.
 
-Before reporting a bug, make sure you have actually found a real bug.
+Before reporting a bug, please make sure you have actually found a real bug.
 Carefully reread the documentation and see if it really says you can do
 what you're trying to do.  If it's not clear whether you should be able
 to do something or not, report that too; it's a bug in the documentation!
@@ -38016,14 +38016,12 @@ You can get this information with the command @samp{gawk --version}.
 Once you have a precise problem, send email to
 @EMAIL{bug-gawk@@gnu.org,bug-gawk at gnu dot org}.
 
-@cindex Robbins, Arnold
 The @command{gawk} maintainers subscribe to this address and
 thus they will receive your bug report.
-If necessary, the primary maintainer can be reached directly at
-@EMAIL{arnold@@skeeve.com,arnold at skeeve dot com}.
-The bug reporting address is preferred since the
+Although you can send mail to the maintainers directly,
+the bug reporting address is preferred since the
 email list is archived at the GNU Project.
-@emph{All email should be in English. This is the only language
+@emph{All email must be in English. This is the only language
 understood in common by all the maintainers.}
 
 @cindex @code{comp.lang.awk} newsgroup
@@ -38032,7 +38030,7 @@ Do @emph{not} try to report bugs in @command{gawk} by
 posting to the Usenet/Internet newsgroup @code{comp.lang.awk}.
 While the @command{gawk} developers do occasionally read this newsgroup,
 there is no guarantee that we will see your posting.  The steps described
-above are the official recognized ways for reporting bugs.
+above are the only official recognized way for reporting bugs.
 Really.
 @end quotation
 
@@ -38044,35 +38042,35 @@ bug reporting system, @emph{please} also send a copy to
 
 This is for two reasons.  First, while some distributions forward
 bug reports ``upstream'' to the GNU mailing list, many don't, so there is a good
-chance that the @command{gawk}  maintainer won't even see the bug report!  Second,
+chance that the @command{gawk}  maintainers won't even see the bug report!  Second,
 mail to the GNU list is archived, and having everything at the GNU project
-keeps things self-contained and not dependant on other web sites.
+keeps things self-contained and not dependant on other organizations.
 @end quotation
 
 Non-bug suggestions are always welcome as well.  If you have questions
 about things that are unclear in the documentation or are just obscure
-features, ask me; I will try to help you out, although I
-may not have the time to fix the problem.  You can send me electronic
-mail at the Internet address noted previously.
-
-If you find bugs in one of the non-Unix ports of @command{gawk}, please send
-an electronic mail message to the person who maintains that port.  They
-are named in the following list, as well as in the @file{README} file
-in the @command{gawk} distribution.  Information in the @file{README}
-file should be considered authoritative if it conflicts with this
-@value{DOCUMENT}.
+features, ask on the bug list; we will try to help you out if we can.
 
-The people maintaining the non-Unix ports of @command{gawk} are
-as follows:
+If you find bugs in one of the non-Unix ports of @command{gawk}, please
+send an electronic mail message to the bug list, with a copy to the
+person who maintains that port.  They are named in the following list,
+as well as in the @file{README} file in the @command{gawk} distribution.
+Information in the @file{README} file should be considered authoritative
+if it conflicts with this @value{DOCUMENT}.
+
+The people maintaining the various @command{gawk} ports are:
 
 @c put the index entries outside the table, for docbook
-@cindex Deifik, Scott
-@cindex Zaretskii, Eli
 @cindex Buening, Andreas
-@cindex Rankin, Pat
+@cindex Deifik, Scott
 @cindex Malmberg, John
 @cindex Pitts, Dave
+@cindex Rankin, Pat
+@cindex Robbins, Arnold
+@cindex Zaretskii, Eli
 @multitable {MS-Windows with MinGW} {123456789012345678901234567890123456789001234567890}
+@item Unix and POSIX systems @tab Arnold Robbins, @EMAIL{arnold@@skeeve.com,arnold at skeeve dot com}.
+
 @item MS-DOS with DJGPP @tab Scott Deifik, @EMAIL{scottd.mail@@sbcglobal.net,scottd dot mail at sbcglobal dot net}.
 
 @item MS-Windows with MinGW @tab Eli Zaretskii, @EMAIL{eliz@@gnu.org,eliz at gnu dot org}.
@@ -38226,7 +38224,7 @@ since approximately 2003.
 @item @command{pawk}
 Nelson H.F.@: Beebe at the University of Utah has modified
 BWK @command{awk} to provide timing and profiling information.
-It is different from @command{gawk} with the @option{--profile} option.
+It is different from @command{gawk} with the @option{--profile} option
 (@pxref{Profiling}),
 in that it uses CPU-based profiling, not line-count
 profiling.  You may find it at either
@@ -38251,7 +38249,7 @@ information, see the @uref{http://busybox.net, project's home page}.
 The versions of @command{awk} in @file{/usr/xpg4/bin} and
 @file{/usr/xpg6/bin} on Solaris are more-or-less POSIX-compliant.
 They are based on the @command{awk} from Mortice Kern Systems for PCs.
-This author was able to make this code compile and work under GNU/Linux
+We were able to make this code compile and work under GNU/Linux
 with 1--2 hours of work.  Making it more generally portable (using
 GNU Autoconf and/or Automake) would take more work, and this
 has not been done, at least to our knowledge.
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index eb9bb0d4..2ce4bb87 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -35844,7 +35844,7 @@ various platforms that are supported by the developers.  The primary
 developer supports GNU/Linux (and Unix), whereas the other ports are
 contributed.
 @xref{Bugs},
-for the electronic mail addresses of the people who did
+for the electronic mail addresses of the people who maintain
 the respective ports.
 
 @menu
@@ -36163,11 +36163,10 @@ Unix-derived systems, GNU/Linux, BSD-based systems, and the Cygwin
 environment for MS-Windows.
 
 After you have extracted the @command{gawk} distribution, @command{cd}
-to @file{gawk-@value{VERSION}.@value{PATCHLEVEL}}.  Like most GNU software,
-@command{gawk} is configured
-automatically for your system by running the @command{configure} program.
-This program is a Bourne shell script that is generated automatically using
-GNU Autoconf.
+to @file{gawk-@value{VERSION}.@value{PATCHLEVEL}}.  As with most GNU
+software, you configure @command{gawk} for your system by running the
+@command{configure} program.  This program is a Bourne shell script that
+is generated automatically using GNU Autoconf.
 @ifnotinfo
 (The Autoconf software is
 described fully in
@@ -36262,8 +36261,8 @@ Similarly, setting the @code{LINT} variable
 has no effect on the running @command{awk} program.
 
 When used with GCC's automatic dead-code-elimination, this option
-cuts almost 200K bytes off the size of the @command{gawk}
-executable on GNU/Linux x86 systems.  Results on other systems and
+cuts almost 23K bytes off the size of the @command{gawk}
+executable on GNU/Linux x86_64 systems.  Results on other systems and
 with other compilers are likely to vary.
 Using this option may bring you some slight performance improvement.
 
@@ -36356,7 +36355,8 @@ various non-Unix systems.
 
 @cindex PC operating systems@comma{} @command{gawk} on, installing
 @cindex operating systems, PC@comma{} @command{gawk} on, installing
-This @value{SECTION} covers installation and usage of @command{gawk} on x86 machines
+This @value{SECTION} covers installation and usage of @command{gawk}
+on Intel architecture machines
 @ifclear FOR_PRINT
 running MS-DOS, any version of MS-Windows, or OS/2.
 @end ifclear
@@ -36458,7 +36458,8 @@ MS-DOS and Windows32 versions.  A list of targets is printed if the
 build @command{gawk} using the DJGPP tools, enter @samp{make djgpp}.
 (The DJGPP tools needed for the build may be found at
 @uref{ftp://ftp.delorie.com/pub/djgpp/current/v2gnu/}.)  To build a
-native MS-Windows binary of @command{gawk}, type @samp{make mingw32}.
+native MS-Windows binary of @command{gawk} using the MinGW tools,
+type @samp{make mingw32}.
 
 @ifclear FOR_PRINT
 @cindex compiling @command{gawk} with EMX for OS/2
@@ -36588,8 +36589,7 @@ The MS-DOS and MS-Windows versions of @command{gawk} search for
 program files as described in @ref{AWKPATH Variable}.  However,
 semicolons (rather than colons) separate elements in the @env{AWKPATH}
 variable.  If @env{AWKPATH} is not set or is empty, then the default
-search path for MS-Windows and MS-DOS versions is
-@samp{@w{.;c:/lib/awk;c:/gnu/lib/awk}}.
+search path is @samp{@w{.;c:/lib/awk;c:/gnu/lib/awk}}.
 
 @ifclear FOR_PRINT
 @cindex @command{gawk}, OS/2 version of
@@ -36634,12 +36634,12 @@ allows control over these translations and is interpreted as follows:
 
 @itemize @value{BULLET}
 @item
-If @code{BINMODE} is @code{"r"}, or one,
+If @code{BINMODE} is @code{"r"} or one,
 then
 binary mode is set on read (i.e., no translations on reads).
 
 @item
-If @code{BINMODE} is @code{"w"}, or two,
+If @code{BINMODE} is @code{"w"} or two,
 then
 binary mode is set on write (i.e., no translations on writes).
 
@@ -36727,7 +36727,7 @@ same as for a Unix system:
 tar -xvpzf gawk-@value{VERSION}.@value{PATCHLEVEL}.tar.gz
 cd gawk-@value{VERSION}.@value{PATCHLEVEL}
 ./configure
-make
+make && make check
 @end example
 
 When compared to GNU/Linux on the same system, the @samp{configure}
@@ -36746,7 +36746,7 @@ been ported to MS-Windows that expect @command{gawk} to do automatic
 translation of @code{"\r\n"}, since it won't.
 
 @node VMS Installation
-@appendixsubsec How to Compile and Install @command{gawk} on Vax/VMS and OpenVMS
+@appendixsubsec Compiling and Installing @command{gawk} on Vax/VMS and OpenVMS
 
 @c based on material from Pat Rankin <rankin@eql.caltech.edu>
 @c now rankin@pactechdata.com
@@ -36963,12 +36963,12 @@ other dash-type options (or multiple parameters such as @value{DF}s to
 process) are present, there is no ambiguity and @option{--} can be omitted.
 
 @cindex exit status, of VMS
-The @code{exit} value is a Unix-style value and is encoded to a VMS exit
+The @code{exit} value is a Unix-style value and is encoded into a VMS exit
 status value when the program exits.
 
 The VMS severity bits will be set based on the @code{exit} value.
 A failure is indicated by 1 and VMS sets the @code{ERROR} status.
-A fatal error is indicated by 2 and VMS will set the @code{FATAL} status.
+A fatal error is indicated by 2 and VMS sets the @code{FATAL} status.
 All other values will have the @code{SUCCESS} status.  The exit value is
 encoded to comply with VMS coding standards and will have the
 @code{C_FACILITY_NO} of @code{0x350000} with the constant @code{0xA000}
@@ -36984,7 +36984,7 @@ unix_status = (vms_status .and. &x7f8) / 8
 A C program that uses @code{exec()} to call @command{gawk} will get the original
 Unix-style exit value.
 
-Older versions of @command{gawk} treated a Unix exit code 0 as 1, a failure
+Older versions of @command{gawk} for VMS treated a Unix exit code 0 as 1, a failure
 as 2, a fatal error as 4, and passed all the other numbers through.
 This violated the VMS exit status coding requirements.
 
@@ -37018,7 +37018,7 @@ See @w{@uref{https://sourceforge.net/p/gnv/wiki/InstallingGNVPackages/}.}
 The normal build procedure for @command{gawk} produces a program that
 is suitable for use with GNV.
 
-The @file{vms/gawk_build_steps.txt} in the source documents the procedure
+The @file{vms/gawk_build_steps.txt} in the distribution documents the procedure
 for building a VMS PCSI kit that is compatible with GNV.
 
 @ignore
@@ -37091,7 +37091,7 @@ If you have problems with @command{gawk} or think that you have found a bug,
 please report it to the developers; we cannot promise to do anything
 but we might well want to fix it.
 
-Before reporting a bug, make sure you have actually found a real bug.
+Before reporting a bug, please make sure you have actually found a real bug.
 Carefully reread the documentation and see if it really says you can do
 what you're trying to do.  If it's not clear whether you should be able
 to do something or not, report that too; it's a bug in the documentation!
@@ -37113,14 +37113,12 @@ You can get this information with the command @samp{gawk --version}.
 Once you have a precise problem, send email to
 @EMAIL{bug-gawk@@gnu.org,bug-gawk at gnu dot org}.
 
-@cindex Robbins, Arnold
 The @command{gawk} maintainers subscribe to this address and
 thus they will receive your bug report.
-If necessary, the primary maintainer can be reached directly at
-@EMAIL{arnold@@skeeve.com,arnold at skeeve dot com}.
-The bug reporting address is preferred since the
+Although you can send mail to the maintainers directly,
+the bug reporting address is preferred since the
 email list is archived at the GNU Project.
-@emph{All email should be in English. This is the only language
+@emph{All email must be in English. This is the only language
 understood in common by all the maintainers.}
 
 @cindex @code{comp.lang.awk} newsgroup
@@ -37129,7 +37127,7 @@ Do @emph{not} try to report bugs in @command{gawk} by
 posting to the Usenet/Internet newsgroup @code{comp.lang.awk}.
 While the @command{gawk} developers do occasionally read this newsgroup,
 there is no guarantee that we will see your posting.  The steps described
-above are the official recognized ways for reporting bugs.
+above are the only official recognized way for reporting bugs.
 Really.
 @end quotation
 
@@ -37141,35 +37139,35 @@ bug reporting system, @emph{please} also send a copy to
 
 This is for two reasons.  First, while some distributions forward
 bug reports ``upstream'' to the GNU mailing list, many don't, so there is a good
-chance that the @command{gawk}  maintainer won't even see the bug report!  Second,
+chance that the @command{gawk}  maintainers won't even see the bug report!  Second,
 mail to the GNU list is archived, and having everything at the GNU project
-keeps things self-contained and not dependant on other web sites.
+keeps things self-contained and not dependant on other organizations.
 @end quotation
 
 Non-bug suggestions are always welcome as well.  If you have questions
 about things that are unclear in the documentation or are just obscure
-features, ask me; I will try to help you out, although I
-may not have the time to fix the problem.  You can send me electronic
-mail at the Internet address noted previously.
-
-If you find bugs in one of the non-Unix ports of @command{gawk}, please send
-an electronic mail message to the person who maintains that port.  They
-are named in the following list, as well as in the @file{README} file
-in the @command{gawk} distribution.  Information in the @file{README}
-file should be considered authoritative if it conflicts with this
-@value{DOCUMENT}.
+features, ask on the bug list; we will try to help you out if we can.
 
-The people maintaining the non-Unix ports of @command{gawk} are
-as follows:
+If you find bugs in one of the non-Unix ports of @command{gawk}, please
+send an electronic mail message to the bug list, with a copy to the
+person who maintains that port.  They are named in the following list,
+as well as in the @file{README} file in the @command{gawk} distribution.
+Information in the @file{README} file should be considered authoritative
+if it conflicts with this @value{DOCUMENT}.
+
+The people maintaining the various @command{gawk} ports are:
 
 @c put the index entries outside the table, for docbook
-@cindex Deifik, Scott
-@cindex Zaretskii, Eli
 @cindex Buening, Andreas
-@cindex Rankin, Pat
+@cindex Deifik, Scott
 @cindex Malmberg, John
 @cindex Pitts, Dave
+@cindex Rankin, Pat
+@cindex Robbins, Arnold
+@cindex Zaretskii, Eli
 @multitable {MS-Windows with MinGW} {123456789012345678901234567890123456789001234567890}
+@item Unix and POSIX systems @tab Arnold Robbins, @EMAIL{arnold@@skeeve.com,arnold at skeeve dot com}.
+
 @item MS-DOS with DJGPP @tab Scott Deifik, @EMAIL{scottd.mail@@sbcglobal.net,scottd dot mail at sbcglobal dot net}.
 
 @item MS-Windows with MinGW @tab Eli Zaretskii, @EMAIL{eliz@@gnu.org,eliz at gnu dot org}.
@@ -37323,7 +37321,7 @@ since approximately 2003.
 @item @command{pawk}
 Nelson H.F.@: Beebe at the University of Utah has modified
 BWK @command{awk} to provide timing and profiling information.
-It is different from @command{gawk} with the @option{--profile} option.
+It is different from @command{gawk} with the @option{--profile} option
 (@pxref{Profiling}),
 in that it uses CPU-based profiling, not line-count
 profiling.  You may find it at either
@@ -37348,7 +37346,7 @@ information, see the @uref{http://busybox.net, project's home page}.
 The versions of @command{awk} in @file{/usr/xpg4/bin} and
 @file{/usr/xpg6/bin} on Solaris are more-or-less POSIX-compliant.
 They are based on the @command{awk} from Mortice Kern Systems for PCs.
-This author was able to make this code compile and work under GNU/Linux
+We were able to make this code compile and work under GNU/Linux
 with 1--2 hours of work.  Making it more generally portable (using
 GNU Autoconf and/or Automake) would take more work, and this
 has not been done, at least to our knowledge.