Update doc to current mawk.

4 files changed, 220 insertions, 211 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index a548570b..54684f15 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2013-01-08         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawk.texi, awkcard.in: Sync what mawk has. Main point of
+	interest is that mawk supports the three time functions.
+
 2013-01-06         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawk.texi, awkcard.in: Add Git Hub info for BWK awk.
diff --git a/doc/awkcard.in b/doc/awkcard.in
index 9f92c1d6..7b76025e 100644
--- a/doc/awkcard.in
+++ b/doc/awkcard.in
@@ -1752,8 +1752,8 @@ left unchanged.\*(CX
 .\" --- Built-in Time Functions
 .ES
 .fi
-\*(CD\*(GK
-provides the following functions for obtaining time stamps and
+\*(CD\*(GK and \*(MK
+provide the following functions for obtaining time stamps and
 formatting them.
 .sp .5
 .fi
@@ -1785,9 +1785,9 @@ of \*(FIdate\*(FR(1).
 \*(FCsystime()\fP
 .br
 Return the current time of day as the number of
-seconds since the Epoch.\*(CB
+seconds since the Epoch.\*(CL
 .in -.2i
-.EB "\s+2\f(HBTIME FUNCTIONS (\*(GK\f(HB)\*(FR\s0"
+.EB "\s+2\f(HBTIME FUNCTIONS\*(FR\s0"
 .sp .6
 .\" --- Built-in Bit Manipulation Functions
 .ES
diff --git a/doc/gawk.info b/doc/gawk.info
index a460447a..953330bd 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -11634,8 +11634,9 @@ timestamps that represent times before the epoch.
    In order to make it easier to process such log files and to produce
 useful reports, `gawk' provides the following functions for working
 with timestamps.  They are `gawk' extensions; they are not specified in
-the POSIX standard, nor are they in any other known version of `awk'.(2)
-Optional parameters are enclosed in square brackets ([ ]):
+the POSIX standard.(2) However, recent versions of `mawk' (*note Other
+Versions::) also support these functions.  Optional parameters are
+enclosed in square brackets ([ ]):
 
 `mktime(DATESPEC)'
      Turn DATESPEC into a timestamp in the same form as is returned by
@@ -20159,6 +20160,7 @@ Feature                      BWK Awk   Mawk   GNU Awk
 `delete' without subscript   X         X      X
 `length()' of an array       X                X
 `BINMODE' variable                     X      X
+Time related functions                 X      X
 
 
 File: gawk.info,  Node: Ranges and Locales,  Next: Contributors,  Prev: Common Extensions,  Up: Language History
@@ -25449,7 +25451,7 @@ Index
 * continue statement:                    Continue Statement.  (line   6)
 * control statements:                    Statements.          (line   6)
 * converting, case:                      String Functions.    (line 522)
-* converting, dates to timestamps:       Time Functions.      (line  74)
+* converting, dates to timestamps:       Time Functions.      (line  75)
 * converting, during subscripting:       Numeric Array Subscripts.
                                                               (line  31)
 * converting, numbers to strings <1>:    Bitwise Functions.   (line 107)
@@ -25524,8 +25526,8 @@ Index
 * database, group, reading:              Group Functions.     (line   6)
 * database, users, reading:              Passwd Functions.    (line   6)
 * date utility, GNU:                     Time Functions.      (line  17)
-* date utility, POSIX:                   Time Functions.      (line 261)
-* dates, converting to timestamps:       Time Functions.      (line  74)
+* date utility, POSIX:                   Time Functions.      (line 262)
+* dates, converting to timestamps:       Time Functions.      (line  75)
 * dates, information related to, localization: Explaining gettext.
                                                               (line 115)
 * Davies, Stephen <1>:                   Contributors.        (line  74)
@@ -25990,7 +25992,7 @@ Index
                                                               (line  57)
 * format specifiers, printf statement:   Control Letters.     (line   6)
 * format specifiers, strftime() function (gawk): Time Functions.
-                                                              (line  87)
+                                                              (line  88)
 * format strings:                        Basic Printf.        (line  15)
 * formats, numeric output:               OFMT.                (line   6)
 * formatting output:                     Printf.              (line   6)
@@ -26143,7 +26145,7 @@ Index
 * gawk, octal numbers and:               Nondecimal-numbers.  (line  42)
 * gawk, OS/2 version of:                 PC Using.            (line  11)
 * gawk, PROCINFO array in <1>:           Two-way I/O.         (line 116)
-* gawk, PROCINFO array in <2>:           Time Functions.      (line  46)
+* gawk, PROCINFO array in <2>:           Time Functions.      (line  47)
 * gawk, PROCINFO array in:               Auto-set.            (line 123)
 * gawk, regexp constants and:            Using Constant Regexps.
                                                               (line  28)
@@ -26538,7 +26540,7 @@ Index
 * message object files, specifying directory of: Explaining gettext.
                                                               (line  53)
 * metacharacters, escape sequences for:  Escape Sequences.    (line 132)
-* mktime() function (gawk):              Time Functions.      (line  24)
+* mktime() function (gawk):              Time Functions.      (line  25)
 * modifiers, in format specifiers:       Format Modifiers.    (line   6)
 * monetary information, localization:    Explaining gettext.  (line 103)
 * msgfmt utility:                        I18N Example.        (line  62)
@@ -26817,7 +26819,7 @@ Index
 * POSIX awk, changes in awk versions:    POSIX.               (line   6)
 * POSIX awk, continue statement and:     Continue Statement.  (line  43)
 * POSIX awk, CONVFMT variable and:       User-modified.       (line  28)
-* POSIX awk, date utility and:           Time Functions.      (line 261)
+* POSIX awk, date utility and:           Time Functions.      (line 262)
 * POSIX awk, field separators and <1>:   Field Splitting Summary.
                                                               (line  41)
 * POSIX awk, field separators and:       Fields.              (line   6)
@@ -26886,7 +26888,7 @@ Index
 * PROCINFO array <3>:                    Group Functions.     (line   6)
 * PROCINFO array <4>:                    Passwd Functions.    (line   6)
 * PROCINFO array <5>:                    Two-way I/O.         (line 116)
-* PROCINFO array <6>:                    Time Functions.      (line  46)
+* PROCINFO array <6>:                    Time Functions.      (line  47)
 * PROCINFO array <7>:                    Auto-set.            (line 123)
 * PROCINFO array:                        Obsolete.            (line  11)
 * profiling awk programs:                Profiling.           (line   6)
@@ -27209,7 +27211,7 @@ Index
 * stream editors <1>:                    Simple Sed.          (line   6)
 * stream editors:                        Field Splitting Summary.
                                                               (line  47)
-* strftime() function (gawk):            Time Functions.      (line  47)
+* strftime() function (gawk):            Time Functions.      (line  48)
 * string constants:                      Scalar Constants.    (line  15)
 * string constants, vs. regexp constants: Computed Regexps.   (line  38)
 * string extraction (internationalization): String Extraction.
@@ -27255,7 +27257,7 @@ Index
 * syntactic ambiguity: /= operator vs. /=.../ regexp constant: Assignment Ops.
                                                               (line 148)
 * system() function:                     I/O Functions.       (line  72)
-* systime() function (gawk):             Time Functions.      (line  64)
+* systime() function (gawk):             Time Functions.      (line  65)
 * t debugger command (alias for tbreak): Breakpoint Control.  (line  89)
 * tbreak debugger command:               Breakpoint Control.  (line  89)
 * Tcl:                                   Library Names.       (line  57)
@@ -27297,7 +27299,7 @@ Index
                                                               (line   6)
 * time, retrieving:                      Time Functions.      (line  17)
 * timestamps:                            Time Functions.      (line   6)
-* timestamps, converting dates to:       Time Functions.      (line  74)
+* timestamps, converting dates to:       Time Functions.      (line  75)
 * timestamps, formatted:                 Gettimeofday Function.
                                                               (line   6)
 * tolower() function:                    String Functions.    (line 523)
@@ -27728,197 +27730,197 @@ Ref: Gory Details-Footnote-2481828
 Node: I/O Functions481979
 Ref: I/O Functions-Footnote-1489084
 Node: Time Functions489231
-Ref: Time Functions-Footnote-1500123
-Ref: Time Functions-Footnote-2500191
-Ref: Time Functions-Footnote-3500349
-Ref: Time Functions-Footnote-4500460
-Ref: Time Functions-Footnote-5500572
-Ref: Time Functions-Footnote-6500799
-Node: Bitwise Functions501065
-Ref: table-bitwise-ops501623
-Ref: Bitwise Functions-Footnote-1505783
-Node: Type Functions505967
-Node: I18N Functions506437
-Node: User-defined508064
-Node: Definition Syntax508868
-Ref: Definition Syntax-Footnote-1513778
-Node: Function Example513847
-Node: Function Caveats516441
-Node: Calling A Function516862
-Node: Variable Scope517977
-Node: Pass By Value/Reference519952
-Node: Return Statement523392
-Node: Dynamic Typing526373
-Node: Indirect Calls527108
-Node: Internationalization536793
-Node: I18N and L10N538219
-Node: Explaining gettext538905
-Ref: Explaining gettext-Footnote-1543971
-Ref: Explaining gettext-Footnote-2544155
-Node: Programmer i18n544320
-Node: Translator i18n548520
-Node: String Extraction549313
-Ref: String Extraction-Footnote-1550274
-Node: Printf Ordering550360
-Ref: Printf Ordering-Footnote-1553144
-Node: I18N Portability553208
-Ref: I18N Portability-Footnote-1555657
-Node: I18N Example555720
-Ref: I18N Example-Footnote-1558355
-Node: Gawk I18N558427
-Node: Advanced Features559044
-Node: Nondecimal Data560557
-Node: Array Sorting562140
-Node: Controlling Array Traversal562837
-Node: Array Sorting Functions571074
-Ref: Array Sorting Functions-Footnote-1574748
-Ref: Array Sorting Functions-Footnote-2574841
-Node: Two-way I/O575035
-Ref: Two-way I/O-Footnote-1580467
-Node: TCP/IP Networking580537
-Node: Profiling583381
-Node: Library Functions590855
-Ref: Library Functions-Footnote-1593862
-Node: Library Names594033
-Ref: Library Names-Footnote-1597504
-Ref: Library Names-Footnote-2597724
-Node: General Functions597810
-Node: Strtonum Function598763
-Node: Assert Function601693
-Node: Round Function605019
-Node: Cliff Random Function606562
-Node: Ordinal Functions607578
-Ref: Ordinal Functions-Footnote-1610648
-Ref: Ordinal Functions-Footnote-2610900
-Node: Join Function611109
-Ref: Join Function-Footnote-1612880
-Node: Gettimeofday Function613080
-Node: Data File Management616795
-Node: Filetrans Function617427
-Node: Rewind Function621566
-Node: File Checking622953
-Node: Empty Files624047
-Node: Ignoring Assigns626277
-Node: Getopt Function627830
-Ref: Getopt Function-Footnote-1639134
-Node: Passwd Functions639337
-Ref: Passwd Functions-Footnote-1648312
-Node: Group Functions648400
-Node: Walking Arrays656484
-Node: Sample Programs658053
-Node: Running Examples658718
-Node: Clones659446
-Node: Cut Program660670
-Node: Egrep Program670515
-Ref: Egrep Program-Footnote-1678288
-Node: Id Program678398
-Node: Split Program682014
-Ref: Split Program-Footnote-1685533
-Node: Tee Program685661
-Node: Uniq Program688464
-Node: Wc Program695893
-Ref: Wc Program-Footnote-1700159
-Ref: Wc Program-Footnote-2700359
-Node: Miscellaneous Programs700451
-Node: Dupword Program701639
-Node: Alarm Program703670
-Node: Translate Program708419
-Ref: Translate Program-Footnote-1712806
-Ref: Translate Program-Footnote-2713034
-Node: Labels Program713168
-Ref: Labels Program-Footnote-1716539
-Node: Word Sorting716623
-Node: History Sorting720507
-Node: Extract Program722346
-Ref: Extract Program-Footnote-1729829
-Node: Simple Sed729957
-Node: Igawk Program733019
-Ref: Igawk Program-Footnote-1748176
-Ref: Igawk Program-Footnote-2748377
-Node: Anagram Program748515
-Node: Signature Program751583
-Node: Debugger752683
-Node: Debugging753594
-Node: Debugging Concepts754007
-Node: Debugging Terms755863
-Node: Awk Debugging758486
-Node: Sample dgawk session759378
-Node: dgawk invocation759870
-Node: Finding The Bug761052
-Node: List of Debugger Commands767538
-Node: Breakpoint Control768849
-Node: Dgawk Execution Control772485
-Node: Viewing And Changing Data775836
-Node: Dgawk Stack779173
-Node: Dgawk Info780633
-Node: Miscellaneous Dgawk Commands784581
-Node: Readline Support790009
-Node: Dgawk Limitations790847
-Node: Language History793036
-Node: V7/SVR3.1794548
-Node: SVR4796869
-Node: POSIX798311
-Node: BTL799319
-Node: POSIX/GNU800124
-Node: Common Extensions805275
-Node: Ranges and Locales806334
-Ref: Ranges and Locales-Footnote-1810952
-Ref: Ranges and Locales-Footnote-2810979
-Ref: Ranges and Locales-Footnote-3811239
-Node: Contributors811460
-Node: Installation815722
-Node: Gawk Distribution816616
-Node: Getting817100
-Node: Extracting817926
-Node: Distribution contents819618
-Node: Unix Installation824879
-Node: Quick Installation825496
-Node: Additional Configuration Options827458
-Node: Configuration Philosophy828935
-Node: Non-Unix Installation831277
-Node: PC Installation831735
-Node: PC Binary Installation833034
-Node: PC Compiling835049
-Node: PC Testing837993
-Node: PC Using839169
-Node: Cygwin843354
-Node: MSYS844354
-Node: VMS Installation844868
-Node: VMS Compilation845471
-Ref: VMS Compilation-Footnote-1846478
-Node: VMS Installation Details846536
-Node: VMS Running848171
-Node: VMS Old Gawk849778
-Node: Bugs850252
-Node: Other Versions854104
-Node: Notes859736
-Node: Compatibility Mode860428
-Node: Additions861211
-Node: Accessing The Source862023
-Node: Adding Code863448
-Node: New Ports869415
-Node: Dynamic Extensions873528
-Node: Internals874904
-Node: Plugin License884007
-Node: Sample Library884641
-Node: Internal File Description885327
-Node: Internal File Ops889042
-Ref: Internal File Ops-Footnote-1893823
-Node: Using Internal File Ops893963
-Node: Future Extensions896340
-Node: Basic Concepts898844
-Node: Basic High Level899601
-Ref: Basic High Level-Footnote-1903636
-Node: Basic Data Typing903821
-Node: Floating Point Issues908346
-Node: String Conversion Precision909429
-Ref: String Conversion Precision-Footnote-1911129
-Node: Unexpected Results911238
-Node: POSIX Floating Point Problems913064
-Ref: POSIX Floating Point Problems-Footnote-1916769
-Node: Glossary916807
-Node: Copying941982
-Node: GNU Free Documentation License979539
-Node: Index1004676
+Ref: Time Functions-Footnote-1500164
+Ref: Time Functions-Footnote-2500232
+Ref: Time Functions-Footnote-3500390
+Ref: Time Functions-Footnote-4500501
+Ref: Time Functions-Footnote-5500613
+Ref: Time Functions-Footnote-6500840
+Node: Bitwise Functions501106
+Ref: table-bitwise-ops501664
+Ref: Bitwise Functions-Footnote-1505824
+Node: Type Functions506008
+Node: I18N Functions506478
+Node: User-defined508105
+Node: Definition Syntax508909
+Ref: Definition Syntax-Footnote-1513819
+Node: Function Example513888
+Node: Function Caveats516482
+Node: Calling A Function516903
+Node: Variable Scope518018
+Node: Pass By Value/Reference519993
+Node: Return Statement523433
+Node: Dynamic Typing526414
+Node: Indirect Calls527149
+Node: Internationalization536834
+Node: I18N and L10N538260
+Node: Explaining gettext538946
+Ref: Explaining gettext-Footnote-1544012
+Ref: Explaining gettext-Footnote-2544196
+Node: Programmer i18n544361
+Node: Translator i18n548561
+Node: String Extraction549354
+Ref: String Extraction-Footnote-1550315
+Node: Printf Ordering550401
+Ref: Printf Ordering-Footnote-1553185
+Node: I18N Portability553249
+Ref: I18N Portability-Footnote-1555698
+Node: I18N Example555761
+Ref: I18N Example-Footnote-1558396
+Node: Gawk I18N558468
+Node: Advanced Features559085
+Node: Nondecimal Data560598
+Node: Array Sorting562181
+Node: Controlling Array Traversal562878
+Node: Array Sorting Functions571115
+Ref: Array Sorting Functions-Footnote-1574789
+Ref: Array Sorting Functions-Footnote-2574882
+Node: Two-way I/O575076
+Ref: Two-way I/O-Footnote-1580508
+Node: TCP/IP Networking580578
+Node: Profiling583422
+Node: Library Functions590896
+Ref: Library Functions-Footnote-1593903
+Node: Library Names594074
+Ref: Library Names-Footnote-1597545
+Ref: Library Names-Footnote-2597765
+Node: General Functions597851
+Node: Strtonum Function598804
+Node: Assert Function601734
+Node: Round Function605060
+Node: Cliff Random Function606603
+Node: Ordinal Functions607619
+Ref: Ordinal Functions-Footnote-1610689
+Ref: Ordinal Functions-Footnote-2610941
+Node: Join Function611150
+Ref: Join Function-Footnote-1612921
+Node: Gettimeofday Function613121
+Node: Data File Management616836
+Node: Filetrans Function617468
+Node: Rewind Function621607
+Node: File Checking622994
+Node: Empty Files624088
+Node: Ignoring Assigns626318
+Node: Getopt Function627871
+Ref: Getopt Function-Footnote-1639175
+Node: Passwd Functions639378
+Ref: Passwd Functions-Footnote-1648353
+Node: Group Functions648441
+Node: Walking Arrays656525
+Node: Sample Programs658094
+Node: Running Examples658759
+Node: Clones659487
+Node: Cut Program660711
+Node: Egrep Program670556
+Ref: Egrep Program-Footnote-1678329
+Node: Id Program678439
+Node: Split Program682055
+Ref: Split Program-Footnote-1685574
+Node: Tee Program685702
+Node: Uniq Program688505
+Node: Wc Program695934
+Ref: Wc Program-Footnote-1700200
+Ref: Wc Program-Footnote-2700400
+Node: Miscellaneous Programs700492
+Node: Dupword Program701680
+Node: Alarm Program703711
+Node: Translate Program708460
+Ref: Translate Program-Footnote-1712847
+Ref: Translate Program-Footnote-2713075
+Node: Labels Program713209
+Ref: Labels Program-Footnote-1716580
+Node: Word Sorting716664
+Node: History Sorting720548
+Node: Extract Program722387
+Ref: Extract Program-Footnote-1729870
+Node: Simple Sed729998
+Node: Igawk Program733060
+Ref: Igawk Program-Footnote-1748217
+Ref: Igawk Program-Footnote-2748418
+Node: Anagram Program748556
+Node: Signature Program751624
+Node: Debugger752724
+Node: Debugging753635
+Node: Debugging Concepts754048
+Node: Debugging Terms755904
+Node: Awk Debugging758527
+Node: Sample dgawk session759419
+Node: dgawk invocation759911
+Node: Finding The Bug761093
+Node: List of Debugger Commands767579
+Node: Breakpoint Control768890
+Node: Dgawk Execution Control772526
+Node: Viewing And Changing Data775877
+Node: Dgawk Stack779214
+Node: Dgawk Info780674
+Node: Miscellaneous Dgawk Commands784622
+Node: Readline Support790050
+Node: Dgawk Limitations790888
+Node: Language History793077
+Node: V7/SVR3.1794589
+Node: SVR4796910
+Node: POSIX798352
+Node: BTL799360
+Node: POSIX/GNU800165
+Node: Common Extensions805316
+Node: Ranges and Locales806423
+Ref: Ranges and Locales-Footnote-1811041
+Ref: Ranges and Locales-Footnote-2811068
+Ref: Ranges and Locales-Footnote-3811328
+Node: Contributors811549
+Node: Installation815811
+Node: Gawk Distribution816705
+Node: Getting817189
+Node: Extracting818015
+Node: Distribution contents819707
+Node: Unix Installation824968
+Node: Quick Installation825585
+Node: Additional Configuration Options827547
+Node: Configuration Philosophy829024
+Node: Non-Unix Installation831366
+Node: PC Installation831824
+Node: PC Binary Installation833123
+Node: PC Compiling835138
+Node: PC Testing838082
+Node: PC Using839258
+Node: Cygwin843443
+Node: MSYS844443
+Node: VMS Installation844957
+Node: VMS Compilation845560
+Ref: VMS Compilation-Footnote-1846567
+Node: VMS Installation Details846625
+Node: VMS Running848260
+Node: VMS Old Gawk849867
+Node: Bugs850341
+Node: Other Versions854193
+Node: Notes859825
+Node: Compatibility Mode860517
+Node: Additions861300
+Node: Accessing The Source862112
+Node: Adding Code863537
+Node: New Ports869504
+Node: Dynamic Extensions873617
+Node: Internals874993
+Node: Plugin License884096
+Node: Sample Library884730
+Node: Internal File Description885416
+Node: Internal File Ops889131
+Ref: Internal File Ops-Footnote-1893912
+Node: Using Internal File Ops894052
+Node: Future Extensions896429
+Node: Basic Concepts898933
+Node: Basic High Level899690
+Ref: Basic High Level-Footnote-1903725
+Node: Basic Data Typing903910
+Node: Floating Point Issues908435
+Node: String Conversion Precision909518
+Ref: String Conversion Precision-Footnote-1911218
+Node: Unexpected Results911327
+Node: POSIX Floating Point Problems913153
+Ref: POSIX Floating Point Problems-Footnote-1916858
+Node: Glossary916896
+Node: Copying942071
+Node: GNU Free Documentation License979628
+Node: Index1004765
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 90658dc3..cfacf8a7 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -15749,10 +15749,11 @@ epoch.
 In order to make it easier to process such log files and to produce
 useful reports, @command{gawk} provides the following functions for
 working with timestamps.  They are @command{gawk} extensions; they are
-not specified in the POSIX standard, nor are they in any other known
-version of @command{awk}.@footnote{The GNU @command{date} utility can
+not specified in the POSIX standard.@footnote{The GNU @command{date} utility can
 also do many of the things described here.  Its use may be preferable
 for simple time-related operations in shell scripts.}
+However, recent versions
+of @command{mawk} (@pxref{Other Versions}) also support these functions.
 Optional parameters are enclosed in square brackets ([ ]):
 
 @table @code
@@ -27080,6 +27081,7 @@ the three most widely-used freely available versions of @command{awk}
 @item @code{delete} without subscript @tab X @tab X @tab X
 @item @code{length()} of an array @tab X @tab @tab X
 @item @code{BINMODE} variable @tab @tab X @tab X
+@item Time related functions @tab @tab X @tab X
 @end multitable
 
 @node Ranges and Locales