gawk-diffs
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[gawk-diffs] [SCM] gawk branch, master, updated. abbe62c9521a1ab5c17dd11


From: Arnold Robbins
Subject: [gawk-diffs] [SCM] gawk branch, master, updated. abbe62c9521a1ab5c17dd118e521d06c899a1720
Date: Mon, 15 Apr 2013 20:08:29 +0000

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".

The branch, master has been updated
       via  abbe62c9521a1ab5c17dd118e521d06c899a1720 (commit)
      from  c2d221c3289504201c81795a970fa65c67d32517 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=abbe62c9521a1ab5c17dd118e521d06c899a1720

commit abbe62c9521a1ab5c17dd118e521d06c899a1720
Author: Arnold D. Robbins <address@hidden>
Date:   Mon Apr 15 23:07:57 2013 +0300

    Continuing doc cleanup.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index e2b2384..affa082 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2013-04-15         Arnold D. Robbins     <address@hidden>
+
+       * gawk.texi: Continue cleanup.
+
 2013-04-14         Arnold D. Robbins     <address@hidden>
 
        * gawk.texi: Add link to 'pawk' - awk for python.
diff --git a/doc/gawk.info b/doc/gawk.info
index 43e8f12..9271620 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -1268,34 +1268,12 @@ Wallin, and Eli Zaretskii (in alphabetical order) make 
up the current
 `gawk' would not be nearly the fine program it is today.  It has been
 and continues to be a pleasure working with this team of fine people.
 
-   Notable code and documentation contributions were made by the
-following people:
-
-   * John Haque made the followoing contributions:
-
-        - The modifications to convert `gawk' into a byte-code
-          interpreter, including the debugger.
-
-        - The additional modifications for support of arbitrary
-          precision arithmetic.
-
-        - The initial text of *note Arbitrary Precision Arithmetic::.
-
-        - The work to merge the three versions of `gawk' into one, for
-          the 4.1 release.
-
-   * Stephen Davies contributed to the effort to bring the byte-code
-     changes into the mainstream code base.
-
-   * Efraim Yawitz contributed the initial text of *note Debugger::.
-
-   * The development of the extension API first released with `gawk'
-     4.1 was driven primarily by Arnold Robbins and Andrew Schorr, with
-     notable contributions from the rest of the development team.
+   Notable code and documentation contributions were made by a number
+of people. *Note Contributors::, for the full list.
 
    I would like to thank Brian Kernighan for invaluable assistance
 during the testing and debugging of `gawk', and for ongoing help and
-advice in clarifying numerous points about the language.   We could not
+advice in clarifying numerous points about the language.  We could not
 have done nearly as good a job on either `gawk' or its documentation
 without his help.
 
@@ -20395,8 +20373,8 @@ attributes of computer arithmetic, along with how this 
can influence
 what you see when running `awk' programs.  This discussion applies to
 all versions of `awk'.
 
-   Then the major node moves on to "arbitrary precision arithmetic", a
-feature which is specific to `gawk'.
+   The major node then moves on to describe "arbitrary precision
+arithmetic", a feature which is specific to `gawk'.
 
 * Menu:
 
@@ -24423,11 +24401,11 @@ The `fork' extension adds three functions, as follows.
 
 File: gawk.info,  Node: Extension Sample Inplace,  Next: Extension Sample Ord, 
 Prev: Extension Sample Fork,  Up: Extension Samples
 
-16.6.4 Enabling in-place file editing.
---------------------------------------
+16.6.4 Enabling In-Place File Editing
+-------------------------------------
 
-The `inplace' extension emulates the `sed' `-i' option which performs
-"in placed" editing of each input file.  It uses the bundled
+The `inplace' extension emulates GNU `sed''s `-i' option which performs
+"in place" editing of each input file.  It uses the bundled
 `inplace.awk' include file to invoke the extension properly:
 
      # inplace --- load and invoke the inplace extension.
@@ -24466,7 +24444,7 @@ processing immediately without damaging the original 
file.
      > { print }' file1 file2 file3
 
    We leave it as an exercise to write a wrapper script that presents an
-interface similar to the `sed' `-i' option.
+interface similar to `sed -i'.
 
 
 File: gawk.info,  Node: Extension Sample Ord,  Next: Extension Sample Readdir, 
 Prev: Extension Sample Inplace,  Up: Extension Samples
@@ -24912,6 +24890,18 @@ introduced the following changes into the language:
    * More complete documentation of many of the previously undocumented
      features of the language.
 
+   In 2012, a number of extensions that had been commonly available for
+many years were finally added to POSIX. They are:
+
+   * The `fflush()' built-in function for flushing buffered output
+     (*note I/O Functions::).
+
+   * The `nextfile' statement (*note Nextfile Statement::).
+
+   * The ability to delete all of an array at once with `delete ARRAY'
+     (*note Delete::).
+
+
    *Note Common Extensions::, for a list of common extensions not
 permitted by the POSIX standard.
 
@@ -24937,8 +24927,7 @@ in his version of `awk'.
      Definition Syntax::).
 
    * The `fflush()' built-in function for flushing buffered output
-     (*note I/O Functions::).  As of December 2012, this function is
-     now standardized by POSIX.
+     (*note I/O Functions::).
 
 
    *Note Common Extensions::, for a full list of the extensions
@@ -25118,6 +25107,7 @@ Feature                      BWK Awk   Mawk   GNU Awk
 `/dev/stdout' special file   X         X      X
 `/dev/stderr' special file   X         X      X
 `**' and `**=' operators     X                X
+`fflush()' function          X         X      X
 `func' keyword               X                X
 `nextfile' statement         X         X      X
 `delete' without subscript   X         X      X
@@ -25334,11 +25324,25 @@ Info file, in approximate chronological order:
    * Patrick T.J. McPhee contributed the code for dynamic loading in
      Windows32 environments.  (This is no longer supported)
 
-   * John Haque reworked the `gawk' internals to use a byte-code engine,
-     providing the `gawk' debugger for `awk' programs.
+   * John Haque made the following contributions:
+
+        - The modifications to convert `gawk' into a byte-code
+          interpreter, including the debugger.
+
+        - The additional modifications for support of arbitrary
+          precision arithmetic.
+
+        - The initial text of *note Arbitrary Precision Arithmetic::.
+
+        - The work to merge the three versions of `gawk' into one, for
+          the 4.1 release.
 
    * Efraim Yawitz contributed the original text for *note Debugger::.
 
+   * The development of the extension API first released with `gawk'
+     4.1 was driven primarily by Arnold Robbins and Andrew Schorr, with
+     notable contributions from the rest of the development team.
+
    * Arnold Robbins has been working on `gawk' since 1988, at first
      helping David Trueman, and as the primary maintainer since around
      1994.
@@ -26398,6 +26402,12 @@ Libmawk
      This is an embeddable `awk' interpreter derived from `mawk'. For
      more information see `http://repo.hu/projects/libmawk/'.
 
+`pawk'
+     This is a Python module that claims to bring `awk'-like features
+     to Python. See `https://github.com/alecthomas/pawk' for more
+     information. (This is not related to Nelson Beebe's modified
+     version of Brian Kernighan's `awk', described earlier.)
+
 QSE Awk
      This is an embeddable `awk' interpreter. For more information see
      `http://code.google.com/p/qse/' and `http://awk.info/?tools/qse'.
@@ -26409,11 +26419,6 @@ QSE Awk
      `http://www.quiktrim.org/QTawk.html' for more information,
      including the manual and a download link.
 
-`pawk'
-     This is a Python module that claims to bring `awk'-like features
-     to Python. See `https://github.com/alecthomas/pawk' for more
-     information.
-
 
 
 File: gawk.info,  Node: Notes,  Next: Basic Concepts,  Prev: Installation,  
Up: Top
@@ -26511,15 +26516,10 @@ access the repository using:
 patch, and send that to the `gawk' maintainer; see *note Bugs::, for
 how to do that.
 
-   Finally, if you cannot install Git (e.g., if it hasn't been ported
-yet to your operating system), you can use the Git-CVS gateway to check
-out a copy using CVS, as follows:
-
-     cvs -d:pserver:address@hidden:/gawk.git co -d gawk master
-
-   Note that this gateway is flakey; you may have better luck using a
-more modern version control system like Bazaar, that has a Git plug-in
-for working with Git repositories.
+   Once upon a time there was Git-CVS gateway for use by people who
+could not install Git. However, this gateway no longer works, so you
+may have better luck using a more modern version control system like
+Bazaar, that has a Git plug-in for working with Git repositories.
 
 
 File: gawk.info,  Node: Adding Code,  Next: New Ports,  Prev: Accessing The 
Source,  Up: Additions
@@ -26596,7 +26596,7 @@ possible to include your changes:
           of `switch' statements, instead of just the plain pointer or
           character value.
 
-        * Use `true', `false' for `bool' values, the `NULL' symbolic
+        * Use `true' and `false' for `bool' values, the `NULL' symbolic
           constant for pointer values, and the character constant
           `'\0'' where appropriate, instead of `1' and `0'.
 
@@ -27148,16 +27148,15 @@ C.6 Compatibility For Old Extensions
 ====================================
 
 *note Dynamic Extensions::, describes the supported API and mechanisms
-for writing extensions for `gawk'.  This API was introduced in *FIXME:
-VERSION*.  However, for many years `gawk' provided an extension
-mechanism that required knowledge of `gawk' internals and that was not
-as well designed.
+for writing extensions for `gawk'.  This API was introduced in version
+4.1.  However, for many years `gawk' provided an extension mechanism
+that required knowledge of `gawk' internals and that was not as well
+designed.
 
-   In order to provide a transition period, `gawk' version *FIXME:
-VERSION* continues to support the original extension mechanism.  This
-will be true for the life of exactly one major release.  This support
-will be withdrawn, and removed from the source code, at the next major
-release.
+   In order to provide a transition period, `gawk' version 4.1
+continues to support the original extension mechanism.  This will be
+true for the life of exactly one major release.  This support will be
+withdrawn, and removed from the source code, at the next major release.
 
    Briefly, original-style extensions should be compiled by including
 the `awk.h' header file in the extension source code. Additionally, you
@@ -27838,9 +27837,9 @@ Pattern
      Overview::.)
 
 PEBKAC
-     A descriptive acronym for describing possibly the most frequent
-     source of computer usage problems. (Problem Exists Between
-     Keyboard And Chair.)
+     An acronym describing what is possibly the most frequent source of
+     computer usage problems. (Problem Exists Between Keyboard And
+     Chair.)
 
 POSIX
      The name for a series of standards that specify a Portable
@@ -30581,7 +30580,7 @@ Index
                                                               (line  47)
 * functions, user-defined, next/nextfile statements and: Next Statement.
                                                               (line  45)
-* G-d:                                   Acknowledgments.     (line 100)
+* G-d:                                   Acknowledgments.     (line  78)
 * Garfinkle, Scott:                      Contributors.        (line  35)
 * gawk program, dynamic profiling:       Profiling.           (line 171)
 * gawk, ARGIND variable in:              Other Arguments.     (line  12)
@@ -30755,8 +30754,7 @@ Index
                                                               (line  66)
 * Hankerson, Darrel <1>:                 Contributors.        (line  61)
 * Hankerson, Darrel:                     Acknowledgments.     (line  60)
-* Haque, John <1>:                       Contributors.        (line 103)
-* Haque, John:                           Acknowledgments.     (line  60)
+* Haque, John:                           Contributors.        (line 103)
 * Hartholz, Elaine:                      Acknowledgments.     (line  38)
 * Hartholz, Marshall:                    Acknowledgments.     (line  38)
 * Hasegawa, Isamu:                       Contributors.        (line  94)
@@ -30886,7 +30884,7 @@ Index
 * Kernighan, Brian <3>:                  Contributors.        (line  12)
 * Kernighan, Brian <4>:                  BTL.                 (line   6)
 * Kernighan, Brian <5>:                  Concatenation.       (line   6)
-* Kernighan, Brian <6>:                  Acknowledgments.     (line  94)
+* Kernighan, Brian <6>:                  Acknowledgments.     (line  72)
 * Kernighan, Brian <7>:                  Conventions.         (line  34)
 * Kernighan, Brian:                      History.             (line  17)
 * kill command, dynamic profiling:       Profiling.           (line 180)
@@ -31209,7 +31207,7 @@ Index
 * patterns, types of:                    Pattern Overview.    (line  15)
 * pawk (profiling version of Brian Kernighan's awk): Other Versions.
                                                               (line  78)
-* pawk, awk-like facilities for Python:  Other Versions.      (line 129)
+* pawk, awk-like facilities for Python:  Other Versions.      (line 118)
 * 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)
@@ -31391,12 +31389,12 @@ Index
 * pwcat program:                         Passwd Functions.    (line  23)
 * q debugger command (alias for quit):   Miscellaneous Debugger Commands.
                                                               (line  99)
-* QSE Awk:                               Other Versions.      (line 118)
+* QSE Awk:                               Other Versions.      (line 124)
 * question mark (?) regexp operator <1>: GNU Regexp Operators.
                                                               (line  59)
 * question mark (?) regexp operator:     Regexp Operators.    (line 111)
 * question mark (?), ?: operator:        Precedence.          (line  92)
-* QuikTrim Awk:                          Other Versions.      (line 122)
+* QuikTrim Awk:                          Other Versions.      (line 128)
 * quit debugger command:                 Miscellaneous Debugger Commands.
                                                               (line  99)
 * QUIT signal (MS-Windows):              Profiling.           (line 206)
@@ -31508,18 +31506,18 @@ Index
 * RLENGTH variable, match() function and: String Functions.   (line 223)
 * Robbins, Arnold <1>:                   Future Extensions.   (line   6)
 * Robbins, Arnold <2>:                   Bugs.                (line  32)
-* Robbins, Arnold <3>:                   Contributors.        (line 108)
+* Robbins, Arnold <3>:                   Contributors.        (line 122)
 * Robbins, Arnold <4>:                   Alarm Program.       (line   6)
 * Robbins, Arnold <5>:                   Passwd Functions.    (line  90)
 * Robbins, Arnold <6>:                   Getline/Pipe.        (line  40)
 * Robbins, Arnold:                       Command Line Field Separator.
                                                               (line  80)
 * Robbins, Bill:                         Getline/Pipe.        (line  40)
-* Robbins, Harry:                        Acknowledgments.     (line 100)
-* Robbins, Jean:                         Acknowledgments.     (line 100)
+* Robbins, Harry:                        Acknowledgments.     (line  78)
+* Robbins, Jean:                         Acknowledgments.     (line  78)
 * Robbins, Miriam <1>:                   Passwd Functions.    (line  90)
 * Robbins, Miriam <2>:                   Getline/Pipe.        (line  40)
-* Robbins, Miriam:                       Acknowledgments.     (line 100)
+* Robbins, Miriam:                       Acknowledgments.     (line  78)
 * Rommel, Kai Uwe:                       Contributors.        (line  43)
 * round() user-defined function:         Round Function.      (line  16)
 * rounding mode, floating-point:         Rounding Mode.       (line   6)
@@ -31548,6 +31546,7 @@ Index
                                                               (line  68)
 * sandbox mode:                          Options.             (line 279)
 * scalar values:                         Basic Data Typing.   (line  13)
+* Schorr, Andrew <1>:                    Contributors.        (line 118)
 * Schorr, Andrew:                        Acknowledgments.     (line  60)
 * Schreiber, Bert:                       Acknowledgments.     (line  38)
 * Schreiber, Rita:                       Acknowledgments.     (line  38)
@@ -31650,8 +31649,8 @@ Index
 * source code, mawk:                     Other Versions.      (line  44)
 * source code, mixing:                   Options.             (line 131)
 * source code, pawk:                     Other Versions.      (line  78)
-* source code, QSE Awk:                  Other Versions.      (line 118)
-* source code, QuikTrim Awk:             Other Versions.      (line 122)
+* source code, QSE Awk:                  Other Versions.      (line 124)
+* source code, QuikTrim Awk:             Other Versions.      (line 128)
 * source code, Solaris awk:              Other Versions.      (line  96)
 * source files, search path for:         Igawk Program.       (line 368)
 * sparse arrays:                         Array Intro.         (line  71)
@@ -31942,7 +31941,7 @@ Index
 * xgettext utility:                      String Extraction.   (line  13)
 * XOR bitwise operation:                 Bitwise Functions.   (line   6)
 * xor() function (gawk):                 Bitwise Functions.   (line  55)
-* Yawitz, Efraim:                        Contributors.        (line 106)
+* Yawitz, Efraim:                        Contributors.        (line 116)
 * Zaretskii, Eli <1>:                    Bugs.                (line  70)
 * Zaretskii, Eli <2>:                    Contributors.        (line  56)
 * Zaretskii, Eli:                        Acknowledgments.     (line  60)
@@ -31992,503 +31991,503 @@ Ref: Manual History-Footnote-163523
 Ref: Manual History-Footnote-263564
 Node: How To Contribute63638
 Node: Acknowledgments64782
-Node: Getting Started69776
-Node: Running gawk72155
-Node: One-shot73341
-Node: Read Terminal74566
-Ref: Read Terminal-Footnote-176216
-Ref: Read Terminal-Footnote-276492
-Node: Long76663
-Node: Executable Scripts78039
-Ref: Executable Scripts-Footnote-179908
-Ref: Executable Scripts-Footnote-280010
-Node: Comments80557
-Node: Quoting83024
-Node: DOS Quoting87647
-Node: Sample Data Files88322
-Node: Very Simple91354
-Node: Two Rules95953
-Node: More Complex98100
-Ref: More Complex-Footnote-1101030
-Node: Statements/Lines101115
-Ref: Statements/Lines-Footnote-1105577
-Node: Other Features105842
-Node: When106770
-Node: Invoking Gawk108917
-Node: Command Line110378
-Node: Options111161
-Ref: Options-Footnote-1126553
-Node: Other Arguments126578
-Node: Naming Standard Input129236
-Node: Environment Variables130330
-Node: AWKPATH Variable130888
-Ref: AWKPATH Variable-Footnote-1133646
-Node: AWKLIBPATH Variable133906
-Node: Other Environment Variables134624
-Node: Exit Status137119
-Node: Include Files137794
-Node: Loading Shared Libraries141363
-Node: Obsolete142727
-Node: Undocumented143424
-Node: Regexp143667
-Node: Regexp Usage145056
-Node: Escape Sequences147082
-Node: Regexp Operators152845
-Ref: Regexp Operators-Footnote-1160225
-Ref: Regexp Operators-Footnote-2160372
-Node: Bracket Expressions160470
-Ref: table-char-classes162360
-Node: GNU Regexp Operators164883
-Node: Case-sensitivity168606
-Ref: Case-sensitivity-Footnote-1171574
-Ref: Case-sensitivity-Footnote-2171809
-Node: Leftmost Longest171917
-Node: Computed Regexps173118
-Node: Reading Files176528
-Node: Records178531
-Ref: Records-Footnote-1187455
-Node: Fields187492
-Ref: Fields-Footnote-1190525
-Node: Nonconstant Fields190611
-Node: Changing Fields192813
-Node: Field Separators198794
-Node: Default Field Splitting201423
-Node: Regexp Field Splitting202540
-Node: Single Character Fields205882
-Node: Command Line Field Separator206941
-Node: Field Splitting Summary210382
-Ref: Field Splitting Summary-Footnote-1213574
-Node: Constant Size213675
-Node: Splitting By Content218259
-Ref: Splitting By Content-Footnote-1221985
-Node: Multiple Line222025
-Ref: Multiple Line-Footnote-1227872
-Node: Getline228051
-Node: Plain Getline230267
-Node: Getline/Variable232356
-Node: Getline/File233497
-Node: Getline/Variable/File234819
-Ref: Getline/Variable/File-Footnote-1236418
-Node: Getline/Pipe236505
-Node: Getline/Variable/Pipe239191
-Node: Getline/Coprocess240298
-Node: Getline/Variable/Coprocess241541
-Node: Getline Notes242255
-Node: Getline Summary245042
-Ref: table-getline-variants245450
-Node: Read Timeout246308
-Ref: Read Timeout-Footnote-1250049
-Node: Command line directories250106
-Node: Printing250736
-Node: Print252367
-Node: Print Examples253704
-Node: Output Separators256488
-Node: OFMT258248
-Node: Printf259606
-Node: Basic Printf260512
-Node: Control Letters262051
-Node: Format Modifiers265863
-Node: Printf Examples271872
-Node: Redirection274587
-Node: Special Files281571
-Node: Special FD282104
-Ref: Special FD-Footnote-1285729
-Node: Special Network285803
-Node: Special Caveats286653
-Node: Close Files And Pipes287449
-Ref: Close Files And Pipes-Footnote-1294472
-Ref: Close Files And Pipes-Footnote-2294620
-Node: Expressions294770
-Node: Values295902
-Node: Constants296578
-Node: Scalar Constants297258
-Ref: Scalar Constants-Footnote-1298117
-Node: Nondecimal-numbers298299
-Node: Regexp Constants301358
-Node: Using Constant Regexps301833
-Node: Variables304888
-Node: Using Variables305543
-Node: Assignment Options307267
-Node: Conversion309139
-Ref: table-locale-affects314630
-Ref: Conversion-Footnote-1315254
-Node: All Operators315363
-Node: Arithmetic Ops315993
-Node: Concatenation318498
-Ref: Concatenation-Footnote-1321291
-Node: Assignment Ops321411
-Ref: table-assign-ops326399
-Node: Increment Ops327812
-Node: Truth Values and Conditions331282
-Node: Truth Values332365
-Node: Typing and Comparison333414
-Node: Variable Typing334203
-Ref: Variable Typing-Footnote-1338100
-Node: Comparison Operators338222
-Ref: table-relational-ops338632
-Node: POSIX String Comparison342181
-Ref: POSIX String Comparison-Footnote-1343137
-Node: Boolean Ops343275
-Ref: Boolean Ops-Footnote-1347353
-Node: Conditional Exp347444
-Node: Function Calls349176
-Node: Precedence352770
-Node: Locales356439
-Node: Patterns and Actions357528
-Node: Pattern Overview358582
-Node: Regexp Patterns360251
-Node: Expression Patterns360794
-Node: Ranges364479
-Node: BEGIN/END367445
-Node: Using BEGIN/END368207
-Ref: Using BEGIN/END-Footnote-1370938
-Node: I/O And BEGIN/END371044
-Node: BEGINFILE/ENDFILE373326
-Node: Empty376230
-Node: Using Shell Variables376546
-Node: Action Overview378831
-Node: Statements381188
-Node: If Statement383042
-Node: While Statement384541
-Node: Do Statement386585
-Node: For Statement387741
-Node: Switch Statement390893
-Node: Break Statement392990
-Node: Continue Statement394980
-Node: Next Statement396773
-Node: Nextfile Statement399163
-Node: Exit Statement401806
-Node: Built-in Variables404222
-Node: User-modified405317
-Ref: User-modified-Footnote-1413672
-Node: Auto-set413734
-Ref: Auto-set-Footnote-1426314
-Ref: Auto-set-Footnote-2426519
-Node: ARGC and ARGV426575
-Node: Arrays430426
-Node: Array Basics431931
-Node: Array Intro432757
-Node: Reference to Elements437075
-Node: Assigning Elements439345
-Node: Array Example439836
-Node: Scanning an Array441568
-Node: Controlling Scanning443882
-Ref: Controlling Scanning-Footnote-1448805
-Node: Delete449121
-Ref: Delete-Footnote-1451886
-Node: Numeric Array Subscripts451943
-Node: Uninitialized Subscripts454126
-Node: Multi-dimensional455754
-Node: Multi-scanning458848
-Node: Arrays of Arrays460439
-Node: Functions465080
-Node: Built-in465899
-Node: Calling Built-in466977
-Node: Numeric Functions468965
-Ref: Numeric Functions-Footnote-1472797
-Ref: Numeric Functions-Footnote-2473154
-Ref: Numeric Functions-Footnote-3473202
-Node: String Functions473471
-Ref: String Functions-Footnote-1496968
-Ref: String Functions-Footnote-2497097
-Ref: String Functions-Footnote-3497345
-Node: Gory Details497432
-Ref: table-sub-escapes499111
-Ref: table-sub-posix-92500465
-Ref: table-sub-proposed501816
-Ref: table-posix-sub503170
-Ref: table-gensub-escapes504715
-Ref: Gory Details-Footnote-1505922
-Ref: Gory Details-Footnote-2505973
-Node: I/O Functions506124
-Ref: I/O Functions-Footnote-1513229
-Node: Time Functions513376
-Ref: Time Functions-Footnote-1524309
-Ref: Time Functions-Footnote-2524377
-Ref: Time Functions-Footnote-3524535
-Ref: Time Functions-Footnote-4524646
-Ref: Time Functions-Footnote-5524758
-Ref: Time Functions-Footnote-6524985
-Node: Bitwise Functions525251
-Ref: table-bitwise-ops525809
-Ref: Bitwise Functions-Footnote-1530030
-Node: Type Functions530214
-Node: I18N Functions530684
-Node: User-defined532311
-Node: Definition Syntax533115
-Ref: Definition Syntax-Footnote-1538025
-Node: Function Example538094
-Node: Function Caveats540688
-Node: Calling A Function541109
-Node: Variable Scope542224
-Node: Pass By Value/Reference545187
-Node: Return Statement548695
-Node: Dynamic Typing551676
-Node: Indirect Calls552607
-Node: Library Functions562292
-Ref: Library Functions-Footnote-1565805
-Ref: Library Functions-Footnote-2565948
-Node: Library Names566119
-Ref: Library Names-Footnote-1569590
-Ref: Library Names-Footnote-2569810
-Node: General Functions569896
-Node: Strtonum Function570849
-Node: Assert Function573779
-Node: Round Function577105
-Node: Cliff Random Function578648
-Node: Ordinal Functions579664
-Ref: Ordinal Functions-Footnote-1582734
-Ref: Ordinal Functions-Footnote-2582986
-Node: Join Function583195
-Ref: Join Function-Footnote-1584966
-Node: Getlocaltime Function585166
-Node: Data File Management588881
-Node: Filetrans Function589513
-Node: Rewind Function593652
-Node: File Checking595039
-Node: Empty Files596133
-Node: Ignoring Assigns598363
-Node: Getopt Function599916
-Ref: Getopt Function-Footnote-1611220
-Node: Passwd Functions611423
-Ref: Passwd Functions-Footnote-1620398
-Node: Group Functions620486
-Node: Walking Arrays628570
-Node: Sample Programs630707
-Node: Running Examples631384
-Node: Clones632112
-Node: Cut Program633336
-Node: Egrep Program643181
-Ref: Egrep Program-Footnote-1650954
-Node: Id Program651064
-Node: Split Program654680
-Ref: Split Program-Footnote-1658199
-Node: Tee Program658327
-Node: Uniq Program661130
-Node: Wc Program668559
-Ref: Wc Program-Footnote-1672825
-Ref: Wc Program-Footnote-2673025
-Node: Miscellaneous Programs673117
-Node: Dupword Program674305
-Node: Alarm Program676336
-Node: Translate Program681085
-Ref: Translate Program-Footnote-1685472
-Ref: Translate Program-Footnote-2685700
-Node: Labels Program685834
-Ref: Labels Program-Footnote-1689205
-Node: Word Sorting689289
-Node: History Sorting693173
-Node: Extract Program695012
-Ref: Extract Program-Footnote-1702513
-Node: Simple Sed702641
-Node: Igawk Program705703
-Ref: Igawk Program-Footnote-1720860
-Ref: Igawk Program-Footnote-2721061
-Node: Anagram Program721199
-Node: Signature Program724267
-Node: Internationalization725367
-Node: I18N and L10N726799
-Node: Explaining gettext727485
-Ref: Explaining gettext-Footnote-1732551
-Ref: Explaining gettext-Footnote-2732735
-Node: Programmer i18n732900
-Node: Translator i18n737100
-Node: String Extraction737893
-Ref: String Extraction-Footnote-1738854
-Node: Printf Ordering738940
-Ref: Printf Ordering-Footnote-1741724
-Node: I18N Portability741788
-Ref: I18N Portability-Footnote-1744237
-Node: I18N Example744300
-Ref: I18N Example-Footnote-1746935
-Node: Gawk I18N747007
-Node: Advanced Features747628
-Node: Nondecimal Data749503
-Node: Array Sorting751086
-Node: Controlling Array Traversal751783
-Node: Array Sorting Functions760021
-Ref: Array Sorting Functions-Footnote-1763695
-Ref: Array Sorting Functions-Footnote-2763788
-Node: Two-way I/O763982
-Ref: Two-way I/O-Footnote-1769414
-Node: TCP/IP Networking769484
-Node: Profiling772328
-Node: Debugger779783
-Node: Debugging780751
-Node: Debugging Concepts781184
-Node: Debugging Terms783040
-Node: Awk Debugging785637
-Node: Sample Debugging Session786529
-Node: Debugger Invocation787049
-Node: Finding The Bug788381
-Node: List of Debugger Commands794869
-Node: Breakpoint Control796203
-Node: Debugger Execution Control799867
-Node: Viewing And Changing Data803227
-Node: Execution Stack806583
-Node: Debugger Info808050
-Node: Miscellaneous Debugger Commands812032
-Node: Readline Support817208
-Node: Limitations818039
-Node: Arbitrary Precision Arithmetic820291
-Ref: Arbitrary Precision Arithmetic-Footnote-1821933
-Node: General Arithmetic822081
-Node: Floating Point Issues823801
-Node: String Conversion Precision824682
-Ref: String Conversion Precision-Footnote-1826388
-Node: Unexpected Results826497
-Node: POSIX Floating Point Problems828650
-Ref: POSIX Floating Point Problems-Footnote-1832475
-Node: Integer Programming832513
-Node: Floating-point Programming834266
-Ref: Floating-point Programming-Footnote-1840575
-Node: Floating-point Representation840839
-Node: Floating-point Context842004
-Ref: table-ieee-formats842846
-Node: Rounding Mode844230
-Ref: table-rounding-modes844709
-Ref: Rounding Mode-Footnote-1847713
-Node: Gawk and MPFR847894
-Node: Arbitrary Precision Floats849136
-Ref: Arbitrary Precision Floats-Footnote-1851565
-Node: Setting Precision851876
-Node: Setting Rounding Mode854609
-Ref: table-gawk-rounding-modes855013
-Node: Floating-point Constants856193
-Node: Changing Precision857617
-Ref: Changing Precision-Footnote-1859017
-Node: Exact Arithmetic859191
-Node: Arbitrary Precision Integers862299
-Ref: Arbitrary Precision Integers-Footnote-1865299
-Node: Dynamic Extensions865446
-Node: Extension Intro866823
-Node: Plugin License868031
-Node: Extension Mechanism Outline868716
-Ref: load-extension869133
-Ref: load-new-function870611
-Ref: call-new-function871606
-Node: Extension API Description873614
-Node: Extension API Functions Introduction874953
-Node: General Data Types879731
-Ref: General Data Types-Footnote-1885333
-Node: Requesting Values885632
-Ref: table-value-types-returned886363
-Node: Constructor Functions887317
-Node: Registration Functions890313
-Node: Extension Functions890998
-Node: Exit Callback Functions893172
-Node: Extension Version String894415
-Node: Input Parsers895065
-Node: Output Wrappers904782
-Node: Two-way processors909198
-Node: Printing Messages911328
-Ref: Printing Messages-Footnote-1912405
-Node: Updating `ERRNO'912557
-Node: Accessing Parameters913296
-Node: Symbol Table Access914526
-Node: Symbol table by name915038
-Node: Symbol table by cookie916611
-Ref: Symbol table by cookie-Footnote-1920740
-Node: Cached values920803
-Ref: Cached values-Footnote-1924246
-Node: Array Manipulation924337
-Ref: Array Manipulation-Footnote-1925435
-Node: Array Data Types925474
-Ref: Array Data Types-Footnote-1928177
-Node: Array Functions928269
-Node: Flattening Arrays932035
-Node: Creating Arrays938874
-Node: Extension API Variables943669
-Node: Extension Versioning944305
-Node: Extension API Informational Variables946206
-Node: Extension API Boilerplate947292
-Node: Finding Extensions951123
-Node: Extension Example951670
-Node: Internal File Description952408
-Node: Internal File Ops956096
-Ref: Internal File Ops-Footnote-1967543
-Node: Using Internal File Ops967683
-Ref: Using Internal File Ops-Footnote-1970036
-Node: Extension Samples970302
-Node: Extension Sample File Functions971826
-Node: Extension Sample Fnmatch980299
-Node: Extension Sample Fork982025
-Node: Extension Sample Inplace983243
-Node: Extension Sample Ord985035
-Node: Extension Sample Readdir985814
-Node: Extension Sample Revout987318
-Node: Extension Sample Rev2way987911
-Node: Extension Sample Read write array988601
-Node: Extension Sample Readfile990484
-Node: Extension Sample API Tests991241
-Node: Extension Sample Time991766
-Node: gawkextlib993073
-Node: Language History995454
-Node: V7/SVR3.1996976
-Node: SVR4999297
-Node: POSIX1000739
-Node: BTL1001747
-Node: POSIX/GNU1002552
-Node: Common Extensions1008087
-Node: Ranges and Locales1009194
-Ref: Ranges and Locales-Footnote-11013812
-Ref: Ranges and Locales-Footnote-21013839
-Ref: Ranges and Locales-Footnote-31014099
-Node: Contributors1014320
-Node: Installation1018616
-Node: Gawk Distribution1019510
-Node: Getting1019994
-Node: Extracting1020820
-Node: Distribution contents1022512
-Node: Unix Installation1027773
-Node: Quick Installation1028390
-Node: Additional Configuration Options1030352
-Node: Configuration Philosophy1031829
-Node: Non-Unix Installation1034171
-Node: PC Installation1034629
-Node: PC Binary Installation1035928
-Node: PC Compiling1037776
-Node: PC Testing1040720
-Node: PC Using1041896
-Node: Cygwin1046081
-Node: MSYS1047081
-Node: VMS Installation1047595
-Node: VMS Compilation1048198
-Ref: VMS Compilation-Footnote-11049205
-Node: VMS Installation Details1049263
-Node: VMS Running1050898
-Node: VMS Old Gawk1052505
-Node: Bugs1052979
-Node: Other Versions1056831
-Node: Notes1062323
-Node: Compatibility Mode1063123
-Node: Additions1063906
-Node: Accessing The Source1064833
-Node: Adding Code1066436
-Node: New Ports1072478
-Node: Derived Files1076613
-Ref: Derived Files-Footnote-11081934
-Ref: Derived Files-Footnote-21081968
-Ref: Derived Files-Footnote-31082568
-Node: Future Extensions1082666
-Node: Implementation Limitations1083247
-Node: Extension Design1084499
-Node: Old Extension Problems1085648
-Ref: Old Extension Problems-Footnote-11087156
-Node: Extension New Mechanism Goals1087213
-Ref: Extension New Mechanism Goals-Footnote-11090572
-Node: Extension Other Design Decisions1090758
-Node: Extension Future Growth1092864
-Node: Old Extension Mechansim1093685
-Node: Basic Concepts1095442
-Node: Basic High Level1096123
-Ref: figure-general-flow1096394
-Ref: figure-process-flow1096993
-Ref: Basic High Level-Footnote-11100222
-Node: Basic Data Typing1100407
-Node: Glossary1103762
-Node: Copying1129240
-Node: GNU Free Documentation License1166797
-Node: Index1191934
+Node: Getting Started68992
+Node: Running gawk71371
+Node: One-shot72557
+Node: Read Terminal73782
+Ref: Read Terminal-Footnote-175432
+Ref: Read Terminal-Footnote-275708
+Node: Long75879
+Node: Executable Scripts77255
+Ref: Executable Scripts-Footnote-179124
+Ref: Executable Scripts-Footnote-279226
+Node: Comments79773
+Node: Quoting82240
+Node: DOS Quoting86863
+Node: Sample Data Files87538
+Node: Very Simple90570
+Node: Two Rules95169
+Node: More Complex97316
+Ref: More Complex-Footnote-1100246
+Node: Statements/Lines100331
+Ref: Statements/Lines-Footnote-1104793
+Node: Other Features105058
+Node: When105986
+Node: Invoking Gawk108133
+Node: Command Line109594
+Node: Options110377
+Ref: Options-Footnote-1125769
+Node: Other Arguments125794
+Node: Naming Standard Input128452
+Node: Environment Variables129546
+Node: AWKPATH Variable130104
+Ref: AWKPATH Variable-Footnote-1132862
+Node: AWKLIBPATH Variable133122
+Node: Other Environment Variables133840
+Node: Exit Status136335
+Node: Include Files137010
+Node: Loading Shared Libraries140579
+Node: Obsolete141943
+Node: Undocumented142640
+Node: Regexp142883
+Node: Regexp Usage144272
+Node: Escape Sequences146298
+Node: Regexp Operators152061
+Ref: Regexp Operators-Footnote-1159441
+Ref: Regexp Operators-Footnote-2159588
+Node: Bracket Expressions159686
+Ref: table-char-classes161576
+Node: GNU Regexp Operators164099
+Node: Case-sensitivity167822
+Ref: Case-sensitivity-Footnote-1170790
+Ref: Case-sensitivity-Footnote-2171025
+Node: Leftmost Longest171133
+Node: Computed Regexps172334
+Node: Reading Files175744
+Node: Records177747
+Ref: Records-Footnote-1186671
+Node: Fields186708
+Ref: Fields-Footnote-1189741
+Node: Nonconstant Fields189827
+Node: Changing Fields192029
+Node: Field Separators198010
+Node: Default Field Splitting200639
+Node: Regexp Field Splitting201756
+Node: Single Character Fields205098
+Node: Command Line Field Separator206157
+Node: Field Splitting Summary209598
+Ref: Field Splitting Summary-Footnote-1212790
+Node: Constant Size212891
+Node: Splitting By Content217475
+Ref: Splitting By Content-Footnote-1221201
+Node: Multiple Line221241
+Ref: Multiple Line-Footnote-1227088
+Node: Getline227267
+Node: Plain Getline229483
+Node: Getline/Variable231572
+Node: Getline/File232713
+Node: Getline/Variable/File234035
+Ref: Getline/Variable/File-Footnote-1235634
+Node: Getline/Pipe235721
+Node: Getline/Variable/Pipe238407
+Node: Getline/Coprocess239514
+Node: Getline/Variable/Coprocess240757
+Node: Getline Notes241471
+Node: Getline Summary244258
+Ref: table-getline-variants244666
+Node: Read Timeout245524
+Ref: Read Timeout-Footnote-1249265
+Node: Command line directories249322
+Node: Printing249952
+Node: Print251583
+Node: Print Examples252920
+Node: Output Separators255704
+Node: OFMT257464
+Node: Printf258822
+Node: Basic Printf259728
+Node: Control Letters261267
+Node: Format Modifiers265079
+Node: Printf Examples271088
+Node: Redirection273803
+Node: Special Files280787
+Node: Special FD281320
+Ref: Special FD-Footnote-1284945
+Node: Special Network285019
+Node: Special Caveats285869
+Node: Close Files And Pipes286665
+Ref: Close Files And Pipes-Footnote-1293688
+Ref: Close Files And Pipes-Footnote-2293836
+Node: Expressions293986
+Node: Values295118
+Node: Constants295794
+Node: Scalar Constants296474
+Ref: Scalar Constants-Footnote-1297333
+Node: Nondecimal-numbers297515
+Node: Regexp Constants300574
+Node: Using Constant Regexps301049
+Node: Variables304104
+Node: Using Variables304759
+Node: Assignment Options306483
+Node: Conversion308355
+Ref: table-locale-affects313846
+Ref: Conversion-Footnote-1314470
+Node: All Operators314579
+Node: Arithmetic Ops315209
+Node: Concatenation317714
+Ref: Concatenation-Footnote-1320507
+Node: Assignment Ops320627
+Ref: table-assign-ops325615
+Node: Increment Ops327028
+Node: Truth Values and Conditions330498
+Node: Truth Values331581
+Node: Typing and Comparison332630
+Node: Variable Typing333419
+Ref: Variable Typing-Footnote-1337316
+Node: Comparison Operators337438
+Ref: table-relational-ops337848
+Node: POSIX String Comparison341397
+Ref: POSIX String Comparison-Footnote-1342353
+Node: Boolean Ops342491
+Ref: Boolean Ops-Footnote-1346569
+Node: Conditional Exp346660
+Node: Function Calls348392
+Node: Precedence351986
+Node: Locales355655
+Node: Patterns and Actions356744
+Node: Pattern Overview357798
+Node: Regexp Patterns359467
+Node: Expression Patterns360010
+Node: Ranges363695
+Node: BEGIN/END366661
+Node: Using BEGIN/END367423
+Ref: Using BEGIN/END-Footnote-1370154
+Node: I/O And BEGIN/END370260
+Node: BEGINFILE/ENDFILE372542
+Node: Empty375446
+Node: Using Shell Variables375762
+Node: Action Overview378047
+Node: Statements380404
+Node: If Statement382258
+Node: While Statement383757
+Node: Do Statement385801
+Node: For Statement386957
+Node: Switch Statement390109
+Node: Break Statement392206
+Node: Continue Statement394196
+Node: Next Statement395989
+Node: Nextfile Statement398379
+Node: Exit Statement401022
+Node: Built-in Variables403438
+Node: User-modified404533
+Ref: User-modified-Footnote-1412888
+Node: Auto-set412950
+Ref: Auto-set-Footnote-1425530
+Ref: Auto-set-Footnote-2425735
+Node: ARGC and ARGV425791
+Node: Arrays429642
+Node: Array Basics431147
+Node: Array Intro431973
+Node: Reference to Elements436291
+Node: Assigning Elements438561
+Node: Array Example439052
+Node: Scanning an Array440784
+Node: Controlling Scanning443098
+Ref: Controlling Scanning-Footnote-1448021
+Node: Delete448337
+Ref: Delete-Footnote-1451102
+Node: Numeric Array Subscripts451159
+Node: Uninitialized Subscripts453342
+Node: Multi-dimensional454970
+Node: Multi-scanning458064
+Node: Arrays of Arrays459655
+Node: Functions464296
+Node: Built-in465115
+Node: Calling Built-in466193
+Node: Numeric Functions468181
+Ref: Numeric Functions-Footnote-1472013
+Ref: Numeric Functions-Footnote-2472370
+Ref: Numeric Functions-Footnote-3472418
+Node: String Functions472687
+Ref: String Functions-Footnote-1496184
+Ref: String Functions-Footnote-2496313
+Ref: String Functions-Footnote-3496561
+Node: Gory Details496648
+Ref: table-sub-escapes498327
+Ref: table-sub-posix-92499681
+Ref: table-sub-proposed501032
+Ref: table-posix-sub502386
+Ref: table-gensub-escapes503931
+Ref: Gory Details-Footnote-1505138
+Ref: Gory Details-Footnote-2505189
+Node: I/O Functions505340
+Ref: I/O Functions-Footnote-1512445
+Node: Time Functions512592
+Ref: Time Functions-Footnote-1523525
+Ref: Time Functions-Footnote-2523593
+Ref: Time Functions-Footnote-3523751
+Ref: Time Functions-Footnote-4523862
+Ref: Time Functions-Footnote-5523974
+Ref: Time Functions-Footnote-6524201
+Node: Bitwise Functions524467
+Ref: table-bitwise-ops525025
+Ref: Bitwise Functions-Footnote-1529246
+Node: Type Functions529430
+Node: I18N Functions529900
+Node: User-defined531527
+Node: Definition Syntax532331
+Ref: Definition Syntax-Footnote-1537241
+Node: Function Example537310
+Node: Function Caveats539904
+Node: Calling A Function540325
+Node: Variable Scope541440
+Node: Pass By Value/Reference544403
+Node: Return Statement547911
+Node: Dynamic Typing550892
+Node: Indirect Calls551823
+Node: Library Functions561508
+Ref: Library Functions-Footnote-1565021
+Ref: Library Functions-Footnote-2565164
+Node: Library Names565335
+Ref: Library Names-Footnote-1568806
+Ref: Library Names-Footnote-2569026
+Node: General Functions569112
+Node: Strtonum Function570065
+Node: Assert Function572995
+Node: Round Function576321
+Node: Cliff Random Function577864
+Node: Ordinal Functions578880
+Ref: Ordinal Functions-Footnote-1581950
+Ref: Ordinal Functions-Footnote-2582202
+Node: Join Function582411
+Ref: Join Function-Footnote-1584182
+Node: Getlocaltime Function584382
+Node: Data File Management588097
+Node: Filetrans Function588729
+Node: Rewind Function592868
+Node: File Checking594255
+Node: Empty Files595349
+Node: Ignoring Assigns597579
+Node: Getopt Function599132
+Ref: Getopt Function-Footnote-1610436
+Node: Passwd Functions610639
+Ref: Passwd Functions-Footnote-1619614
+Node: Group Functions619702
+Node: Walking Arrays627786
+Node: Sample Programs629923
+Node: Running Examples630600
+Node: Clones631328
+Node: Cut Program632552
+Node: Egrep Program642397
+Ref: Egrep Program-Footnote-1650170
+Node: Id Program650280
+Node: Split Program653896
+Ref: Split Program-Footnote-1657415
+Node: Tee Program657543
+Node: Uniq Program660346
+Node: Wc Program667775
+Ref: Wc Program-Footnote-1672041
+Ref: Wc Program-Footnote-2672241
+Node: Miscellaneous Programs672333
+Node: Dupword Program673521
+Node: Alarm Program675552
+Node: Translate Program680301
+Ref: Translate Program-Footnote-1684688
+Ref: Translate Program-Footnote-2684916
+Node: Labels Program685050
+Ref: Labels Program-Footnote-1688421
+Node: Word Sorting688505
+Node: History Sorting692389
+Node: Extract Program694228
+Ref: Extract Program-Footnote-1701729
+Node: Simple Sed701857
+Node: Igawk Program704919
+Ref: Igawk Program-Footnote-1720076
+Ref: Igawk Program-Footnote-2720277
+Node: Anagram Program720415
+Node: Signature Program723483
+Node: Internationalization724583
+Node: I18N and L10N726015
+Node: Explaining gettext726701
+Ref: Explaining gettext-Footnote-1731767
+Ref: Explaining gettext-Footnote-2731951
+Node: Programmer i18n732116
+Node: Translator i18n736316
+Node: String Extraction737109
+Ref: String Extraction-Footnote-1738070
+Node: Printf Ordering738156
+Ref: Printf Ordering-Footnote-1740940
+Node: I18N Portability741004
+Ref: I18N Portability-Footnote-1743453
+Node: I18N Example743516
+Ref: I18N Example-Footnote-1746151
+Node: Gawk I18N746223
+Node: Advanced Features746844
+Node: Nondecimal Data748719
+Node: Array Sorting750302
+Node: Controlling Array Traversal750999
+Node: Array Sorting Functions759237
+Ref: Array Sorting Functions-Footnote-1762911
+Ref: Array Sorting Functions-Footnote-2763004
+Node: Two-way I/O763198
+Ref: Two-way I/O-Footnote-1768630
+Node: TCP/IP Networking768700
+Node: Profiling771544
+Node: Debugger778999
+Node: Debugging779967
+Node: Debugging Concepts780400
+Node: Debugging Terms782256
+Node: Awk Debugging784853
+Node: Sample Debugging Session785745
+Node: Debugger Invocation786265
+Node: Finding The Bug787597
+Node: List of Debugger Commands794085
+Node: Breakpoint Control795419
+Node: Debugger Execution Control799083
+Node: Viewing And Changing Data802443
+Node: Execution Stack805799
+Node: Debugger Info807266
+Node: Miscellaneous Debugger Commands811248
+Node: Readline Support816424
+Node: Limitations817255
+Node: Arbitrary Precision Arithmetic819507
+Ref: Arbitrary Precision Arithmetic-Footnote-1821158
+Node: General Arithmetic821306
+Node: Floating Point Issues823026
+Node: String Conversion Precision823907
+Ref: String Conversion Precision-Footnote-1825613
+Node: Unexpected Results825722
+Node: POSIX Floating Point Problems827875
+Ref: POSIX Floating Point Problems-Footnote-1831700
+Node: Integer Programming831738
+Node: Floating-point Programming833491
+Ref: Floating-point Programming-Footnote-1839800
+Node: Floating-point Representation840064
+Node: Floating-point Context841229
+Ref: table-ieee-formats842071
+Node: Rounding Mode843455
+Ref: table-rounding-modes843934
+Ref: Rounding Mode-Footnote-1846938
+Node: Gawk and MPFR847119
+Node: Arbitrary Precision Floats848361
+Ref: Arbitrary Precision Floats-Footnote-1850790
+Node: Setting Precision851101
+Node: Setting Rounding Mode853834
+Ref: table-gawk-rounding-modes854238
+Node: Floating-point Constants855418
+Node: Changing Precision856842
+Ref: Changing Precision-Footnote-1858242
+Node: Exact Arithmetic858416
+Node: Arbitrary Precision Integers861524
+Ref: Arbitrary Precision Integers-Footnote-1864524
+Node: Dynamic Extensions864671
+Node: Extension Intro866048
+Node: Plugin License867256
+Node: Extension Mechanism Outline867941
+Ref: load-extension868358
+Ref: load-new-function869836
+Ref: call-new-function870831
+Node: Extension API Description872839
+Node: Extension API Functions Introduction874178
+Node: General Data Types878956
+Ref: General Data Types-Footnote-1884558
+Node: Requesting Values884857
+Ref: table-value-types-returned885588
+Node: Constructor Functions886542
+Node: Registration Functions889538
+Node: Extension Functions890223
+Node: Exit Callback Functions892397
+Node: Extension Version String893640
+Node: Input Parsers894290
+Node: Output Wrappers904007
+Node: Two-way processors908423
+Node: Printing Messages910553
+Ref: Printing Messages-Footnote-1911630
+Node: Updating `ERRNO'911782
+Node: Accessing Parameters912521
+Node: Symbol Table Access913751
+Node: Symbol table by name914263
+Node: Symbol table by cookie915836
+Ref: Symbol table by cookie-Footnote-1919965
+Node: Cached values920028
+Ref: Cached values-Footnote-1923471
+Node: Array Manipulation923562
+Ref: Array Manipulation-Footnote-1924660
+Node: Array Data Types924699
+Ref: Array Data Types-Footnote-1927402
+Node: Array Functions927494
+Node: Flattening Arrays931260
+Node: Creating Arrays938099
+Node: Extension API Variables942894
+Node: Extension Versioning943530
+Node: Extension API Informational Variables945431
+Node: Extension API Boilerplate946517
+Node: Finding Extensions950348
+Node: Extension Example950895
+Node: Internal File Description951633
+Node: Internal File Ops955321
+Ref: Internal File Ops-Footnote-1966768
+Node: Using Internal File Ops966908
+Ref: Using Internal File Ops-Footnote-1969261
+Node: Extension Samples969527
+Node: Extension Sample File Functions971051
+Node: Extension Sample Fnmatch979524
+Node: Extension Sample Fork981250
+Node: Extension Sample Inplace982468
+Node: Extension Sample Ord984246
+Node: Extension Sample Readdir985025
+Node: Extension Sample Revout986529
+Node: Extension Sample Rev2way987122
+Node: Extension Sample Read write array987812
+Node: Extension Sample Readfile989695
+Node: Extension Sample API Tests990452
+Node: Extension Sample Time990977
+Node: gawkextlib992284
+Node: Language History994665
+Node: V7/SVR3.1996187
+Node: SVR4998508
+Node: POSIX999950
+Node: BTL1001336
+Node: POSIX/GNU1002070
+Node: Common Extensions1007605
+Node: Ranges and Locales1008760
+Ref: Ranges and Locales-Footnote-11013378
+Ref: Ranges and Locales-Footnote-21013405
+Ref: Ranges and Locales-Footnote-31013665
+Node: Contributors1013886
+Node: Installation1018690
+Node: Gawk Distribution1019584
+Node: Getting1020068
+Node: Extracting1020894
+Node: Distribution contents1022586
+Node: Unix Installation1027847
+Node: Quick Installation1028464
+Node: Additional Configuration Options1030426
+Node: Configuration Philosophy1031903
+Node: Non-Unix Installation1034245
+Node: PC Installation1034703
+Node: PC Binary Installation1036002
+Node: PC Compiling1037850
+Node: PC Testing1040794
+Node: PC Using1041970
+Node: Cygwin1046155
+Node: MSYS1047155
+Node: VMS Installation1047669
+Node: VMS Compilation1048272
+Ref: VMS Compilation-Footnote-11049279
+Node: VMS Installation Details1049337
+Node: VMS Running1050972
+Node: VMS Old Gawk1052579
+Node: Bugs1053053
+Node: Other Versions1056905
+Node: Notes1062506
+Node: Compatibility Mode1063306
+Node: Additions1064089
+Node: Accessing The Source1065016
+Node: Adding Code1066456
+Node: New Ports1072501
+Node: Derived Files1076636
+Ref: Derived Files-Footnote-11081957
+Ref: Derived Files-Footnote-21081991
+Ref: Derived Files-Footnote-31082591
+Node: Future Extensions1082689
+Node: Implementation Limitations1083270
+Node: Extension Design1084522
+Node: Old Extension Problems1085671
+Ref: Old Extension Problems-Footnote-11087179
+Node: Extension New Mechanism Goals1087236
+Ref: Extension New Mechanism Goals-Footnote-11090595
+Node: Extension Other Design Decisions1090781
+Node: Extension Future Growth1092887
+Node: Old Extension Mechansim1093708
+Node: Basic Concepts1095447
+Node: Basic High Level1096128
+Ref: figure-general-flow1096399
+Ref: figure-process-flow1096998
+Ref: Basic High Level-Footnote-11100227
+Node: Basic Data Typing1100412
+Node: Glossary1103767
+Node: Copying1129238
+Node: GNU Free Documentation License1166795
+Node: Index1191932
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 8009f12..dee577a 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -1741,7 +1741,6 @@ significant editorial help for this @value{DOCUMENT} for 
the
 @cindex Deifik, Scott
 @cindex Demaille, Akim
 @cindex Hankerson, Darrel
address@hidden Haque, John
 @cindex Jaegermann, Michal
 @cindex Kahrs, J@"urgen
 @cindex Kasal, Stepan
@@ -1780,50 +1779,14 @@ help, @command{gawk} would not be nearly the fine 
program it is today.  It
 has been and continues to be a pleasure working with this team of fine
 people.
 
-Notable code and documentation contributions were made by the
-following people:
-
address@hidden @bullet
address@hidden
-John Haque made the followoing contributions:
-
address@hidden @minus
address@hidden
-The modifications to convert @command{gawk}
-into a byte-code interpreter, including the debugger.
-
address@hidden
-The additional modifications for support of arbitrary precision arithmetic.
-
address@hidden
-The initial text of
address@hidden Precision Arithmetic}.
-
address@hidden
-The work to merge the three versions of @command{gawk}
-into one, for the 4.1 release.
address@hidden itemize
-
address@hidden
-Stephen Davies
-contributed to the effort to bring the byte-code changes into the mainstream
-code base. 
-
address@hidden
-Efraim Yawitz contributed the initial text of @ref{Debugger}.
-
address@hidden
-The development of the extension API first released with
address@hidden 4.1 was driven primarily by
-Arnold Robbins and Andrew Schorr, with notable contributions from
-the rest of the development team.
address@hidden itemize
+Notable code and documentation contributions were made by
+a number of people. @xref{Contributors}, for the full list.
 
 @cindex Kernighan, Brian
 I would like to thank Brian Kernighan for invaluable assistance during the
 testing and debugging of @command{gawk}, and for ongoing
 help and advice in clarifying numerous points about the language.
- We could not have done nearly as good a job on either @command{gawk}
+We could not have done nearly as good a job on either @command{gawk}
 or its documentation without his help.
 
 @cindex Robbins, Miriam
@@ -27177,7 +27140,7 @@ the general attributes of computer arithmetic, along 
with how
 this can influence what you see when running @command{awk} programs.
 This discussion applies to all versions of @command{awk}.
 
-Then the @value{CHAPTER} moves on to @dfn{arbitrary precision
+The @value{CHAPTER} then moves on to describe @dfn{arbitrary precision
 arithmetic}, a feature which is specific to @command{gawk}.
 
 @menu
@@ -31610,10 +31573,10 @@ else
 @end example
 
 @node Extension Sample Inplace
address@hidden Enabling in-place file editing.
address@hidden Enabling In-Place File Editing
 
-The @code{inplace} extension emulates the @command{sed} @option{-i} option
-which performs ``in placed'' editing of each input file.
+The @code{inplace} extension emulates GNU @command{sed}'s @option{-i} option
+which performs ``in place'' editing of each input file.
 It uses the bundled @file{inplace.awk} include file to invoke the extension
 properly:
 
@@ -31663,7 +31626,7 @@ $ @kbd{gawk -i inplace -v INPLACE_SUFFIX=.bak '@{ 
gsub(/foo/, "bar") @}}
 @end example
 
 We leave it as an exercise to write a wrapper script that presents an
-interface similar to the @command{sed} @option{-i} option.
+interface similar to @samp{sed -i}.
 
 @node Extension Sample Ord
 @subsection Character and Numeric values: @code{ord()} and @code{chr()}
@@ -32219,6 +32182,24 @@ More complete documentation of many of the previously 
undocumented
 features of the language.
 @end itemize
 
+In 2012, a number of extensions that had been commonly available for
+many years were finally added to POSIX. They are:
+
address@hidden @bullet
address@hidden
+The @code{fflush()} built-in function for flushing buffered output
+(@pxref{I/O Functions}).
+
address@hidden
+The @code{nextfile} statement
+(@pxref{Nextfile Statement}).
+
address@hidden
+The ability to delete all of an array at once with @samp{delete @var{array}}
+(@pxref{Delete}).
+
address@hidden itemize
+
 @xref{Common Extensions}, for a list of common extensions
 not permitted by the POSIX standard.
 
@@ -32255,7 +32236,6 @@ The use of @code{func} as an abbreviation for 
@code{function}
 @item
 The @code{fflush()} built-in function for flushing buffered output
 (@pxref{I/O Functions}).
-As of December 2012, this function is now standardized by POSIX.
 
 @ignore
 @item
@@ -32604,6 +32584,7 @@ the three most widely-used freely available versions of 
@command{awk}
 @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 @tab X
address@hidden @code{fflush()} function @tab X @tab X @tab X
 @item @code{func} keyword @tab X @tab @tab X
 @item @code{nextfile} statement @tab X @tab X @tab X
 @item @code{delete} without subscript @tab X @tab X @tab X
@@ -32711,6 +32692,7 @@ to implementors to implement ranges in whatever way 
they choose.
 The @command{gawk} maintainer chose to apply the pre-POSIX meaning in all
 cases: the default regexp matching; with @option{--traditional}, and with
 @option{--posix}; in all cases, @command{gawk} remains POSIX compliant.
+
 @node Contributors
 @appendixsec Major Contributors to @command{gawk}
 @cindex @command{gawk}, list of contributors to
@@ -32903,17 +32885,40 @@ Patrick T.J.@: McPhee contributed the code for 
dynamic loading in Windows32
 environments.
 (This is no longer supported)
 
+
 @item
 @cindex Haque, John
-John Haque
-reworked the @command{gawk} internals to use a byte-code engine,
-providing the @command{gawk} debugger for @command{awk} programs.
+John Haque made the following contributions:
+
address@hidden @minus
address@hidden
+The modifications to convert @command{gawk}
+into a byte-code interpreter, including the debugger.
+
address@hidden
+The additional modifications for support of arbitrary precision arithmetic.
+
address@hidden
+The initial text of
address@hidden Precision Arithmetic}.
+
address@hidden
+The work to merge the three versions of @command{gawk}
+into one, for the 4.1 release.
address@hidden itemize
 
 @item
 @cindex Yawitz, Efraim
 Efraim Yawitz contributed the original text for @ref{Debugger}.
 
 @item
address@hidden Schorr, Andrew
+The development of the extension API first released with
address@hidden 4.1 was driven primarily by
+Arnold Robbins and Andrew Schorr, with notable contributions from
+the rest of the development team.
+
address@hidden
 @cindex Robbins, Arnold
 Arnold Robbins
 has been working on @command{gawk} since 1988, at first
@@ -34239,6 +34244,14 @@ This is an embeddable @command{awk} interpreter 
derived from
 @command{mawk}. For more information see
 @uref{http://repo.hu/projects/libmawk/}.
 
address@hidden @code{pawk}
address@hidden @code{pawk}, @command{awk}-like facilities for Python
+This is a Python module that claims to bring @command{awk}-like
+features to Python. See @uref{https://github.com/alecthomas/pawk}
+for more information. (This is not related to Nelson Beebe's
+modified version of Brian Kernighan's @command{awk},
+described earlier.)
+
 @item @w{QSE Awk}
 @cindex QSE Awk
 @cindex source code, QSE Awk
@@ -34254,12 +34267,6 @@ under the GPL. It has a large number of extensions 
over standard
 See @uref{http://www.quiktrim.org/QTawk.html} for more information,
 including the manual and a download link.
 
address@hidden @code{pawk}
address@hidden @code{pawk}, @command{awk}-like facilities for Python
-This is a Python module that claims to bring @command{awk}-like
-features to Python. See @uref{https://github.com/alecthomas/pawk}
-for more information.
-
 @end table
 @c ENDOFRANGE gligawk
 @c ENDOFRANGE ingawk
@@ -34364,17 +34371,10 @@ Once you have made changes, you can use @samp{git 
diff} to produce a
 patch, and send that to the @command{gawk} maintainer; see @ref{Bugs},
 for how to do that.
 
-Finally, if you cannot install Git (e.g., if it hasn't been ported
-yet to your operating system), you can use the Git--CVS gateway
-to check out a copy using CVS, as follows:
-
address@hidden
-cvs -d:pserver:anonymous@@pserver.git.sv.gnu.org:/gawk.git co -d gawk master
address@hidden example
-
-Note that this gateway is flakey; you may have better luck using
-a more modern version control system like Bazaar, that has a Git
-plug-in for working with Git repositories.
+Once upon a time there was Git--CVS gateway for use by people who could
+not install Git. However, this gateway no longer works, so you may have
+better luck using a more modern version control system like Bazaar,
+that has a Git plug-in for working with Git repositories.
 
 @node Adding Code
 @appendixsubsec Adding New Features
@@ -34477,7 +34477,7 @@ of @code{switch} statements, instead of just the
 plain pointer or character value.
 
 @item
-Use @code{true}, @code{false} for @code{bool} values,
+Use @code{true} and @code{false} for @code{bool} values,
 the @code{NULL} symbolic constant for pointer values,
 and the character constant @code{'\0'} where appropriate, instead of @code{1}
 and @code{0}.
@@ -35146,12 +35146,12 @@ to any of the above.
 
 @ref{Dynamic Extensions}, describes the supported API and mechanisms
 for writing extensions for @command{gawk}.  This API was introduced
-in @strong{FIXME: VERSION}.  However, for many years @command{gawk}
+in @value{PVERSION} 4.1.  However, for many years @command{gawk}
 provided an extension mechanism that required knowledge of @command{gawk}
 internals and that was not as well designed.
 
-In order to provide a transition period, @command{gawk} version
address@hidden: VERSION} continues to support the original extension mechanism.
+In order to provide a transition period, @command{gawk} @value{PVERSION}
+4.1 continues to support the original extension mechanism.
 This will be true for the life of exactly one major release.  This support
 will be withdrawn, and removed from the source code, at the next major
 release.
@@ -36002,7 +36002,7 @@ the input record.  A typical pattern might compare the 
input record against
 a regular expression. (@xref{Pattern Overview}.)
 
 @item PEBKAC
-A descriptive acronym for describing possibly the most frequent
+An acronym describing what is possibly the most frequent
 source of computer usage problems. (Problem Exists Between
 Keyboard And Chair.)
 

-----------------------------------------------------------------------

Summary of changes:
 doc/ChangeLog |    4 +
 doc/gawk.info | 1149 ++++++++++++++++++++++++++++-----------------------------
 doc/gawk.texi |  142 ++++----
 3 files changed, 649 insertions(+), 646 deletions(-)


hooks/post-receive
-- 
gawk



reply via email to

[Prev in Thread] Current Thread [Next in Thread]