Merge branch 'gawk-4.1-stable'

4 files changed, 423 insertions, 368 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index abd8cdfe..fce2f3c6 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2016-07-12         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in (Auto-set): Add example use of multiply function.
+
 2016-06-30         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawk.1: Typo fix. Thanks to Antonio Giovanni Colombo
diff --git a/doc/gawk.info b/doc/gawk.info
index 2a190873..0c2c9597 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -10746,6 +10746,19 @@ they are not special:
               return SYMTAB[variable] *= amount
           }
 
+     You would use it like this:
+
+          BEGIN {
+              answer = 10.5
+              multiply("answer", 4)
+              print "The answer is", answer
+          }
+
+     When run, this produces:
+
+          $ gawk -f answer.awk
+          -| The answer is 42
+
           NOTE: In order to avoid severe time-travel paradoxes,(2)
           neither 'FUNCTAB' nor 'SYMTAB' is available as an element
           within the 'SYMTAB' array.
@@ -33036,7 +33049,7 @@ Index
 * dark corner, field separators:         Full Line Fields.    (line  22)
 * dark corner, FILENAME variable:        Getline Notes.       (line  19)
 * dark corner, FILENAME variable <1>:    Auto-set.            (line 108)
-* dark corner, FNR/NR variables:         Auto-set.            (line 344)
+* dark corner, FNR/NR variables:         Auto-set.            (line 357)
 * dark corner, format-control characters: Control Letters.    (line  18)
 * dark corner, format-control characters <1>: Control Letters.
                                                               (line  93)
@@ -33593,7 +33606,7 @@ Index
                                                               (line  12)
 * FNR variable:                          Records.             (line   6)
 * FNR variable <1>:                      Auto-set.            (line 118)
-* FNR variable, changing:                Auto-set.            (line 344)
+* FNR variable, changing:                Auto-set.            (line 357)
 * for statement:                         For Statement.       (line   6)
 * for statement, looping over arrays:    Scanning an Array.   (line  20)
 * fork() extension function:             Extension Sample Fork.
@@ -34247,7 +34260,7 @@ Index
 * not Boolean-logic operator:            Boolean Ops.         (line   6)
 * NR variable:                           Records.             (line   6)
 * NR variable <1>:                       Auto-set.            (line 143)
-* NR variable, changing:                 Auto-set.            (line 344)
+* NR variable, changing:                 Auto-set.            (line 357)
 * null strings:                          awk split records.   (line 114)
 * null strings <1>:                      Regexp Field Splitting.
                                                               (line  43)
@@ -34846,7 +34859,7 @@ Index
                                                               (line 106)
 * sidebar, Changing FS Does Not Affect the Fields: Full Line Fields.
                                                               (line  14)
-* sidebar, Changing NR and FNR:          Auto-set.            (line 342)
+* sidebar, Changing NR and FNR:          Auto-set.            (line 355)
 * sidebar, Controlling Output Buffering with system(): I/O Functions.
                                                               (line 164)
 * sidebar, Escape Sequences for Metacharacters: Escape Sequences.
@@ -35466,365 +35479,365 @@ Node: Exit Statement438161
 Node: Built-in Variables440564
 Node: User-modified441697
 Node: Auto-set449283
-Ref: Auto-set-Footnote-1463670
-Ref: Auto-set-Footnote-2463876
-Node: ARGC and ARGV463932
-Node: Pattern Action Summary468145
-Node: Arrays470575
-Node: Array Basics471904
-Node: Array Intro472748
-Ref: figure-array-elements474723
-Ref: Array Intro-Footnote-1477427
-Node: Reference to Elements477555
-Node: Assigning Elements480019
-Node: Array Example480510
-Node: Scanning an Array482269
-Node: Controlling Scanning485291
-Ref: Controlling Scanning-Footnote-1490690
-Node: Numeric Array Subscripts491006
-Node: Uninitialized Subscripts493190
-Node: Delete494809
-Ref: Delete-Footnote-1497561
-Node: Multidimensional497618
-Node: Multiscanning500713
-Node: Arrays of Arrays502304
-Node: Arrays Summary507071
-Node: Functions509164
-Node: Built-in510202
-Node: Calling Built-in511283
-Node: Numeric Functions513279
-Ref: Numeric Functions-Footnote-1518112
-Ref: Numeric Functions-Footnote-2518469
-Ref: Numeric Functions-Footnote-3518517
-Node: String Functions518789
-Ref: String Functions-Footnote-1542293
-Ref: String Functions-Footnote-2542421
-Ref: String Functions-Footnote-3542669
-Node: Gory Details542756
-Ref: table-sub-escapes544547
-Ref: table-sub-proposed546066
-Ref: table-posix-sub547429
-Ref: table-gensub-escapes548970
-Ref: Gory Details-Footnote-1549793
-Node: I/O Functions549947
-Ref: table-system-return-values556529
-Ref: I/O Functions-Footnote-1558509
-Ref: I/O Functions-Footnote-2558657
-Node: Time Functions558777
-Ref: Time Functions-Footnote-1569282
-Ref: Time Functions-Footnote-2569350
-Ref: Time Functions-Footnote-3569508
-Ref: Time Functions-Footnote-4569619
-Ref: Time Functions-Footnote-5569731
-Ref: Time Functions-Footnote-6569958
-Node: Bitwise Functions570224
-Ref: table-bitwise-ops570818
-Ref: Bitwise Functions-Footnote-1575156
-Node: Type Functions575329
-Node: I18N Functions577990
-Node: User-defined579641
-Node: Definition Syntax580446
-Ref: Definition Syntax-Footnote-1586133
-Node: Function Example586204
-Ref: Function Example-Footnote-1589126
-Node: Function Caveats589148
-Node: Calling A Function589666
-Node: Variable Scope590624
-Node: Pass By Value/Reference593618
-Node: Return Statement597117
-Node: Dynamic Typing600096
-Node: Indirect Calls601026
-Ref: Indirect Calls-Footnote-1611277
-Node: Functions Summary611405
-Node: Library Functions614110
-Ref: Library Functions-Footnote-1617717
-Ref: Library Functions-Footnote-2617860
-Node: Library Names618031
-Ref: Library Names-Footnote-1621491
-Ref: Library Names-Footnote-2621714
-Node: General Functions621800
-Node: Strtonum Function622903
-Node: Assert Function625925
-Node: Round Function629251
-Node: Cliff Random Function630792
-Node: Ordinal Functions631808
-Ref: Ordinal Functions-Footnote-1634871
-Ref: Ordinal Functions-Footnote-2635123
-Node: Join Function635333
-Ref: Join Function-Footnote-1637103
-Node: Getlocaltime Function637303
-Node: Readfile Function641045
-Node: Shell Quoting643017
-Node: Data File Management644418
-Node: Filetrans Function645050
-Node: Rewind Function649146
-Node: File Checking651051
-Ref: File Checking-Footnote-1652385
-Node: Empty Files652586
-Node: Ignoring Assigns654565
-Node: Getopt Function656115
-Ref: Getopt Function-Footnote-1667584
-Node: Passwd Functions667784
-Ref: Passwd Functions-Footnote-1676623
-Node: Group Functions676711
-Ref: Group Functions-Footnote-1684608
-Node: Walking Arrays684815
-Node: Library Functions Summary687823
-Node: Library Exercises689229
-Node: Sample Programs689694
-Node: Running Examples690464
-Node: Clones691192
-Node: Cut Program692416
-Node: Egrep Program702345
-Ref: Egrep Program-Footnote-1709857
-Node: Id Program709967
-Node: Split Program713647
-Ref: Split Program-Footnote-1717106
-Node: Tee Program717235
-Node: Uniq Program720025
-Node: Wc Program727451
-Ref: Wc Program-Footnote-1731706
-Node: Miscellaneous Programs731800
-Node: Dupword Program733013
-Node: Alarm Program735043
-Node: Translate Program739898
-Ref: Translate Program-Footnote-1744463
-Node: Labels Program744733
-Ref: Labels Program-Footnote-1748084
-Node: Word Sorting748168
-Node: History Sorting752240
-Node: Extract Program754075
-Node: Simple Sed761604
-Node: Igawk Program764678
-Ref: Igawk Program-Footnote-1779009
-Ref: Igawk Program-Footnote-2779211
-Ref: Igawk Program-Footnote-3779333
-Node: Anagram Program779448
-Node: Signature Program782510
-Node: Programs Summary783757
-Node: Programs Exercises784971
-Ref: Programs Exercises-Footnote-1789100
-Node: Advanced Features789191
-Node: Nondecimal Data791181
-Node: Array Sorting792772
-Node: Controlling Array Traversal793472
-Ref: Controlling Array Traversal-Footnote-1801839
-Node: Array Sorting Functions801957
-Ref: Array Sorting Functions-Footnote-1807048
-Node: Two-way I/O807244
-Ref: Two-way I/O-Footnote-1813794
-Ref: Two-way I/O-Footnote-2813981
-Node: TCP/IP Networking814063
-Node: Profiling817181
-Ref: Profiling-Footnote-1825674
-Node: Advanced Features Summary825997
-Node: Internationalization827841
-Node: I18N and L10N829321
-Node: Explaining gettext830008
-Ref: Explaining gettext-Footnote-1835031
-Ref: Explaining gettext-Footnote-2835216
-Node: Programmer i18n835381
-Ref: Programmer i18n-Footnote-1840236
-Node: Translator i18n840285
-Node: String Extraction841079
-Ref: String Extraction-Footnote-1842211
-Node: Printf Ordering842297
-Ref: Printf Ordering-Footnote-1845083
-Node: I18N Portability845147
-Ref: I18N Portability-Footnote-1847603
-Node: I18N Example847666
-Ref: I18N Example-Footnote-1850472
-Node: Gawk I18N850545
-Node: I18N Summary851190
-Node: Debugger852531
-Node: Debugging853553
-Node: Debugging Concepts853994
-Node: Debugging Terms855803
-Node: Awk Debugging858378
-Node: Sample Debugging Session859284
-Node: Debugger Invocation859818
-Node: Finding The Bug861204
-Node: List of Debugger Commands867682
-Node: Breakpoint Control869015
-Node: Debugger Execution Control872709
-Node: Viewing And Changing Data876071
-Node: Execution Stack879445
-Node: Debugger Info881082
-Node: Miscellaneous Debugger Commands885153
-Node: Readline Support890241
-Node: Limitations891137
-Ref: Limitations-Footnote-1895368
-Node: Debugging Summary895419
-Node: Arbitrary Precision Arithmetic896698
-Node: Computer Arithmetic898114
-Ref: table-numeric-ranges901705
-Ref: Computer Arithmetic-Footnote-1902427
-Node: Math Definitions902484
-Ref: table-ieee-formats905798
-Ref: Math Definitions-Footnote-1906401
-Node: MPFR features906506
-Node: FP Math Caution908223
-Ref: FP Math Caution-Footnote-1909295
-Node: Inexactness of computations909664
-Node: Inexact representation910624
-Node: Comparing FP Values911984
-Node: Errors accumulate913066
-Node: Getting Accuracy914499
-Node: Try To Round917209
-Node: Setting precision918108
-Ref: table-predefined-precision-strings918805
-Node: Setting the rounding mode920635
-Ref: table-gawk-rounding-modes921009
-Ref: Setting the rounding mode-Footnote-1924417
-Node: Arbitrary Precision Integers924596
-Ref: Arbitrary Precision Integers-Footnote-1929513
-Node: POSIX Floating Point Problems929662
-Ref: POSIX Floating Point Problems-Footnote-1933544
-Node: Floating point summary933582
-Node: Dynamic Extensions935772
-Node: Extension Intro937325
-Node: Plugin License938591
-Node: Extension Mechanism Outline939388
-Ref: figure-load-extension939827
-Ref: figure-register-new-function941392
-Ref: figure-call-new-function942484
-Node: Extension API Description944546
-Node: Extension API Functions Introduction946078
-Node: General Data Types950937
-Ref: General Data Types-Footnote-1956892
-Node: Memory Allocation Functions957191
-Ref: Memory Allocation Functions-Footnote-1960036
-Node: Constructor Functions960135
-Node: Registration Functions961880
-Node: Extension Functions962565
-Node: Exit Callback Functions965188
-Node: Extension Version String966438
-Node: Input Parsers967101
-Node: Output Wrappers976983
-Node: Two-way processors981495
-Node: Printing Messages983760
-Ref: Printing Messages-Footnote-1984931
-Node: Updating ERRNO985084
-Node: Requesting Values985823
-Ref: table-value-types-returned986560
-Node: Accessing Parameters987443
-Node: Symbol Table Access988678
-Node: Symbol table by name989190
-Node: Symbol table by cookie991211
-Ref: Symbol table by cookie-Footnote-1995363
-Node: Cached values995427
-Ref: Cached values-Footnote-1998934
-Node: Array Manipulation999025
-Ref: Array Manipulation-Footnote-11000116
-Node: Array Data Types1000153
-Ref: Array Data Types-Footnote-11002811
-Node: Array Functions1002903
-Node: Flattening Arrays1006761
-Node: Creating Arrays1013669
-Node: Redirection API1018438
-Node: Extension API Variables1021269
-Node: Extension Versioning1021902
-Ref: gawk-api-version1022339
-Node: Extension API Informational Variables1024095
-Node: Extension API Boilerplate1025159
-Node: Finding Extensions1028973
-Node: Extension Example1029532
-Node: Internal File Description1030330
-Node: Internal File Ops1034410
-Ref: Internal File Ops-Footnote-11046172
-Node: Using Internal File Ops1046312
-Ref: Using Internal File Ops-Footnote-11048695
-Node: Extension Samples1048969
-Node: Extension Sample File Functions1050498
-Node: Extension Sample Fnmatch1058147
-Node: Extension Sample Fork1059634
-Node: Extension Sample Inplace1060852
-Node: Extension Sample Ord1064062
-Node: Extension Sample Readdir1064898
-Ref: table-readdir-file-types1065787
-Node: Extension Sample Revout1066592
-Node: Extension Sample Rev2way1067181
-Node: Extension Sample Read write array1067921
-Node: Extension Sample Readfile1069863
-Node: Extension Sample Time1070958
-Node: Extension Sample API Tests1072306
-Node: gawkextlib1072798
-Node: Extension summary1075245
-Node: Extension Exercises1078947
-Node: Language History1080444
-Node: V7/SVR3.11082100
-Node: SVR41084252
-Node: POSIX1085686
-Node: BTL1087065
-Node: POSIX/GNU1087794
-Node: Feature History1093656
-Node: Common Extensions1108026
-Node: Ranges and Locales1109309
-Ref: Ranges and Locales-Footnote-11113925
-Ref: Ranges and Locales-Footnote-21113952
-Ref: Ranges and Locales-Footnote-31114187
-Node: Contributors1114408
-Node: History summary1119977
-Node: Installation1121357
-Node: Gawk Distribution1122301
-Node: Getting1122785
-Node: Extracting1123746
-Node: Distribution contents1125384
-Node: Unix Installation1131478
-Node: Quick Installation1132160
-Node: Shell Startup Files1134574
-Node: Additional Configuration Options1135652
-Node: Configuration Philosophy1137457
-Node: Non-Unix Installation1139826
-Node: PC Installation1140284
-Node: PC Binary Installation1141604
-Node: PC Compiling1143456
-Ref: PC Compiling-Footnote-11146480
-Node: PC Testing1146589
-Node: PC Using1147769
-Node: Cygwin1151883
-Node: MSYS1152653
-Node: VMS Installation1153154
-Node: VMS Compilation1153945
-Ref: VMS Compilation-Footnote-11155174
-Node: VMS Dynamic Extensions1155232
-Node: VMS Installation Details1156917
-Node: VMS Running1159170
-Node: VMS GNV1163449
-Node: VMS Old Gawk1164184
-Node: Bugs1164655
-Node: Other Versions1168852
-Node: Installation summary1175436
-Node: Notes1176494
-Node: Compatibility Mode1177359
-Node: Additions1178141
-Node: Accessing The Source1179066
-Node: Adding Code1180501
-Node: New Ports1186720
-Node: Derived Files1191208
-Ref: Derived Files-Footnote-11196693
-Ref: Derived Files-Footnote-21196728
-Ref: Derived Files-Footnote-31197326
-Node: Future Extensions1197440
-Node: Implementation Limitations1198098
-Node: Extension Design1199281
-Node: Old Extension Problems1200435
-Ref: Old Extension Problems-Footnote-11201953
-Node: Extension New Mechanism Goals1202010
-Ref: Extension New Mechanism Goals-Footnote-11205374
-Node: Extension Other Design Decisions1205563
-Node: Extension Future Growth1207676
-Node: Old Extension Mechanism1208512
-Node: Notes summary1210275
-Node: Basic Concepts1211457
-Node: Basic High Level1212138
-Ref: figure-general-flow1212420
-Ref: figure-process-flow1213105
-Ref: Basic High Level-Footnote-11216406
-Node: Basic Data Typing1216591
-Node: Glossary1219919
-Node: Copying1251865
-Node: GNU Free Documentation License1289404
-Node: Index1314522
+Ref: Auto-set-Footnote-1463936
+Ref: Auto-set-Footnote-2464142
+Node: ARGC and ARGV464198
+Node: Pattern Action Summary468411
+Node: Arrays470841
+Node: Array Basics472170
+Node: Array Intro473014
+Ref: figure-array-elements474989
+Ref: Array Intro-Footnote-1477693
+Node: Reference to Elements477821
+Node: Assigning Elements480285
+Node: Array Example480776
+Node: Scanning an Array482535
+Node: Controlling Scanning485557
+Ref: Controlling Scanning-Footnote-1490956
+Node: Numeric Array Subscripts491272
+Node: Uninitialized Subscripts493456
+Node: Delete495075
+Ref: Delete-Footnote-1497827
+Node: Multidimensional497884
+Node: Multiscanning500979
+Node: Arrays of Arrays502570
+Node: Arrays Summary507337
+Node: Functions509430
+Node: Built-in510468
+Node: Calling Built-in511549
+Node: Numeric Functions513545
+Ref: Numeric Functions-Footnote-1518378
+Ref: Numeric Functions-Footnote-2518735
+Ref: Numeric Functions-Footnote-3518783
+Node: String Functions519055
+Ref: String Functions-Footnote-1542559
+Ref: String Functions-Footnote-2542687
+Ref: String Functions-Footnote-3542935
+Node: Gory Details543022
+Ref: table-sub-escapes544813
+Ref: table-sub-proposed546332
+Ref: table-posix-sub547695
+Ref: table-gensub-escapes549236
+Ref: Gory Details-Footnote-1550059
+Node: I/O Functions550213
+Ref: table-system-return-values556795
+Ref: I/O Functions-Footnote-1558775
+Ref: I/O Functions-Footnote-2558923
+Node: Time Functions559043
+Ref: Time Functions-Footnote-1569548
+Ref: Time Functions-Footnote-2569616
+Ref: Time Functions-Footnote-3569774
+Ref: Time Functions-Footnote-4569885
+Ref: Time Functions-Footnote-5569997
+Ref: Time Functions-Footnote-6570224
+Node: Bitwise Functions570490
+Ref: table-bitwise-ops571084
+Ref: Bitwise Functions-Footnote-1575422
+Node: Type Functions575595
+Node: I18N Functions578256
+Node: User-defined579907
+Node: Definition Syntax580712
+Ref: Definition Syntax-Footnote-1586399
+Node: Function Example586470
+Ref: Function Example-Footnote-1589392
+Node: Function Caveats589414
+Node: Calling A Function589932
+Node: Variable Scope590890
+Node: Pass By Value/Reference593884
+Node: Return Statement597383
+Node: Dynamic Typing600362
+Node: Indirect Calls601292
+Ref: Indirect Calls-Footnote-1611543
+Node: Functions Summary611671
+Node: Library Functions614376
+Ref: Library Functions-Footnote-1617983
+Ref: Library Functions-Footnote-2618126
+Node: Library Names618297
+Ref: Library Names-Footnote-1621757
+Ref: Library Names-Footnote-2621980
+Node: General Functions622066
+Node: Strtonum Function623169
+Node: Assert Function626191
+Node: Round Function629517
+Node: Cliff Random Function631058
+Node: Ordinal Functions632074
+Ref: Ordinal Functions-Footnote-1635137
+Ref: Ordinal Functions-Footnote-2635389
+Node: Join Function635599
+Ref: Join Function-Footnote-1637369
+Node: Getlocaltime Function637569
+Node: Readfile Function641311
+Node: Shell Quoting643283
+Node: Data File Management644684
+Node: Filetrans Function645316
+Node: Rewind Function649412
+Node: File Checking651317
+Ref: File Checking-Footnote-1652651
+Node: Empty Files652852
+Node: Ignoring Assigns654831
+Node: Getopt Function656381
+Ref: Getopt Function-Footnote-1667850
+Node: Passwd Functions668050
+Ref: Passwd Functions-Footnote-1676889
+Node: Group Functions676977
+Ref: Group Functions-Footnote-1684874
+Node: Walking Arrays685081
+Node: Library Functions Summary688089
+Node: Library Exercises689495
+Node: Sample Programs689960
+Node: Running Examples690730
+Node: Clones691458
+Node: Cut Program692682
+Node: Egrep Program702611
+Ref: Egrep Program-Footnote-1710123
+Node: Id Program710233
+Node: Split Program713913
+Ref: Split Program-Footnote-1717372
+Node: Tee Program717501
+Node: Uniq Program720291
+Node: Wc Program727717
+Ref: Wc Program-Footnote-1731972
+Node: Miscellaneous Programs732066
+Node: Dupword Program733279
+Node: Alarm Program735309
+Node: Translate Program740164
+Ref: Translate Program-Footnote-1744729
+Node: Labels Program744999
+Ref: Labels Program-Footnote-1748350
+Node: Word Sorting748434
+Node: History Sorting752506
+Node: Extract Program754341
+Node: Simple Sed761870
+Node: Igawk Program764944
+Ref: Igawk Program-Footnote-1779275
+Ref: Igawk Program-Footnote-2779477
+Ref: Igawk Program-Footnote-3779599
+Node: Anagram Program779714
+Node: Signature Program782776
+Node: Programs Summary784023
+Node: Programs Exercises785237
+Ref: Programs Exercises-Footnote-1789366
+Node: Advanced Features789457
+Node: Nondecimal Data791447
+Node: Array Sorting793038
+Node: Controlling Array Traversal793738
+Ref: Controlling Array Traversal-Footnote-1802105
+Node: Array Sorting Functions802223
+Ref: Array Sorting Functions-Footnote-1807314
+Node: Two-way I/O807510
+Ref: Two-way I/O-Footnote-1814060
+Ref: Two-way I/O-Footnote-2814247
+Node: TCP/IP Networking814329
+Node: Profiling817447
+Ref: Profiling-Footnote-1825940
+Node: Advanced Features Summary826263
+Node: Internationalization828107
+Node: I18N and L10N829587
+Node: Explaining gettext830274
+Ref: Explaining gettext-Footnote-1835297
+Ref: Explaining gettext-Footnote-2835482
+Node: Programmer i18n835647
+Ref: Programmer i18n-Footnote-1840502
+Node: Translator i18n840551
+Node: String Extraction841345
+Ref: String Extraction-Footnote-1842477
+Node: Printf Ordering842563
+Ref: Printf Ordering-Footnote-1845349
+Node: I18N Portability845413
+Ref: I18N Portability-Footnote-1847869
+Node: I18N Example847932
+Ref: I18N Example-Footnote-1850738
+Node: Gawk I18N850811
+Node: I18N Summary851456
+Node: Debugger852797
+Node: Debugging853819
+Node: Debugging Concepts854260
+Node: Debugging Terms856069
+Node: Awk Debugging858644
+Node: Sample Debugging Session859550
+Node: Debugger Invocation860084
+Node: Finding The Bug861470
+Node: List of Debugger Commands867948
+Node: Breakpoint Control869281
+Node: Debugger Execution Control872975
+Node: Viewing And Changing Data876337
+Node: Execution Stack879711
+Node: Debugger Info881348
+Node: Miscellaneous Debugger Commands885419
+Node: Readline Support890507
+Node: Limitations891403
+Ref: Limitations-Footnote-1895634
+Node: Debugging Summary895685
+Node: Arbitrary Precision Arithmetic896964
+Node: Computer Arithmetic898380
+Ref: table-numeric-ranges901971
+Ref: Computer Arithmetic-Footnote-1902693
+Node: Math Definitions902750
+Ref: table-ieee-formats906064
+Ref: Math Definitions-Footnote-1906667
+Node: MPFR features906772
+Node: FP Math Caution908489
+Ref: FP Math Caution-Footnote-1909561
+Node: Inexactness of computations909930
+Node: Inexact representation910890
+Node: Comparing FP Values912250
+Node: Errors accumulate913332
+Node: Getting Accuracy914765
+Node: Try To Round917475
+Node: Setting precision918374
+Ref: table-predefined-precision-strings919071
+Node: Setting the rounding mode920901
+Ref: table-gawk-rounding-modes921275
+Ref: Setting the rounding mode-Footnote-1924683
+Node: Arbitrary Precision Integers924862
+Ref: Arbitrary Precision Integers-Footnote-1929779
+Node: POSIX Floating Point Problems929928
+Ref: POSIX Floating Point Problems-Footnote-1933810
+Node: Floating point summary933848
+Node: Dynamic Extensions936038
+Node: Extension Intro937591
+Node: Plugin License938857
+Node: Extension Mechanism Outline939654
+Ref: figure-load-extension940093
+Ref: figure-register-new-function941658
+Ref: figure-call-new-function942750
+Node: Extension API Description944812
+Node: Extension API Functions Introduction946344
+Node: General Data Types951203
+Ref: General Data Types-Footnote-1957158
+Node: Memory Allocation Functions957457
+Ref: Memory Allocation Functions-Footnote-1960302
+Node: Constructor Functions960401
+Node: Registration Functions962146
+Node: Extension Functions962831
+Node: Exit Callback Functions965454
+Node: Extension Version String966704
+Node: Input Parsers967367
+Node: Output Wrappers977249
+Node: Two-way processors981761
+Node: Printing Messages984026
+Ref: Printing Messages-Footnote-1985197
+Node: Updating ERRNO985350
+Node: Requesting Values986089
+Ref: table-value-types-returned986826
+Node: Accessing Parameters987709
+Node: Symbol Table Access988944
+Node: Symbol table by name989456
+Node: Symbol table by cookie991477
+Ref: Symbol table by cookie-Footnote-1995629
+Node: Cached values995693
+Ref: Cached values-Footnote-1999200
+Node: Array Manipulation999291
+Ref: Array Manipulation-Footnote-11000382
+Node: Array Data Types1000419
+Ref: Array Data Types-Footnote-11003077
+Node: Array Functions1003169
+Node: Flattening Arrays1007027
+Node: Creating Arrays1013935
+Node: Redirection API1018704
+Node: Extension API Variables1021535
+Node: Extension Versioning1022168
+Ref: gawk-api-version1022605
+Node: Extension API Informational Variables1024361
+Node: Extension API Boilerplate1025425
+Node: Finding Extensions1029239
+Node: Extension Example1029798
+Node: Internal File Description1030596
+Node: Internal File Ops1034676
+Ref: Internal File Ops-Footnote-11046438
+Node: Using Internal File Ops1046578
+Ref: Using Internal File Ops-Footnote-11048961
+Node: Extension Samples1049235
+Node: Extension Sample File Functions1050764
+Node: Extension Sample Fnmatch1058413
+Node: Extension Sample Fork1059900
+Node: Extension Sample Inplace1061118
+Node: Extension Sample Ord1064328
+Node: Extension Sample Readdir1065164
+Ref: table-readdir-file-types1066053
+Node: Extension Sample Revout1066858
+Node: Extension Sample Rev2way1067447
+Node: Extension Sample Read write array1068187
+Node: Extension Sample Readfile1070129
+Node: Extension Sample Time1071224
+Node: Extension Sample API Tests1072572
+Node: gawkextlib1073064
+Node: Extension summary1075511
+Node: Extension Exercises1079213
+Node: Language History1080710
+Node: V7/SVR3.11082366
+Node: SVR41084518
+Node: POSIX1085952
+Node: BTL1087331
+Node: POSIX/GNU1088060
+Node: Feature History1093922
+Node: Common Extensions1108292
+Node: Ranges and Locales1109575
+Ref: Ranges and Locales-Footnote-11114191
+Ref: Ranges and Locales-Footnote-21114218
+Ref: Ranges and Locales-Footnote-31114453
+Node: Contributors1114674
+Node: History summary1120243
+Node: Installation1121623
+Node: Gawk Distribution1122567
+Node: Getting1123051
+Node: Extracting1124012
+Node: Distribution contents1125650
+Node: Unix Installation1131744
+Node: Quick Installation1132426
+Node: Shell Startup Files1134840
+Node: Additional Configuration Options1135918
+Node: Configuration Philosophy1137723
+Node: Non-Unix Installation1140092
+Node: PC Installation1140550
+Node: PC Binary Installation1141870
+Node: PC Compiling1143722
+Ref: PC Compiling-Footnote-11146746
+Node: PC Testing1146855
+Node: PC Using1148035
+Node: Cygwin1152149
+Node: MSYS1152919
+Node: VMS Installation1153420
+Node: VMS Compilation1154211
+Ref: VMS Compilation-Footnote-11155440
+Node: VMS Dynamic Extensions1155498
+Node: VMS Installation Details1157183
+Node: VMS Running1159436
+Node: VMS GNV1163715
+Node: VMS Old Gawk1164450
+Node: Bugs1164921
+Node: Other Versions1169118
+Node: Installation summary1175702
+Node: Notes1176760
+Node: Compatibility Mode1177625
+Node: Additions1178407
+Node: Accessing The Source1179332
+Node: Adding Code1180767
+Node: New Ports1186986
+Node: Derived Files1191474
+Ref: Derived Files-Footnote-11196959
+Ref: Derived Files-Footnote-21196994
+Ref: Derived Files-Footnote-31197592
+Node: Future Extensions1197706
+Node: Implementation Limitations1198364
+Node: Extension Design1199547
+Node: Old Extension Problems1200701
+Ref: Old Extension Problems-Footnote-11202219
+Node: Extension New Mechanism Goals1202276
+Ref: Extension New Mechanism Goals-Footnote-11205640
+Node: Extension Other Design Decisions1205829
+Node: Extension Future Growth1207942
+Node: Old Extension Mechanism1208778
+Node: Notes summary1210541
+Node: Basic Concepts1211723
+Node: Basic High Level1212404
+Ref: figure-general-flow1212686
+Ref: figure-process-flow1213371
+Ref: Basic High Level-Footnote-11216672
+Node: Basic Data Typing1216857
+Node: Glossary1220185
+Node: Copying1252131
+Node: GNU Free Documentation License1289670
+Node: Index1314788
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index a4a1e8d7..64d72b7a 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -15386,9 +15386,28 @@ function multiply(variable, amount)
 @}
 @end example
 
+@noindent
+You would use it like this:
+
+@example
+BEGIN @{
+    answer = 10.5
+    multiply("answer", 4)
+    print "The answer is", answer
+@}
+@end example
+
+@noindent
+When run, this produces:
+
+@example
+$ @kbd{gawk -f answer.awk}
+@print{} The answer is 42
+@end example
+
 @quotation NOTE
-In order to avoid severe time-travel paradoxes,@footnote{Not to mention difficult
-implementation issues.} neither @code{FUNCTAB} nor @code{SYMTAB}
+In order to avoid severe time-travel paradoxes,@footnote{Not to mention
+difficult implementation issues.} neither @code{FUNCTAB} nor @code{SYMTAB}
 is available as an element within the @code{SYMTAB} array.
 @end quotation
 @end table
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index e5177ca2..c205c1d5 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -14714,9 +14714,28 @@ function multiply(variable, amount)
 @}
 @end example
 
+@noindent
+You would use it like this:
+
+@example
+BEGIN @{
+    answer = 10.5
+    multiply("answer", 4)
+    print "The answer is", answer
+@}
+@end example
+
+@noindent
+When run, this produces:
+
+@example
+$ @kbd{gawk -f answer.awk}
+@print{} The answer is 42
+@end example
+
 @quotation NOTE
-In order to avoid severe time-travel paradoxes,@footnote{Not to mention difficult
-implementation issues.} neither @code{FUNCTAB} nor @code{SYMTAB}
+In order to avoid severe time-travel paradoxes,@footnote{Not to mention
+difficult implementation issues.} neither @code{FUNCTAB} nor @code{SYMTAB}
 is available as an element within the @code{SYMTAB} array.
 @end quotation
 @end table