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, 10 insertions, 1 deletions
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 897098c0..3fd1f06c 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -54,7 +54,7 @@
@c applies to and all the info about who's publishing this edition
@c These apply across the board.
-@set UPDATE-MONTH January, 2021
+@set UPDATE-MONTH July, 2021
@set VERSION 5.1
@set PATCHLEVEL 0
@@ -17809,6 +17809,9 @@ You may use them as the first argument, but only if providing a second
array to use for the actual sorting.
@end quotation
+You are allowed to use the same array for both the @var{source} and @var{dest}
+arguments, but doing so only makes sense if you're also supplying the third argument.
+
@item @code{gensub(@var{regexp}, @var{replacement}, @var{how}} [@code{, @var{target}}]@code{) #}
@cindexgawkfunc{gensub}
@cindex search and replace in strings
@@ -28771,6 +28774,12 @@ there is only one copy of the original array elements' data, even though
both arrays use the values.
@end quotation
+You may use the same array for both the first and second arguments to
+@code{asort()} and @code{asorti()}. Doing so only makes sense if you
+are also supplying the third argument, since @command{awk} doesn't
+provide a way to pass that third argument without also passing the first
+and second ones.
+
@c Document It And Call It A Feature. Sigh.
@cindex @command{gawk} @subentry @code{IGNORECASE} variable in
@cindex arrays @subentry sorting @subentry @code{IGNORECASE} variable and