Improve API regex support.

2 files changed, 14 insertions, 1 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 2e08deff..ddf454f0 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,5 +1,10 @@
 2016-12-04         Andrew J. Schorr     <aschorr@telemetry-investments.com>
 
+	* gawktexi.in: Remove make_regex and replace it with make_const_regex
+	and make_malloced_regex.
+
+2016-12-04         Andrew J. Schorr     <aschorr@telemetry-investments.com>
+
 	* gawktexi.in: Document new flatten_array_typed API function, and
 	indicate that the old flatten_array function has been superseded.
 
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 17206bce..1450d09d 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -31796,9 +31796,17 @@ This function simply creates a numeric value in the @code{awk_value_t} variable
 pointed to by @code{result}.
 
 @item static inline awk_value_t *
-@itemx make_regex(const char *string, size_t length, awk_value_t *result);
+@itemx make_const_regex(const char *string, size_t length, awk_value_t *result);
+This function creates a strongly typed regexp value by allocating a copy of the string.
+@code{string} is the regular expression of length @code{len}.
+
+@item static inline awk_value_t *
+@itemx make_malloced_regex(const char *string, size_t length, awk_value_t *result);
 This function creates a strongly typed regexp value.
 @code{string} is the regular expression of length @code{len}.
+It expects @code{string} to be a @samp{char *}
+value pointing to data previously obtained from @code{gawk_malloc()}, @code{gawk_calloc()}, or @code{gawk_realloc()}.
+
 @end table
 
 @node Registration Functions