diff options
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/gawk.info | 306 | ||||
| -rw-r--r-- | doc/gawk.texi | 3 | ||||
| -rw-r--r-- | doc/gawktexi.in | 3 |
4 files changed, 166 insertions, 151 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index e23b7a91..2db4ea38 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2018-01-08 Andrew J. Schorr <aschorr@telemetry-investments.com> + + * gawktexi.in (Checking for MPFR): Add warnings about exit's processing + of END rules. + 2018-01-03 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Update copryight year, and some small cleanups. diff --git a/doc/gawk.info b/doc/gawk.info index 9fe8396f..5f52e258 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -23293,10 +23293,14 @@ arbitrary-precision arithmetic is available: if (! adequate_math_precision(fpbits)) { print("Error: insufficient computation precision available.\n" \ "Try again with the -M argument?") > "/dev/stderr" + # Note: you may need to set a flag here to bail out of END rules exit 1 } } + Please be aware that 'exit' will jump to the 'END' rules, if present +(*note Exit Statement::). + File: gawk.info, Node: POSIX Floating Point Problems, Next: Floating point summary, Prev: Checking for MPFR, Up: Arbitrary Precision Arithmetic @@ -36403,156 +36407,156 @@ Ref: Setting the rounding mode-Footnote-1939872 Node: Arbitrary Precision Integers940051 Ref: Arbitrary Precision Integers-Footnote-1943226 Node: Checking for MPFR943375 -Node: POSIX Floating Point Problems944672 -Ref: POSIX Floating Point Problems-Footnote-1948543 -Node: Floating point summary948581 -Node: Dynamic Extensions950771 -Node: Extension Intro952324 -Node: Plugin License953590 -Node: Extension Mechanism Outline954387 -Ref: figure-load-extension954826 -Ref: figure-register-new-function956391 -Ref: figure-call-new-function957483 -Node: Extension API Description959545 -Node: Extension API Functions Introduction961187 -Node: General Data Types966727 -Ref: General Data Types-Footnote-1975088 -Node: Memory Allocation Functions975387 -Ref: Memory Allocation Functions-Footnote-1979597 -Node: Constructor Functions979696 -Node: Registration Functions983282 -Node: Extension Functions983967 -Node: Exit Callback Functions989182 -Node: Extension Version String990432 -Node: Input Parsers991095 -Node: Output Wrappers1003816 -Node: Two-way processors1008328 -Node: Printing Messages1010593 -Ref: Printing Messages-Footnote-11011764 -Node: Updating ERRNO1011917 -Node: Requesting Values1012656 -Ref: table-value-types-returned1013393 -Node: Accessing Parameters1014329 -Node: Symbol Table Access1015564 -Node: Symbol table by name1016076 -Node: Symbol table by cookie1017865 -Ref: Symbol table by cookie-Footnote-11022050 -Node: Cached values1022114 -Ref: Cached values-Footnote-11025650 -Node: Array Manipulation1025803 -Ref: Array Manipulation-Footnote-11026894 -Node: Array Data Types1026931 -Ref: Array Data Types-Footnote-11029589 -Node: Array Functions1029681 -Node: Flattening Arrays1034179 -Node: Creating Arrays1041155 -Node: Redirection API1045922 -Node: Extension API Variables1048755 -Node: Extension Versioning1049466 -Ref: gawk-api-version1049895 -Node: Extension GMP/MPFR Versioning1051626 -Node: Extension API Informational Variables1053254 -Node: Extension API Boilerplate1054327 -Node: Changes from API V11058301 -Node: Finding Extensions1059873 -Node: Extension Example1060432 -Node: Internal File Description1061230 -Node: Internal File Ops1065310 -Ref: Internal File Ops-Footnote-11076661 -Node: Using Internal File Ops1076801 -Ref: Using Internal File Ops-Footnote-11079184 -Node: Extension Samples1079458 -Node: Extension Sample File Functions1080987 -Node: Extension Sample Fnmatch1088636 -Node: Extension Sample Fork1090123 -Node: Extension Sample Inplace1091341 -Node: Extension Sample Ord1094558 -Node: Extension Sample Readdir1095394 -Ref: table-readdir-file-types1096283 -Node: Extension Sample Revout1097088 -Node: Extension Sample Rev2way1097677 -Node: Extension Sample Read write array1098417 -Node: Extension Sample Readfile1100359 -Node: Extension Sample Time1101454 -Node: Extension Sample API Tests1102802 -Node: gawkextlib1103294 -Node: Extension summary1105750 -Node: Extension Exercises1109452 -Node: Language History1110950 -Node: V7/SVR3.11112606 -Node: SVR41114758 -Node: POSIX1116192 -Node: BTL1117572 -Node: POSIX/GNU1118301 -Node: Feature History1124079 -Node: Common Extensions1139938 -Node: Ranges and Locales1141221 -Ref: Ranges and Locales-Footnote-11145837 -Ref: Ranges and Locales-Footnote-21145864 -Ref: Ranges and Locales-Footnote-31146099 -Node: Contributors1146320 -Node: History summary1152265 -Node: Installation1153645 -Node: Gawk Distribution1154589 -Node: Getting1155073 -Node: Extracting1156036 -Node: Distribution contents1157674 -Node: Unix Installation1164154 -Node: Quick Installation1164836 -Node: Shell Startup Files1167250 -Node: Additional Configuration Options1168339 -Node: Configuration Philosophy1170632 -Node: Non-Unix Installation1173001 -Node: PC Installation1173461 -Node: PC Binary Installation1174299 -Node: PC Compiling1174734 -Node: PC Using1175851 -Node: Cygwin1178896 -Node: MSYS1179666 -Node: VMS Installation1180167 -Node: VMS Compilation1180958 -Ref: VMS Compilation-Footnote-11182187 -Node: VMS Dynamic Extensions1182245 -Node: VMS Installation Details1183930 -Node: VMS Running1186183 -Node: VMS GNV1190462 -Node: VMS Old Gawk1191197 -Node: Bugs1191668 -Node: Bug address1192331 -Node: Usenet1195123 -Node: Maintainers1195900 -Node: Other Versions1197161 -Node: Installation summary1203923 -Node: Notes1205125 -Node: Compatibility Mode1205990 -Node: Additions1206772 -Node: Accessing The Source1207697 -Node: Adding Code1209134 -Node: New Ports1215353 -Node: Derived Files1219841 -Ref: Derived Files-Footnote-11225487 -Ref: Derived Files-Footnote-21225522 -Ref: Derived Files-Footnote-31226120 -Node: Future Extensions1226234 -Node: Implementation Limitations1226892 -Node: Extension Design1228075 -Node: Old Extension Problems1229229 -Ref: Old Extension Problems-Footnote-11230747 -Node: Extension New Mechanism Goals1230804 -Ref: Extension New Mechanism Goals-Footnote-11234168 -Node: Extension Other Design Decisions1234357 -Node: Extension Future Growth1236470 -Node: Old Extension Mechanism1237306 -Node: Notes summary1239069 -Node: Basic Concepts1240251 -Node: Basic High Level1240932 -Ref: figure-general-flow1241214 -Ref: figure-process-flow1241899 -Ref: Basic High Level-Footnote-11245200 -Node: Basic Data Typing1245385 -Node: Glossary1248713 -Node: Copying1280551 -Node: GNU Free Documentation License1318090 -Node: Index1343208 +Node: POSIX Floating Point Problems944849 +Ref: POSIX Floating Point Problems-Footnote-1948720 +Node: Floating point summary948758 +Node: Dynamic Extensions950948 +Node: Extension Intro952501 +Node: Plugin License953767 +Node: Extension Mechanism Outline954564 +Ref: figure-load-extension955003 +Ref: figure-register-new-function956568 +Ref: figure-call-new-function957660 +Node: Extension API Description959722 +Node: Extension API Functions Introduction961364 +Node: General Data Types966904 +Ref: General Data Types-Footnote-1975265 +Node: Memory Allocation Functions975564 +Ref: Memory Allocation Functions-Footnote-1979774 +Node: Constructor Functions979873 +Node: Registration Functions983459 +Node: Extension Functions984144 +Node: Exit Callback Functions989359 +Node: Extension Version String990609 +Node: Input Parsers991272 +Node: Output Wrappers1003993 +Node: Two-way processors1008505 +Node: Printing Messages1010770 +Ref: Printing Messages-Footnote-11011941 +Node: Updating ERRNO1012094 +Node: Requesting Values1012833 +Ref: table-value-types-returned1013570 +Node: Accessing Parameters1014506 +Node: Symbol Table Access1015741 +Node: Symbol table by name1016253 +Node: Symbol table by cookie1018042 +Ref: Symbol table by cookie-Footnote-11022227 +Node: Cached values1022291 +Ref: Cached values-Footnote-11025827 +Node: Array Manipulation1025980 +Ref: Array Manipulation-Footnote-11027071 +Node: Array Data Types1027108 +Ref: Array Data Types-Footnote-11029766 +Node: Array Functions1029858 +Node: Flattening Arrays1034356 +Node: Creating Arrays1041332 +Node: Redirection API1046099 +Node: Extension API Variables1048932 +Node: Extension Versioning1049643 +Ref: gawk-api-version1050072 +Node: Extension GMP/MPFR Versioning1051803 +Node: Extension API Informational Variables1053431 +Node: Extension API Boilerplate1054504 +Node: Changes from API V11058478 +Node: Finding Extensions1060050 +Node: Extension Example1060609 +Node: Internal File Description1061407 +Node: Internal File Ops1065487 +Ref: Internal File Ops-Footnote-11076838 +Node: Using Internal File Ops1076978 +Ref: Using Internal File Ops-Footnote-11079361 +Node: Extension Samples1079635 +Node: Extension Sample File Functions1081164 +Node: Extension Sample Fnmatch1088813 +Node: Extension Sample Fork1090300 +Node: Extension Sample Inplace1091518 +Node: Extension Sample Ord1094735 +Node: Extension Sample Readdir1095571 +Ref: table-readdir-file-types1096460 +Node: Extension Sample Revout1097265 +Node: Extension Sample Rev2way1097854 +Node: Extension Sample Read write array1098594 +Node: Extension Sample Readfile1100536 +Node: Extension Sample Time1101631 +Node: Extension Sample API Tests1102979 +Node: gawkextlib1103471 +Node: Extension summary1105927 +Node: Extension Exercises1109629 +Node: Language History1111127 +Node: V7/SVR3.11112783 +Node: SVR41114935 +Node: POSIX1116369 +Node: BTL1117749 +Node: POSIX/GNU1118478 +Node: Feature History1124256 +Node: Common Extensions1140115 +Node: Ranges and Locales1141398 +Ref: Ranges and Locales-Footnote-11146014 +Ref: Ranges and Locales-Footnote-21146041 +Ref: Ranges and Locales-Footnote-31146276 +Node: Contributors1146497 +Node: History summary1152442 +Node: Installation1153822 +Node: Gawk Distribution1154766 +Node: Getting1155250 +Node: Extracting1156213 +Node: Distribution contents1157851 +Node: Unix Installation1164331 +Node: Quick Installation1165013 +Node: Shell Startup Files1167427 +Node: Additional Configuration Options1168516 +Node: Configuration Philosophy1170809 +Node: Non-Unix Installation1173178 +Node: PC Installation1173638 +Node: PC Binary Installation1174476 +Node: PC Compiling1174911 +Node: PC Using1176028 +Node: Cygwin1179073 +Node: MSYS1179843 +Node: VMS Installation1180344 +Node: VMS Compilation1181135 +Ref: VMS Compilation-Footnote-11182364 +Node: VMS Dynamic Extensions1182422 +Node: VMS Installation Details1184107 +Node: VMS Running1186360 +Node: VMS GNV1190639 +Node: VMS Old Gawk1191374 +Node: Bugs1191845 +Node: Bug address1192508 +Node: Usenet1195300 +Node: Maintainers1196077 +Node: Other Versions1197338 +Node: Installation summary1204100 +Node: Notes1205302 +Node: Compatibility Mode1206167 +Node: Additions1206949 +Node: Accessing The Source1207874 +Node: Adding Code1209311 +Node: New Ports1215530 +Node: Derived Files1220018 +Ref: Derived Files-Footnote-11225664 +Ref: Derived Files-Footnote-21225699 +Ref: Derived Files-Footnote-31226297 +Node: Future Extensions1226411 +Node: Implementation Limitations1227069 +Node: Extension Design1228252 +Node: Old Extension Problems1229406 +Ref: Old Extension Problems-Footnote-11230924 +Node: Extension New Mechanism Goals1230981 +Ref: Extension New Mechanism Goals-Footnote-11234345 +Node: Extension Other Design Decisions1234534 +Node: Extension Future Growth1236647 +Node: Old Extension Mechanism1237483 +Node: Notes summary1239246 +Node: Basic Concepts1240428 +Node: Basic High Level1241109 +Ref: figure-general-flow1241391 +Ref: figure-process-flow1242076 +Ref: Basic High Level-Footnote-11245377 +Node: Basic Data Typing1245562 +Node: Glossary1248890 +Node: Copying1280728 +Node: GNU Free Documentation License1318267 +Node: Index1343385 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 2e218d6c..5eb20995 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -32464,11 +32464,14 @@ BEGIN @{ if (! adequate_math_precision(fpbits)) @{ print("Error: insufficient computation precision available.\n" \ "Try again with the -M argument?") > "/dev/stderr" + # Note: you may need to set a flag here to bail out of END rules exit 1 @} @} @end example +Please be aware that @code{exit} will jump to the @code{END} rules, if present (@pxref{Exit Statement}). + @node POSIX Floating Point Problems @section Standards Versus Existing Practice diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 3b46ef78..17100b6b 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -31438,11 +31438,14 @@ BEGIN @{ if (! adequate_math_precision(fpbits)) @{ print("Error: insufficient computation precision available.\n" \ "Try again with the -M argument?") > "/dev/stderr" + # Note: you may need to set a flag here to bail out of END rules exit 1 @} @} @end example +Please be aware that @code{exit} will jump to the @code{END} rules, if present (@pxref{Exit Statement}). + @node POSIX Floating Point Problems @section Standards Versus Existing Practice |