diff options
| -rw-r--r-- | doc/ChangeLog | 5 | ||||
| -rw-r--r-- | doc/gawk.info | 536 | ||||
| -rw-r--r-- | doc/gawk.texi | 5 |
3 files changed, 280 insertions, 266 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 70782728..cd7c51d9 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2013-01-27 Arnold D. Robbins <arnold@skeeve.com> + + * gawk.texi (Dynamic Typing): Clarify that gawk dies after the + first fatal error on the test program. Thanks to Hermann Peifer. + 2013-01-21 Arnold D. Robbins <arnold@skeeve.com> * gawk.texi (Setting Precision): Fix a typo. 3.322 instead diff --git a/doc/gawk.info b/doc/gawk.info index a9acd6a1..c271041f 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -13153,6 +13153,10 @@ Here is an annotated sample program: x = 1 # now not allowed, runtime error } + In this example, the first call to `foo()' generates a fatal error, +so `gawk' will not report the second error. If you comment out that +call, though, then `gawk' will report the second error. + Usually, such things aren't a big issue, but it's worth being aware of them. @@ -32157,271 +32161,271 @@ Node: Variable Scope540877 Node: Pass By Value/Reference543840 Node: Return Statement547280 Node: Dynamic Typing550261 -Node: Indirect Calls550996 -Node: Library Functions560681 -Ref: Library Functions-Footnote-1564194 -Ref: Library Functions-Footnote-2564337 -Node: Library Names564508 -Ref: Library Names-Footnote-1567979 -Ref: Library Names-Footnote-2568199 -Node: General Functions568285 -Node: Strtonum Function569238 -Node: Assert Function572168 -Node: Round Function575494 -Node: Cliff Random Function577037 -Node: Ordinal Functions578053 -Ref: Ordinal Functions-Footnote-1581123 -Ref: Ordinal Functions-Footnote-2581375 -Node: Join Function581584 -Ref: Join Function-Footnote-1583355 -Node: Getlocaltime Function583555 -Node: Data File Management587270 -Node: Filetrans Function587902 -Node: Rewind Function592041 -Node: File Checking593428 -Node: Empty Files594522 -Node: Ignoring Assigns596752 -Node: Getopt Function598305 -Ref: Getopt Function-Footnote-1609609 -Node: Passwd Functions609812 -Ref: Passwd Functions-Footnote-1618787 -Node: Group Functions618875 -Node: Walking Arrays626959 -Node: Sample Programs628528 -Node: Running Examples629205 -Node: Clones629933 -Node: Cut Program631157 -Node: Egrep Program641002 -Ref: Egrep Program-Footnote-1648775 -Node: Id Program648885 -Node: Split Program652501 -Ref: Split Program-Footnote-1656020 -Node: Tee Program656148 -Node: Uniq Program658951 -Node: Wc Program666380 -Ref: Wc Program-Footnote-1670646 -Ref: Wc Program-Footnote-2670846 -Node: Miscellaneous Programs670938 -Node: Dupword Program672126 -Node: Alarm Program674157 -Node: Translate Program678906 -Ref: Translate Program-Footnote-1683293 -Ref: Translate Program-Footnote-2683521 -Node: Labels Program683655 -Ref: Labels Program-Footnote-1687026 -Node: Word Sorting687110 -Node: History Sorting690994 -Node: Extract Program692833 -Ref: Extract Program-Footnote-1700316 -Node: Simple Sed700444 -Node: Igawk Program703506 -Ref: Igawk Program-Footnote-1718663 -Ref: Igawk Program-Footnote-2718864 -Node: Anagram Program719002 -Node: Signature Program722070 -Node: Internationalization723170 -Node: I18N and L10N724602 -Node: Explaining gettext725288 -Ref: Explaining gettext-Footnote-1730354 -Ref: Explaining gettext-Footnote-2730538 -Node: Programmer i18n730703 -Node: Translator i18n734903 -Node: String Extraction735696 -Ref: String Extraction-Footnote-1736657 -Node: Printf Ordering736743 -Ref: Printf Ordering-Footnote-1739527 -Node: I18N Portability739591 -Ref: I18N Portability-Footnote-1742040 -Node: I18N Example742103 -Ref: I18N Example-Footnote-1744738 -Node: Gawk I18N744810 -Node: Advanced Features745427 -Node: Nondecimal Data746931 -Node: Array Sorting748514 -Node: Controlling Array Traversal749211 -Node: Array Sorting Functions757449 -Ref: Array Sorting Functions-Footnote-1761123 -Ref: Array Sorting Functions-Footnote-2761216 -Node: Two-way I/O761410 -Ref: Two-way I/O-Footnote-1766842 -Node: TCP/IP Networking766912 -Node: Profiling769756 -Node: Debugger777210 -Node: Debugging778178 -Node: Debugging Concepts778611 -Node: Debugging Terms780467 -Node: Awk Debugging783064 -Node: Sample Debugging Session783956 -Node: Debugger Invocation784476 -Node: Finding The Bug785805 -Node: List of Debugger Commands792293 -Node: Breakpoint Control793627 -Node: Debugger Execution Control797291 -Node: Viewing And Changing Data800651 -Node: Execution Stack804007 -Node: Debugger Info805474 -Node: Miscellaneous Debugger Commands809455 -Node: Readline Support814900 -Node: Limitations815731 -Node: Arbitrary Precision Arithmetic817983 -Ref: Arbitrary Precision Arithmetic-Footnote-1819625 -Node: General Arithmetic819773 -Node: Floating Point Issues821493 -Node: String Conversion Precision822374 -Ref: String Conversion Precision-Footnote-1824080 -Node: Unexpected Results824189 -Node: POSIX Floating Point Problems826342 -Ref: POSIX Floating Point Problems-Footnote-1830167 -Node: Integer Programming830205 -Node: Floating-point Programming831958 -Ref: Floating-point Programming-Footnote-1838267 -Node: Floating-point Representation838531 -Node: Floating-point Context839696 -Ref: table-ieee-formats840538 -Node: Rounding Mode841922 -Ref: table-rounding-modes842401 -Ref: Rounding Mode-Footnote-1845405 -Node: Gawk and MPFR845586 -Node: Arbitrary Precision Floats846828 -Ref: Arbitrary Precision Floats-Footnote-1849257 -Node: Setting Precision849568 -Node: Setting Rounding Mode852301 -Ref: table-gawk-rounding-modes852705 -Node: Floating-point Constants853885 -Node: Changing Precision855309 -Ref: Changing Precision-Footnote-1856709 -Node: Exact Arithmetic856883 -Node: Arbitrary Precision Integers859991 -Ref: Arbitrary Precision Integers-Footnote-1862991 -Node: Dynamic Extensions863138 -Node: Extension Intro864515 -Node: Plugin License865723 -Node: Extension Mechanism Outline866408 -Ref: load-extension866825 -Ref: load-new-function868303 -Ref: call-new-function869284 -Node: Extension API Description871278 -Node: Extension API Functions Introduction872617 -Node: General Data Types877395 -Ref: General Data Types-Footnote-1882997 -Node: Requesting Values883296 -Ref: table-value-types-returned884027 -Node: Constructor Functions884981 -Node: Registration Functions887977 -Node: Extension Functions888662 -Node: Exit Callback Functions890836 -Node: Extension Version String892079 -Node: Input Parsers892729 -Node: Output Wrappers902446 -Node: Two-way processors906862 -Node: Printing Messages908992 -Ref: Printing Messages-Footnote-1910069 -Node: Updating `ERRNO'910221 -Node: Accessing Parameters910960 -Node: Symbol Table Access912190 -Node: Symbol table by name912702 -Node: Symbol table by cookie914275 -Ref: Symbol table by cookie-Footnote-1918404 -Node: Cached values918467 -Ref: Cached values-Footnote-1921910 -Node: Array Manipulation922001 -Ref: Array Manipulation-Footnote-1923099 -Node: Array Data Types923138 -Ref: Array Data Types-Footnote-1925841 -Node: Array Functions925933 -Node: Flattening Arrays929699 -Node: Creating Arrays936538 -Node: Extension API Variables941333 -Node: Extension Versioning941969 -Node: Extension API Informational Variables943870 -Node: Extension API Boilerplate944956 -Node: Finding Extensions948787 -Node: Extension Example949334 -Node: Internal File Description950072 -Node: Internal File Ops953760 -Ref: Internal File Ops-Footnote-1965207 -Node: Using Internal File Ops965347 -Ref: Using Internal File Ops-Footnote-1967700 -Node: Extension Samples967966 -Node: Extension Sample File Functions969490 -Node: Extension Sample Fnmatch977963 -Node: Extension Sample Fork979689 -Node: Extension Sample Inplace980907 -Node: Extension Sample Ord982699 -Node: Extension Sample Readdir983478 -Node: Extension Sample Revout984982 -Node: Extension Sample Rev2way985575 -Node: Extension Sample Read write array986265 -Node: Extension Sample Readfile988148 -Node: Extension Sample API Tests988905 -Node: Extension Sample Time989430 -Node: gawkextlib990737 -Node: Language History993118 -Node: V7/SVR3.1994640 -Node: SVR4996961 -Node: POSIX998403 -Node: BTL999411 -Node: POSIX/GNU1000216 -Node: Common Extensions1005751 -Node: Ranges and Locales1006858 -Ref: Ranges and Locales-Footnote-11011476 -Ref: Ranges and Locales-Footnote-21011503 -Ref: Ranges and Locales-Footnote-31011763 -Node: Contributors1011984 -Node: Installation1016280 -Node: Gawk Distribution1017174 -Node: Getting1017658 -Node: Extracting1018484 -Node: Distribution contents1020176 -Node: Unix Installation1025437 -Node: Quick Installation1026054 -Node: Additional Configuration Options1028016 -Node: Configuration Philosophy1029493 -Node: Non-Unix Installation1031835 -Node: PC Installation1032293 -Node: PC Binary Installation1033592 -Node: PC Compiling1035440 -Node: PC Testing1038384 -Node: PC Using1039560 -Node: Cygwin1043745 -Node: MSYS1044745 -Node: VMS Installation1045259 -Node: VMS Compilation1045862 -Ref: VMS Compilation-Footnote-11046869 -Node: VMS Installation Details1046927 -Node: VMS Running1048562 -Node: VMS Old Gawk1050169 -Node: Bugs1050643 -Node: Other Versions1054495 -Node: Notes1060151 -Node: Compatibility Mode1060951 -Node: Additions1061734 -Node: Accessing The Source1062661 -Node: Adding Code1064264 -Node: New Ports1070306 -Node: Derived Files1074441 -Ref: Derived Files-Footnote-11079762 -Ref: Derived Files-Footnote-21079796 -Ref: Derived Files-Footnote-31080396 -Node: Future Extensions1080494 -Node: Implementation Limitations1081075 -Node: Extension Design1082327 -Node: Old Extension Problems1083476 -Ref: Old Extension Problems-Footnote-11084984 -Node: Extension New Mechanism Goals1085041 -Ref: Extension New Mechanism Goals-Footnote-11088400 -Node: Extension Other Design Decisions1088586 -Node: Extension Future Growth1090692 -Node: Old Extension Mechansim1091513 -Node: Basic Concepts1093270 -Node: Basic High Level1093951 -Ref: figure-general-flow1094222 -Ref: figure-process-flow1094821 -Ref: Basic High Level-Footnote-11098050 -Node: Basic Data Typing1098235 -Node: Glossary1101590 -Node: Copying1126901 -Node: GNU Free Documentation License1164458 -Node: Index1189595 +Node: Indirect Calls551192 +Node: Library Functions560877 +Ref: Library Functions-Footnote-1564390 +Ref: Library Functions-Footnote-2564533 +Node: Library Names564704 +Ref: Library Names-Footnote-1568175 +Ref: Library Names-Footnote-2568395 +Node: General Functions568481 +Node: Strtonum Function569434 +Node: Assert Function572364 +Node: Round Function575690 +Node: Cliff Random Function577233 +Node: Ordinal Functions578249 +Ref: Ordinal Functions-Footnote-1581319 +Ref: Ordinal Functions-Footnote-2581571 +Node: Join Function581780 +Ref: Join Function-Footnote-1583551 +Node: Getlocaltime Function583751 +Node: Data File Management587466 +Node: Filetrans Function588098 +Node: Rewind Function592237 +Node: File Checking593624 +Node: Empty Files594718 +Node: Ignoring Assigns596948 +Node: Getopt Function598501 +Ref: Getopt Function-Footnote-1609805 +Node: Passwd Functions610008 +Ref: Passwd Functions-Footnote-1618983 +Node: Group Functions619071 +Node: Walking Arrays627155 +Node: Sample Programs628724 +Node: Running Examples629401 +Node: Clones630129 +Node: Cut Program631353 +Node: Egrep Program641198 +Ref: Egrep Program-Footnote-1648971 +Node: Id Program649081 +Node: Split Program652697 +Ref: Split Program-Footnote-1656216 +Node: Tee Program656344 +Node: Uniq Program659147 +Node: Wc Program666576 +Ref: Wc Program-Footnote-1670842 +Ref: Wc Program-Footnote-2671042 +Node: Miscellaneous Programs671134 +Node: Dupword Program672322 +Node: Alarm Program674353 +Node: Translate Program679102 +Ref: Translate Program-Footnote-1683489 +Ref: Translate Program-Footnote-2683717 +Node: Labels Program683851 +Ref: Labels Program-Footnote-1687222 +Node: Word Sorting687306 +Node: History Sorting691190 +Node: Extract Program693029 +Ref: Extract Program-Footnote-1700512 +Node: Simple Sed700640 +Node: Igawk Program703702 +Ref: Igawk Program-Footnote-1718859 +Ref: Igawk Program-Footnote-2719060 +Node: Anagram Program719198 +Node: Signature Program722266 +Node: Internationalization723366 +Node: I18N and L10N724798 +Node: Explaining gettext725484 +Ref: Explaining gettext-Footnote-1730550 +Ref: Explaining gettext-Footnote-2730734 +Node: Programmer i18n730899 +Node: Translator i18n735099 +Node: String Extraction735892 +Ref: String Extraction-Footnote-1736853 +Node: Printf Ordering736939 +Ref: Printf Ordering-Footnote-1739723 +Node: I18N Portability739787 +Ref: I18N Portability-Footnote-1742236 +Node: I18N Example742299 +Ref: I18N Example-Footnote-1744934 +Node: Gawk I18N745006 +Node: Advanced Features745623 +Node: Nondecimal Data747127 +Node: Array Sorting748710 +Node: Controlling Array Traversal749407 +Node: Array Sorting Functions757645 +Ref: Array Sorting Functions-Footnote-1761319 +Ref: Array Sorting Functions-Footnote-2761412 +Node: Two-way I/O761606 +Ref: Two-way I/O-Footnote-1767038 +Node: TCP/IP Networking767108 +Node: Profiling769952 +Node: Debugger777406 +Node: Debugging778374 +Node: Debugging Concepts778807 +Node: Debugging Terms780663 +Node: Awk Debugging783260 +Node: Sample Debugging Session784152 +Node: Debugger Invocation784672 +Node: Finding The Bug786001 +Node: List of Debugger Commands792489 +Node: Breakpoint Control793823 +Node: Debugger Execution Control797487 +Node: Viewing And Changing Data800847 +Node: Execution Stack804203 +Node: Debugger Info805670 +Node: Miscellaneous Debugger Commands809651 +Node: Readline Support815096 +Node: Limitations815927 +Node: Arbitrary Precision Arithmetic818179 +Ref: Arbitrary Precision Arithmetic-Footnote-1819821 +Node: General Arithmetic819969 +Node: Floating Point Issues821689 +Node: String Conversion Precision822570 +Ref: String Conversion Precision-Footnote-1824276 +Node: Unexpected Results824385 +Node: POSIX Floating Point Problems826538 +Ref: POSIX Floating Point Problems-Footnote-1830363 +Node: Integer Programming830401 +Node: Floating-point Programming832154 +Ref: Floating-point Programming-Footnote-1838463 +Node: Floating-point Representation838727 +Node: Floating-point Context839892 +Ref: table-ieee-formats840734 +Node: Rounding Mode842118 +Ref: table-rounding-modes842597 +Ref: Rounding Mode-Footnote-1845601 +Node: Gawk and MPFR845782 +Node: Arbitrary Precision Floats847024 +Ref: Arbitrary Precision Floats-Footnote-1849453 +Node: Setting Precision849764 +Node: Setting Rounding Mode852497 +Ref: table-gawk-rounding-modes852901 +Node: Floating-point Constants854081 +Node: Changing Precision855505 +Ref: Changing Precision-Footnote-1856905 +Node: Exact Arithmetic857079 +Node: Arbitrary Precision Integers860187 +Ref: Arbitrary Precision Integers-Footnote-1863187 +Node: Dynamic Extensions863334 +Node: Extension Intro864711 +Node: Plugin License865919 +Node: Extension Mechanism Outline866604 +Ref: load-extension867021 +Ref: load-new-function868499 +Ref: call-new-function869480 +Node: Extension API Description871474 +Node: Extension API Functions Introduction872813 +Node: General Data Types877591 +Ref: General Data Types-Footnote-1883193 +Node: Requesting Values883492 +Ref: table-value-types-returned884223 +Node: Constructor Functions885177 +Node: Registration Functions888173 +Node: Extension Functions888858 +Node: Exit Callback Functions891032 +Node: Extension Version String892275 +Node: Input Parsers892925 +Node: Output Wrappers902642 +Node: Two-way processors907058 +Node: Printing Messages909188 +Ref: Printing Messages-Footnote-1910265 +Node: Updating `ERRNO'910417 +Node: Accessing Parameters911156 +Node: Symbol Table Access912386 +Node: Symbol table by name912898 +Node: Symbol table by cookie914471 +Ref: Symbol table by cookie-Footnote-1918600 +Node: Cached values918663 +Ref: Cached values-Footnote-1922106 +Node: Array Manipulation922197 +Ref: Array Manipulation-Footnote-1923295 +Node: Array Data Types923334 +Ref: Array Data Types-Footnote-1926037 +Node: Array Functions926129 +Node: Flattening Arrays929895 +Node: Creating Arrays936734 +Node: Extension API Variables941529 +Node: Extension Versioning942165 +Node: Extension API Informational Variables944066 +Node: Extension API Boilerplate945152 +Node: Finding Extensions948983 +Node: Extension Example949530 +Node: Internal File Description950268 +Node: Internal File Ops953956 +Ref: Internal File Ops-Footnote-1965403 +Node: Using Internal File Ops965543 +Ref: Using Internal File Ops-Footnote-1967896 +Node: Extension Samples968162 +Node: Extension Sample File Functions969686 +Node: Extension Sample Fnmatch978159 +Node: Extension Sample Fork979885 +Node: Extension Sample Inplace981103 +Node: Extension Sample Ord982895 +Node: Extension Sample Readdir983674 +Node: Extension Sample Revout985178 +Node: Extension Sample Rev2way985771 +Node: Extension Sample Read write array986461 +Node: Extension Sample Readfile988344 +Node: Extension Sample API Tests989101 +Node: Extension Sample Time989626 +Node: gawkextlib990933 +Node: Language History993314 +Node: V7/SVR3.1994836 +Node: SVR4997157 +Node: POSIX998599 +Node: BTL999607 +Node: POSIX/GNU1000412 +Node: Common Extensions1005947 +Node: Ranges and Locales1007054 +Ref: Ranges and Locales-Footnote-11011672 +Ref: Ranges and Locales-Footnote-21011699 +Ref: Ranges and Locales-Footnote-31011959 +Node: Contributors1012180 +Node: Installation1016476 +Node: Gawk Distribution1017370 +Node: Getting1017854 +Node: Extracting1018680 +Node: Distribution contents1020372 +Node: Unix Installation1025633 +Node: Quick Installation1026250 +Node: Additional Configuration Options1028212 +Node: Configuration Philosophy1029689 +Node: Non-Unix Installation1032031 +Node: PC Installation1032489 +Node: PC Binary Installation1033788 +Node: PC Compiling1035636 +Node: PC Testing1038580 +Node: PC Using1039756 +Node: Cygwin1043941 +Node: MSYS1044941 +Node: VMS Installation1045455 +Node: VMS Compilation1046058 +Ref: VMS Compilation-Footnote-11047065 +Node: VMS Installation Details1047123 +Node: VMS Running1048758 +Node: VMS Old Gawk1050365 +Node: Bugs1050839 +Node: Other Versions1054691 +Node: Notes1060347 +Node: Compatibility Mode1061147 +Node: Additions1061930 +Node: Accessing The Source1062857 +Node: Adding Code1064460 +Node: New Ports1070502 +Node: Derived Files1074637 +Ref: Derived Files-Footnote-11079958 +Ref: Derived Files-Footnote-21079992 +Ref: Derived Files-Footnote-31080592 +Node: Future Extensions1080690 +Node: Implementation Limitations1081271 +Node: Extension Design1082523 +Node: Old Extension Problems1083672 +Ref: Old Extension Problems-Footnote-11085180 +Node: Extension New Mechanism Goals1085237 +Ref: Extension New Mechanism Goals-Footnote-11088596 +Node: Extension Other Design Decisions1088782 +Node: Extension Future Growth1090888 +Node: Old Extension Mechansim1091709 +Node: Basic Concepts1093466 +Node: Basic High Level1094147 +Ref: figure-general-flow1094418 +Ref: figure-process-flow1095017 +Ref: Basic High Level-Footnote-11098246 +Node: Basic Data Typing1098431 +Node: Glossary1101786 +Node: Copying1127097 +Node: GNU Free Documentation License1164654 +Node: Index1189791 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 7c59d385..941d8e04 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -17611,6 +17611,11 @@ BEGIN @{ @} @end example +In this example, the first call to @code{foo()} generates +a fatal error, so @command{gawk} will not report the second +error. If you comment out that call, though, then @command{gawk} +will report the second error. + Usually, such things aren't a big issue, but it's worth being aware of them. @c ENDOFRANGE udfunc |