Improve autoconf. More doc updates.

10 files changed, 748 insertions, 843 deletions

diff --git a/ChangeLog b/ChangeLog
index fc00a165..53ed3676 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+Wed Jan  5 20:35:30 2011  Arnold D. Robbins  <arnold@skeeve.com>
+
+	* configure.ac: Move call to AC_LANG([C]) into here from
+	m4/readline.m4.
+
 Tue Jan  4 11:21:18 2011  Arnold D. Robbins  <arnold@skeeve.com>
 
 	Clean up some compiler warnings:
diff --git a/configure b/configure
index d4dd6c90..9d9701fc 100755
--- a/configure
+++ b/configure
@@ -5816,6 +5816,13 @@ then
 	CFLAGS="$CFLAGS -D_SYSV3"
 fi
 
+ac_ext=c
+ac_cpp='$CPP $CPPFLAGS'
+ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
+ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
+ac_compiler_gnu=$ac_cv_c_compiler_gnu
+
+
 { $as_echo "$as_me:${as_lineno-$LINENO}: checking for function prototypes" >&5
 $as_echo_n "checking for function prototypes... " >&6; }
 if test "$ac_cv_prog_cc_c89" != no; then
@@ -10283,12 +10290,6 @@ fi
         { $as_echo "$as_me:${as_lineno-$LINENO}: checking whether readline via \"$_combo\" is present and sane" >&5
 $as_echo_n "checking whether readline via \"$_combo\" is present and sane... " >&6; }
 
-	ac_ext=c
-ac_cpp='$CPP $CPPFLAGS'
-ac_compile='$CC -c $CFLAGS $CPPFLAGS conftest.$ac_ext >&5'
-ac_link='$CC -o conftest$ac_exeext $CFLAGS $CPPFLAGS $LDFLAGS conftest.$ac_ext $LIBS >&5'
-ac_compiler_gnu=$ac_cv_c_compiler_gnu
-
         cat confdefs.h - <<_ACEOF >conftest.$ac_ext
 /* end confdefs.h.  */
 
diff --git a/configure.ac b/configure.ac
index 0d72d7db..138b19d9 100644
--- a/configure.ac
+++ b/configure.ac
@@ -112,6 +112,10 @@ dnl	need -D_SYSV3 for ISC
 	CFLAGS="$CFLAGS -D_SYSV3"
 fi
 
+dnl Set the programming language for checks. Fortunately,
+dnl this only needs to be set once, since everything is in C.
+AC_LANG([C])
+
 dnl check for C compiler for automake. Needed for dfa.h.
 AM_C_PROTOTYPES
 
diff --git a/doc/ChangeLog b/doc/ChangeLog
index f90a7920..edc1df03 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+Wed Jan  5 14:33:51 2011  Arnold D. Robbins  <arnold@skeeve.com>
+
+	* Makefile.am: Sanitize making of different PDF files.
+
 Sun Jan  2 20:30:37 2011  Arnold D. Robbins  <arnold@skeeve.com>
 
 	* texinfo.tex: Update to latest from texinfo CVS repository.
diff --git a/doc/Makefile.am b/doc/Makefile.am
index 359bf056..73c5745e 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -77,10 +77,7 @@ uninstall-hook:
 
 postscript: gawk.ps gawkinet.ps gawk.1.ps igawk.1.ps $(AWKCARD)
 
-pdf: postscript gawk.pdf gawkinet.pdf awkcard.ps gawk.1.ps igawk.1.ps
-	ps2pdf awkcard.ps awkcard.pdf
-	ps2pdf gawk.1.ps gawk.1.pdf
-	ps2pdf igawk.1.ps igawk.1.pdf
+pdf: postscript gawk.pdf gawkinet.pdf awkcard.pdf gawk.1.pdf igawk.1.pdf
 
 gawk.ps: gawk.dvi
 	dvips -o gawk.ps gawk.dvi
@@ -91,9 +88,15 @@ gawkinet.ps: gawkinet.dvi
 gawk.1.ps: gawk.1
 	-groff -man $(srcdir)/gawk.1 > gawk.1.ps
 
+gawk.1.pdf: gawk.1.ps
+	ps2pdf gawk.1.ps gawk.1.pdf
+
 igawk.1.ps: igawk.1
 	-groff -man $(srcdir)/igawk.1 > igawk.1.ps
 
+igawk.1.pdf: igawk.1.ps
+	ps2pdf igawk.1.ps igawk.1.pdf
+
 awkcard.tr: awkcard.in
 	sed 's:SRCDIR:$(srcdir):' < $(srcdir)/awkcard.in > awkcard.tr
 
@@ -102,3 +105,6 @@ awkcard.ps: $(CARDFILES)
 
 awkcard.nc: $(CARDFILES)
 	$(TROFF) $(CARDSRC_N) | $(SEDME) | cat $(srcdir)/setter.outline - | $(SEDME2) > awkcard.ps && touch awkcard.nc
+
+awkcard.pdf: awkcard.ps
+	ps2pdf awkcard.ps awkcard.pdf
diff --git a/doc/Makefile.in b/doc/Makefile.in
index f99a4a13..d37394e7 100644
--- a/doc/Makefile.in
+++ b/doc/Makefile.in
@@ -766,10 +766,7 @@ uninstall-hook:
 
 postscript: gawk.ps gawkinet.ps gawk.1.ps igawk.1.ps $(AWKCARD)
 
-pdf: postscript gawk.pdf gawkinet.pdf awkcard.ps gawk.1.ps igawk.1.ps
-	ps2pdf awkcard.ps awkcard.pdf
-	ps2pdf gawk.1.ps gawk.1.pdf
-	ps2pdf igawk.1.ps igawk.1.pdf
+pdf: postscript gawk.pdf gawkinet.pdf awkcard.pdf gawk.1.pdf igawk.1.pdf
 
 gawk.ps: gawk.dvi
 	dvips -o gawk.ps gawk.dvi
@@ -780,9 +777,15 @@ gawkinet.ps: gawkinet.dvi
 gawk.1.ps: gawk.1
 	-groff -man $(srcdir)/gawk.1 > gawk.1.ps
 
+gawk.1.pdf: gawk.1.ps
+	ps2pdf gawk.1.ps gawk.1.pdf
+
 igawk.1.ps: igawk.1
 	-groff -man $(srcdir)/igawk.1 > igawk.1.ps
 
+igawk.1.pdf: igawk.1.ps
+	ps2pdf igawk.1.ps igawk.1.pdf
+
 awkcard.tr: awkcard.in
 	sed 's:SRCDIR:$(srcdir):' < $(srcdir)/awkcard.in > awkcard.tr
 
@@ -792,6 +795,9 @@ awkcard.ps: $(CARDFILES)
 awkcard.nc: $(CARDFILES)
 	$(TROFF) $(CARDSRC_N) | $(SEDME) | cat $(srcdir)/setter.outline - | $(SEDME2) > awkcard.ps && touch awkcard.nc
 
+awkcard.pdf: awkcard.ps
+	ps2pdf awkcard.ps awkcard.pdf
+
 # 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/gawk.info b/doc/gawk.info
index a1a20461..7e7f1ff5 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -438,6 +438,7 @@ texts being (a) (see below), and with the Back-Cover Texts being (b)
 * POSIX/GNU::                      The extensions in `gawk' not in
                                    POSIX `awk'.
 * Contributors::                   The major contributors to `gawk'.
+* Common Extensions::              Common Extensions Summary.
 * Gawk Distribution::              What is in the `gawk' distribution.
 * Getting::                        How to get the distribution.
 * Extracting::                     How to extract the distribution.
@@ -2294,11 +2295,10 @@ The following list describes options mandated by the POSIX standard:
 `-P'
 `--posix'
      Operate in strict POSIX mode.  This disables all `gawk' extensions
-     (just like `--traditional') and adds the following additional
-     restrictions:
-
-        * `\x' escape sequences are not recognized (*note Escape
-          Sequences::).
+     (just like `--traditional') and disables all extensions not
+     allowed by POSIX.  *Note Common Extensions::, for a summary of the
+     extensions in `gawk' that are disabled by this option.  Also, the
+     following additional restrictions apply:
 
         * Newlines do not act as whitespace to separate fields when
           `FS' is equal to a single space (*note Fields::).
@@ -2306,13 +2306,6 @@ The following list describes options mandated by the POSIX standard:
         * Newlines are not allowed after `?' or `:' (*note Conditional
           Exp::).
 
-        * The synonym `func' for the keyword `function' is not
-          recognized (*note Definition Syntax::).
-
-        * The `**' and `**=' operators cannot be used in place of `^'
-          and `^=' (*note Arithmetic Ops::, and also *note Assignment
-          Ops::).
-
         * Specifying `-Ft' on the command-line does not set the value
           of `FS' to be a single TAB character (*note Field
           Separators::).
@@ -2320,9 +2313,6 @@ The following list describes options mandated by the POSIX standard:
         * The locale's decimal point character is used for parsing input
           data (*note Locales::).
 
-        * The `fflush()' built-in function is not supported (*note I/O
-          Functions::).
-
      If you supply both `--traditional' and `--posix' on the command
      line, `--posix' takes precedence. `gawk' also issues a warning if
      both options are supplied.
@@ -3792,7 +3782,7 @@ variable `RT' to the text in the input that matched `RS'.
 
    When using `gawk', the value of `RS' is not limited to a
 one-character string.  It can be any regular expression (*note
-Regexp::).  In general, each record ends at the next string that
+Regexp::). (c.e.)  In general, each record ends at the next string that
 matches the regular expression; the next record starts at the end of
 the matching string.  This general rule is actually at work in the
 usual case, where `RS' contains just a newline: a record ends at the
@@ -4305,8 +4295,8 @@ File: gawk.info,  Node: Single Character Fields,  Next: Command Line Field Separ
 
 There are times when you may want to examine each character of a record
 separately.  This can be done in `gawk' by simply assigning the null
-string (`""') to `FS'. In this case, each individual character in the
-record becomes a separate field.  For example:
+string (`""') to `FS'. (c.e.)  In this case, each individual character
+in the record becomes a separate field.  For example:
 
      $ echo a b | gawk 'BEGIN { FS = "" }
      >                  {
@@ -6107,11 +6097,12 @@ run from a background job, it may not have a terminal at all.  Then
 opening `/dev/tty' fails.
 
    `gawk' provides special file names for accessing the three standard
-streams, as well as any other inherited open files.  If the file name
-matches one of these special names when `gawk' redirects input or
-output, then it directly uses the stream that the file name stands for.
-These special file names work for all operating systems that `gawk' has
-been ported to, not just those that are POSIX-compliant:
+streams. (c.e.). It also provides syntax for accessing any other
+inherited open files.  If the file name matches one of these special
+names when `gawk' redirects input or output, then it directly uses the
+stream that the file name stands for.  These special file names work
+for all operating systems that `gawk' has been ported to, not just
+those that are POSIX-compliant:
 
 `/dev/stdin'
      The standard input (file descriptor 0).
@@ -8928,8 +8919,8 @@ File: gawk.info,  Node: Nextfile Statement,  Next: Exit Statement,  Prev: Next S
 -----------------------------------------
 
 `gawk' provides the `nextfile' statement, which is similar to the
-`next' statement.  However, instead of abandoning processing of the
-current record, the `nextfile' statement instructs `gawk' to stop
+`next' statement. (c.e.)  However, instead of abandoning processing of
+the current record, the `nextfile' statement instructs `gawk' to stop
 processing the current data file.
 
    The `nextfile' statement is a `gawk' extension.  In most other `awk'
@@ -9930,7 +9921,8 @@ issues a warning message when an element that is not in the array is
 deleted.
 
    All the elements of an array may be deleted with a single statement
-by leaving off the subscript in the `delete' statement, as follows:
+(c.e.)  by leaving off the subscript in the `delete' statement, as
+follows:
 
      delete ARRAY
 
@@ -10751,12 +10743,12 @@ with a pound sign (`#'):
 
      With `gawk' and several other `awk' implementations, when supplied
      an array argument, the `length()' function returns the number of
-     elements in the array.  This is less useful than it might seem at
-     first, as the array is not guaranteed to be indexed from one to
-     the number of elements in it.  If `--lint' is provided on the
-     command line (*note Options::), `gawk' warns that passing an array
-     argument is not portable.  If `--posix' is supplied, using an
-     array argument is a fatal error (*note Arrays::).
+     elements in the array. (c.e.)  This is less useful than it might
+     seem at first, as the array is not guaranteed to be indexed from
+     one to the number of elements in it.  If `--lint' is provided on
+     the command line (*note Options::), `gawk' warns that passing an
+     array argument is not portable.  If `--posix' is supplied, using
+     an array argument is a fatal error (*note Arrays::).
 
 `match(STRING, REGEXP [, ARRAY])'
      Search STRING for the longest, leftmost substring matched by the
@@ -11971,10 +11963,11 @@ function.  When this happens, we say the function is "recursive".  The
 act of a function calling itself is called "recursion".
 
    In many `awk' implementations, including `gawk', the keyword
-`function' may be abbreviated `func'.  However, POSIX only specifies
-the use of the keyword `function'.  This actually has some practical
-implications.  If `gawk' is in POSIX-compatibility mode (*note
-Options::), then the following statement does _not_ define a function:
+`function' may be abbreviated `func'. (c.e.)  However, POSIX only
+specifies the use of the keyword `function'.  This actually has some
+practical implications.  If `gawk' is in POSIX-compatibility mode
+(*note Options::), then the following statement does _not_ define a
+function:
 
      func foo() { a = sqrt($1) ; print a }
 
@@ -19154,6 +19147,7 @@ find more information.
                                 version of `awk'.
 * POSIX/GNU::                   The extensions in `gawk' not in POSIX
                                 `awk'.
+* Common Extensions::           Common Extensions Summary.
 * Contributors::                The major contributors to `gawk'.
 
 
@@ -19286,44 +19280,8 @@ introduced the following changes into the language:
    * More complete documentation of many of the previously undocumented
      features of the language.
 
-   The following common extensions are not permitted by the POSIX
-standard:
-
-   * `\x' escape sequences are not recognized (*note Escape
-     Sequences::).
-
-   * Newlines do not act as whitespace to separate fields when `FS' is
-     equal to a single space (*note Fields::).
-
-   * Newlines are not allowed after `?' or `:' (*note Conditional
-     Exp::).
-
-   * The synonym `func' for the keyword `function' is not recognized
-     (*note Definition Syntax::).
-
-   * The operators `**' and `**=' cannot be used in place of `^' and
-     `^=' (*note Arithmetic Ops::, and *note Assignment Ops::).
-
-   * Specifying `-Ft' on the command line does not set the value of
-     `FS' to be a single TAB character (*note Field Separators::).
-
-   * The locale's decimal point character is used for parsing input
-     data (*note Locales::).
-
-   * The `fflush()' built-in function is not supported (*note I/O
-     Functions::).
-
-   * The ability for `FS' and for the third argument to `split()' to be
-     null strings (*note Single Character Fields::).
-
-   * The `nextfile' statement (*note Nextfile Statement::).
-
-   * The ability to delete all of an array at once with `delete ARRAY'
-     (*note Delete::).
-
-   * The ability for the `length()' function to accept an array
-     argument and return the number of elements in the array.  (*note
-     String Functions::).
+   *Note Common Extensions::, for a list of common extensions not
+permitted by the POSIX standard.
 
    The 2008 POSIX standard can be found online at
 `http://www.opengroup.org/onlinepubs/9699919799/'.
@@ -19334,13 +19292,11 @@ File: gawk.info,  Node: BTL,  Next: POSIX/GNU,  Prev: POSIX,  Up: Language Histo
 A.4 Extensions in Brian Kernighan's `awk'
 =========================================
 
-Brian Kernighan, one of the original designers of Unix `awk', has made
-his version available via his home page (*note Other Versions::).  This
-minor node describes extensions in his version of `awk' that are not in
-POSIX `awk':
+Brian Kernighan has made his version available via his home page (*note
+Other Versions::).
 
-   * The `fflush()' built-in function for flushing buffered output
-     (*note I/O Functions::).
+   This minor node describes common extensions that originally appeared
+in his version of `awk'.
 
    * The `**' and `**=' operators (*note Arithmetic Ops:: and *note
      Assignment Ops::).
@@ -19348,29 +19304,15 @@ POSIX `awk':
    * The use of `func' as an abbreviation for `function' (*note
      Definition Syntax::).
 
+   * The `fflush()' built-in function for flushing buffered output
+     (*note I/O Functions::).
 
-   Brian Kernighan's `awk' also incorporates the following extensions,
-originally developed for `gawk':
-
-   * The `\x' escape sequence (*note Escape Sequences::).
-
-   * The `/dev/stdin', `/dev/stdout', and `/dev/stderr' special files
-     (*note Special Files::).
-
-   * The ability for `FS' and for the third argument to `split()' to be
-     null strings (*note Single Character Fields::).
-
-   * The `nextfile' statement (*note Nextfile Statement::).
-
-   * The ability to delete all of an array at once with `delete ARRAY'
-     (*note Delete::).
 
-   * The ability for the `length()' function to accept an array
-     argument and return the number of elements in the array.  (*note
-     String Functions::).
+   *Note Common Extensions::, for a full list of the extensions
+available in his `awk'.
 
 
-File: gawk.info,  Node: POSIX/GNU,  Next: Contributors,  Prev: BTL,  Up: Language History
+File: gawk.info,  Node: POSIX/GNU,  Next: Common Extensions,  Prev: BTL,  Up: Language History
 
 A.5 Extensions in `gawk' Not in POSIX `awk'
 ===========================================
@@ -19519,9 +19461,37 @@ the current version of `gawk'.
 
 
 
-File: gawk.info,  Node: Contributors,  Prev: POSIX/GNU,  Up: Language History
+File: gawk.info,  Node: Common Extensions,  Next: Contributors,  Prev: POSIX/GNU,  Up: Language History
 
-A.6 Major Contributors to `gawk'
+A.6 Common Extensions Summary
+=============================
+
+This minor node summarizes the common exceptions supported by `gawk',
+Brian Kernighan's `awk', and `mawk', the three most widely-used freely
+available versions of `awk' (*note Other Versions::).
+
+   *FIXME:* Check all of these
+
+Feature                      BWK Awk   Mawk   GNU Awk
+-------------------------------------------------------- 
+`\x' Escape sequence         X         X      X
+`RS' as regexp                         X      X
+`FS' as null string          X         X      X
+`/dev/stdin' special file    X                X
+`/dev/stdout' special file   X         X      X
+`/dev/stderr' special file   X         X      X
+`**' and `**=' operators     X         X      X
+`func' keyword               X         X      X
+`nextfile' statement         X         X      X
+`delete' without subscript   X         X      X
+`length()' of an array       X                X
+`fflush()' function          X         X      X
+`BINMODE' variable                     X      X
+
+
+File: gawk.info,  Node: Contributors,  Prev: Common Extensions,  Up: Language History
+
+A.7 Major Contributors to `gawk'
 ================================
 
      Always give credit where credit is due.
@@ -19553,11 +19523,11 @@ Info file, in approximate chronological order:
      making it compatible with "new" `awk', and greatly improving its
      performance.
 
-   * Pat Rankin provided the VMS port and its documentation.
-
    * Conrad Kwok, Scott Garfinkle, and Kent Williams did the initial
      ports to MS-DOS with various versions of MSC.
 
+   * Pat Rankin provided the VMS port and its documentation.
+
    * Hal Peterson provided help in porting `gawk' to Cray systems.
 
    * Kai Uwe Rommel provided the initial port to OS/2 and its
@@ -19590,13 +19560,15 @@ Info file, in approximate chronological order:
      the `|&' operator.
 
    * Stephen Davies provided the initial port to Tandem systems and its
-     documentation.  He was also instrumental in the initial work to
-     integrate the byte-code internals into the `gawk' code base.
+     documentation.  (However, this is no longer supported.)  He was
+     also instrumental in the initial work to integrate the byte-code
+     internals into the `gawk' code base.
 
    * Matthew Woehlke provided improvements for Tandem's POSIX-compliant
      systems.
 
    * Martin Brown provided the port to BeOS and its documentation.
+     (This is no longer supported.)
 
    * Arno Peters did the initial work to convert `gawk' to use GNU
      Automake and GNU `gettext'.
@@ -20242,8 +20214,9 @@ several shells are available for OS/2, including `ksh'.
 
    Under MS-Windows, OS/2 and MS-DOS, `gawk' (and many other text
 programs) silently translate end-of-line `"\r\n"' to `"\n"' on input
-and `"\n"' to `"\r\n"' on output.  A special `BINMODE' variable allows
-control over these translations and is interpreted as follows:
+and `"\n"' to `"\r\n"' on output.  A special `BINMODE' variable
+(c.e.)  allows control over these translations and is interpreted as
+follows:
 
    * If `BINMODE' is `"r"', or one, then binary mode is set on read
      (i.e., no translations on reads).
@@ -20612,10 +20585,11 @@ B.5 Other Freely Available `awk' Implementations
 This minor node briefly describes where to get them:
 
 Unix `awk'
-     Brian Kernighan has made his implementation of `awk' freely
-     available.  You can retrieve this version via the World Wide Web
-     from his home page (http://www.cs.princeton.edu/~bwk).  It is
-     available in several archive formats:
+     Brian Kernighan, one of the original designers of Unix `awk', has
+     made his implementation of `awk' freely available.  You can
+     retrieve this version via the World Wide Web from his home page
+     (http://www.cs.princeton.edu/~bwk).  It is available in several
+     archive formats:
 
     Shell archive
           `http://www.cs.princeton.edu/~bwk/btl.mirror/awk.shar'
@@ -20629,8 +20603,8 @@ Unix `awk'
      This version requires an ISO C (1990 standard) compiler; the C
      compiler from GCC (the GNU Compiler Collection) works quite nicely.
 
-     *Note BTL::, for a list of extensions in this `awk' that are not
-     in POSIX `awk'.
+     *Note Common Extensions::, for a list of extensions in this `awk'
+     that are not in POSIX `awk'.
 
 `mawk'
      Michael Brennan has written an independent implementation of `awk',
@@ -20649,35 +20623,8 @@ Unix `awk'
      Once you have it, `gunzip' may be used to decompress this file.
      Installation is similar to `gawk''s (*note Unix Installation::).
 
-     `mawk' has the following extensions that are not in POSIX `awk':
-
-        * The `fflush()' built-in function for flushing buffered output
-          (*note I/O Functions::).
-
-        * The `**' and `**=' operators (*note Arithmetic Ops:: and also
-          see *note Assignment Ops::).
-
-        * The use of `func' as an abbreviation for `function' (*note
-          Definition Syntax::).
-
-        * The `\x' escape sequence (*note Escape Sequences::).
-
-        * The `/dev/stdout', and `/dev/stderr' special files (*note
-          Special Files::).  Use `"-"' instead of `"/dev/stdin"' with
-          `mawk'.
-
-        * The ability for `FS' and for the third argument to `split()'
-          to be null strings (*note Single Character Fields::).
-
-        * The ability to delete all of an array at once with `delete
-          ARRAY' (*note Delete::).
-
-        * The ability for `RS' to be a regexp (*note Records::).
-
-        * The `BINMODE' special variable for non-Unix operating systems
-          (*note PC Using::).
-
-        * The `nextfile' statement (*note Nextfile Statement::).
+     *Note Common Extensions::, for a list of extensions in `mawk' that
+     are not in POSIX `awk'.
 
 `awka'
      Written by Andrew Sumner, `awka' translates `awk' programs into C,
@@ -24107,6 +24054,13 @@ A.3 Consistency Issues
    * Use @code{xxx} for the xxx operator in indexing statements, not
      @samp.
 
+   * Use MS-Windows not MS Windows
+
+   * Use MS-DOS not MS-DOS
+
+   * Use an empty set of parentheses after built-in and awk function
+     names.
+
 
 File: gawk.info,  Node: Index,  Prev: next-edition,  Up: Top
 
@@ -24168,11 +24122,9 @@ Index
 * * (asterisk), * operator, null strings, matching: Gory Details.
                                                               (line  96)
 * * (asterisk), ** operator <1>:         Precedence.          (line  49)
-* * (asterisk), ** operator <2>:         Arithmetic Ops.      (line  81)
-* * (asterisk), ** operator:             Options.             (line 213)
+* * (asterisk), ** operator:             Arithmetic Ops.      (line  81)
 * * (asterisk), **= operator <1>:        Precedence.          (line  95)
-* * (asterisk), **= operator <2>:        Assignment Ops.      (line 129)
-* * (asterisk), **= operator:            Options.             (line 213)
+* * (asterisk), **= operator:            Assignment Ops.      (line 129)
 * * (asterisk), *= operator <1>:         Precedence.          (line  95)
 * * (asterisk), *= operator:             Assignment Ops.      (line 129)
 * + (plus sign):                         Regexp Operators.    (line 101)
@@ -24194,7 +24146,7 @@ Index
 * --assign option:                       Options.             (line  32)
 * --c option:                            Options.             (line  78)
 * --characters-as-bytes option:          Options.             (line  68)
-* --command option:                      Options.             (line 240)
+* --command option:                      Options.             (line 229)
 * --copyright option:                    Options.             (line  85)
 * --disable-lint configuration option:   Additional Configuration Options.
                                                               (line  13)
@@ -24208,30 +24160,30 @@ Index
 * --gen-pot option <1>:                  String Extraction.   (line   6)
 * --gen-pot option:                      Options.             (line 134)
 * --help option:                         Options.             (line 141)
-* --L option:                            Options.             (line 254)
+* --L option:                            Options.             (line 243)
 * --lint option <1>:                     Options.             (line 146)
 * --lint option:                         Command Line.        (line  20)
-* --lint-old option:                     Options.             (line 254)
+* --lint-old option:                     Options.             (line 243)
 * --non-decimal-data option <1>:         Nondecimal Data.     (line   6)
 * --non-decimal-data option:             Options.             (line 165)
 * --non-decimal-data option, strtonum() function and: Nondecimal Data.
                                                               (line  36)
 * --optimize option:                     Options.             (line 178)
 * --posix option:                        Options.             (line 197)
-* --posix option, --traditional option and: Options.          (line 227)
+* --posix option, --traditional option and: Options.          (line 216)
 * --profile option <1>:                  Profiling.           (line  15)
 * --profile option:                      Options.             (line 185)
-* --re-interval option:                  Options.             (line 233)
-* --sandbox option:                      Options.             (line 245)
+* --re-interval option:                  Options.             (line 222)
+* --sandbox option:                      Options.             (line 234)
 * --sandbox option, disabling system function: I/O Functions. (line  85)
 * --sandbox option, input redirection with getline: Getline.  (line  19)
 * --sandbox option, output redirection with print, printf: Redirection.
                                                               (line   6)
 * --source option:                       Options.             (line 104)
 * --traditional option:                  Options.             (line  78)
-* --traditional option, --posix option and: Options.          (line 227)
+* --traditional option, --posix option and: Options.          (line 216)
 * --use-lc-numeric option:               Options.             (line 173)
-* --version option:                      Options.             (line 259)
+* --version option:                      Options.             (line 248)
 * --with-whiny-user-strftime configuration option: Additional Configuration Options.
                                                               (line   9)
 * -b option:                             Options.             (line  68)
@@ -24244,8 +24196,8 @@ Index
 * -f option:                             Options.             (line  25)
 * -F option:                             Options.             (line  21)
 * -f option:                             Long.                (line  12)
-* -F option, -Ft sets FS to TAB:         Options.             (line 267)
-* -f option, on command line:            Options.             (line 272)
+* -F option, -Ft sets FS to TAB:         Options.             (line 256)
+* -f option, on command line:            Options.             (line 261)
 * -g option:                             Options.             (line 134)
 * -h option:                             Options.             (line 141)
 * -l option:                             Options.             (line 146)
@@ -24254,10 +24206,10 @@ Index
 * -O option:                             Options.             (line 178)
 * -P option:                             Options.             (line 197)
 * -p option:                             Options.             (line 185)
-* -R option:                             Options.             (line 240)
-* -r option:                             Options.             (line 233)
-* -S option:                             Options.             (line 245)
-* -V option:                             Options.             (line 259)
+* -R option:                             Options.             (line 229)
+* -r option:                             Options.             (line 222)
+* -S option:                             Options.             (line 234)
+* -V option:                             Options.             (line 248)
 * -v option:                             Options.             (line  32)
 * -v option, variables, assigning:       Assignment Options.  (line  12)
 * -W option:                             Options.             (line  46)
@@ -24278,7 +24230,7 @@ Index
                                                               (line 148)
 * / (forward slash), patterns and:       Expression Patterns. (line  24)
 * /= operator vs. /=.../ regexp constant: Assignment Ops.     (line 148)
-* /dev/... special files (gawk):         Special FD.          (line  44)
+* /dev/... special files (gawk):         Special FD.          (line  45)
 * /inet/ files (gawk):                   TCP/IP Networking.   (line   6)
 * /inet4/ files (gawk):                  TCP/IP Networking.   (line   6)
 * /inet6/ files (gawk):                  TCP/IP Networking.   (line   6)
@@ -24366,11 +24318,9 @@ Index
 * ^ (caret) <1>:                         GNU Regexp Operators.
                                                               (line  59)
 * ^ (caret):                             Regexp Operators.    (line  22)
-* ^ (caret), ^ operator <1>:             Precedence.          (line  49)
-* ^ (caret), ^ operator:                 Options.             (line 213)
+* ^ (caret), ^ operator:                 Precedence.          (line  49)
 * ^ (caret), ^= operator <1>:            Precedence.          (line  95)
-* ^ (caret), ^= operator <2>:            Assignment Ops.      (line 129)
-* ^ (caret), ^= operator:                Options.             (line 213)
+* ^ (caret), ^= operator:                Assignment Ops.      (line 129)
 * ^ (caret), in character lists:         Character Lists.     (line  16)
 * ^, in FS:                              Regexp Field Splitting.
                                                               (line  59)
@@ -24500,11 +24450,9 @@ Index
 * asterisk (*), * operator, null strings, matching: Gory Details.
                                                               (line  96)
 * asterisk (*), ** operator <1>:         Precedence.          (line  49)
-* asterisk (*), ** operator <2>:         Arithmetic Ops.      (line  81)
-* asterisk (*), ** operator:             Options.             (line 213)
+* asterisk (*), ** operator:             Arithmetic Ops.      (line  81)
 * asterisk (*), **= operator <1>:        Precedence.          (line  95)
-* asterisk (*), **= operator <2>:        Assignment Ops.      (line 129)
-* asterisk (*), **= operator:            Options.             (line 213)
+* asterisk (*), **= operator:            Assignment Ops.      (line 129)
 * asterisk (*), *= operator <1>:         Precedence.          (line  95)
 * asterisk (*), *= operator:             Assignment Ops.      (line 129)
 * atan2() function:                      Numeric Functions.   (line  11)
@@ -24557,9 +24505,11 @@ Index
 * awk, versions of, changes between SVR4 and POSIX awk: POSIX.
                                                               (line   6)
 * awk, versions of, changes between V7 and SVR3.1: V7/SVR3.1. (line   6)
+* awk, versions of, See Also Brian Kernighan's awk <1>: Other Versions.
+                                                              (line  13)
 * awk, versions of, See Also Brian Kernighan's awk: BTL.      (line   6)
 * awk.h file (internal):                 Internals.           (line  15)
-* awka compiler for awk:                 Other Versions.      (line  81)
+* awka compiler for awk:                 Other Versions.      (line  55)
 * AWKNUM internal type:                  Internals.           (line  19)
 * AWKPATH environment variable <1>:      PC Using.            (line  11)
 * AWKPATH environment variable:          AWKPATH Variable.    (line   6)
@@ -24620,7 +24570,7 @@ Index
 * backtrace debugger command:            Dgawk Stack.         (line  13)
 * BBS-list file:                         Sample Data Files.   (line   6)
 * Beebe, Nelson:                         Acknowledgments.     (line  59)
-* Beebe, Nelson H.F.:                    Other Versions.      (line  95)
+* Beebe, Nelson H.F.:                    Other Versions.      (line  69)
 * BEGIN pattern <1>:                     BEGIN/END.           (line   6)
 * BEGIN pattern <2>:                     Field Separators.    (line  44)
 * BEGIN pattern:                         Records.             (line  29)
@@ -24646,7 +24596,7 @@ Index
                                                               (line  73)
 * BEGINFILE special pattern:             BEGINFILE/ENDFILE.   (line   6)
 * beginfile() user-defined function:     Filetrans Function.  (line  62)
-* Benzinger, Michael:                    Contributors.        (line  92)
+* Benzinger, Michael:                    Contributors.        (line  94)
 * Berry, Karl:                           Acknowledgments.     (line  32)
 * binary input/output:                   User-modified.       (line  10)
 * bindtextdomain() function (C library): Explaining gettext.  (line  49)
@@ -24675,14 +24625,15 @@ Index
 * Brennan, Michael <1>:                  Other Versions.      (line   6)
 * Brennan, Michael <2>:                  Simple Sed.          (line  25)
 * Brennan, Michael <3>:                  Two-way I/O.         (line   6)
-* Brennan, Michael:                      Delete.              (line  51)
+* Brennan, Michael:                      Delete.              (line  52)
+* Brian Kernighan's awk, extensions <1>: Other Versions.      (line  13)
 * Brian Kernighan's awk, extensions:     BTL.                 (line   6)
-* Broder, Alan J.:                       Contributors.        (line  83)
-* Brown, Martin:                         Contributors.        (line  78)
+* Broder, Alan J.:                       Contributors.        (line  85)
+* Brown, Martin:                         Contributors.        (line  79)
 * BSD-based operating systems:           Glossary.            (line 580)
 * bt debugger command (alias for backtrace): Dgawk Stack.     (line  13)
 * Buening, Andreas <1>:                  Bugs.                (line  71)
-* Buening, Andreas <2>:                  Contributors.        (line  87)
+* Buening, Andreas <2>:                  Contributors.        (line  89)
 * Buening, Andreas:                      Acknowledgments.     (line  59)
 * buffering, input/output <1>:           Two-way I/O.         (line  70)
 * buffering, input/output:               I/O Functions.       (line 130)
@@ -24705,11 +24656,9 @@ Index
 * caret (^) <1>:                         GNU Regexp Operators.
                                                               (line  59)
 * caret (^):                             Regexp Operators.    (line  22)
-* caret (^), ^ operator <1>:             Precedence.          (line  49)
-* caret (^), ^ operator:                 Options.             (line 213)
+* caret (^), ^ operator:                 Precedence.          (line  49)
 * caret (^), ^= operator <1>:            Precedence.          (line  95)
-* caret (^), ^= operator <2>:            Assignment Ops.      (line 129)
-* caret (^), ^= operator:                Options.             (line 213)
+* caret (^), ^= operator:                Assignment Ops.      (line 129)
 * caret (^), in character lists:         Character Lists.     (line  16)
 * case keyword:                          Switch Statement.    (line   6)
 * case sensitivity, array indices and:   Array Intro.         (line  92)
@@ -24786,8 +24735,20 @@ Index
 * commenting, backslash continuation and: Statements/Lines.   (line  76)
 * common extensions, ** operator:        Arithmetic Ops.      (line  36)
 * common extensions, **= operator:       Assignment Ops.      (line 136)
+* common extensions, /dev/stderr special file: Special FD.    (line  45)
+* common extensions, /dev/stdin special file: Special FD.     (line  45)
+* common extensions, /dev/stdout special file: Special FD.    (line  45)
 * common extensions, \x escape sequence: Escape Sequences.    (line  61)
+* common extensions, BINMODE variable:   PC Using.            (line  34)
+* common extensions, delete to delete entire arrays: Delete.  (line  39)
 * common extensions, fflush() function:  I/O Functions.       (line  25)
+* common extensions, func keyword:       Definition Syntax.   (line  78)
+* common extensions, length() applied to an array: String Functions.
+                                                              (line 167)
+* common extensions, nextfile statement: Nextfile Statement.  (line   6)
+* common extensions, RS as a regexp:     Records.             (line 115)
+* common extensions, single character fields: Single Character Fields.
+                                                              (line   6)
 * comp.lang.awk newsgroup:               Bugs.                (line  38)
 * comparison expressions:                Typing and Comparison.
                                                               (line   9)
@@ -24843,7 +24804,7 @@ Index
 * cos() function:                        Numeric Functions.   (line  14)
 * counting:                              Wc Program.          (line   6)
 * csh utility:                           Statements/Lines.    (line  44)
-* csh utility, POSIXLY_CORRECT environment variable: Options. (line 310)
+* csh utility, POSIXLY_CORRECT environment variable: Options. (line 299)
 * csh utility, |& operator, comparison with: Two-way I/O.     (line  44)
 * ctime() user-defined function:         Function Example.    (line  72)
 * currency symbols, localization:        Explaining gettext.  (line 103)
@@ -25012,7 +24973,7 @@ Index
 * debugger commands, watch:              Viewing And Changing Data.
                                                               (line  67)
 * debugging gawk, bug reports:           Bugs.                (line   9)
-* decimal point character, locale specific: Options.          (line 221)
+* decimal point character, locale specific: Options.          (line 213)
 * decrement operators:                   Increment Ops.       (line  35)
 * default keyword:                       Switch Statement.    (line   6)
 * Deifik, Scott <1>:                     Bugs.                (line  70)
@@ -25175,7 +25136,6 @@ Index
 * escape processing, gsub()/gensub()/sub() functions: Gory Details.
                                                               (line   6)
 * escape sequences:                      Escape Sequences.    (line   6)
-* escape sequences, unrecognized:        Options.             (line 201)
 * eval debugger command:                 Viewing And Changing Data.
                                                               (line  23)
 * evaluation order:                      Increment Ops.       (line  61)
@@ -25214,13 +25174,25 @@ Index
 * Extended Regular Expressions (EREs):   Character Lists.     (line  23)
 * extension() function (gawk):           Using Internal File Ops.
                                                               (line  15)
+* extensions, Brian Kernighan's awk <1>: Other Versions.      (line  13)
 * extensions, Brian Kernighan's awk:     BTL.                 (line   6)
 * extensions, common, ** operator:       Arithmetic Ops.      (line  36)
 * extensions, common, **= operator:      Assignment Ops.      (line 136)
+* extensions, common, /dev/stderr special file: Special FD.   (line  45)
+* extensions, common, /dev/stdin special file: Special FD.    (line  45)
+* extensions, common, /dev/stdout special file: Special FD.   (line  45)
 * extensions, common, \x escape sequence: Escape Sequences.   (line  61)
+* extensions, common, BINMODE variable:  PC Using.            (line  34)
+* extensions, common, delete to delete entire arrays: Delete. (line  39)
 * extensions, common, fflush() function: I/O Functions.       (line  25)
+* extensions, common, func keyword:      Definition Syntax.   (line  78)
+* extensions, common, length() applied to an array: String Functions.
+                                                              (line 167)
+* extensions, common, nextfile statement: Nextfile Statement. (line   6)
+* extensions, common, RS as a regexp:    Records.             (line 115)
+* extensions, common, single character fields: Single Character Fields.
+                                                              (line   6)
 * extensions, in gawk, not in POSIX awk: POSIX/GNU.           (line   6)
-* extensions, mawk:                      Other Versions.      (line  51)
 * extract.awk program:                   Extract Program.     (line  78)
 * extraction, of marked strings (internationalization): String Extraction.
                                                               (line   6)
@@ -25235,7 +25207,6 @@ Index
 * Fenlason, Jay <1>:                     Contributors.        (line  19)
 * Fenlason, Jay:                         History.             (line  30)
 * fflush() function:                     I/O Functions.       (line  25)
-* fflush() function, unsupported:        Options.             (line 224)
 * field numbers:                         Nonconstant Fields.  (line   6)
 * field operator $:                      Fields.              (line  19)
 * field operators, dollar sign as:       Fields.              (line  19)
@@ -25273,7 +25244,7 @@ Index
 * file descriptors:                      Special FD.          (line   6)
 * file names, distinguishing:            Auto-set.            (line  52)
 * file names, in compatibility mode:     Special Caveats.     (line   9)
-* file names, standard streams in gawk:  Special FD.          (line  44)
+* file names, standard streams in gawk:  Special FD.          (line  45)
 * FILENAME variable <1>:                 Auto-set.            (line  92)
 * FILENAME variable:                     Reading Files.       (line   6)
 * FILENAME variable, getline, setting with: Getline Notes.    (line  19)
@@ -25286,7 +25257,7 @@ Index
 * files, .po:                            Explaining gettext.  (line  36)
 * files, .po, converting to .mo:         I18N Example.        (line  62)
 * files, .pot:                           Explaining gettext.  (line  30)
-* files, /dev/... special files:         Special FD.          (line  44)
+* files, /dev/... special files:         Special FD.          (line  45)
 * files, /inet/ (gawk):                  TCP/IP Networking.   (line   6)
 * files, /inet4/ (gawk):                 TCP/IP Networking.   (line   6)
 * files, /inet6/ (gawk):                 TCP/IP Networking.   (line   6)
@@ -25375,7 +25346,7 @@ Index
 * FS variable, --field-separator option and: Options.         (line  21)
 * FS variable, as null string:           Single Character Fields.
                                                               (line  20)
-* FS variable, as TAB character:         Options.             (line 217)
+* FS variable, as TAB character:         Options.             (line 209)
 * FS variable, changing value of:        Field Separators.    (line  34)
 * FS variable, running awk programs and: Cut Program.         (line  68)
 * FS variable, setting from command line: Command Line Field Separator.
@@ -25434,7 +25405,7 @@ Index
 * functions, user-defined, next/nextfile statements and: Next Statement.
                                                               (line  45)
 * G-d:                                   Acknowledgments.     (line  79)
-* Garfinkle, Scott:                      Contributors.        (line  37)
+* Garfinkle, Scott:                      Contributors.        (line  35)
 * gawk, awk and <1>:                     This Manual.         (line  14)
 * gawk, awk and:                         Preface.             (line  22)
 * gawk, bitwise operations in:           Bitwise Functions.   (line  39)
@@ -25501,7 +25472,7 @@ Index
 * gawk, string-translation functions:    I18N Functions.      (line   6)
 * gawk, timestamps:                      Time Functions.      (line   6)
 * gawk, uses for:                        Preface.             (line  35)
-* gawk, versions of, information about, printing: Options.    (line 259)
+* gawk, versions of, information about, printing: Options.    (line 248)
 * gawk, word-boundary operator:          GNU Regexp Operators.
                                                               (line  63)
 * General Public License (GPL):          Glossary.            (line 295)
@@ -25582,11 +25553,11 @@ Index
                                                               (line  68)
 * Hankerson, Darrel <1>:                 Contributors.        (line  58)
 * Hankerson, Darrel:                     Acknowledgments.     (line  59)
-* Haque, John <1>:                       Contributors.        (line  98)
+* Haque, John <1>:                       Contributors.        (line 100)
 * Haque, John:                           Acknowledgments.     (line  59)
 * Hartholz, Elaine:                      Acknowledgments.     (line  37)
 * Hartholz, Marshall:                    Acknowledgments.     (line  37)
-* Hasegawa, Isamu:                       Contributors.        (line  89)
+* Hasegawa, Isamu:                       Contributors.        (line  91)
 * help debugger command:                 Miscellaneous Dgawk Commands.
                                                               (line  68)
 * hexadecimal numbers:                   Nondecimal-numbers.  (line   6)
@@ -25690,8 +25661,8 @@ Index
 * Jacobs, Andrew:                        Passwd Functions.    (line  90)
 * Jaegermann, Michal <1>:                Contributors.        (line  45)
 * Jaegermann, Michal:                    Acknowledgments.     (line  59)
-* Java implementation of awk:            Other Versions.      (line 113)
-* jawk:                                  Other Versions.      (line 113)
+* Java implementation of awk:            Other Versions.      (line  87)
+* jawk:                                  Other Versions.      (line  87)
 * Jedi knights:                          Undocumented.        (line   6)
 * join() user-defined function:          Join Function.       (line  18)
 * Kahrs, Ju"rgen <1>:                    Contributors.        (line  67)
@@ -25708,7 +25679,7 @@ Index
 * Kernighan, Brian:                      History.             (line  17)
 * kill command, dynamic profiling:       Profiling.           (line 182)
 * Knights, jedi:                         Undocumented.        (line   6)
-* Kwok, Conrad:                          Contributors.        (line  37)
+* Kwok, Conrad:                          Contributors.        (line  35)
 * l debugger command (alias for list):   Miscellaneous Dgawk Commands.
                                                               (line  74)
 * labels.awk program:                    Labels Program.      (line  51)
@@ -25735,7 +25706,7 @@ Index
 * length() function:                     String Functions.    (line 137)
 * Lesser General Public License (LGPL):  Glossary.            (line 374)
 * LGPL (Lesser General Public License):  Glossary.            (line 374)
-* Libmawk:                               Other Versions.      (line 132)
+* Libmawk:                               Other Versions.      (line 106)
 * libraries of awk functions:            Library Functions.   (line   6)
 * libraries of awk functions, assertions: Assert Function.    (line   6)
 * libraries of awk functions, associative arrays and: Library Names.
@@ -25777,7 +25748,7 @@ Index
 * lint checking, empty programs:         Command Line.        (line  16)
 * lint checking, issuing warnings:       Options.             (line 146)
 * lint checking, POSIXLY_CORRECT environment variable: Options.
-                                                              (line 297)
+                                                              (line 286)
 * lint checking, undefined functions:    Pass By Value/Reference.
                                                               (line  88)
 * LINT variable:                         User-modified.       (line  98)
@@ -25788,7 +25759,7 @@ Index
                                                               (line  74)
 * local variables:                       Variable Scope.      (line   6)
 * locale categories:                     Explaining gettext.  (line  80)
-* locale decimal point character:        Options.             (line 221)
+* locale decimal point character:        Options.             (line 213)
 * locale, definition of:                 Locales.             (line   6)
 * localization:                          I18N and L10N.       (line   6)
 * localization, See internationalization, localization: I18N and L10N.
@@ -25825,8 +25796,8 @@ Index
                                                               (line   9)
 * matching, leftmost longest:            Multiple Line.       (line  26)
 * matching, null strings:                Gory Details.        (line  96)
-* mawk program:                          Other Versions.      (line  34)
-* McPhee, Patrick:                       Contributors.        (line  95)
+* mawk program:                          Other Versions.      (line  35)
+* McPhee, Patrick:                       Contributors.        (line  97)
 * memory, releasing:                     Internals.           (line 101)
 * message object files:                  Explaining gettext.  (line  41)
 * message object files, converting from portable object files: I18N Example.
@@ -25856,7 +25827,7 @@ Index
 * networks, programming:                 TCP/IP Networking.   (line   6)
 * networks, support for:                 Special Network.     (line   6)
 * newlines <1>:                          Boolean Ops.         (line  67)
-* newlines <2>:                          Options.             (line 204)
+* newlines <2>:                          Options.             (line 203)
 * newlines:                              Statements/Lines.    (line   6)
 * newlines, as field separators:         Default Field Splitting.
                                                               (line   6)
@@ -25943,7 +25914,7 @@ Index
 * OFS variable <2>:                      Output Separators.   (line   6)
 * OFS variable:                          Changing Fields.     (line  64)
 * OpenBSD:                               Glossary.            (line 580)
-* OpenSolaris:                           Other Versions.      (line 103)
+* OpenSolaris:                           Other Versions.      (line  77)
 * operating systems, BSD-based:          Manual History.      (line  28)
 * operating systems, PC, gawk on:        PC Using.            (line   6)
 * operating systems, PC, gawk on, installing: PC Installation.
@@ -26028,7 +25999,7 @@ Index
 * patterns, ranges in:                   Ranges.              (line   6)
 * patterns, regexp constants as:         Expression Patterns. (line  36)
 * patterns, types of:                    Pattern Overview.    (line  15)
-* pawk profiling Bell Labs awk:          Other Versions.      (line  95)
+* pawk profiling Bell Labs awk:          Other Versions.      (line  69)
 * PC operating systems, gawk on:         PC Using.            (line   6)
 * PC operating systems, gawk on, installing: PC Installation. (line   6)
 * percent sign (%), % operator:          Precedence.          (line  55)
@@ -26036,7 +26007,7 @@ Index
 * percent sign (%), %= operator:         Assignment Ops.      (line 129)
 * period (.):                            Regexp Operators.    (line  43)
 * PERL:                                  Future Extensions.   (line   6)
-* Peters, Arno:                          Contributors.        (line  80)
+* Peters, Arno:                          Contributors.        (line  82)
 * Peterson, Hal:                         Contributors.        (line  40)
 * pgawk program:                         Profiling.           (line   6)
 * pgawk program, awkprof.out file:       Profiling.           (line  10)
@@ -26067,10 +26038,10 @@ Index
 * portability, close() function and:     Close Files And Pipes.
                                                               (line  81)
 * portability, data files as single record: Records.          (line 175)
-* portability, deleting array elements:  Delete.              (line  51)
+* portability, deleting array elements:  Delete.              (line  52)
 * portability, example programs:         Library Functions.   (line  31)
 * portability, fflush() function and:    I/O Functions.       (line  29)
-* portability, functions, defining:      Definition Syntax.   (line  93)
+* portability, functions, defining:      Definition Syntax.   (line  94)
 * portability, gawk:                     New Ports.           (line   6)
 * portability, gettext library and:      Explaining gettext.  (line  10)
 * portability, internationalization and: I18N Portability.    (line   6)
@@ -26081,7 +26052,7 @@ Index
 * portability, NF variable, decrementing: Changing Fields.    (line 115)
 * portability, operators:                Increment Ops.       (line  61)
 * portability, operators, not in POSIX awk: Precedence.       (line  98)
-* portability, POSIXLY_CORRECT environment variable: Options. (line 315)
+* portability, POSIXLY_CORRECT environment variable: Options. (line 304)
 * portability, substr() function:        String Functions.    (line 484)
 * portable object files <1>:             Translator i18n.     (line   6)
 * portable object files:                 Explaining gettext.  (line  36)
@@ -26133,7 +26104,7 @@ Index
 * POSIX, awk and:                        Preface.             (line  22)
 * POSIX, gawk extensions not included in: POSIX/GNU.          (line   6)
 * POSIX, programs, implementing in awk:  Clones.              (line   6)
-* POSIXLY_CORRECT environment variable:  Options.             (line 297)
+* POSIXLY_CORRECT environment variable:  Options.             (line 286)
 * precedence <1>:                        Precedence.          (line   6)
 * precedence:                            Increment Ops.       (line  61)
 * precedence, regexp operators:          Regexp Operators.    (line 151)
@@ -26206,12 +26177,12 @@ Index
 * pwcat program:                         Passwd Functions.    (line  23)
 * q debugger command (alias for quit):   Miscellaneous Dgawk Commands.
                                                               (line 101)
-* QSE Awk:                               Other Versions.      (line 128)
+* QSE Awk:                               Other Versions.      (line 102)
 * question mark (?) <1>:                 GNU Regexp Operators.
                                                               (line  59)
 * question mark (?):                     Regexp Operators.    (line 110)
 * question mark (?), ?: operator:        Precedence.          (line  92)
-* QuikTrim Awk:                          Other Versions.      (line 121)
+* QuikTrim Awk:                          Other Versions.      (line  95)
 * quit debugger command:                 Miscellaneous Dgawk Commands.
                                                               (line 101)
 * QUIT signal (MS-Windows):              Profiling.           (line 207)
@@ -26232,7 +26203,7 @@ Index
 * range expressions:                     Character Lists.     (line   6)
 * range patterns:                        Ranges.              (line   6)
 * Rankin, Pat <1>:                       Bugs.                (line  72)
-* Rankin, Pat <2>:                       Contributors.        (line  35)
+* Rankin, Pat <2>:                       Contributors.        (line  38)
 * Rankin, Pat <3>:                       Assignment Ops.      (line 100)
 * Rankin, Pat:                           Acknowledgments.     (line  59)
 * readable data files, checking:         File Checking.       (line   6)
@@ -26285,7 +26256,7 @@ Index
                                                               (line  59)
 * regular expressions, gawk, command-line options: GNU Regexp Operators.
                                                               (line  70)
-* regular expressions, interval expressions and: Options.     (line 233)
+* regular expressions, interval expressions and: Options.     (line 222)
 * regular expressions, leftmost longest match: Leftmost Longest.
                                                               (line   6)
 * regular expressions, operators <1>:    Regexp Operators.    (line   6)
@@ -26323,7 +26294,7 @@ Index
 * RLENGTH variable, match() function and: String Functions.   (line 194)
 * Robbins, Arnold <1>:                   Future Extensions.   (line   6)
 * Robbins, Arnold <2>:                   Bugs.                (line  32)
-* Robbins, Arnold <3>:                   Contributors.        (line 101)
+* Robbins, Arnold <3>:                   Contributors.        (line 103)
 * Robbins, Arnold <4>:                   Alarm Program.       (line   6)
 * Robbins, Arnold <5>:                   Passwd Functions.    (line  90)
 * Robbins, Arnold <6>:                   Getline/Pipe.        (line  36)
@@ -26358,7 +26329,7 @@ Index
 * rvalues/lvalues:                       Assignment Ops.      (line  32)
 * s debugger command (alias for step):   Dgawk Execution Control.
                                                               (line  68)
-* sandbox mode:                          Options.             (line 245)
+* sandbox mode:                          Options.             (line 234)
 * scalar values:                         Basic Data Typing.   (line  13)
 * Schorr, Andrew:                        Acknowledgments.     (line  59)
 * Schreiber, Bert:                       Acknowledgments.     (line  37)
@@ -26432,23 +26403,23 @@ Index
 * single-precision floating-point:       Basic Data Typing.   (line  33)
 * Skywalker, Luke:                       Undocumented.        (line   6)
 * sleep utility:                         Alarm Program.       (line 109)
-* Solaris, POSIX compliant awk:          Other Versions.      (line 103)
+* Solaris, POSIX compliant awk:          Other Versions.      (line  77)
 * sort function, arrays, sorting:        Array Sorting.       (line   6)
 * sort utility:                          Word Sorting.        (line  56)
 * sort utility, coprocesses and:         Two-way I/O.         (line  83)
 * sorting characters in different languages: Explaining gettext.
                                                               (line  93)
-* source code, awka:                     Other Versions.      (line  81)
+* source code, awka:                     Other Versions.      (line  55)
 * source code, Bell Laboratories awk:    Other Versions.      (line  13)
 * source code, gawk:                     Gawk Distribution.   (line   6)
-* source code, mawk:                     Other Versions.      (line  34)
+* source code, mawk:                     Other Versions.      (line  35)
 * source code, mixing:                   Options.             (line 104)
 * source files, search path for:         Igawk Program.       (line 364)
 * sparse arrays:                         Array Intro.         (line  71)
 * Spencer, Henry:                        Glossary.            (line  12)
 * split utility:                         Split Program.       (line   6)
 * split() function:                      String Functions.    (line 285)
-* split() function, array elements, deleting: Delete.         (line  56)
+* split() function, array elements, deleting: Delete.         (line  57)
 * split.awk program:                     Split Program.       (line  30)
 * sprintf() function <1>:                String Functions.    (line 349)
 * sprintf() function:                    OFMT.                (line  15)
@@ -26519,7 +26490,7 @@ Index
 * SUBSEP variable, multidimensional arrays: Multi-dimensional.
                                                               (line  16)
 * substr() function:                     String Functions.    (line 453)
-* Sumner, Andrew:                        Other Versions.      (line  81)
+* Sumner, Andrew:                        Other Versions.      (line  55)
 * switch statement:                      Switch Statement.    (line   6)
 * syntactic ambiguity: /= operator vs. /=.../ regexp constant: Assignment Ops.
                                                               (line 148)
@@ -26599,7 +26570,7 @@ Index
 * troubleshooting, print statement, omitting commas: Print Examples.
                                                               (line  31)
 * troubleshooting, printing:             Redirection.         (line 118)
-* troubleshooting, quotes with file names: Special FD.        (line  66)
+* troubleshooting, quotes with file names: Special FD.        (line  67)
 * troubleshooting, readable data files:  File Checking.       (line   6)
 * troubleshooting, regexp constants vs. string constants: Computed Regexps.
                                                               (line  38)
@@ -26719,9 +26690,9 @@ Index
 * whitespace, as field separators:       Default Field Splitting.
                                                               (line   6)
 * whitespace, functions, calling:        Calling Built-in.    (line  10)
-* whitespace, newlines as:               Options.             (line 204)
-* Williams, Kent:                        Contributors.        (line  37)
-* Woehlke, Matthew:                      Contributors.        (line  75)
+* whitespace, newlines as:               Options.             (line 203)
+* Williams, Kent:                        Contributors.        (line  35)
+* Woehlke, Matthew:                      Contributors.        (line  76)
 * Woods, John:                           Contributors.        (line  28)
 * word boundaries, matching:             GNU Regexp Operators.
                                                               (line  38)
@@ -26772,405 +26743,406 @@ Index
 
 Tag Table:
 Node: Top1340
-Node: Foreword29971
-Node: Preface34291
-Ref: Preface-Footnote-137243
-Ref: Preface-Footnote-237349
-Node: History37581
-Node: Names39815
-Ref: Names-Footnote-141292
-Node: This Manual41364
-Ref: This Manual-Footnote-146262
-Node: Conventions46362
-Node: Manual History48478
-Ref: Manual History-Footnote-151656
-Ref: Manual History-Footnote-251697
-Node: How To Contribute51771
-Node: Acknowledgments52915
-Node: Getting Started57163
-Node: Running gawk59542
-Node: One-shot60728
-Node: Read Terminal61953
-Ref: Read Terminal-Footnote-163603
-Ref: Read Terminal-Footnote-263877
-Node: Long64048
-Node: Executable Scripts65424
-Ref: Executable Scripts-Footnote-167285
-Ref: Executable Scripts-Footnote-267387
-Node: Comments67838
-Node: Quoting70305
-Node: DOS Quoting74922
-Node: Sample Data Files75597
-Node: Very Simple78629
-Node: Two Rules83226
-Node: More Complex85373
-Ref: More Complex-Footnote-188303
-Node: Statements/Lines88383
-Ref: Statements/Lines-Footnote-192845
-Node: Other Features93110
-Node: When93979
-Node: Invoking Gawk96122
-Node: Command Line97507
-Node: Options98290
-Ref: Options-Footnote-1111635
-Node: Other Arguments111660
-Node: Naming Standard Input114323
-Node: Environment Variables115287
-Node: AWKPATH Variable115731
-Ref: AWKPATH Variable-Footnote-1118468
-Node: Other Environment Variables118728
-Node: Exit Status121076
-Node: Include Files121751
-Node: Obsolete125142
-Node: Undocumented125828
-Node: Regexp126069
-Node: Regexp Usage127521
-Node: Escape Sequences129547
-Node: Regexp Operators135290
-Ref: Regexp Operators-Footnote-1142462
-Ref: Regexp Operators-Footnote-2142609
-Node: Character Lists142707
-Ref: table-char-classes144482
-Node: GNU Regexp Operators147122
-Node: Case-sensitivity150841
-Ref: Case-sensitivity-Footnote-1153796
-Ref: Case-sensitivity-Footnote-2154031
-Node: Leftmost Longest154139
-Node: Computed Regexps155340
-Node: Locales158757
-Node: Reading Files162299
-Node: Records164240
-Ref: Records-Footnote-1172912
-Node: Fields172949
-Ref: Fields-Footnote-1175981
-Node: Nonconstant Fields176067
-Node: Changing Fields178269
-Node: Field Separators183559
-Node: Default Field Splitting186188
-Node: Regexp Field Splitting187305
-Node: Single Character Fields190663
-Node: Command Line Field Separator191714
-Node: Field Splitting Summary195153
-Ref: Field Splitting Summary-Footnote-1198339
-Node: Constant Size198440
-Node: Splitting By Content203002
-Ref: Splitting By Content-Footnote-1206728
-Node: Multiple Line206768
-Ref: Multiple Line-Footnote-1212615
-Node: Getline212794
-Node: Plain Getline215022
-Node: Getline/Variable217111
-Node: Getline/File218252
-Node: Getline/Variable/File219574
-Ref: Getline/Variable/File-Footnote-1221173
-Node: Getline/Pipe221260
-Node: Getline/Variable/Pipe223808
-Node: Getline/Coprocess224915
-Node: Getline/Variable/Coprocess226158
-Node: Getline Notes226872
-Node: Getline Summary228814
-Ref: table-getline-variants229098
-Node: Command line directories230003
-Node: Printing230628
-Node: Print232259
-Node: Print Examples233596
-Node: Output Separators236380
-Node: OFMT238139
-Node: Printf239497
-Node: Basic Printf240403
-Node: Control Letters241940
-Node: Format Modifiers245752
-Node: Printf Examples251763
-Node: Redirection254478
-Node: Special Files261456
-Node: Special FD261989
-Ref: Special FD-Footnote-1265564
-Node: Special Network265638
-Node: Special Caveats266493
-Node: Close Files And Pipes267287
-Ref: Close Files And Pipes-Footnote-1274231
-Ref: Close Files And Pipes-Footnote-2274379
-Node: Expressions274529
-Node: Values275598
-Node: Constants276274
-Node: Scalar Constants276954
-Ref: Scalar Constants-Footnote-1277813
-Node: Nondecimal-numbers277995
-Node: Regexp Constants281054
-Node: Using Constant Regexps281529
-Node: Variables284534
-Node: Using Variables285189
-Node: Assignment Options286916
-Node: Conversion288797
-Ref: table-locale-affects294171
-Ref: Conversion-Footnote-1294795
-Node: All Operators294904
-Node: Arithmetic Ops295534
-Node: Concatenation298040
-Ref: Concatenation-Footnote-1300833
-Node: Assignment Ops300952
-Ref: table-assign-ops305940
-Node: Increment Ops307348
-Node: Truth Values and Conditions310826
-Node: Truth Values311909
-Node: Typing and Comparison312957
-Node: Variable Typing313746
-Ref: Variable Typing-Footnote-1317643
-Node: Comparison Operators317765
-Ref: table-relational-ops318175
-Node: POSIX String Comparison321724
-Ref: POSIX String Comparison-Footnote-1322681
-Node: Boolean Ops322819
-Ref: Boolean Ops-Footnote-1326897
-Node: Conditional Exp326988
-Node: Function Calls328720
-Node: Precedence332310
-Node: Patterns and Actions335963
-Node: Pattern Overview337017
-Node: Regexp Patterns338683
-Node: Expression Patterns339226
-Node: Ranges342800
-Node: BEGIN/END345766
-Node: Using BEGIN/END346516
-Ref: Using BEGIN/END-Footnote-1349247
-Node: I/O And BEGIN/END349361
-Node: Empty351630
-Node: BEGINFILE/ENDFILE351964
-Node: Using Shell Variables354789
-Node: Action Overview357068
-Node: Statements359425
-Node: If Statement361284
-Node: While Statement362783
-Node: Do Statement364827
-Node: For Statement365983
-Node: Switch Statement369135
-Node: Break Statement371232
-Node: Continue Statement373208
-Node: Next Statement374909
-Node: Nextfile Statement377291
-Node: Exit Statement379809
-Node: Built-in Variables382140
-Node: User-modified383235
-Ref: User-modified-Footnote-1391236
-Node: Auto-set391298
-Ref: Auto-set-Footnote-1400281
-Node: ARGC and ARGV400486
-Node: Arrays404245
-Node: Array Basics405816
-Node: Array Intro406527
-Node: Reference to Elements410845
-Node: Assigning Elements413115
-Node: Array Example413606
-Node: Scanning an Array415338
-Node: Delete417615
-Ref: Delete-Footnote-1420038
-Node: Numeric Array Subscripts420095
-Node: Uninitialized Subscripts422278
-Node: Multi-dimensional423906
-Node: Multi-scanning426997
-Node: Array Sorting428581
-Ref: Array Sorting-Footnote-1431779
-Node: Arrays of Arrays431973
-Node: Functions436135
-Node: Built-in436957
-Node: Calling Built-in437971
-Node: Numeric Functions439947
-Ref: Numeric Functions-Footnote-1443704
-Ref: Numeric Functions-Footnote-2444040
-Ref: Numeric Functions-Footnote-3444088
-Node: String Functions444357
-Ref: String Functions-Footnote-1466156
-Ref: String Functions-Footnote-2466285
-Ref: String Functions-Footnote-3466533
-Node: Gory Details466620
-Ref: table-sub-escapes468277
-Ref: table-posix-sub469591
-Ref: table-gensub-escapes470491
-Node: I/O Functions471662
-Ref: I/O Functions-Footnote-1478357
-Node: Time Functions478504
-Ref: Time Functions-Footnote-1489371
-Ref: Time Functions-Footnote-2489439
-Ref: Time Functions-Footnote-3489597
-Ref: Time Functions-Footnote-4489708
-Ref: Time Functions-Footnote-5489820
-Ref: Time Functions-Footnote-6490047
-Node: Bitwise Functions490313
-Ref: table-bitwise-ops490871
-Ref: Bitwise Functions-Footnote-1495031
-Node: I18N Functions495215
-Node: User-defined496845
-Node: Definition Syntax497649
-Ref: Definition Syntax-Footnote-1502279
-Node: Function Example502348
-Node: Function Caveats504942
-Node: Calling A Function505363
-Node: Variable Scope506478
-Node: Pass By Value/Reference508406
-Node: Return Statement511846
-Node: Dynamic Typing514788
-Node: Indirect Calls515525
-Node: Internationalization525210
-Node: I18N and L10N526638
-Node: Explaining gettext527324
-Ref: Explaining gettext-Footnote-1532386
-Ref: Explaining gettext-Footnote-2532569
-Node: Programmer i18n532734
-Node: Translator i18n537025
-Node: String Extraction537818
-Ref: String Extraction-Footnote-1538779
-Node: Printf Ordering538865
-Ref: Printf Ordering-Footnote-1541649
-Node: I18N Portability541713
-Ref: I18N Portability-Footnote-1544162
-Node: I18N Example544225
-Ref: I18N Example-Footnote-1546860
-Node: Gawk I18N546932
-Node: Advanced Features547549
-Node: Nondecimal Data548868
-Node: Two-way I/O550449
-Ref: Two-way I/O-Footnote-1555863
-Node: TCP/IP Networking555940
-Node: Profiling558783
-Node: Library Functions566183
-Ref: Library Functions-Footnote-1569153
-Node: Library Names569324
-Ref: Library Names-Footnote-1572795
-Ref: Library Names-Footnote-2573015
-Node: General Functions573101
-Node: Nextfile Function574164
-Node: Strtonum Function578545
-Node: Assert Function581496
-Node: Round Function584822
-Node: Cliff Random Function586363
-Node: Ordinal Functions587379
-Ref: Ordinal Functions-Footnote-1590449
-Ref: Ordinal Functions-Footnote-2590701
-Node: Join Function590917
-Ref: Join Function-Footnote-1592688
-Node: Gettimeofday Function592888
-Node: Data File Management596603
-Node: Filetrans Function597235
-Node: Rewind Function601472
-Node: File Checking602925
-Node: Empty Files604019
-Node: Ignoring Assigns606249
-Node: Getopt Function607802
-Ref: Getopt Function-Footnote-1619127
-Node: Passwd Functions619330
-Ref: Passwd Functions-Footnote-1628318
-Node: Group Functions628406
-Node: Sample Programs636486
-Node: Running Examples637151
-Node: Clones637879
-Node: Cut Program639002
-Node: Egrep Program648843
-Ref: Egrep Program-Footnote-1656614
-Node: Id Program656724
-Node: Split Program660340
-Ref: Split Program-Footnote-1663859
-Node: Tee Program663987
-Node: Uniq Program666790
-Node: Wc Program674213
-Ref: Wc Program-Footnote-1678477
-Node: Miscellaneous Programs678677
-Node: Dupword Program679797
-Node: Alarm Program681828
-Node: Translate Program686550
-Ref: Translate Program-Footnote-1690929
-Ref: Translate Program-Footnote-2691157
-Node: Labels Program691291
-Ref: Labels Program-Footnote-1694662
-Node: Word Sorting694746
-Node: History Sorting699091
-Node: Extract Program700929
-Ref: Extract Program-Footnote-1708410
-Node: Simple Sed708538
-Node: Igawk Program711600
-Ref: Igawk Program-Footnote-1726634
-Ref: Igawk Program-Footnote-2726835
-Node: Signature Program726973
-Node: Debugger728053
-Node: Debugging728964
-Node: Debugging Concepts729278
-Node: Debugging Terms731134
-Node: Awk Debugging733679
-Node: Sample dgawk session734571
-Node: dgawk invocation735063
-Node: Finding The Bug736245
-Node: List of Debugger Commands742729
-Node: Breakpoint Control744040
-Node: Dgawk Execution Control747516
-Node: Viewing And Changing Data750867
-Node: Dgawk Stack754176
-Node: Dgawk Info755636
-Node: Miscellaneous Dgawk Commands759584
-Node: Readline Support765012
-Node: Dgawk Limitations765839
-Node: Language History767978
-Node: V7/SVR3.1769351
-Node: SVR4771646
-Node: POSIX773091
-Node: BTL775346
-Node: POSIX/GNU776738
-Node: Contributors781919
-Node: Installation785864
-Node: Gawk Distribution786758
-Node: Getting787242
-Node: Extracting788068
-Node: Distribution contents789746
-Node: Unix Installation794764
-Node: Quick Installation795381
-Node: Additional Configuration Options797343
-Node: Configuration Philosophy798820
-Node: Non-Unix Installation801162
-Node: PC Installation801620
-Node: PC Binary Installation802919
-Node: PC Compiling804767
-Node: PC Testing808173
-Node: PC Using808997
-Node: Cygwin813174
-Node: MSYS814171
-Node: VMS Installation814685
-Node: VMS Compilation815289
-Node: VMS Installation Details816866
-Node: VMS Running818496
-Node: VMS POSIX820093
-Node: VMS Old Gawk821391
-Node: Bugs821863
-Node: Other Versions825728
-Node: Notes831176
-Node: Compatibility Mode831868
-Node: Additions832651
-Node: Accessing The Source833463
-Node: Adding Code834886
-Node: New Ports840434
-Node: Dynamic Extensions844547
-Node: Internals845923
-Node: Plugin License855042
-Node: Sample Library855676
-Node: Internal File Description856362
-Node: Internal File Ops860069
-Ref: Internal File Ops-Footnote-1864802
-Node: Using Internal File Ops864950
-Node: Future Extensions867327
-Node: Basic Concepts869832
-Node: Basic High Level870589
-Ref: Basic High Level-Footnote-1874708
-Node: Basic Data Typing874902
-Node: Floating Point Issues879339
-Node: String Conversion Precision880422
-Ref: String Conversion Precision-Footnote-1882116
-Node: Unexpected Results882225
-Node: POSIX Floating Point Problems884051
-Ref: POSIX Floating Point Problems-Footnote-1887750
-Node: Glossary887788
-Node: Copying911423
-Node: GNU Free Documentation License948980
-Node: next-edition974124
-Node: unresolved974476
-Node: revision974976
-Node: consistency975399
-Node: Index978752
+Node: Foreword30033
+Node: Preface34353
+Ref: Preface-Footnote-137305
+Ref: Preface-Footnote-237411
+Node: History37643
+Node: Names39877
+Ref: Names-Footnote-141354
+Node: This Manual41426
+Ref: This Manual-Footnote-146324
+Node: Conventions46424
+Node: Manual History48540
+Ref: Manual History-Footnote-151718
+Ref: Manual History-Footnote-251759
+Node: How To Contribute51833
+Node: Acknowledgments52977
+Node: Getting Started57225
+Node: Running gawk59604
+Node: One-shot60790
+Node: Read Terminal62015
+Ref: Read Terminal-Footnote-163665
+Ref: Read Terminal-Footnote-263939
+Node: Long64110
+Node: Executable Scripts65486
+Ref: Executable Scripts-Footnote-167347
+Ref: Executable Scripts-Footnote-267449
+Node: Comments67900
+Node: Quoting70367
+Node: DOS Quoting74984
+Node: Sample Data Files75659
+Node: Very Simple78691
+Node: Two Rules83288
+Node: More Complex85435
+Ref: More Complex-Footnote-188365
+Node: Statements/Lines88445
+Ref: Statements/Lines-Footnote-192907
+Node: Other Features93172
+Node: When94041
+Node: Invoking Gawk96184
+Node: Command Line97569
+Node: Options98352
+Ref: Options-Footnote-1111406
+Node: Other Arguments111431
+Node: Naming Standard Input114094
+Node: Environment Variables115058
+Node: AWKPATH Variable115502
+Ref: AWKPATH Variable-Footnote-1118239
+Node: Other Environment Variables118499
+Node: Exit Status120847
+Node: Include Files121522
+Node: Obsolete124913
+Node: Undocumented125599
+Node: Regexp125840
+Node: Regexp Usage127292
+Node: Escape Sequences129318
+Node: Regexp Operators135061
+Ref: Regexp Operators-Footnote-1142233
+Ref: Regexp Operators-Footnote-2142380
+Node: Character Lists142478
+Ref: table-char-classes144253
+Node: GNU Regexp Operators146893
+Node: Case-sensitivity150612
+Ref: Case-sensitivity-Footnote-1153567
+Ref: Case-sensitivity-Footnote-2153802
+Node: Leftmost Longest153910
+Node: Computed Regexps155111
+Node: Locales158528
+Node: Reading Files162070
+Node: Records164011
+Ref: Records-Footnote-1172690
+Node: Fields172727
+Ref: Fields-Footnote-1175759
+Node: Nonconstant Fields175845
+Node: Changing Fields178047
+Node: Field Separators183337
+Node: Default Field Splitting185966
+Node: Regexp Field Splitting187083
+Node: Single Character Fields190441
+Node: Command Line Field Separator191500
+Node: Field Splitting Summary194939
+Ref: Field Splitting Summary-Footnote-1198125
+Node: Constant Size198226
+Node: Splitting By Content202788
+Ref: Splitting By Content-Footnote-1206514
+Node: Multiple Line206554
+Ref: Multiple Line-Footnote-1212401
+Node: Getline212580
+Node: Plain Getline214808
+Node: Getline/Variable216897
+Node: Getline/File218038
+Node: Getline/Variable/File219360
+Ref: Getline/Variable/File-Footnote-1220959
+Node: Getline/Pipe221046
+Node: Getline/Variable/Pipe223594
+Node: Getline/Coprocess224701
+Node: Getline/Variable/Coprocess225944
+Node: Getline Notes226658
+Node: Getline Summary228600
+Ref: table-getline-variants228884
+Node: Command line directories229789
+Node: Printing230414
+Node: Print232045
+Node: Print Examples233382
+Node: Output Separators236166
+Node: OFMT237925
+Node: Printf239283
+Node: Basic Printf240189
+Node: Control Letters241726
+Node: Format Modifiers245538
+Node: Printf Examples251549
+Node: Redirection254264
+Node: Special Files261242
+Node: Special FD261775
+Ref: Special FD-Footnote-1265386
+Node: Special Network265460
+Node: Special Caveats266315
+Node: Close Files And Pipes267109
+Ref: Close Files And Pipes-Footnote-1274053
+Ref: Close Files And Pipes-Footnote-2274201
+Node: Expressions274351
+Node: Values275420
+Node: Constants276096
+Node: Scalar Constants276776
+Ref: Scalar Constants-Footnote-1277635
+Node: Nondecimal-numbers277817
+Node: Regexp Constants280876
+Node: Using Constant Regexps281351
+Node: Variables284356
+Node: Using Variables285011
+Node: Assignment Options286738
+Node: Conversion288619
+Ref: table-locale-affects293993
+Ref: Conversion-Footnote-1294617
+Node: All Operators294726
+Node: Arithmetic Ops295356
+Node: Concatenation297862
+Ref: Concatenation-Footnote-1300655
+Node: Assignment Ops300774
+Ref: table-assign-ops305762
+Node: Increment Ops307170
+Node: Truth Values and Conditions310648
+Node: Truth Values311731
+Node: Typing and Comparison312779
+Node: Variable Typing313568
+Ref: Variable Typing-Footnote-1317465
+Node: Comparison Operators317587
+Ref: table-relational-ops317997
+Node: POSIX String Comparison321546
+Ref: POSIX String Comparison-Footnote-1322503
+Node: Boolean Ops322641
+Ref: Boolean Ops-Footnote-1326719
+Node: Conditional Exp326810
+Node: Function Calls328542
+Node: Precedence332132
+Node: Patterns and Actions335785
+Node: Pattern Overview336839
+Node: Regexp Patterns338505
+Node: Expression Patterns339048
+Node: Ranges342622
+Node: BEGIN/END345588
+Node: Using BEGIN/END346338
+Ref: Using BEGIN/END-Footnote-1349069
+Node: I/O And BEGIN/END349183
+Node: Empty351452
+Node: BEGINFILE/ENDFILE351786
+Node: Using Shell Variables354611
+Node: Action Overview356890
+Node: Statements359247
+Node: If Statement361106
+Node: While Statement362605
+Node: Do Statement364649
+Node: For Statement365805
+Node: Switch Statement368957
+Node: Break Statement371054
+Node: Continue Statement373030
+Node: Next Statement374731
+Node: Nextfile Statement377113
+Node: Exit Statement379638
+Node: Built-in Variables381969
+Node: User-modified383064
+Ref: User-modified-Footnote-1391065
+Node: Auto-set391127
+Ref: Auto-set-Footnote-1400110
+Node: ARGC and ARGV400315
+Node: Arrays404074
+Node: Array Basics405645
+Node: Array Intro406356
+Node: Reference to Elements410674
+Node: Assigning Elements412944
+Node: Array Example413435
+Node: Scanning an Array415167
+Node: Delete417444
+Ref: Delete-Footnote-1419875
+Node: Numeric Array Subscripts419932
+Node: Uninitialized Subscripts422115
+Node: Multi-dimensional423743
+Node: Multi-scanning426834
+Node: Array Sorting428418
+Ref: Array Sorting-Footnote-1431616
+Node: Arrays of Arrays431810
+Node: Functions435972
+Node: Built-in436794
+Node: Calling Built-in437808
+Node: Numeric Functions439784
+Ref: Numeric Functions-Footnote-1443541
+Ref: Numeric Functions-Footnote-2443877
+Ref: Numeric Functions-Footnote-3443925
+Node: String Functions444194
+Ref: String Functions-Footnote-1466000
+Ref: String Functions-Footnote-2466129
+Ref: String Functions-Footnote-3466377
+Node: Gory Details466464
+Ref: table-sub-escapes468121
+Ref: table-posix-sub469435
+Ref: table-gensub-escapes470335
+Node: I/O Functions471506
+Ref: I/O Functions-Footnote-1478201
+Node: Time Functions478348
+Ref: Time Functions-Footnote-1489215
+Ref: Time Functions-Footnote-2489283
+Ref: Time Functions-Footnote-3489441
+Ref: Time Functions-Footnote-4489552
+Ref: Time Functions-Footnote-5489664
+Ref: Time Functions-Footnote-6489891
+Node: Bitwise Functions490157
+Ref: table-bitwise-ops490715
+Ref: Bitwise Functions-Footnote-1494875
+Node: I18N Functions495059
+Node: User-defined496689
+Node: Definition Syntax497493
+Ref: Definition Syntax-Footnote-1502130
+Node: Function Example502199
+Node: Function Caveats504793
+Node: Calling A Function505214
+Node: Variable Scope506329
+Node: Pass By Value/Reference508257
+Node: Return Statement511697
+Node: Dynamic Typing514639
+Node: Indirect Calls515376
+Node: Internationalization525061
+Node: I18N and L10N526489
+Node: Explaining gettext527175
+Ref: Explaining gettext-Footnote-1532237
+Ref: Explaining gettext-Footnote-2532420
+Node: Programmer i18n532585
+Node: Translator i18n536876
+Node: String Extraction537669
+Ref: String Extraction-Footnote-1538630
+Node: Printf Ordering538716
+Ref: Printf Ordering-Footnote-1541500
+Node: I18N Portability541564
+Ref: I18N Portability-Footnote-1544013
+Node: I18N Example544076
+Ref: I18N Example-Footnote-1546711
+Node: Gawk I18N546783
+Node: Advanced Features547400
+Node: Nondecimal Data548719
+Node: Two-way I/O550300
+Ref: Two-way I/O-Footnote-1555714
+Node: TCP/IP Networking555791
+Node: Profiling558634
+Node: Library Functions566034
+Ref: Library Functions-Footnote-1569004
+Node: Library Names569175
+Ref: Library Names-Footnote-1572646
+Ref: Library Names-Footnote-2572866
+Node: General Functions572952
+Node: Nextfile Function574015
+Node: Strtonum Function578396
+Node: Assert Function581347
+Node: Round Function584673
+Node: Cliff Random Function586214
+Node: Ordinal Functions587230
+Ref: Ordinal Functions-Footnote-1590300
+Ref: Ordinal Functions-Footnote-2590552
+Node: Join Function590768
+Ref: Join Function-Footnote-1592539
+Node: Gettimeofday Function592739
+Node: Data File Management596454
+Node: Filetrans Function597086
+Node: Rewind Function601323
+Node: File Checking602776
+Node: Empty Files603870
+Node: Ignoring Assigns606100
+Node: Getopt Function607653
+Ref: Getopt Function-Footnote-1618978
+Node: Passwd Functions619181
+Ref: Passwd Functions-Footnote-1628169
+Node: Group Functions628257
+Node: Sample Programs636337
+Node: Running Examples637002
+Node: Clones637730
+Node: Cut Program638853
+Node: Egrep Program648694
+Ref: Egrep Program-Footnote-1656465
+Node: Id Program656575
+Node: Split Program660191
+Ref: Split Program-Footnote-1663710
+Node: Tee Program663838
+Node: Uniq Program666641
+Node: Wc Program674064
+Ref: Wc Program-Footnote-1678328
+Node: Miscellaneous Programs678528
+Node: Dupword Program679648
+Node: Alarm Program681679
+Node: Translate Program686401
+Ref: Translate Program-Footnote-1690780
+Ref: Translate Program-Footnote-2691008
+Node: Labels Program691142
+Ref: Labels Program-Footnote-1694513
+Node: Word Sorting694597
+Node: History Sorting698942
+Node: Extract Program700780
+Ref: Extract Program-Footnote-1708261
+Node: Simple Sed708389
+Node: Igawk Program711451
+Ref: Igawk Program-Footnote-1726485
+Ref: Igawk Program-Footnote-2726686
+Node: Signature Program726824
+Node: Debugger727904
+Node: Debugging728815
+Node: Debugging Concepts729129
+Node: Debugging Terms730985
+Node: Awk Debugging733530
+Node: Sample dgawk session734422
+Node: dgawk invocation734914
+Node: Finding The Bug736096
+Node: List of Debugger Commands742580
+Node: Breakpoint Control743891
+Node: Dgawk Execution Control747367
+Node: Viewing And Changing Data750718
+Node: Dgawk Stack754027
+Node: Dgawk Info755487
+Node: Miscellaneous Dgawk Commands759435
+Node: Readline Support764863
+Node: Dgawk Limitations765690
+Node: Language History767829
+Node: V7/SVR3.1769261
+Node: SVR4771556
+Node: POSIX773001
+Node: BTL773999
+Node: POSIX/GNU774733
+Node: Common Extensions779919
+Node: Contributors781052
+Node: Installation785087
+Node: Gawk Distribution785981
+Node: Getting786465
+Node: Extracting787291
+Node: Distribution contents788969
+Node: Unix Installation793987
+Node: Quick Installation794604
+Node: Additional Configuration Options796566
+Node: Configuration Philosophy798043
+Node: Non-Unix Installation800385
+Node: PC Installation800843
+Node: PC Binary Installation802142
+Node: PC Compiling803990
+Node: PC Testing807396
+Node: PC Using808220
+Node: Cygwin812405
+Node: MSYS813402
+Node: VMS Installation813916
+Node: VMS Compilation814520
+Node: VMS Installation Details816097
+Node: VMS Running817727
+Node: VMS POSIX819324
+Node: VMS Old Gawk820622
+Node: Bugs821094
+Node: Other Versions824959
+Node: Notes829484
+Node: Compatibility Mode830176
+Node: Additions830959
+Node: Accessing The Source831771
+Node: Adding Code833194
+Node: New Ports838742
+Node: Dynamic Extensions842855
+Node: Internals844231
+Node: Plugin License853350
+Node: Sample Library853984
+Node: Internal File Description854670
+Node: Internal File Ops858377
+Ref: Internal File Ops-Footnote-1863110
+Node: Using Internal File Ops863258
+Node: Future Extensions865635
+Node: Basic Concepts868140
+Node: Basic High Level868897
+Ref: Basic High Level-Footnote-1873016
+Node: Basic Data Typing873210
+Node: Floating Point Issues877647
+Node: String Conversion Precision878730
+Ref: String Conversion Precision-Footnote-1880424
+Node: Unexpected Results880533
+Node: POSIX Floating Point Problems882359
+Ref: POSIX Floating Point Problems-Footnote-1886058
+Node: Glossary886096
+Node: Copying909731
+Node: GNU Free Documentation License947288
+Node: next-edition972432
+Node: unresolved972784
+Node: revision973284
+Node: consistency973707
+Node: Index977206
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index afa6a7ed..44014f6d 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -1,19 +1,4 @@
 \input texinfo   @c -*-texinfo-*-
-@ignore
-TODO:
-	Document common extensions with COMMONEXT marking & index entry.
-DONE:
-	Globally add () after built in function names.
-	Globally add () after awk function names.
-	Check use of 3.2 vs. 4.0 everywhere.
-	DOS vs MS-DOS
-	MS-Windows vs MS Windows
-	Review use of "Modern xxx systems..."
-	Go through CAUTION, NOTE, @strong, @quotation, etc.
-	Fix refs to other info docs to use @inforef.
-	Pick a reasonable name for BWK awk and use it everywhere (search
-		for Bell Laboratories)
-@end ignore
 @c %**start of header (This is for running Texinfo on a region.)
 @setfilename gawk.info
 @settitle The GNU Awk User's Guide
@@ -650,6 +635,7 @@ particular records in a file and perform operations upon them.
 * POSIX/GNU::                      The extensions in @command{gawk} not in
                                    POSIX @command{awk}.
 * Contributors::                   The major contributors to @command{gawk}.
+* Common Extensions::              Common Extensions Summary.
 * Gawk Distribution::              What is in the @command{gawk} distribution.
 * Getting::                        How to get the distribution.
 * Extracting::                     How to extract the distribution.
@@ -3238,16 +3224,15 @@ call counts for each function.
 @cindex POSIX mode
 @cindex @command{gawk}, extensions@comma{} disabling
 Operate in strict POSIX mode.  This disables all @command{gawk}
-extensions (just like @option{--traditional}) and adds the following additional
-restrictions:
-
-@c IMPORTANT! Keep this list in sync with the one in node POSIX
+extensions (just like @option{--traditional}) and
+disables all extensions not allowed by POSIX.
+@xref{Common Extensions}, for a summary of the extensions
+in @command{gawk} that are disabled by this option.
+Also,
+the following additional
+restrictions apply:
 
 @itemize @bullet
-@cindex escape sequences, unrecognized
-@item
-@code{\x} escape sequences are not recognized
-(@pxref{Escape Sequences}).
 
 @cindex newlines
 @cindex whitespace, newlines as
@@ -3260,22 +3245,6 @@ equal to a single space
 Newlines are not allowed after @samp{?} or @samp{:}
 (@pxref{Conditional Exp}).
 
-@item
-The synonym @code{func} for the keyword @code{function} is not
-recognized (@pxref{Definition Syntax}).
-
-@cindex @code{*} (asterisk), @code{**} operator
-@cindex asterisk (@code{*}), @code{**} operator
-@cindex @code{*} (asterisk), @code{**=} operator
-@cindex asterisk (@code{*}), @code{**=} operator
-@cindex @code{^} (caret), @code{^} operator
-@cindex caret (@code{^}), @code{^} operator
-@cindex @code{^} (caret), @code{^=} operator
-@cindex caret (@code{^}), @code{^=} operator
-@item
-The @samp{**} and @samp{**=} operators cannot be used in
-place of @samp{^} and @samp{^=} (@pxref{Arithmetic Ops},
-and also @pxref{Assignment Ops}).
 
 @cindex @code{FS} variable, as TAB character
 @item
@@ -3288,11 +3257,6 @@ of @code{FS} to be a single TAB character
 @item
 The locale's decimal point character is used for parsing input
 data (@pxref{Locales}).
-
-@cindex @code{fflush()} function@comma{} unsupported
-@item
-The @code{fflush()} built-in function is not supported
-(@pxref{I/O Functions}).
 @end itemize
 
 @c @cindex automatic warnings
@@ -5367,10 +5331,12 @@ After the end of the record has been determined, @command{gawk}
 sets the variable @code{RT} to the text in the input that matched
 @code{RS}.
 
+@cindex common extensions, @code{RS} as a regexp
+@cindex extensions, common@comma{} @code{RS} as a regexp
 When using @command{gawk},
 the value of @code{RS} is not limited to a one-character
 string.  It can be any regular expression
-(@pxref{Regexp}).
+(@pxref{Regexp}). @value{COMMONEXT}
 In general, each record
 ends at the next string that matches the regular expression; the next
 record starts at the end of the matching string.  This general rule is
@@ -6030,12 +5996,15 @@ $ @kbd{echo 'xxAA  xxBxx  C' |}
 @node Single Character Fields
 @subsection Making Each Character a Separate Field
 
+@cindex common extensions, single character fields
+@cindex extensions, common@comma{} single character fields
 @cindex differences in @command{awk} and @command{gawk}, single-character fields
 @cindex single-character fields
 @cindex fields, single-character
 There are times when you may want to examine each character
 of a record separately.  This can be done in @command{gawk} by
-simply assigning the null string (@code{""}) to @code{FS}. In this case,
+simply assigning the null string (@code{""}) to @code{FS}. @value{COMMONEXT}
+In this case,
 each individual character in the record becomes a separate field.
 For example:
 
@@ -8349,12 +8318,19 @@ terminal at all.
 Then opening @file{/dev/tty} fails.
 
 @command{gawk} provides special @value{FN}s for accessing the three standard
-streams, as well as any other inherited open files.  If the @value{FN} matches
+streams. @value{COMMONEXT}. It also provides syntax for accessing
+any other inherited open files.  If the @value{FN} matches
 one of these special names when @command{gawk} redirects input or output,
 then it directly uses the stream that the @value{FN} stands for.
 These special @value{FN}s work for all operating systems that @command{gawk}
 has been ported to, not just those that are POSIX-compliant:
 
+@cindex common extensions, @file{/dev/stdin} special file
+@cindex common extensions, @file{/dev/stdout} special file
+@cindex common extensions, @file{/dev/stderr} special file
+@cindex extensions, common@comma{} @file{/dev/stdin} special file
+@cindex extensions, common@comma{} @file{/dev/stdout} special file
+@cindex extensions, common@comma{} @file{/dev/stderr} special file
 @cindex @value{FN}s, standard streams in @command{gawk}
 @cindex @code{/dev/@dots{}} special files (@command{gawk})
 @cindex files, @code{/dev/@dots{}} special files
@@ -12094,8 +12070,10 @@ first rule in the program.
 @cindex @code{nextfile} statement
 @cindex differences in @command{awk} and @command{gawk}, @code{next}/@code{nextfile} statements
 
+@cindex common extensions, @code{nextfile} statement
+@cindex extensions, common@comma{} @code{nextfile} statement
 @command{gawk} provides the @code{nextfile} statement,
-which is similar to the @code{next} statement.
+which is similar to the @code{next} statement. @value{COMMONEXT}
 However, instead of abandoning processing of the current record, the
 @code{nextfile} statement instructs @command{gawk} to stop processing the
 current @value{DF}.
@@ -13423,10 +13401,13 @@ If @option{--lint} is provided on the command line
 @command{gawk} issues a warning message when an element that
 is not in the array is deleted.
 
+@cindex common extensions, @code{delete} to delete entire arrays
+@cindex extensions, common@comma{} @code{delete} to delete entire arrays
 @cindex arrays, deleting entire contents
 @cindex deleting entire arrays
 @cindex differences in @command{awk} and @command{gawk}, array elements, deleting
 All the elements of an array may be deleted with a single statement
+@value{COMMONEXT}
 by leaving off the subscript in the @code{delete} statement,
 as follows:
 
@@ -14428,10 +14409,13 @@ If @option{--lint} has
 been specified on the command line, @command{gawk} issues a
 warning about this.
 
+@cindex common extensions, @code{length()} applied to an array
+@cindex extensions, common@comma{} @code{length()} applied to an array
 @cindex differences between @command{gawk} and @command{awk}
 With @command{gawk} and several other @command{awk} implementations, when supplied an
 array argument, the @code{length()} function returns the number of elements
-in the array.  This is less useful than it might seem at first, as the
+in the array. @value{COMMONEXT}
+This is less useful than it might seem at first, as the
 array is not guaranteed to be indexed from one to the number of elements
 in it.
 If @option{--lint} is provided on the command line
@@ -16324,12 +16308,15 @@ can even call this function, either directly or by way of another
 function.  When this happens, we say the function is @dfn{recursive}.
 The act of a function calling itself is called @dfn{recursion}.
 
+@cindex common extensions, @code{func} keyword
+@cindex extensions, common@comma{} @code{func} keyword
 @c @cindex @command{awk} language, POSIX version
 @c @cindex POSIX @command{awk}
 @cindex POSIX @command{awk}, @code{function} keyword in
 In many @command{awk} implementations, including @command{gawk},
 the keyword @code{function} may be
-abbreviated @code{func}.  However, POSIX only specifies the use of
+abbreviated @code{func}. @value{COMMONEXT}
+However, POSIX only specifies the use of
 the keyword @code{function}.  This actually has some practical implications.
 If @command{gawk} is in POSIX-compatibility mode
 (@pxref{Options}), then the following
@@ -25699,6 +25686,7 @@ of the @value{DOCUMENT} where you can find more information.
                                 version of @command{awk}.
 * POSIX/GNU::                   The extensions in @command{gawk} not in POSIX
                                 @command{awk}.
+* Common Extensions::           Common Extensions Summary.
 * Contributors::                The major contributors to @command{gawk}.
 @end menu
 
@@ -25887,65 +25875,8 @@ More complete documentation of many of the previously undocumented
 features of the language.
 @end itemize
 
-The following common extensions are not permitted by the POSIX
-standard:
-
-@c IMPORTANT! Keep this list in sync with the one in node Options
-
-@itemize @bullet
-@item
-@code{\x} escape sequences are not recognized
-(@pxref{Escape Sequences}).
-
-@item
-Newlines do not act as whitespace to separate fields when @code{FS} is
-equal to a single space
-(@pxref{Fields}).
-
-@item
-Newlines are not allowed after @samp{?} or @samp{:}
-(@pxref{Conditional Exp}).
-
-@item
-The synonym @code{func} for the keyword @code{function} is not
-recognized (@pxref{Definition Syntax}).
-
-@item
-The operators @samp{**} and @samp{**=} cannot be used in
-place of @samp{^} and @samp{^=} (@pxref{Arithmetic Ops},
-and @ref{Assignment Ops}).
-
-@item
-Specifying @samp{-Ft} on the command line does not set the value
-of @code{FS} to be a single TAB character
-(@pxref{Field Separators}).
-
-@item
-The locale's decimal point character is used for parsing input
-data (@pxref{Locales}).
-
-@item
-The @code{fflush()} built-in function is not supported
-(@pxref{I/O Functions}).
-
-@item
-The ability for @code{FS} and for the third
-argument to @code{split()} to be null strings
-(@pxref{Single Character Fields}).
-
-@item
-The @code{nextfile} statement
-(@pxref{Nextfile Statement}).
-
-@item
-The ability to delete all of an array at once with @samp{delete @var{array}}
-(@pxref{Delete}).
-
-@item
-The ability for the @code{length()} function to accept an array argument and
-return the number of elements in the array.
-(@pxref{String Functions}).
-@end itemize
+@xref{Common Extensions}, for a list of common extensions
+not permitted by the POSIX standard.
 
 The 2008 POSIX standard can be found online at
 @url{http://www.opengroup.org/onlinepubs/9699919799/}.
@@ -25959,17 +25890,14 @@ The 2008 POSIX standard can be found online at
 @cindex extensions, Brian Kernighan's @command{awk}
 @cindex Brian Kernighan's @command{awk}, extensions
 @cindex Kernighan, Brian
-Brian Kernighan, one of the original designers of Unix @command{awk},
+Brian Kernighan
 has made his version available via his home page
 (@pxref{Other Versions}).
-This @value{SECTION} describes extensions in his version of @command{awk} that are
-not in POSIX @command{awk}:
 
-@itemize @bullet
-@item
-The @code{fflush()} built-in function for flushing buffered output
-(@pxref{I/O Functions}).
+This @value{SECTION} describes common extensions that
+originally appeared in his version of @command{awk}.
 
+@itemize @bullet
 @item
 The @samp{**} and @samp{**=} operators
 (@pxref{Arithmetic Ops}
@@ -25980,6 +25908,10 @@ and
 The use of @code{func} as an abbreviation for @code{function}
 (@pxref{Definition Syntax}).
 
+@item
+The @code{fflush()} built-in function for flushing buffered output
+(@pxref{I/O Functions}).
+
 @ignore
 @item
 The @code{SYMTAB} array, that allows access to @command{awk}'s internal symbol
@@ -25989,37 +25921,8 @@ or array elements through it.
 @end ignore
 @end itemize
 
-Brian Kernighan's @command{awk} also incorporates the following extensions,
-originally developed for @command{gawk}:
-
-@itemize @bullet
-@item
-The @samp{\x} escape sequence
-(@pxref{Escape Sequences}).
-
-@item
-The @file{/dev/stdin}, @file{/dev/stdout}, and @file{/dev/stderr}
-special files
-(@pxref{Special Files}).
-
-@item
-The ability for @code{FS} and for the third
-argument to @code{split()} to be null strings
-(@pxref{Single Character Fields}).
-
-@item
-The @code{nextfile} statement
-(@pxref{Nextfile Statement}).
-
-@item
-The ability to delete all of an array at once with @samp{delete @var{array}}
-(@pxref{Delete}).
-
-@item
-The ability for the @code{length()} function to accept an array argument and
-return the number of elements in the array.
-(@pxref{String Functions}).
-@end itemize
+@xref{Common Extensions}, for a full list of the extensions
+available in his @command{awk}.
 
 @node POSIX/GNU
 @appendixsec Extensions in @command{gawk} Not in POSIX @command{awk}
@@ -26301,6 +26204,33 @@ Tandem (non-POSIX).
 @c ENDOFRANGE exgnot
 @c ENDOFRANGE posnot
 
+@node Common Extensions
+@appendixsec Common Extensions Summary
+
+This @value{SECTION} summarizes the common exceptions supported
+by @command{gawk}, Brian Kernighan's @command{awk}, and @command{mawk},
+the three most widely-used freely available versions of @command{awk}
+(@pxref{Other Versions}).
+
+@strong{FIXME:} Check all of these
+
+@multitable {@file{/dev/stderr} special file} {BWK Awk} {Mawk} {GNU Awk}
+@headitem Feature @tab BWK Awk @tab Mawk @tab GNU Awk
+@item @samp{\x} Escape sequence @tab X @tab X @tab X
+@item @code{RS} as regexp @tab @tab X @tab X
+@item @code{FS} as null string @tab X @tab X @tab X
+@item @file{/dev/stdin} special file @tab X @tab @tab X
+@item @file{/dev/stdout} special file @tab X @tab X @tab X
+@item @file{/dev/stderr} special file @tab X @tab X @tab X
+@item @code{**} and @code{**=} operators @tab X @tab X @tab X
+@item @code{func} keyword @tab X @tab X @tab X
+@item @code{nextfile} statement @tab X @tab X @tab X
+@item @code{delete} without subscript @tab X @tab X @tab X
+@item @code{length()} of an array @tab X @tab @tab X
+@item @code{fflush()} function @tab X @tab X @tab X
+@item @code{BINMODE} variable @tab @tab X @tab X
+@end multitable
+
 @node Contributors
 @appendixsec Major Contributors to @command{gawk}
 @cindex @command{gawk}, list of contributors to
@@ -26362,11 +26292,6 @@ making it compatible with ``new'' @command{awk}, and
 greatly improving its performance.
 
 @item
-@cindex Rankin, Pat
-Pat Rankin
-provided the VMS port and its documentation.
-
-@item
 @cindex Kwok, Conrad
 @cindex Garfinkle, Scott
 @cindex Williams, Kent
@@ -26377,6 +26302,11 @@ Kent Williams
 did the initial ports to MS-DOS with various versions of MSC.
 
 @item
+@cindex Rankin, Pat
+Pat Rankin
+provided the VMS port and its documentation.
+
+@item
 @cindex Peterson, Hal
 Hal Peterson
 provided help in porting @command{gawk} to Cray systems.
@@ -26436,6 +26366,7 @@ code and documentation, and motivated the inclusion of the @samp{|&} operator.
 @cindex Davies, Stephen
 Stephen Davies
 provided the initial port to Tandem systems and its documentation.
+(However, this is no longer supported.)
 He was also instrumental in the initial work to integrate the
 byte-code internals into the @command{gawk} code base.
 
@@ -26448,6 +26379,7 @@ provided improvements for Tandem's POSIX-compliant systems.
 @cindex Brown, Martin
 Martin Brown
 provided the port to BeOS and its documentation.
+(This is no longer supported.)
 
 @item
 @cindex Peters, Arno
@@ -27208,12 +27140,14 @@ or @command{cmd.exe} under MS-Windows or OS/2) may be useful for @command{awk} p
 The DJGPP collection of tools includes an MS-DOS port of Bash,
 and several shells are available for OS/2, including @command{ksh}.
 
+@cindex common extensions, @code{BINMODE} variable
+@cindex extensions, common@comma{} @code{BINMODE} variable
 @cindex differences in @command{awk} and @command{gawk}, @code{BINMODE} variable
 @cindex @code{BINMODE} variable
 Under MS-Windows, OS/2 and MS-DOS, @command{gawk} (and many other text programs) silently
 translate end-of-line @code{"\r\n"} to @code{"\n"} on input and @code{"\n"}
-to @code{"\r\n"} on output.  A special @code{BINMODE} variable allows
-control over these translations and is interpreted as follows:
+to @code{"\r\n"} on output.  A special @code{BINMODE} variable @value{COMMONEXT}
+allows control over these translations and is interpreted as follows:
 
 @itemize @bullet
 @item
@@ -27665,8 +27599,12 @@ This @value{SECTION} briefly describes where to get them:
 @table @asis
 @cindex Kernighan, Brian
 @cindex source code, Bell Laboratories @command{awk}
+@cindex @command{awk}, versions of, See Also Brian Kernighan's @command{awk}
+@cindex extensions, Brian Kernighan's @command{awk}
+@cindex Brian Kernighan's @command{awk}, extensions
 @item Unix @command{awk}
-Brian Kernighan has made his implementation of
+Brian Kernighan, one of the original designers of Unix @command{awk},
+has made his implementation of
 @command{awk} freely available.
 You can retrieve this version via the World Wide Web from
 @uref{http://www.cs.princeton.edu/~bwk, his home page}.
@@ -27688,7 +27626,7 @@ the C compiler from
 GCC (the GNU Compiler Collection)
 works quite nicely.
 
-@xref{BTL},
+@xref{Common Extensions},
 for a list of extensions in this @command{awk} that are not in POSIX @command{awk}.
 
 @cindex Brennan, Michael
@@ -27715,55 +27653,8 @@ Once you have it,
 is similar to @command{gawk}'s
 (@pxref{Unix Installation}).
 
-@cindex extensions, @command{mawk}
-@command{mawk} has the following extensions that are not in POSIX @command{awk}:
-
-@itemize @bullet
-@item
-The @code{fflush()} built-in function for flushing buffered output
-(@pxref{I/O Functions}).
-
-@item
-The @samp{**} and @samp{**=} operators
-(@pxref{Arithmetic Ops}
-and also see
-@ref{Assignment Ops}).
-
-@item
-The use of @code{func} as an abbreviation for @code{function}
-(@pxref{Definition Syntax}).
-
-@item
-The @samp{\x} escape sequence
-(@pxref{Escape Sequences}).
-
-@item
-The @file{/dev/stdout}, and @file{/dev/stderr}
-special files
-(@pxref{Special Files}).
-Use @code{"-"} instead of @code{"/dev/stdin"} with @command{mawk}.
-
-@item
-The ability for @code{FS} and for the third
-argument to @code{split()} to be null strings
-(@pxref{Single Character Fields}).
-
-@item
-The ability to delete all of an array at once with @samp{delete @var{array}}
-(@pxref{Delete}).
-
-@item
-The ability for @code{RS} to be a regexp
-(@pxref{Records}).
-
-@item
-The @code{BINMODE} special variable for non-Unix operating systems
-(@pxref{PC Using}).
-
-@item
-The @code{nextfile} statement
-(@pxref{Nextfile Statement}).
-@end itemize
+@xref{Common Extensions},
+for a list of extensions in @command{mawk} that are not in POSIX @command{awk}.
 
 @cindex Sumner, Andrew
 @cindex @command{awka} compiler for @command{awk}
@@ -31805,6 +31696,15 @@ Use numbered lists only to show a sequential series of steps.
 
 @item
 Use @@code@{xxx@} for the xxx operator in indexing statements, not @@samp.
+
+@item
+Use MS-Windows not MS Windows
+
+@item
+Use MS-DOS not MS-DOS
+
+@item
+Use an empty set of parentheses after built-in and awk function names.
 @end itemize
 
 @node Index
@@ -31897,6 +31797,9 @@ Consistency issues:
 	Use numbered lists only to show a sequential series of steps.
 
 	Use @code{xxx} for the xxx operator in indexing statements, not @samp.
+	Use MS-Windows not MS Windows
+	Use MS-DOS not MS-DOS
+	Use an empty set of parentheses after built-in and awk function names.
 
 Date: Wed, 13 Apr 94 15:20:52 -0400
 From: rms@gnu.org (Richard Stallman)
diff --git a/m4/ChangeLog b/m4/ChangeLog
index 26d81c7e..305c1cfd 100644
--- a/m4/ChangeLog
+++ b/m4/ChangeLog
@@ -1,3 +1,8 @@
+Wed Jan  5 20:36:10 2011  Arnold D. Robbins  <arnold@skeeve.com>
+
+	* readline.m4: Move call to AC_LANG([C]) from here to
+	../configure.ac.
+
 Tue Jan  4 11:09:43 2011  Arnold D. Robbins  <arnold@skeeve.com>
 
 	* readline.m4: Really fixed to work correctly with Autoconf 2.68.
diff --git a/m4/readline.m4 b/m4/readline.m4
index 9550d997..73bbf2a9 100644
--- a/m4/readline.m4
+++ b/m4/readline.m4
@@ -30,7 +30,6 @@ AC_DEFUN([GNUPG_CHECK_READLINE],
 
         AC_MSG_CHECKING([whether readline via \"$_combo\" is present and sane])
 
-	AC_LANG([C])
         AC_LINK_IFELSE([
 	AC_LANG_PROGRAM([
 #include <stdio.h>