diff options
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 173 | ||||
| -rw-r--r-- | doc/gawk.texi | 10 | ||||
| -rw-r--r-- | doc/gawktexi.in | 10 | ||||
| -rw-r--r-- | extension/ChangeLog | 4 | ||||
| -rw-r--r-- | extension/time.3am | 13 |
6 files changed, 131 insertions, 83 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index f9f2b4d7..515567a6 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2019-11-21 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: Document that the time extension is now obsolete. + 2019-11-03 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Document that readdir extension can cause a diff --git a/doc/gawk.info b/doc/gawk.info index 7322305d..60a24f81 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -28015,7 +28015,16 @@ File: gawk.info, Node: Extension Sample Time, Next: Extension Sample API Tests 17.7.11 Extension Time Functions -------------------------------- -The 'time' extension adds two functions, named 'gettimeofday()' and + CAUTION: As 'gawk' version 5.1.0, this extension is considered to + be obsolete. It is replaced by the 'timex' extension in + 'gawkextlib' (*note gawkextlib::). + + For version 5.1, no warning will be issued if this extension is + used. For the next major release, a warning will be issued. In + the release after that this extension will be removed from the + distribution. + + The 'time' extension adds two functions, named 'gettimeofday()' and 'sleep()', as follows: '@load "time"' @@ -35540,7 +35549,7 @@ Index * gettext library, locale categories: Explaining gettext. (line 81) * gettext() function (C library): Explaining gettext. (line 63) * gettimeofday() extension function: Extension Sample Time. - (line 12) + (line 21) * git utility: gawkextlib. (line 31) * git utility <1>: Other Versions. (line 18) * git utility <2>: Accessing The Source. @@ -36692,7 +36701,7 @@ Index * Skywalker, Luke: Undocumented. (line 6) * sleep utility: Alarm Program. (line 109) * sleep() extension function: Extension Sample Time. - (line 22) + (line 31) * Solaris, POSIX-compliant awk: Other Versions. (line 96) * sort array: String Functions. (line 42) * sort array indices: String Functions. (line 42) @@ -37612,85 +37621,85 @@ Node: Extension Sample Rev2way1130520 Node: Extension Sample Read write array1131260 Node: Extension Sample Readfile1133202 Node: Extension Sample Time1134297 -Node: Extension Sample API Tests1135645 -Node: gawkextlib1136137 -Node: Extension summary1139055 -Node: Extension Exercises1142757 -Node: Language History1143999 -Node: V7/SVR3.11145655 -Node: SVR41147807 -Node: POSIX1149241 -Node: BTL1150621 -Node: POSIX/GNU1151350 -Node: Feature History1157128 -Node: Common Extensions1173321 -Node: Ranges and Locales1174604 -Ref: Ranges and Locales-Footnote-11179220 -Ref: Ranges and Locales-Footnote-21179247 -Ref: Ranges and Locales-Footnote-31179482 -Node: Contributors1179703 -Node: History summary1185656 -Node: Installation1187036 -Node: Gawk Distribution1187980 -Node: Getting1188464 -Node: Extracting1189427 -Node: Distribution contents1191065 -Node: Unix Installation1197545 -Node: Quick Installation1198227 -Node: Shell Startup Files1200641 -Node: Additional Configuration Options1201730 -Node: Configuration Philosophy1204045 -Node: Non-Unix Installation1206414 -Node: PC Installation1206874 -Node: PC Binary Installation1207712 -Node: PC Compiling1208147 -Node: PC Using1209264 -Node: Cygwin1212817 -Node: MSYS1214041 -Node: VMS Installation1214542 -Node: VMS Compilation1215333 -Ref: VMS Compilation-Footnote-11216562 -Node: VMS Dynamic Extensions1216620 -Node: VMS Installation Details1218305 -Node: VMS Running1220558 -Node: VMS GNV1224837 -Node: VMS Old Gawk1225572 -Node: Bugs1226043 -Node: Bug address1226706 -Node: Usenet1229688 -Node: Maintainers1230692 -Node: Other Versions1231953 -Node: Installation summary1239041 -Node: Notes1240243 -Node: Compatibility Mode1241037 -Node: Additions1241819 -Node: Accessing The Source1242744 -Node: Adding Code1244181 -Node: New Ports1250400 -Node: Derived Files1254775 -Ref: Derived Files-Footnote-11260435 -Ref: Derived Files-Footnote-21260470 -Ref: Derived Files-Footnote-31261068 -Node: Future Extensions1261182 -Node: Implementation Limitations1261840 -Node: Extension Design1263023 -Node: Old Extension Problems1264167 -Ref: Old Extension Problems-Footnote-11265685 -Node: Extension New Mechanism Goals1265742 -Ref: Extension New Mechanism Goals-Footnote-11269106 -Node: Extension Other Design Decisions1269295 -Node: Extension Future Growth1271408 -Node: Notes summary1272244 -Node: Basic Concepts1273402 -Node: Basic High Level1274083 -Ref: figure-general-flow1274365 -Ref: figure-process-flow1275050 -Ref: Basic High Level-Footnote-11278351 -Node: Basic Data Typing1278536 -Node: Glossary1281864 -Node: Copying1313702 -Node: GNU Free Documentation License1351245 -Node: Index1376365 +Node: Extension Sample API Tests1136049 +Node: gawkextlib1136541 +Node: Extension summary1139459 +Node: Extension Exercises1143161 +Node: Language History1144403 +Node: V7/SVR3.11146059 +Node: SVR41148211 +Node: POSIX1149645 +Node: BTL1151025 +Node: POSIX/GNU1151754 +Node: Feature History1157532 +Node: Common Extensions1173725 +Node: Ranges and Locales1175008 +Ref: Ranges and Locales-Footnote-11179624 +Ref: Ranges and Locales-Footnote-21179651 +Ref: Ranges and Locales-Footnote-31179886 +Node: Contributors1180107 +Node: History summary1186060 +Node: Installation1187440 +Node: Gawk Distribution1188384 +Node: Getting1188868 +Node: Extracting1189831 +Node: Distribution contents1191469 +Node: Unix Installation1197949 +Node: Quick Installation1198631 +Node: Shell Startup Files1201045 +Node: Additional Configuration Options1202134 +Node: Configuration Philosophy1204449 +Node: Non-Unix Installation1206818 +Node: PC Installation1207278 +Node: PC Binary Installation1208116 +Node: PC Compiling1208551 +Node: PC Using1209668 +Node: Cygwin1213221 +Node: MSYS1214445 +Node: VMS Installation1214946 +Node: VMS Compilation1215737 +Ref: VMS Compilation-Footnote-11216966 +Node: VMS Dynamic Extensions1217024 +Node: VMS Installation Details1218709 +Node: VMS Running1220962 +Node: VMS GNV1225241 +Node: VMS Old Gawk1225976 +Node: Bugs1226447 +Node: Bug address1227110 +Node: Usenet1230092 +Node: Maintainers1231096 +Node: Other Versions1232357 +Node: Installation summary1239445 +Node: Notes1240647 +Node: Compatibility Mode1241441 +Node: Additions1242223 +Node: Accessing The Source1243148 +Node: Adding Code1244585 +Node: New Ports1250804 +Node: Derived Files1255179 +Ref: Derived Files-Footnote-11260839 +Ref: Derived Files-Footnote-21260874 +Ref: Derived Files-Footnote-31261472 +Node: Future Extensions1261586 +Node: Implementation Limitations1262244 +Node: Extension Design1263427 +Node: Old Extension Problems1264571 +Ref: Old Extension Problems-Footnote-11266089 +Node: Extension New Mechanism Goals1266146 +Ref: Extension New Mechanism Goals-Footnote-11269510 +Node: Extension Other Design Decisions1269699 +Node: Extension Future Growth1271812 +Node: Notes summary1272648 +Node: Basic Concepts1273806 +Node: Basic High Level1274487 +Ref: figure-general-flow1274769 +Ref: figure-process-flow1275454 +Ref: Basic High Level-Footnote-11278755 +Node: Basic Data Typing1278940 +Node: Glossary1282268 +Node: Copying1314106 +Node: GNU Free Documentation License1351649 +Node: Index1376769 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 2ae6d564..12841fde 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -38120,6 +38120,16 @@ if (contents == "" && ERRNO != "") @{ @node Extension Sample Time @subsection Extension Time Functions +@quotation CAUTION +As @command{gawk} @value{PVERSION} 5.1.0, this extension is considered to be obsolete. +It is replaced by the @code{timex} extension in @code{gawkextlib} +(@pxref{gawkextlib}). + +For @value{PVERSION} 5.1, no warning will be issued if this extension is used. +For the next major release, a warning will be issued. In the release after that +this extension will be removed from the distribution. +@end quotation + The @code{time} extension adds two functions, named @code{gettimeofday()} and @code{sleep()}, as follows: diff --git a/doc/gawktexi.in b/doc/gawktexi.in index e6f778ac..05741cf1 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -37091,6 +37091,16 @@ if (contents == "" && ERRNO != "") @{ @node Extension Sample Time @subsection Extension Time Functions +@quotation CAUTION +As @command{gawk} @value{PVERSION} 5.1.0, this extension is considered to be obsolete. +It is replaced by the @code{timex} extension in @code{gawkextlib} +(@pxref{gawkextlib}). + +For @value{PVERSION} 5.1, no warning will be issued if this extension is used. +For the next major release, a warning will be issued. In the release after that +this extension will be removed from the distribution. +@end quotation + The @code{time} extension adds two functions, named @code{gettimeofday()} and @code{sleep()}, as follows: diff --git a/extension/ChangeLog b/extension/ChangeLog index d71ac219..f6dd4a4d 100644 --- a/extension/ChangeLog +++ b/extension/ChangeLog @@ -1,3 +1,7 @@ +2019-11-21 Arnold D. Robbins <arnold@skeeve.com> + + * time.3am: Document that this extension is now obsolete. + 2019-11-03 Arnold D. Robbins <arnold@skeeve.com> * readdir.3am: Document that readdir extension can cause a diff --git a/extension/time.3am b/extension/time.3am index 0b872c70..05f4646f 100644 --- a/extension/time.3am +++ b/extension/time.3am @@ -1,4 +1,4 @@ -.TH TIME 3am "Feb 02 2018" "Free Software Foundation" "GNU Awk Extension Modules" +.TH TIME 3am "Nov 21 2019" "Free Software Foundation" "GNU Awk Extension Modules" .SH NAME time \- time functions for gawk .SH SYNOPSIS @@ -9,6 +9,17 @@ time = gettimeofday() .br ret = sleep(amount) .ft R +.SH CAUTION +This extension is deprecated in favor of the +.B timex +extension in the +.I gawkextlib +project. In the next major release of +.IR gawk , +loading it will issue a warning. +It will be removed from the +.I gawk +distribution in the major release after the next one. .SH DESCRIPTION The .I time |