[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gawk-diffs] [SCM] gawk branch, master, updated. 2be6f33f68e1a8d412c8712
|
From: |
Arnold Robbins |
|
Subject: |
[gawk-diffs] [SCM] gawk branch, master, updated. 2be6f33f68e1a8d412c8712d8017fc7f3b318161 |
|
Date: |
Tue, 23 Apr 2013 19:27:37 +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, master has been updated
via 2be6f33f68e1a8d412c8712d8017fc7f3b318161 (commit)
from b3b12a680adb98a750228efbf8200fd2f66787dc (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=2be6f33f68e1a8d412c8712d8017fc7f3b318161
commit 2be6f33f68e1a8d412c8712d8017fc7f3b318161
Author: Arnold D. Robbins <address@hidden>
Date: Tue Apr 23 22:27:24 2013 +0300
More doc updates.
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 17f8adf..876ed35 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2013-04-23 Arnold D. Robbins <address@hidden>
+
+ * gawk.1: Start cleanup pass.
+ * awkcard.in: Minor addition.
+ * gawkman.texi: Minor fixes.
+
2013-04-21 Arnold D. Robbins <address@hidden>
* gawkman.texi: Update all the menus. Fix spelling errors. Remove
diff --git a/doc/awkcard.in b/doc/awkcard.in
index 3f3c802..9096988 100644
--- a/doc/awkcard.in
+++ b/doc/awkcard.in
@@ -703,6 +703,8 @@ element from an array.
Specifying just the array name without a subscript in
the \*(FCdelete\fP
statement deletes the entire contents of an array.
+\*(CBYou cannot use \*(FCdelete\fP with \*(FCFUNCTAB\fP
+or \*(FCSYMTAB\fP.\*(CD
.sp .5
\*(CB\*(GK provides true multidimensional arrays.
Such arrays need not be ``rectangular'' as in C or C++. For example:
diff --git a/doc/gawk.1 b/doc/gawk.1
index 90288db..b1d80c0 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -1,6 +1,5 @@
.ds PX \s-1POSIX\s+1
.ds UX \s-1UNIX\s+1
-.ds AN \s-1ANSI\s+1
.ds GN \s-1GNU\s+1
.ds AK \s-1AWK\s+1
.ds EP \fIGAWK: Effective AWK Programming\fP
@@ -14,7 +13,7 @@
. if \w'\(rq' .ds rq "\(rq
. \}
.\}
-.TH GAWK 1 "Dec 07 2012" "Free Software Foundation" "Utility Commands"
+.TH GAWK 1 "Apr 23 2012" "Free Software Foundation" "Utility Commands"
.SH NAME
gawk \- pattern scanning and processing language
.SH SYNOPSIS
@@ -60,7 +59,7 @@ and
.B ARGV
pre-defined \*(AK variables.
.PP
-When
+When
.I gawk
is invoked with the
.B \-\^\-profile
@@ -107,7 +106,7 @@ next command line argument.
Long options may be abbreviated, as long as the abbreviation
remains unique.
.PP
-Additionally, each long option has a corresponding short
+Additionally, every long option has a corresponding short
option, so that the option's functionality may be used from
within
.B #!
@@ -158,7 +157,7 @@ to the variable
before execution of the program begins.
Such variable values are available to the
.B BEGIN
-block of an \*(AK program.
+rule of an \*(AK program.
.TP
.PD 0
.B \-b
@@ -171,6 +170,7 @@ process strings as multibyte characters.
The
.B "\-\^\-posix"
option overrides this one.
+.bp
.TP
.PD 0
.B \-c
@@ -234,7 +234,7 @@ Enable debugging of \*(AK programs.
By default, the debugger reads commands interactively from the terminal.
The optional
.IR file
-argument can be used to specify a file with a list
+argument specifies a file with a list
of commands for the debugger to execute non-interactively.
.TP
.PD 0
@@ -304,8 +304,10 @@ Load an awk source library.
This searches for the library using the
.B AWKPATH
environment variable. If the initial search fails, another attempt will
-be made after appending the ".awk" suffix. The file will be loaded only
-once (i.e. duplicates are eliminated), and the code does not constitute
+be made after appending the
+.B \&.awk
+suffix. The file will be loaded only
+once (i.e., duplicates are eliminated), and the code does not constitute
the main program source.
.TP
.PD 0
@@ -347,7 +349,7 @@ actually invalid are issued. (This is not fully implemented
yet.)
Force arbitrary precision arithmetic on numbers. This option has
no effect if
.I gawk
-is not compiled to use the GNU MPFR and MP libraries.
+is not compiled to use the GNU MPFR and MP libraries.
.TP
.PD 0
.B \-n
@@ -415,12 +417,12 @@ elimination for recursive functions. The
maintainer hopes to add additional optimizations over time.
.TP
.PD 0
-\fB\-p\fR[\fIprof_file\fR]
+\fB\-p\fR[\fIprof-file\fR]
.TP
.PD
-\fB\-\^\-profile\fR[\fB=\fIprof_file\fR]
+\fB\-\^\-profile\fR[\fB=\fIprof-file\fR]
Start a profiling session, and send the profiling data to
-.IR prof_file .
+.IR prof-file .
The default is
.BR awkprof.out .
The profile contains execution counts of each statement in the program
@@ -487,7 +489,7 @@ and
.I egrep
consistent with each other.
They are enabled by default, but this option remains for use with
-.BR \-\^-traditional .
+.BR \-\^\-traditional .
.TP
.PD 0
.BI \-S
@@ -500,7 +502,7 @@ in sandbox mode, disabling the
.B system()
function, input redirection with
.BR getline ,
-output redirection with
+output redirection with
.BR print " and " printf ,
and loading dynamic extensions.
Command execution (through pipelines) is also disabled.
@@ -513,7 +515,7 @@ This effectively blocks a script from accessing local
resources
.PD
.B \-\^\-lint\-old
Provide warnings about constructs that are
-not portable to the original version of Unix
+not portable to the original version of \*(UX
.IR awk .
.TP
.PD 0
@@ -547,6 +549,10 @@ options are passed on to the \*(AK program in the
.B ARGV
array for processing. This is particularly useful for running \*(AK
programs via the \*(lq#!\*(rq executable interpreter mechanism.
+.PP
+For \*(PX compatibility, the
+.B \-W
+option may be used, followed by the name of a long option.
.SH AWK PROGRAM EXECUTION
.PP
An \*(AK program consists of a sequence of pattern-action statements
@@ -586,13 +592,16 @@ functions with command line programs.
In addition, lines beginning with
.B @include
may be used to include other source files into your program,
-making library use even easier.
+making library use even easier. This is equivalent
+to using the
+.B \-i
+option.
.PP
Lines beginning with
.B @load
may be used to load shared libraries into your program. This is equivalent
to using the
-.B \-l
+.B \-l
option.
.PP
The environment variable
@@ -611,6 +620,17 @@ If a file name given to the
.B \-f
option contains a \*(lq/\*(rq character, no path search is performed.
.PP
+The environment variable
+.B AWKLIBPATH
+specifies a search path to use when finding source files named with
+the
+.B \-l
+option. If this variable does not exist, the default path is
+\fB".:/usr/local/lib/gawk"\fR.
+(The actual directory may vary, depending upon how
+.I gawk
+was built and installed.)
+.PP
.I Gawk
executes \*(AK programs in the following order.
First,
@@ -624,7 +644,7 @@ Then,
.I gawk
executes the code in the
.B BEGIN
-block(s) (if any),
+rule(s) (if any),
and then proceeds to read
each file named in the
.B ARGV
@@ -642,7 +662,7 @@ will be assigned the value
.IR val .
(This happens after any
.B BEGIN
-block(s) have been run.)
+rule(s) have been run.)
Command line variable assignment
is most useful for dynamically assigning values to the variables
\*(AK uses to control how input is broken into fields and records.
@@ -673,16 +693,17 @@ For each record in the input,
tests to see if it matches any
.I pattern
in the \*(AK program.
-For each pattern that the record matches, the associated
-.I action
-is executed.
+For each pattern that the record matches,
+.I gawk
+executes the associated
+.IR action .
The patterns are tested in the order they occur in the program.
.PP
Finally, after all the input is exhausted,
.I gawk
executes the code in the
.B END
-block(s) (if any).
+rule(s) (if any).
.SS Command Line Directories
.PP
According to POSIX, files named on the
@@ -710,6 +731,10 @@ first used. Their values are either floating-point
numbers or strings,
or both,
depending upon how they are used. \*(AK also has one dimensional
arrays; arrays with multiple dimensions may be simulated.
+.I Gawk
+provides true arrays of arrays; see
+.BR Arrays ,
+below.
Several pre-defined variables are set as a program
runs; these are described as needed and summarized below.
.SS Records
@@ -799,7 +824,7 @@ or
overrides the use of
.BR FPAT .
.PP
-Each field in the input record may be referenced by its position,
+Each field in the input record may be referenced by its position:
.BR $1 ,
.BR $2 ,
and so on.
@@ -821,14 +846,14 @@ The variable
.B NF
is set to the total number of fields in the input record.
.PP
-References to non-existent fields (i.e. fields after
+References to non-existent fields (i.e., fields after
.BR $NF )
produce the null-string. However, assigning to a non-existent field
(e.g.,
.BR "$(NF+2) = 5" )
increases the value of
.BR NF ,
-creates any intervening fields with the null string as their value, and
+creates any intervening fields with the null string as their values, and
causes the value of
.B $0
to be recomputed, with the fields being separated by the value of
@@ -891,7 +916,7 @@ The conversion format for numbers, \fB"%.6g"\fR, by default.
An array containing the values of the current environment.
The array is indexed by the environment variables, each element being
the value of that variable (e.g., \fBENVIRON["HOME"]\fP might be
-.BR /home/arnold ).
+\fB"/home/arnold"\fR).
Changing this array does not affect the environment seen by programs which
.I gawk
spawns via redirection or the
@@ -931,7 +956,7 @@ However,
.B FILENAME
is undefined inside the
.B BEGIN
-block
+rule
(unless set by
.BR getline ).
.TP
@@ -958,11 +983,11 @@ The input field separator, a space by default. See
above.
.TP
.B FUNCTAB
-An array whose indices are the names of all the user-defined
+An array whose indices and corresponding values
+are the names of all the user-defined
or extension functions in the program.
.BR NOTE :
-The array values cannot currently be used.
-Also, you may not use the
+You may not use the
.B delete
statment with the
.B FUNCTAB
@@ -1063,7 +1088,7 @@ The following elements are guaranteed to be available:
.RS
.TP \w'\fBPROCINFO["version"]\fR'u+1n
\fBPROCINFO["egid"]\fP
-the value of the
+The value of the
.IR getegid (2)
system call.
.TP
@@ -1072,7 +1097,7 @@ The default time format string for
.BR strftime() .
.TP
\fBPROCINFO["euid"]\fP
-the value of the
+The value of the
.IR geteuid (2)
system call.
.TP
@@ -1089,7 +1114,13 @@ is in effect.
.TP
\fBPROCINFO["identifiers"]\fP
A subarray, indexed by the names of all identifiers used in the
-text of the AWK program. For each identifier, the value of the element is one
of the following:
+text of the AWK program.
+The values indicate what
+.I gawk
+knows about the identifiers after it has finished parsing the program; they are
+.I not
+updated while the program runs.
+For each identifier, the value of the element is one of the following:
.RS
.TP
\fB"array"\fR
@@ -1110,28 +1141,23 @@ doesn't know yet).
\fB"user"\fR
The identifier is a user-defined function.
.RE
-The values indicate what
-.I gawk
-knows about the identifiers after it has finished parsing the program; they are
-.I not
-updated while the program runs.
.TP
\fBPROCINFO["gid"]\fP
-the value of the
+The value of the
.IR getgid (2)
system call.
.TP
\fBPROCINFO["pgrpid"]\fP
-the process group ID of the current process.
+The process group ID of the current process.
.TP
\fBPROCINFO["pid"]\fP
-the process ID of the current process.
+The process ID of the current process.
.TP
\fBPROCINFO["ppid"]\fP
-the parent process ID of the current process.
+The parent process ID of the current process.
.TP
\fBPROCINFO["uid"]\fP
-the value of the
+The value of the
.IR getuid (2)
system call.
.TP
@@ -1157,11 +1183,11 @@ and
\fB"@unsorted"\fR.
The value can also be the name of any comparison function defined
as follows:
-.PP
-.RS
+.sp
+.in +5m
\fBfunction cmp_func(i1, v1, i2, v2)\fR
-.RE
-.PP
+.in -5m
+.sp
where
.I i1
and
@@ -1176,7 +1202,7 @@ 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
-specifies the timeout in milliseconds for reading data from
+The timeout in milliseconds for reading data from
.IR input ,
where
.I input
@@ -1184,22 +1210,30 @@ 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
+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
+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
+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
+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["version"]\fP
the version of
@@ -1248,15 +1282,17 @@ elements, by default \fB"\e034"\fR.
An array whose indices are the names of all currently defined
global variables and arrays in the program. The array may be used
for indirect access to read or write the value of a variable:
-.PP
-.RS
+.sp
.ft B
+.nf
+.in +5m
foo = 5
SYMTAB["foo"] = 4
print foo # prints 4
+.fi
.ft R
-.RE
-.PP
+.in -5m
+.sp
The
.B isarray()
function may be used to test if an element in
@@ -1296,7 +1332,7 @@ x[i, j, k] = "hello, world\en"
assigns the string \fB"hello, world\en"\fR to the element of the array
.B x
which is indexed by the string \fB"A\e034B\e034C"\fR. All arrays in \*(AK
-are associative, i.e. indexed by string values.
+are associative, i.e., indexed by string values.
.PP
The special operator
.B in
@@ -1333,6 +1369,7 @@ just by specifying the array name without a subscript.
supports true multidimensional arrays. It does not require that
such arrays be ``rectangular'' as in C or C++.
For example:
+.sp
.RS
.ft B
.nf
@@ -1469,7 +1506,7 @@ vertical tab.
The character represented by the string of hexadecimal digits following
the
.BR \ex .
-As in \*(AN C, all following hexadecimal digits are considered part of
+As in ISO C, all following hexadecimal digits are considered part of
the escape sequence.
(This feature should tell us something about language design by committee.)
E.g., \fB"\ex1B"\fR is the \s-1ASCII\s+1 \s-1ESC\s+1 (escape) character.
@@ -1568,10 +1605,10 @@ The action parts of all
patterns are merged as if all the statements had
been written in a single
.B BEGIN
-block. They are executed before any
+rule. They are executed before any
of the input is read. Similarly, all the
.B END
-blocks are merged,
+rules are merged,
and executed when all the input is exhausted (or when an
.B exit
statement is executed).
@@ -1918,7 +1955,7 @@ matches a literal
.BR w ).
.TP
.B \-\^\-traditional
-Traditional Unix
+Traditional \*(UX
.I awk
regular expressions are matched. The \*(GN operators
are not special, and interval expressions are not available.
@@ -2122,7 +2159,7 @@ Stop processing the current input record. The next input
record
is read and processing starts over with the first pattern in the
\*(AK program. If the end of the input data is reached, the
.B END
-block(s), if any, are executed.
+rule(s), if any, are executed.
.TP
.B "nextfile"
Stop processing the current input file. The next input record read
@@ -2135,7 +2172,7 @@ are updated,
is reset to 1, and processing starts over with the first pattern in the
\*(AK program. If the end of the input data is reached, the
.B END
-block(s), if any, are executed.
+rule(s), if any, are executed.
.TP
.B print
Print the current record.
@@ -2415,7 +2452,7 @@ The dynamic
.I width
and
.I prec
-capabilities of the \*(AN C
+capabilities of the ISO C
.B printf()
routines are supported.
A
@@ -2843,7 +2880,7 @@ and trailing whitespace goes into the extra array element
.IR seps[n] ,
where
.I n
-is the return value of
+is the return value of
.IR "split(s, a, r, seps)" .
Splitting behaves identically to field splitting, described above.
.TP
@@ -2991,7 +3028,7 @@ The default format is available in
.BR PROCINFO["strftime"] .
See the specification for the
.B strftime()
-function in \*(AN C for the format conversions that are
+function in ISO C for the format conversions that are
guaranteed to be available.
.TP
.B systime()
@@ -3053,7 +3090,7 @@ For full details, see \*(EP.
Specify the directory where
.I gawk
looks for the
-.B \&.mo
+.B \&.gmo
files, in case they
will not or cannot be placed in the ``standard'' locations
(e.g., during testing).
@@ -3278,7 +3315,7 @@ BEGIN { TEXTDOMAIN = "myprog" }
This allows
.I gawk
to find the
-.B \&.mo
+.B \&.gmo
file associated with your program.
Without this step,
.I gawk
@@ -3306,7 +3343,7 @@ file for your program.
.TP
5.
Provide appropriate translations, and build and install the corresponding
-.B \&.mo
+.B \&.gmo
files.
.PP
The internationalization features are described in full detail in \*(EP.
@@ -3328,12 +3365,12 @@ The book indicates that command line variable
assignment happens when
.I awk
would otherwise open the argument as a file, which is after the
.B BEGIN
-block is executed. However, in earlier implementations, when such an
+rule is executed. However, in earlier implementations, when such an
assignment appeared before any file names, the assignment would happen
.I before
the
.B BEGIN
-block was run. Applications came to depend on this \*(lqfeature.\*(rq
+rule was run. Applications came to depend on this \*(lqfeature.\*(rq
When
.I awk
was changed to match its documentation, the
@@ -3378,7 +3415,7 @@ and fed back into the Bell Laboratories version); the
.B tolower()
and
.B toupper()
-built-in functions (from the Bell Laboratories version); and the \*(AN C
conversion specifications in
+built-in functions (from the Bell Laboratories version); and the ISO C
conversion specifications in
.B printf
(done first in the Bell Laboratories version).
.SH HISTORICAL FEATURES
@@ -3441,7 +3478,7 @@ environment variable is not special.
.\" POSIX and language recognition issues
.TP
\(bu
-There is no facility for doing file inclusion
+There is no facility for doing file inclusion
.RI ( gawk 's
.B @include
mechanism).
@@ -3920,3 +3957,5 @@ Permission is granted to copy and distribute translations
of this
manual page into another language, under the above conditions for
modified versions, except that this permission notice may be stated in
a translation approved by the Foundation.
+.\" ---------------
+.\" Unix / UX -> BWK
diff --git a/doc/gawk.info b/doc/gawk.info
index 5e29450..63b5a2a 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -9734,10 +9734,10 @@ with a pound sign (`#').
Fields::.
`FUNCTAB #'
- An array whose indices are the names of all the user-defined or
- extension functions in the program. *NOTE*: The array values
- cannot currently be used. Also, you may not use the `delete'
- statement with the `FUNCTAB' array.
+ An array whose indices and corresponding values are the names of
+ all the user-defined or extension functions in the program.
+ *NOTE*: You may not use the `delete' statement with the `FUNCTAB'
+ array.
`NR'
The number of input records `awk' has processed since the
@@ -32163,333 +32163,333 @@ Node: Built-in Variables402841
Node: User-modified403936
Ref: User-modified-Footnote-1412291
Node: Auto-set412353
-Ref: Auto-set-Footnote-1424903
-Ref: Auto-set-Footnote-2425108
-Node: ARGC and ARGV425164
-Node: Arrays429015
-Node: Array Basics430520
-Node: Array Intro431346
-Node: Reference to Elements435664
-Node: Assigning Elements437934
-Node: Array Example438425
-Node: Scanning an Array440157
-Node: Controlling Scanning442471
-Ref: Controlling Scanning-Footnote-1447394
-Node: Delete447710
-Ref: Delete-Footnote-1450475
-Node: Numeric Array Subscripts450532
-Node: Uninitialized Subscripts452715
-Node: Multi-dimensional454343
-Node: Multi-scanning457437
-Node: Arrays of Arrays459028
-Node: Functions463669
-Node: Built-in464488
-Node: Calling Built-in465566
-Node: Numeric Functions467554
-Ref: Numeric Functions-Footnote-1471386
-Ref: Numeric Functions-Footnote-2471743
-Ref: Numeric Functions-Footnote-3471791
-Node: String Functions472060
-Ref: String Functions-Footnote-1495557
-Ref: String Functions-Footnote-2495686
-Ref: String Functions-Footnote-3495934
-Node: Gory Details496021
-Ref: table-sub-escapes497700
-Ref: table-sub-posix-92499054
-Ref: table-sub-proposed500405
-Ref: table-posix-sub501759
-Ref: table-gensub-escapes503304
-Ref: Gory Details-Footnote-1504480
-Ref: Gory Details-Footnote-2504531
-Node: I/O Functions504682
-Ref: I/O Functions-Footnote-1511667
-Node: Time Functions511814
-Ref: Time Functions-Footnote-1522747
-Ref: Time Functions-Footnote-2522815
-Ref: Time Functions-Footnote-3522973
-Ref: Time Functions-Footnote-4523084
-Ref: Time Functions-Footnote-5523196
-Ref: Time Functions-Footnote-6523423
-Node: Bitwise Functions523689
-Ref: table-bitwise-ops524247
-Ref: Bitwise Functions-Footnote-1528468
-Node: Type Functions528652
-Node: I18N Functions529122
-Node: User-defined530749
-Node: Definition Syntax531553
-Ref: Definition Syntax-Footnote-1536463
-Node: Function Example536532
-Node: Function Caveats539126
-Node: Calling A Function539547
-Node: Variable Scope540662
-Node: Pass By Value/Reference543625
-Node: Return Statement547133
-Node: Dynamic Typing550114
-Node: Indirect Calls551045
-Node: Library Functions560730
-Ref: Library Functions-Footnote-1564243
-Ref: Library Functions-Footnote-2564386
-Node: Library Names564557
-Ref: Library Names-Footnote-1568028
-Ref: Library Names-Footnote-2568248
-Node: General Functions568334
-Node: Strtonum Function569287
-Node: Assert Function572217
-Node: Round Function575543
-Node: Cliff Random Function577086
-Node: Ordinal Functions578102
-Ref: Ordinal Functions-Footnote-1581172
-Ref: Ordinal Functions-Footnote-2581424
-Node: Join Function581633
-Ref: Join Function-Footnote-1583404
-Node: Getlocaltime Function583604
-Node: Data File Management587319
-Node: Filetrans Function587951
-Node: Rewind Function592020
-Node: File Checking593407
-Node: Empty Files594501
-Node: Ignoring Assigns596731
-Node: Getopt Function598284
-Ref: Getopt Function-Footnote-1609588
-Node: Passwd Functions609791
-Ref: Passwd Functions-Footnote-1618766
-Node: Group Functions618854
-Node: Walking Arrays626938
-Node: Sample Programs629075
-Node: Running Examples629749
-Node: Clones630477
-Node: Cut Program631701
-Node: Egrep Program641546
-Ref: Egrep Program-Footnote-1649319
-Node: Id Program649429
-Node: Split Program653045
-Ref: Split Program-Footnote-1656564
-Node: Tee Program656692
-Node: Uniq Program659495
-Node: Wc Program666924
-Ref: Wc Program-Footnote-1671190
-Ref: Wc Program-Footnote-2671390
-Node: Miscellaneous Programs671482
-Node: Dupword Program672670
-Node: Alarm Program674701
-Node: Translate Program679450
-Ref: Translate Program-Footnote-1683837
-Ref: Translate Program-Footnote-2684065
-Node: Labels Program684199
-Ref: Labels Program-Footnote-1687570
-Node: Word Sorting687654
-Node: History Sorting691538
-Node: Extract Program693377
-Ref: Extract Program-Footnote-1700878
-Node: Simple Sed701006
-Node: Igawk Program704068
-Ref: Igawk Program-Footnote-1719225
-Ref: Igawk Program-Footnote-2719426
-Node: Anagram Program719564
-Node: Signature Program722632
-Node: Advanced Features723732
-Node: Nondecimal Data725614
-Node: Array Sorting727197
-Node: Controlling Array Traversal727894
-Node: Array Sorting Functions736132
-Ref: Array Sorting Functions-Footnote-1739806
-Ref: Array Sorting Functions-Footnote-2739899
-Node: Two-way I/O740093
-Ref: Two-way I/O-Footnote-1745525
-Node: TCP/IP Networking745595
-Node: Profiling748439
-Node: Internationalization755894
-Node: I18N and L10N757319
-Node: Explaining gettext758005
-Ref: Explaining gettext-Footnote-1763071
-Ref: Explaining gettext-Footnote-2763255
-Node: Programmer i18n763420
-Node: Translator i18n767620
-Node: String Extraction768413
-Ref: String Extraction-Footnote-1769374
-Node: Printf Ordering769460
-Ref: Printf Ordering-Footnote-1772244
-Node: I18N Portability772308
-Ref: I18N Portability-Footnote-1774757
-Node: I18N Example774820
-Ref: I18N Example-Footnote-1777455
-Node: Gawk I18N777527
-Node: Debugger778148
-Node: Debugging779119
-Node: Debugging Concepts779552
-Node: Debugging Terms781408
-Node: Awk Debugging784005
-Node: Sample Debugging Session784897
-Node: Debugger Invocation785417
-Node: Finding The Bug786749
-Node: List of Debugger Commands793237
-Node: Breakpoint Control794571
-Node: Debugger Execution Control798235
-Node: Viewing And Changing Data801595
-Node: Execution Stack804951
-Node: Debugger Info806418
-Node: Miscellaneous Debugger Commands810400
-Node: Readline Support815576
-Node: Limitations816407
-Node: Arbitrary Precision Arithmetic818659
-Ref: Arbitrary Precision Arithmetic-Footnote-1820310
-Node: General Arithmetic820458
-Node: Floating Point Issues822178
-Node: String Conversion Precision823059
-Ref: String Conversion Precision-Footnote-1824765
-Node: Unexpected Results824874
-Node: POSIX Floating Point Problems827027
-Ref: POSIX Floating Point Problems-Footnote-1830852
-Node: Integer Programming830890
-Node: Floating-point Programming832643
-Ref: Floating-point Programming-Footnote-1838952
-Node: Floating-point Representation839216
-Node: Floating-point Context840381
-Ref: table-ieee-formats841223
-Node: Rounding Mode842607
-Ref: table-rounding-modes843086
-Ref: Rounding Mode-Footnote-1846090
-Node: Gawk and MPFR846271
-Node: Arbitrary Precision Floats847513
-Ref: Arbitrary Precision Floats-Footnote-1849942
-Node: Setting Precision850253
-Node: Setting Rounding Mode852986
-Ref: table-gawk-rounding-modes853390
-Node: Floating-point Constants854570
-Node: Changing Precision855994
-Ref: Changing Precision-Footnote-1857394
-Node: Exact Arithmetic857568
-Node: Arbitrary Precision Integers860676
-Ref: Arbitrary Precision Integers-Footnote-1863676
-Node: Dynamic Extensions863823
-Node: Extension Intro865200
-Node: Plugin License866408
-Node: Extension Mechanism Outline867093
-Ref: load-extension867510
-Ref: load-new-function868988
-Ref: call-new-function869983
-Node: Extension API Description871991
-Node: Extension API Functions Introduction873323
-Node: General Data Types878101
-Ref: General Data Types-Footnote-1883703
-Node: Requesting Values884002
-Ref: table-value-types-returned884733
-Node: Constructor Functions885687
-Node: Registration Functions888683
-Node: Extension Functions889368
-Node: Exit Callback Functions891542
-Node: Extension Version String892785
-Node: Input Parsers893435
-Node: Output Wrappers903152
-Node: Two-way processors907568
-Node: Printing Messages909698
-Ref: Printing Messages-Footnote-1910775
-Node: Updating `ERRNO'910927
-Node: Accessing Parameters911666
-Node: Symbol Table Access912896
-Node: Symbol table by name913408
-Node: Symbol table by cookie914981
-Ref: Symbol table by cookie-Footnote-1919110
-Node: Cached values919173
-Ref: Cached values-Footnote-1922616
-Node: Array Manipulation922707
-Ref: Array Manipulation-Footnote-1923805
-Node: Array Data Types923844
-Ref: Array Data Types-Footnote-1926547
-Node: Array Functions926639
-Node: Flattening Arrays930405
-Node: Creating Arrays937244
-Node: Extension API Variables942039
-Node: Extension Versioning942675
-Node: Extension API Informational Variables944576
-Node: Extension API Boilerplate945662
-Node: Finding Extensions949493
-Node: Extension Example950040
-Node: Internal File Description950778
-Node: Internal File Ops954466
-Ref: Internal File Ops-Footnote-1965913
-Node: Using Internal File Ops966053
-Ref: Using Internal File Ops-Footnote-1968406
-Node: Extension Samples968672
-Node: Extension Sample File Functions970196
-Node: Extension Sample Fnmatch978669
-Node: Extension Sample Fork980395
-Node: Extension Sample Inplace981613
-Node: Extension Sample Ord983391
-Node: Extension Sample Readdir984170
-Node: Extension Sample Revout985674
-Node: Extension Sample Rev2way986267
-Node: Extension Sample Read write array986957
-Node: Extension Sample Readfile988840
-Node: Extension Sample API Tests989597
-Node: Extension Sample Time990122
-Node: gawkextlib991429
-Node: Language History993810
-Node: V7/SVR3.1995332
-Node: SVR4997653
-Node: POSIX999095
-Node: BTL1000481
-Node: POSIX/GNU1001215
-Node: Common Extensions1006750
-Node: Ranges and Locales1007905
-Ref: Ranges and Locales-Footnote-11012523
-Ref: Ranges and Locales-Footnote-21012550
-Ref: Ranges and Locales-Footnote-31012810
-Node: Contributors1013031
-Node: Installation1017835
-Node: Gawk Distribution1018729
-Node: Getting1019213
-Node: Extracting1020039
-Node: Distribution contents1021731
-Node: Unix Installation1026992
-Node: Quick Installation1027609
-Node: Additional Configuration Options1029571
-Node: Configuration Philosophy1031048
-Node: Non-Unix Installation1033390
-Node: PC Installation1033848
-Node: PC Binary Installation1035147
-Node: PC Compiling1036995
-Node: PC Testing1039939
-Node: PC Using1041115
-Node: Cygwin1045300
-Node: MSYS1046300
-Node: VMS Installation1046814
-Node: VMS Compilation1047417
-Ref: VMS Compilation-Footnote-11048424
-Node: VMS Installation Details1048482
-Node: VMS Running1050117
-Node: VMS Old Gawk1051724
-Node: Bugs1052198
-Node: Other Versions1056050
-Node: Notes1061651
-Node: Compatibility Mode1062451
-Node: Additions1063234
-Node: Accessing The Source1064161
-Node: Adding Code1065601
-Node: New Ports1071646
-Node: Derived Files1075781
-Ref: Derived Files-Footnote-11081102
-Ref: Derived Files-Footnote-21081136
-Ref: Derived Files-Footnote-31081736
-Node: Future Extensions1081834
-Node: Implementation Limitations1082415
-Node: Extension Design1083667
-Node: Old Extension Problems1084816
-Ref: Old Extension Problems-Footnote-11086324
-Node: Extension New Mechanism Goals1086381
-Ref: Extension New Mechanism Goals-Footnote-11089740
-Node: Extension Other Design Decisions1089926
-Node: Extension Future Growth1092032
-Node: Old Extension Mechanism1092853
-Node: Basic Concepts1094593
-Node: Basic High Level1095274
-Ref: figure-general-flow1095545
-Ref: figure-process-flow1096144
-Ref: Basic High Level-Footnote-11099373
-Node: Basic Data Typing1099558
-Node: Glossary1102913
-Node: Copying1128384
-Node: GNU Free Documentation License1165941
-Node: Index1191078
+Ref: Auto-set-Footnote-1424877
+Ref: Auto-set-Footnote-2425082
+Node: ARGC and ARGV425138
+Node: Arrays428989
+Node: Array Basics430494
+Node: Array Intro431320
+Node: Reference to Elements435638
+Node: Assigning Elements437908
+Node: Array Example438399
+Node: Scanning an Array440131
+Node: Controlling Scanning442445
+Ref: Controlling Scanning-Footnote-1447368
+Node: Delete447684
+Ref: Delete-Footnote-1450449
+Node: Numeric Array Subscripts450506
+Node: Uninitialized Subscripts452689
+Node: Multi-dimensional454317
+Node: Multi-scanning457411
+Node: Arrays of Arrays459002
+Node: Functions463643
+Node: Built-in464462
+Node: Calling Built-in465540
+Node: Numeric Functions467528
+Ref: Numeric Functions-Footnote-1471360
+Ref: Numeric Functions-Footnote-2471717
+Ref: Numeric Functions-Footnote-3471765
+Node: String Functions472034
+Ref: String Functions-Footnote-1495531
+Ref: String Functions-Footnote-2495660
+Ref: String Functions-Footnote-3495908
+Node: Gory Details495995
+Ref: table-sub-escapes497674
+Ref: table-sub-posix-92499028
+Ref: table-sub-proposed500379
+Ref: table-posix-sub501733
+Ref: table-gensub-escapes503278
+Ref: Gory Details-Footnote-1504454
+Ref: Gory Details-Footnote-2504505
+Node: I/O Functions504656
+Ref: I/O Functions-Footnote-1511641
+Node: Time Functions511788
+Ref: Time Functions-Footnote-1522721
+Ref: Time Functions-Footnote-2522789
+Ref: Time Functions-Footnote-3522947
+Ref: Time Functions-Footnote-4523058
+Ref: Time Functions-Footnote-5523170
+Ref: Time Functions-Footnote-6523397
+Node: Bitwise Functions523663
+Ref: table-bitwise-ops524221
+Ref: Bitwise Functions-Footnote-1528442
+Node: Type Functions528626
+Node: I18N Functions529096
+Node: User-defined530723
+Node: Definition Syntax531527
+Ref: Definition Syntax-Footnote-1536437
+Node: Function Example536506
+Node: Function Caveats539100
+Node: Calling A Function539521
+Node: Variable Scope540636
+Node: Pass By Value/Reference543599
+Node: Return Statement547107
+Node: Dynamic Typing550088
+Node: Indirect Calls551019
+Node: Library Functions560704
+Ref: Library Functions-Footnote-1564217
+Ref: Library Functions-Footnote-2564360
+Node: Library Names564531
+Ref: Library Names-Footnote-1568002
+Ref: Library Names-Footnote-2568222
+Node: General Functions568308
+Node: Strtonum Function569261
+Node: Assert Function572191
+Node: Round Function575517
+Node: Cliff Random Function577060
+Node: Ordinal Functions578076
+Ref: Ordinal Functions-Footnote-1581146
+Ref: Ordinal Functions-Footnote-2581398
+Node: Join Function581607
+Ref: Join Function-Footnote-1583378
+Node: Getlocaltime Function583578
+Node: Data File Management587293
+Node: Filetrans Function587925
+Node: Rewind Function591994
+Node: File Checking593381
+Node: Empty Files594475
+Node: Ignoring Assigns596705
+Node: Getopt Function598258
+Ref: Getopt Function-Footnote-1609562
+Node: Passwd Functions609765
+Ref: Passwd Functions-Footnote-1618740
+Node: Group Functions618828
+Node: Walking Arrays626912
+Node: Sample Programs629049
+Node: Running Examples629723
+Node: Clones630451
+Node: Cut Program631675
+Node: Egrep Program641520
+Ref: Egrep Program-Footnote-1649293
+Node: Id Program649403
+Node: Split Program653019
+Ref: Split Program-Footnote-1656538
+Node: Tee Program656666
+Node: Uniq Program659469
+Node: Wc Program666898
+Ref: Wc Program-Footnote-1671164
+Ref: Wc Program-Footnote-2671364
+Node: Miscellaneous Programs671456
+Node: Dupword Program672644
+Node: Alarm Program674675
+Node: Translate Program679424
+Ref: Translate Program-Footnote-1683811
+Ref: Translate Program-Footnote-2684039
+Node: Labels Program684173
+Ref: Labels Program-Footnote-1687544
+Node: Word Sorting687628
+Node: History Sorting691512
+Node: Extract Program693351
+Ref: Extract Program-Footnote-1700852
+Node: Simple Sed700980
+Node: Igawk Program704042
+Ref: Igawk Program-Footnote-1719199
+Ref: Igawk Program-Footnote-2719400
+Node: Anagram Program719538
+Node: Signature Program722606
+Node: Advanced Features723706
+Node: Nondecimal Data725588
+Node: Array Sorting727171
+Node: Controlling Array Traversal727868
+Node: Array Sorting Functions736106
+Ref: Array Sorting Functions-Footnote-1739780
+Ref: Array Sorting Functions-Footnote-2739873
+Node: Two-way I/O740067
+Ref: Two-way I/O-Footnote-1745499
+Node: TCP/IP Networking745569
+Node: Profiling748413
+Node: Internationalization755868
+Node: I18N and L10N757293
+Node: Explaining gettext757979
+Ref: Explaining gettext-Footnote-1763045
+Ref: Explaining gettext-Footnote-2763229
+Node: Programmer i18n763394
+Node: Translator i18n767594
+Node: String Extraction768387
+Ref: String Extraction-Footnote-1769348
+Node: Printf Ordering769434
+Ref: Printf Ordering-Footnote-1772218
+Node: I18N Portability772282
+Ref: I18N Portability-Footnote-1774731
+Node: I18N Example774794
+Ref: I18N Example-Footnote-1777429
+Node: Gawk I18N777501
+Node: Debugger778122
+Node: Debugging779093
+Node: Debugging Concepts779526
+Node: Debugging Terms781382
+Node: Awk Debugging783979
+Node: Sample Debugging Session784871
+Node: Debugger Invocation785391
+Node: Finding The Bug786723
+Node: List of Debugger Commands793211
+Node: Breakpoint Control794545
+Node: Debugger Execution Control798209
+Node: Viewing And Changing Data801569
+Node: Execution Stack804925
+Node: Debugger Info806392
+Node: Miscellaneous Debugger Commands810374
+Node: Readline Support815550
+Node: Limitations816381
+Node: Arbitrary Precision Arithmetic818633
+Ref: Arbitrary Precision Arithmetic-Footnote-1820284
+Node: General Arithmetic820432
+Node: Floating Point Issues822152
+Node: String Conversion Precision823033
+Ref: String Conversion Precision-Footnote-1824739
+Node: Unexpected Results824848
+Node: POSIX Floating Point Problems827001
+Ref: POSIX Floating Point Problems-Footnote-1830826
+Node: Integer Programming830864
+Node: Floating-point Programming832617
+Ref: Floating-point Programming-Footnote-1838926
+Node: Floating-point Representation839190
+Node: Floating-point Context840355
+Ref: table-ieee-formats841197
+Node: Rounding Mode842581
+Ref: table-rounding-modes843060
+Ref: Rounding Mode-Footnote-1846064
+Node: Gawk and MPFR846245
+Node: Arbitrary Precision Floats847487
+Ref: Arbitrary Precision Floats-Footnote-1849916
+Node: Setting Precision850227
+Node: Setting Rounding Mode852960
+Ref: table-gawk-rounding-modes853364
+Node: Floating-point Constants854544
+Node: Changing Precision855968
+Ref: Changing Precision-Footnote-1857368
+Node: Exact Arithmetic857542
+Node: Arbitrary Precision Integers860650
+Ref: Arbitrary Precision Integers-Footnote-1863650
+Node: Dynamic Extensions863797
+Node: Extension Intro865174
+Node: Plugin License866382
+Node: Extension Mechanism Outline867067
+Ref: load-extension867484
+Ref: load-new-function868962
+Ref: call-new-function869957
+Node: Extension API Description871965
+Node: Extension API Functions Introduction873297
+Node: General Data Types878075
+Ref: General Data Types-Footnote-1883677
+Node: Requesting Values883976
+Ref: table-value-types-returned884707
+Node: Constructor Functions885661
+Node: Registration Functions888657
+Node: Extension Functions889342
+Node: Exit Callback Functions891516
+Node: Extension Version String892759
+Node: Input Parsers893409
+Node: Output Wrappers903126
+Node: Two-way processors907542
+Node: Printing Messages909672
+Ref: Printing Messages-Footnote-1910749
+Node: Updating `ERRNO'910901
+Node: Accessing Parameters911640
+Node: Symbol Table Access912870
+Node: Symbol table by name913382
+Node: Symbol table by cookie914955
+Ref: Symbol table by cookie-Footnote-1919084
+Node: Cached values919147
+Ref: Cached values-Footnote-1922590
+Node: Array Manipulation922681
+Ref: Array Manipulation-Footnote-1923779
+Node: Array Data Types923818
+Ref: Array Data Types-Footnote-1926521
+Node: Array Functions926613
+Node: Flattening Arrays930379
+Node: Creating Arrays937218
+Node: Extension API Variables942013
+Node: Extension Versioning942649
+Node: Extension API Informational Variables944550
+Node: Extension API Boilerplate945636
+Node: Finding Extensions949467
+Node: Extension Example950014
+Node: Internal File Description950752
+Node: Internal File Ops954440
+Ref: Internal File Ops-Footnote-1965887
+Node: Using Internal File Ops966027
+Ref: Using Internal File Ops-Footnote-1968380
+Node: Extension Samples968646
+Node: Extension Sample File Functions970170
+Node: Extension Sample Fnmatch978643
+Node: Extension Sample Fork980369
+Node: Extension Sample Inplace981587
+Node: Extension Sample Ord983365
+Node: Extension Sample Readdir984144
+Node: Extension Sample Revout985648
+Node: Extension Sample Rev2way986241
+Node: Extension Sample Read write array986931
+Node: Extension Sample Readfile988814
+Node: Extension Sample API Tests989571
+Node: Extension Sample Time990096
+Node: gawkextlib991403
+Node: Language History993784
+Node: V7/SVR3.1995306
+Node: SVR4997627
+Node: POSIX999069
+Node: BTL1000455
+Node: POSIX/GNU1001189
+Node: Common Extensions1006724
+Node: Ranges and Locales1007879
+Ref: Ranges and Locales-Footnote-11012497
+Ref: Ranges and Locales-Footnote-21012524
+Ref: Ranges and Locales-Footnote-31012784
+Node: Contributors1013005
+Node: Installation1017809
+Node: Gawk Distribution1018703
+Node: Getting1019187
+Node: Extracting1020013
+Node: Distribution contents1021705
+Node: Unix Installation1026966
+Node: Quick Installation1027583
+Node: Additional Configuration Options1029545
+Node: Configuration Philosophy1031022
+Node: Non-Unix Installation1033364
+Node: PC Installation1033822
+Node: PC Binary Installation1035121
+Node: PC Compiling1036969
+Node: PC Testing1039913
+Node: PC Using1041089
+Node: Cygwin1045274
+Node: MSYS1046274
+Node: VMS Installation1046788
+Node: VMS Compilation1047391
+Ref: VMS Compilation-Footnote-11048398
+Node: VMS Installation Details1048456
+Node: VMS Running1050091
+Node: VMS Old Gawk1051698
+Node: Bugs1052172
+Node: Other Versions1056024
+Node: Notes1061625
+Node: Compatibility Mode1062425
+Node: Additions1063208
+Node: Accessing The Source1064135
+Node: Adding Code1065575
+Node: New Ports1071620
+Node: Derived Files1075755
+Ref: Derived Files-Footnote-11081076
+Ref: Derived Files-Footnote-21081110
+Ref: Derived Files-Footnote-31081710
+Node: Future Extensions1081808
+Node: Implementation Limitations1082389
+Node: Extension Design1083641
+Node: Old Extension Problems1084790
+Ref: Old Extension Problems-Footnote-11086298
+Node: Extension New Mechanism Goals1086355
+Ref: Extension New Mechanism Goals-Footnote-11089714
+Node: Extension Other Design Decisions1089900
+Node: Extension Future Growth1092006
+Node: Old Extension Mechanism1092827
+Node: Basic Concepts1094567
+Node: Basic High Level1095248
+Ref: figure-general-flow1095519
+Ref: figure-process-flow1096118
+Ref: Basic High Level-Footnote-11099347
+Node: Basic Data Typing1099532
+Node: Glossary1102887
+Node: Copying1128358
+Node: GNU Free Documentation License1165915
+Node: Index1191052
End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index a9b4ab8..1684e90 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -13743,10 +13743,9 @@ current record. @xref{Changing Fields}.
@cindex @command{gawk}, @code{FUNCTAB} array in
@cindex differences in @command{awk} and @command{gawk}, @code{FUNCTAB}
variable
@item FUNCTAB #
-An array whose indices are the names of all the user-defined
-or extension functions in the program.
address@hidden: The array values cannot currently be used.
-Also, you may not use the @code{delete} statement with the
+An array whose indices and corresponding values are the names of all
+the user-defined or extension functions in the program.
address@hidden: You may not use the @code{delete} statement with the
@code{FUNCTAB} array.
@cindex @code{NR} variable
diff --git a/doc/gawkman.texi b/doc/gawkman.texi
index f2a454b..3cf3766 100644
--- a/doc/gawkman.texi
+++ b/doc/gawkman.texi
@@ -13128,10 +13128,9 @@ current record. @xref{Changing Fields}.
@cindex @command{gawk}, @code{FUNCTAB} array in
@cindex differences in @command{awk} and @command{gawk}, @code{FUNCTAB}
variable
@item FUNCTAB #
-An array whose indices are the names of all the user-defined
-or extension functions in the program.
address@hidden: The array values cannot currently be used.
-Also, you may not use the @code{delete} statement with the
+An array whose indices and corresponding values are the names of all
+the user-defined or extension functions in the program.
address@hidden: You may not use the @code{delete} statement with the
@code{FUNCTAB} array.
@cindex @code{NR} variable
-----------------------------------------------------------------------
Summary of changes:
doc/ChangeLog | 6 +
doc/awkcard.in | 2 +
doc/gawk.1 | 187 +++++++++------
doc/gawk.info | 664 +++++++++++++++++++++++++++---------------------------
doc/gawk.texi | 7 +-
doc/gawkman.texi | 7 +-
6 files changed, 459 insertions(+), 414 deletions(-)
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [gawk-diffs] [SCM] gawk branch, master, updated. 2be6f33f68e1a8d412c8712d8017fc7f3b318161,
Arnold Robbins <=