aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog5
-rw-r--r--doc/gawk.info201
-rw-r--r--doc/gawk.texi101
-rw-r--r--doc/gawktexi.in101
-rw-r--r--doc/wordlist10
-rw-r--r--doc/wordlist27
6 files changed, 314 insertions, 111 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 86c1d130..e6dd8ea0 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2017-08-16 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawktexi.in: Update history of features appendix section.
+ * wordlist, worldlist2: Add more words.
+
2017-08-13 Arnold D. Robbins <arnold@skeeve.com>
* gawktexi.in, gawk.1, awkcard.in: Update versions and
diff --git a/doc/gawk.info b/doc/gawk.info
index 9031d5e7..53d45a11 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -28034,9 +28034,9 @@ POSIX 'awk', in the order they were added to 'gawk'.
- MIPS RiscOS
- - MS-DOS with Microsoft Compiler
+ - MS-DOS with the Microsoft Compiler
- - MS-Windows with Microsoft Compiler
+ - MS-Windows with the Microsoft Compiler
- NeXT
@@ -28090,23 +28090,32 @@ POSIX 'awk', in the order they were added to 'gawk'.
* Support for Ultrix was removed.
- Version 4.2 introduced the following changes:
+ Version 4.2 of 'gawk' introduced the following changes:
* Changes to 'ENVIRON' are reflected into 'gawk''s environment and
that of programs that it runs. *Note Auto-set::.
- * The 'PROCINFO["argv"' array. *Note Auto-set::.
+ * 'FIELDWIDTHS' was enhanced to allow skipping characters before
+ assigning a value to a field (*note Splitting By Content::).
- * The '--pretty-print' option no longer runs the 'awk' program too.
- *Note Options::.
-
- * The 'igawk' program and its manual page are no longer installed
- when 'gawk' is built. *Note Igawk Program::.
+ * The 'PROCINFO["argv"]' array. *Note Auto-set::.
* The maximum number of hexadecimal digits in '\x' escapes is now
two. *Note Escape Sequences::.
- * Nonfatal output with 'print' and 'printf'. *Note Nonfatal::.
+ * Strongly typed regexp constants of the form '@/.../' (*note Strong
+ Regexp Constants::).
+
+ * The bitwise functions changed, making negative arguments into a
+ fatal error (*note Bitwise Functions::).
+
+ * The 'mktime()' function now accepts an optional second argument
+ (*note Time Functions::).
+
+ * The 'typeof()' function (*note Type Functions::).
+
+ * Optimizations are enabled by default. Use '-s' / '--no-optimize'
+ to disable optimizations.
* For many years, POSIX specified that default field splitting only
allowed spaces and tabs to separate fields, and this was how 'gawk'
@@ -28114,10 +28123,44 @@ POSIX 'awk', in the order they were added to 'gawk'.
historical behavior, and now default field splitting with '--posix'
also allows newlines to separate fields.
+ * Nonfatal output with 'print' and 'printf'. *Note Nonfatal::.
+
+ * Retryable I/O via 'PROCINFO[INPUT-FILE, "RETRY"]'; (*note Retrying
+ Input::).
+
+ * Changes to the pretty-printer (*note Profiling::):
+
+ - The '--pretty-print' option no longer runs the 'awk' program
+ too.
+
+ - Comments in the source program are preserved and placed into
+ the output file.
+
+ - Explicit parentheses for expressions in the input are
+ preserved in the generated output.
+
+ * Improvements to the extension API (*note Dynamic Extensions::):
+
+ - The 'get_file()' function to access open redirections.
+
+ - The 'nonfatal()' function for generating nonfatal error
+ messages.
+
+ - Support for GMP and MPFR values.
+
+ - Input parsers can now override the default field parsing
+ mechanism by specifying explicit locations.
+
* Support for MirBSD was removed.
* Support for GNU/Linux on Alpha was removed.
+ * Shell startup files are supplied with the distribution and
+ installed by 'make install' (*note Shell Startup Files::).
+
+ * The 'igawk' program and its manual page are no longer installed
+ when 'gawk' is built. *Note Igawk Program::.
+

File: gawk.info, Node: Common Extensions, Next: Ranges and Locales, Prev: Feature History, Up: Language History
@@ -36304,74 +36347,74 @@ Node: POSIX1113185
Node: BTL1114564
Node: POSIX/GNU1115293
Node: Feature History1121071
-Node: Common Extensions1135436
-Node: Ranges and Locales1136719
-Ref: Ranges and Locales-Footnote-11141335
-Ref: Ranges and Locales-Footnote-21141362
-Ref: Ranges and Locales-Footnote-31141597
-Node: Contributors1141818
-Node: History summary1147446
-Node: Installation1148826
-Node: Gawk Distribution1149770
-Node: Getting1150254
-Node: Extracting1151215
-Node: Distribution contents1152853
-Node: Unix Installation1159195
-Node: Quick Installation1159877
-Node: Shell Startup Files1162291
-Node: Additional Configuration Options1163380
-Node: Configuration Philosophy1165369
-Node: Non-Unix Installation1167738
-Node: PC Installation1168198
-Node: PC Binary Installation1169036
-Node: PC Compiling1169471
-Node: PC Using1170588
-Node: Cygwin1173633
-Node: MSYS1174403
-Node: VMS Installation1174904
-Node: VMS Compilation1175695
-Ref: VMS Compilation-Footnote-11176924
-Node: VMS Dynamic Extensions1176982
-Node: VMS Installation Details1178667
-Node: VMS Running1180920
-Node: VMS GNV1185199
-Node: VMS Old Gawk1185934
-Node: Bugs1186405
-Node: Bug address1187068
-Node: Usenet1189465
-Node: Maintainers1190242
-Node: Other Versions1191503
-Node: Installation summary1198087
-Node: Notes1199122
-Node: Compatibility Mode1199987
-Node: Additions1200769
-Node: Accessing The Source1201694
-Node: Adding Code1203129
-Node: New Ports1209347
-Node: Derived Files1213835
-Ref: Derived Files-Footnote-11219320
-Ref: Derived Files-Footnote-21219355
-Ref: Derived Files-Footnote-31219953
-Node: Future Extensions1220067
-Node: Implementation Limitations1220725
-Node: Extension Design1221908
-Node: Old Extension Problems1223062
-Ref: Old Extension Problems-Footnote-11224580
-Node: Extension New Mechanism Goals1224637
-Ref: Extension New Mechanism Goals-Footnote-11228001
-Node: Extension Other Design Decisions1228190
-Node: Extension Future Growth1230303
-Node: Old Extension Mechanism1231139
-Node: Notes summary1232902
-Node: Basic Concepts1234084
-Node: Basic High Level1234765
-Ref: figure-general-flow1235047
-Ref: figure-process-flow1235732
-Ref: Basic High Level-Footnote-11239033
-Node: Basic Data Typing1239218
-Node: Glossary1242546
-Node: Copying1274493
-Node: GNU Free Documentation License1312032
-Node: Index1337150
+Node: Common Extensions1136930
+Node: Ranges and Locales1138213
+Ref: Ranges and Locales-Footnote-11142829
+Ref: Ranges and Locales-Footnote-21142856
+Ref: Ranges and Locales-Footnote-31143091
+Node: Contributors1143312
+Node: History summary1148940
+Node: Installation1150320
+Node: Gawk Distribution1151264
+Node: Getting1151748
+Node: Extracting1152709
+Node: Distribution contents1154347
+Node: Unix Installation1160689
+Node: Quick Installation1161371
+Node: Shell Startup Files1163785
+Node: Additional Configuration Options1164874
+Node: Configuration Philosophy1166863
+Node: Non-Unix Installation1169232
+Node: PC Installation1169692
+Node: PC Binary Installation1170530
+Node: PC Compiling1170965
+Node: PC Using1172082
+Node: Cygwin1175127
+Node: MSYS1175897
+Node: VMS Installation1176398
+Node: VMS Compilation1177189
+Ref: VMS Compilation-Footnote-11178418
+Node: VMS Dynamic Extensions1178476
+Node: VMS Installation Details1180161
+Node: VMS Running1182414
+Node: VMS GNV1186693
+Node: VMS Old Gawk1187428
+Node: Bugs1187899
+Node: Bug address1188562
+Node: Usenet1190959
+Node: Maintainers1191736
+Node: Other Versions1192997
+Node: Installation summary1199581
+Node: Notes1200616
+Node: Compatibility Mode1201481
+Node: Additions1202263
+Node: Accessing The Source1203188
+Node: Adding Code1204623
+Node: New Ports1210841
+Node: Derived Files1215329
+Ref: Derived Files-Footnote-11220814
+Ref: Derived Files-Footnote-21220849
+Ref: Derived Files-Footnote-31221447
+Node: Future Extensions1221561
+Node: Implementation Limitations1222219
+Node: Extension Design1223402
+Node: Old Extension Problems1224556
+Ref: Old Extension Problems-Footnote-11226074
+Node: Extension New Mechanism Goals1226131
+Ref: Extension New Mechanism Goals-Footnote-11229495
+Node: Extension Other Design Decisions1229684
+Node: Extension Future Growth1231797
+Node: Old Extension Mechanism1232633
+Node: Notes summary1234396
+Node: Basic Concepts1235578
+Node: Basic High Level1236259
+Ref: figure-general-flow1236541
+Ref: figure-process-flow1237226
+Ref: Basic High Level-Footnote-11240527
+Node: Basic Data Typing1240712
+Node: Glossary1244040
+Node: Copying1275987
+Node: GNU Free Documentation License1313526
+Node: Index1338644

End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 9c36c107..20c82251 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -37586,7 +37586,9 @@ I've tried to follow this general order, esp.@: for the 3.0 and 3.1 sections:
new keywords
new command-line options
behavioral changes
- new ports
+ extension API changes
+ new / deprecated / removed ports
+ installation time stuff
Within each category, be alphabetical.
@end ignore
@@ -38098,10 +38100,10 @@ Cray
MIPS RiscOS
@item
-MS-DOS with Microsoft Compiler
+MS-DOS with the Microsoft Compiler
@item
-MS-Windows with Microsoft Compiler
+MS-Windows with the Microsoft Compiler
@item
NeXT
@@ -38186,7 +38188,7 @@ Support for Ultrix was removed.
@end itemize
-Version 4.2 introduced the following changes:
+Version 4.2 of @command{gawk} introduced the following changes:
@itemize @bullet
@item
@@ -38195,18 +38197,26 @@ environment and that of programs that it runs.
@xref{Auto-set}.
@item
-The @code{PROCINFO["argv"} array.
+@code{FIELDWIDTHS} was enhanced to allow skipping characters
+before assigning a value to a field
+(@pxref{Splitting By Content}).
+
+@item
+The @code{PROCINFO["argv"]} array.
@xref{Auto-set}.
@item
-The @option{--pretty-print} option no longer runs the @command{awk}
-program too.
-@xref{Options}.
+The maximum number of hexadecimal digits in @samp{\x} escapes
+is now two.
+@xref{Escape Sequences}.
@item
-The @command{igawk} program and its manual page are no longer
-installed when @command{gawk} is built.
-@xref{Igawk Program}.
+Strongly typed regexp constants of the form @samp{@@/@dots{}/}
+(@pxref{Strong Regexp Constants}).
+
+@item
+The bitwise functions changed, making negative arguments into
+a fatal error (@pxref{Bitwise Functions}).
@ifset INTDIV
@item
@@ -38215,13 +38225,16 @@ The @code{intdiv0()} function.
@end ifset
@item
-The maximum number of hexadecimal digits in @samp{\x} escapes
-is now two.
-@xref{Escape Sequences}.
+The @code{mktime()} function now accepts an optional
+second argument
+(@pxref{Time Functions}).
@item
-Nonfatal output with @code{print} and @code{printf}.
-@xref{Nonfatal}.
+The @code{typeof()} function (@pxref{Type Functions}).
+
+@item
+Optimizations are enabled by default. Use @option{-s} /
+@option{--no-optimize} to disable optimizations.
@item
For many years, POSIX specified that default field splitting
@@ -38232,10 +38245,66 @@ field splitting with @option{--posix} also allows newlines to
separate fields.
@item
+Nonfatal output with @code{print} and @code{printf}.
+@xref{Nonfatal}.
+
+@item
+Retryable I/O via @code{PROCINFO[@var{input-file}, "RETRY"]};
+(@pxref{Retrying Input}).
+
+@item
+Changes to the pretty-printer (@pxref{Profiling}):
+
+@c nested table
+@itemize @value{MINUS}
+@item
+The @option{--pretty-print} option no longer runs the @command{awk}
+program too.
+
+@item
+Comments in the source program are preserved and placed into the
+output file.
+
+@item
+Explicit parentheses for expressions
+in the input are preserved in the generated output.
+@end itemize
+
+@item
+Improvements to the extension API
+(@pxref{Dynamic Extensions}):
+
+@c nested
+@itemize @value{MINUS}
+@item
+The @code{get_file()} function to access open redirections.
+
+@item
+The @code{nonfatal()} function for generating nonfatal error messages.
+
+@item
+Support for GMP and MPFR values.
+
+@item
+Input parsers can now override the default field parsing mechanism
+by specifying explicit locations.
+@end itemize
+
+@item
Support for MirBSD was removed.
@item
Support for GNU/Linux on Alpha was removed.
+
+@item
+Shell startup files are supplied with the distribution and
+installed by @samp{make install} (@pxref{Shell Startup Files}).
+
+@item
+The @command{igawk} program and its manual page are no longer
+installed when @command{gawk} is built.
+@xref{Igawk Program}.
+
@end itemize
@c XXX ADD MORE STUFF HERE
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 68f0510c..94001fac 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -36600,7 +36600,9 @@ I've tried to follow this general order, esp.@: for the 3.0 and 3.1 sections:
new keywords
new command-line options
behavioral changes
- new ports
+ extension API changes
+ new / deprecated / removed ports
+ installation time stuff
Within each category, be alphabetical.
@end ignore
@@ -37112,10 +37114,10 @@ Cray
MIPS RiscOS
@item
-MS-DOS with Microsoft Compiler
+MS-DOS with the Microsoft Compiler
@item
-MS-Windows with Microsoft Compiler
+MS-Windows with the Microsoft Compiler
@item
NeXT
@@ -37200,7 +37202,7 @@ Support for Ultrix was removed.
@end itemize
-Version 4.2 introduced the following changes:
+Version 4.2 of @command{gawk} introduced the following changes:
@itemize @bullet
@item
@@ -37209,18 +37211,26 @@ environment and that of programs that it runs.
@xref{Auto-set}.
@item
-The @code{PROCINFO["argv"} array.
+@code{FIELDWIDTHS} was enhanced to allow skipping characters
+before assigning a value to a field
+(@pxref{Splitting By Content}).
+
+@item
+The @code{PROCINFO["argv"]} array.
@xref{Auto-set}.
@item
-The @option{--pretty-print} option no longer runs the @command{awk}
-program too.
-@xref{Options}.
+The maximum number of hexadecimal digits in @samp{\x} escapes
+is now two.
+@xref{Escape Sequences}.
@item
-The @command{igawk} program and its manual page are no longer
-installed when @command{gawk} is built.
-@xref{Igawk Program}.
+Strongly typed regexp constants of the form @samp{@@/@dots{}/}
+(@pxref{Strong Regexp Constants}).
+
+@item
+The bitwise functions changed, making negative arguments into
+a fatal error (@pxref{Bitwise Functions}).
@ifset INTDIV
@item
@@ -37229,13 +37239,16 @@ The @code{intdiv0()} function.
@end ifset
@item
-The maximum number of hexadecimal digits in @samp{\x} escapes
-is now two.
-@xref{Escape Sequences}.
+The @code{mktime()} function now accepts an optional
+second argument
+(@pxref{Time Functions}).
@item
-Nonfatal output with @code{print} and @code{printf}.
-@xref{Nonfatal}.
+The @code{typeof()} function (@pxref{Type Functions}).
+
+@item
+Optimizations are enabled by default. Use @option{-s} /
+@option{--no-optimize} to disable optimizations.
@item
For many years, POSIX specified that default field splitting
@@ -37246,10 +37259,66 @@ field splitting with @option{--posix} also allows newlines to
separate fields.
@item
+Nonfatal output with @code{print} and @code{printf}.
+@xref{Nonfatal}.
+
+@item
+Retryable I/O via @code{PROCINFO[@var{input-file}, "RETRY"]};
+(@pxref{Retrying Input}).
+
+@item
+Changes to the pretty-printer (@pxref{Profiling}):
+
+@c nested table
+@itemize @value{MINUS}
+@item
+The @option{--pretty-print} option no longer runs the @command{awk}
+program too.
+
+@item
+Comments in the source program are preserved and placed into the
+output file.
+
+@item
+Explicit parentheses for expressions
+in the input are preserved in the generated output.
+@end itemize
+
+@item
+Improvements to the extension API
+(@pxref{Dynamic Extensions}):
+
+@c nested
+@itemize @value{MINUS}
+@item
+The @code{get_file()} function to access open redirections.
+
+@item
+The @code{nonfatal()} function for generating nonfatal error messages.
+
+@item
+Support for GMP and MPFR values.
+
+@item
+Input parsers can now override the default field parsing mechanism
+by specifying explicit locations.
+@end itemize
+
+@item
Support for MirBSD was removed.
@item
Support for GNU/Linux on Alpha was removed.
+
+@item
+Shell startup files are supplied with the distribution and
+installed by @samp{make install} (@pxref{Shell Startup Files}).
+
+@item
+The @command{igawk} program and its manual page are no longer
+installed when @command{gawk} is built.
+@xref{Igawk Program}.
+
@end itemize
@c XXX ADD MORE STUFF HERE
diff --git a/doc/wordlist b/doc/wordlist
index 97d4fb22..378c2b46 100644
--- a/doc/wordlist
+++ b/doc/wordlist
@@ -240,6 +240,7 @@ IFSOCK
IGNORECASE
INPLACE
INT
+INTDIV
IPv
ISBLK
ISBN
@@ -298,6 +299,7 @@ MMK
MMS
MP
MPFR
+MPZ
MSC
MSEC
MSG
@@ -411,6 +413,7 @@ PowerPC
Pr
Pre
Preopened
+Preprocessor
Prestandard
Printf
Prolog
@@ -442,6 +445,7 @@ Regex
Regexp
Regexps
Reimplementing
+Retryable
Revout
RiscOS
Ritchie
@@ -668,6 +672,7 @@ awkcard
awkforai
awkgram
awklib
+awknum
awkp
awkprof
awks
@@ -929,6 +934,7 @@ emalloc
embeddable
emory
emph
+emptor
emxomfar
en
encodings
@@ -1105,6 +1111,7 @@ groupsbyuser
grp
gst
gsub
+guerrero
gunzip
gvim
gz
@@ -1222,6 +1229,7 @@ joe
johansen
johnny
joyent
+juan
julie
karl
katie
@@ -1325,6 +1333,7 @@ monthname
moore
mortoneccc
mpfr
+mpz
msg
msgfmt
msgid
@@ -1429,6 +1438,7 @@ nr
nroff
nul
num
+numfields
nums
nusers
nvalue
diff --git a/doc/wordlist2 b/doc/wordlist2
index 0d2db288..9275fdbd 100644
--- a/doc/wordlist2
+++ b/doc/wordlist2
@@ -14,6 +14,7 @@ GitHub
ISBN
Kahrs
Libtool
+Makefile
PCC
PDF
Rebase
@@ -22,10 +23,12 @@ Repo
SVN
TODO
Texinfo
+Uncomment
UsingGit
Workflow
Yehezkel
ac
+apache
api
arnold
arnoldrobbins
@@ -94,6 +97,7 @@ inlineraw
insertcopying
jpdev
kbd
+labelled
libtool
lineannotation
linkcolor
@@ -102,6 +106,7 @@ literallayout
llvm
ltu
ludd
+maintainer's
makeinfo
mpfr
multiplestates
@@ -127,6 +132,7 @@ regexp
repo
repo's
samp
+savannah
scm
se
setchapternewpage
@@ -152,6 +158,7 @@ texi
texinfo
thischapter
thispage
+tinycc
titlepage
tmp
toto
generated by cgit v1.2.3 (git 2.25.1) at 2025-05-07 07:11:24 +0000