aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gawktexi.in
diff options
context:
space:
mode:
Diffstat (limited to 'doc/gawktexi.in')
-rw-r--r--doc/gawktexi.in11
1 files changed, 11 insertions, 0 deletions
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 991136c3..dde1aed2 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -29049,6 +29049,17 @@ $ @kbd{gawk -f case_fold_compare.awk}
@print{} n N O o p P Q q r R S s t T u U V v w W X x y Y z Z
@end example
+@quotation NOTE
+`Under the hood,'' @command{gawk} uses the C library @code{qsort()}
+function to manage the sorting. @code{qsort()} can call itself
+recursively. This means that when you write a comparison function,
+you should be careful to avoid the use of global variables and arrays;
+use only local variables and arrays that you declare as additional
+parameters to the comparison function. Otherwise, you are likely to
+cause unintentional memory corruption in your global arrays and possibly
+cause @command{gawk} itself to fail.
+@end quotation
+
@node Two-way I/O
@section Two-Way Communications with Another Process