Fix assertion error in sorted loops for SYMTAB/FUNCTAB.

1 files changed, 13 insertions, 0 deletions

diff --git a/doc/gawk.texi b/doc/gawk.texi
index 5e344e52..1a41f880 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -17183,6 +17183,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.
@@ -18303,6 +18309,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