aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gawktexi.in
diff options
context:
space:
mode:
authorArnold D. Robbins <arnold@skeeve.com>2017-11-17 11:09:55 +0200
committerArnold D. Robbins <arnold@skeeve.com>2017-11-17 11:09:55 +0200
commitfac131ce0d9b4cae007f6f84b084973319f97d62 (patch)
treeb9a2304381025c68013594334cebe211e51ae32f /doc/gawktexi.in
parentb4b1162e427f634567e09bda421f947c3c8db9ce (diff)
downloadegawk-fac131ce0d9b4cae007f6f84b084973319f97d62.tar.gz
egawk-fac131ce0d9b4cae007f6f84b084973319f97d62.tar.bz2
egawk-fac131ce0d9b4cae007f6f84b084973319f97d62.zip
Update doc with list of API changes from V1 to V2.
Diffstat (limited to 'doc/gawktexi.in')
-rw-r--r--doc/gawktexi.in43
1 files changed, 42 insertions, 1 deletions
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index a0bb8b73..e1b318ca 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -34344,7 +34344,48 @@ the current version of @command{gawk}.
Fortunately, at the possible expense of some compile-time warnings, the API remains
source-code--compatible with the previous API. The major differences are
the additional members in the @code{awk_ext_func_t} structure, and the
-addition of the third argument to the C implementation function.
+addition of the third argument to the C implementation function
+(@pxref{Extension Functions}).
+
+Here is a list of individual features that changed from version 1 to
+version 2 of the API:
+
+@itemize @bullet
+
+@item
+Numeric values can now have MPFR/MPZ variants
+(@pxref{General Data Types}).
+
+@item
+There are new string types: @code{AWK_REGEX} and @code{AWK_STRNUM}
+(@pxref{General Data Types}).
+
+@item
+The @code{ezalloc()} macro is new
+(@pxref{Memory Allocation Functions}).
+
+@item
+The @code{awk_ext_func_t} structure changed. Instead of
+@code{num_expected_args}, it now has @code{max_expected} and
+@code{min_required}
+(@pxref{Extension Functions}).
+
+@item
+For @code{get_record()}, an input parser can now specify field widths
+(@pxref{Input Parsers}).
+
+@item
+Extensions can now produce nonfatal error messages
+(@pxref{Printing Messages}).
+
+@item
+When flattening an array, you can now specify the index and value types
+(@pxref{Array Functions}).
+
+@item
+The @code{get_file()} API is new
+(@pxref{Redirection API}).
+@end itemize
@node Finding Extensions
@section How @command{gawk} Finds Extensions