Merge branch 'gawk-4.1-stable'

1 files changed, 230 insertions, 227 deletions

diff --git a/doc/gawk.info b/doc/gawk.info
index bc7a1b67..5deb6482 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -16666,6 +16666,8 @@ File: gawk.info,  Node: Alarm Program,  Next: Translate Program,  Prev: Dupword
      Nothing cures insomnia like a ringing alarm clock.  -- Arnold
      Robbins
 
+     Sleep is for web developers.  -- Erik Quanstrom
+
    The following program is a simple "alarm clock" program.  You give
 it a time of day and an optional message.  At the specified time, it
 prints the message on the standard output. In addition, you can give it
@@ -30230,8 +30232,8 @@ Index
                                                               (line  10)
 * Aho, Alfred <1>:                       Contributors.        (line  11)
 * Aho, Alfred:                           History.             (line  17)
-* alarm clock example program:           Alarm Program.       (line   9)
-* alarm.awk program:                     Alarm Program.       (line  29)
+* alarm clock example program:           Alarm Program.       (line  11)
+* alarm.awk program:                     Alarm Program.       (line  31)
 * algorithms:                            Basic High Level.    (line  68)
 * Alpha (DEC):                           Manual History.      (line  28)
 * amazing awk assembler (aaa):           Glossary.            (line  12)
@@ -32115,6 +32117,7 @@ Index
 * q debugger command (alias for quit):   Miscellaneous Debugger Commands.
                                                               (line  99)
 * QSE Awk:                               Other Versions.      (line 130)
+* Quanstrom, Erik:                       Alarm Program.       (line   8)
 * question mark (?) regexp operator <1>: GNU Regexp Operators.
                                                               (line  59)
 * question mark (?) regexp operator:     Regexp Operators.    (line 111)
@@ -32394,7 +32397,7 @@ Index
 * single-character fields:               Single Character Fields.
                                                               (line   6)
 * Skywalker, Luke:                       Undocumented.        (line   6)
-* sleep utility:                         Alarm Program.       (line 109)
+* sleep utility:                         Alarm Program.       (line 111)
 * sleep() extension function:            Extension Sample Time.
                                                               (line  23)
 * Solaris, POSIX-compliant awk:          Other Versions.      (line  96)
@@ -32533,7 +32536,7 @@ Index
 * tilde (~), ~ operator <5>:             Computed Regexps.    (line   6)
 * tilde (~), ~ operator <6>:             Case-sensitivity.    (line  26)
 * tilde (~), ~ operator:                 Regexp Usage.        (line  19)
-* time, alarm clock example program:     Alarm Program.       (line   9)
+* time, alarm clock example program:     Alarm Program.       (line  11)
 * time, localization and:                Explaining gettext.  (line 115)
 * time, managing:                        Getlocaltime Function.
                                                               (line   6)
@@ -33044,228 +33047,228 @@ Ref: Wc Program-Footnote-2675813
 Node: Miscellaneous Programs675905
 Node: Dupword Program677093
 Node: Alarm Program679124
-Node: Translate Program683877
-Ref: Translate Program-Footnote-1688264
-Ref: Translate Program-Footnote-2688512
-Node: Labels Program688646
-Ref: Labels Program-Footnote-1692017
-Node: Word Sorting692101
-Node: History Sorting695985
-Node: Extract Program697824
-Ref: Extract Program-Footnote-1705327
-Node: Simple Sed705455
-Node: Igawk Program708517
-Ref: Igawk Program-Footnote-1723674
-Ref: Igawk Program-Footnote-2723875
-Node: Anagram Program724013
-Node: Signature Program727081
-Node: Advanced Features728181
-Node: Nondecimal Data730067
-Node: Array Sorting731650
-Node: Controlling Array Traversal732347
-Node: Array Sorting Functions740631
-Ref: Array Sorting Functions-Footnote-1744500
-Node: Two-way I/O744694
-Ref: Two-way I/O-Footnote-1750126
-Node: TCP/IP Networking750196
-Node: Profiling753040
-Node: Internationalization760537
-Node: I18N and L10N761962
-Node: Explaining gettext762648
-Ref: Explaining gettext-Footnote-1767716
-Ref: Explaining gettext-Footnote-2767900
-Node: Programmer i18n768065
-Node: Translator i18n772267
-Node: String Extraction773060
-Ref: String Extraction-Footnote-1774021
-Node: Printf Ordering774107
-Ref: Printf Ordering-Footnote-1776891
-Node: I18N Portability776955
-Ref: I18N Portability-Footnote-1779404
-Node: I18N Example779467
-Ref: I18N Example-Footnote-1782105
-Node: Gawk I18N782177
-Node: Debugger782798
-Node: Debugging783769
-Node: Debugging Concepts784202
-Node: Debugging Terms786058
-Node: Awk Debugging788655
-Node: Sample Debugging Session789547
-Node: Debugger Invocation790067
-Node: Finding The Bug791399
-Node: List of Debugger Commands797887
-Node: Breakpoint Control799221
-Node: Debugger Execution Control802885
-Node: Viewing And Changing Data806245
-Node: Execution Stack809601
-Node: Debugger Info811068
-Node: Miscellaneous Debugger Commands815050
-Node: Readline Support820226
-Node: Limitations821057
-Node: Arbitrary Precision Arithmetic823309
-Ref: Arbitrary Precision Arithmetic-Footnote-1824958
-Node: General Arithmetic825106
-Node: Floating Point Issues826826
-Node: String Conversion Precision827707
-Ref: String Conversion Precision-Footnote-1829412
-Node: Unexpected Results829521
-Node: POSIX Floating Point Problems831674
-Ref: POSIX Floating Point Problems-Footnote-1835499
-Node: Integer Programming835537
-Node: Floating-point Programming837276
-Ref: Floating-point Programming-Footnote-1843607
-Ref: Floating-point Programming-Footnote-2843877
-Node: Floating-point Representation844141
-Node: Floating-point Context845306
-Ref: table-ieee-formats846145
-Node: Rounding Mode847529
-Ref: table-rounding-modes848008
-Ref: Rounding Mode-Footnote-1851023
-Node: Gawk and MPFR851202
-Node: Arbitrary Precision Floats852457
-Ref: Arbitrary Precision Floats-Footnote-1854900
-Node: Setting Precision855216
-Ref: table-predefined-precision-strings855902
-Node: Setting Rounding Mode858047
-Ref: table-gawk-rounding-modes858451
-Node: Floating-point Constants859638
-Node: Changing Precision861067
-Ref: Changing Precision-Footnote-1862464
-Node: Exact Arithmetic862638
-Node: Arbitrary Precision Integers865776
-Ref: Arbitrary Precision Integers-Footnote-1868794
-Node: Dynamic Extensions868941
-Node: Extension Intro870399
-Node: Plugin License871664
-Node: Extension Mechanism Outline872349
-Ref: load-extension872766
-Ref: load-new-function874244
-Ref: call-new-function875239
-Node: Extension API Description877254
-Node: Extension API Functions Introduction878467
-Node: General Data Types883333
-Ref: General Data Types-Footnote-1888935
-Node: Requesting Values889234
-Ref: table-value-types-returned889965
-Node: Constructor Functions890919
-Node: Registration Functions893939
-Node: Extension Functions894624
-Node: Exit Callback Functions896849
-Node: Extension Version String898098
-Node: Input Parsers898748
-Node: Output Wrappers908505
-Node: Two-way processors913015
-Node: Printing Messages915223
-Ref: Printing Messages-Footnote-1916300
-Node: Updating `ERRNO'916452
-Node: Accessing Parameters917191
-Node: Symbol Table Access918421
-Node: Symbol table by name918933
-Node: Symbol table by cookie920680
-Ref: Symbol table by cookie-Footnote-1924810
-Node: Cached values924873
-Ref: Cached values-Footnote-1928322
-Node: Array Manipulation928413
-Ref: Array Manipulation-Footnote-1929511
-Node: Array Data Types929550
-Ref: Array Data Types-Footnote-1932253
-Node: Array Functions932345
-Node: Flattening Arrays936111
-Node: Creating Arrays942963
-Node: Extension API Variables947688
-Node: Extension Versioning948324
-Node: Extension API Informational Variables950225
-Node: Extension API Boilerplate951311
-Node: Finding Extensions955115
-Node: Extension Example955675
-Node: Internal File Description956405
-Node: Internal File Ops960496
-Ref: Internal File Ops-Footnote-1972004
-Node: Using Internal File Ops972144
-Ref: Using Internal File Ops-Footnote-1974497
-Node: Extension Samples974763
-Node: Extension Sample File Functions976287
-Node: Extension Sample Fnmatch984772
-Node: Extension Sample Fork986498
-Node: Extension Sample Inplace987716
-Node: Extension Sample Ord989494
-Node: Extension Sample Readdir990330
-Node: Extension Sample Revout991862
-Node: Extension Sample Rev2way992455
-Node: Extension Sample Read write array993145
-Node: Extension Sample Readfile995028
-Node: Extension Sample API Tests995846
-Node: Extension Sample Time996371
-Node: gawkextlib997735
-Node: Language History1000516
-Node: V7/SVR3.11002109
-Node: SVR41004429
-Node: POSIX1005871
-Node: BTL1007257
-Node: POSIX/GNU1007991
-Node: Feature History1013590
-Node: Common Extensions1026554
-Node: Ranges and Locales1027866
-Ref: Ranges and Locales-Footnote-11032484
-Ref: Ranges and Locales-Footnote-21032511
-Ref: Ranges and Locales-Footnote-31032771
-Node: Contributors1032992
-Node: Installation1038137
-Node: Gawk Distribution1039031
-Node: Getting1039515
-Node: Extracting1040341
-Node: Distribution contents1042033
-Node: Unix Installation1047738
-Node: Quick Installation1048355
-Node: Additional Configuration Options1050799
-Node: Configuration Philosophy1052535
-Node: Non-Unix Installation1054889
-Node: PC Installation1055347
-Node: PC Binary Installation1056646
-Node: PC Compiling1058494
-Node: PC Testing1061438
-Node: PC Using1062614
-Node: Cygwin1066799
-Node: MSYS1067799
-Node: VMS Installation1068313
-Node: VMS Compilation1069077
-Ref: VMS Compilation-Footnote-11070692
-Node: VMS Dynamic Extensions1070750
-Node: VMS Installation Details1072123
-Node: VMS Running1074370
-Node: VMS GNV1077204
-Node: VMS Old Gawk1077927
-Node: Bugs1078397
-Node: Other Versions1082315
-Node: Notes1088399
-Node: Compatibility Mode1089199
-Node: Additions1089982
-Node: Accessing The Source1090909
-Node: Adding Code1092349
-Node: New Ports1098394
-Node: Derived Files1102529
-Ref: Derived Files-Footnote-11107850
-Ref: Derived Files-Footnote-21107884
-Ref: Derived Files-Footnote-31108484
-Node: Future Extensions1108582
-Node: Implementation Limitations1109165
-Node: Extension Design1110417
-Node: Old Extension Problems1111571
-Ref: Old Extension Problems-Footnote-11113079
-Node: Extension New Mechanism Goals1113136
-Ref: Extension New Mechanism Goals-Footnote-11116501
-Node: Extension Other Design Decisions1116687
-Node: Extension Future Growth1118793
-Node: Old Extension Mechanism1119629
-Node: Basic Concepts1121369
-Node: Basic High Level1122050
-Ref: figure-general-flow1122321
-Ref: figure-process-flow1122920
-Ref: Basic High Level-Footnote-11126149
-Node: Basic Data Typing1126334
-Node: Glossary1129689
-Node: Copying1155151
-Node: GNU Free Documentation License1192708
-Node: Index1217845
+Node: Translate Program683931
+Ref: Translate Program-Footnote-1688318
+Ref: Translate Program-Footnote-2688566
+Node: Labels Program688700
+Ref: Labels Program-Footnote-1692071
+Node: Word Sorting692155
+Node: History Sorting696039
+Node: Extract Program697878
+Ref: Extract Program-Footnote-1705381
+Node: Simple Sed705509
+Node: Igawk Program708571
+Ref: Igawk Program-Footnote-1723728
+Ref: Igawk Program-Footnote-2723929
+Node: Anagram Program724067
+Node: Signature Program727135
+Node: Advanced Features728235
+Node: Nondecimal Data730121
+Node: Array Sorting731704
+Node: Controlling Array Traversal732401
+Node: Array Sorting Functions740685
+Ref: Array Sorting Functions-Footnote-1744554
+Node: Two-way I/O744748
+Ref: Two-way I/O-Footnote-1750180
+Node: TCP/IP Networking750250
+Node: Profiling753094
+Node: Internationalization760591
+Node: I18N and L10N762016
+Node: Explaining gettext762702
+Ref: Explaining gettext-Footnote-1767770
+Ref: Explaining gettext-Footnote-2767954
+Node: Programmer i18n768119
+Node: Translator i18n772321
+Node: String Extraction773114
+Ref: String Extraction-Footnote-1774075
+Node: Printf Ordering774161
+Ref: Printf Ordering-Footnote-1776945
+Node: I18N Portability777009
+Ref: I18N Portability-Footnote-1779458
+Node: I18N Example779521
+Ref: I18N Example-Footnote-1782159
+Node: Gawk I18N782231
+Node: Debugger782852
+Node: Debugging783823
+Node: Debugging Concepts784256
+Node: Debugging Terms786112
+Node: Awk Debugging788709
+Node: Sample Debugging Session789601
+Node: Debugger Invocation790121
+Node: Finding The Bug791453
+Node: List of Debugger Commands797941
+Node: Breakpoint Control799275
+Node: Debugger Execution Control802939
+Node: Viewing And Changing Data806299
+Node: Execution Stack809655
+Node: Debugger Info811122
+Node: Miscellaneous Debugger Commands815104
+Node: Readline Support820280
+Node: Limitations821111
+Node: Arbitrary Precision Arithmetic823363
+Ref: Arbitrary Precision Arithmetic-Footnote-1825012
+Node: General Arithmetic825160
+Node: Floating Point Issues826880
+Node: String Conversion Precision827761
+Ref: String Conversion Precision-Footnote-1829466
+Node: Unexpected Results829575
+Node: POSIX Floating Point Problems831728
+Ref: POSIX Floating Point Problems-Footnote-1835553
+Node: Integer Programming835591
+Node: Floating-point Programming837330
+Ref: Floating-point Programming-Footnote-1843661
+Ref: Floating-point Programming-Footnote-2843931
+Node: Floating-point Representation844195
+Node: Floating-point Context845360
+Ref: table-ieee-formats846199
+Node: Rounding Mode847583
+Ref: table-rounding-modes848062
+Ref: Rounding Mode-Footnote-1851077
+Node: Gawk and MPFR851256
+Node: Arbitrary Precision Floats852511
+Ref: Arbitrary Precision Floats-Footnote-1854954
+Node: Setting Precision855270
+Ref: table-predefined-precision-strings855956
+Node: Setting Rounding Mode858101
+Ref: table-gawk-rounding-modes858505
+Node: Floating-point Constants859692
+Node: Changing Precision861121
+Ref: Changing Precision-Footnote-1862518
+Node: Exact Arithmetic862692
+Node: Arbitrary Precision Integers865830
+Ref: Arbitrary Precision Integers-Footnote-1868848
+Node: Dynamic Extensions868995
+Node: Extension Intro870453
+Node: Plugin License871718
+Node: Extension Mechanism Outline872403
+Ref: load-extension872820
+Ref: load-new-function874298
+Ref: call-new-function875293
+Node: Extension API Description877308
+Node: Extension API Functions Introduction878521
+Node: General Data Types883387
+Ref: General Data Types-Footnote-1888989
+Node: Requesting Values889288
+Ref: table-value-types-returned890019
+Node: Constructor Functions890973
+Node: Registration Functions893993
+Node: Extension Functions894678
+Node: Exit Callback Functions896903
+Node: Extension Version String898152
+Node: Input Parsers898802
+Node: Output Wrappers908559
+Node: Two-way processors913069
+Node: Printing Messages915277
+Ref: Printing Messages-Footnote-1916354
+Node: Updating `ERRNO'916506
+Node: Accessing Parameters917245
+Node: Symbol Table Access918475
+Node: Symbol table by name918987
+Node: Symbol table by cookie920734
+Ref: Symbol table by cookie-Footnote-1924864
+Node: Cached values924927
+Ref: Cached values-Footnote-1928376
+Node: Array Manipulation928467
+Ref: Array Manipulation-Footnote-1929565
+Node: Array Data Types929604
+Ref: Array Data Types-Footnote-1932307
+Node: Array Functions932399
+Node: Flattening Arrays936165
+Node: Creating Arrays943017
+Node: Extension API Variables947742
+Node: Extension Versioning948378
+Node: Extension API Informational Variables950279
+Node: Extension API Boilerplate951365
+Node: Finding Extensions955169
+Node: Extension Example955729
+Node: Internal File Description956459
+Node: Internal File Ops960550
+Ref: Internal File Ops-Footnote-1972058
+Node: Using Internal File Ops972198
+Ref: Using Internal File Ops-Footnote-1974551
+Node: Extension Samples974817
+Node: Extension Sample File Functions976341
+Node: Extension Sample Fnmatch984826
+Node: Extension Sample Fork986552
+Node: Extension Sample Inplace987770
+Node: Extension Sample Ord989548
+Node: Extension Sample Readdir990384
+Node: Extension Sample Revout991916
+Node: Extension Sample Rev2way992509
+Node: Extension Sample Read write array993199
+Node: Extension Sample Readfile995082
+Node: Extension Sample API Tests995900
+Node: Extension Sample Time996425
+Node: gawkextlib997789
+Node: Language History1000570
+Node: V7/SVR3.11002163
+Node: SVR41004483
+Node: POSIX1005925
+Node: BTL1007311
+Node: POSIX/GNU1008045
+Node: Feature History1013644
+Node: Common Extensions1026608
+Node: Ranges and Locales1027920
+Ref: Ranges and Locales-Footnote-11032538
+Ref: Ranges and Locales-Footnote-21032565
+Ref: Ranges and Locales-Footnote-31032825
+Node: Contributors1033046
+Node: Installation1038191
+Node: Gawk Distribution1039085
+Node: Getting1039569
+Node: Extracting1040395
+Node: Distribution contents1042087
+Node: Unix Installation1047792
+Node: Quick Installation1048409
+Node: Additional Configuration Options1050853
+Node: Configuration Philosophy1052589
+Node: Non-Unix Installation1054943
+Node: PC Installation1055401
+Node: PC Binary Installation1056700
+Node: PC Compiling1058548
+Node: PC Testing1061492
+Node: PC Using1062668
+Node: Cygwin1066853
+Node: MSYS1067853
+Node: VMS Installation1068367
+Node: VMS Compilation1069131
+Ref: VMS Compilation-Footnote-11070746
+Node: VMS Dynamic Extensions1070804
+Node: VMS Installation Details1072177
+Node: VMS Running1074424
+Node: VMS GNV1077258
+Node: VMS Old Gawk1077981
+Node: Bugs1078451
+Node: Other Versions1082369
+Node: Notes1088453
+Node: Compatibility Mode1089253
+Node: Additions1090036
+Node: Accessing The Source1090963
+Node: Adding Code1092403
+Node: New Ports1098448
+Node: Derived Files1102583
+Ref: Derived Files-Footnote-11107904
+Ref: Derived Files-Footnote-21107938
+Ref: Derived Files-Footnote-31108538
+Node: Future Extensions1108636
+Node: Implementation Limitations1109219
+Node: Extension Design1110471
+Node: Old Extension Problems1111625
+Ref: Old Extension Problems-Footnote-11113133
+Node: Extension New Mechanism Goals1113190
+Ref: Extension New Mechanism Goals-Footnote-11116555
+Node: Extension Other Design Decisions1116741
+Node: Extension Future Growth1118847
+Node: Old Extension Mechanism1119683
+Node: Basic Concepts1121423
+Node: Basic High Level1122104
+Ref: figure-general-flow1122375
+Ref: figure-process-flow1122974
+Ref: Basic High Level-Footnote-11126203
+Node: Basic Data Typing1126388
+Node: Glossary1129743
+Node: Copying1155205
+Node: GNU Free Documentation License1192762
+Node: Index1217899
 
 End Tag Table