aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gawktexi.in
diff options
context:
space:
mode:
Diffstat (limited to 'doc/gawktexi.in')
-rw-r--r--doc/gawktexi.in13
1 files changed, 13 insertions, 0 deletions
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index f2be74ca..fe2cc17c 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -16452,6 +16452,12 @@ which in turn come before all subarrays.
(Subarrays have not been described yet;
@pxref{Arrays of Arrays}.)
+If you choose to use this feature in traversing @code{FUNCTAB}
+(@pxref{Auto-set}), then the order is built-in functions first
+(@pxref{Built-in}), then user-defined functions (@pxref{User-defined})
+next, and finally functions loaded from an extension
+(@pxref{Dynamic Extensions}).
+
@item "@@val_str_asc"
Order by element values in ascending order (rather than by indices). Scalar values are
compared as strings. Subarrays, if present, come out last.
@@ -17572,6 +17578,13 @@ a[2] = "last"
a[3] = "middle"
@end example
+@quotation NOTE
+Due to implementation limitations, you may not use either @code{SYMTAB}
+or @code{FUNCTAB} as arguments to these functions, even if providing a
+second array to use for the actual sorting. Attempting to do so produces
+a fatal error. This restriction may be lifted in the future.
+@end quotation
+
@item @code{gensub(@var{regexp}, @var{replacement}, @var{how}} [@code{, @var{target}}]@code{) #}
@cindexgawkfunc{gensub}
@cindex search and replace in strings