aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorArnold D. Robbins <arnold@skeeve.com>2013-04-27 22:45:09 +0300
committerArnold D. Robbins <arnold@skeeve.com>2013-04-27 22:45:09 +0300
commit7a60bda0777c6779429c40a1865acfdba6fa5d3e (patch)
treebb1670b40d11edb48c0f894114ae81112c923710
parenteff09e28536a4ebd4b178bd71a00b258c316e1bf (diff)
downloadegawk-7a60bda0777c6779429c40a1865acfdba6fa5d3e.tar.gz
egawk-7a60bda0777c6779429c40a1865acfdba6fa5d3e.tar.bz2
egawk-7a60bda0777c6779429c40a1865acfdba6fa5d3e.zip
Add a reference to a book on Computer Math.
-rw-r--r--doc/ChangeLog2
-rw-r--r--doc/gawk.info316
-rw-r--r--doc/gawk.texi7
-rw-r--r--doc/gawktexi.in7
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.