[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gawk-diffs] [SCM] gawk branch, gawk-4.1-stable, updated. gawk-4.1.0-778
|
From: |
Arnold Robbins |
|
Subject: |
[gawk-diffs] [SCM] gawk branch, gawk-4.1-stable, updated. gawk-4.1.0-778-ged180ef |
|
Date: |
Fri, 18 Dec 2015 08:18:02 +0000 |
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".
The branch, gawk-4.1-stable has been updated
via ed180efd4dd0b6b6ab9195d7eeb6f12666ae7f2a (commit)
from 354ee4e5a78dccc67817c0f223fcc072355d35be (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=ed180efd4dd0b6b6ab9195d7eeb6f12666ae7f2a
commit ed180efd4dd0b6b6ab9195d7eeb6f12666ae7f2a
Author: Arnold D. Robbins <address@hidden>
Date: Fri Dec 18 10:17:45 2015 +0200
Update doc on PROCINFO.
diff --git a/doc/ChangeLog b/doc/ChangeLog
index da3c921..8d1bd7e 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2015-12-18 Arnold D. Robbins <address@hidden>
+
+ * gawk.1: Update description of PROCINFO, and sort it properly.
+ * gawktexi.in: Ditto.
+
2015-11-26 Arnold D. Robbins <address@hidden>
* gawktexi.in: Add "exit" as synonym for "quit" in the
diff --git a/doc/gawk.1 b/doc/gawk.1
index 0c00f3b..da1f583 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -13,7 +13,7 @@
. if \w'\(rq' .ds rq "\(rq
. \}
.\}
-.TH GAWK 1 "Aug 03 2014" "Free Software Foundation" "Utility Commands"
+.TH GAWK 1 "Dec 17 2015" "Free Software Foundation" "Utility Commands"
.SH NAME
gawk \- pattern scanning and processing language
.SH SYNOPSIS
@@ -1087,16 +1087,12 @@ Use the
operator to test for these elements.
The following elements are guaranteed to be available:
.RS
-.TP \w'\fBPROCINFO["version"]\fR'u+1n
+.TP \w'\fBPROCINFO["strftime"]\fR'u+1n
\fBPROCINFO["egid"]\fP
The value of the
.IR getegid (2)
system call.
.TP
-\fBPROCINFO["strftime"]\fP
-The default time format string for
-.BR strftime() .
-.TP
\fBPROCINFO["euid"]\fP
The value of the
.IR geteuid (2)
@@ -1113,6 +1109,11 @@ or \fB"FIELDWIDTHS"\fP if field splitting with
.B FIELDWIDTHS
is in effect.
.TP
+\fBPROCINFO["gid"]\fP
+The value of the
+.IR getgid (2)
+system call.
+.TP
\fBPROCINFO["identifiers"]\fP
A subarray, indexed by the names of all identifiers used in the
text of the AWK program.
@@ -1148,11 +1149,6 @@ doesn't know yet).
The identifier is a user-defined function.
.RE
.TP
-\fBPROCINFO["gid"]\fP
-The value of the
-.IR getgid (2)
-system call.
-.TP
\fBPROCINFO["pgrpid"]\fP
The process group ID of the current process.
.TP
@@ -1162,11 +1158,68 @@ The process ID of the current process.
\fBPROCINFO["ppid"]\fP
The parent process ID of the current process.
.TP
+\fBPROCINFO["strftime"]\fP
+The default time format string for
+.BR strftime() .
+.TP
\fBPROCINFO["uid"]\fP
The value of the
.IR getuid (2)
system call.
.TP
+\fBPROCINFO["version"]\fP
+the version of
+.IR gawk .
+.PP
+The following elements are present if loading dynamic
+extensions is available:
+.TP
+\fBPROCINFO["api_major"]\fP
+The major version of the extension API.
+.TP
+\fBPROCINFO["api_minor"]\fP
+The minor version of the extension API.
+.PP
+The following elements are available if MPFR support is
+compiled into
+.IR gawk\^ :
+.TP
+\fBPROCINFO["gmp_version"]\fP
+The version of the GNU MP library used for arbitrary precision
+number support in
+.IR gawk .
+.TP
+\fBPROCINFO["mpfr_version"]\fP
+The version of the GNU MPFR library used for arbitrary precision
+number support in
+.IR gawk .
+.TP
+\fBPROCINFO["prec_max"]\fP
+The maximum precision supported by the GNU MPFR library for
+arbitrary precision floating-point numbers.
+.TP
+\fBPROCINFO["prec_min"]\fP
+The minimum precision allowed by the GNU MPFR library for
+arbitrary precision floating-point numbers.
+.PP
+The following elements may set by a program to
+change
+.IR gawk 's
+behavior:
+.TP
+\fBPROCINFO["\fIcommand\fB", "pty"]\fR
+Use a pseudo-tty for two-way communication with
+.I command
+instead of setting up two one-way pipes.
+.TP
+\fBPROCINFO["\fIinput\fB", "READ_TIMEOUT"]\fR
+The timeout in milliseconds for reading data from
+.IR input ,
+where
+.I input
+is a redirection string or a filename. A value of zero or
+less than zero means no timeout.
+.TP
\fBPROCINFO["sorted_in"]\fP
If this element exists in
.BR PROCINFO ,
@@ -1206,52 +1259,6 @@ are the
corresponding values of the two elements being compared.
It should return a number less than, equal to, or greater than 0,
depending on how the elements of the array are to be ordered.
-.TP
-\fBPROCINFO["input", "READ_TIMEOUT"]\fP
-The timeout in milliseconds for reading data from
-.IR input ,
-where
-.I input
-is a redirection string or a filename. A value of zero or
-less than zero means no timeout.
-.TP
-\fBPROCINFO["mpfr_version"]\fP
-The version of the GNU MPFR library used for arbitrary precision
-number support in
-.IR gawk .
-This entry is not present if MPFR support is not compiled into
-.IR gawk .
-.TP
-\fBPROCINFO["gmp_version"]\fP
-The version of the GNU MP library used for arbitrary precision
-number support in
-.IR gawk .
-This entry is not present if MPFR support is not compiled into
-.IR gawk .
-.TP
-\fBPROCINFO["prec_max"]\fP
-The maximum precision supported by the GNU MPFR library for
-arbitrary precision floating-point numbers.
-This entry is not present if MPFR support is not compiled into
-.IR gawk .
-.TP
-\fBPROCINFO["prec_min"]\fP
-The minimum precision allowed by the GNU MPFR library for
-arbitrary precision floating-point numbers.
-This entry is not present if MPFR support is not compiled into
-.IR gawk .
-.TP
-\fBPROCINFO["api_major"]\fP
-The major version of the extension API.
-This entry is not present if loading dynamic extensions is not available.
-.TP
-\fBPROCINFO["api_minor"]\fP
-The minor version of the extension API.
-This entry is not present if loading dynamic extensions is not available.
-.TP
-\fBPROCINFO["version"]\fP
-the version of
-.IR gawk .
.RE
.TP
.B ROUNDMODE
diff --git a/doc/gawk.info b/doc/gawk.info
index f2ff3a9..6f401dd 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -10368,6 +10368,9 @@ they are not special:
effect, or '"FPAT"' if field matching with 'FPAT' is in
effect.
+ 'PROCINFO["gid"]'
+ The value of the 'getgid()' system call.
+
'PROCINFO["identifiers"]'
A subarray, indexed by the names of all identifiers used in
the text of the 'awk' program. An "identifier" is simply the
@@ -10399,9 +10402,6 @@ they are not special:
after it has finished parsing the program; they are _not_
updated while the program runs.
- 'PROCINFO["gid"]'
- The value of the 'getgid()' system call.
-
'PROCINFO["pgrpid"]'
The process group ID of the current process.
@@ -10411,13 +10411,6 @@ they are not special:
'PROCINFO["ppid"]'
The parent process ID of the current process.
- 'PROCINFO["sorted_in"]'
- If this element exists in 'PROCINFO', its value controls the
- order in which array indices will be processed by 'for (INDX
- in ARRAY)' loops. This is an advanced feature, so we defer
- the full description until later; see *note Scanning an
- Array::.
-
'PROCINFO["strftime"]'
The default time format string for 'strftime()'. Assigning a
new value to this element changes the default. *Note Time
@@ -10462,15 +10455,23 @@ they are not special:
groups that the process has. Use the 'in' operator to test for
these elements (*note Reference to Elements::).
- The 'PROCINFO' array has the following additional uses:
+ The following elements allow you to change 'gawk''s behavior:
- * It may be used to provide a timeout when reading from any open
- input file, pipe, or coprocess. *Note Read Timeout::, for
- more information.
+ 'PROCINFO["COMMAND", "pty"]'
+ For two-way communication to COMMAND, use a pseudo-tty instead
+ of setting up a two-way pipe. *Note Two-way I/O::, for more
+ information.
- * It may be used to cause coprocesses to communicate over
- pseudo-ttys instead of through two-way pipes; this is
- discussed further in *note Two-way I/O::.
+ 'PROCINFO["INPUT_NAME", "READ_TIMEOUT"]'
+ Set a timeout for reading from input redirection INPUT_NAME.
+ *Note Read Timeout::, for more information.
+
+ 'PROCINFO["sorted_in"]'
+ If this element exists in 'PROCINFO', its value controls the
+ order in which array indices will be processed by 'for (INDX
+ in ARRAY)' loops. This is an advanced feature, so we defer
+ the full description until later; see *note Scanning an
+ Array::.
'RLENGTH'
The length of the substring matched by the 'match()' function
@@ -32266,7 +32267,7 @@ Index
* dark corner, field separators: Full Line Fields. (line 22)
* dark corner, FILENAME variable: Getline Notes. (line 19)
* dark corner, FILENAME variable <1>: Auto-set. (line 89)
-* dark corner, FNR/NR variables: Auto-set. (line 312)
+* dark corner, FNR/NR variables: Auto-set. (line 313)
* dark corner, format-control characters: Control Letters. (line 18)
* dark corner, format-control characters <1>: Control Letters.
(line 93)
@@ -32499,7 +32500,7 @@ Index
(line 26)
* differences in awk and gawk, RS/RT variables: gawk split records.
(line 58)
-* differences in awk and gawk, RT variable: Auto-set. (line 263)
+* differences in awk and gawk, RT variable: Auto-set. (line 264)
* differences in awk and gawk, single-character fields: Single Character
Fields.
(line 6)
* differences in awk and gawk, split() function: String Functions.
@@ -32507,7 +32508,7 @@ Index
* differences in awk and gawk, strings: Scalar Constants. (line 20)
* differences in awk and gawk, strings, storing: gawk split records.
(line 76)
-* differences in awk and gawk, SYMTAB variable: Auto-set. (line 267)
+* differences in awk and gawk, SYMTAB variable: Auto-set. (line 268)
* differences in awk and gawk, TEXTDOMAIN variable: User-modified.
(line 152)
* differences in awk and gawk, trunc-mod operation: Arithmetic Ops.
@@ -32669,7 +32670,7 @@ Index
(line 6)
* extension API version: Extension Versioning.
(line 6)
-* extension API, version number: Auto-set. (line 230)
+* extension API, version number: Auto-set. (line 223)
* extension example: Extension Example. (line 6)
* extension registration: Registration Functions.
(line 6)
@@ -32822,7 +32823,7 @@ Index
(line 12)
* FNR variable: Records. (line 6)
* FNR variable <1>: Auto-set. (line 99)
-* FNR variable, changing: Auto-set. (line 312)
+* FNR variable, changing: Auto-set. (line 313)
* for statement: For Statement. (line 6)
* for statement, looping over arrays: Scanning an Array. (line 20)
* fork() extension function: Extension Sample Fork.
@@ -32926,7 +32927,7 @@ Index
* G., Daniel Richard <1>: Bugs. (line 73)
* Garfinkle, Scott: Contributors. (line 35)
* gawk program, dynamic profiling: Profiling. (line 178)
-* gawk version: Auto-set. (line 205)
+* gawk version: Auto-set. (line 198)
* gawk, ARGIND variable in: Other Arguments. (line 15)
* gawk, awk and: Preface. (line 21)
* gawk, awk and <1>: This Manual. (line 14)
@@ -32993,9 +32994,8 @@ Index
* gawk, OS/2 version of: PC Using. (line 17)
* gawk, predefined variables and: Built-in Variables. (line 14)
* gawk, PROCINFO array in: Auto-set. (line 129)
-* gawk, PROCINFO array in <1>: Auto-set. (line 240)
-* gawk, PROCINFO array in <2>: Time Functions. (line 47)
-* gawk, PROCINFO array in <3>: Two-way I/O. (line 99)
+* gawk, PROCINFO array in <1>: Time Functions. (line 47)
+* gawk, PROCINFO array in <2>: Two-way I/O. (line 99)
* gawk, regexp constants and: Using Constant Regexps.
(line 28)
* gawk, regular expressions, case sensitivity: Case-sensitivity.
@@ -33005,12 +33005,12 @@ Index
* gawk, regular expressions, precedence: Regexp Operators. (line 161)
* gawk, RT variable in: awk split records. (line 124)
* gawk, RT variable in <1>: Multiple Line. (line 130)
-* gawk, RT variable in <2>: Auto-set. (line 263)
+* gawk, RT variable in <2>: Auto-set. (line 264)
* gawk, See Also awk: Preface. (line 34)
* gawk, source code, obtaining: Getting. (line 6)
* gawk, splitting fields and: Constant Size. (line 86)
* gawk, string-translation functions: I18N Functions. (line 6)
-* gawk, SYMTAB array in: Auto-set. (line 267)
+* gawk, SYMTAB array in: Auto-set. (line 268)
* gawk, TEXTDOMAIN variable in: User-modified. (line 152)
* gawk, timestamps: Time Functions. (line 6)
* gawk, uses for: Preface. (line 34)
@@ -33101,7 +33101,7 @@ Index
* Grigera, Juan: Contributors. (line 58)
* group database, reading: Group Functions. (line 6)
* group file: Group Functions. (line 6)
-* group ID of gawk user: Auto-set. (line 178)
+* group ID of gawk user: Auto-set. (line 147)
* groups, information about: Group Functions. (line 6)
* gsub: Using Constant Regexps.
(line 43)
@@ -33398,7 +33398,7 @@ Index
* mawk utility <2>: Concatenation. (line 36)
* mawk utility <3>: Nextfile Statement. (line 47)
* mawk utility <4>: Other Versions. (line 48)
-* maximum precision supported by MPFR library: Auto-set. (line 219)
+* maximum precision supported by MPFR library: Auto-set. (line 212)
* McIlroy, Doug: Glossary. (line 257)
* McPhee, Patrick: Contributors. (line 101)
* message object files: Explaining gettext. (line 42)
@@ -33411,7 +33411,7 @@ Index
* messages from extensions: Printing Messages. (line 6)
* metacharacters in regular expressions: Regexp Operators. (line 6)
* metacharacters, escape sequences for: Escape Sequences. (line 137)
-* minimum precision required by MPFR library: Auto-set. (line 222)
+* minimum precision required by MPFR library: Auto-set. (line 215)
* mktime: Time Functions. (line 25)
* modifiers, in format specifiers: Format Modifiers. (line 6)
* monetary information, localization: Explaining gettext. (line 104)
@@ -33471,7 +33471,7 @@ Index
* not Boolean-logic operator: Boolean Ops. (line 6)
* NR variable: Records. (line 6)
* NR variable <1>: Auto-set. (line 124)
-* NR variable, changing: Auto-set. (line 312)
+* NR variable, changing: Auto-set. (line 313)
* null strings: awk split records. (line 114)
* null strings <1>: Regexp Field Splitting.
(line 43)
@@ -33774,12 +33774,11 @@ Index
* PROCINFO array, and user and group ID numbers: Id Program. (line 15)
* PROCINFO array, testing the field splitting: Passwd Functions.
(line 154)
-* PROCINFO array, uses: Auto-set. (line 240)
* PROCINFO, values of sorted_in: Controlling Scanning.
(line 26)
* profiling awk programs: Profiling. (line 6)
* profiling awk programs, dynamically: Profiling. (line 178)
-* program identifiers: Auto-set. (line 147)
+* program identifiers: Auto-set. (line 150)
* program, definition of: Getting Started. (line 21)
* programming conventions, --non-decimal-data option: Nondecimal Data.
(line 35)
@@ -33938,7 +33937,7 @@ Index
* right shift: Bitwise Functions. (line 54)
* right shift, bitwise: Bitwise Functions. (line 32)
* Ritchie, Dennis: Basic Data Typing. (line 54)
-* RLENGTH variable: Auto-set. (line 250)
+* RLENGTH variable: Auto-set. (line 251)
* RLENGTH variable, match() function and: String Functions. (line 227)
* Robbins, Arnold: Command Line Field Separator.
(line 71)
@@ -33964,11 +33963,11 @@ Index
* RS variable <1>: User-modified. (line 133)
* RS variable, multiline records and: Multiple Line. (line 17)
* rshift: Bitwise Functions. (line 54)
-* RSTART variable: Auto-set. (line 256)
+* RSTART variable: Auto-set. (line 257)
* RSTART variable, match() function and: String Functions. (line 227)
* RT variable: awk split records. (line 124)
* RT variable <1>: Multiple Line. (line 130)
-* RT variable <2>: Auto-set. (line 263)
+* RT variable <2>: Auto-set. (line 264)
* Rubin, Paul: History. (line 30)
* Rubin, Paul <1>: Contributors. (line 16)
* rule, definition of: Getting Started. (line 21)
@@ -33986,7 +33985,7 @@ Index
* scanning arrays: Scanning an Array. (line 6)
* scanning multidimensional arrays: Multiscanning. (line 11)
* Schorr, Andrew: Acknowledgments. (line 60)
-* Schorr, Andrew <1>: Auto-set. (line 295)
+* Schorr, Andrew <1>: Auto-set. (line 296)
* Schorr, Andrew <2>: Contributors. (line 134)
* Schreiber, Bert: Acknowledgments. (line 38)
* Schreiber, Rita: Acknowledgments. (line 38)
@@ -34072,7 +34071,7 @@ Index
(line 103)
* sidebar, Changing FS Does Not Affect the Fields: Full Line Fields.
(line 14)
-* sidebar, Changing NR and FNR: Auto-set. (line 310)
+* sidebar, Changing NR and FNR: Auto-set. (line 311)
* sidebar, Controlling Output Buffering with system(): I/O Functions.
(line 137)
* sidebar, Escape Sequences for Metacharacters: Escape Sequences.
@@ -34235,9 +34234,9 @@ Index
* substr: String Functions. (line 482)
* substring: String Functions. (line 482)
* Sumner, Andrew: Other Versions. (line 68)
-* supplementary groups of gawk process: Auto-set. (line 235)
+* supplementary groups of gawk process: Auto-set. (line 228)
* switch statement: Switch Statement. (line 6)
-* SYMTAB array: Auto-set. (line 267)
+* SYMTAB array: Auto-set. (line 268)
* syntactic ambiguity: /= operator vs. /=.../ regexp constant: Assignment Ops.
(line 149)
* system: I/O Functions. (line 107)
@@ -34417,10 +34416,10 @@ Index
* variables, uninitialized, as array subscripts: Uninitialized Subscripts.
(line 6)
* variables, user-defined: Variables. (line 6)
-* version of gawk: Auto-set. (line 205)
-* version of gawk extension API: Auto-set. (line 230)
-* version of GNU MP library: Auto-set. (line 213)
-* version of GNU MPFR library: Auto-set. (line 215)
+* version of gawk: Auto-set. (line 198)
+* version of gawk extension API: Auto-set. (line 223)
+* version of GNU MP library: Auto-set. (line 206)
+* version of GNU MPFR library: Auto-set. (line 208)
* vertical bar (|): Regexp Operators. (line 70)
* vertical bar (|), | operator (I/O): Getline/Pipe. (line 10)
* vertical bar (|), | operator (I/O) <1>: Precedence. (line 64)
@@ -34688,358 +34687,358 @@ Node: Built-in Variables431852
Node: User-modified432985
Ref: User-modified-Footnote-1440612
Node: Auto-set440674
-Ref: Auto-set-Footnote-1453742
-Ref: Auto-set-Footnote-2453948
-Node: ARGC and ARGV454004
-Node: Pattern Action Summary458223
-Node: Arrays460653
-Node: Array Basics461982
-Node: Array Intro462826
-Ref: figure-array-elements464801
-Ref: Array Intro-Footnote-1467505
-Node: Reference to Elements467633
-Node: Assigning Elements470097
-Node: Array Example470588
-Node: Scanning an Array472347
-Node: Controlling Scanning475371
-Ref: Controlling Scanning-Footnote-1480770
-Node: Numeric Array Subscripts481086
-Node: Uninitialized Subscripts483270
-Node: Delete484889
-Ref: Delete-Footnote-1487641
-Node: Multidimensional487698
-Node: Multiscanning490793
-Node: Arrays of Arrays492384
-Node: Arrays Summary497152
-Node: Functions499245
-Node: Built-in500283
-Node: Calling Built-in501361
-Node: Numeric Functions503357
-Ref: Numeric Functions-Footnote-1507385
-Ref: Numeric Functions-Footnote-2507742
-Ref: Numeric Functions-Footnote-3507790
-Node: String Functions508062
-Ref: String Functions-Footnote-1531570
-Ref: String Functions-Footnote-2531699
-Ref: String Functions-Footnote-3531947
-Node: Gory Details532034
-Ref: table-sub-escapes533825
-Ref: table-sub-proposed535344
-Ref: table-posix-sub536707
-Ref: table-gensub-escapes538248
-Ref: Gory Details-Footnote-1539071
-Node: I/O Functions539222
-Ref: I/O Functions-Footnote-1546443
-Node: Time Functions546591
-Ref: Time Functions-Footnote-1557096
-Ref: Time Functions-Footnote-2557164
-Ref: Time Functions-Footnote-3557322
-Ref: Time Functions-Footnote-4557433
-Ref: Time Functions-Footnote-5557545
-Ref: Time Functions-Footnote-6557772
-Node: Bitwise Functions558038
-Ref: table-bitwise-ops558632
-Ref: Bitwise Functions-Footnote-1562970
-Node: Type Functions563143
-Node: I18N Functions564299
-Node: User-defined565950
-Node: Definition Syntax566755
-Ref: Definition Syntax-Footnote-1572442
-Node: Function Example572513
-Ref: Function Example-Footnote-1575435
-Node: Function Caveats575457
-Node: Calling A Function575975
-Node: Variable Scope576933
-Node: Pass By Value/Reference579927
-Node: Return Statement583426
-Node: Dynamic Typing586405
-Node: Indirect Calls587335
-Ref: Indirect Calls-Footnote-1597586
-Node: Functions Summary597714
-Node: Library Functions600419
-Ref: Library Functions-Footnote-1604028
-Ref: Library Functions-Footnote-2604171
-Node: Library Names604342
-Ref: Library Names-Footnote-1607803
-Ref: Library Names-Footnote-2608026
-Node: General Functions608112
-Node: Strtonum Function609215
-Node: Assert Function612237
-Node: Round Function615563
-Node: Cliff Random Function617104
-Node: Ordinal Functions618120
-Ref: Ordinal Functions-Footnote-1621183
-Ref: Ordinal Functions-Footnote-2621435
-Node: Join Function621645
-Ref: Join Function-Footnote-1623415
-Node: Getlocaltime Function623615
-Node: Readfile Function627359
-Node: Shell Quoting629333
-Node: Data File Management630734
-Node: Filetrans Function631366
-Node: Rewind Function635463
-Node: File Checking636849
-Ref: File Checking-Footnote-1638183
-Node: Empty Files638384
-Node: Ignoring Assigns640363
-Node: Getopt Function641913
-Ref: Getopt Function-Footnote-1653383
-Node: Passwd Functions653583
-Ref: Passwd Functions-Footnote-1662424
-Node: Group Functions662512
-Ref: Group Functions-Footnote-1670411
-Node: Walking Arrays670618
-Node: Library Functions Summary673628
-Node: Library Exercises675034
-Node: Sample Programs675499
-Node: Running Examples676269
-Node: Clones676997
-Node: Cut Program678221
-Node: Egrep Program687942
-Ref: Egrep Program-Footnote-1695454
-Node: Id Program695564
-Node: Split Program699244
-Ref: Split Program-Footnote-1702703
-Node: Tee Program702832
-Node: Uniq Program705622
-Node: Wc Program713048
-Ref: Wc Program-Footnote-1717303
-Node: Miscellaneous Programs717397
-Node: Dupword Program718610
-Node: Alarm Program720640
-Node: Translate Program725495
-Ref: Translate Program-Footnote-1730060
-Node: Labels Program730330
-Ref: Labels Program-Footnote-1733681
-Node: Word Sorting733765
-Node: History Sorting737837
-Node: Extract Program739672
-Node: Simple Sed747203
-Node: Igawk Program750277
-Ref: Igawk Program-Footnote-1764608
-Ref: Igawk Program-Footnote-2764810
-Ref: Igawk Program-Footnote-3764932
-Node: Anagram Program765047
-Node: Signature Program768109
-Node: Programs Summary769356
-Node: Programs Exercises770571
-Ref: Programs Exercises-Footnote-1774700
-Node: Advanced Features774791
-Node: Nondecimal Data776781
-Node: Array Sorting778372
-Node: Controlling Array Traversal779072
-Ref: Controlling Array Traversal-Footnote-1787441
-Node: Array Sorting Functions787559
-Ref: Array Sorting Functions-Footnote-1791446
-Node: Two-way I/O791642
-Ref: Two-way I/O-Footnote-1796593
-Ref: Two-way I/O-Footnote-2796780
-Node: TCP/IP Networking796862
-Node: Profiling799980
-Node: Advanced Features Summary807519
-Node: Internationalization809455
-Node: I18N and L10N810935
-Node: Explaining gettext811622
-Ref: Explaining gettext-Footnote-1816645
-Ref: Explaining gettext-Footnote-2816830
-Node: Programmer i18n816995
-Ref: Programmer i18n-Footnote-1821851
-Node: Translator i18n821900
-Node: String Extraction822694
-Ref: String Extraction-Footnote-1823827
-Node: Printf Ordering823913
-Ref: Printf Ordering-Footnote-1826699
-Node: I18N Portability826763
-Ref: I18N Portability-Footnote-1829219
-Node: I18N Example829282
-Ref: I18N Example-Footnote-1832088
-Node: Gawk I18N832161
-Node: I18N Summary832806
-Node: Debugger834147
-Node: Debugging835169
-Node: Debugging Concepts835610
-Node: Debugging Terms837419
-Node: Awk Debugging839994
-Node: Sample Debugging Session840900
-Node: Debugger Invocation841434
-Node: Finding The Bug842820
-Node: List of Debugger Commands849298
-Node: Breakpoint Control850631
-Node: Debugger Execution Control854325
-Node: Viewing And Changing Data857687
-Node: Execution Stack861061
-Node: Debugger Info862698
-Node: Miscellaneous Debugger Commands866769
-Node: Readline Support871857
-Node: Limitations872753
-Node: Debugging Summary874862
-Node: Arbitrary Precision Arithmetic876035
-Node: Computer Arithmetic877451
-Ref: table-numeric-ranges881042
-Ref: Computer Arithmetic-Footnote-1881764
-Node: Math Definitions881821
-Ref: table-ieee-formats885135
-Ref: Math Definitions-Footnote-1885738
-Node: MPFR features885843
-Node: FP Math Caution887516
-Ref: FP Math Caution-Footnote-1888588
-Node: Inexactness of computations888957
-Node: Inexact representation889917
-Node: Comparing FP Values891277
-Node: Errors accumulate892359
-Node: Getting Accuracy893792
-Node: Try To Round896502
-Node: Setting precision897401
-Ref: table-predefined-precision-strings898098
-Node: Setting the rounding mode899928
-Ref: table-gawk-rounding-modes900302
-Ref: Setting the rounding mode-Footnote-1903710
-Node: Arbitrary Precision Integers903889
-Ref: Arbitrary Precision Integers-Footnote-1906873
-Node: POSIX Floating Point Problems907022
-Ref: POSIX Floating Point Problems-Footnote-1910904
-Node: Floating point summary910942
-Node: Dynamic Extensions913132
-Node: Extension Intro914685
-Node: Plugin License915951
-Node: Extension Mechanism Outline916748
-Ref: figure-load-extension917187
-Ref: figure-register-new-function918752
-Ref: figure-call-new-function919844
-Node: Extension API Description921907
-Node: Extension API Functions Introduction923355
-Node: General Data Types928167
-Ref: General Data Types-Footnote-1934122
-Node: Memory Allocation Functions934421
-Ref: Memory Allocation Functions-Footnote-1937266
-Node: Constructor Functions937365
-Node: Registration Functions939110
-Node: Extension Functions939795
-Node: Exit Callback Functions942094
-Node: Extension Version String943344
-Node: Input Parsers944007
-Node: Output Wrappers953892
-Node: Two-way processors958404
-Node: Printing Messages960668
-Ref: Printing Messages-Footnote-1961742
-Node: Updating ERRNO961895
-Node: Requesting Values962634
-Ref: table-value-types-returned963371
-Node: Accessing Parameters964254
-Node: Symbol Table Access965490
-Node: Symbol table by name966002
-Node: Symbol table by cookie968023
-Ref: Symbol table by cookie-Footnote-1972172
-Node: Cached values972236
-Ref: Cached values-Footnote-1975737
-Node: Array Manipulation975828
-Ref: Array Manipulation-Footnote-1976927
-Node: Array Data Types976964
-Ref: Array Data Types-Footnote-1979622
-Node: Array Functions979714
-Node: Flattening Arrays983573
-Node: Creating Arrays990481
-Node: Extension API Variables995253
-Node: Extension Versioning995889
-Node: Extension API Informational Variables997780
-Node: Extension API Boilerplate998844
-Node: Finding Extensions1002658
-Node: Extension Example1003218
-Node: Internal File Description1004016
-Node: Internal File Ops1008096
-Ref: Internal File Ops-Footnote-11019858
-Node: Using Internal File Ops1019998
-Ref: Using Internal File Ops-Footnote-11022381
-Node: Extension Samples1022656
-Node: Extension Sample File Functions1024185
-Node: Extension Sample Fnmatch1031834
-Node: Extension Sample Fork1033321
-Node: Extension Sample Inplace1034539
-Node: Extension Sample Ord1037749
-Node: Extension Sample Readdir1038585
-Ref: table-readdir-file-types1039474
-Node: Extension Sample Revout1040279
-Node: Extension Sample Rev2way1040868
-Node: Extension Sample Read write array1041608
-Node: Extension Sample Readfile1043550
-Node: Extension Sample Time1044645
-Node: Extension Sample API Tests1045993
-Node: gawkextlib1046485
-Node: Extension summary1048909
-Node: Extension Exercises1052601
-Node: Language History1054098
-Node: V7/SVR3.11055754
-Node: SVR41057906
-Node: POSIX1059340
-Node: BTL1060720
-Node: POSIX/GNU1061450
-Node: Feature History1066971
-Node: Common Extensions1080300
-Node: Ranges and Locales1081583
-Ref: Ranges and Locales-Footnote-11086199
-Ref: Ranges and Locales-Footnote-21086226
-Ref: Ranges and Locales-Footnote-31086461
-Node: Contributors1086682
-Node: History summary1092251
-Node: Installation1093631
-Node: Gawk Distribution1094576
-Node: Getting1095060
-Node: Extracting1096021
-Node: Distribution contents1097659
-Node: Unix Installation1103412
-Node: Quick Installation1104028
-Node: Additional Configuration Options1106455
-Node: Configuration Philosophy1108259
-Node: Non-Unix Installation1110629
-Node: PC Installation1111087
-Node: PC Binary Installation1112407
-Node: PC Compiling1114259
-Ref: PC Compiling-Footnote-11117283
-Node: PC Testing1117392
-Node: PC Using1118572
-Node: Cygwin1122686
-Node: MSYS1123456
-Node: VMS Installation1123957
-Node: VMS Compilation1124748
-Ref: VMS Compilation-Footnote-11125978
-Node: VMS Dynamic Extensions1126036
-Node: VMS Installation Details1127721
-Node: VMS Running1129974
-Node: VMS GNV1132815
-Node: VMS Old Gawk1133550
-Node: Bugs1134021
-Node: Other Versions1138218
-Node: Installation summary1144804
-Node: Notes1145862
-Node: Compatibility Mode1146727
-Node: Additions1147509
-Node: Accessing The Source1148434
-Node: Adding Code1149870
-Node: New Ports1156089
-Node: Derived Files1160577
-Ref: Derived Files-Footnote-11166062
-Ref: Derived Files-Footnote-21166097
-Ref: Derived Files-Footnote-31166695
-Node: Future Extensions1166809
-Node: Implementation Limitations1167467
-Node: Extension Design1168650
-Node: Old Extension Problems1169804
-Ref: Old Extension Problems-Footnote-11171322
-Node: Extension New Mechanism Goals1171379
-Ref: Extension New Mechanism Goals-Footnote-11174743
-Node: Extension Other Design Decisions1174932
-Node: Extension Future Growth1177045
-Node: Old Extension Mechanism1177881
-Node: Notes summary1179644
-Node: Basic Concepts1180826
-Node: Basic High Level1181507
-Ref: figure-general-flow1181789
-Ref: figure-process-flow1182474
-Ref: Basic High Level-Footnote-11185775
-Node: Basic Data Typing1185960
-Node: Glossary1189288
-Node: Copying1221234
-Node: GNU Free Documentation License1258773
-Node: Index1283891
+Ref: Auto-set-Footnote-1453768
+Ref: Auto-set-Footnote-2453974
+Node: ARGC and ARGV454030
+Node: Pattern Action Summary458249
+Node: Arrays460679
+Node: Array Basics462008
+Node: Array Intro462852
+Ref: figure-array-elements464827
+Ref: Array Intro-Footnote-1467531
+Node: Reference to Elements467659
+Node: Assigning Elements470123
+Node: Array Example470614
+Node: Scanning an Array472373
+Node: Controlling Scanning475397
+Ref: Controlling Scanning-Footnote-1480796
+Node: Numeric Array Subscripts481112
+Node: Uninitialized Subscripts483296
+Node: Delete484915
+Ref: Delete-Footnote-1487667
+Node: Multidimensional487724
+Node: Multiscanning490819
+Node: Arrays of Arrays492410
+Node: Arrays Summary497178
+Node: Functions499271
+Node: Built-in500309
+Node: Calling Built-in501387
+Node: Numeric Functions503383
+Ref: Numeric Functions-Footnote-1507411
+Ref: Numeric Functions-Footnote-2507768
+Ref: Numeric Functions-Footnote-3507816
+Node: String Functions508088
+Ref: String Functions-Footnote-1531596
+Ref: String Functions-Footnote-2531725
+Ref: String Functions-Footnote-3531973
+Node: Gory Details532060
+Ref: table-sub-escapes533851
+Ref: table-sub-proposed535370
+Ref: table-posix-sub536733
+Ref: table-gensub-escapes538274
+Ref: Gory Details-Footnote-1539097
+Node: I/O Functions539248
+Ref: I/O Functions-Footnote-1546469
+Node: Time Functions546617
+Ref: Time Functions-Footnote-1557122
+Ref: Time Functions-Footnote-2557190
+Ref: Time Functions-Footnote-3557348
+Ref: Time Functions-Footnote-4557459
+Ref: Time Functions-Footnote-5557571
+Ref: Time Functions-Footnote-6557798
+Node: Bitwise Functions558064
+Ref: table-bitwise-ops558658
+Ref: Bitwise Functions-Footnote-1562996
+Node: Type Functions563169
+Node: I18N Functions564325
+Node: User-defined565976
+Node: Definition Syntax566781
+Ref: Definition Syntax-Footnote-1572468
+Node: Function Example572539
+Ref: Function Example-Footnote-1575461
+Node: Function Caveats575483
+Node: Calling A Function576001
+Node: Variable Scope576959
+Node: Pass By Value/Reference579953
+Node: Return Statement583452
+Node: Dynamic Typing586431
+Node: Indirect Calls587361
+Ref: Indirect Calls-Footnote-1597612
+Node: Functions Summary597740
+Node: Library Functions600445
+Ref: Library Functions-Footnote-1604054
+Ref: Library Functions-Footnote-2604197
+Node: Library Names604368
+Ref: Library Names-Footnote-1607829
+Ref: Library Names-Footnote-2608052
+Node: General Functions608138
+Node: Strtonum Function609241
+Node: Assert Function612263
+Node: Round Function615589
+Node: Cliff Random Function617130
+Node: Ordinal Functions618146
+Ref: Ordinal Functions-Footnote-1621209
+Ref: Ordinal Functions-Footnote-2621461
+Node: Join Function621671
+Ref: Join Function-Footnote-1623441
+Node: Getlocaltime Function623641
+Node: Readfile Function627385
+Node: Shell Quoting629359
+Node: Data File Management630760
+Node: Filetrans Function631392
+Node: Rewind Function635489
+Node: File Checking636875
+Ref: File Checking-Footnote-1638209
+Node: Empty Files638410
+Node: Ignoring Assigns640389
+Node: Getopt Function641939
+Ref: Getopt Function-Footnote-1653409
+Node: Passwd Functions653609
+Ref: Passwd Functions-Footnote-1662450
+Node: Group Functions662538
+Ref: Group Functions-Footnote-1670437
+Node: Walking Arrays670644
+Node: Library Functions Summary673654
+Node: Library Exercises675060
+Node: Sample Programs675525
+Node: Running Examples676295
+Node: Clones677023
+Node: Cut Program678247
+Node: Egrep Program687968
+Ref: Egrep Program-Footnote-1695480
+Node: Id Program695590
+Node: Split Program699270
+Ref: Split Program-Footnote-1702729
+Node: Tee Program702858
+Node: Uniq Program705648
+Node: Wc Program713074
+Ref: Wc Program-Footnote-1717329
+Node: Miscellaneous Programs717423
+Node: Dupword Program718636
+Node: Alarm Program720666
+Node: Translate Program725521
+Ref: Translate Program-Footnote-1730086
+Node: Labels Program730356
+Ref: Labels Program-Footnote-1733707
+Node: Word Sorting733791
+Node: History Sorting737863
+Node: Extract Program739698
+Node: Simple Sed747229
+Node: Igawk Program750303
+Ref: Igawk Program-Footnote-1764634
+Ref: Igawk Program-Footnote-2764836
+Ref: Igawk Program-Footnote-3764958
+Node: Anagram Program765073
+Node: Signature Program768135
+Node: Programs Summary769382
+Node: Programs Exercises770597
+Ref: Programs Exercises-Footnote-1774726
+Node: Advanced Features774817
+Node: Nondecimal Data776807
+Node: Array Sorting778398
+Node: Controlling Array Traversal779098
+Ref: Controlling Array Traversal-Footnote-1787467
+Node: Array Sorting Functions787585
+Ref: Array Sorting Functions-Footnote-1791472
+Node: Two-way I/O791668
+Ref: Two-way I/O-Footnote-1796619
+Ref: Two-way I/O-Footnote-2796806
+Node: TCP/IP Networking796888
+Node: Profiling800006
+Node: Advanced Features Summary807545
+Node: Internationalization809481
+Node: I18N and L10N810961
+Node: Explaining gettext811648
+Ref: Explaining gettext-Footnote-1816671
+Ref: Explaining gettext-Footnote-2816856
+Node: Programmer i18n817021
+Ref: Programmer i18n-Footnote-1821877
+Node: Translator i18n821926
+Node: String Extraction822720
+Ref: String Extraction-Footnote-1823853
+Node: Printf Ordering823939
+Ref: Printf Ordering-Footnote-1826725
+Node: I18N Portability826789
+Ref: I18N Portability-Footnote-1829245
+Node: I18N Example829308
+Ref: I18N Example-Footnote-1832114
+Node: Gawk I18N832187
+Node: I18N Summary832832
+Node: Debugger834173
+Node: Debugging835195
+Node: Debugging Concepts835636
+Node: Debugging Terms837445
+Node: Awk Debugging840020
+Node: Sample Debugging Session840926
+Node: Debugger Invocation841460
+Node: Finding The Bug842846
+Node: List of Debugger Commands849324
+Node: Breakpoint Control850657
+Node: Debugger Execution Control854351
+Node: Viewing And Changing Data857713
+Node: Execution Stack861087
+Node: Debugger Info862724
+Node: Miscellaneous Debugger Commands866795
+Node: Readline Support871883
+Node: Limitations872779
+Node: Debugging Summary874888
+Node: Arbitrary Precision Arithmetic876061
+Node: Computer Arithmetic877477
+Ref: table-numeric-ranges881068
+Ref: Computer Arithmetic-Footnote-1881790
+Node: Math Definitions881847
+Ref: table-ieee-formats885161
+Ref: Math Definitions-Footnote-1885764
+Node: MPFR features885869
+Node: FP Math Caution887542
+Ref: FP Math Caution-Footnote-1888614
+Node: Inexactness of computations888983
+Node: Inexact representation889943
+Node: Comparing FP Values891303
+Node: Errors accumulate892385
+Node: Getting Accuracy893818
+Node: Try To Round896528
+Node: Setting precision897427
+Ref: table-predefined-precision-strings898124
+Node: Setting the rounding mode899954
+Ref: table-gawk-rounding-modes900328
+Ref: Setting the rounding mode-Footnote-1903736
+Node: Arbitrary Precision Integers903915
+Ref: Arbitrary Precision Integers-Footnote-1906899
+Node: POSIX Floating Point Problems907048
+Ref: POSIX Floating Point Problems-Footnote-1910930
+Node: Floating point summary910968
+Node: Dynamic Extensions913158
+Node: Extension Intro914711
+Node: Plugin License915977
+Node: Extension Mechanism Outline916774
+Ref: figure-load-extension917213
+Ref: figure-register-new-function918778
+Ref: figure-call-new-function919870
+Node: Extension API Description921933
+Node: Extension API Functions Introduction923381
+Node: General Data Types928193
+Ref: General Data Types-Footnote-1934148
+Node: Memory Allocation Functions934447
+Ref: Memory Allocation Functions-Footnote-1937292
+Node: Constructor Functions937391
+Node: Registration Functions939136
+Node: Extension Functions939821
+Node: Exit Callback Functions942120
+Node: Extension Version String943370
+Node: Input Parsers944033
+Node: Output Wrappers953918
+Node: Two-way processors958430
+Node: Printing Messages960694
+Ref: Printing Messages-Footnote-1961768
+Node: Updating ERRNO961921
+Node: Requesting Values962660
+Ref: table-value-types-returned963397
+Node: Accessing Parameters964280
+Node: Symbol Table Access965516
+Node: Symbol table by name966028
+Node: Symbol table by cookie968049
+Ref: Symbol table by cookie-Footnote-1972198
+Node: Cached values972262
+Ref: Cached values-Footnote-1975763
+Node: Array Manipulation975854
+Ref: Array Manipulation-Footnote-1976953
+Node: Array Data Types976990
+Ref: Array Data Types-Footnote-1979648
+Node: Array Functions979740
+Node: Flattening Arrays983599
+Node: Creating Arrays990507
+Node: Extension API Variables995279
+Node: Extension Versioning995915
+Node: Extension API Informational Variables997806
+Node: Extension API Boilerplate998870
+Node: Finding Extensions1002684
+Node: Extension Example1003244
+Node: Internal File Description1004042
+Node: Internal File Ops1008122
+Ref: Internal File Ops-Footnote-11019884
+Node: Using Internal File Ops1020024
+Ref: Using Internal File Ops-Footnote-11022407
+Node: Extension Samples1022682
+Node: Extension Sample File Functions1024211
+Node: Extension Sample Fnmatch1031860
+Node: Extension Sample Fork1033347
+Node: Extension Sample Inplace1034565
+Node: Extension Sample Ord1037775
+Node: Extension Sample Readdir1038611
+Ref: table-readdir-file-types1039500
+Node: Extension Sample Revout1040305
+Node: Extension Sample Rev2way1040894
+Node: Extension Sample Read write array1041634
+Node: Extension Sample Readfile1043576
+Node: Extension Sample Time1044671
+Node: Extension Sample API Tests1046019
+Node: gawkextlib1046511
+Node: Extension summary1048935
+Node: Extension Exercises1052627
+Node: Language History1054124
+Node: V7/SVR3.11055780
+Node: SVR41057932
+Node: POSIX1059366
+Node: BTL1060746
+Node: POSIX/GNU1061476
+Node: Feature History1066997
+Node: Common Extensions1080326
+Node: Ranges and Locales1081609
+Ref: Ranges and Locales-Footnote-11086225
+Ref: Ranges and Locales-Footnote-21086252
+Ref: Ranges and Locales-Footnote-31086487
+Node: Contributors1086708
+Node: History summary1092277
+Node: Installation1093657
+Node: Gawk Distribution1094602
+Node: Getting1095086
+Node: Extracting1096047
+Node: Distribution contents1097685
+Node: Unix Installation1103438
+Node: Quick Installation1104054
+Node: Additional Configuration Options1106481
+Node: Configuration Philosophy1108285
+Node: Non-Unix Installation1110655
+Node: PC Installation1111113
+Node: PC Binary Installation1112433
+Node: PC Compiling1114285
+Ref: PC Compiling-Footnote-11117309
+Node: PC Testing1117418
+Node: PC Using1118598
+Node: Cygwin1122712
+Node: MSYS1123482
+Node: VMS Installation1123983
+Node: VMS Compilation1124774
+Ref: VMS Compilation-Footnote-11126004
+Node: VMS Dynamic Extensions1126062
+Node: VMS Installation Details1127747
+Node: VMS Running1130000
+Node: VMS GNV1132841
+Node: VMS Old Gawk1133576
+Node: Bugs1134047
+Node: Other Versions1138244
+Node: Installation summary1144830
+Node: Notes1145888
+Node: Compatibility Mode1146753
+Node: Additions1147535
+Node: Accessing The Source1148460
+Node: Adding Code1149896
+Node: New Ports1156115
+Node: Derived Files1160603
+Ref: Derived Files-Footnote-11166088
+Ref: Derived Files-Footnote-21166123
+Ref: Derived Files-Footnote-31166721
+Node: Future Extensions1166835
+Node: Implementation Limitations1167493
+Node: Extension Design1168676
+Node: Old Extension Problems1169830
+Ref: Old Extension Problems-Footnote-11171348
+Node: Extension New Mechanism Goals1171405
+Ref: Extension New Mechanism Goals-Footnote-11174769
+Node: Extension Other Design Decisions1174958
+Node: Extension Future Growth1177071
+Node: Old Extension Mechanism1177907
+Node: Notes summary1179670
+Node: Basic Concepts1180852
+Node: Basic High Level1181533
+Ref: figure-general-flow1181815
+Ref: figure-process-flow1182500
+Ref: Basic High Level-Footnote-11185801
+Node: Basic Data Typing1185986
+Node: Glossary1189314
+Node: Copying1221260
+Node: GNU Free Documentation License1258799
+Node: Index1283917
End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 995bca9..7b91d85 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -51,7 +51,7 @@
@c applies to and all the info about who's publishing this edition
@c These apply across the board.
address@hidden UPDATE-MONTH May, 2015
address@hidden UPDATE-MONTH December, 2015
@set VERSION 4.1
@set PATCHLEVEL 3
@@ -14923,6 +14923,10 @@ This is
@code{"FIELDWIDTHS"} if field splitting with @code{FIELDWIDTHS} is in effect,
or @code{"FPAT"} if field matching with @code{FPAT} is in effect.
address@hidden PROCINFO["gid"]
address@hidden group ID of @command{gawk} user
+The value of the @code{getgid()} system call.
+
@item PROCINFO["identifiers"]
@cindex program identifiers
A subarray, indexed by the names of all identifiers used in the text of
@@ -14958,10 +14962,6 @@ The values indicate what @command{gawk} knows about
the identifiers
after it has finished parsing the program; they are @emph{not} updated
while the program runs.
address@hidden PROCINFO["gid"]
address@hidden group ID of @command{gawk} user
-The value of the @code{getgid()} system call.
-
@item PROCINFO["pgrpid"]
@cindex process group ID of @command{gawk} process
The process group ID of the current process.
@@ -14974,14 +14974,6 @@ The process ID of the current process.
@cindex parent process ID of @command{gawk} process
The parent process ID of the current process.
address@hidden PROCINFO["sorted_in"]
-If this element exists in @code{PROCINFO}, its value controls the
-order in which array indices will be processed by
address@hidden (@var{indx} in @var{array})} loops.
-This is an advanced feature, so we defer the
-full description until later; see
address@hidden an Array}.
-
@item PROCINFO["strftime"]
The default time format string for @code{strftime()}.
Assigning a new value to this element changes the default.
@@ -15041,21 +15033,26 @@ supplementary groups that the process has. Use the
@code{in} operator
to test for these elements
(@pxref{Reference to Elements}).
address@hidden @command{gawk}, @code{PROCINFO} array in
address@hidden @code{PROCINFO} array, uses
-The @code{PROCINFO} array has the following additional uses:
+The following elements allow you to change @command{gawk}'s behavior:
address@hidden @value{BULLET}
address@hidden
-It may be used to provide a timeout when reading from any
-open input file, pipe, or coprocess.
address@hidden @code
address@hidden PROCINFO["@var{command}", "pty"]
+For two-way communication to @var{command}, use a pseudo-tty instead
+of setting up a two-way pipe.
address@hidden I/O} for more information.
+
address@hidden PROCINFO["@var{input_name}", "READ_TIMEOUT"]
+Set a timeout for reading from input redirection @var{input_name}.
@DBXREF{Read Timeout} for more information.
address@hidden
-It may be used to cause coprocesses to communicate over pseudo-ttys
-instead of through two-way pipes; this is discussed further in
address@hidden I/O}.
address@hidden itemize
address@hidden PROCINFO["sorted_in"]
+If this element exists in @code{PROCINFO}, its value controls the
+order in which array indices will be processed by
address@hidden (@var{indx} in @var{array})} loops.
+This is an advanced feature, so we defer the
+full description until later; see
address@hidden an Array}.
address@hidden table
@cindex @code{RLENGTH} variable
@item @code{RLENGTH}
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 58ccaaf..f3d639e 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -46,7 +46,7 @@
@c applies to and all the info about who's publishing this edition
@c These apply across the board.
address@hidden UPDATE-MONTH May, 2015
address@hidden UPDATE-MONTH December, 2015
@set VERSION 4.1
@set PATCHLEVEL 3
@@ -14251,6 +14251,10 @@ This is
@code{"FIELDWIDTHS"} if field splitting with @code{FIELDWIDTHS} is in effect,
or @code{"FPAT"} if field matching with @code{FPAT} is in effect.
address@hidden PROCINFO["gid"]
address@hidden group ID of @command{gawk} user
+The value of the @code{getgid()} system call.
+
@item PROCINFO["identifiers"]
@cindex program identifiers
A subarray, indexed by the names of all identifiers used in the text of
@@ -14286,10 +14290,6 @@ The values indicate what @command{gawk} knows about
the identifiers
after it has finished parsing the program; they are @emph{not} updated
while the program runs.
address@hidden PROCINFO["gid"]
address@hidden group ID of @command{gawk} user
-The value of the @code{getgid()} system call.
-
@item PROCINFO["pgrpid"]
@cindex process group ID of @command{gawk} process
The process group ID of the current process.
@@ -14302,14 +14302,6 @@ The process ID of the current process.
@cindex parent process ID of @command{gawk} process
The parent process ID of the current process.
address@hidden PROCINFO["sorted_in"]
-If this element exists in @code{PROCINFO}, its value controls the
-order in which array indices will be processed by
address@hidden (@var{indx} in @var{array})} loops.
-This is an advanced feature, so we defer the
-full description until later; see
address@hidden an Array}.
-
@item PROCINFO["strftime"]
The default time format string for @code{strftime()}.
Assigning a new value to this element changes the default.
@@ -14369,21 +14361,26 @@ supplementary groups that the process has. Use the
@code{in} operator
to test for these elements
(@pxref{Reference to Elements}).
address@hidden @command{gawk}, @code{PROCINFO} array in
address@hidden @code{PROCINFO} array, uses
-The @code{PROCINFO} array has the following additional uses:
+The following elements allow you to change @command{gawk}'s behavior:
address@hidden @value{BULLET}
address@hidden
-It may be used to provide a timeout when reading from any
-open input file, pipe, or coprocess.
address@hidden @code
address@hidden PROCINFO["@var{command}", "pty"]
+For two-way communication to @var{command}, use a pseudo-tty instead
+of setting up a two-way pipe.
address@hidden I/O} for more information.
+
address@hidden PROCINFO["@var{input_name}", "READ_TIMEOUT"]
+Set a timeout for reading from input redirection @var{input_name}.
@DBXREF{Read Timeout} for more information.
address@hidden
-It may be used to cause coprocesses to communicate over pseudo-ttys
-instead of through two-way pipes; this is discussed further in
address@hidden I/O}.
address@hidden itemize
address@hidden PROCINFO["sorted_in"]
+If this element exists in @code{PROCINFO}, its value controls the
+order in which array indices will be processed by
address@hidden (@var{indx} in @var{array})} loops.
+This is an advanced feature, so we defer the
+full description until later; see
address@hidden an Array}.
address@hidden table
@cindex @code{RLENGTH} variable
@item @code{RLENGTH}
-----------------------------------------------------------------------
Summary of changes:
doc/ChangeLog | 5 +
doc/gawk.1 | 121 +++++----
doc/gawk.info | 795 +++++++++++++++++++++++++++----------------------------
doc/gawk.texi | 47 ++--
doc/gawktexi.in | 47 ++--
5 files changed, 510 insertions(+), 505 deletions(-)
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [gawk-diffs] [SCM] gawk branch, gawk-4.1-stable, updated. gawk-4.1.0-778-ged180ef,
Arnold Robbins <=