diff options
-rw-r--r-- | TODO | 2 | ||||
-rw-r--r-- | doc/ChangeLog | 5 | ||||
-rw-r--r-- | doc/awkcard.in | 8 | ||||
-rw-r--r-- | doc/gawk.info | 604 | ||||
-rw-r--r-- | doc/gawk.texi | 8 |
5 files changed, 317 insertions, 310 deletions
@@ -15,8 +15,6 @@ TODO Minor Cleanups and Code Improvements ------------------------------------ - Sync doc with current mawk features and web site. - make check with AWKFLAGS=-M has 4 tests that fail but the results are not reflected in make diffout. Look at this. diff --git a/doc/ChangeLog b/doc/ChangeLog index 3c4e1fc4..09beb1e4 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 274f079f..67bf3db5 100644 --- a/doc/awkcard.in +++ b/doc/awkcard.in @@ -1778,8 +1778,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 @@ -1811,9 +1811,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 835d83a3..82ff0c46 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -12092,8 +12092,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 @@ -25009,6 +25010,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 @@ -26221,8 +26223,8 @@ Unix `awk' In 2009, Thomas Dickey took on `mawk' maintenance. Basic information is available on the project's web page - (http://www.invisible-island.net/mawk/mawk.html). The download - URL is `http://invisible-island.net/datafiles/release/mawk.tar.gz'. + (http://www.invisible-island.net/mawk). The download URL is + `http://invisible-island.net/datafiles/release/mawk.tar.gz'. Once you have it, `gunzip' may be used to decompress this file. Installation is similar to `gawk''s (*note Unix Installation::). @@ -29843,7 +29845,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 109) @@ -29919,8 +29921,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) @@ -30380,7 +30382,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) @@ -30532,7 +30534,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 130) * gawk, regexp constants and: Using Constant Regexps. (line 28) @@ -30897,7 +30899,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) * MPFR: Arbitrary Precision Arithmetic. @@ -31169,7 +31171,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) @@ -31239,7 +31241,7 @@ Index * PROCINFO array <2>: Id Program. (line 15) * PROCINFO array <3>: Group Functions. (line 6) * PROCINFO array <4>: Passwd Functions. (line 6) -* PROCINFO array <5>: Time Functions. (line 46) +* PROCINFO array <5>: Time Functions. (line 47) * PROCINFO array <6>: Auto-set. (line 130) * PROCINFO array: Obsolete. (line 11) * profiling awk programs: Profiling. (line 6) @@ -31565,7 +31567,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. @@ -31610,7 +31612,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 90) * tbreak debugger command: Breakpoint Control. (line 90) * Tcl: Library Names. (line 57) @@ -31655,7 +31657,7 @@ Index * time, retrieving: Time Functions. (line 17) * timeout, reading input: Read Timeout. (line 6) * timestamps: Time Functions. (line 6) -* timestamps, converting dates to: Time Functions. (line 74) +* timestamps, converting dates to: Time Functions. (line 75) * timestamps, formatted: Getlocaltime Function. (line 6) * tolower() function: String Functions. (line 523) @@ -32083,291 +32085,291 @@ Ref: Gory Details-Footnote-2504554 Node: I/O Functions504705 Ref: I/O Functions-Footnote-1511810 Node: Time Functions511957 -Ref: Time Functions-Footnote-1522849 -Ref: Time Functions-Footnote-2522917 -Ref: Time Functions-Footnote-3523075 -Ref: Time Functions-Footnote-4523186 -Ref: Time Functions-Footnote-5523298 -Ref: Time Functions-Footnote-6523525 -Node: Bitwise Functions523791 -Ref: table-bitwise-ops524349 -Ref: Bitwise Functions-Footnote-1528570 -Node: Type Functions528754 -Node: I18N Functions529224 -Node: User-defined530851 -Node: Definition Syntax531655 -Ref: Definition Syntax-Footnote-1536565 -Node: Function Example536634 -Node: Function Caveats539228 -Node: Calling A Function539649 -Node: Variable Scope540764 -Node: Pass By Value/Reference543727 -Node: Return Statement547167 -Node: Dynamic Typing550148 -Node: Indirect Calls550883 -Node: Library Functions560568 -Ref: Library Functions-Footnote-1564081 -Ref: Library Functions-Footnote-2564224 -Node: Library Names564395 -Ref: Library Names-Footnote-1567866 -Ref: Library Names-Footnote-2568086 -Node: General Functions568172 -Node: Strtonum Function569125 -Node: Assert Function572055 -Node: Round Function575381 -Node: Cliff Random Function576924 -Node: Ordinal Functions577940 -Ref: Ordinal Functions-Footnote-1581010 -Ref: Ordinal Functions-Footnote-2581262 -Node: Join Function581471 -Ref: Join Function-Footnote-1583242 -Node: Getlocaltime Function583442 -Node: Data File Management587157 -Node: Filetrans Function587789 -Node: Rewind Function591928 -Node: File Checking593315 -Node: Empty Files594409 -Node: Ignoring Assigns596639 -Node: Getopt Function598192 -Ref: Getopt Function-Footnote-1609496 -Node: Passwd Functions609699 -Ref: Passwd Functions-Footnote-1618674 -Node: Group Functions618762 -Node: Walking Arrays626846 -Node: Sample Programs628415 -Node: Running Examples629092 -Node: Clones629820 -Node: Cut Program631044 -Node: Egrep Program640889 -Ref: Egrep Program-Footnote-1648662 -Node: Id Program648772 -Node: Split Program652388 -Ref: Split Program-Footnote-1655907 -Node: Tee Program656035 -Node: Uniq Program658838 -Node: Wc Program666267 -Ref: Wc Program-Footnote-1670533 -Ref: Wc Program-Footnote-2670733 -Node: Miscellaneous Programs670825 -Node: Dupword Program672013 -Node: Alarm Program674044 -Node: Translate Program678793 -Ref: Translate Program-Footnote-1683180 -Ref: Translate Program-Footnote-2683408 -Node: Labels Program683542 -Ref: Labels Program-Footnote-1686913 -Node: Word Sorting686997 -Node: History Sorting690881 -Node: Extract Program692720 -Ref: Extract Program-Footnote-1700203 -Node: Simple Sed700331 -Node: Igawk Program703393 -Ref: Igawk Program-Footnote-1718550 -Ref: Igawk Program-Footnote-2718751 -Node: Anagram Program718889 -Node: Signature Program721957 -Node: Internationalization723057 -Node: I18N and L10N724489 -Node: Explaining gettext725175 -Ref: Explaining gettext-Footnote-1730241 -Ref: Explaining gettext-Footnote-2730425 -Node: Programmer i18n730590 -Node: Translator i18n734790 -Node: String Extraction735583 -Ref: String Extraction-Footnote-1736544 -Node: Printf Ordering736630 -Ref: Printf Ordering-Footnote-1739414 -Node: I18N Portability739478 -Ref: I18N Portability-Footnote-1741927 -Node: I18N Example741990 -Ref: I18N Example-Footnote-1744625 -Node: Gawk I18N744697 -Node: Advanced Features745314 -Node: Nondecimal Data746818 -Node: Array Sorting748401 -Node: Controlling Array Traversal749098 -Node: Array Sorting Functions757336 -Ref: Array Sorting Functions-Footnote-1761010 -Ref: Array Sorting Functions-Footnote-2761103 -Node: Two-way I/O761297 -Ref: Two-way I/O-Footnote-1766729 -Node: TCP/IP Networking766799 -Node: Profiling769643 -Node: Debugger777097 -Node: Debugging778065 -Node: Debugging Concepts778498 -Node: Debugging Terms780354 -Node: Awk Debugging782951 -Node: Sample Debugging Session783843 -Node: Debugger Invocation784363 -Node: Finding The Bug785692 -Node: List of Debugger Commands792180 -Node: Breakpoint Control793514 -Node: Debugger Execution Control797178 -Node: Viewing And Changing Data800538 -Node: Execution Stack803894 -Node: Debugger Info805361 -Node: Miscellaneous Debugger Commands809342 -Node: Readline Support814787 -Node: Limitations815618 -Node: Arbitrary Precision Arithmetic817870 -Ref: Arbitrary Precision Arithmetic-Footnote-1819512 -Node: General Arithmetic819660 -Node: Floating Point Issues821380 -Node: String Conversion Precision822261 -Ref: String Conversion Precision-Footnote-1823967 -Node: Unexpected Results824076 -Node: POSIX Floating Point Problems826229 -Ref: POSIX Floating Point Problems-Footnote-1830054 -Node: Integer Programming830092 -Node: Floating-point Programming831845 -Ref: Floating-point Programming-Footnote-1838154 -Node: Floating-point Representation838418 -Node: Floating-point Context839583 -Ref: table-ieee-formats840425 -Node: Rounding Mode841809 -Ref: table-rounding-modes842288 -Ref: Rounding Mode-Footnote-1845292 -Node: Gawk and MPFR845473 -Node: Arbitrary Precision Floats846715 -Ref: Arbitrary Precision Floats-Footnote-1849144 -Node: Setting Precision849455 -Node: Setting Rounding Mode852188 -Ref: table-gawk-rounding-modes852592 -Node: Floating-point Constants853772 -Node: Changing Precision855196 -Ref: Changing Precision-Footnote-1856596 -Node: Exact Arithmetic856770 -Node: Arbitrary Precision Integers859878 -Ref: Arbitrary Precision Integers-Footnote-1862878 -Node: Dynamic Extensions863025 -Node: Extension Intro864402 -Node: Plugin License865610 -Node: Extension Mechanism Outline866295 -Ref: load-extension866712 -Ref: load-new-function868190 -Ref: call-new-function869171 -Node: Extension API Description871165 -Node: Extension API Functions Introduction872504 -Node: General Data Types877282 -Ref: General Data Types-Footnote-1882884 -Node: Requesting Values883183 -Ref: table-value-types-returned883914 -Node: Constructor Functions884868 -Node: Registration Functions887864 -Node: Extension Functions888549 -Node: Exit Callback Functions890723 -Node: Extension Version String891966 -Node: Input Parsers892616 -Node: Output Wrappers902333 -Node: Two-way processors906749 -Node: Printing Messages908879 -Ref: Printing Messages-Footnote-1909956 -Node: Updating `ERRNO'910108 -Node: Accessing Parameters910847 -Node: Symbol Table Access912077 -Node: Symbol table by name912589 -Node: Symbol table by cookie914162 -Ref: Symbol table by cookie-Footnote-1918291 -Node: Cached values918354 -Ref: Cached values-Footnote-1921797 -Node: Array Manipulation921888 -Ref: Array Manipulation-Footnote-1922986 -Node: Array Data Types923025 -Ref: Array Data Types-Footnote-1925728 -Node: Array Functions925820 -Node: Flattening Arrays929586 -Node: Creating Arrays936425 -Node: Extension API Variables941220 -Node: Extension Versioning941856 -Node: Extension API Informational Variables943757 -Node: Extension API Boilerplate944843 -Node: Finding Extensions948674 -Node: Extension Example949221 -Node: Internal File Description949959 -Node: Internal File Ops953647 -Ref: Internal File Ops-Footnote-1965094 -Node: Using Internal File Ops965234 -Ref: Using Internal File Ops-Footnote-1967587 -Node: Extension Samples967853 -Node: Extension Sample File Functions969296 -Node: Extension Sample Fnmatch977769 -Node: Extension Sample Fork979495 -Node: Extension Sample Ord980709 -Node: Extension Sample Readdir981485 -Node: Extension Sample Revout982989 -Node: Extension Sample Rev2way983582 -Node: Extension Sample Read write array984272 -Node: Extension Sample Readfile986155 -Node: Extension Sample API Tests986910 -Node: Extension Sample Time987435 -Node: gawkextlib988742 -Node: Language History991123 -Node: V7/SVR3.1992645 -Node: SVR4994966 -Node: POSIX996408 -Node: BTL997416 -Node: POSIX/GNU998221 -Node: Common Extensions1003756 -Node: Ranges and Locales1004815 -Ref: Ranges and Locales-Footnote-11009433 -Ref: Ranges and Locales-Footnote-21009460 -Ref: Ranges and Locales-Footnote-31009720 -Node: Contributors1009941 -Node: Installation1014237 -Node: Gawk Distribution1015131 -Node: Getting1015615 -Node: Extracting1016441 -Node: Distribution contents1018133 -Node: Unix Installation1023394 -Node: Quick Installation1024011 -Node: Additional Configuration Options1025973 -Node: Configuration Philosophy1027450 -Node: Non-Unix Installation1029792 -Node: PC Installation1030250 -Node: PC Binary Installation1031549 -Node: PC Compiling1033397 -Node: PC Testing1036341 -Node: PC Using1037517 -Node: Cygwin1041702 -Node: MSYS1042702 -Node: VMS Installation1043216 -Node: VMS Compilation1043819 -Ref: VMS Compilation-Footnote-11044826 -Node: VMS Installation Details1044884 -Node: VMS Running1046519 -Node: VMS Old Gawk1048126 -Node: Bugs1048600 -Node: Other Versions1052452 -Node: Notes1058118 -Node: Compatibility Mode1058918 -Node: Additions1059701 -Node: Accessing The Source1060628 -Node: Adding Code1062231 -Node: New Ports1068273 -Node: Derived Files1072408 -Ref: Derived Files-Footnote-11077729 -Ref: Derived Files-Footnote-21077763 -Ref: Derived Files-Footnote-31078363 -Node: Future Extensions1078461 -Node: Implementation Limitations1079042 -Node: Extension Design1080294 -Node: Old Extension Problems1081443 -Ref: Old Extension Problems-Footnote-11082951 -Node: Extension New Mechanism Goals1083008 -Ref: Extension New Mechanism Goals-Footnote-11086367 -Node: Extension Other Design Decisions1086553 -Node: Extension Future Growth1088659 -Node: Old Extension Mechansim1089480 -Node: Basic Concepts1091237 -Node: Basic High Level1091918 -Ref: figure-general-flow1092189 -Ref: figure-process-flow1092788 -Ref: Basic High Level-Footnote-11096017 -Node: Basic Data Typing1096202 -Node: Glossary1099557 -Node: Copying1124868 -Node: GNU Free Documentation License1162425 -Node: Index1187562 +Ref: Time Functions-Footnote-1522890 +Ref: Time Functions-Footnote-2522958 +Ref: Time Functions-Footnote-3523116 +Ref: Time Functions-Footnote-4523227 +Ref: Time Functions-Footnote-5523339 +Ref: Time Functions-Footnote-6523566 +Node: Bitwise Functions523832 +Ref: table-bitwise-ops524390 +Ref: Bitwise Functions-Footnote-1528611 +Node: Type Functions528795 +Node: I18N Functions529265 +Node: User-defined530892 +Node: Definition Syntax531696 +Ref: Definition Syntax-Footnote-1536606 +Node: Function Example536675 +Node: Function Caveats539269 +Node: Calling A Function539690 +Node: Variable Scope540805 +Node: Pass By Value/Reference543768 +Node: Return Statement547208 +Node: Dynamic Typing550189 +Node: Indirect Calls550924 +Node: Library Functions560609 +Ref: Library Functions-Footnote-1564122 +Ref: Library Functions-Footnote-2564265 +Node: Library Names564436 +Ref: Library Names-Footnote-1567907 +Ref: Library Names-Footnote-2568127 +Node: General Functions568213 +Node: Strtonum Function569166 +Node: Assert Function572096 +Node: Round Function575422 +Node: Cliff Random Function576965 +Node: Ordinal Functions577981 +Ref: Ordinal Functions-Footnote-1581051 +Ref: Ordinal Functions-Footnote-2581303 +Node: Join Function581512 +Ref: Join Function-Footnote-1583283 +Node: Getlocaltime Function583483 +Node: Data File Management587198 +Node: Filetrans Function587830 +Node: Rewind Function591969 +Node: File Checking593356 +Node: Empty Files594450 +Node: Ignoring Assigns596680 +Node: Getopt Function598233 +Ref: Getopt Function-Footnote-1609537 +Node: Passwd Functions609740 +Ref: Passwd Functions-Footnote-1618715 +Node: Group Functions618803 +Node: Walking Arrays626887 +Node: Sample Programs628456 +Node: Running Examples629133 +Node: Clones629861 +Node: Cut Program631085 +Node: Egrep Program640930 +Ref: Egrep Program-Footnote-1648703 +Node: Id Program648813 +Node: Split Program652429 +Ref: Split Program-Footnote-1655948 +Node: Tee Program656076 +Node: Uniq Program658879 +Node: Wc Program666308 +Ref: Wc Program-Footnote-1670574 +Ref: Wc Program-Footnote-2670774 +Node: Miscellaneous Programs670866 +Node: Dupword Program672054 +Node: Alarm Program674085 +Node: Translate Program678834 +Ref: Translate Program-Footnote-1683221 +Ref: Translate Program-Footnote-2683449 +Node: Labels Program683583 +Ref: Labels Program-Footnote-1686954 +Node: Word Sorting687038 +Node: History Sorting690922 +Node: Extract Program692761 +Ref: Extract Program-Footnote-1700244 +Node: Simple Sed700372 +Node: Igawk Program703434 +Ref: Igawk Program-Footnote-1718591 +Ref: Igawk Program-Footnote-2718792 +Node: Anagram Program718930 +Node: Signature Program721998 +Node: Internationalization723098 +Node: I18N and L10N724530 +Node: Explaining gettext725216 +Ref: Explaining gettext-Footnote-1730282 +Ref: Explaining gettext-Footnote-2730466 +Node: Programmer i18n730631 +Node: Translator i18n734831 +Node: String Extraction735624 +Ref: String Extraction-Footnote-1736585 +Node: Printf Ordering736671 +Ref: Printf Ordering-Footnote-1739455 +Node: I18N Portability739519 +Ref: I18N Portability-Footnote-1741968 +Node: I18N Example742031 +Ref: I18N Example-Footnote-1744666 +Node: Gawk I18N744738 +Node: Advanced Features745355 +Node: Nondecimal Data746859 +Node: Array Sorting748442 +Node: Controlling Array Traversal749139 +Node: Array Sorting Functions757377 +Ref: Array Sorting Functions-Footnote-1761051 +Ref: Array Sorting Functions-Footnote-2761144 +Node: Two-way I/O761338 +Ref: Two-way I/O-Footnote-1766770 +Node: TCP/IP Networking766840 +Node: Profiling769684 +Node: Debugger777138 +Node: Debugging778106 +Node: Debugging Concepts778539 +Node: Debugging Terms780395 +Node: Awk Debugging782992 +Node: Sample Debugging Session783884 +Node: Debugger Invocation784404 +Node: Finding The Bug785733 +Node: List of Debugger Commands792221 +Node: Breakpoint Control793555 +Node: Debugger Execution Control797219 +Node: Viewing And Changing Data800579 +Node: Execution Stack803935 +Node: Debugger Info805402 +Node: Miscellaneous Debugger Commands809383 +Node: Readline Support814828 +Node: Limitations815659 +Node: Arbitrary Precision Arithmetic817911 +Ref: Arbitrary Precision Arithmetic-Footnote-1819553 +Node: General Arithmetic819701 +Node: Floating Point Issues821421 +Node: String Conversion Precision822302 +Ref: String Conversion Precision-Footnote-1824008 +Node: Unexpected Results824117 +Node: POSIX Floating Point Problems826270 +Ref: POSIX Floating Point Problems-Footnote-1830095 +Node: Integer Programming830133 +Node: Floating-point Programming831886 +Ref: Floating-point Programming-Footnote-1838195 +Node: Floating-point Representation838459 +Node: Floating-point Context839624 +Ref: table-ieee-formats840466 +Node: Rounding Mode841850 +Ref: table-rounding-modes842329 +Ref: Rounding Mode-Footnote-1845333 +Node: Gawk and MPFR845514 +Node: Arbitrary Precision Floats846756 +Ref: Arbitrary Precision Floats-Footnote-1849185 +Node: Setting Precision849496 +Node: Setting Rounding Mode852229 +Ref: table-gawk-rounding-modes852633 +Node: Floating-point Constants853813 +Node: Changing Precision855237 +Ref: Changing Precision-Footnote-1856637 +Node: Exact Arithmetic856811 +Node: Arbitrary Precision Integers859919 +Ref: Arbitrary Precision Integers-Footnote-1862919 +Node: Dynamic Extensions863066 +Node: Extension Intro864443 +Node: Plugin License865651 +Node: Extension Mechanism Outline866336 +Ref: load-extension866753 +Ref: load-new-function868231 +Ref: call-new-function869212 +Node: Extension API Description871206 +Node: Extension API Functions Introduction872545 +Node: General Data Types877323 +Ref: General Data Types-Footnote-1882925 +Node: Requesting Values883224 +Ref: table-value-types-returned883955 +Node: Constructor Functions884909 +Node: Registration Functions887905 +Node: Extension Functions888590 +Node: Exit Callback Functions890764 +Node: Extension Version String892007 +Node: Input Parsers892657 +Node: Output Wrappers902374 +Node: Two-way processors906790 +Node: Printing Messages908920 +Ref: Printing Messages-Footnote-1909997 +Node: Updating `ERRNO'910149 +Node: Accessing Parameters910888 +Node: Symbol Table Access912118 +Node: Symbol table by name912630 +Node: Symbol table by cookie914203 +Ref: Symbol table by cookie-Footnote-1918332 +Node: Cached values918395 +Ref: Cached values-Footnote-1921838 +Node: Array Manipulation921929 +Ref: Array Manipulation-Footnote-1923027 +Node: Array Data Types923066 +Ref: Array Data Types-Footnote-1925769 +Node: Array Functions925861 +Node: Flattening Arrays929627 +Node: Creating Arrays936466 +Node: Extension API Variables941261 +Node: Extension Versioning941897 +Node: Extension API Informational Variables943798 +Node: Extension API Boilerplate944884 +Node: Finding Extensions948715 +Node: Extension Example949262 +Node: Internal File Description950000 +Node: Internal File Ops953688 +Ref: Internal File Ops-Footnote-1965135 +Node: Using Internal File Ops965275 +Ref: Using Internal File Ops-Footnote-1967628 +Node: Extension Samples967894 +Node: Extension Sample File Functions969337 +Node: Extension Sample Fnmatch977810 +Node: Extension Sample Fork979536 +Node: Extension Sample Ord980750 +Node: Extension Sample Readdir981526 +Node: Extension Sample Revout983030 +Node: Extension Sample Rev2way983623 +Node: Extension Sample Read write array984313 +Node: Extension Sample Readfile986196 +Node: Extension Sample API Tests986951 +Node: Extension Sample Time987476 +Node: gawkextlib988783 +Node: Language History991164 +Node: V7/SVR3.1992686 +Node: SVR4995007 +Node: POSIX996449 +Node: BTL997457 +Node: POSIX/GNU998262 +Node: Common Extensions1003797 +Node: Ranges and Locales1004904 +Ref: Ranges and Locales-Footnote-11009522 +Ref: Ranges and Locales-Footnote-21009549 +Ref: Ranges and Locales-Footnote-31009809 +Node: Contributors1010030 +Node: Installation1014326 +Node: Gawk Distribution1015220 +Node: Getting1015704 +Node: Extracting1016530 +Node: Distribution contents1018222 +Node: Unix Installation1023483 +Node: Quick Installation1024100 +Node: Additional Configuration Options1026062 +Node: Configuration Philosophy1027539 +Node: Non-Unix Installation1029881 +Node: PC Installation1030339 +Node: PC Binary Installation1031638 +Node: PC Compiling1033486 +Node: PC Testing1036430 +Node: PC Using1037606 +Node: Cygwin1041791 +Node: MSYS1042791 +Node: VMS Installation1043305 +Node: VMS Compilation1043908 +Ref: VMS Compilation-Footnote-11044915 +Node: VMS Installation Details1044973 +Node: VMS Running1046608 +Node: VMS Old Gawk1048215 +Node: Bugs1048689 +Node: Other Versions1052541 +Node: Notes1058197 +Node: Compatibility Mode1058997 +Node: Additions1059780 +Node: Accessing The Source1060707 +Node: Adding Code1062310 +Node: New Ports1068352 +Node: Derived Files1072487 +Ref: Derived Files-Footnote-11077808 +Ref: Derived Files-Footnote-21077842 +Ref: Derived Files-Footnote-31078442 +Node: Future Extensions1078540 +Node: Implementation Limitations1079121 +Node: Extension Design1080373 +Node: Old Extension Problems1081522 +Ref: Old Extension Problems-Footnote-11083030 +Node: Extension New Mechanism Goals1083087 +Ref: Extension New Mechanism Goals-Footnote-11086446 +Node: Extension Other Design Decisions1086632 +Node: Extension Future Growth1088738 +Node: Old Extension Mechansim1089559 +Node: Basic Concepts1091316 +Node: Basic High Level1091997 +Ref: figure-general-flow1092268 +Ref: figure-process-flow1092867 +Ref: Basic High Level-Footnote-11096096 +Node: Basic Data Typing1096281 +Node: Glossary1099636 +Node: Copying1124947 +Node: GNU Free Documentation License1162504 +Node: Index1187641 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 3bf2a4fb..6d476b73 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -16225,10 +16225,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 @@ -32447,6 +32448,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 @@ -33989,7 +33991,7 @@ no longer has it. A copy is available at In 2009, Thomas Dickey took on @command{mawk} maintenance. Basic information is available on -@uref{http://www.invisible-island.net/mawk/mawk.html, the project's web page}. +@uref{http://www.invisible-island.net/mawk, the project's web page}. The download URL is @url{http://invisible-island.net/datafiles/release/mawk.tar.gz}. |