Edits through Appendix A.

4 files changed, 141 insertions, 107 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index fe9c1122..dac82608 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2014-05-25         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in: Edits through Appendix A.
+
 2014-05-24         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in (Staying current): New section.
diff --git a/doc/gawk.info b/doc/gawk.info
index 4852a58f..48a8e9a4 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -25090,7 +25090,7 @@ the POSIX specification.  Many long-time `awk' users learned `awk'
 programming with the original `awk' implementation in Version 7 Unix.
 (This implementation was the basis for `awk' in Berkeley Unix, through
 4.3-Reno.  Subsequent versions of Berkeley Unix, and some systems
-derived from 4.4BSD-Lite, use various versions of `gawk' for their
+derived from 4.4BSD-Lite, used various versions of `gawk' for their
 `awk'.)  This major node briefly describes the evolution of the `awk'
 language, with cross-references to other parts of the Info file where
 you can find more information.
@@ -25532,8 +25532,8 @@ in POSIX `awk', in the order they were added to `gawk'.
    * The `next file' statement became `nextfile' (*note Nextfile
      Statement::).
 
-   * The `fflush()' function from the Bell Laboratories research
-     version of `awk' (*note I/O Functions::).
+   * The `fflush()' function from Brian Kernighan's `awk' (then at Bell
+     Laboratories; *note I/O Functions::).
 
    * New command line options:
 
@@ -25541,8 +25541,9 @@ in POSIX `awk', in the order they were added to `gawk'.
           available in the original Version 7 Unix version of `awk'
           (*note V7/SVR3.1::).
 
-        - The `-m' option from the Bell Laboratories research version
-          of `awk' This was later removed.
+        - The `-m' option from Brian Kernighan's `awk'.  (He was still
+          at Bell Laboratories at the time.)  This was later removed
+          from both his `awk' and from `gawk'.
 
         - The `--re-interval' option to provide interval expressions in
           regexps (*note Regexp Operators::).
@@ -25553,7 +25554,7 @@ in POSIX `awk', in the order they were added to `gawk'.
    * The use of GNU Autoconf to control the configuration process
      (*note Quick Installation::).
 
-   * Amiga support.
+   * Amiga support.  This has since been removed.
 
 
    Version 3.1 of `gawk' introduced the following features:
@@ -25644,7 +25645,8 @@ in POSIX `awk', in the order they were added to `gawk'.
 
    * Tandem support. This was later removed.
 
-   * The Atari port became officially unsupported.
+   * The Atari port became officially unsupported and was later removed
+     entirely.
 
    * The source code changed to use ISO C standard-style function
      definitions.
@@ -25706,8 +25708,8 @@ in POSIX `awk', in the order they were added to `gawk'.
      output redirections (*note I/O Functions::).
 
    * The `isarray()' function which distinguishes if an item is an array
-     or not, to make it possible to traverse multidimensional arrays
-     (*note Type Functions::).
+     or not, to make it possible to traverse arrays of arrays (*note
+     Type Functions::).
 
    * The `patsplit()' function which gives the same capability as
      `FPAT', for splitting (*note String Functions::).
@@ -26008,8 +26010,8 @@ Info file, in approximate chronological order:
 
    * Michal Jaegermann provided the port to Atari systems and its
      documentation.  (This port is no longer supported.)  He continues
-     to provide portability checking with DEC Alpha systems, and has
-     done a lot of work to make sure `gawk' works on non-32-bit systems.
+     to provide portability checking, and has done a lot of work to
+     make sure `gawk' works on non-32-bit systems.
 
    * Fred Fish provided the port to Amiga systems and its documentation.
      (With Fred's sad passing, this is no longer supported.)
@@ -26074,8 +26076,8 @@ Info file, in approximate chronological order:
         - The modifications to convert `gawk' into a byte-code
           interpreter, including the debugger.
 
-        - The addition of true multidimensional arrays.  *note Arrays
-          of Arrays::.
+        - The addition of true arrays of arrays.  *note Arrays of
+          Arrays::.
 
         - The additional modifications for support of arbitrary
           precision arithmetic.
@@ -32153,7 +32155,7 @@ Index
                                                               (line  19)
 * next debugger command:                 Debugger Execution Control.
                                                               (line  43)
-* next file statement:                   Feature History.     (line 168)
+* next file statement:                   Feature History.     (line 169)
 * next statement <1>:                    Next Statement.      (line   6)
 * next statement:                        Boolean Ops.         (line  85)
 * next statement, BEGIN/END patterns and: I/O And BEGIN/END.  (line  37)
@@ -33671,74 +33673,74 @@ Node: Extension Sample API Tests1003531
 Node: Extension Sample Time1004056
 Node: gawkextlib1005371
 Node: Language History1008152
-Node: V7/SVR3.11009745
-Node: SVR41012065
-Node: POSIX1013507
-Node: BTL1014893
-Node: POSIX/GNU1015627
-Node: Feature History1021226
-Node: Common Extensions1034202
-Node: Ranges and Locales1035514
-Ref: Ranges and Locales-Footnote-11040131
-Ref: Ranges and Locales-Footnote-21040158
-Ref: Ranges and Locales-Footnote-31040392
-Node: Contributors1040613
-Node: Installation1045994
-Node: Gawk Distribution1046888
-Node: Getting1047372
-Node: Extracting1048198
-Node: Distribution contents1049890
-Node: Unix Installation1055611
-Node: Quick Installation1056228
-Node: Additional Configuration Options1058674
-Node: Configuration Philosophy1060410
-Node: Non-Unix Installation1062764
-Node: PC Installation1063222
-Node: PC Binary Installation1064533
-Node: PC Compiling1066381
-Node: PC Testing1069341
-Node: PC Using1070517
-Node: Cygwin1074685
-Node: MSYS1075494
-Node: VMS Installation1076008
-Node: VMS Compilation1076804
-Ref: VMS Compilation-Footnote-11078056
-Node: VMS Dynamic Extensions1078114
-Node: VMS Installation Details1079487
-Node: VMS Running1081738
-Node: VMS GNV1084572
-Node: VMS Old Gawk1085295
-Node: Bugs1085765
-Node: Other Versions1089683
-Node: Notes1095767
-Node: Compatibility Mode1096567
-Node: Additions1097350
-Node: Accessing The Source1098277
-Node: Adding Code1099717
-Node: New Ports1105762
-Node: Derived Files1109897
-Ref: Derived Files-Footnote-11115218
-Ref: Derived Files-Footnote-21115252
-Ref: Derived Files-Footnote-31115852
-Node: Future Extensions1115950
-Node: Implementation Limitations1116533
-Node: Extension Design1117781
-Node: Old Extension Problems1118935
-Ref: Old Extension Problems-Footnote-11120443
-Node: Extension New Mechanism Goals1120500
-Ref: Extension New Mechanism Goals-Footnote-11123865
-Node: Extension Other Design Decisions1124051
-Node: Extension Future Growth1126157
-Node: Old Extension Mechanism1126993
-Node: Basic Concepts1128733
-Node: Basic High Level1129414
-Ref: figure-general-flow1129686
-Ref: figure-process-flow1130285
-Ref: Basic High Level-Footnote-11133514
-Node: Basic Data Typing1133699
-Node: Glossary1137054
-Node: Copying1162285
-Node: GNU Free Documentation License1199841
-Node: Index1224977
+Node: V7/SVR3.11009746
+Node: SVR41012066
+Node: POSIX1013508
+Node: BTL1014894
+Node: POSIX/GNU1015628
+Node: Feature History1021227
+Node: Common Extensions1034339
+Node: Ranges and Locales1035651
+Ref: Ranges and Locales-Footnote-11040268
+Ref: Ranges and Locales-Footnote-21040295
+Ref: Ranges and Locales-Footnote-31040529
+Node: Contributors1040750
+Node: Installation1046101
+Node: Gawk Distribution1046995
+Node: Getting1047479
+Node: Extracting1048305
+Node: Distribution contents1049997
+Node: Unix Installation1055718
+Node: Quick Installation1056335
+Node: Additional Configuration Options1058781
+Node: Configuration Philosophy1060517
+Node: Non-Unix Installation1062871
+Node: PC Installation1063329
+Node: PC Binary Installation1064640
+Node: PC Compiling1066488
+Node: PC Testing1069448
+Node: PC Using1070624
+Node: Cygwin1074792
+Node: MSYS1075601
+Node: VMS Installation1076115
+Node: VMS Compilation1076911
+Ref: VMS Compilation-Footnote-11078163
+Node: VMS Dynamic Extensions1078221
+Node: VMS Installation Details1079594
+Node: VMS Running1081845
+Node: VMS GNV1084679
+Node: VMS Old Gawk1085402
+Node: Bugs1085872
+Node: Other Versions1089790
+Node: Notes1095874
+Node: Compatibility Mode1096674
+Node: Additions1097457
+Node: Accessing The Source1098384
+Node: Adding Code1099824
+Node: New Ports1105869
+Node: Derived Files1110004
+Ref: Derived Files-Footnote-11115325
+Ref: Derived Files-Footnote-21115359
+Ref: Derived Files-Footnote-31115959
+Node: Future Extensions1116057
+Node: Implementation Limitations1116640
+Node: Extension Design1117888
+Node: Old Extension Problems1119042
+Ref: Old Extension Problems-Footnote-11120550
+Node: Extension New Mechanism Goals1120607
+Ref: Extension New Mechanism Goals-Footnote-11123972
+Node: Extension Other Design Decisions1124158
+Node: Extension Future Growth1126264
+Node: Old Extension Mechanism1127100
+Node: Basic Concepts1128840
+Node: Basic High Level1129521
+Ref: figure-general-flow1129793
+Ref: figure-process-flow1130392
+Ref: Basic High Level-Footnote-11133621
+Node: Basic Data Typing1133806
+Node: Glossary1137161
+Node: Copying1162392
+Node: GNU Free Documentation License1199948
+Node: Index1225084
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index f8b58bd8..4dac41dc 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -34066,12 +34066,20 @@ which follows the POSIX specification.  Many long-time @command{awk}
 users learned @command{awk} programming with the original @command{awk}
 implementation in Version 7 Unix.  (This implementation was the basis for
 @command{awk} in Berkeley Unix, through 4.3-Reno.  Subsequent versions
-of Berkeley Unix, and some systems derived from 4.4BSD-Lite, use various
+of Berkeley Unix, and some systems derived from 4.4BSD-Lite, used various
 versions of @command{gawk} for their @command{awk}.)  This @value{CHAPTER}
 briefly describes the evolution of the @command{awk} language, with
 cross-references to other parts of the @value{DOCUMENT} where you can
 find more information.
 
+@ifset FOR_PRINT
+To save space, we have omitted
+information on the history of features in @command{gawk} from this
+edition. You can find it in the
+@uref{http://www.gnu.org/software/gawk/manual/html_node/Feature-History.html,
+online documentation}.
+@end ifset
+
 @menu
 * V7/SVR3.1::                   The major changes between V7 and System V
                                 Release 3.1.
@@ -34661,6 +34669,8 @@ GCC for VAX and Alpha has not been tested for a while.
 @c ENDOFRANGE exgnot
 @c ENDOFRANGE posnot
 
+@c This does not need to be in the formal book.
+@ifclear FOR_PRINT
 @node Feature History
 @appendixsec History of @command{gawk} Features
 
@@ -34825,9 +34835,10 @@ The @code{next file} statement became @code{nextfile}
 (@pxref{Nextfile Statement}).
 
 @item
-The @code{fflush()} function from the
-Bell Laboratories research version of @command{awk}
-(@pxref{I/O Functions}).
+The @code{fflush()} function from
+Brian Kernighan's @command{awk}
+(then at Bell Laboratories;
+@pxref{I/O Functions}).
 
 @item
 New command line options:
@@ -34840,9 +34851,9 @@ the original Version 7 Unix version of @command{awk}
 (@pxref{V7/SVR3.1}).
 
 @item
-The @option{-m} option from the
-Bell Laboratories research version of @command{awk}
-This was later removed.
+The @option{-m} option from Brian Kernighan's @command{awk}.  (He was
+still at Bell Laboratories at the time.)  This was later removed from
+both his @command{awk} and from @command{gawk}.
 
 @item
 The @option{--re-interval} option to provide interval expressions in regexps
@@ -34859,6 +34870,7 @@ The use of GNU Autoconf to control the configuration process
 
 @item
 Amiga support.
+This has since been removed.
 
 @end itemize
 
@@ -34995,7 +35007,8 @@ BeOS support. This was later removed.
 Tandem support. This was later removed.
 
 @item
-The Atari port became officially unsupported.
+The Atari port became officially unsupported and was
+later removed entirely.
 
 @item
 The source code changed to use ISO C standard-style function definitions.
@@ -35088,7 +35101,7 @@ flush all open output redirections
 @item
 The @code{isarray()}
 function which distinguishes if an item is an array
-or not, to make it possible to traverse multidimensional arrays
+or not, to make it possible to traverse arrays of arrays
 (@pxref{Type Functions}).
 
 @item
@@ -35266,6 +35279,7 @@ The dynamic extension interface was completely redone
 @end itemize
 
 @c XXX ADD MORE STUFF HERE
+@end ifclear
 
 @node Common Extensions
 @appendixsec Common Extensions Summary
@@ -35492,8 +35506,8 @@ provided the initial port to OS/2 and its documentation.
 Michal Jaegermann
 provided the port to Atari systems and its documentation.
 (This port is no longer supported.)
-He continues to provide portability checking with DEC Alpha
-systems, and has done a lot of work to make sure @command{gawk}
+He continues to provide portability checking,
+and has done a lot of work to make sure @command{gawk}
 works on non-32-bit systems.
 
 @item
@@ -35612,7 +35626,7 @@ The modifications to convert @command{gawk}
 into a byte-code interpreter, including the debugger.
 
 @item
-The addition of true multidimensional arrays.
+The addition of true arrays of arrays.
 @ref{Arrays of Arrays}.
 
 @item
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index c37034e3..6a07c2db 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -33210,12 +33210,20 @@ which follows the POSIX specification.  Many long-time @command{awk}
 users learned @command{awk} programming with the original @command{awk}
 implementation in Version 7 Unix.  (This implementation was the basis for
 @command{awk} in Berkeley Unix, through 4.3-Reno.  Subsequent versions
-of Berkeley Unix, and some systems derived from 4.4BSD-Lite, use various
+of Berkeley Unix, and some systems derived from 4.4BSD-Lite, used various
 versions of @command{gawk} for their @command{awk}.)  This @value{CHAPTER}
 briefly describes the evolution of the @command{awk} language, with
 cross-references to other parts of the @value{DOCUMENT} where you can
 find more information.
 
+@ifset FOR_PRINT
+To save space, we have omitted
+information on the history of features in @command{gawk} from this
+edition. You can find it in the
+@uref{http://www.gnu.org/software/gawk/manual/html_node/Feature-History.html,
+online documentation}.
+@end ifset
+
 @menu
 * V7/SVR3.1::                   The major changes between V7 and System V
                                 Release 3.1.
@@ -33805,6 +33813,8 @@ GCC for VAX and Alpha has not been tested for a while.
 @c ENDOFRANGE exgnot
 @c ENDOFRANGE posnot
 
+@c This does not need to be in the formal book.
+@ifclear FOR_PRINT
 @node Feature History
 @appendixsec History of @command{gawk} Features
 
@@ -33969,9 +33979,10 @@ The @code{next file} statement became @code{nextfile}
 (@pxref{Nextfile Statement}).
 
 @item
-The @code{fflush()} function from the
-Bell Laboratories research version of @command{awk}
-(@pxref{I/O Functions}).
+The @code{fflush()} function from
+Brian Kernighan's @command{awk}
+(then at Bell Laboratories;
+@pxref{I/O Functions}).
 
 @item
 New command line options:
@@ -33984,9 +33995,9 @@ the original Version 7 Unix version of @command{awk}
 (@pxref{V7/SVR3.1}).
 
 @item
-The @option{-m} option from the
-Bell Laboratories research version of @command{awk}
-This was later removed.
+The @option{-m} option from Brian Kernighan's @command{awk}.  (He was
+still at Bell Laboratories at the time.)  This was later removed from
+both his @command{awk} and from @command{gawk}.
 
 @item
 The @option{--re-interval} option to provide interval expressions in regexps
@@ -34003,6 +34014,7 @@ The use of GNU Autoconf to control the configuration process
 
 @item
 Amiga support.
+This has since been removed.
 
 @end itemize
 
@@ -34139,7 +34151,8 @@ BeOS support. This was later removed.
 Tandem support. This was later removed.
 
 @item
-The Atari port became officially unsupported.
+The Atari port became officially unsupported and was
+later removed entirely.
 
 @item
 The source code changed to use ISO C standard-style function definitions.
@@ -34232,7 +34245,7 @@ flush all open output redirections
 @item
 The @code{isarray()}
 function which distinguishes if an item is an array
-or not, to make it possible to traverse multidimensional arrays
+or not, to make it possible to traverse arrays of arrays
 (@pxref{Type Functions}).
 
 @item
@@ -34410,6 +34423,7 @@ The dynamic extension interface was completely redone
 @end itemize
 
 @c XXX ADD MORE STUFF HERE
+@end ifclear
 
 @node Common Extensions
 @appendixsec Common Extensions Summary
@@ -34636,8 +34650,8 @@ provided the initial port to OS/2 and its documentation.
 Michal Jaegermann
 provided the port to Atari systems and its documentation.
 (This port is no longer supported.)
-He continues to provide portability checking with DEC Alpha
-systems, and has done a lot of work to make sure @command{gawk}
+He continues to provide portability checking,
+and has done a lot of work to make sure @command{gawk}
 works on non-32-bit systems.
 
 @item
@@ -34756,7 +34770,7 @@ The modifications to convert @command{gawk}
 into a byte-code interpreter, including the debugger.
 
 @item
-The addition of true multidimensional arrays.
+The addition of true arrays of arrays.
 @ref{Arrays of Arrays}.
 
 @item