From 1963e23d0a9b13974f2e5a77fdea03d50dc9c654 Mon Sep 17 00:00:00 2001
From: "Arnold D. Robbins" <arnold@skeeve.com>
Date: Tue, 30 May 2017 10:54:06 +0300
Subject: Document PROCINFO["argv"].

---
 doc/gawk.texi | 44 +++++++++++++++++++++++++-------------------
 1 file changed, 25 insertions(+), 19 deletions(-)

(limited to 'doc/gawk.texi')

diff --git a/doc/gawk.texi b/doc/gawk.texi
index e7d75521..c344acfb 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -4981,25 +4981,6 @@ function names added by @command{gawk} after the code was written.
 Standard @command{awk} built-in functions, such as @code{sin()} or
 @code{substr()} are @emph{not} shadowed in this way.
 
-The @code{PROCINFO["argv"]} array contains all of the command-line arguments
-(after glob expansion and redirection processing on platforms where that must
-be done manually by the program) with subscripts ranging from 0 through
-@code{argc} @minus{} 1.  For example, @code{PROCINFO["argv"][0]} will contain
-the name by which @command{gawk} was invoked.  Here is an example of how this
-feature may be used:
-
-@example
-gawk '
-BEGIN @{
-        for (i = 0; i < length(PROCINFO["argv"]); i++)
-                print i, PROCINFO["argv"][i]
-@}'
-@end example
-
-Please note that this differs from the standard @code{ARGV} array which does
-not include command-line arguments that have already been processed by
-@command{gawk} (@pxref{ARGC and ARGV}).
-
 @end ignore
 
 @node Invoking Summary
@@ -15484,6 +15465,27 @@ The following elements (listed alphabetically)
 are guaranteed to be available:
 
 @table @code
+@item PROCINFO["argv"]
+@cindex command line arguments, @code{PROCINFO["argv"}
+The @code{PROCINFO["argv"]} array contains all of the command-line arguments
+(after glob expansion and redirection processing on platforms where that must
+be done manually by the program) with subscripts ranging from 0 through
+@code{argc} @minus{} 1.  For example, @code{PROCINFO["argv"][0]} will contain
+the name by which @command{gawk} was invoked.  Here is an example of how this
+feature may be used:
+
+@example
+gawk '
+BEGIN @{
+        for (i = 0; i < length(PROCINFO["argv"]); i++)
+                print i, PROCINFO["argv"][i]
+@}'
+@end example
+
+Please note that this differs from the standard @code{ARGV} array which does
+not include command-line arguments that have already been processed by
+@command{gawk} (@pxref{ARGC and ARGV}).
+
 @cindex effective group ID of @command{gawk} user
 @item PROCINFO["egid"]
 The value of the @code{getegid()} system call.
@@ -38011,6 +38013,10 @@ Changes to @code{ENVIRON} are reflected into @command{gawk}'s
 environment and that of programs that it runs.
 @xref{Auto-set}.
 
+@item
+The @code{PROCINFO["argv"} array.
+@xref{Auto-set}.
+
 @item
 The @option{--pretty-print} option no longer runs the @command{awk}
 program too.
-- 
cgit v1.2.3