aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gawk.1
diff options
context:
space:
mode:
authorArnold D. Robbins <arnold@skeeve.com>2011-03-29 20:51:30 +0200
committerArnold D. Robbins <arnold@skeeve.com>2011-03-29 20:51:30 +0200
commit2400cc5143383a881356a9f55e93b60037d851e5 (patch)
tree3ba75f8b1225bf50e48b4f6c381e7772f1ab6c5b /doc/gawk.1
parent4fe569fb78dd1b25822c16c9cac515a0fc6702a4 (diff)
downloadegawk-2400cc5143383a881356a9f55e93b60037d851e5.tar.gz
egawk-2400cc5143383a881356a9f55e93b60037d851e5.tar.bz2
egawk-2400cc5143383a881356a9f55e93b60037d851e5.zip
Revise array sorting for PROCINFO["sorted_in"].
Diffstat (limited to 'doc/gawk.1')
-rw-r--r--doc/gawk.119
1 files changed, 13 insertions, 6 deletions
diff --git a/doc/gawk.1 b/doc/gawk.1
index 83a91094..ff3c0a20 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -1082,13 +1082,20 @@ system call.
\fBPROCINFO["sorted_in"]\fP
If this element exists in
.BR PROCINFO ,
-.IR "no matter what its value" ,
-then
-.I gawk
-will cause array
+then its value controls the order in which array elements
+are traversed in
.B for
-loops
-to traverse the array indices in sorted order.
+loops.
+Supported values are
+\fB"ascending index string"\fR,
+\fB"ascending index number"\fR,
+\fB"ascending value"\fR,
+\fB"descending index string"\fR,
+\fB"descending index number"\fR,
+\fB"descending value"\fR, and
+\fB"unsorted"\fR.
+The order specification words can be truncated, or omitted (provided
+that at least one is present), or given in any order.
.TP
\fBPROCINFO["version"]\fP
the version of