Merge branch 'master' into array-iface

1 files changed, 11 insertions, 2 deletions

diff --git a/doc/gawk.texi b/doc/gawk.texi
index 5b6ea931..fca7cebb 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -28722,7 +28722,7 @@ The following types and/or macros and/or functions are referenced
 in @file{gawkapi.h}.  For correct use, you must therefore include the
 corresponding standard header file @emph{before} including @file{gawkapi.h}:
 
-@multitable {C Entity} {@code{<sys/types.h>}}
+@multitable {@code{memset()}, @code{memcpy()}} {@code{<sys/types.h>}}
 @headitem C Entity @tab Header File
 @item @code{FILE} @tab @code{<stdio.h>}
 @item @code{NULL} @tab @code{<stddef.h>}
@@ -29110,6 +29110,11 @@ The name of the new function.
 @command{awk} level code calls the function by this name.
 This is a regular C string.
 
+Function names must obey the rules for @command{awk}
+identifiers. That is, they must begin with either a letter
+or an underscore, which may be followed by any number of
+letters, digits, and underscores.
+
 @item awk_value_t *(*function)(int num_actual_args, awk_value_t *result);
 This is a pointer to the C function that provides the desired
 functionality.
@@ -29117,6 +29122,9 @@ The function must fill in the result with either a number
 or a string. @command{awk} takes ownership of any string memory.
 As mentioned earlier, string memory @strong{must} come from @code{malloc()}.
 
+The @code{num_actual_args} argument tells the C function how many
+actual parameters were passed from the calling @command{awk} code.
+
 The function must return the value of @code{result}.
 This is for the convenience of the calling code inside @command{gawk}.
 
@@ -33114,7 +33122,8 @@ as a list of things that the POSIX standard should describe but does not.
 
 @cindex artificial intelligence@comma{} @command{gawk} and
 @item doc/awkforai.txt
-A short article describing why @command{gawk} is a good language for
+Pointers to the original draft of
+a short article describing why @command{gawk} is a good language for
 Artificial Intelligence (AI) programming.
 
 @item doc/bc_notes