Merge branch 'gawk-4.1-stable'

4 files changed, 536 insertions, 527 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 494b896c..a85e84b3 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,10 @@
+2016-02-03         Andrew J. Schorr     <aschorr@telemetry-investments.com>
+
+	* gawktexi.in (Command-Line Options): Change wording of -M description
+	to say "Select" instead of "Force".
+	(Arbitrary-Precision Arithmetic Features): Tweak the wording to make
+	it clear that MPFR is not used unless the -M option is supplied.
+
 2016-02-03         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in (VMS Running): Improve the Texinfo usage.
diff --git a/doc/gawk.info b/doc/gawk.info
index 472b50f7..8afb1e11 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -2610,7 +2610,7 @@ The following list describes options mandated by the POSIX standard:
 
 '-M'
 '--bignum'
-     Force arbitrary-precision arithmetic on numbers.  This option has
+     Select arbitrary-precision arithmetic on numbers.  This option has
      no effect if 'gawk' is not compiled to use the GNU MPFR and MP
      libraries (*note Arbitrary Precision Arithmetic::).
 
@@ -22264,10 +22264,10 @@ File: gawk.info,  Node: MPFR features,  Next: FP Math Caution,  Prev: Math Defin
 
 By default, 'gawk' uses the double-precision floating-point values
 supplied by the hardware of the system it runs on.  However, if it was
-compiled to do so, 'gawk' uses the GNU MPFR (http://www.mpfr.org) and
-GNU MP (http://gmplib.org) (GMP) libraries for arbitrary-precision
-arithmetic on numbers.  You can see if MPFR support is available like
-so:
+compiled to do so, and the '-M' command-line option is supplied, 'gawk'
+uses the GNU MPFR (http://www.mpfr.org) and GNU MP (http://gmplib.org)
+(GMP) libraries for arbitrary-precision arithmetic on numbers.  You can
+see if MPFR support is available like so:
 
      $ gawk --version
      -| GNU Awk 4.1.2, API: 1.1 (GNU MPFR 3.1.0-p3, GNU MP 5.0.2)
@@ -35185,523 +35185,523 @@ Node: Intro Summary113234
 Node: Invoking Gawk114118
 Node: Command Line115632
 Node: Options116430
-Ref: Options-Footnote-1132081
-Ref: Options-Footnote-2132311
-Node: Other Arguments132336
-Node: Naming Standard Input135283
-Node: Environment Variables136376
-Node: AWKPATH Variable136934
-Ref: AWKPATH Variable-Footnote-1140345
-Ref: AWKPATH Variable-Footnote-2140390
-Node: AWKLIBPATH Variable140651
-Node: Other Environment Variables141908
-Node: Exit Status145546
-Node: Include Files146223
-Node: Loading Shared Libraries149818
-Node: Obsolete151246
-Node: Undocumented151938
-Node: Invoking Summary152235
-Node: Regexp153895
-Node: Regexp Usage155414
-Node: Escape Sequences157451
-Node: Regexp Operators163684
-Ref: Regexp Operators-Footnote-1171101
-Ref: Regexp Operators-Footnote-2171248
-Node: Bracket Expressions171346
-Ref: table-char-classes173369
-Node: Leftmost Longest176506
-Node: Computed Regexps177809
-Node: GNU Regexp Operators181236
-Node: Case-sensitivity184915
-Ref: Case-sensitivity-Footnote-1187811
-Ref: Case-sensitivity-Footnote-2188046
-Node: Strong Regexp Constants188154
-Node: Regexp Summary191096
-Node: Reading Files192702
-Node: Records194865
-Node: awk split records195598
-Node: gawk split records200530
-Ref: gawk split records-Footnote-1205074
-Node: Fields205111
-Node: Nonconstant Fields207852
-Ref: Nonconstant Fields-Footnote-1210088
-Node: Changing Fields210292
-Node: Field Separators216222
-Node: Default Field Splitting218920
-Node: Regexp Field Splitting220038
-Node: Single Character Fields223391
-Node: Command Line Field Separator224451
-Node: Full Line Fields227669
-Ref: Full Line Fields-Footnote-1229191
-Ref: Full Line Fields-Footnote-2229237
-Node: Field Splitting Summary229338
-Node: Constant Size231412
-Node: Splitting By Content235991
-Ref: Splitting By Content-Footnote-1239962
-Node: Multiple Line240125
-Ref: Multiple Line-Footnote-1246008
-Node: Getline246187
-Node: Plain Getline248654
-Node: Getline/Variable251293
-Node: Getline/File252442
-Node: Getline/Variable/File253828
-Ref: Getline/Variable/File-Footnote-1255432
-Node: Getline/Pipe255520
-Node: Getline/Variable/Pipe258225
-Node: Getline/Coprocess259358
-Node: Getline/Variable/Coprocess260623
-Node: Getline Notes261363
-Node: Getline Summary264158
-Ref: table-getline-variants264580
-Node: Read Timeout265328
-Ref: Read Timeout-Footnote-1269235
-Node: Retrying Input269293
-Node: Command-line directories270492
-Node: Input Summary271399
-Node: Input Exercises274571
-Node: Printing275299
-Node: Print277134
-Node: Print Examples278591
-Node: Output Separators281371
-Node: OFMT283388
-Node: Printf284744
-Node: Basic Printf285529
-Node: Control Letters287103
-Node: Format Modifiers291091
-Node: Printf Examples297106
-Node: Redirection299592
-Node: Special FD306435
-Ref: Special FD-Footnote-1309603
-Node: Special Files309677
-Node: Other Inherited Files310294
-Node: Special Network311295
-Node: Special Caveats312155
-Node: Close Files And Pipes313104
-Ref: Close Files And Pipes-Footnote-1320291
-Ref: Close Files And Pipes-Footnote-2320439
-Node: Nonfatal320590
-Node: Output Summary322915
-Node: Output Exercises324137
-Node: Expressions324816
-Node: Values326004
-Node: Constants326682
-Node: Scalar Constants327373
-Ref: Scalar Constants-Footnote-1328237
-Node: Nondecimal-numbers328487
-Node: Regexp Constants331501
-Node: Using Constant Regexps332027
-Node: Variables335190
-Node: Using Variables335847
-Node: Assignment Options337758
-Node: Conversion339632
-Node: Strings And Numbers340156
-Ref: Strings And Numbers-Footnote-1343220
-Node: Locale influences conversions343329
-Ref: table-locale-affects346087
-Node: All Operators346705
-Node: Arithmetic Ops347334
-Node: Concatenation349840
-Ref: Concatenation-Footnote-1352687
-Node: Assignment Ops352794
-Ref: table-assign-ops357786
-Node: Increment Ops359099
-Node: Truth Values and Conditions362559
-Node: Truth Values363633
-Node: Typing and Comparison364681
-Node: Variable Typing365501
-Node: Comparison Operators369125
-Ref: table-relational-ops369544
-Node: POSIX String Comparison373039
-Ref: POSIX String Comparison-Footnote-1374113
-Node: Boolean Ops374252
-Ref: Boolean Ops-Footnote-1378734
-Node: Conditional Exp378826
-Node: Function Calls380562
-Node: Precedence384442
-Node: Locales388101
-Node: Expressions Summary389733
-Node: Patterns and Actions392306
-Node: Pattern Overview393426
-Node: Regexp Patterns395103
-Node: Expression Patterns395645
-Node: Ranges399426
-Node: BEGIN/END402534
-Node: Using BEGIN/END403295
-Ref: Using BEGIN/END-Footnote-1406032
-Node: I/O And BEGIN/END406138
-Node: BEGINFILE/ENDFILE408454
-Node: Empty411361
-Node: Using Shell Variables411678
-Node: Action Overview413952
-Node: Statements416277
-Node: If Statement418125
-Node: While Statement419620
-Node: Do Statement421648
-Node: For Statement422796
-Node: Switch Statement425955
-Node: Break Statement428341
-Node: Continue Statement430433
-Node: Next Statement432260
-Node: Nextfile Statement434643
-Node: Exit Statement437295
-Node: Built-in Variables439700
-Node: User-modified440833
-Node: Auto-set448421
-Ref: Auto-set-Footnote-1462814
-Ref: Auto-set-Footnote-2463020
-Node: ARGC and ARGV463076
-Node: Pattern Action Summary467295
-Node: Arrays469725
-Node: Array Basics471054
-Node: Array Intro471898
-Ref: figure-array-elements473873
-Ref: Array Intro-Footnote-1476577
-Node: Reference to Elements476705
-Node: Assigning Elements479169
-Node: Array Example479660
-Node: Scanning an Array481419
-Node: Controlling Scanning484443
-Ref: Controlling Scanning-Footnote-1489842
-Node: Numeric Array Subscripts490158
-Node: Uninitialized Subscripts492342
-Node: Delete493961
-Ref: Delete-Footnote-1496713
-Node: Multidimensional496770
-Node: Multiscanning499865
-Node: Arrays of Arrays501456
-Node: Arrays Summary506224
-Node: Functions508317
-Node: Built-in509355
-Node: Calling Built-in510433
-Node: Numeric Functions512429
-Ref: Numeric Functions-Footnote-1517262
-Ref: Numeric Functions-Footnote-2517619
-Ref: Numeric Functions-Footnote-3517667
-Node: String Functions517939
-Ref: String Functions-Footnote-1541447
-Ref: String Functions-Footnote-2541576
-Ref: String Functions-Footnote-3541824
-Node: Gory Details541911
-Ref: table-sub-escapes543702
-Ref: table-sub-proposed545221
-Ref: table-posix-sub546584
-Ref: table-gensub-escapes548125
-Ref: Gory Details-Footnote-1548948
-Node: I/O Functions549099
-Ref: I/O Functions-Footnote-1556320
-Node: Time Functions556468
-Ref: Time Functions-Footnote-1566973
-Ref: Time Functions-Footnote-2567041
-Ref: Time Functions-Footnote-3567199
-Ref: Time Functions-Footnote-4567310
-Ref: Time Functions-Footnote-5567422
-Ref: Time Functions-Footnote-6567649
-Node: Bitwise Functions567915
-Ref: table-bitwise-ops568509
-Ref: Bitwise Functions-Footnote-1572847
-Node: Type Functions573020
-Node: I18N Functions575681
-Node: User-defined577332
-Node: Definition Syntax578137
-Ref: Definition Syntax-Footnote-1583824
-Node: Function Example583895
-Ref: Function Example-Footnote-1586817
-Node: Function Caveats586839
-Node: Calling A Function587357
-Node: Variable Scope588315
-Node: Pass By Value/Reference591309
-Node: Return Statement594808
-Node: Dynamic Typing597787
-Node: Indirect Calls598717
-Ref: Indirect Calls-Footnote-1608968
-Node: Functions Summary609096
-Node: Library Functions611801
-Ref: Library Functions-Footnote-1615410
-Ref: Library Functions-Footnote-2615553
-Node: Library Names615724
-Ref: Library Names-Footnote-1619185
-Ref: Library Names-Footnote-2619408
-Node: General Functions619494
-Node: Strtonum Function620597
-Node: Assert Function623619
-Node: Round Function626945
-Node: Cliff Random Function628486
-Node: Ordinal Functions629502
-Ref: Ordinal Functions-Footnote-1632565
-Ref: Ordinal Functions-Footnote-2632817
-Node: Join Function633027
-Ref: Join Function-Footnote-1634797
-Node: Getlocaltime Function634997
-Node: Readfile Function638741
-Node: Shell Quoting640715
-Node: Data File Management642116
-Node: Filetrans Function642748
-Node: Rewind Function646845
-Node: File Checking648231
-Ref: File Checking-Footnote-1649565
-Node: Empty Files649766
-Node: Ignoring Assigns651745
-Node: Getopt Function653295
-Ref: Getopt Function-Footnote-1664765
-Node: Passwd Functions664965
-Ref: Passwd Functions-Footnote-1673806
-Node: Group Functions673894
-Ref: Group Functions-Footnote-1681793
-Node: Walking Arrays682000
-Node: Library Functions Summary685010
-Node: Library Exercises686416
-Node: Sample Programs686881
-Node: Running Examples687651
-Node: Clones688379
-Node: Cut Program689603
-Node: Egrep Program699324
-Ref: Egrep Program-Footnote-1706836
-Node: Id Program706946
-Node: Split Program710626
-Ref: Split Program-Footnote-1714085
-Node: Tee Program714214
-Node: Uniq Program717004
-Node: Wc Program724430
-Ref: Wc Program-Footnote-1728685
-Node: Miscellaneous Programs728779
-Node: Dupword Program729992
-Node: Alarm Program732022
-Node: Translate Program736877
-Ref: Translate Program-Footnote-1741442
-Node: Labels Program741712
-Ref: Labels Program-Footnote-1745063
-Node: Word Sorting745147
-Node: History Sorting749219
-Node: Extract Program751054
-Node: Simple Sed758583
-Node: Igawk Program761657
-Ref: Igawk Program-Footnote-1775988
-Ref: Igawk Program-Footnote-2776190
-Ref: Igawk Program-Footnote-3776312
-Node: Anagram Program776427
-Node: Signature Program779489
-Node: Programs Summary780736
-Node: Programs Exercises781951
-Ref: Programs Exercises-Footnote-1786080
-Node: Advanced Features786171
-Node: Nondecimal Data788161
-Node: Array Sorting789752
-Node: Controlling Array Traversal790452
-Ref: Controlling Array Traversal-Footnote-1798821
-Node: Array Sorting Functions798939
-Ref: Array Sorting Functions-Footnote-1804030
-Node: Two-way I/O804226
-Ref: Two-way I/O-Footnote-1810046
-Ref: Two-way I/O-Footnote-2810233
-Node: TCP/IP Networking810315
-Node: Profiling813433
-Node: Advanced Features Summary821704
-Node: Internationalization823548
-Node: I18N and L10N825028
-Node: Explaining gettext825715
-Ref: Explaining gettext-Footnote-1830738
-Ref: Explaining gettext-Footnote-2830923
-Node: Programmer i18n831088
-Ref: Programmer i18n-Footnote-1835944
-Node: Translator i18n835993
-Node: String Extraction836787
-Ref: String Extraction-Footnote-1837920
-Node: Printf Ordering838006
-Ref: Printf Ordering-Footnote-1840792
-Node: I18N Portability840856
-Ref: I18N Portability-Footnote-1843312
-Node: I18N Example843375
-Ref: I18N Example-Footnote-1846181
-Node: Gawk I18N846254
-Node: I18N Summary846899
-Node: Debugger848240
-Node: Debugging849262
-Node: Debugging Concepts849703
-Node: Debugging Terms851512
-Node: Awk Debugging854087
-Node: Sample Debugging Session854993
-Node: Debugger Invocation855527
-Node: Finding The Bug856913
-Node: List of Debugger Commands863391
-Node: Breakpoint Control864724
-Node: Debugger Execution Control868418
-Node: Viewing And Changing Data871780
-Node: Execution Stack875154
-Node: Debugger Info876791
-Node: Miscellaneous Debugger Commands880862
-Node: Readline Support885950
-Node: Limitations886846
-Ref: Limitations-Footnote-1891077
-Node: Debugging Summary891128
-Node: Arbitrary Precision Arithmetic892407
-Node: Computer Arithmetic893823
-Ref: table-numeric-ranges897414
-Ref: Computer Arithmetic-Footnote-1898136
-Node: Math Definitions898193
-Ref: table-ieee-formats901507
-Ref: Math Definitions-Footnote-1902110
-Node: MPFR features902215
-Node: FP Math Caution903888
-Ref: FP Math Caution-Footnote-1904960
-Node: Inexactness of computations905329
-Node: Inexact representation906289
-Node: Comparing FP Values907649
-Node: Errors accumulate908731
-Node: Getting Accuracy910164
-Node: Try To Round912874
-Node: Setting precision913773
-Ref: table-predefined-precision-strings914470
-Node: Setting the rounding mode916300
-Ref: table-gawk-rounding-modes916674
-Ref: Setting the rounding mode-Footnote-1920082
-Node: Arbitrary Precision Integers920261
-Ref: Arbitrary Precision Integers-Footnote-1925178
-Node: POSIX Floating Point Problems925327
-Ref: POSIX Floating Point Problems-Footnote-1929209
-Node: Floating point summary929247
-Node: Dynamic Extensions931437
-Node: Extension Intro932990
-Node: Plugin License934256
-Node: Extension Mechanism Outline935053
-Ref: figure-load-extension935492
-Ref: figure-register-new-function937057
-Ref: figure-call-new-function938149
-Node: Extension API Description940212
-Node: Extension API Functions Introduction941744
-Node: General Data Types946603
-Ref: General Data Types-Footnote-1952558
-Node: Memory Allocation Functions952857
-Ref: Memory Allocation Functions-Footnote-1955702
-Node: Constructor Functions955801
-Node: Registration Functions957546
-Node: Extension Functions958231
-Node: Exit Callback Functions960530
-Node: Extension Version String961780
-Node: Input Parsers962443
-Node: Output Wrappers972328
-Node: Two-way processors976840
-Node: Printing Messages979104
-Ref: Printing Messages-Footnote-1980178
-Node: Updating ERRNO980331
-Node: Requesting Values981070
-Ref: table-value-types-returned981807
-Node: Accessing Parameters982690
-Node: Symbol Table Access983926
-Node: Symbol table by name984438
-Node: Symbol table by cookie986459
-Ref: Symbol table by cookie-Footnote-1990608
-Node: Cached values990672
-Ref: Cached values-Footnote-1994173
-Node: Array Manipulation994264
-Ref: Array Manipulation-Footnote-1995355
-Node: Array Data Types995392
-Ref: Array Data Types-Footnote-1998050
-Node: Array Functions998142
-Node: Flattening Arrays1002001
-Node: Creating Arrays1008909
-Node: Redirection API1013681
-Node: Extension API Variables1016512
-Node: Extension Versioning1017145
-Node: Extension API Informational Variables1019036
-Node: Extension API Boilerplate1020100
-Node: Finding Extensions1023914
-Node: Extension Example1024474
-Node: Internal File Description1025272
-Node: Internal File Ops1029352
-Ref: Internal File Ops-Footnote-11041114
-Node: Using Internal File Ops1041254
-Ref: Using Internal File Ops-Footnote-11043637
-Node: Extension Samples1043912
-Node: Extension Sample File Functions1045441
-Node: Extension Sample Fnmatch1053090
-Node: Extension Sample Fork1054577
-Node: Extension Sample Inplace1055795
-Node: Extension Sample Ord1059005
-Node: Extension Sample Readdir1059841
-Ref: table-readdir-file-types1060730
-Node: Extension Sample Revout1061535
-Node: Extension Sample Rev2way1062124
-Node: Extension Sample Read write array1062864
-Node: Extension Sample Readfile1064806
-Node: Extension Sample Time1065901
-Node: Extension Sample API Tests1067249
-Node: gawkextlib1067741
-Node: Extension summary1070188
-Node: Extension Exercises1073880
-Node: Language History1075377
-Node: V7/SVR3.11077033
-Node: SVR41079185
-Node: POSIX1080619
-Node: BTL1081999
-Node: POSIX/GNU1082729
-Node: Feature History1088568
-Node: Common Extensions1102938
-Node: Ranges and Locales1104221
-Ref: Ranges and Locales-Footnote-11108837
-Ref: Ranges and Locales-Footnote-21108864
-Ref: Ranges and Locales-Footnote-31109099
-Node: Contributors1109320
-Node: History summary1114889
-Node: Installation1116269
-Node: Gawk Distribution1117214
-Node: Getting1117698
-Node: Extracting1118659
-Node: Distribution contents1120297
-Node: Unix Installation1126393
-Node: Quick Installation1127075
-Node: Shell Startup Files1129489
-Node: Additional Configuration Options1130567
-Node: Configuration Philosophy1132372
-Node: Non-Unix Installation1134742
-Node: PC Installation1135200
-Node: PC Binary Installation1136520
-Node: PC Compiling1138372
-Ref: PC Compiling-Footnote-11141396
-Node: PC Testing1141505
-Node: PC Using1142685
-Node: Cygwin1146799
-Node: MSYS1147569
-Node: VMS Installation1148070
-Node: VMS Compilation1148861
-Ref: VMS Compilation-Footnote-11150091
-Node: VMS Dynamic Extensions1150149
-Node: VMS Installation Details1151834
-Node: VMS Running1154087
-Node: VMS GNV1158366
-Node: VMS Old Gawk1159101
-Node: Bugs1159572
-Node: Other Versions1163769
-Node: Installation summary1170355
-Node: Notes1171413
-Node: Compatibility Mode1172278
-Node: Additions1173060
-Node: Accessing The Source1173985
-Node: Adding Code1175421
-Node: New Ports1181640
-Node: Derived Files1186128
-Ref: Derived Files-Footnote-11191613
-Ref: Derived Files-Footnote-21191648
-Ref: Derived Files-Footnote-31192246
-Node: Future Extensions1192360
-Node: Implementation Limitations1193018
-Node: Extension Design1194201
-Node: Old Extension Problems1195355
-Ref: Old Extension Problems-Footnote-11196873
-Node: Extension New Mechanism Goals1196930
-Ref: Extension New Mechanism Goals-Footnote-11200294
-Node: Extension Other Design Decisions1200483
-Node: Extension Future Growth1202596
-Node: Old Extension Mechanism1203432
-Node: Notes summary1205195
-Node: Basic Concepts1206377
-Node: Basic High Level1207058
-Ref: figure-general-flow1207340
-Ref: figure-process-flow1208025
-Ref: Basic High Level-Footnote-11211326
-Node: Basic Data Typing1211511
-Node: Glossary1214839
-Node: Copying1246785
-Node: GNU Free Documentation License1284324
-Node: Index1309442
+Ref: Options-Footnote-1132082
+Ref: Options-Footnote-2132312
+Node: Other Arguments132337
+Node: Naming Standard Input135284
+Node: Environment Variables136377
+Node: AWKPATH Variable136935
+Ref: AWKPATH Variable-Footnote-1140346
+Ref: AWKPATH Variable-Footnote-2140391
+Node: AWKLIBPATH Variable140652
+Node: Other Environment Variables141909
+Node: Exit Status145547
+Node: Include Files146224
+Node: Loading Shared Libraries149819
+Node: Obsolete151247
+Node: Undocumented151939
+Node: Invoking Summary152236
+Node: Regexp153896
+Node: Regexp Usage155415
+Node: Escape Sequences157452
+Node: Regexp Operators163685
+Ref: Regexp Operators-Footnote-1171102
+Ref: Regexp Operators-Footnote-2171249
+Node: Bracket Expressions171347
+Ref: table-char-classes173370
+Node: Leftmost Longest176507
+Node: Computed Regexps177810
+Node: GNU Regexp Operators181237
+Node: Case-sensitivity184916
+Ref: Case-sensitivity-Footnote-1187812
+Ref: Case-sensitivity-Footnote-2188047
+Node: Strong Regexp Constants188155
+Node: Regexp Summary191097
+Node: Reading Files192703
+Node: Records194866
+Node: awk split records195599
+Node: gawk split records200531
+Ref: gawk split records-Footnote-1205075
+Node: Fields205112
+Node: Nonconstant Fields207853
+Ref: Nonconstant Fields-Footnote-1210089
+Node: Changing Fields210293
+Node: Field Separators216223
+Node: Default Field Splitting218921
+Node: Regexp Field Splitting220039
+Node: Single Character Fields223392
+Node: Command Line Field Separator224452
+Node: Full Line Fields227670
+Ref: Full Line Fields-Footnote-1229192
+Ref: Full Line Fields-Footnote-2229238
+Node: Field Splitting Summary229339
+Node: Constant Size231413
+Node: Splitting By Content235992
+Ref: Splitting By Content-Footnote-1239963
+Node: Multiple Line240126
+Ref: Multiple Line-Footnote-1246009
+Node: Getline246188
+Node: Plain Getline248655
+Node: Getline/Variable251294
+Node: Getline/File252443
+Node: Getline/Variable/File253829
+Ref: Getline/Variable/File-Footnote-1255433
+Node: Getline/Pipe255521
+Node: Getline/Variable/Pipe258226
+Node: Getline/Coprocess259359
+Node: Getline/Variable/Coprocess260624
+Node: Getline Notes261364
+Node: Getline Summary264159
+Ref: table-getline-variants264581
+Node: Read Timeout265329
+Ref: Read Timeout-Footnote-1269236
+Node: Retrying Input269294
+Node: Command-line directories270493
+Node: Input Summary271400
+Node: Input Exercises274572
+Node: Printing275300
+Node: Print277135
+Node: Print Examples278592
+Node: Output Separators281372
+Node: OFMT283389
+Node: Printf284745
+Node: Basic Printf285530
+Node: Control Letters287104
+Node: Format Modifiers291092
+Node: Printf Examples297107
+Node: Redirection299593
+Node: Special FD306436
+Ref: Special FD-Footnote-1309604
+Node: Special Files309678
+Node: Other Inherited Files310295
+Node: Special Network311296
+Node: Special Caveats312156
+Node: Close Files And Pipes313105
+Ref: Close Files And Pipes-Footnote-1320292
+Ref: Close Files And Pipes-Footnote-2320440
+Node: Nonfatal320591
+Node: Output Summary322916
+Node: Output Exercises324138
+Node: Expressions324817
+Node: Values326005
+Node: Constants326683
+Node: Scalar Constants327374
+Ref: Scalar Constants-Footnote-1328238
+Node: Nondecimal-numbers328488
+Node: Regexp Constants331502
+Node: Using Constant Regexps332028
+Node: Variables335191
+Node: Using Variables335848
+Node: Assignment Options337759
+Node: Conversion339633
+Node: Strings And Numbers340157
+Ref: Strings And Numbers-Footnote-1343221
+Node: Locale influences conversions343330
+Ref: table-locale-affects346088
+Node: All Operators346706
+Node: Arithmetic Ops347335
+Node: Concatenation349841
+Ref: Concatenation-Footnote-1352688
+Node: Assignment Ops352795
+Ref: table-assign-ops357787
+Node: Increment Ops359100
+Node: Truth Values and Conditions362560
+Node: Truth Values363634
+Node: Typing and Comparison364682
+Node: Variable Typing365502
+Node: Comparison Operators369126
+Ref: table-relational-ops369545
+Node: POSIX String Comparison373040
+Ref: POSIX String Comparison-Footnote-1374114
+Node: Boolean Ops374253
+Ref: Boolean Ops-Footnote-1378735
+Node: Conditional Exp378827
+Node: Function Calls380563
+Node: Precedence384443
+Node: Locales388102
+Node: Expressions Summary389734
+Node: Patterns and Actions392307
+Node: Pattern Overview393427
+Node: Regexp Patterns395104
+Node: Expression Patterns395646
+Node: Ranges399427
+Node: BEGIN/END402535
+Node: Using BEGIN/END403296
+Ref: Using BEGIN/END-Footnote-1406033
+Node: I/O And BEGIN/END406139
+Node: BEGINFILE/ENDFILE408455
+Node: Empty411362
+Node: Using Shell Variables411679
+Node: Action Overview413953
+Node: Statements416278
+Node: If Statement418126
+Node: While Statement419621
+Node: Do Statement421649
+Node: For Statement422797
+Node: Switch Statement425956
+Node: Break Statement428342
+Node: Continue Statement430434
+Node: Next Statement432261
+Node: Nextfile Statement434644
+Node: Exit Statement437296
+Node: Built-in Variables439701
+Node: User-modified440834
+Node: Auto-set448422
+Ref: Auto-set-Footnote-1462815
+Ref: Auto-set-Footnote-2463021
+Node: ARGC and ARGV463077
+Node: Pattern Action Summary467296
+Node: Arrays469726
+Node: Array Basics471055
+Node: Array Intro471899
+Ref: figure-array-elements473874
+Ref: Array Intro-Footnote-1476578
+Node: Reference to Elements476706
+Node: Assigning Elements479170
+Node: Array Example479661
+Node: Scanning an Array481420
+Node: Controlling Scanning484444
+Ref: Controlling Scanning-Footnote-1489843
+Node: Numeric Array Subscripts490159
+Node: Uninitialized Subscripts492343
+Node: Delete493962
+Ref: Delete-Footnote-1496714
+Node: Multidimensional496771
+Node: Multiscanning499866
+Node: Arrays of Arrays501457
+Node: Arrays Summary506225
+Node: Functions508318
+Node: Built-in509356
+Node: Calling Built-in510434
+Node: Numeric Functions512430
+Ref: Numeric Functions-Footnote-1517263
+Ref: Numeric Functions-Footnote-2517620
+Ref: Numeric Functions-Footnote-3517668
+Node: String Functions517940
+Ref: String Functions-Footnote-1541448
+Ref: String Functions-Footnote-2541577
+Ref: String Functions-Footnote-3541825
+Node: Gory Details541912
+Ref: table-sub-escapes543703
+Ref: table-sub-proposed545222
+Ref: table-posix-sub546585
+Ref: table-gensub-escapes548126
+Ref: Gory Details-Footnote-1548949
+Node: I/O Functions549100
+Ref: I/O Functions-Footnote-1556321
+Node: Time Functions556469
+Ref: Time Functions-Footnote-1566974
+Ref: Time Functions-Footnote-2567042
+Ref: Time Functions-Footnote-3567200
+Ref: Time Functions-Footnote-4567311
+Ref: Time Functions-Footnote-5567423
+Ref: Time Functions-Footnote-6567650
+Node: Bitwise Functions567916
+Ref: table-bitwise-ops568510
+Ref: Bitwise Functions-Footnote-1572848
+Node: Type Functions573021
+Node: I18N Functions575682
+Node: User-defined577333
+Node: Definition Syntax578138
+Ref: Definition Syntax-Footnote-1583825
+Node: Function Example583896
+Ref: Function Example-Footnote-1586818
+Node: Function Caveats586840
+Node: Calling A Function587358
+Node: Variable Scope588316
+Node: Pass By Value/Reference591310
+Node: Return Statement594809
+Node: Dynamic Typing597788
+Node: Indirect Calls598718
+Ref: Indirect Calls-Footnote-1608969
+Node: Functions Summary609097
+Node: Library Functions611802
+Ref: Library Functions-Footnote-1615411
+Ref: Library Functions-Footnote-2615554
+Node: Library Names615725
+Ref: Library Names-Footnote-1619186
+Ref: Library Names-Footnote-2619409
+Node: General Functions619495
+Node: Strtonum Function620598
+Node: Assert Function623620
+Node: Round Function626946
+Node: Cliff Random Function628487
+Node: Ordinal Functions629503
+Ref: Ordinal Functions-Footnote-1632566
+Ref: Ordinal Functions-Footnote-2632818
+Node: Join Function633028
+Ref: Join Function-Footnote-1634798
+Node: Getlocaltime Function634998
+Node: Readfile Function638742
+Node: Shell Quoting640716
+Node: Data File Management642117
+Node: Filetrans Function642749
+Node: Rewind Function646846
+Node: File Checking648232
+Ref: File Checking-Footnote-1649566
+Node: Empty Files649767
+Node: Ignoring Assigns651746
+Node: Getopt Function653296
+Ref: Getopt Function-Footnote-1664766
+Node: Passwd Functions664966
+Ref: Passwd Functions-Footnote-1673807
+Node: Group Functions673895
+Ref: Group Functions-Footnote-1681794
+Node: Walking Arrays682001
+Node: Library Functions Summary685011
+Node: Library Exercises686417
+Node: Sample Programs686882
+Node: Running Examples687652
+Node: Clones688380
+Node: Cut Program689604
+Node: Egrep Program699325
+Ref: Egrep Program-Footnote-1706837
+Node: Id Program706947
+Node: Split Program710627
+Ref: Split Program-Footnote-1714086
+Node: Tee Program714215
+Node: Uniq Program717005
+Node: Wc Program724431
+Ref: Wc Program-Footnote-1728686
+Node: Miscellaneous Programs728780
+Node: Dupword Program729993
+Node: Alarm Program732023
+Node: Translate Program736878
+Ref: Translate Program-Footnote-1741443
+Node: Labels Program741713
+Ref: Labels Program-Footnote-1745064
+Node: Word Sorting745148
+Node: History Sorting749220
+Node: Extract Program751055
+Node: Simple Sed758584
+Node: Igawk Program761658
+Ref: Igawk Program-Footnote-1775989
+Ref: Igawk Program-Footnote-2776191
+Ref: Igawk Program-Footnote-3776313
+Node: Anagram Program776428
+Node: Signature Program779490
+Node: Programs Summary780737
+Node: Programs Exercises781952
+Ref: Programs Exercises-Footnote-1786081
+Node: Advanced Features786172
+Node: Nondecimal Data788162
+Node: Array Sorting789753
+Node: Controlling Array Traversal790453
+Ref: Controlling Array Traversal-Footnote-1798822
+Node: Array Sorting Functions798940
+Ref: Array Sorting Functions-Footnote-1804031
+Node: Two-way I/O804227
+Ref: Two-way I/O-Footnote-1810047
+Ref: Two-way I/O-Footnote-2810234
+Node: TCP/IP Networking810316
+Node: Profiling813434
+Node: Advanced Features Summary821705
+Node: Internationalization823549
+Node: I18N and L10N825029
+Node: Explaining gettext825716
+Ref: Explaining gettext-Footnote-1830739
+Ref: Explaining gettext-Footnote-2830924
+Node: Programmer i18n831089
+Ref: Programmer i18n-Footnote-1835945
+Node: Translator i18n835994
+Node: String Extraction836788
+Ref: String Extraction-Footnote-1837921
+Node: Printf Ordering838007
+Ref: Printf Ordering-Footnote-1840793
+Node: I18N Portability840857
+Ref: I18N Portability-Footnote-1843313
+Node: I18N Example843376
+Ref: I18N Example-Footnote-1846182
+Node: Gawk I18N846255
+Node: I18N Summary846900
+Node: Debugger848241
+Node: Debugging849263
+Node: Debugging Concepts849704
+Node: Debugging Terms851513
+Node: Awk Debugging854088
+Node: Sample Debugging Session854994
+Node: Debugger Invocation855528
+Node: Finding The Bug856914
+Node: List of Debugger Commands863392
+Node: Breakpoint Control864725
+Node: Debugger Execution Control868419
+Node: Viewing And Changing Data871781
+Node: Execution Stack875155
+Node: Debugger Info876792
+Node: Miscellaneous Debugger Commands880863
+Node: Readline Support885951
+Node: Limitations886847
+Ref: Limitations-Footnote-1891078
+Node: Debugging Summary891129
+Node: Arbitrary Precision Arithmetic892408
+Node: Computer Arithmetic893824
+Ref: table-numeric-ranges897415
+Ref: Computer Arithmetic-Footnote-1898137
+Node: Math Definitions898194
+Ref: table-ieee-formats901508
+Ref: Math Definitions-Footnote-1902111
+Node: MPFR features902216
+Node: FP Math Caution903935
+Ref: FP Math Caution-Footnote-1905007
+Node: Inexactness of computations905376
+Node: Inexact representation906336
+Node: Comparing FP Values907696
+Node: Errors accumulate908778
+Node: Getting Accuracy910211
+Node: Try To Round912921
+Node: Setting precision913820
+Ref: table-predefined-precision-strings914517
+Node: Setting the rounding mode916347
+Ref: table-gawk-rounding-modes916721
+Ref: Setting the rounding mode-Footnote-1920129
+Node: Arbitrary Precision Integers920308
+Ref: Arbitrary Precision Integers-Footnote-1925225
+Node: POSIX Floating Point Problems925374
+Ref: POSIX Floating Point Problems-Footnote-1929256
+Node: Floating point summary929294
+Node: Dynamic Extensions931484
+Node: Extension Intro933037
+Node: Plugin License934303
+Node: Extension Mechanism Outline935100
+Ref: figure-load-extension935539
+Ref: figure-register-new-function937104
+Ref: figure-call-new-function938196
+Node: Extension API Description940259
+Node: Extension API Functions Introduction941791
+Node: General Data Types946650
+Ref: General Data Types-Footnote-1952605
+Node: Memory Allocation Functions952904
+Ref: Memory Allocation Functions-Footnote-1955749
+Node: Constructor Functions955848
+Node: Registration Functions957593
+Node: Extension Functions958278
+Node: Exit Callback Functions960577
+Node: Extension Version String961827
+Node: Input Parsers962490
+Node: Output Wrappers972375
+Node: Two-way processors976887
+Node: Printing Messages979151
+Ref: Printing Messages-Footnote-1980225
+Node: Updating ERRNO980378
+Node: Requesting Values981117
+Ref: table-value-types-returned981854
+Node: Accessing Parameters982737
+Node: Symbol Table Access983973
+Node: Symbol table by name984485
+Node: Symbol table by cookie986506
+Ref: Symbol table by cookie-Footnote-1990655
+Node: Cached values990719
+Ref: Cached values-Footnote-1994220
+Node: Array Manipulation994311
+Ref: Array Manipulation-Footnote-1995402
+Node: Array Data Types995439
+Ref: Array Data Types-Footnote-1998097
+Node: Array Functions998189
+Node: Flattening Arrays1002048
+Node: Creating Arrays1008956
+Node: Redirection API1013728
+Node: Extension API Variables1016559
+Node: Extension Versioning1017192
+Node: Extension API Informational Variables1019083
+Node: Extension API Boilerplate1020147
+Node: Finding Extensions1023961
+Node: Extension Example1024521
+Node: Internal File Description1025319
+Node: Internal File Ops1029399
+Ref: Internal File Ops-Footnote-11041161
+Node: Using Internal File Ops1041301
+Ref: Using Internal File Ops-Footnote-11043684
+Node: Extension Samples1043959
+Node: Extension Sample File Functions1045488
+Node: Extension Sample Fnmatch1053137
+Node: Extension Sample Fork1054624
+Node: Extension Sample Inplace1055842
+Node: Extension Sample Ord1059052
+Node: Extension Sample Readdir1059888
+Ref: table-readdir-file-types1060777
+Node: Extension Sample Revout1061582
+Node: Extension Sample Rev2way1062171
+Node: Extension Sample Read write array1062911
+Node: Extension Sample Readfile1064853
+Node: Extension Sample Time1065948
+Node: Extension Sample API Tests1067296
+Node: gawkextlib1067788
+Node: Extension summary1070235
+Node: Extension Exercises1073927
+Node: Language History1075424
+Node: V7/SVR3.11077080
+Node: SVR41079232
+Node: POSIX1080666
+Node: BTL1082046
+Node: POSIX/GNU1082776
+Node: Feature History1088615
+Node: Common Extensions1102985
+Node: Ranges and Locales1104268
+Ref: Ranges and Locales-Footnote-11108884
+Ref: Ranges and Locales-Footnote-21108911
+Ref: Ranges and Locales-Footnote-31109146
+Node: Contributors1109367
+Node: History summary1114936
+Node: Installation1116316
+Node: Gawk Distribution1117261
+Node: Getting1117745
+Node: Extracting1118706
+Node: Distribution contents1120344
+Node: Unix Installation1126440
+Node: Quick Installation1127122
+Node: Shell Startup Files1129536
+Node: Additional Configuration Options1130614
+Node: Configuration Philosophy1132419
+Node: Non-Unix Installation1134789
+Node: PC Installation1135247
+Node: PC Binary Installation1136567
+Node: PC Compiling1138419
+Ref: PC Compiling-Footnote-11141443
+Node: PC Testing1141552
+Node: PC Using1142732
+Node: Cygwin1146846
+Node: MSYS1147616
+Node: VMS Installation1148117
+Node: VMS Compilation1148908
+Ref: VMS Compilation-Footnote-11150138
+Node: VMS Dynamic Extensions1150196
+Node: VMS Installation Details1151881
+Node: VMS Running1154134
+Node: VMS GNV1158413
+Node: VMS Old Gawk1159148
+Node: Bugs1159619
+Node: Other Versions1163816
+Node: Installation summary1170402
+Node: Notes1171460
+Node: Compatibility Mode1172325
+Node: Additions1173107
+Node: Accessing The Source1174032
+Node: Adding Code1175468
+Node: New Ports1181687
+Node: Derived Files1186175
+Ref: Derived Files-Footnote-11191660
+Ref: Derived Files-Footnote-21191695
+Ref: Derived Files-Footnote-31192293
+Node: Future Extensions1192407
+Node: Implementation Limitations1193065
+Node: Extension Design1194248
+Node: Old Extension Problems1195402
+Ref: Old Extension Problems-Footnote-11196920
+Node: Extension New Mechanism Goals1196977
+Ref: Extension New Mechanism Goals-Footnote-11200341
+Node: Extension Other Design Decisions1200530
+Node: Extension Future Growth1202643
+Node: Old Extension Mechanism1203479
+Node: Notes summary1205242
+Node: Basic Concepts1206424
+Node: Basic High Level1207105
+Ref: figure-general-flow1207387
+Ref: figure-process-flow1208072
+Ref: Basic High Level-Footnote-11211373
+Node: Basic Data Typing1211558
+Node: Glossary1214886
+Node: Copying1246832
+Node: GNU Free Documentation License1284371
+Node: Index1309489
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 06aacd3b..fab29487 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -4049,7 +4049,7 @@ care to search for all occurrences of each inappropriate construct. As
 @itemx @option{--bignum}
 @cindex @option{-M} option
 @cindex @option{--bignum} option
-Force arbitrary-precision arithmetic on numbers. This option has no effect
+Select arbitrary-precision arithmetic on numbers. This option has no effect
 if @command{gawk} is not compiled to use the GNU MPFR and MP libraries
 (@pxref{Arbitrary Precision Arithmetic}).
 
@@ -30867,7 +30867,8 @@ one extra bit of significand.
 
 By default, @command{gawk} uses the double-precision floating-point values
 supplied by the hardware of the system it runs on.  However, if it was
-compiled to do so, @command{gawk} uses the @uref{http://www.mpfr.org,
+compiled to do so, and the @option{-M} command-line option is supplied,
+@command{gawk} uses the @uref{http://www.mpfr.org,
 GNU MPFR} and @uref{http://gmplib.org, GNU MP} (GMP) libraries for
 arbitrary-precision arithmetic on numbers.  You can see if MPFR support
 is available like so:
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 651d2573..e15d6323 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -3960,7 +3960,7 @@ care to search for all occurrences of each inappropriate construct. As
 @itemx @option{--bignum}
 @cindex @option{-M} option
 @cindex @option{--bignum} option
-Force arbitrary-precision arithmetic on numbers. This option has no effect
+Select arbitrary-precision arithmetic on numbers. This option has no effect
 if @command{gawk} is not compiled to use the GNU MPFR and MP libraries
 (@pxref{Arbitrary Precision Arithmetic}).
 
@@ -29958,7 +29958,8 @@ one extra bit of significand.
 
 By default, @command{gawk} uses the double-precision floating-point values
 supplied by the hardware of the system it runs on.  However, if it was
-compiled to do so, @command{gawk} uses the @uref{http://www.mpfr.org,
+compiled to do so, and the @option{-M} command-line option is supplied,
+@command{gawk} uses the @uref{http://www.mpfr.org,
 GNU MPFR} and @uref{http://gmplib.org, GNU MP} (GMP) libraries for
 arbitrary-precision arithmetic on numbers.  You can see if MPFR support
 is available like so: