[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-3639-gc9b866
|
From: |
Arnold Robbins |
|
Subject: |
[gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-3639-gc9b8660 |
|
Date: |
Sun, 3 Feb 2019 15:22:34 -0500 (EST) |
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 c9b866094dab452054c85971d96ebcb3afdcaacf (commit)
via 348cdff0b903121e4a3d21dec69947fa4fc779cd (commit)
from de0fcefe4207ab6438556341deea14662a1a3a6f (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=c9b866094dab452054c85971d96ebcb3afdcaacf
commit c9b866094dab452054c85971d96ebcb3afdcaacf
Author: Arnold D. Robbins <address@hidden>
Date: Sun Feb 3 22:21:50 2019 +0200
Update TODO, disallow @/.../ as second arg to index.
diff --git a/ChangeLog b/ChangeLog
index a7a8de0..cb0a2cb 100755
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2019-02-03 Arnold D. Robbins <address@hidden>
+
+ * awkgram.y (snode): Disallow @/.../ as second param of index, also.
+ * TODO: Updated.
+
2019-02-02 Arnold D. Robbins <address@hidden>
* awkgram.c, command.c: Regenerated with Bison 3.3.
diff --git a/TODO b/TODO
index b621ab6..5f10b2b 100644
--- a/TODO
+++ b/TODO
@@ -1,4 +1,4 @@
-Wed Dec 12 21:29:16 IST 2018
+Sun Feb 3 20:34:46 IST 2019
============================
There were too many files tracking different thoughts and ideas for
@@ -41,6 +41,8 @@ Minor New Features
Consider relaxing the strictness of --posix.
+ Enhance --lint=invalid to apply in more places.
+
? Add an optional base to strtonum, allowing 2-36.
? Optional third argument for index indicating where to start the
diff --git a/awkgram.c b/awkgram.c
index 55c42db..2269c58 100644
--- a/awkgram.c
+++ b/awkgram.c
@@ -7293,7 +7293,7 @@ snode(INSTRUCTION *subn, INSTRUCTION *r)
else if (r->builtin == do_index) {
arg = subn->nexti->lasti->nexti; /* 2nd arg list */
ip = arg->lasti;
- if (ip->opcode == Op_match_rec)
+ if (ip->opcode == Op_match_rec || ip->opcode == Op_push_re)
fatal(_("index: regexp constant as second argument is
not allowed"));
}
#ifdef ARRAYDEBUG
diff --git a/awkgram.y b/awkgram.y
index 415b894..720efce 100644
--- a/awkgram.y
+++ b/awkgram.y
@@ -4799,7 +4799,7 @@ snode(INSTRUCTION *subn, INSTRUCTION *r)
else if (r->builtin == do_index) {
arg = subn->nexti->lasti->nexti; /* 2nd arg list */
ip = arg->lasti;
- if (ip->opcode == Op_match_rec)
+ if (ip->opcode == Op_match_rec || ip->opcode == Op_push_re)
fatal(_("index: regexp constant as second argument is
not allowed"));
}
#ifdef ARRAYDEBUG
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=348cdff0b903121e4a3d21dec69947fa4fc779cd
commit 348cdff0b903121e4a3d21dec69947fa4fc779cd
Author: Arnold D. Robbins <address@hidden>
Date: Sun Feb 3 22:21:24 2019 +0200
Doc updates, add spell check for man page.
diff --git a/doc/ChangeLog b/doc/ChangeLog
index f8c5f30..647f2a6 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,10 +1,21 @@
+2019-02-03 Arnold D. Robbins <address@hidden>
+
+ * Makefile.am (EXTRA_DIST): Add wordlist3.
+ (spellmanpage): New target.
+ (spell): Add spellmanpage to the list.
+ * wordlist1: Updated.
+ * wordlist3: New file.
+ * awkcard.in: Finish cleanups.
+ * gawk.1: Ditto.
+ * gawktexi.in: Fix small typo.
+
2019-02-01 Arnold D. Robbins <address@hidden>
* awkcard.in: Start on cleanup edits.
* gawk.1: Ditto.
* gawktexi.in: Credit Nelson Beebe with gawk's current
random number generator.
- * (gawk.texi, gawk.info): Brought back into sync.
+ * gawk.texi, gawk.info: Brought back into sync.
2019-01-28 Arnold D. Robbins <address@hidden>
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 0b9316b..1e5d86a 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -48,7 +48,7 @@ EXTRA_DIST = ChangeLog ChangeLog.0 README.card ad.block
setter.outline \
lflashlight-small.xpic lflashlight.eps lflashlight.pdf \
rflashlight-small.xpic rflashlight.eps rflashlight.pdf \
statist.jpg statist.eps statist.pdf \
- wordlist wordlist2 \
+ wordlist wordlist2 wordlist3 \
bc_notes
# Get rid of generated files when cleaning
@@ -109,7 +109,7 @@ awkcard.nc: $(CARDFILES)
awkcard.pdf: awkcard.ps
ps2pdf awkcard.ps awkcard.pdf
-spell: spellmanual spellworkflow
+spell: spellmanual spellworkflow spellmanpage
spellmanual:
@echo ==== gawktexi.in ====;
@@ -120,3 +120,8 @@ spellworkflow:
@echo ==== gawkworkflow.texi ====
export LC_ALL=C ; spell "$(srcdir)"/gawkworkflow.texi | \
sort -u | comm -23 - "$(srcdir)"/wordlist2
+
+spellmanpage:
+ @echo ==== gawk.1 ====
+ export LC_ALL=C ; spell "$(srcdir)"/gawk.1 | \
+ sort -u | comm -23 - "$(srcdir)"/wordlist3
diff --git a/doc/Makefile.in b/doc/Makefile.in
index 2d028bf..2c4c6d2 100644
--- a/doc/Makefile.in
+++ b/doc/Makefile.in
@@ -376,7 +376,7 @@ EXTRA_DIST = ChangeLog ChangeLog.0 README.card ad.block
setter.outline \
lflashlight-small.xpic lflashlight.eps lflashlight.pdf \
rflashlight-small.xpic rflashlight.eps rflashlight.pdf \
statist.jpg statist.eps statist.pdf \
- wordlist wordlist2 \
+ wordlist wordlist2 wordlist3 \
bc_notes
@@ -926,7 +926,7 @@ awkcard.nc: $(CARDFILES)
awkcard.pdf: awkcard.ps
ps2pdf awkcard.ps awkcard.pdf
-spell: spellmanual spellworkflow
+spell: spellmanual spellworkflow spellmanpage
spellmanual:
@echo ==== gawktexi.in ====;
@@ -938,6 +938,11 @@ spellworkflow:
export LC_ALL=C ; spell "$(srcdir)"/gawkworkflow.texi | \
sort -u | comm -23 - "$(srcdir)"/wordlist2
+spellmanpage:
+ @echo ==== gawk.1 ====
+ export LC_ALL=C ; spell "$(srcdir)"/gawk.1 | \
+ sort -u | comm -23 - "$(srcdir)"/wordlist3
+
# Tell versions [3.59,3.63) of GNU make to not export all variables.
# Otherwise a system limit (for SysV at least) may be exceeded.
.NOEXPORT:
diff --git a/doc/awkcard.in b/doc/awkcard.in
index 9638c44..14e69fa 100644
--- a/doc/awkcard.in
+++ b/doc/awkcard.in
@@ -1158,14 +1158,14 @@ lp8 lp8 lp8 lp8.
.ES
.fi
\*(CDThe environment variable \*(FCAWKPATH\fP specifies a search path to use
-when finding source files named with the \*(FC\-f\fP
-option.
+when finding source files named with the \*(FC\-f\fP and \*(FC\-i\fP
+options.
The default path is
\*(FC".:/usr/local/share/awk"\*(FR.
.\" if this variable does not exist.
.\" (The actual directory may vary,
.\" depending upon how \*(GK was built and installed.)
-If a file name given to the \*(FC\-f\fP option contains a ``/'' character,
+If a source file name contains a ``/'' character,
no path search is performed.
.sp .5
The variable \*(FCAWKLIBPATH\fP
@@ -1304,7 +1304,7 @@ The left identifier is the namespace and the right one
is the variable within it.
All non-qualified names are treated as if in the
``current'' namespace; the default namespace is \*(FCawk\fP.
-However, simple identifiers consisting solely of upper-case
+However, simple identifiers consisting solely of uppercase
letters are forced into the
\*(FCawk\fP
namespace.
@@ -1390,7 +1390,7 @@ If no \*(FIfile\fP, or if
.ti -.2i
\*(FCprint\fP
.br
-Print the current record. Terminate output record
+Print \*(FC$0\*(FR. Terminate the output record
with \*(FCORS\fP.
.ti -.2i
\*(FCprint \*(FIexpr-list\*(FR
@@ -1467,25 +1467,25 @@ the error.\*(CX
accept the following conversion specification formats:
.sp .5
.nf
-\*(CB\*(FC%a\fP, \*(FC%A\fP A C99 floating point hexadecimal number\*(CD
-\*(FC%c\fP An \s-1ASCII\s+1 character
-\*(FC%d\fP, \*(FC%i\fP A decimal number (the integer part)
+\*(CB\*(FC%a\fP, \*(FC%A\fP A C99 floating point hexadecimal number.\*(CD
+\*(FC%c\fP An \s-1ASCII\s+1 character.
+\*(FC%d\fP, \*(FC%i\fP A decimal number (the integer part).
\*(FC%e\fP A floating point number of the form
- \*(FC[\-]d.dddddde[+\^\-]dd\*(FR
-\*(FC%E\fP Like \*(FC%e\fP, but use \*(FCE\fP instead of
\*(FCe\*(FR
+ \*(FC[\-]d.dddddde[+\^\-]dd\*(FR.
+\*(FC%E\fP Like \*(FC%e\fP, but use \*(FCE\fP instead of
\*(FCe\*(FR.
\*(FC%f\fP A floating point number of the form
- \*(FC[\-]ddd.dddddd\*(FR
+ \*(FC[\-]ddd.dddddd\*(FR.
\*(FC%F\fP Like \*(FC%f\fP, but use capital letters for infinity
and
not-a-number values.
\*(FC%g\fP Use \*(FC%e\fP or \*(FC%f\fP, whichever is shorter, with
- nonsignificant zeros suppressed
-\*(FC%G\fP Like \*(FC%g\fP, but use \*(FC%E\fP instead of
\*(FC%e\*(FR
-\*(FC%o\fP An unsigned octal integer
-\*(FC%u\fP An unsigned decimal integer
-\*(FC%s\fP A character string
-\*(FC%x\fP An unsigned hexadecimal integer
-\*(FC%X\fP Like \*(FC%x\fP, but use \*(FCABCDEF\fP for 10\(en15
-\*(FC%%\fP A literal \*(FC%\fP; no argument is converted
+ nonsignificant zeros suppressed.
+\*(FC%G\fP Like \*(FC%g\fP, but use \*(FC%E\fP instead of
\*(FC%e\*(FR.
+\*(FC%o\fP An unsigned octal integer.
+\*(FC%u\fP An unsigned decimal integer.
+\*(FC%s\fP A character string.
+\*(FC%x\fP An unsigned hexadecimal integer.
+\*(FC%X\fP Like \*(FC%x\fP, but use \*(FCABCDEF\fP for 10\(en15.
+\*(FC%%\fP A literal \*(FC%\fP; no argument is converted.
.sp .5
.fi
Optional, additional parameters may lie between the \*(FC%\fP
@@ -1654,7 +1654,7 @@ expand;
l lw(1.9i).
\*(CD\*(FCatan2(\*(FIy\*(FC, \*(FIx\*(FC)\*(FR The arctangent of \*(FIy/x\fP
in radians.
\*(FCcos(\*(FIexpr\*(FC)\*(FR The cosine of \*(FIexpr\fP, which is in radians.
-\*(FCexp(\*(FIexpr\*(FC)\*(FR The exponential function (\*(FIe \*(FC^
\*(FIx\*(FR).
+\*(FCexp(\*(FIexpr\*(FC)\*(FR The exponential function
(\*(FIe\|\*(FC^\|\*(FIx\*(FR).
\*(FCint(\*(FIexpr\*(FC)\*(FR Truncate to integer.
.\" \*(CB\*(FCintdiv(\*(FIn\*(FR\*(FC,\*(FI d\*(FR\*(FC,\*(FI
r\*(FR\*(FC)\*(FR T{
.\" Return result of integer division in \*(FIr\*(FR.\*(CD
@@ -1745,9 +1745,9 @@ is placed in \*(FIa\*(FC[0]\*(FR. If there were
parenthesized
subexpressions, the matching texts are placed
in \*(FIa\*(FC[1]\*(FR, \*(FIa\*(FC[2]\*(FR, and so on.
Subscripts
-\*(FCa[\*(FIn\^\*(FC, "start"]\*(FR,
+\*(FIa\*(FC[\*(FIn\^\*(FC, "start"]\*(FR,
and
-\*(FCa[\*(FIn\^\*(FC, "length"]\*(FR
+\*(FIa\*(FC[\*(FIn\^\*(FC, "length"]\*(FR
provide the starting index in the string and length,
respectively, of each matching substring.\*(CD
.ti -.2i
@@ -1759,8 +1759,8 @@ and the array \*(FIseps\fP of separator strings
using the regular expression \*(FIr\*(FR,
and return the number of fields.
Element values are the portions of \*(FIs\fP that matched \*(FIr\fP.
-The value of \*(FIseps\fP[\*(FIi\fP] is the separator that appeared in
-front of \*(FIa\fP[\*(FIi\fP+1].
+The value of \*(FIseps\*(FC[\*(FIi\^\fP]\*(FR is the separator that appeared in
+front of \*(FIa\*(FC[\*(FIi\fP+1]\*(FR.
If \*(FIr\fP is omitted, use \*(FCFPAT\fP instead.
Clear the arrays \*(FIa\fP and \*(FIseps\fP first.
Splitting behaves identically to field splitting with \*(FCFPAT\fP.\*(CD
@@ -1798,7 +1798,7 @@ treat it as an octal number.
If \*(FIs\*(FR begins with a leading \*(FC0x\*(FR
or \*(FC0X\*(FR, treat
\*(FIs\*(FR as a hexadecimal number. Otherwise,
-treat the number as decimal.\*(CD
+treat \*(FIs\*(FR as decimal.\*(CD
.ti -.2i
\*(FCsub(\*(FIr\*(FC, \*(FIs \*(FR[\*(FC, \*(FIt\*(FR]\*(FC)\*(FR
.br
diff --git a/doc/gawk.1 b/doc/gawk.1
index 1349a48..550976f 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -13,7 +13,7 @@
. if \w'\(rq' .ds rq "\(rq
. \}
.\}
-.TH GAWK 1 "Jan 27 2019" "Free Software Foundation" "Utility Commands"
+.TH GAWK 1 "Feb 03 2019" "Free Software Foundation" "Utility Commands"
.SH NAME
gawk \- pattern scanning and processing language
.SH SYNOPSIS
@@ -51,7 +51,7 @@ The command line consists of options to
itself, the \*(AK program text (if not supplied via the
.B \-f
or
-.B \-i
+.B \-\^\-include
options), and values to be made
available in the
.B ARGC
@@ -85,7 +85,9 @@ AWK source code and then prompts for debugging commands.
.I Gawk
can only debug AWK program source provided with the
.B \-f
-option.
+and
+.B \-\^\-include
+options.
The debugger is documented in \*(EP.
.SH OPTION FORMAT
.PP
@@ -134,7 +136,7 @@ Multiple
options may be used.
Files read with
.B \-f
-are treated as if they begin with an implict address@hidden "awk"\fR statement.
+are treated as if they begin with an implicit address@hidden "awk"\fR
statement.
.TP
.PD 0
.BI \-F " fs"
@@ -252,13 +254,13 @@ as \*(AK program source code.
This option allows the easy intermixing of library functions (used via the
.B \-f
and
-.B \-i
+.B \-\^\-include
options) with source code entered on the command line.
It is intended primarily for medium to large \*(AK programs used
in shell scripts.
Each argument supplied via
.B \-e
-is treated as if it begins with an implict address@hidden "awk"\fR statement.
+is treated as if it begins with an implicit address@hidden "awk"\fR statement.
.TP
.PD 0
.BI "\-E " file
@@ -317,8 +319,8 @@ suffix. The file will be loaded only
once (i.e., duplicates are eliminated), and the code does not constitute
the main program source.
Files read with
-.B \-i
-are treated as if they begin with an implict address@hidden "awk"\fR statement.
+.B \-\^\-include
+are treated as if they begin with an implicit address@hidden "awk"\fR
statement.
.TP
.PD 0
.BI "\-l " lib
@@ -361,7 +363,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 GMP libraries.
(In such a case,
.I gawk
issues a warning.)
@@ -419,7 +421,7 @@ is provided,
uses a file named
.B awkprof.out
in the current directory.
-Implies
+This option implies
.BR \-\^\-no\-optimize .
.TP
.PD 0
@@ -444,7 +446,7 @@ The default is
.BR awkprof.out .
The profile contains execution counts of each statement in the program
in the left margin and function call counts for each user-defined function.
-Implies
+This option implies
.BR \-\^\-no\-optimize .
.TP
.PD 0
@@ -502,7 +504,7 @@ Interval expressions were not traditionally available in the
and
.I egrep
consistent with each other.
-They are enabled by default, but this option remains for use with
+They are enabled by default, but this option remains for use together with
.BR \-\^\-traditional .
.TP
.PD 0
@@ -623,14 +625,14 @@ In addition, lines beginning with
may be used to include other source files into your program,
making library use even easier. This is equivalent
to using the
-.B \-i
+.B \-\^\-include
option.
.PP
Lines beginning with
.B @load
may be used to load extension functions into your program. This is equivalent
to using the
-.B \-l
+.B \-\^\-load
option.
.PP
The environment variable
@@ -639,7 +641,7 @@ specifies a search path to use when finding source files
named with
the
.B \-f
and
-.B \-i
+.B \-\^\-include
options. If this variable does not exist, the default path is
\fB".:/usr/local/share/awk"\fR.
(The actual directory may vary, depending upon how
@@ -653,7 +655,7 @@ The environment variable
.B AWKLIBPATH
specifies a search path to use when finding source files named with
the
-.B \-l
+.B \-\^\-load
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
@@ -862,7 +864,8 @@ Each field in the input record may be referenced by its
position:
.BR $2 ,
and so on.
.B $0
-is the whole record.
+is the whole record,
+including leading and trailing whitespace.
Fields need not be referenced by constants:
.RS
.PP
@@ -881,7 +884,7 @@ is set to the total number of fields in the input record.
.PP
References to non-existent fields (i.e., fields after
.BR $NF )
-produce the null-string. However, assigning to a non-existent field
+produce the null string. However, assigning to a non-existent field
(e.g.,
.BR "$(NF+2) = 5" )
increases the value of
@@ -1020,9 +1023,9 @@ When set,
.I gawk
parses the input into fields, where the fields match the
regular expression, instead of using the
-value of the
+value of
.B FS
-variable as the field separator.
+as the field separator.
See
.BR Fields ,
above.
@@ -1199,7 +1202,7 @@ The identifier is a built-in function.
The identifier is an extension function loaded via
.B @load
or
-.BR \-l .
+.BR \-\^\-load .
.TP
\fB"scalar"\fR
The identifier is a scalar.
@@ -1213,40 +1216,49 @@ doesn't know yet).
The identifier is a user-defined function.
.RE
.TP
+\fBPROCINFO["pgrpid"]\fP
+The value of the
+.IR getpgrp (2)
+system call.
+.TP
+\fBPROCINFO["pid"]\fP
+The value of the
+.IR getpid (2)
+system call.
+.TP
\fBPROCINFO["platform"]\fP
A string indicating the platform for which
.I gawk
was compiled. It is one of:
.RS
.TP
-\fB"vms"\fR
-OpenVMS or Vax/VMS.
+\fB"cygwin"\fR, \fB"djgpp"\fR, \fB"mingw"\fR
+Microsoft Windows, using either Cygwin, DJGPP, or MinGW, respectively.
.TP
\fB"macosx"\fR
Mac OS X.
.TP
-\fB"cygwin"\fR, \fB"djgpp"\fR, \fB"mingw"\fR
-Microsoft Windows, using either Cygwin, DJGPP, or MinGW, respectively.
-.TP
\fB"os2"\fR
OS/2.
.TP
\fB"posix"\fR
GNU/Linux and legacy Unix systems.
-.RE
-.TP
-\fBPROCINFO["pgrpid"]\fP
-The process group ID of the current process.
.TP
-\fBPROCINFO["pid"]\fP
-The process ID of the current process.
+\fB"vms"\fR
+OpenVMS or Vax/VMS.
+.RE
.TP
\fBPROCINFO["ppid"]\fP
-The parent process ID of the current process.
+The value of the
+.IR getppid (2)
+system call.
.TP
\fBPROCINFO["strftime"]\fP
The default time format string for
.BR strftime() .
+Changing its value affects how
+.B strftime()
+formats time values when called with no arguments.
.TP
\fBPROCINFO["uid"]\fP
The value of the
@@ -1254,7 +1266,7 @@ The value of the
system call.
.TP
\fBPROCINFO["version"]\fP
-the version of
+The version of
.IR gawk .
.PP
The following elements are present if loading dynamic
@@ -1271,7 +1283,7 @@ 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 GMP library used for arbitrary precision
number support in
.IR gawk .
.TP
@@ -1328,7 +1340,7 @@ An I/O error that may be retried is one where
has the value EAGAIN, EWOULDBLOCK, EINTR, or ETIMEDOUT.
This may be useful in conjunction with
\fBPROCINFO["\fIinput\^\fB", "READ_TIMEOUT"]\fR
-or situations where a file descriptor has been configured to behave in a
+or in situations where a file descriptor has been configured to behave in a
non-blocking fashion.
.TP
\fBPROCINFO["sorted_in"]\fP
@@ -1377,13 +1389,26 @@ depending on how the elements of the array are to be
ordered.
.B ROUNDMODE
The rounding mode to use for arbitrary precision arithmetic on
numbers, by default \fB"N"\fR (IEEE-754 roundTiesToEven mode).
-The accepted values are
-\fB"N"\fR or \fB"n"\fR for roundTiesToEven,
-\fB"U"\fR or \fB"u"\fR for roundTowardPositive,
-\fB"D"\fR or \fB"d"\fR for roundTowardNegative,
-\fB"Z"\fR or \fB"z"\fR for roundTowardZero,
-and if your version of GNU MPFR library supports it,
-\fB"A"\fR or \fB"a"\fR for rounding away from zero.
+The accepted values are:
+.RS
+.TP
+\fB"A"\fR or \fB"a"\fR
+for rounding away from zero.
+This one is only available if your version of
+the GNU MPFR library supports it.
+.TP "\w'\fB\(dqD\(dq\fR or \fB\(dqd\(dq\fR'u+1n"
+\fB"D"\fR or \fB"d"\fR
+for roundTowardNegative.
+.TP
+\fB"N"\fR or \fB"n"\fR
+for roundTiesToEven.
+.TP
+\fB"U"\fR or \fB"u"\fR
+for roundTowardPositive.
+.TP
+\fB"Z"\fR or \fB"z"\fR
+for roundTowardZero.
+.RE
.TP
.B RS
The input record separator, by default a newline.
@@ -1409,7 +1434,7 @@ The length of the string matched by
\-1 if no match.
.TP
.B SUBSEP
-The character used to separate multiple subscripts in array
+The string used to separate multiple subscripts in array
elements, by default \fB"\e034"\fR.
.TP
.B SYMTAB
@@ -1547,7 +1572,7 @@ identifier is the variable within it.
All simple (non-qualified) names are considered to be in the
``current'' namespace; the default namespace is
.BR awk .
-However, simple identifiers consisting solely of upper-case
+However, simple identifiers consisting solely of uppercase
letters are forced into the
.B awk
namespace, even if the current namespace is different.
@@ -1828,8 +1853,8 @@ patterns cannot have missing action parts.
.B BEGINFILE
and
.B ENDFILE
-are additional special patterns whose bodies are executed
-before reading the first record of each command line input file
+are additional special patterns whose actions are executed
+before reading the first record of each command-line input file
and after reading the last record of each file.
Inside the
.B BEGINFILE
@@ -1909,6 +1934,7 @@ Matches the end of a string.
A character list: matches any of the characters
.IR abc.\|.\|. .
You may include a range of characters by separating them with a dash.
+To include a literal dash in the list, put it first or last.
.TP
\fB[^\fIabc.\|.\|.\fB]\fR
A negated character list: matches any character except
@@ -2308,7 +2334,7 @@ It must be a string value, either
.B getline
Set
.B $0
-from next input record; set
+from the next input record; set
.BR NF ,
.BR NR ,
.BR FNR ,
@@ -2317,7 +2343,7 @@ from next input record; set
.BI "getline <" file
Set
.B $0
-from next record of
+from the next record of
.IR file ;
set
.BR NF ,
@@ -2326,7 +2352,7 @@ set
.BI getline " var"
Set
.I var
-from next input record; set
+from the next input record; set
.BR NR ,
.BR FNR ,
.BR RT .
@@ -2334,14 +2360,14 @@ from next input record; set
.BI getline " var" " <" file
Set
.I var
-from next record of
+from the next record of
.IR file ;
set
.BR RT .
.TP
\fIcommand\fB | getline \fR[\fIvar\fR]
Run
-.I command
+.IR command ,
piping the output either into
.B $0
or
@@ -2362,34 +2388,34 @@ as above, and
Coprocesses are a
.I gawk
extension.
-.RI ( command
+.RI "(The " command
can also be a socket. See the subsection
.BR "Special File Names" ,
below.)
.TP
.B next
-Stop processing the current input record. The next input record
-is read and processing starts over with the first pattern in the
+Stop processing the current input record.
+Read the next input record
+and start processing over with the first pattern in the
\*(AK program.
Upon reaching the end of the input data,
-.I gawk
-executes any
+execute any
.B END
rule(s).
.TP
.B "nextfile"
Stop processing the current input file. The next input record read
comes from the next input file.
+Update
.B FILENAME
and
-.B ARGIND
-are updated,
+.BR ARGIND ,
+reset
.B FNR
-is reset to 1, and processing starts over with the first pattern in the
+to 1, and start processing over with the first pattern in the
\*(AK program.
Upon reaching the end of the input data,
-.I gawk
-executes any
+execute any
.B ENDFILE
and
.B END
@@ -2445,14 +2471,14 @@ and
.BR printf .
.TP
.BI "print .\|.\|. >>" " file"
-Appends output to the
+Append output to the
.IR file .
.TP
.BI "print .\|.\|. |" " command"
-Writes on a pipe.
+Write on a pipe.
.TP
.BI "print .\|.\|. |&" " command"
-Sends data to a coprocess or socket.
+Send data to a coprocess or socket.
(See also the subsection
.BR "Special File Names" ,
below.)
@@ -2685,8 +2711,9 @@ of significant digits. For the
and
.B %X
formats, it specifies the minimum number of
-digits to print. For
-.BR %s ,
+digits to print. For the
+.B %s
+format,
it specifies the maximum number of
characters from the string that should be printed.
.PP
@@ -2796,6 +2823,9 @@ to force an IPv6 connection.
Plain
.B /inet
uses the system default (most likely IPv4).
+Usable only with the
+.B |&
+two-way I/O operator.
.TP
.PD 0
.BI /inet/udp/ lport / rhost / rport
@@ -3355,15 +3385,15 @@ Return the bitwise XOR of the values provided in the
argument list.
There must be at least two.
.PP
.SS Type Functions
-The following function is for use with multidimensional arrays.
+The following functions provide type related information about
+their arguments.
.TP
\fBisarray(\fIx\fB)\fR
Return true if
.I x
is an array, false otherwise.
-.PP
-You can tell the type of any variable or array element with the
-following function:
+This function is mainly for use with the elements of multidimensional arrays
+and with function parameters.
.TP
\fBtypeof(\fIx\fB)\fR
Return a string indicating the type of
@@ -3676,7 +3706,7 @@ was changed to match its documentation, the
.B \-v
option for assigning variables before program execution was added to
accommodate applications that depended upon the old behavior.
-(This feature was agreed upon by both the Bell Laboratories
+(This feature was agreed upon by both the Bell Laboratories developers
and the \*(GN developers.)
.PP
When processing arguments,
@@ -4008,7 +4038,7 @@ environment variable can be used to provide a list of
directories that
.I gawk
searches when looking for files named via the
.BR \-f ,
-.RB \-\^\-file ,
+.BR \-\^\-file ,
.B \-i
and
.B \-\^\-include
@@ -4039,7 +4069,7 @@ For connection to a remote host via socket,
.B GAWK_SOCK_RETRIES
controls the number of retries, and
.B GAWK_MSEC_SLEEP
-and the interval between retries.
+the interval between retries.
The interval is in milliseconds. On systems that do not support
.IR usleep (3),
the value is rounded up to an integral number of seconds.
@@ -4152,7 +4182,11 @@ post a bug report in
While the
.I gawk
developers occasionally read this newsgroup, posting bug reports there
-is an unreliable way to report bugs. Instead, please use the electronic mail
+is an unreliable way to report bugs.
+Similarly, do
+.B NOT
+use a web forum (such as Stack Overflow) for reporting bugs.
+Instead, please use the electronic mail
addresses given above.
Really.
.PP
diff --git a/doc/gawk.info b/doc/gawk.info
index ba02f4f..7fa1e6a 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -7741,7 +7741,7 @@ Other Versions::) elide the backslash and newline, as in
C:
In POSIX mode (*note Options::), 'gawk' does not allow escaped
newlines. Otherwise, it behaves as just described.
- Brian Kernighan's 'awk' and Busybox 'awk' remove the backslash but
+ Brian Kernighan's 'awk' and BusyBox 'awk' remove the backslash but
leave the newline intact, as part of the string:
$ nawk 'BEGIN { print "hello, \
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 6fed73a..e1140ea 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -11129,7 +11129,7 @@ $ @kbd{gawk 'BEGIN @{ print "hello, \}
In POSIX mode (@pxref{Options}), @command{gawk} does not
allow escaped newlines. Otherwise, it behaves as just described.
-Brian Kernighan's @command{awk} and Busybox @command{awk}
+Brian Kernighan's @command{awk} and BusyBox @command{awk}
remove the backslash but leave the newline
intact, as part of the string:
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index bd8471b..b24324a 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -10614,7 +10614,7 @@ $ @kbd{gawk 'BEGIN @{ print "hello, \}
In POSIX mode (@pxref{Options}), @command{gawk} does not
allow escaped newlines. Otherwise, it behaves as just described.
-Brian Kernighan's @command{awk} and Busybox @command{awk}
+Brian Kernighan's @command{awk} and BusyBox @command{awk}
remove the backslash but leave the newline
intact, as part of the string:
diff --git a/doc/wordlist b/doc/wordlist
index d87a1b1..a07d666 100644
--- a/doc/wordlist
+++ b/doc/wordlist
@@ -710,6 +710,7 @@ beginfile
begpat
behaviour
bellcore
+benhoyt
beslab
bf
bfoo
@@ -1115,6 +1116,8 @@ gmplib
gmx
gnubin
gnv
+goawk
+golang
goldberg
goodie
goto
@@ -1604,6 +1607,7 @@ qsort
quanstro
quicksort
quiktrim
+quux
rab
radians
raincloud
@@ -1677,6 +1681,7 @@ sbcglobal
sbin
sbuf
sc
+scanf
scl
scm
scottd
@@ -1688,6 +1693,7 @@ seps
setchapternewpage
setenv
setfilename
+setlinebuf
settitle
sf
shar
@@ -1728,11 +1734,13 @@ sqrt
srand
src
ssize
+stackoverflow
stackptr
standalone
stat
statdata
statfunc
+std
stdbuf
stddef
stderr
diff --git a/doc/wordlist3 b/doc/wordlist3
new file mode 100644
index 0000000..62e3e61
--- /dev/null
+++ b/doc/wordlist3
@@ -0,0 +1,247 @@
+AB
+ABCDEF
+API
+ARGC
+ARGIND
+ARGV
+AWK
+AWKLIBPATH
+AWKPATH
+Ab
+Aho
+BEGINFILE
+BEL
+BINMODE
+CGI
+CONVFMT
+Coprocesses
+Cygwin
+DD
+DJGPP
+DST
+EAGAIN
+EINTR
+ENDFILE
+ERRNO
+ESC
+ETIMEDOUT
+EWOULDBLOCK
+FIELDWIDTHS
+FNR
+FPAT
+FS
+FUNCTAB
+Fenlason
+GMP
+HH
+IGNORECASE
+IPv
+ISBN
+LC
+Localizable
+MKS
+MPFR
+MSEC
+MinGW
+NF
+NR
+OFMT
+OFS
+ORS
+OpenVMS
+PREC
+PROCINFO
+RLENGTH
+ROUNDMODE
+RSTART
+RT
+Regexp
+Retryable
+SIGHUP
+SIGUSR
+SS
+SUBSEP
+SYMTAB
+TEXTDOMAIN
+TP
+Trueman
+UTC
+Weinberger
+YYYY
+Za
+aB
+ab
+abc
+abcdef
+alnum
+api
+argv
+arnold
+asc
+asort
+asorti
+atan
+awk
+awkprof
+awkvars
+bignum
+bindtextdomain
+builtin
+ch
+cmd
+cmp
+cntrl
+comp
+compl
+coprocess
+coprocesses
+cos
+cygwin
+datespec
+dcgettext
+dcngettext
+dd
+ddd
+dddddd
+denom
+desc
+dev
+djgpp
+dl
+ds
+eB
+eS
+eW
+ea
+eb
+ec
+ef
+egid
+egrep
+en
+er
+errno
+euid
+ev
+ew
+exp
+expr
+ey
+fclose
+fd
+fflush
+fmt
+foo
+formfeed
+fs
+func
+gen
+gensub
+getegid
+geteuid
+getgid
+getgroups
+getline
+getpgrp
+getpid
+getppid
+gettext
+getuid
+gid
+gmo
+gmp
+gsub
+hhhh
+html
+https
+ind
+inet
+int
+intdiv
+isarray
+lang
+lc
+localizable
+logdir
+lport
+lq
+lshift
+macosx
+metacharacter
+metacharacters
+min
+mingw
+mktime
+monde
+mpfr
+multibyte
+myfunc
+myhome
+myprog
+nextfile
+nlines
+nmap
+nonsignificant
+nonwhitespace
+num
+org
+os
+parsedebug
+patsplit
+pclose
+pgrpid
+pid
+posix
+ppid
+pre
+prec
+printf
+pty
+punct
+rand
+regex
+regexp
+resplit
+rhost
+roundTiesToEven
+roundTowardNegative
+roundTowardPositive
+roundTowardZero
+rport
+rq
+rshift
+rw
+sed
+seps
+sprintf
+srand
+stderr
+stdin
+stdout
+str
+strftime
+strnum
+strtod
+strtonum
+subarray
+substr
+systime
+tcp
+tolower
+toupper
+typeof
+udp
+uid
+uintmax
+usleep
+usr
+utc
+val
+var
+vars
+vms
+wr
+www
+xdigit
+xor
+zero'th
-----------------------------------------------------------------------
Summary of changes:
ChangeLog | 5 ++
TODO | 4 +-
awkgram.c | 2 +-
awkgram.y | 2 +-
doc/ChangeLog | 13 ++-
doc/Makefile.am | 9 ++-
doc/Makefile.in | 9 ++-
doc/awkcard.in | 50 ++++++------
doc/gawk.1 | 184 ++++++++++++++++++++++++-----------------
doc/gawk.info | 2 +-
doc/gawk.texi | 2 +-
doc/gawktexi.in | 2 +-
doc/wordlist | 8 ++
doc/wordlist3 | 247 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++
14 files changed, 428 insertions(+), 111 deletions(-)
create mode 100644 doc/wordlist3
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [gawk-diffs] [SCM] gawk branch, master, updated. gawk-4.1.0-3639-gc9b8660,
Arnold Robbins <=