[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[SCM] gawk branch, gawk-5.1-stable, updated. gawk-4.1.0-4307-gb5a955b
|
From: |
Arnold Robbins |
|
Subject: |
[SCM] gawk branch, gawk-5.1-stable, updated. gawk-4.1.0-4307-gb5a955b |
|
Date: |
Wed, 22 Sep 2021 08:56:32 -0400 (EDT) |
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".
The branch, gawk-5.1-stable has been updated
via b5a955b904d420dfd3e9216bf360858488f2bada (commit)
from 596cccc1d46931f2cdb2310505fc2c49895efda4 (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=b5a955b904d420dfd3e9216bf360858488f2bada
commit b5a955b904d420dfd3e9216bf360858488f2bada
Author: Arnold D. Robbins <arnold@skeeve.com>
Date: Wed Sep 22 15:56:19 2021 +0300
Documentation updates.
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 6505bc0..d92ebbd 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,10 @@
+2021-09-22 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawktexi.in (Compiling from Git): New node.
+ (Building the Documentation): New node.
+ Set the update month and update the patch level.
+ * awkcard.in: Update tar ball version.
+
2021-09-09 Arnold D. Robbins <arnold@skeeve.com>
* gawktexi.in (Interval Expressions): Add some notes borrowed from
diff --git a/doc/awkcard.in b/doc/awkcard.in
index 7cf90cc..cbc6761 100644
--- a/doc/awkcard.in
+++ b/doc/awkcard.in
@@ -1984,7 +1984,7 @@ to use the current domain.\*(CB
.ES
.nf
\*(CDHost: \*(FCftp.gnu.org\*(FR
-File: \*(FC/gnu/gawk/gawk-5.1.0.tar.gz\fP
+File: \*(FC/gnu/gawk/gawk-5.1.1.tar.gz\fP
.in +.2i
.fi
GNU \*(AK (\*(GK). There may be a later version.
diff --git a/doc/gawk.info b/doc/gawk.info
index 94ebf26..7485675 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -5,7 +5,7 @@ Free Software Foundation, Inc.
This is Edition 5.1 of 'GAWK: Effective AWK Programming: A User's
-Guide for GNU Awk', for the 5.1.0 (or later) version of the GNU
+Guide for GNU Awk', for the 5.1.1 (or later) version of the GNU
implementation of AWK.
Permission is granted to copy, distribute and/or modify this document
@@ -42,7 +42,7 @@ Free Software Foundation, Inc.
This is Edition 5.1 of 'GAWK: Effective AWK Programming: A User's
-Guide for GNU Awk', for the 5.1.0 (or later) version of the GNU
+Guide for GNU Awk', for the 5.1.1 (or later) version of the GNU
implementation of AWK.
Permission is granted to copy, distribute and/or modify this document
@@ -435,8 +435,8 @@ in (a) below. A copy of the license is included in the
section entitled
once.
* Shell Quoting:: A function to quote strings for the
shell.
-* Isnumeric Function:: A function to test whether a value
- is numeric.
+* Isnumeric Function:: A function to test whether a value is
+ numeric.
* Data File Management:: Functions for managing command-line
data files.
* Filetrans Function:: A function for handling data file
@@ -660,6 +660,8 @@ in (a) below. A copy of the license is included in the
section entitled
* Shell Startup Files:: Shell convenience functions.
* Additional Configuration Options:: Other compile-time options.
* Configuration Philosophy:: How it's all supposed to work.
+* Compiling from Git:: Compiling from Git.
+* Building the Documentation:: Building the Documentation.
* Non-Unix Installation:: Installation on Other Operating
Systems.
* PC Installation:: Installing and Compiling
@@ -685,7 +687,8 @@ in (a) below. A copy of the license is included in the
section entitled
* Bug definition:: Defining what is and is not a bug.
* Bug address:: Where to send reports to.
* Usenet:: Where not to send reports to.
-* Performance bugs:: What to do if you think there is a
performance issue.
+* Performance bugs:: What to do if you think there is a
+ performance issue.
* Asking for help:: Dealing with non-bug questions.
* Maintainers:: Maintainers of non-*nix ports.
* Other Versions:: Other freely available 'awk'
@@ -30458,7 +30461,7 @@ There are two ways to get GNU software:
supported. If you have the 'wget' program, you can use a command
like the following:
- wget https://ftp.gnu.org/gnu/gawk/gawk-5.1.0.tar.gz
+ wget https://ftp.gnu.org/gnu/gawk/gawk-5.1.1.tar.gz
The GNU software archive is mirrored around the world. The
up-to-date list of mirror sites is available from the main FSF website
@@ -30480,25 +30483,25 @@ compression programs: 'gzip', 'bzip2', and 'xz'. For
simplicity, the
rest of these instructions assume you are using the one compressed with
the GNU Gzip program ('gzip').
- Once you have the distribution (e.g., 'gawk-5.1.0.tar.gz'), use
+ Once you have the distribution (e.g., 'gawk-5.1.1.tar.gz'), use
'gzip' to expand the file and then use 'tar' to extract it. You can use
the following pipeline to produce the 'gawk' distribution:
- gzip -d -c gawk-5.1.0.tar.gz | tar -xvpf -
+ gzip -d -c gawk-5.1.1.tar.gz | tar -xvpf -
On a system with GNU 'tar', you can let 'tar' do the decompression
for you:
- tar -xvpzf gawk-5.1.0.tar.gz
+ tar -xvpzf gawk-5.1.1.tar.gz
-Extracting the archive creates a directory named 'gawk-5.1.0' in the
+Extracting the archive creates a directory named 'gawk-5.1.1' in the
current directory.
The distribution file name is of the form 'gawk-V.R.P.tar.gz'. The V
represents the major version of 'gawk', the R represents the current
release of version V, and the P represents a "patch level", meaning that
minor bugs have been fixed in the release. The current patch level is
-0, but when retrieving distributions, you should get the version with
+1, but when retrieving distributions, you should get the version with
the highest version, release, and patch level. (Note, however, that
patch levels greater than or equal to 60 denote "beta" or nonproduction
software; you might not want to retrieve such a version unless you don't
@@ -30713,6 +30716,8 @@ for your system yourself.
* Shell Startup Files:: Shell convenience functions.
* Additional Configuration Options:: Other compile-time options.
* Configuration Philosophy:: How it's all supposed to work.
+* Compiling from Git:: Compiling from Git.
+* Building the Documentation:: Building the Documentation.
File: gawk.info, Node: Quick Installation, Next: Shell Startup Files, Up:
Unix Installation
@@ -30722,14 +30727,14 @@ B.2.1 Compiling 'gawk' for Unix-Like Systems
* Menu:
-* Compiling with MPFR:: Building with MPFR.
+* Compiling with MPFR:: Building with MPFR.
The normal installation steps should work on all modern commercial
Unix-derived systems, GNU/Linux, BSD-based systems, and the Cygwin
environment for MS-Windows.
After you have extracted the 'gawk' distribution, 'cd' to
-'gawk-5.1.0'. As with most GNU software, you configure 'gawk' for your
+'gawk-5.1.1'. As with most GNU software, you configure 'gawk' for your
system by running the 'configure' program. This program is a Bourne
shell script that is generated automatically using GNU Autoconf. (The
Autoconf software is described fully starting with *note (Autoconf,
@@ -30880,7 +30885,7 @@ command line when compiling 'gawk' from scratch,
including:
supplied by 'configure'.
-File: gawk.info, Node: Configuration Philosophy, Prev: Additional
Configuration Options, Up: Unix Installation
+File: gawk.info, Node: Configuration Philosophy, Next: Compiling from Git,
Prev: Additional Configuration Options, Up: Unix Installation
B.2.4 The Configuration Process
-------------------------------
@@ -30926,6 +30931,45 @@ how to report problems in configuring 'gawk'). The
same mechanism may
be used to send in updates to 'configure.ac' and/or 'custom.h'.
+File: gawk.info, Node: Compiling from Git, Next: Building the Documentation,
Prev: Configuration Philosophy, Up: Unix Installation
+
+B.2.5 Compiling from Git
+------------------------
+
+Building 'gawk' directly from the development source control repository
+is possible, but not recommended for everyday users, as the code may not
+be as stable as released versions are. If you really do want to do
+that, here are the steps:
+
+ git clone https://git.savannah.gnu.org/r/gawk.git
+ cd gawk
+ ./bootstrap.sh && ./configure && make && make check
+
+
+File: gawk.info, Node: Building the Documentation, Prev: Compiling from Git,
Up: Unix Installation
+
+B.2.6 Building the Documentation
+--------------------------------
+
+The Info documentation is included in the distribution tar files and in
+Git; you should not need to rebuild it. However, if it needs to be
+done, simply running 'make' will do it, assuming that you have a recent
+enough version of 'makeinfo' installed.
+
+ If you wish to build the PDF version of the manual, you will need to
+have TeX installed, and possibly additional packages that provide the
+necessary fonts and tools, such as 'ps2pdf'. You will also need GNU
+Troff ('groff') installed in order to format the reference card and the
+manual page. Managing this process is beyond the scope of this Info
+file.
+
+ Assuming you have all you need, then the following commands produce
+the PDF versions of the documentation:
+
+ cd doc
+ make pdf
+
+
File: gawk.info, Node: Non-Unix Installation, Next: Bugs, Prev: Unix
Installation, Up: Installation
B.3 Installation on Other Operating Systems
@@ -31093,8 +31137,8 @@ environment provides an excellent simulation of
GNU/Linux, using Bash,
GCC, GNU Make, and other GNU programs. Compilation and installation for
Cygwin is the same as for a Unix system:
- tar -xvpzf gawk-5.1.0.tar.gz
- cd gawk-5.1.0
+ tar -xvpzf gawk-5.1.1.tar.gz
+ cd gawk-5.1.1
./configure
make && make check
@@ -31439,7 +31483,8 @@ might well want to fix it.
* Bug definition:: Defining what is and is not a bug.
* Bug address:: Where to send reports to.
* Usenet:: Where not to send reports to.
-* Performance bugs:: What to do if you think there is a performance
issue.
+* Performance bugs:: What to do if you think there is a performance
+ issue.
* Asking for help:: Dealing with non-bug questions.
* Maintainers:: Maintainers of non-*nix ports.
@@ -31949,9 +31994,9 @@ B.6 Summary
* The 'gawk' distribution is available from the GNU Project's main
distribution site, 'ftp.gnu.org'. The canonical build recipe is:
- wget https://ftp.gnu.org/gnu/gawk/gawk-5.1.0.tar.gz
- tar -xvpzf gawk-5.1.0.tar.gz
- cd gawk-5.1.0
+ wget https://ftp.gnu.org/gnu/gawk/gawk-5.1.1.tar.gz
+ tar -xvpzf gawk-5.1.1.tar.gz
+ cd gawk-5.1.1
./configure && make && make check
NOTE: Because of the 'https://' URL, you may have to supply
@@ -38401,607 +38446,609 @@ Index
Tag Table:
Node: Top1200
-Node: Foreword345084
-Node: Foreword449526
-Node: Preface51058
-Ref: Preface-Footnote-153917
-Ref: Preface-Footnote-254026
-Ref: Preface-Footnote-354260
-Node: History54402
-Node: Names56754
-Ref: Names-Footnote-157858
-Node: This Manual58005
-Ref: This Manual-Footnote-164644
-Node: Conventions64744
-Node: Manual History67113
-Ref: Manual History-Footnote-170110
-Ref: Manual History-Footnote-270151
-Node: How To Contribute70225
-Node: Acknowledgments71151
-Node: Getting Started76088
-Node: Running gawk78527
-Node: One-shot79717
-Node: Read Terminal80980
-Node: Long82973
-Node: Executable Scripts84486
-Ref: Executable Scripts-Footnote-187119
-Node: Comments87222
-Node: Quoting89706
-Node: DOS Quoting95232
-Node: Sample Data Files97288
-Node: Very Simple99883
-Node: Two Rules105985
-Node: More Complex107870
-Node: Statements/Lines110202
-Ref: Statements/Lines-Footnote-1114686
-Node: Other Features114951
-Node: When115887
-Ref: When-Footnote-1117641
-Node: Intro Summary117706
-Node: Invoking Gawk118590
-Node: Command Line120104
-Node: Options120902
-Ref: Options-Footnote-1138816
-Ref: Options-Footnote-2139047
-Node: Other Arguments139072
-Node: Naming Standard Input143083
-Node: Environment Variables144293
-Node: AWKPATH Variable144851
-Ref: AWKPATH Variable-Footnote-1148263
-Ref: AWKPATH Variable-Footnote-2148297
-Node: AWKLIBPATH Variable148668
-Ref: AWKLIBPATH Variable-Footnote-1150365
-Node: Other Environment Variables150740
-Node: Exit Status154561
-Node: Include Files155238
-Node: Loading Shared Libraries158928
-Node: Obsolete160356
-Node: Undocumented161048
-Node: Invoking Summary161345
-Node: Regexp164186
-Node: Regexp Usage165640
-Node: Escape Sequences167677
-Node: Regexp Operators173918
-Node: Regexp Operator Details174403
-Ref: Regexp Operator Details-Footnote-1181767
-Node: Interval Expressions181914
-Ref: Interval Expressions-Footnote-1184114
-Node: Bracket Expressions184212
-Ref: table-char-classes186688
-Node: Leftmost Longest190014
-Node: Computed Regexps191317
-Node: GNU Regexp Operators194744
-Node: Case-sensitivity198481
-Ref: Case-sensitivity-Footnote-1201347
-Ref: Case-sensitivity-Footnote-2201582
-Node: Regexp Summary201690
-Node: Reading Files203156
-Node: Records205425
-Node: awk split records206500
-Node: gawk split records211200
-Ref: gawk split records-Footnote-1216274
-Node: Fields216311
-Node: Nonconstant Fields219052
-Ref: Nonconstant Fields-Footnote-1221288
-Node: Changing Fields221492
-Node: Field Separators227523
-Node: Default Field Splitting230221
-Node: Regexp Field Splitting231339
-Node: Single Character Fields235016
-Node: Command Line Field Separator236076
-Node: Full Line Fields239294
-Ref: Full Line Fields-Footnote-1240816
-Ref: Full Line Fields-Footnote-2240862
-Node: Field Splitting Summary240963
-Node: Constant Size243037
-Node: Fixed width data243769
-Node: Skipping intervening247236
-Node: Allowing trailing data248034
-Node: Fields with fixed data249071
-Node: Splitting By Content250589
-Ref: Splitting By Content-Footnote-1254372
-Node: More CSV254535
-Node: Testing field creation256127
-Node: Multiple Line257752
-Node: Getline264029
-Node: Plain Getline266498
-Node: Getline/Variable269071
-Node: Getline/File270222
-Node: Getline/Variable/File271610
-Ref: Getline/Variable/File-Footnote-1273215
-Node: Getline/Pipe273303
-Node: Getline/Variable/Pipe276007
-Node: Getline/Coprocess277142
-Node: Getline/Variable/Coprocess278409
-Node: Getline Notes279151
-Node: Getline Summary281948
-Ref: table-getline-variants282372
-Node: Read Timeout283120
-Ref: Read Timeout-Footnote-1287026
-Node: Retrying Input287084
-Node: Command-line directories288283
-Node: Input Summary289189
-Node: Input Exercises292361
-Node: Printing292795
-Node: Print294629
-Node: Print Examples296086
-Node: Output Separators298866
-Node: OFMT300883
-Node: Printf302239
-Node: Basic Printf303024
-Node: Control Letters304598
-Node: Format Modifiers309762
-Node: Printf Examples315777
-Node: Redirection318263
-Node: Special FD325104
-Ref: Special FD-Footnote-1328272
-Node: Special Files328346
-Node: Other Inherited Files328963
-Node: Special Network329964
-Node: Special Caveats330824
-Node: Close Files And Pipes331773
-Ref: table-close-pipe-return-values338680
-Ref: Close Files And Pipes-Footnote-1339493
-Ref: Close Files And Pipes-Footnote-2339641
-Node: Nonfatal339793
-Node: Output Summary342131
-Node: Output Exercises343353
-Node: Expressions344032
-Node: Values345220
-Node: Constants345898
-Node: Scalar Constants346589
-Ref: Scalar Constants-Footnote-1349099
-Node: Nondecimal-numbers349349
-Node: Regexp Constants352350
-Node: Using Constant Regexps352876
-Node: Standard Regexp Constants353498
-Node: Strong Regexp Constants356686
-Node: Variables360110
-Node: Using Variables360767
-Node: Assignment Options362677
-Node: Conversion365148
-Node: Strings And Numbers365672
-Ref: Strings And Numbers-Footnote-1368735
-Node: Locale influences conversions368844
-Ref: table-locale-affects371602
-Node: All Operators372220
-Node: Arithmetic Ops372849
-Node: Concatenation375565
-Ref: Concatenation-Footnote-1378412
-Node: Assignment Ops378519
-Ref: table-assign-ops383510
-Node: Increment Ops384823
-Node: Truth Values and Conditions388283
-Node: Truth Values389357
-Node: Typing and Comparison390405
-Node: Variable Typing391225
-Ref: Variable Typing-Footnote-1397688
-Ref: Variable Typing-Footnote-2397760
-Node: Comparison Operators397837
-Ref: table-relational-ops398256
-Node: POSIX String Comparison401751
-Ref: POSIX String Comparison-Footnote-1403446
-Ref: POSIX String Comparison-Footnote-2403585
-Node: Boolean Ops403669
-Ref: Boolean Ops-Footnote-1408151
-Node: Conditional Exp408243
-Node: Function Calls409979
-Node: Precedence413856
-Node: Locales417515
-Node: Expressions Summary419147
-Node: Patterns and Actions421720
-Node: Pattern Overview422840
-Node: Regexp Patterns424517
-Node: Expression Patterns425059
-Node: Ranges428840
-Node: BEGIN/END431948
-Node: Using BEGIN/END432709
-Ref: Using BEGIN/END-Footnote-1435463
-Node: I/O And BEGIN/END435569
-Node: BEGINFILE/ENDFILE437882
-Node: Empty441113
-Node: Using Shell Variables441430
-Node: Action Overview443704
-Node: Statements446029
-Node: If Statement447877
-Node: While Statement449372
-Node: Do Statement451400
-Node: For Statement452548
-Node: Switch Statement455719
-Node: Break Statement458160
-Node: Continue Statement460252
-Node: Next Statement462079
-Node: Nextfile Statement464462
-Node: Exit Statement467151
-Node: Built-in Variables469554
-Node: User-modified470687
-Node: Auto-set478454
-Ref: Auto-set-Footnote-1495261
-Ref: Auto-set-Footnote-2495467
-Node: ARGC and ARGV495523
-Node: Pattern Action Summary499736
-Node: Arrays502166
-Node: Array Basics503495
-Node: Array Intro504339
-Ref: figure-array-elements506314
-Ref: Array Intro-Footnote-1509018
-Node: Reference to Elements509146
-Node: Assigning Elements511610
-Node: Array Example512101
-Node: Scanning an Array513860
-Node: Controlling Scanning516882
-Ref: Controlling Scanning-Footnote-1523338
-Node: Numeric Array Subscripts523654
-Node: Uninitialized Subscripts525838
-Node: Delete527457
-Ref: Delete-Footnote-1530209
-Node: Multidimensional530266
-Node: Multiscanning533361
-Node: Arrays of Arrays534952
-Node: Arrays Summary539720
-Node: Functions541813
-Node: Built-in542851
-Node: Calling Built-in543932
-Node: Numeric Functions545928
-Ref: Numeric Functions-Footnote-1549956
-Ref: Numeric Functions-Footnote-2550604
-Ref: Numeric Functions-Footnote-3550652
-Node: String Functions550924
-Ref: String Functions-Footnote-1575439
-Ref: String Functions-Footnote-2575567
-Ref: String Functions-Footnote-3575815
-Node: Gory Details575902
-Ref: table-sub-escapes577693
-Ref: table-sub-proposed579212
-Ref: table-posix-sub580575
-Ref: table-gensub-escapes582116
-Ref: Gory Details-Footnote-1582939
-Node: I/O Functions583093
-Ref: table-system-return-values589547
-Ref: I/O Functions-Footnote-1591627
-Ref: I/O Functions-Footnote-2591775
-Node: Time Functions591895
-Ref: Time Functions-Footnote-1602566
-Ref: Time Functions-Footnote-2602634
-Ref: Time Functions-Footnote-3602792
-Ref: Time Functions-Footnote-4602903
-Ref: Time Functions-Footnote-5603015
-Ref: Time Functions-Footnote-6603242
-Node: Bitwise Functions603508
-Ref: table-bitwise-ops604102
-Ref: Bitwise Functions-Footnote-1610165
-Ref: Bitwise Functions-Footnote-2610338
-Node: Type Functions610529
-Node: I18N Functions613392
-Node: User-defined615043
-Node: Definition Syntax615855
-Ref: Definition Syntax-Footnote-1621549
-Node: Function Example621620
-Ref: Function Example-Footnote-1624542
-Node: Function Calling624564
-Node: Calling A Function625152
-Node: Variable Scope626110
-Node: Pass By Value/Reference629104
-Node: Function Caveats631748
-Ref: Function Caveats-Footnote-1633795
-Node: Return Statement633915
-Node: Dynamic Typing636894
-Node: Indirect Calls637824
-Ref: Indirect Calls-Footnote-1648076
-Node: Functions Summary648204
-Node: Library Functions650909
-Ref: Library Functions-Footnote-1654516
-Ref: Library Functions-Footnote-2654659
-Node: Library Names654830
-Ref: Library Names-Footnote-1658497
-Ref: Library Names-Footnote-2658720
-Node: General Functions658806
-Node: Strtonum Function659988
-Node: Assert Function663010
-Node: Round Function666336
-Node: Cliff Random Function667876
-Node: Ordinal Functions668892
-Ref: Ordinal Functions-Footnote-1671955
-Ref: Ordinal Functions-Footnote-2672207
-Node: Join Function672417
-Ref: Join Function-Footnote-1674187
-Node: Getlocaltime Function674387
-Node: Readfile Function678129
-Node: Shell Quoting680106
-Node: Isnumeric Function681534
-Node: Data File Management682922
-Node: Filetrans Function683554
-Node: Rewind Function687650
-Node: File Checking689559
-Ref: File Checking-Footnote-1690893
-Node: Empty Files691094
-Node: Ignoring Assigns693073
-Node: Getopt Function694623
-Ref: Getopt Function-Footnote-1709846
-Node: Passwd Functions710046
-Ref: Passwd Functions-Footnote-1718885
-Node: Group Functions718973
-Ref: Group Functions-Footnote-1726871
-Node: Walking Arrays727078
-Node: Library Functions Summary730086
-Node: Library Exercises731492
-Node: Sample Programs731957
-Node: Running Examples732727
-Node: Clones733455
-Node: Cut Program734679
-Node: Egrep Program744819
-Node: Id Program753820
-Node: Split Program763767
-Ref: Split Program-Footnote-1773660
-Node: Tee Program773833
-Node: Uniq Program776623
-Node: Wc Program784211
-Node: Bytes vs. Characters784598
-Node: Using extensions786146
-Node: wc program786900
-Node: Miscellaneous Programs791765
-Node: Dupword Program792978
-Node: Alarm Program795008
-Node: Translate Program799863
-Ref: Translate Program-Footnote-1804428
-Node: Labels Program804698
-Ref: Labels Program-Footnote-1808049
-Node: Word Sorting808133
-Node: History Sorting812205
-Node: Extract Program814430
-Node: Simple Sed822484
-Node: Igawk Program825558
-Ref: Igawk Program-Footnote-1839889
-Ref: Igawk Program-Footnote-2840091
-Ref: Igawk Program-Footnote-3840213
-Node: Anagram Program840328
-Node: Signature Program843390
-Node: Programs Summary844637
-Node: Programs Exercises845851
-Ref: Programs Exercises-Footnote-1849981
-Node: Advanced Features850067
-Node: Nondecimal Data852134
-Node: Array Sorting853725
-Node: Controlling Array Traversal854425
-Ref: Controlling Array Traversal-Footnote-1862793
-Node: Array Sorting Functions862911
-Ref: Array Sorting Functions-Footnote-1868285
-Node: Two-way I/O868481
-Ref: Two-way I/O-Footnote-1876207
-Ref: Two-way I/O-Footnote-2876394
-Node: TCP/IP Networking876476
-Node: Profiling879594
-Node: Extension Philosophy888903
-Node: Advanced Features Summary890382
-Node: Internationalization892397
-Node: I18N and L10N894071
-Node: Explaining gettext894758
-Ref: Explaining gettext-Footnote-1900650
-Ref: Explaining gettext-Footnote-2900835
-Node: Programmer i18n901000
-Ref: Programmer i18n-Footnote-1905949
-Node: Translator i18n905998
-Node: String Extraction906792
-Ref: String Extraction-Footnote-1907924
-Node: Printf Ordering908010
-Ref: Printf Ordering-Footnote-1910796
-Node: I18N Portability910860
-Ref: I18N Portability-Footnote-1913316
-Node: I18N Example913379
-Ref: I18N Example-Footnote-1916654
-Ref: I18N Example-Footnote-2916727
-Node: Gawk I18N916836
-Node: I18N Summary917485
-Node: Debugger918826
-Node: Debugging919826
-Node: Debugging Concepts920267
-Node: Debugging Terms922076
-Node: Awk Debugging924651
-Ref: Awk Debugging-Footnote-1925596
-Node: Sample Debugging Session925728
-Node: Debugger Invocation926262
-Node: Finding The Bug927648
-Node: List of Debugger Commands934122
-Node: Breakpoint Control935455
-Node: Debugger Execution Control939149
-Node: Viewing And Changing Data942511
-Node: Execution Stack946052
-Node: Debugger Info947689
-Node: Miscellaneous Debugger Commands951760
-Node: Readline Support956822
-Node: Limitations957718
-Node: Debugging Summary960272
-Node: Namespaces961551
-Node: Global Namespace962662
-Node: Qualified Names964060
-Node: Default Namespace965059
-Node: Changing The Namespace965800
-Node: Naming Rules967414
-Node: Internal Name Management969262
-Node: Namespace Example970304
-Node: Namespace And Features972866
-Node: Namespace Summary974301
-Node: Arbitrary Precision Arithmetic975778
-Node: Computer Arithmetic977265
-Ref: table-numeric-ranges981031
-Ref: table-floating-point-ranges981524
-Ref: Computer Arithmetic-Footnote-1982182
-Node: Math Definitions982239
-Ref: table-ieee-formats985555
-Ref: Math Definitions-Footnote-1986158
-Node: MPFR features986263
-Node: FP Math Caution987981
-Ref: FP Math Caution-Footnote-1989053
-Node: Inexactness of computations989422
-Node: Inexact representation990382
-Node: Comparing FP Values991742
-Node: Errors accumulate992983
-Node: Getting Accuracy994416
-Node: Try To Round997126
-Node: Setting precision998025
-Ref: table-predefined-precision-strings998722
-Node: Setting the rounding mode1000552
-Ref: table-gawk-rounding-modes1000926
-Ref: Setting the rounding mode-Footnote-11004857
-Node: Arbitrary Precision Integers1005036
-Ref: Arbitrary Precision Integers-Footnote-11008211
-Node: Checking for MPFR1008360
-Node: POSIX Floating Point Problems1009834
-Ref: POSIX Floating Point Problems-Footnote-11014119
-Node: Floating point summary1014157
-Node: Dynamic Extensions1016347
-Node: Extension Intro1017900
-Node: Plugin License1019166
-Node: Extension Mechanism Outline1019963
-Ref: figure-load-extension1020402
-Ref: figure-register-new-function1021967
-Ref: figure-call-new-function1023059
-Node: Extension API Description1025121
-Node: Extension API Functions Introduction1026834
-Ref: table-api-std-headers1028670
-Node: General Data Types1032919
-Ref: General Data Types-Footnote-11041549
-Node: Memory Allocation Functions1041848
-Ref: Memory Allocation Functions-Footnote-11046349
-Node: Constructor Functions1046448
-Node: API Ownership of MPFR and GMP Values1049914
-Node: Registration Functions1051227
-Node: Extension Functions1051927
-Node: Exit Callback Functions1057249
-Node: Extension Version String1058499
-Node: Input Parsers1059162
-Node: Output Wrappers1071883
-Node: Two-way processors1076395
-Node: Printing Messages1078660
-Ref: Printing Messages-Footnote-11079831
-Node: Updating ERRNO1079984
-Node: Requesting Values1080723
-Ref: table-value-types-returned1081460
-Node: Accessing Parameters1082396
-Node: Symbol Table Access1083633
-Node: Symbol table by name1084145
-Ref: Symbol table by name-Footnote-11087169
-Node: Symbol table by cookie1087297
-Ref: Symbol table by cookie-Footnote-11091482
-Node: Cached values1091546
-Ref: Cached values-Footnote-11095082
-Node: Array Manipulation1095235
-Ref: Array Manipulation-Footnote-11096326
-Node: Array Data Types1096363
-Ref: Array Data Types-Footnote-11099021
-Node: Array Functions1099113
-Node: Flattening Arrays1103611
-Node: Creating Arrays1110587
-Node: Redirection API1115354
-Node: Extension API Variables1118187
-Node: Extension Versioning1118898
-Ref: gawk-api-version1119327
-Node: Extension GMP/MPFR Versioning1121058
-Node: Extension API Informational Variables1122686
-Node: Extension API Boilerplate1123759
-Node: Changes from API V11127733
-Node: Finding Extensions1129305
-Node: Extension Example1129864
-Node: Internal File Description1130662
-Node: Internal File Ops1134742
-Ref: Internal File Ops-Footnote-11146092
-Node: Using Internal File Ops1146232
-Ref: Using Internal File Ops-Footnote-11148615
-Node: Extension Samples1148889
-Node: Extension Sample File Functions1150418
-Node: Extension Sample Fnmatch1158067
-Node: Extension Sample Fork1159554
-Node: Extension Sample Inplace1160772
-Node: Extension Sample Ord1164398
-Node: Extension Sample Readdir1165234
-Ref: table-readdir-file-types1166123
-Node: Extension Sample Revout1167190
-Node: Extension Sample Rev2way1167779
-Node: Extension Sample Read write array1168519
-Node: Extension Sample Readfile1170461
-Node: Extension Sample Time1171556
-Node: Extension Sample API Tests1173308
-Node: gawkextlib1173800
-Node: Extension summary1176718
-Node: Extension Exercises1180420
-Node: Language History1181662
-Node: V7/SVR3.11183318
-Node: SVR41185470
-Node: POSIX1186904
-Node: BTL1188285
-Node: POSIX/GNU1189014
-Node: Feature History1194792
-Node: Common Extensions1211967
-Node: Ranges and Locales1213250
-Ref: Ranges and Locales-Footnote-11217866
-Ref: Ranges and Locales-Footnote-21217893
-Ref: Ranges and Locales-Footnote-31218128
-Node: Contributors1218351
-Node: History summary1224348
-Node: Installation1225728
-Node: Gawk Distribution1226672
-Node: Getting1227156
-Node: Extracting1228119
-Node: Distribution contents1229757
-Node: Unix Installation1236237
-Node: Quick Installation1236919
-Node: Compiling with MPFR1239400
-Node: Shell Startup Files1240092
-Node: Additional Configuration Options1241181
-Node: Configuration Philosophy1243496
-Node: Non-Unix Installation1245865
-Node: PC Installation1246325
-Node: PC Binary Installation1247163
-Node: PC Compiling1247598
-Node: PC Using1248715
-Node: Cygwin1252268
-Node: MSYS1253492
-Node: VMS Installation1254094
-Node: VMS Compilation1254813
-Ref: VMS Compilation-Footnote-11256042
-Node: VMS Dynamic Extensions1256100
-Node: VMS Installation Details1257785
-Node: VMS Running1260047
-Node: VMS GNV1264326
-Node: Bugs1265040
-Node: Bug definition1265920
-Node: Bug address1268424
-Node: Usenet1271812
-Node: Performance bugs1272821
-Node: Asking for help1275742
-Node: Maintainers1277704
-Node: Other Versions1278898
-Node: Installation summary1286750
-Node: Notes1288114
-Node: Compatibility Mode1288908
-Node: Additions1289690
-Node: Accessing The Source1290615
-Node: Adding Code1292052
-Node: New Ports1298271
-Node: Derived Files1302646
-Ref: Derived Files-Footnote-11308306
-Ref: Derived Files-Footnote-21308341
-Ref: Derived Files-Footnote-31308939
-Node: Future Extensions1309053
-Node: Implementation Limitations1309711
-Node: Extension Design1310921
-Node: Old Extension Problems1312065
-Ref: Old Extension Problems-Footnote-11313583
-Node: Extension New Mechanism Goals1313640
-Ref: Extension New Mechanism Goals-Footnote-11317004
-Node: Extension Other Design Decisions1317193
-Node: Extension Future Growth1319306
-Node: Notes summary1319912
-Node: Basic Concepts1321070
-Node: Basic High Level1321751
-Ref: figure-general-flow1322033
-Ref: figure-process-flow1322718
-Ref: Basic High Level-Footnote-11326019
-Node: Basic Data Typing1326204
-Node: Glossary1329532
-Node: Copying1361417
-Node: GNU Free Documentation License1398960
-Node: Index1424080
+Node: Foreword345252
+Node: Foreword449694
+Node: Preface51226
+Ref: Preface-Footnote-154085
+Ref: Preface-Footnote-254194
+Ref: Preface-Footnote-354428
+Node: History54570
+Node: Names56922
+Ref: Names-Footnote-158026
+Node: This Manual58173
+Ref: This Manual-Footnote-164812
+Node: Conventions64912
+Node: Manual History67281
+Ref: Manual History-Footnote-170278
+Ref: Manual History-Footnote-270319
+Node: How To Contribute70393
+Node: Acknowledgments71319
+Node: Getting Started76256
+Node: Running gawk78695
+Node: One-shot79885
+Node: Read Terminal81148
+Node: Long83141
+Node: Executable Scripts84654
+Ref: Executable Scripts-Footnote-187287
+Node: Comments87390
+Node: Quoting89874
+Node: DOS Quoting95400
+Node: Sample Data Files97456
+Node: Very Simple100051
+Node: Two Rules106153
+Node: More Complex108038
+Node: Statements/Lines110370
+Ref: Statements/Lines-Footnote-1114854
+Node: Other Features115119
+Node: When116055
+Ref: When-Footnote-1117809
+Node: Intro Summary117874
+Node: Invoking Gawk118758
+Node: Command Line120272
+Node: Options121070
+Ref: Options-Footnote-1138984
+Ref: Options-Footnote-2139215
+Node: Other Arguments139240
+Node: Naming Standard Input143251
+Node: Environment Variables144461
+Node: AWKPATH Variable145019
+Ref: AWKPATH Variable-Footnote-1148431
+Ref: AWKPATH Variable-Footnote-2148465
+Node: AWKLIBPATH Variable148836
+Ref: AWKLIBPATH Variable-Footnote-1150533
+Node: Other Environment Variables150908
+Node: Exit Status154729
+Node: Include Files155406
+Node: Loading Shared Libraries159096
+Node: Obsolete160524
+Node: Undocumented161216
+Node: Invoking Summary161513
+Node: Regexp164354
+Node: Regexp Usage165808
+Node: Escape Sequences167845
+Node: Regexp Operators174086
+Node: Regexp Operator Details174571
+Ref: Regexp Operator Details-Footnote-1181935
+Node: Interval Expressions182082
+Ref: Interval Expressions-Footnote-1184282
+Node: Bracket Expressions184380
+Ref: table-char-classes186856
+Node: Leftmost Longest190182
+Node: Computed Regexps191485
+Node: GNU Regexp Operators194912
+Node: Case-sensitivity198649
+Ref: Case-sensitivity-Footnote-1201515
+Ref: Case-sensitivity-Footnote-2201750
+Node: Regexp Summary201858
+Node: Reading Files203324
+Node: Records205593
+Node: awk split records206668
+Node: gawk split records211368
+Ref: gawk split records-Footnote-1216442
+Node: Fields216479
+Node: Nonconstant Fields219220
+Ref: Nonconstant Fields-Footnote-1221456
+Node: Changing Fields221660
+Node: Field Separators227691
+Node: Default Field Splitting230389
+Node: Regexp Field Splitting231507
+Node: Single Character Fields235184
+Node: Command Line Field Separator236244
+Node: Full Line Fields239462
+Ref: Full Line Fields-Footnote-1240984
+Ref: Full Line Fields-Footnote-2241030
+Node: Field Splitting Summary241131
+Node: Constant Size243205
+Node: Fixed width data243937
+Node: Skipping intervening247404
+Node: Allowing trailing data248202
+Node: Fields with fixed data249239
+Node: Splitting By Content250757
+Ref: Splitting By Content-Footnote-1254540
+Node: More CSV254703
+Node: Testing field creation256295
+Node: Multiple Line257920
+Node: Getline264197
+Node: Plain Getline266666
+Node: Getline/Variable269239
+Node: Getline/File270390
+Node: Getline/Variable/File271778
+Ref: Getline/Variable/File-Footnote-1273383
+Node: Getline/Pipe273471
+Node: Getline/Variable/Pipe276175
+Node: Getline/Coprocess277310
+Node: Getline/Variable/Coprocess278577
+Node: Getline Notes279319
+Node: Getline Summary282116
+Ref: table-getline-variants282540
+Node: Read Timeout283288
+Ref: Read Timeout-Footnote-1287194
+Node: Retrying Input287252
+Node: Command-line directories288451
+Node: Input Summary289357
+Node: Input Exercises292529
+Node: Printing292963
+Node: Print294797
+Node: Print Examples296254
+Node: Output Separators299034
+Node: OFMT301051
+Node: Printf302407
+Node: Basic Printf303192
+Node: Control Letters304766
+Node: Format Modifiers309930
+Node: Printf Examples315945
+Node: Redirection318431
+Node: Special FD325272
+Ref: Special FD-Footnote-1328440
+Node: Special Files328514
+Node: Other Inherited Files329131
+Node: Special Network330132
+Node: Special Caveats330992
+Node: Close Files And Pipes331941
+Ref: table-close-pipe-return-values338848
+Ref: Close Files And Pipes-Footnote-1339661
+Ref: Close Files And Pipes-Footnote-2339809
+Node: Nonfatal339961
+Node: Output Summary342299
+Node: Output Exercises343521
+Node: Expressions344200
+Node: Values345388
+Node: Constants346066
+Node: Scalar Constants346757
+Ref: Scalar Constants-Footnote-1349267
+Node: Nondecimal-numbers349517
+Node: Regexp Constants352518
+Node: Using Constant Regexps353044
+Node: Standard Regexp Constants353666
+Node: Strong Regexp Constants356854
+Node: Variables360278
+Node: Using Variables360935
+Node: Assignment Options362845
+Node: Conversion365316
+Node: Strings And Numbers365840
+Ref: Strings And Numbers-Footnote-1368903
+Node: Locale influences conversions369012
+Ref: table-locale-affects371770
+Node: All Operators372388
+Node: Arithmetic Ops373017
+Node: Concatenation375733
+Ref: Concatenation-Footnote-1378580
+Node: Assignment Ops378687
+Ref: table-assign-ops383678
+Node: Increment Ops384991
+Node: Truth Values and Conditions388451
+Node: Truth Values389525
+Node: Typing and Comparison390573
+Node: Variable Typing391393
+Ref: Variable Typing-Footnote-1397856
+Ref: Variable Typing-Footnote-2397928
+Node: Comparison Operators398005
+Ref: table-relational-ops398424
+Node: POSIX String Comparison401919
+Ref: POSIX String Comparison-Footnote-1403614
+Ref: POSIX String Comparison-Footnote-2403753
+Node: Boolean Ops403837
+Ref: Boolean Ops-Footnote-1408319
+Node: Conditional Exp408411
+Node: Function Calls410147
+Node: Precedence414024
+Node: Locales417683
+Node: Expressions Summary419315
+Node: Patterns and Actions421888
+Node: Pattern Overview423008
+Node: Regexp Patterns424685
+Node: Expression Patterns425227
+Node: Ranges429008
+Node: BEGIN/END432116
+Node: Using BEGIN/END432877
+Ref: Using BEGIN/END-Footnote-1435631
+Node: I/O And BEGIN/END435737
+Node: BEGINFILE/ENDFILE438050
+Node: Empty441281
+Node: Using Shell Variables441598
+Node: Action Overview443872
+Node: Statements446197
+Node: If Statement448045
+Node: While Statement449540
+Node: Do Statement451568
+Node: For Statement452716
+Node: Switch Statement455887
+Node: Break Statement458328
+Node: Continue Statement460420
+Node: Next Statement462247
+Node: Nextfile Statement464630
+Node: Exit Statement467319
+Node: Built-in Variables469722
+Node: User-modified470855
+Node: Auto-set478622
+Ref: Auto-set-Footnote-1495429
+Ref: Auto-set-Footnote-2495635
+Node: ARGC and ARGV495691
+Node: Pattern Action Summary499904
+Node: Arrays502334
+Node: Array Basics503663
+Node: Array Intro504507
+Ref: figure-array-elements506482
+Ref: Array Intro-Footnote-1509186
+Node: Reference to Elements509314
+Node: Assigning Elements511778
+Node: Array Example512269
+Node: Scanning an Array514028
+Node: Controlling Scanning517050
+Ref: Controlling Scanning-Footnote-1523506
+Node: Numeric Array Subscripts523822
+Node: Uninitialized Subscripts526006
+Node: Delete527625
+Ref: Delete-Footnote-1530377
+Node: Multidimensional530434
+Node: Multiscanning533529
+Node: Arrays of Arrays535120
+Node: Arrays Summary539888
+Node: Functions541981
+Node: Built-in543019
+Node: Calling Built-in544100
+Node: Numeric Functions546096
+Ref: Numeric Functions-Footnote-1550124
+Ref: Numeric Functions-Footnote-2550772
+Ref: Numeric Functions-Footnote-3550820
+Node: String Functions551092
+Ref: String Functions-Footnote-1575607
+Ref: String Functions-Footnote-2575735
+Ref: String Functions-Footnote-3575983
+Node: Gory Details576070
+Ref: table-sub-escapes577861
+Ref: table-sub-proposed579380
+Ref: table-posix-sub580743
+Ref: table-gensub-escapes582284
+Ref: Gory Details-Footnote-1583107
+Node: I/O Functions583261
+Ref: table-system-return-values589715
+Ref: I/O Functions-Footnote-1591795
+Ref: I/O Functions-Footnote-2591943
+Node: Time Functions592063
+Ref: Time Functions-Footnote-1602734
+Ref: Time Functions-Footnote-2602802
+Ref: Time Functions-Footnote-3602960
+Ref: Time Functions-Footnote-4603071
+Ref: Time Functions-Footnote-5603183
+Ref: Time Functions-Footnote-6603410
+Node: Bitwise Functions603676
+Ref: table-bitwise-ops604270
+Ref: Bitwise Functions-Footnote-1610333
+Ref: Bitwise Functions-Footnote-2610506
+Node: Type Functions610697
+Node: I18N Functions613560
+Node: User-defined615211
+Node: Definition Syntax616023
+Ref: Definition Syntax-Footnote-1621717
+Node: Function Example621788
+Ref: Function Example-Footnote-1624710
+Node: Function Calling624732
+Node: Calling A Function625320
+Node: Variable Scope626278
+Node: Pass By Value/Reference629272
+Node: Function Caveats631916
+Ref: Function Caveats-Footnote-1633963
+Node: Return Statement634083
+Node: Dynamic Typing637062
+Node: Indirect Calls637992
+Ref: Indirect Calls-Footnote-1648244
+Node: Functions Summary648372
+Node: Library Functions651077
+Ref: Library Functions-Footnote-1654684
+Ref: Library Functions-Footnote-2654827
+Node: Library Names654998
+Ref: Library Names-Footnote-1658665
+Ref: Library Names-Footnote-2658888
+Node: General Functions658974
+Node: Strtonum Function660156
+Node: Assert Function663178
+Node: Round Function666504
+Node: Cliff Random Function668044
+Node: Ordinal Functions669060
+Ref: Ordinal Functions-Footnote-1672123
+Ref: Ordinal Functions-Footnote-2672375
+Node: Join Function672585
+Ref: Join Function-Footnote-1674355
+Node: Getlocaltime Function674555
+Node: Readfile Function678297
+Node: Shell Quoting680274
+Node: Isnumeric Function681702
+Node: Data File Management683090
+Node: Filetrans Function683722
+Node: Rewind Function687818
+Node: File Checking689727
+Ref: File Checking-Footnote-1691061
+Node: Empty Files691262
+Node: Ignoring Assigns693241
+Node: Getopt Function694791
+Ref: Getopt Function-Footnote-1710014
+Node: Passwd Functions710214
+Ref: Passwd Functions-Footnote-1719053
+Node: Group Functions719141
+Ref: Group Functions-Footnote-1727039
+Node: Walking Arrays727246
+Node: Library Functions Summary730254
+Node: Library Exercises731660
+Node: Sample Programs732125
+Node: Running Examples732895
+Node: Clones733623
+Node: Cut Program734847
+Node: Egrep Program744987
+Node: Id Program753988
+Node: Split Program763935
+Ref: Split Program-Footnote-1773828
+Node: Tee Program774001
+Node: Uniq Program776791
+Node: Wc Program784379
+Node: Bytes vs. Characters784766
+Node: Using extensions786314
+Node: wc program787068
+Node: Miscellaneous Programs791933
+Node: Dupword Program793146
+Node: Alarm Program795176
+Node: Translate Program800031
+Ref: Translate Program-Footnote-1804596
+Node: Labels Program804866
+Ref: Labels Program-Footnote-1808217
+Node: Word Sorting808301
+Node: History Sorting812373
+Node: Extract Program814598
+Node: Simple Sed822652
+Node: Igawk Program825726
+Ref: Igawk Program-Footnote-1840057
+Ref: Igawk Program-Footnote-2840259
+Ref: Igawk Program-Footnote-3840381
+Node: Anagram Program840496
+Node: Signature Program843558
+Node: Programs Summary844805
+Node: Programs Exercises846019
+Ref: Programs Exercises-Footnote-1850149
+Node: Advanced Features850235
+Node: Nondecimal Data852302
+Node: Array Sorting853893
+Node: Controlling Array Traversal854593
+Ref: Controlling Array Traversal-Footnote-1862961
+Node: Array Sorting Functions863079
+Ref: Array Sorting Functions-Footnote-1868453
+Node: Two-way I/O868649
+Ref: Two-way I/O-Footnote-1876375
+Ref: Two-way I/O-Footnote-2876562
+Node: TCP/IP Networking876644
+Node: Profiling879762
+Node: Extension Philosophy889071
+Node: Advanced Features Summary890550
+Node: Internationalization892565
+Node: I18N and L10N894239
+Node: Explaining gettext894926
+Ref: Explaining gettext-Footnote-1900818
+Ref: Explaining gettext-Footnote-2901003
+Node: Programmer i18n901168
+Ref: Programmer i18n-Footnote-1906117
+Node: Translator i18n906166
+Node: String Extraction906960
+Ref: String Extraction-Footnote-1908092
+Node: Printf Ordering908178
+Ref: Printf Ordering-Footnote-1910964
+Node: I18N Portability911028
+Ref: I18N Portability-Footnote-1913484
+Node: I18N Example913547
+Ref: I18N Example-Footnote-1916822
+Ref: I18N Example-Footnote-2916895
+Node: Gawk I18N917004
+Node: I18N Summary917653
+Node: Debugger918994
+Node: Debugging919994
+Node: Debugging Concepts920435
+Node: Debugging Terms922244
+Node: Awk Debugging924819
+Ref: Awk Debugging-Footnote-1925764
+Node: Sample Debugging Session925896
+Node: Debugger Invocation926430
+Node: Finding The Bug927816
+Node: List of Debugger Commands934290
+Node: Breakpoint Control935623
+Node: Debugger Execution Control939317
+Node: Viewing And Changing Data942679
+Node: Execution Stack946220
+Node: Debugger Info947857
+Node: Miscellaneous Debugger Commands951928
+Node: Readline Support956990
+Node: Limitations957886
+Node: Debugging Summary960440
+Node: Namespaces961719
+Node: Global Namespace962830
+Node: Qualified Names964228
+Node: Default Namespace965227
+Node: Changing The Namespace965968
+Node: Naming Rules967582
+Node: Internal Name Management969430
+Node: Namespace Example970472
+Node: Namespace And Features973034
+Node: Namespace Summary974469
+Node: Arbitrary Precision Arithmetic975946
+Node: Computer Arithmetic977433
+Ref: table-numeric-ranges981199
+Ref: table-floating-point-ranges981692
+Ref: Computer Arithmetic-Footnote-1982350
+Node: Math Definitions982407
+Ref: table-ieee-formats985723
+Ref: Math Definitions-Footnote-1986326
+Node: MPFR features986431
+Node: FP Math Caution988149
+Ref: FP Math Caution-Footnote-1989221
+Node: Inexactness of computations989590
+Node: Inexact representation990550
+Node: Comparing FP Values991910
+Node: Errors accumulate993151
+Node: Getting Accuracy994584
+Node: Try To Round997294
+Node: Setting precision998193
+Ref: table-predefined-precision-strings998890
+Node: Setting the rounding mode1000720
+Ref: table-gawk-rounding-modes1001094
+Ref: Setting the rounding mode-Footnote-11005025
+Node: Arbitrary Precision Integers1005204
+Ref: Arbitrary Precision Integers-Footnote-11008379
+Node: Checking for MPFR1008528
+Node: POSIX Floating Point Problems1010002
+Ref: POSIX Floating Point Problems-Footnote-11014287
+Node: Floating point summary1014325
+Node: Dynamic Extensions1016515
+Node: Extension Intro1018068
+Node: Plugin License1019334
+Node: Extension Mechanism Outline1020131
+Ref: figure-load-extension1020570
+Ref: figure-register-new-function1022135
+Ref: figure-call-new-function1023227
+Node: Extension API Description1025289
+Node: Extension API Functions Introduction1027002
+Ref: table-api-std-headers1028838
+Node: General Data Types1033087
+Ref: General Data Types-Footnote-11041717
+Node: Memory Allocation Functions1042016
+Ref: Memory Allocation Functions-Footnote-11046517
+Node: Constructor Functions1046616
+Node: API Ownership of MPFR and GMP Values1050082
+Node: Registration Functions1051395
+Node: Extension Functions1052095
+Node: Exit Callback Functions1057417
+Node: Extension Version String1058667
+Node: Input Parsers1059330
+Node: Output Wrappers1072051
+Node: Two-way processors1076563
+Node: Printing Messages1078828
+Ref: Printing Messages-Footnote-11079999
+Node: Updating ERRNO1080152
+Node: Requesting Values1080891
+Ref: table-value-types-returned1081628
+Node: Accessing Parameters1082564
+Node: Symbol Table Access1083801
+Node: Symbol table by name1084313
+Ref: Symbol table by name-Footnote-11087337
+Node: Symbol table by cookie1087465
+Ref: Symbol table by cookie-Footnote-11091650
+Node: Cached values1091714
+Ref: Cached values-Footnote-11095250
+Node: Array Manipulation1095403
+Ref: Array Manipulation-Footnote-11096494
+Node: Array Data Types1096531
+Ref: Array Data Types-Footnote-11099189
+Node: Array Functions1099281
+Node: Flattening Arrays1103779
+Node: Creating Arrays1110755
+Node: Redirection API1115522
+Node: Extension API Variables1118355
+Node: Extension Versioning1119066
+Ref: gawk-api-version1119495
+Node: Extension GMP/MPFR Versioning1121226
+Node: Extension API Informational Variables1122854
+Node: Extension API Boilerplate1123927
+Node: Changes from API V11127901
+Node: Finding Extensions1129473
+Node: Extension Example1130032
+Node: Internal File Description1130830
+Node: Internal File Ops1134910
+Ref: Internal File Ops-Footnote-11146260
+Node: Using Internal File Ops1146400
+Ref: Using Internal File Ops-Footnote-11148783
+Node: Extension Samples1149057
+Node: Extension Sample File Functions1150586
+Node: Extension Sample Fnmatch1158235
+Node: Extension Sample Fork1159722
+Node: Extension Sample Inplace1160940
+Node: Extension Sample Ord1164566
+Node: Extension Sample Readdir1165402
+Ref: table-readdir-file-types1166291
+Node: Extension Sample Revout1167358
+Node: Extension Sample Rev2way1167947
+Node: Extension Sample Read write array1168687
+Node: Extension Sample Readfile1170629
+Node: Extension Sample Time1171724
+Node: Extension Sample API Tests1173476
+Node: gawkextlib1173968
+Node: Extension summary1176886
+Node: Extension Exercises1180588
+Node: Language History1181830
+Node: V7/SVR3.11183486
+Node: SVR41185638
+Node: POSIX1187072
+Node: BTL1188453
+Node: POSIX/GNU1189182
+Node: Feature History1194960
+Node: Common Extensions1212135
+Node: Ranges and Locales1213418
+Ref: Ranges and Locales-Footnote-11218034
+Ref: Ranges and Locales-Footnote-21218061
+Ref: Ranges and Locales-Footnote-31218296
+Node: Contributors1218519
+Node: History summary1224516
+Node: Installation1225896
+Node: Gawk Distribution1226840
+Node: Getting1227324
+Node: Extracting1228287
+Node: Distribution contents1229925
+Node: Unix Installation1236405
+Node: Quick Installation1237209
+Node: Compiling with MPFR1239685
+Node: Shell Startup Files1240377
+Node: Additional Configuration Options1241466
+Node: Configuration Philosophy1243781
+Node: Compiling from Git1246177
+Node: Building the Documentation1246732
+Node: Non-Unix Installation1247654
+Node: PC Installation1248114
+Node: PC Binary Installation1248952
+Node: PC Compiling1249387
+Node: PC Using1250504
+Node: Cygwin1254057
+Node: MSYS1255281
+Node: VMS Installation1255883
+Node: VMS Compilation1256602
+Ref: VMS Compilation-Footnote-11257831
+Node: VMS Dynamic Extensions1257889
+Node: VMS Installation Details1259574
+Node: VMS Running1261836
+Node: VMS GNV1266115
+Node: Bugs1266829
+Node: Bug definition1267741
+Node: Bug address1270245
+Node: Usenet1273633
+Node: Performance bugs1274642
+Node: Asking for help1277563
+Node: Maintainers1279525
+Node: Other Versions1280719
+Node: Installation summary1288571
+Node: Notes1289935
+Node: Compatibility Mode1290729
+Node: Additions1291511
+Node: Accessing The Source1292436
+Node: Adding Code1293873
+Node: New Ports1300092
+Node: Derived Files1304467
+Ref: Derived Files-Footnote-11310127
+Ref: Derived Files-Footnote-21310162
+Ref: Derived Files-Footnote-31310760
+Node: Future Extensions1310874
+Node: Implementation Limitations1311532
+Node: Extension Design1312742
+Node: Old Extension Problems1313886
+Ref: Old Extension Problems-Footnote-11315404
+Node: Extension New Mechanism Goals1315461
+Ref: Extension New Mechanism Goals-Footnote-11318825
+Node: Extension Other Design Decisions1319014
+Node: Extension Future Growth1321127
+Node: Notes summary1321733
+Node: Basic Concepts1322891
+Node: Basic High Level1323572
+Ref: figure-general-flow1323854
+Ref: figure-process-flow1324539
+Ref: Basic High Level-Footnote-11327840
+Node: Basic Data Typing1328025
+Node: Glossary1331353
+Node: Copying1363238
+Node: GNU Free Documentation License1400781
+Node: Index1425901
End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 8470790..a3745eb 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -59,9 +59,9 @@
@c applies to and all the info about who's publishing this edition
@c These apply across the board.
-@set UPDATE-MONTH July, 2021
+@set UPDATE-MONTH September, 2021
@set VERSION 5.1
-@set PATCHLEVEL 0
+@set PATCHLEVEL 1
@set GAWKINETTITLE TCP/IP Internetworking with @command{gawk}
@ifset FOR_PRINT
@@ -808,8 +808,8 @@ particular records in a file and perform operations upon
them.
once.
* Shell Quoting:: A function to quote strings for the
shell.
-* Isnumeric Function:: A function to test whether a value
- is numeric.
+* Isnumeric Function:: A function to test whether a value is
+ numeric.
* Data File Management:: Functions for managing command-line
data files.
* Filetrans Function:: A function for handling data file
@@ -1033,6 +1033,8 @@ particular records in a file and perform operations upon
them.
* Shell Startup Files:: Shell convenience functions.
* Additional Configuration Options:: Other compile-time options.
* Configuration Philosophy:: How it's all supposed to work.
+* Compiling from Git:: Compiling from Git.
+* Building the Documentation:: Building the Documentation.
* Non-Unix Installation:: Installation on Other Operating
Systems.
* PC Installation:: Installing and Compiling
@@ -1058,7 +1060,8 @@ particular records in a file and perform operations upon
them.
* Bug definition:: Defining what is and is not a bug.
* Bug address:: Where to send reports to.
* Usenet:: Where not to send reports to.
-* Performance bugs:: What to do if you think there is a
performance issue.
+* Performance bugs:: What to do if you think there is a
+ performance issue.
* Asking for help:: Dealing with non-bug questions.
* Maintainers:: Maintainers of non-*nix ports.
* Other Versions:: Other freely available @command{awk}
@@ -41943,13 +41946,15 @@ to configure @command{gawk} for your system yourself.
* Shell Startup Files:: Shell convenience functions.
* Additional Configuration Options:: Other compile-time options.
* Configuration Philosophy:: How it's all supposed to work.
+* Compiling from Git:: Compiling from Git.
+* Building the Documentation:: Building the Documentation.
@end menu
@node Quick Installation
@appendixsubsec Compiling @command{gawk} for Unix-Like Systems
@menu
-* Compiling with MPFR:: Building with MPFR.
+* Compiling with MPFR:: Building with MPFR.
@end menu
The normal installation steps should work on all modern commercial
@@ -42208,6 +42213,43 @@ for information on how to report problems in
configuring @command{gawk}).
The same mechanism may be used to send in updates to @file{configure.ac}
and/or @file{custom.h}.
+@node Compiling from Git
+@appendixsubsec Compiling from Git
+
+Building @command{gawk} directly from the development source control
+repository is possible, but not recommended for everyday users, as the
+code may not be as stable as released versions are. If you really do
+want to do that, here are the steps:
+
+@example
+git clone https://git.savannah.gnu.org/r/gawk.git
+cd gawk
+./bootstrap.sh && ./configure && make && make check
+@end example
+
+@node Building the Documentation
+@appendixsubsec Building the Documentation
+
+The Info documentation is included in the distribution tar files and in
+Git; you should not need to rebuild it. However, if it needs to be done,
+simply running @command{make} will do it, assuming that you have a recent
+enough version of @command{makeinfo} installed.
+
+If you wish to build the PDF version of the manual, you will need to
+have @TeX{} installed, and possibly additional packages that provide the
+necessary fonts and tools, such as @command{ps2pdf}. You will also need
+GNU Troff (@command{groff}) installed in order to format the reference
+card and the manual page. Managing this process is beyond the scope of
+this @value{DOCUMENT}.
+
+Assuming you have all you need, then the following commands produce the
+PDF versions of the documentation:
+
+@example
+cd doc
+make pdf
+@end example
+
@node Non-Unix Installation
@appendixsec Installation on Other Operating Systems
@@ -42786,7 +42828,8 @@ but we might well want to fix it.
* Bug definition:: Defining what is and is not a bug.
* Bug address:: Where to send reports to.
* Usenet:: Where not to send reports to.
-* Performance bugs:: What to do if you think there is a performance
issue.
+* Performance bugs:: What to do if you think there is a performance
+ issue.
* Asking for help:: Dealing with non-bug questions.
* Maintainers:: Maintainers of non-*nix ports.
@end menu
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 9513cf1..d915efd 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -54,9 +54,9 @@
@c applies to and all the info about who's publishing this edition
@c These apply across the board.
-@set UPDATE-MONTH July, 2021
+@set UPDATE-MONTH September, 2021
@set VERSION 5.1
-@set PATCHLEVEL 0
+@set PATCHLEVEL 1
@set GAWKINETTITLE TCP/IP Internetworking with @command{gawk}
@ifset FOR_PRINT
@@ -803,8 +803,8 @@ particular records in a file and perform operations upon
them.
once.
* Shell Quoting:: A function to quote strings for the
shell.
-* Isnumeric Function:: A function to test whether a value
- is numeric.
+* Isnumeric Function:: A function to test whether a value is
+ numeric.
* Data File Management:: Functions for managing command-line
data files.
* Filetrans Function:: A function for handling data file
@@ -1028,6 +1028,8 @@ particular records in a file and perform operations upon
them.
* Shell Startup Files:: Shell convenience functions.
* Additional Configuration Options:: Other compile-time options.
* Configuration Philosophy:: How it's all supposed to work.
+* Compiling from Git:: Compiling from Git.
+* Building the Documentation:: Building the Documentation.
* Non-Unix Installation:: Installation on Other Operating
Systems.
* PC Installation:: Installing and Compiling
@@ -1053,7 +1055,8 @@ particular records in a file and perform operations upon
them.
* Bug definition:: Defining what is and is not a bug.
* Bug address:: Where to send reports to.
* Usenet:: Where not to send reports to.
-* Performance bugs:: What to do if you think there is a
performance issue.
+* Performance bugs:: What to do if you think there is a
+ performance issue.
* Asking for help:: Dealing with non-bug questions.
* Maintainers:: Maintainers of non-*nix ports.
* Other Versions:: Other freely available @command{awk}
@@ -40786,13 +40789,15 @@ to configure @command{gawk} for your system yourself.
* Shell Startup Files:: Shell convenience functions.
* Additional Configuration Options:: Other compile-time options.
* Configuration Philosophy:: How it's all supposed to work.
+* Compiling from Git:: Compiling from Git.
+* Building the Documentation:: Building the Documentation.
@end menu
@node Quick Installation
@appendixsubsec Compiling @command{gawk} for Unix-Like Systems
@menu
-* Compiling with MPFR:: Building with MPFR.
+* Compiling with MPFR:: Building with MPFR.
@end menu
The normal installation steps should work on all modern commercial
@@ -41051,6 +41056,43 @@ for information on how to report problems in
configuring @command{gawk}).
The same mechanism may be used to send in updates to @file{configure.ac}
and/or @file{custom.h}.
+@node Compiling from Git
+@appendixsubsec Compiling from Git
+
+Building @command{gawk} directly from the development source control
+repository is possible, but not recommended for everyday users, as the
+code may not be as stable as released versions are. If you really do
+want to do that, here are the steps:
+
+@example
+git clone https://git.savannah.gnu.org/r/gawk.git
+cd gawk
+./bootstrap.sh && ./configure && make && make check
+@end example
+
+@node Building the Documentation
+@appendixsubsec Building the Documentation
+
+The Info documentation is included in the distribution tar files and in
+Git; you should not need to rebuild it. However, if it needs to be done,
+simply running @command{make} will do it, assuming that you have a recent
+enough version of @command{makeinfo} installed.
+
+If you wish to build the PDF version of the manual, you will need to
+have @TeX{} installed, and possibly additional packages that provide the
+necessary fonts and tools, such as @command{ps2pdf}. You will also need
+GNU Troff (@command{groff}) installed in order to format the reference
+card and the manual page. Managing this process is beyond the scope of
+this @value{DOCUMENT}.
+
+Assuming you have all you need, then the following commands produce the
+PDF versions of the documentation:
+
+@example
+cd doc
+make pdf
+@end example
+
@node Non-Unix Installation
@appendixsec Installation on Other Operating Systems
@@ -41629,7 +41671,8 @@ but we might well want to fix it.
* Bug definition:: Defining what is and is not a bug.
* Bug address:: Where to send reports to.
* Usenet:: Where not to send reports to.
-* Performance bugs:: What to do if you think there is a performance
issue.
+* Performance bugs:: What to do if you think there is a performance
+ issue.
* Asking for help:: Dealing with non-bug questions.
* Maintainers:: Maintainers of non-*nix ports.
@end menu
-----------------------------------------------------------------------
Summary of changes:
doc/ChangeLog | 7 +
doc/awkcard.in | 2 +-
doc/gawk.info | 1289 ++++++++++++++++++++++++++++---------------------------
doc/gawk.texi | 57 ++-
doc/gawktexi.in | 57 ++-
5 files changed, 776 insertions(+), 636 deletions(-)
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [SCM] gawk branch, gawk-5.1-stable, updated. gawk-4.1.0-4307-gb5a955b,
Arnold Robbins <=