aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog4
-rw-r--r--doc/gawk.texi9
-rw-r--r--doc/gawktexi.in9
3 files changed, 22 insertions, 0 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 4bbc906c..287f2cd1 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2019-01-09 Andrew J. Schorr <aschorr@telemetry-investments.com>
+
+ * gawktexi.in (Undocumented): Discuss typeof's optional 2nd argument.
+
2019-01-08 Arnold D. Robbins <arnold@skeeve.com>
* gawktexi.in (I18N Example): Add more explanation of how to
diff --git a/doc/gawk.texi b/doc/gawk.texi
index e661c6fa..44c00d00 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -4997,6 +4997,15 @@ NaN and Infinity values, instead of the special values @command{gawk}
usually produces, as described in @ref{POSIX Floating Point Problems}.
This is mainly useful for the included unit tests.
+The @code{typeof()} built-in function
+(@pxref{Type Functions})
+takes an optional second array argument that, if present, will be cleared
+and populated with some information about the internal implementation of
+the variable. This can be useful for debugging. At the moment, this
+returns a textual version of the flags for scalar variables, and the
+array back-end implementation type for arrays. This interface is subject
+to change and may not be stable.
+
@end ignore
@node Invoking Summary
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index f8850d9a..ac099ccc 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -4907,6 +4907,15 @@ NaN and Infinity values, instead of the special values @command{gawk}
usually produces, as described in @ref{POSIX Floating Point Problems}.
This is mainly useful for the included unit tests.
+The @code{typeof()} built-in function
+(@pxref{Type Functions})
+takes an optional second array argument that, if present, will be cleared
+and populated with some information about the internal implementation of
+the variable. This can be useful for debugging. At the moment, this
+returns a textual version of the flags for scalar variables, and the
+array back-end implementation type for arrays. This interface is subject
+to change and may not be stable.
+
@end ignore
@node Invoking Summary