Merge branch 'gawk-4.1-stable'

4 files changed, 237 insertions, 221 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 70fa1abd..c5a60fb9 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2015-02-20         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in: More O'Reilly fixes. I think it's done!
+
 2015-02-19         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in: More O'Reilly fixes.
diff --git a/doc/gawk.info b/doc/gawk.info
index 012d95a9..6f5c0095 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -1874,7 +1874,7 @@ file surrounded by double quotes:
 
 File: gawk.info,  Node: Sample Data Files,  Next: Very Simple,  Prev: Running gawk,  Up: Getting Started
 
-1.2 Data Files for the Examples
+1.2 Data files for the Examples
 ===============================
 
 Many of the examples in this Info file take their input from two sample
@@ -6958,7 +6958,7 @@ option (*note Options::).
 
 File: gawk.info,  Node: Special Files,  Next: Close Files And Pipes,  Prev: Special FD,  Up: Printing
 
-5.8 Special File Names in `gawk'
+5.8 Special File names in `gawk'
 ================================
 
 Besides access to standard input, standard output, and standard error,
@@ -7019,7 +7019,7 @@ mentioned here only for completeness.  Full discussion is delayed until
 
 File: gawk.info,  Node: Special Caveats,  Prev: Special Network,  Up: Special Files
 
-5.8.3 Special File Name Caveats
+5.8.3 Special File name Caveats
 -------------------------------
 
 Here are some things to bear in mind when using the special file names
@@ -15185,7 +15185,7 @@ three-character string `"\"'\""':
 
 File: gawk.info,  Node: Data File Management,  Next: Getopt Function,  Prev: General Functions,  Up: Library Functions
 
-10.3 Data File Management
+10.3 Data file Management
 =========================
 
 This minor node presents functions that are useful for managing
@@ -15202,7 +15202,7 @@ command-line data files.
 
 File: gawk.info,  Node: Filetrans Function,  Next: Rewind Function,  Up: Data File Management
 
-10.3.1 Noting Data File Boundaries
+10.3.1 Noting Data file Boundaries
 ----------------------------------
 
 The `BEGIN' and `END' rules are each executed exactly once, at the
@@ -15340,7 +15340,7 @@ rule finishes!)
 
 File: gawk.info,  Node: File Checking,  Next: Empty Files,  Prev: Rewind Function,  Up: Data File Management
 
-10.3.3 Checking for Readable Data Files
+10.3.3 Checking for Readable Data files
 ---------------------------------------
 
 Normally, if you give `awk' a data file that isn't readable, it stops
@@ -15430,7 +15430,7 @@ of the `for' loop uses the `<=' operator, not `<'.
 
 File: gawk.info,  Node: Ignoring Assigns,  Prev: Empty Files,  Up: Data File Management
 
-10.3.5 Treating Assignments as File Names
+10.3.5 Treating Assignments as File names
 -----------------------------------------
 
 Occasionally, you might not want `awk' to process command-line variable
@@ -22677,9 +22677,9 @@ File: gawk.info,  Node: Floating point summary,  Prev: POSIX Floating Point Prob
      using the GMP library.  This is faster and more space-efficient
      than using MPFR for the same calculations.
 
-   * There are several "dark corners" with respect to floating-point
-     numbers where `gawk' disagrees with the POSIX standard.  It pays
-     to be aware of them.
+   * There are several areas with respect to floating-point numbers
+     where `gawk' disagrees with the POSIX standard.  It pays to be
+     aware of them.
 
    * Overall, there is no need to be unduly suspicious about the
      results from floating-point arithmetic. The lesson to remember is
@@ -35079,148 +35079,148 @@ Ref: Arbitrary Precision Integers-Footnote-1910504
 Node: POSIX Floating Point Problems910653
 Ref: POSIX Floating Point Problems-Footnote-1914532
 Node: Floating point summary914570
-Node: Dynamic Extensions916766
-Node: Extension Intro918318
-Node: Plugin License919583
-Node: Extension Mechanism Outline920380
-Ref: figure-load-extension920808
-Ref: figure-register-new-function922288
-Ref: figure-call-new-function923292
-Node: Extension API Description925279
-Node: Extension API Functions Introduction926729
-Node: General Data Types931550
-Ref: General Data Types-Footnote-1937450
-Node: Memory Allocation Functions937749
-Ref: Memory Allocation Functions-Footnote-1940588
-Node: Constructor Functions940687
-Node: Registration Functions942426
-Node: Extension Functions943111
-Node: Exit Callback Functions945408
-Node: Extension Version String946656
-Node: Input Parsers947319
-Node: Output Wrappers957194
-Node: Two-way processors961707
-Node: Printing Messages963970
-Ref: Printing Messages-Footnote-1965046
-Node: Updating `ERRNO'965198
-Node: Requesting Values965938
-Ref: table-value-types-returned966665
-Node: Accessing Parameters967622
-Node: Symbol Table Access968856
-Node: Symbol table by name969370
-Node: Symbol table by cookie971390
-Ref: Symbol table by cookie-Footnote-1975535
-Node: Cached values975598
-Ref: Cached values-Footnote-1979094
-Node: Array Manipulation979185
-Ref: Array Manipulation-Footnote-1980283
-Node: Array Data Types980320
-Ref: Array Data Types-Footnote-1982975
-Node: Array Functions983067
-Node: Flattening Arrays986926
-Node: Creating Arrays993828
-Node: Extension API Variables998599
-Node: Extension Versioning999235
-Node: Extension API Informational Variables1001126
-Node: Extension API Boilerplate1002191
-Node: Finding Extensions1006000
-Node: Extension Example1006560
-Node: Internal File Description1007332
-Node: Internal File Ops1011399
-Ref: Internal File Ops-Footnote-11023150
-Node: Using Internal File Ops1023290
-Ref: Using Internal File Ops-Footnote-11025673
-Node: Extension Samples1025946
-Node: Extension Sample File Functions1027474
-Node: Extension Sample Fnmatch1035155
-Node: Extension Sample Fork1036643
-Node: Extension Sample Inplace1037858
-Node: Extension Sample Ord1039534
-Node: Extension Sample Readdir1040370
-Ref: table-readdir-file-types1041247
-Node: Extension Sample Revout1042058
-Node: Extension Sample Rev2way1042647
-Node: Extension Sample Read write array1043387
-Node: Extension Sample Readfile1045327
-Node: Extension Sample Time1046422
-Node: Extension Sample API Tests1047770
-Node: gawkextlib1048261
-Node: Extension summary1050939
-Node: Extension Exercises1054628
-Node: Language History1055350
-Node: V7/SVR3.11057006
-Node: SVR41059159
-Node: POSIX1060593
-Node: BTL1061974
-Node: POSIX/GNU1062705
-Node: Feature History1068450
-Node: Common Extensions1082176
-Node: Ranges and Locales1083548
-Ref: Ranges and Locales-Footnote-11088167
-Ref: Ranges and Locales-Footnote-21088194
-Ref: Ranges and Locales-Footnote-31088429
-Node: Contributors1088650
-Node: History summary1094190
-Node: Installation1095569
-Node: Gawk Distribution1096515
-Node: Getting1096999
-Node: Extracting1097822
-Node: Distribution contents1099459
-Node: Unix Installation1105561
-Node: Quick Installation1106244
-Node: Shell Startup Files1108655
-Node: Additional Configuration Options1109734
-Node: Configuration Philosophy1111538
-Node: Non-Unix Installation1113907
-Node: PC Installation1114365
-Node: PC Binary Installation1115685
-Node: PC Compiling1117533
-Ref: PC Compiling-Footnote-11120554
-Node: PC Testing1120663
-Node: PC Using1121839
-Node: Cygwin1125954
-Node: MSYS1126724
-Node: VMS Installation1127225
-Node: VMS Compilation1128017
-Ref: VMS Compilation-Footnote-11129246
-Node: VMS Dynamic Extensions1129304
-Node: VMS Installation Details1130988
-Node: VMS Running1133239
-Node: VMS GNV1136079
-Node: VMS Old Gawk1136814
-Node: Bugs1137284
-Node: Other Versions1141173
-Node: Installation summary1147607
-Node: Notes1148666
-Node: Compatibility Mode1149531
-Node: Additions1150313
-Node: Accessing The Source1151238
-Node: Adding Code1152673
-Node: New Ports1158830
-Node: Derived Files1163312
-Ref: Derived Files-Footnote-11168787
-Ref: Derived Files-Footnote-21168821
-Ref: Derived Files-Footnote-31169417
-Node: Future Extensions1169531
-Node: Implementation Limitations1170137
-Node: Extension Design1171385
-Node: Old Extension Problems1172539
-Ref: Old Extension Problems-Footnote-11174056
-Node: Extension New Mechanism Goals1174113
-Ref: Extension New Mechanism Goals-Footnote-11177473
-Node: Extension Other Design Decisions1177662
-Node: Extension Future Growth1179770
-Node: Old Extension Mechanism1180606
-Node: Notes summary1182368
-Node: Basic Concepts1183554
-Node: Basic High Level1184235
-Ref: figure-general-flow1184507
-Ref: figure-process-flow1185106
-Ref: Basic High Level-Footnote-11188335
-Node: Basic Data Typing1188520
-Node: Glossary1191848
-Node: Copying1223777
-Node: GNU Free Documentation License1261333
-Node: Index1286469
+Node: Dynamic Extensions916757
+Node: Extension Intro918309
+Node: Plugin License919574
+Node: Extension Mechanism Outline920371
+Ref: figure-load-extension920799
+Ref: figure-register-new-function922279
+Ref: figure-call-new-function923283
+Node: Extension API Description925270
+Node: Extension API Functions Introduction926720
+Node: General Data Types931541
+Ref: General Data Types-Footnote-1937441
+Node: Memory Allocation Functions937740
+Ref: Memory Allocation Functions-Footnote-1940579
+Node: Constructor Functions940678
+Node: Registration Functions942417
+Node: Extension Functions943102
+Node: Exit Callback Functions945399
+Node: Extension Version String946647
+Node: Input Parsers947310
+Node: Output Wrappers957185
+Node: Two-way processors961698
+Node: Printing Messages963961
+Ref: Printing Messages-Footnote-1965037
+Node: Updating `ERRNO'965189
+Node: Requesting Values965929
+Ref: table-value-types-returned966656
+Node: Accessing Parameters967613
+Node: Symbol Table Access968847
+Node: Symbol table by name969361
+Node: Symbol table by cookie971381
+Ref: Symbol table by cookie-Footnote-1975526
+Node: Cached values975589
+Ref: Cached values-Footnote-1979085
+Node: Array Manipulation979176
+Ref: Array Manipulation-Footnote-1980274
+Node: Array Data Types980311
+Ref: Array Data Types-Footnote-1982966
+Node: Array Functions983058
+Node: Flattening Arrays986917
+Node: Creating Arrays993819
+Node: Extension API Variables998590
+Node: Extension Versioning999226
+Node: Extension API Informational Variables1001117
+Node: Extension API Boilerplate1002182
+Node: Finding Extensions1005991
+Node: Extension Example1006551
+Node: Internal File Description1007323
+Node: Internal File Ops1011390
+Ref: Internal File Ops-Footnote-11023141
+Node: Using Internal File Ops1023281
+Ref: Using Internal File Ops-Footnote-11025664
+Node: Extension Samples1025937
+Node: Extension Sample File Functions1027465
+Node: Extension Sample Fnmatch1035146
+Node: Extension Sample Fork1036634
+Node: Extension Sample Inplace1037849
+Node: Extension Sample Ord1039525
+Node: Extension Sample Readdir1040361
+Ref: table-readdir-file-types1041238
+Node: Extension Sample Revout1042049
+Node: Extension Sample Rev2way1042638
+Node: Extension Sample Read write array1043378
+Node: Extension Sample Readfile1045318
+Node: Extension Sample Time1046413
+Node: Extension Sample API Tests1047761
+Node: gawkextlib1048252
+Node: Extension summary1050930
+Node: Extension Exercises1054619
+Node: Language History1055341
+Node: V7/SVR3.11056997
+Node: SVR41059150
+Node: POSIX1060584
+Node: BTL1061965
+Node: POSIX/GNU1062696
+Node: Feature History1068441
+Node: Common Extensions1082167
+Node: Ranges and Locales1083539
+Ref: Ranges and Locales-Footnote-11088158
+Ref: Ranges and Locales-Footnote-21088185
+Ref: Ranges and Locales-Footnote-31088420
+Node: Contributors1088641
+Node: History summary1094181
+Node: Installation1095560
+Node: Gawk Distribution1096506
+Node: Getting1096990
+Node: Extracting1097813
+Node: Distribution contents1099450
+Node: Unix Installation1105552
+Node: Quick Installation1106235
+Node: Shell Startup Files1108646
+Node: Additional Configuration Options1109725
+Node: Configuration Philosophy1111529
+Node: Non-Unix Installation1113898
+Node: PC Installation1114356
+Node: PC Binary Installation1115676
+Node: PC Compiling1117524
+Ref: PC Compiling-Footnote-11120545
+Node: PC Testing1120654
+Node: PC Using1121830
+Node: Cygwin1125945
+Node: MSYS1126715
+Node: VMS Installation1127216
+Node: VMS Compilation1128008
+Ref: VMS Compilation-Footnote-11129237
+Node: VMS Dynamic Extensions1129295
+Node: VMS Installation Details1130979
+Node: VMS Running1133230
+Node: VMS GNV1136070
+Node: VMS Old Gawk1136805
+Node: Bugs1137275
+Node: Other Versions1141164
+Node: Installation summary1147598
+Node: Notes1148657
+Node: Compatibility Mode1149522
+Node: Additions1150304
+Node: Accessing The Source1151229
+Node: Adding Code1152664
+Node: New Ports1158821
+Node: Derived Files1163303
+Ref: Derived Files-Footnote-11168778
+Ref: Derived Files-Footnote-21168812
+Ref: Derived Files-Footnote-31169408
+Node: Future Extensions1169522
+Node: Implementation Limitations1170128
+Node: Extension Design1171376
+Node: Old Extension Problems1172530
+Ref: Old Extension Problems-Footnote-11174047
+Node: Extension New Mechanism Goals1174104
+Ref: Extension New Mechanism Goals-Footnote-11177464
+Node: Extension Other Design Decisions1177653
+Node: Extension Future Growth1179761
+Node: Old Extension Mechanism1180597
+Node: Notes summary1182359
+Node: Basic Concepts1183545
+Node: Basic High Level1184226
+Ref: figure-general-flow1184498
+Ref: figure-process-flow1185097
+Ref: Basic High Level-Footnote-11188326
+Node: Basic Data Typing1188511
+Node: Glossary1191839
+Node: Copying1223768
+Node: GNU Free Documentation License1261324
+Node: Index1286460
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index d9e19ba1..7c0171da 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -198,9 +198,9 @@
 
 @ifclear FOR_PRINT
 @set FN file name
-@set FFN File Name
+@set FFN File name
 @set DF data file
-@set DDF Data File
+@set DDF Data file
 @set PVERSION version
 @end ifclear
 @ifset FOR_PRINT
@@ -1751,15 +1751,39 @@ and how to compile and use it on different
 non-POSIX systems.  It also describes how to report bugs
 in @command{gawk} and where to get other freely
 available @command{awk} implementations.
-@end itemize
 
 @ifset FOR_PRINT
-@itemize @value{MINUS}
 @item
 @ref{Copying},
 presents the license that covers the @command{gawk} source code.
+@end ifset
+
+@ifclear FOR_PRINT
+@item
+@ref{Notes},
+describes how to disable @command{gawk}'s extensions, as
+well as how to contribute new code to @command{gawk},
+and some possible future directions for @command{gawk} development.
+
+@item
+@ref{Basic Concepts},
+provides some very cursory background material for those who
+are completely unfamiliar with computer programming.
+
+The @ref{Glossary}, defines most, if not all, of the significant terms used
+throughout the @value{DOCUMENT}.  If you find terms that you aren't familiar with,
+try looking them up here.
+
+@item
+@ref{Copying}, and
+@ref{GNU Free Documentation License},
+present the licenses that cover the @command{gawk} source code
+and this @value{DOCUMENT}, respectively.
+@end ifclear
+@end itemize
 @end itemize
 
+@ifset FOR_PRINT
 The version of this @value{DOCUMENT} distributed with @command{gawk}
 contains additional appendices and other end material.
 To save space, we have omitted them from the
@@ -1797,32 +1821,6 @@ Some of the chapters have exercise sections; these have also been
 omitted from the print edition but are available online.
 @end ifset
 
-@ifclear FOR_PRINT
-@itemize @value{MINUS}
-@item
-@ref{Notes},
-describes how to disable @command{gawk}'s extensions, as
-well as how to contribute new code to @command{gawk},
-and some possible future directions for @command{gawk} development.
-
-@item
-@ref{Basic Concepts},
-provides some very cursory background material for those who
-are completely unfamiliar with computer programming.
-
-The @ref{Glossary}, defines most, if not all, of the significant terms used
-throughout the @value{DOCUMENT}.  If you find terms that you aren't familiar with,
-try looking them up here.
-
-@item
-@ref{Copying}, and
-@ref{GNU Free Documentation License},
-present the licenses that cover the @command{gawk} source code
-and this @value{DOCUMENT}, respectively.
-@end itemize
-@end ifclear
-@end itemize
-
 @c FULLXREF OFF
 
 @node Conventions
@@ -1864,15 +1862,23 @@ $ @kbd{echo hello on stderr 1>&2}
 @end example
 
 @ifnotinfo
-In the text, command names appear in @code{this font}, while code segments
+In the text, almost anything related to programming, such as
+command names,
+variable and function names, and string, numeric and regexp constants
+appear in @code{this font}. Code fragments
 appear in the same font and quoted, @samp{like this}.
+Things that are replaced by the user or programmer
+appear in @var{this font}.
 Options look like this: @option{-f}.
+@value{FFN}s are indicated like this: @file{/path/to/ourfile}.
+@ifclear FOR_PRINT
 Some things are
 emphasized @emph{like this}, and if a point needs to be made
-strongly, it is done @strong{like this}.  The first occurrence of
+strongly, it is done @strong{like this}.
+@end ifclear
+The first occurrence of
 a new term is usually its @dfn{definition} and appears in the same
 font as the previous occurrence of ``definition'' in this sentence.
-Finally, @value{FN}s are indicated like this: @file{/path/to/ourfile}.
 @end ifnotinfo
 
 Characters that you type at the keyboard look @kbd{like this}.  In particular,
@@ -31216,7 +31222,7 @@ This is faster and more space-efficient than using MPFR for
 the same calculations.
 
 @item
-There are several ``dark corners'' with respect to floating-point
+There are several areas with respect to floating-point
 numbers where @command{gawk} disagrees with the POSIX standard.
 It pays to be aware of them.
 
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 2a24a374..a7b01dc7 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -193,9 +193,9 @@
 
 @ifclear FOR_PRINT
 @set FN file name
-@set FFN File Name
+@set FFN File name
 @set DF data file
-@set DDF Data File
+@set DDF Data file
 @set PVERSION version
 @end ifclear
 @ifset FOR_PRINT
@@ -1718,15 +1718,39 @@ and how to compile and use it on different
 non-POSIX systems.  It also describes how to report bugs
 in @command{gawk} and where to get other freely
 available @command{awk} implementations.
-@end itemize
 
 @ifset FOR_PRINT
-@itemize @value{MINUS}
 @item
 @ref{Copying},
 presents the license that covers the @command{gawk} source code.
+@end ifset
+
+@ifclear FOR_PRINT
+@item
+@ref{Notes},
+describes how to disable @command{gawk}'s extensions, as
+well as how to contribute new code to @command{gawk},
+and some possible future directions for @command{gawk} development.
+
+@item
+@ref{Basic Concepts},
+provides some very cursory background material for those who
+are completely unfamiliar with computer programming.
+
+The @ref{Glossary}, defines most, if not all, of the significant terms used
+throughout the @value{DOCUMENT}.  If you find terms that you aren't familiar with,
+try looking them up here.
+
+@item
+@ref{Copying}, and
+@ref{GNU Free Documentation License},
+present the licenses that cover the @command{gawk} source code
+and this @value{DOCUMENT}, respectively.
+@end ifclear
+@end itemize
 @end itemize
 
+@ifset FOR_PRINT
 The version of this @value{DOCUMENT} distributed with @command{gawk}
 contains additional appendices and other end material.
 To save space, we have omitted them from the
@@ -1764,32 +1788,6 @@ Some of the chapters have exercise sections; these have also been
 omitted from the print edition but are available online.
 @end ifset
 
-@ifclear FOR_PRINT
-@itemize @value{MINUS}
-@item
-@ref{Notes},
-describes how to disable @command{gawk}'s extensions, as
-well as how to contribute new code to @command{gawk},
-and some possible future directions for @command{gawk} development.
-
-@item
-@ref{Basic Concepts},
-provides some very cursory background material for those who
-are completely unfamiliar with computer programming.
-
-The @ref{Glossary}, defines most, if not all, of the significant terms used
-throughout the @value{DOCUMENT}.  If you find terms that you aren't familiar with,
-try looking them up here.
-
-@item
-@ref{Copying}, and
-@ref{GNU Free Documentation License},
-present the licenses that cover the @command{gawk} source code
-and this @value{DOCUMENT}, respectively.
-@end itemize
-@end ifclear
-@end itemize
-
 @c FULLXREF OFF
 
 @node Conventions
@@ -1831,15 +1829,23 @@ $ @kbd{echo hello on stderr 1>&2}
 @end example
 
 @ifnotinfo
-In the text, command names appear in @code{this font}, while code segments
+In the text, almost anything related to programming, such as
+command names,
+variable and function names, and string, numeric and regexp constants
+appear in @code{this font}. Code fragments
 appear in the same font and quoted, @samp{like this}.
+Things that are replaced by the user or programmer
+appear in @var{this font}.
 Options look like this: @option{-f}.
+@value{FFN}s are indicated like this: @file{/path/to/ourfile}.
+@ifclear FOR_PRINT
 Some things are
 emphasized @emph{like this}, and if a point needs to be made
-strongly, it is done @strong{like this}.  The first occurrence of
+strongly, it is done @strong{like this}.
+@end ifclear
+The first occurrence of
 a new term is usually its @dfn{definition} and appears in the same
 font as the previous occurrence of ``definition'' in this sentence.
-Finally, @value{FN}s are indicated like this: @file{/path/to/ourfile}.
 @end ifnotinfo
 
 Characters that you type at the keyboard look @kbd{like this}.  In particular,
@@ -30307,7 +30313,7 @@ This is faster and more space-efficient than using MPFR for
 the same calculations.
 
 @item
-There are several ``dark corners'' with respect to floating-point
+There are several areas with respect to floating-point
 numbers where @command{gawk} disagrees with the POSIX standard.
 It pays to be aware of them.