diff options
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/awkcard.in | 8 | ||||
| -rw-r--r-- | doc/gawk.info | 412 | ||||
| -rw-r--r-- | doc/gawk.texi | 6 |
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 |