diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2013-04-27 22:45:09 +0300 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2013-04-27 22:45:09 +0300 |
commit | 7a60bda0777c6779429c40a1865acfdba6fa5d3e (patch) | |
tree | bb1670b40d11edb48c0f894114ae81112c923710 | |
parent | eff09e28536a4ebd4b178bd71a00b258c316e1bf (diff) | |
download | egawk-7a60bda0777c6779429c40a1865acfdba6fa5d3e.tar.gz egawk-7a60bda0777c6779429c40a1865acfdba6fa5d3e.tar.bz2 egawk-7a60bda0777c6779429c40a1865acfdba6fa5d3e.zip |
Add a reference to a book on Computer Math.
-rw-r--r-- | doc/ChangeLog | 2 | ||||
-rw-r--r-- | doc/gawk.info | 316 | ||||
-rw-r--r-- | doc/gawk.texi | 7 | ||||
-rw-r--r-- | doc/gawktexi.in | 7 |
4 files changed, 175 insertions, 157 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 0a8ac224..f27efbad 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,6 +1,8 @@ 2013-04-27 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Renamed from gawkman.texi. + Add a reference to Overton's IEEE Math book in MPFR chapter. + Thanks to Nelson Beebe for the recommendation. * Makefile.am, sidebar.awk: Adjusted. 2013-04-26 Arnold D. Robbins <arnold@skeeve.com> diff --git a/doc/gawk.info b/doc/gawk.info index b5d7052b..7e013b6e 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -20686,9 +20686,9 @@ File: gawk.info, Node: Floating-point Programming, Next: Gawk and MPFR, Prev: Numerical programming is an extensive area; if you need to develop sophisticated numerical algorithms then `gawk' may not be the ideal tool, and this documentation may not be sufficient. It might require -digesting a book or two to really internalize how to compute with ideal -accuracy and precision, and the result often depends on the particular -application. +digesting a book or two(1) to really internalize how to compute with +ideal accuracy and precision, and the result often depends on the +particular application. NOTE: A floating-point calculation's "accuracy" is how close it comes to the real value. This is as opposed to the "precision", @@ -20702,7 +20702,7 @@ hardware floating-point (as used by standard `awk' and the default for `gawk'), and "arbitrary-precision" floating-point, which is software based. From this point forward, this major node aims to provide enough information to understand both, and then will focus on `gawk''s -facilities for the latter.(1) +facilities for the latter.(2) Binary floating-point representations and arithmetic are inexact. Simple values like 0.1 cannot be precisely represented using binary @@ -20832,7 +20832,12 @@ implies better precision than is actually the case. ---------- Footnotes ---------- - (1) If you are interested in other tools that perform arbitrary + (1) One recommended title is `Numerical Computing with IEEE Floating +Point Arithmetic', Michael L. Overton, Society for Industrial and +Applied Mathematics, 2004. ISBN: 0-89871-482-6, ISBN-13: +978-0-89871-482-1. See `http://www.cs.nyu.edu/cs/faculty/overton/book'. + + (2) If you are interested in other tools that perform arbitrary precision arithmetic, you may want to investigate the POSIX `bc' tool. See the POSIX specification for it (http://pubs.opengroup.org/onlinepubs/009695399/utilities/bc.html), for @@ -32380,155 +32385,156 @@ Node: POSIX Floating Point Problems827544 Ref: POSIX Floating Point Problems-Footnote-1831369 Node: Integer Programming831407 Node: Floating-point Programming833146 -Ref: Floating-point Programming-Footnote-1839474 -Node: Floating-point Representation839738 -Node: Floating-point Context840903 -Ref: table-ieee-formats841742 -Node: Rounding Mode843126 -Ref: table-rounding-modes843605 -Ref: Rounding Mode-Footnote-1846620 -Node: Gawk and MPFR846799 -Node: Arbitrary Precision Floats848054 -Ref: Arbitrary Precision Floats-Footnote-1850497 -Node: Setting Precision850813 -Ref: table-predefined-precision-strings851499 -Node: Setting Rounding Mode853644 -Ref: table-gawk-rounding-modes854048 -Node: Floating-point Constants855235 -Node: Changing Precision856664 -Ref: Changing Precision-Footnote-1858064 -Node: Exact Arithmetic858238 -Node: Arbitrary Precision Integers861376 -Ref: Arbitrary Precision Integers-Footnote-1864394 -Node: Dynamic Extensions864541 -Node: Extension Intro865999 -Node: Plugin License867264 -Node: Extension Mechanism Outline867949 -Ref: load-extension868366 -Ref: load-new-function869844 -Ref: call-new-function870839 -Node: Extension API Description872854 -Node: Extension API Functions Introduction874067 -Node: General Data Types878933 -Ref: General Data Types-Footnote-1884535 -Node: Requesting Values884834 -Ref: table-value-types-returned885565 -Node: Constructor Functions886519 -Node: Registration Functions889539 -Node: Extension Functions890224 -Node: Exit Callback Functions892449 -Node: Extension Version String893698 -Node: Input Parsers894348 -Node: Output Wrappers904105 -Node: Two-way processors908615 -Node: Printing Messages910823 -Ref: Printing Messages-Footnote-1911900 -Node: Updating `ERRNO'912052 -Node: Accessing Parameters912791 -Node: Symbol Table Access914021 -Node: Symbol table by name914533 -Node: Symbol table by cookie916280 -Ref: Symbol table by cookie-Footnote-1920410 -Node: Cached values920473 -Ref: Cached values-Footnote-1923922 -Node: Array Manipulation924013 -Ref: Array Manipulation-Footnote-1925111 -Node: Array Data Types925150 -Ref: Array Data Types-Footnote-1927853 -Node: Array Functions927945 -Node: Flattening Arrays931711 -Node: Creating Arrays938563 -Node: Extension API Variables943288 -Node: Extension Versioning943924 -Node: Extension API Informational Variables945825 -Node: Extension API Boilerplate946911 -Node: Finding Extensions950715 -Node: Extension Example951275 -Node: Internal File Description952006 -Node: Internal File Ops955694 -Ref: Internal File Ops-Footnote-1967178 -Node: Using Internal File Ops967318 -Ref: Using Internal File Ops-Footnote-1969671 -Node: Extension Samples969937 -Node: Extension Sample File Functions971461 -Node: Extension Sample Fnmatch979948 -Node: Extension Sample Fork981674 -Node: Extension Sample Inplace982892 -Node: Extension Sample Ord984670 -Node: Extension Sample Readdir985506 -Node: Extension Sample Revout987038 -Node: Extension Sample Rev2way987631 -Node: Extension Sample Read write array988321 -Node: Extension Sample Readfile990204 -Node: Extension Sample API Tests991022 -Node: Extension Sample Time991547 -Node: gawkextlib992911 -Node: Language History995342 -Node: V7/SVR3.1996864 -Node: SVR4999185 -Node: POSIX1000627 -Node: BTL1002013 -Node: POSIX/GNU1002747 -Node: Common Extensions1008282 -Node: Ranges and Locales1009437 -Ref: Ranges and Locales-Footnote-11014055 -Ref: Ranges and Locales-Footnote-21014082 -Ref: Ranges and Locales-Footnote-31014342 -Node: Contributors1014563 -Node: Installation1019367 -Node: Gawk Distribution1020261 -Node: Getting1020745 -Node: Extracting1021571 -Node: Distribution contents1023263 -Node: Unix Installation1028524 -Node: Quick Installation1029141 -Node: Additional Configuration Options1031103 -Node: Configuration Philosophy1032580 -Node: Non-Unix Installation1034922 -Node: PC Installation1035380 -Node: PC Binary Installation1036679 -Node: PC Compiling1038527 -Node: PC Testing1041471 -Node: PC Using1042647 -Node: Cygwin1046832 -Node: MSYS1047832 -Node: VMS Installation1048346 -Node: VMS Compilation1048949 -Ref: VMS Compilation-Footnote-11049956 -Node: VMS Installation Details1050014 -Node: VMS Running1051649 -Node: VMS Old Gawk1053256 -Node: Bugs1053730 -Node: Other Versions1057582 -Node: Notes1063183 -Node: Compatibility Mode1063983 -Node: Additions1064766 -Node: Accessing The Source1065693 -Node: Adding Code1067133 -Node: New Ports1073178 -Node: Derived Files1077313 -Ref: Derived Files-Footnote-11082634 -Ref: Derived Files-Footnote-21082668 -Ref: Derived Files-Footnote-31083268 -Node: Future Extensions1083366 -Node: Implementation Limitations1083947 -Node: Extension Design1085199 -Node: Old Extension Problems1086353 -Ref: Old Extension Problems-Footnote-11087861 -Node: Extension New Mechanism Goals1087918 -Ref: Extension New Mechanism Goals-Footnote-11091284 -Node: Extension Other Design Decisions1091470 -Node: Extension Future Growth1093576 -Node: Old Extension Mechanism1094412 -Node: Basic Concepts1096152 -Node: Basic High Level1096833 -Ref: figure-general-flow1097104 -Ref: figure-process-flow1097703 -Ref: Basic High Level-Footnote-11100932 -Node: Basic Data Typing1101117 -Node: Glossary1104472 -Node: Copying1129943 -Node: GNU Free Documentation License1167500 -Node: Index1192637 +Ref: Floating-point Programming-Footnote-1839477 +Ref: Floating-point Programming-Footnote-2839747 +Node: Floating-point Representation840011 +Node: Floating-point Context841176 +Ref: table-ieee-formats842015 +Node: Rounding Mode843399 +Ref: table-rounding-modes843878 +Ref: Rounding Mode-Footnote-1846893 +Node: Gawk and MPFR847072 +Node: Arbitrary Precision Floats848327 +Ref: Arbitrary Precision Floats-Footnote-1850770 +Node: Setting Precision851086 +Ref: table-predefined-precision-strings851772 +Node: Setting Rounding Mode853917 +Ref: table-gawk-rounding-modes854321 +Node: Floating-point Constants855508 +Node: Changing Precision856937 +Ref: Changing Precision-Footnote-1858337 +Node: Exact Arithmetic858511 +Node: Arbitrary Precision Integers861649 +Ref: Arbitrary Precision Integers-Footnote-1864667 +Node: Dynamic Extensions864814 +Node: Extension Intro866272 +Node: Plugin License867537 +Node: Extension Mechanism Outline868222 +Ref: load-extension868639 +Ref: load-new-function870117 +Ref: call-new-function871112 +Node: Extension API Description873127 +Node: Extension API Functions Introduction874340 +Node: General Data Types879206 +Ref: General Data Types-Footnote-1884808 +Node: Requesting Values885107 +Ref: table-value-types-returned885838 +Node: Constructor Functions886792 +Node: Registration Functions889812 +Node: Extension Functions890497 +Node: Exit Callback Functions892722 +Node: Extension Version String893971 +Node: Input Parsers894621 +Node: Output Wrappers904378 +Node: Two-way processors908888 +Node: Printing Messages911096 +Ref: Printing Messages-Footnote-1912173 +Node: Updating `ERRNO'912325 +Node: Accessing Parameters913064 +Node: Symbol Table Access914294 +Node: Symbol table by name914806 +Node: Symbol table by cookie916553 +Ref: Symbol table by cookie-Footnote-1920683 +Node: Cached values920746 +Ref: Cached values-Footnote-1924195 +Node: Array Manipulation924286 +Ref: Array Manipulation-Footnote-1925384 +Node: Array Data Types925423 +Ref: Array Data Types-Footnote-1928126 +Node: Array Functions928218 +Node: Flattening Arrays931984 +Node: Creating Arrays938836 +Node: Extension API Variables943561 +Node: Extension Versioning944197 +Node: Extension API Informational Variables946098 +Node: Extension API Boilerplate947184 +Node: Finding Extensions950988 +Node: Extension Example951548 +Node: Internal File Description952279 +Node: Internal File Ops955967 +Ref: Internal File Ops-Footnote-1967451 +Node: Using Internal File Ops967591 +Ref: Using Internal File Ops-Footnote-1969944 +Node: Extension Samples970210 +Node: Extension Sample File Functions971734 +Node: Extension Sample Fnmatch980221 +Node: Extension Sample Fork981947 +Node: Extension Sample Inplace983165 +Node: Extension Sample Ord984943 +Node: Extension Sample Readdir985779 +Node: Extension Sample Revout987311 +Node: Extension Sample Rev2way987904 +Node: Extension Sample Read write array988594 +Node: Extension Sample Readfile990477 +Node: Extension Sample API Tests991295 +Node: Extension Sample Time991820 +Node: gawkextlib993184 +Node: Language History995615 +Node: V7/SVR3.1997137 +Node: SVR4999458 +Node: POSIX1000900 +Node: BTL1002286 +Node: POSIX/GNU1003020 +Node: Common Extensions1008555 +Node: Ranges and Locales1009710 +Ref: Ranges and Locales-Footnote-11014328 +Ref: Ranges and Locales-Footnote-21014355 +Ref: Ranges and Locales-Footnote-31014615 +Node: Contributors1014836 +Node: Installation1019640 +Node: Gawk Distribution1020534 +Node: Getting1021018 +Node: Extracting1021844 +Node: Distribution contents1023536 +Node: Unix Installation1028797 +Node: Quick Installation1029414 +Node: Additional Configuration Options1031376 +Node: Configuration Philosophy1032853 +Node: Non-Unix Installation1035195 +Node: PC Installation1035653 +Node: PC Binary Installation1036952 +Node: PC Compiling1038800 +Node: PC Testing1041744 +Node: PC Using1042920 +Node: Cygwin1047105 +Node: MSYS1048105 +Node: VMS Installation1048619 +Node: VMS Compilation1049222 +Ref: VMS Compilation-Footnote-11050229 +Node: VMS Installation Details1050287 +Node: VMS Running1051922 +Node: VMS Old Gawk1053529 +Node: Bugs1054003 +Node: Other Versions1057855 +Node: Notes1063456 +Node: Compatibility Mode1064256 +Node: Additions1065039 +Node: Accessing The Source1065966 +Node: Adding Code1067406 +Node: New Ports1073451 +Node: Derived Files1077586 +Ref: Derived Files-Footnote-11082907 +Ref: Derived Files-Footnote-21082941 +Ref: Derived Files-Footnote-31083541 +Node: Future Extensions1083639 +Node: Implementation Limitations1084220 +Node: Extension Design1085472 +Node: Old Extension Problems1086626 +Ref: Old Extension Problems-Footnote-11088134 +Node: Extension New Mechanism Goals1088191 +Ref: Extension New Mechanism Goals-Footnote-11091557 +Node: Extension Other Design Decisions1091743 +Node: Extension Future Growth1093849 +Node: Old Extension Mechanism1094685 +Node: Basic Concepts1096425 +Node: Basic High Level1097106 +Ref: figure-general-flow1097377 +Ref: figure-process-flow1097976 +Ref: Basic High Level-Footnote-11101205 +Node: Basic Data Typing1101390 +Node: Glossary1104745 +Node: Copying1130216 +Node: GNU Free Documentation License1167773 +Node: Index1192910 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 7c53fc14..fcd07a07 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -28363,7 +28363,12 @@ around on your screen. Numerical programming is an extensive area; if you need to develop sophisticated numerical algorithms then @command{gawk} may not be the ideal tool, and this documentation may not be sufficient. -It might require digesting a book or two to really internalize how to compute +It might require digesting a book or two@footnote{One recommended title is +@cite{Numerical Computing with IEEE Floating Point Arithmetic}, Michael L.@: +Overton, Society for Industrial and Applied Mathematics, 2004. +ISBN: 0-89871-482-6, ISBN-13: 978-0-89871-482-1. See +@uref{http://www.cs.nyu.edu/cs/faculty/overton/book}.} +to really internalize how to compute with ideal accuracy and precision, and the result often depends on the particular application. diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 084145f8..799c172f 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -27512,7 +27512,12 @@ around on your screen. Numerical programming is an extensive area; if you need to develop sophisticated numerical algorithms then @command{gawk} may not be the ideal tool, and this documentation may not be sufficient. -It might require digesting a book or two to really internalize how to compute +It might require digesting a book or two@footnote{One recommended title is +@cite{Numerical Computing with IEEE Floating Point Arithmetic}, Michael L.@: +Overton, Society for Industrial and Applied Mathematics, 2004. +ISBN: 0-89871-482-6, ISBN-13: 978-0-89871-482-1. See +@uref{http://www.cs.nyu.edu/cs/faculty/overton/book}.} +to really internalize how to compute with ideal accuracy and precision, and the result often depends on the particular application. |