From 4ed8e81f87aadda3521a967b5c5e714bf027194b Mon Sep 17 00:00:00 2001 From: "Arnold D. Robbins" Date: Sun, 9 Dec 2012 20:04:03 +0200 Subject: Fix awkforai.txt to avoid copyright issues. --- doc/gawk.texi | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'doc/gawk.texi') diff --git a/doc/gawk.texi b/doc/gawk.texi index 63e9cbd6..ec83964d 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -27565,7 +27565,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 -- cgit v1.2.3 From 049873587037f41580a4759a7b903719d5c85b68 Mon Sep 17 00:00:00 2001 From: "Arnold D. Robbins" Date: Sun, 9 Dec 2012 21:57:42 +0200 Subject: Allow only ASCII letters for a an extension name. --- doc/gawk.texi | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) (limited to 'doc/gawk.texi') diff --git a/doc/gawk.texi b/doc/gawk.texi index ab26df28..77f8b527 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -28721,7 +28721,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{}} +@multitable {@code{memset()}, @code{memcpy()}} {@code{}} @headitem C Entity @tab Header File @item @code{FILE} @tab @code{} @item @code{NULL} @tab @code{} @@ -29109,6 +29109,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. @@ -29116,6 +29121,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}. -- cgit v1.2.3