aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/ChangeLog4
-rw-r--r--doc/gawk.info168
-rw-r--r--doc/gawk.texi38
-rw-r--r--doc/gawktexi.in38
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