More doc updates.

4 files changed, 722 insertions, 635 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 5cddbcf8..026ff1bb 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2022-05-10         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in (MPFR Features): Add subsections for deprecating
+	and the intro material.
+	(Obsolete): Add note about MPFR features.
+
 2022-05-03         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawk.1: Document that -M is deprecated.
diff --git a/doc/gawk.info b/doc/gawk.info
index b605f5f8..5f67c634 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -552,6 +552,8 @@ in (a) below.  A copy of the license is included in the section entitled
 * Computer Arithmetic::                 A quick intro to computer math.
 * Math Definitions::                    Defining terms used.
 * MPFR features::                       The MPFR features in 'gawk'.
+* MPFR Deprecated::                     MPFR features are deprecated!
+* MPFR Intro::                          MPFR General introduction.
 * FP Math Caution::                     Things to know.
 * Inexactness of computations::         Floating point math is not exact.
 * Inexact representation::              Numbers are not exactly represented.
@@ -3447,12 +3449,11 @@ File: gawk.info,  Node: Obsolete,  Next: Undocumented,  Prev: Loading Shared Lib
 This minor node describes features and/or command-line options from
 previous releases of 'gawk' that either are not available in the current
 version or are still supported but deprecated (meaning that they will
-_not_ be in the next release).
+_not_ be in a future release).
 
-   The process-related special files '/dev/pid', '/dev/ppid',
-'/dev/pgrpid', and '/dev/user' were deprecated in 'gawk' 3.1, but still
-worked.  As of version 4.0, they are no longer interpreted specially by
-'gawk'.  (Use 'PROCINFO' instead; see *note Auto-set::.)
+   The multiprecision arithmetic feature is deprecated as of 'gawk'
+version 5.2.  Use of '-M'/'--bignum' produces a warning message.  The
+feature will be removed in the release of 2024.
 
 
 File: gawk.info,  Node: Undocumented,  Next: Invoking Summary,  Prev: Obsolete,  Up: Invoking Gawk
@@ -24584,17 +24585,48 @@ File: gawk.info,  Node: MPFR features,  Next: FP Math Caution,  Prev: Math Defin
 16.3 Arbitrary-Precision Arithmetic Features in 'gawk'
 ======================================================
 
-     WARNING: As of version 5.2, arbitrary precision arithmetic in
-     'gawk' is _deprecated_.  It will be removed from 'gawk' in 2024.
+This minor node briefly describes arbitrary-precision arithmetic in
+'gawk'.
+
+* Menu:
+
+* MPFR Deprecated::             MPFR features are deprecated!
+* MPFR Intro::                  MPFR General introduction.
+
+
+File: gawk.info,  Node: MPFR Deprecated,  Next: MPFR Intro,  Up: MPFR features
+
+16.3.1 Arbitrary Precision Arithmetic is Deprecated!
+----------------------------------------------------
+
+As of version 5.2, arbitrary precision arithmetic in 'gawk' is
+_deprecated_.  It will be removed from 'gawk' in 2024.
+
+   This feature is deprecated because its inclusion was a mistake.  It
+has led to endless bug reports, misuse of the feature and public abuse
+of the maintainer, for no real increased value.
+
+   If you use this feature, you should start working now to find a
+different toolset with which to accomplish your goals.(1)
 
-     MPFR support is deprecated because its inclusion was a mistake.  It
-     has led to endless bug reports, misuse of the feature and public
-     abuse of the maintainer, for no real increased value.
+   If the feature is very important to you, then consider if you are
+willing to volunteer to maintain it, so that it can continue to be
+included in 'gawk'.  If that is the case, contact the maintainer to
+discuss it with him.  You may do so by submitting a bug report.
 
-     If you use this feature, you should start working now to find a
-     different toolset with which to accomplish your goals.(1)
+   ---------- Footnotes ----------
+
+   (1) Of course, you can always continue to use a version of 'gawk'
+that still supports arbitrary precison arithmetic.  It simply will be
+unmaintained.
 
-   By default, 'gawk' uses the double-precision floating-point values
+
+File: gawk.info,  Node: MPFR Intro,  Prev: MPFR Deprecated,  Up: MPFR features
+
+16.3.2 Arbitrary Precsioon Introduction
+---------------------------------------
+
+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, and the '-M' command-line option is supplied, 'gawk'
 uses the GNU MPFR (http://www.mpfr.org) and GNU MP (https://gmplib.org)
@@ -24626,11 +24658,6 @@ rounding mode are set globally for every operation to follow.  *Note
 Setting precision:: and *note Setting the rounding mode:: for more
 information.
 
-   ---------- Footnotes ----------
-
-   (1) Of course, you can always continue to use a version of 'gawk'
-that still supports MPFR mode.  It simply will be unmaintained.
-
 
 File: gawk.info,  Node: FP Math Caution,  Next: Arbitrary Precision Integers,  Prev: MPFR features,  Up: Arbitrary Precision Arithmetic
 
@@ -38819,613 +38846,615 @@ Index
 
 Tag Table:
 Node: Top1200
-Node: Foreword345584
-Node: Foreword450026
-Node: Preface51558
-Ref: Preface-Footnote-154417
-Ref: Preface-Footnote-254526
-Ref: Preface-Footnote-354760
-Node: History54902
-Node: Names57254
-Ref: Names-Footnote-158358
-Node: This Manual58505
-Ref: This Manual-Footnote-165144
-Node: Conventions65244
-Node: Manual History67613
-Ref: Manual History-Footnote-170610
-Ref: Manual History-Footnote-270651
-Node: How To Contribute70725
-Node: Acknowledgments71647
-Node: Getting Started76584
-Node: Running gawk79023
-Node: One-shot80213
-Node: Read Terminal81476
-Node: Long83469
-Node: Executable Scripts84982
-Ref: Executable Scripts-Footnote-187615
-Node: Comments87718
-Node: Quoting90202
-Node: DOS Quoting95728
-Node: Sample Data Files97784
-Node: Very Simple100379
-Node: Two Rules106481
-Node: More Complex108366
-Node: Statements/Lines110698
-Ref: Statements/Lines-Footnote-1115182
-Node: Other Features115447
-Node: When116383
-Ref: When-Footnote-1118137
-Node: Intro Summary118202
-Node: Invoking Gawk119086
-Node: Command Line120600
-Node: Options121398
-Ref: Options-Footnote-1139582
-Ref: Options-Footnote-2139813
-Node: Other Arguments139838
-Node: Naming Standard Input143849
-Node: Environment Variables145059
-Node: AWKPATH Variable145617
-Ref: AWKPATH Variable-Footnote-1149029
-Ref: AWKPATH Variable-Footnote-2149063
-Node: AWKLIBPATH Variable149434
-Ref: AWKLIBPATH Variable-Footnote-1151131
-Node: Other Environment Variables151506
-Node: Exit Status155594
-Node: Include Files156271
-Node: Loading Shared Libraries159961
-Node: Obsolete161389
-Node: Undocumented162081
-Node: Invoking Summary162378
-Node: Regexp165219
-Node: Regexp Usage166673
-Node: Escape Sequences168710
-Node: Regexp Operators174952
-Node: Regexp Operator Details175437
-Ref: Regexp Operator Details-Footnote-1182801
-Node: Interval Expressions182948
-Ref: Interval Expressions-Footnote-1185123
-Node: Bracket Expressions185221
-Ref: table-char-classes187697
-Node: Leftmost Longest191024
-Node: Computed Regexps192327
-Node: GNU Regexp Operators195754
-Node: Case-sensitivity199432
-Ref: Case-sensitivity-Footnote-1202298
-Ref: Case-sensitivity-Footnote-2202533
-Node: Regexp Summary202641
-Node: Reading Files204107
-Node: Records206376
-Node: awk split records207451
-Node: gawk split records212151
-Ref: gawk split records-Footnote-1217225
-Node: Fields217262
-Node: Nonconstant Fields220003
-Ref: Nonconstant Fields-Footnote-1222239
-Node: Changing Fields222443
-Node: Field Separators228474
-Node: Default Field Splitting231172
-Node: Regexp Field Splitting232290
-Node: Single Character Fields235967
-Node: Command Line Field Separator237027
-Node: Full Line Fields240245
-Ref: Full Line Fields-Footnote-1241767
-Ref: Full Line Fields-Footnote-2241813
-Node: Field Splitting Summary241914
-Node: Constant Size243988
-Node: Fixed width data244720
-Node: Skipping intervening248187
-Node: Allowing trailing data248985
-Node: Fields with fixed data250022
-Node: Splitting By Content251540
-Ref: Splitting By Content-Footnote-1255376
-Node: More CSV255539
-Node: FS versus FPAT257154
-Node: Testing field creation258314
-Node: Multiple Line259939
-Node: Getline266216
-Node: Plain Getline268685
-Node: Getline/Variable271258
-Node: Getline/File272409
-Node: Getline/Variable/File273797
-Ref: Getline/Variable/File-Footnote-1275402
-Node: Getline/Pipe275490
-Node: Getline/Variable/Pipe278194
-Node: Getline/Coprocess279329
-Node: Getline/Variable/Coprocess280596
-Node: Getline Notes281338
-Node: Getline Summary284135
-Ref: table-getline-variants284559
-Node: Read Timeout285308
-Ref: Read Timeout-Footnote-1289224
-Node: Retrying Input289282
-Node: Command-line directories290481
-Node: Input Summary291387
-Node: Input Exercises294559
-Node: Printing294993
-Node: Print296827
-Node: Print Examples298284
-Node: Output Separators301064
-Node: OFMT303081
-Node: Printf304437
-Node: Basic Printf305222
-Node: Control Letters306796
-Node: Format Modifiers311958
-Node: Printf Examples317973
-Node: Redirection320459
-Node: Special FD327300
-Ref: Special FD-Footnote-1330468
-Node: Special Files330542
-Node: Other Inherited Files331159
-Node: Special Network332160
-Node: Special Caveats333020
-Node: Close Files And Pipes333969
-Ref: table-close-pipe-return-values340876
-Ref: Close Files And Pipes-Footnote-1341690
-Ref: Close Files And Pipes-Footnote-2341838
-Node: Nonfatal341990
-Node: Output Summary344328
-Node: Output Exercises345550
-Node: Expressions346229
-Node: Values347417
-Node: Constants348095
-Node: Scalar Constants348786
-Ref: Scalar Constants-Footnote-1351296
-Node: Nondecimal-numbers351546
-Node: Regexp Constants354547
-Node: Using Constant Regexps355073
-Node: Standard Regexp Constants355695
-Node: Strong Regexp Constants358883
-Node: Variables362598
-Node: Using Variables363255
-Node: Assignment Options365165
-Node: Conversion367636
-Node: Strings And Numbers368160
-Ref: Strings And Numbers-Footnote-1371223
-Node: Locale influences conversions371332
-Ref: table-locale-affects374090
-Node: All Operators374709
-Node: Arithmetic Ops375338
-Node: Concatenation378054
-Ref: Concatenation-Footnote-1380901
-Node: Assignment Ops381008
-Ref: table-assign-ops385999
-Node: Increment Ops387313
-Node: Truth Values and Conditions390773
-Node: Truth Values391847
-Node: Typing and Comparison392895
-Node: Variable Typing393715
-Ref: Variable Typing-Footnote-1400178
-Ref: Variable Typing-Footnote-2400250
-Node: Comparison Operators400327
-Ref: table-relational-ops400746
-Node: POSIX String Comparison404242
-Ref: POSIX String Comparison-Footnote-1405937
-Ref: POSIX String Comparison-Footnote-2406076
-Node: Boolean Ops406160
-Ref: Boolean Ops-Footnote-1410642
-Node: Conditional Exp410734
-Node: Function Calls412470
-Node: Precedence416347
-Node: Locales420006
-Node: Expressions Summary421638
-Node: Patterns and Actions424211
-Node: Pattern Overview425331
-Node: Regexp Patterns427008
-Node: Expression Patterns427550
-Node: Ranges431331
-Node: BEGIN/END434439
-Node: Using BEGIN/END435200
-Ref: Using BEGIN/END-Footnote-1437954
-Node: I/O And BEGIN/END438060
-Node: BEGINFILE/ENDFILE440373
-Node: Empty443604
-Node: Using Shell Variables443921
-Node: Action Overview446195
-Node: Statements448520
-Node: If Statement450368
-Node: While Statement451863
-Node: Do Statement453891
-Node: For Statement455039
-Node: Switch Statement458294
-Node: Break Statement460735
-Node: Continue Statement462827
-Node: Next Statement464654
-Node: Nextfile Statement467037
-Node: Exit Statement469726
-Node: Built-in Variables472129
-Node: User-modified473262
-Node: Auto-set481029
-Ref: Auto-set-Footnote-1497836
-Ref: Auto-set-Footnote-2498042
-Node: ARGC and ARGV498098
-Node: Pattern Action Summary502311
-Node: Arrays504741
-Node: Array Basics506070
-Node: Array Intro506914
-Ref: figure-array-elements508889
-Ref: Array Intro-Footnote-1511594
-Node: Reference to Elements511722
-Node: Assigning Elements514186
-Node: Array Example514677
-Node: Scanning an Array516631
-Node: Controlling Scanning519653
-Ref: Controlling Scanning-Footnote-1526109
-Node: Numeric Array Subscripts526425
-Node: Uninitialized Subscripts528609
-Node: Delete530228
-Ref: Delete-Footnote-1532980
-Node: Multidimensional533037
-Node: Multiscanning536132
-Node: Arrays of Arrays537723
-Node: Arrays Summary542491
-Node: Functions544584
-Node: Built-in545622
-Node: Calling Built-in546775
-Node: Boolean Functions548771
-Node: Numeric Functions549325
-Ref: Numeric Functions-Footnote-1553352
-Ref: Numeric Functions-Footnote-2554000
-Ref: Numeric Functions-Footnote-3554048
-Node: String Functions554320
-Ref: String Functions-Footnote-1579162
-Ref: String Functions-Footnote-2579290
-Ref: String Functions-Footnote-3579538
-Node: Gory Details579625
-Ref: table-sub-escapes581416
-Ref: table-sub-proposed582936
-Ref: table-posix-sub584300
-Ref: table-gensub-escapes585842
-Ref: Gory Details-Footnote-1586666
-Node: I/O Functions586820
-Ref: table-system-return-values593274
-Ref: I/O Functions-Footnote-1595355
-Ref: I/O Functions-Footnote-2595503
-Node: Time Functions595623
-Ref: Time Functions-Footnote-1606294
-Ref: Time Functions-Footnote-2606362
-Ref: Time Functions-Footnote-3606520
-Ref: Time Functions-Footnote-4606631
-Ref: Time Functions-Footnote-5606743
-Ref: Time Functions-Footnote-6606970
-Node: Bitwise Functions607236
-Ref: table-bitwise-ops607830
-Ref: Bitwise Functions-Footnote-1613894
-Ref: Bitwise Functions-Footnote-2614067
-Node: Type Functions614258
-Node: I18N Functions617678
-Node: User-defined619329
-Node: Definition Syntax620141
-Ref: Definition Syntax-Footnote-1625835
-Node: Function Example625906
-Ref: Function Example-Footnote-1628828
-Node: Function Calling628850
-Node: Calling A Function629438
-Node: Variable Scope630396
-Node: Pass By Value/Reference633390
-Node: Function Caveats636034
-Ref: Function Caveats-Footnote-1638081
-Node: Return Statement638201
-Node: Dynamic Typing641180
-Node: Indirect Calls642110
-Node: Functions Summary653037
-Node: Library Functions655742
-Ref: Library Functions-Footnote-1659349
-Ref: Library Functions-Footnote-2659492
-Node: Library Names659663
-Ref: Library Names-Footnote-1663330
-Ref: Library Names-Footnote-2663553
-Node: General Functions663639
-Node: Strtonum Function664821
-Node: Assert Function667843
-Node: Round Function671169
-Node: Cliff Random Function672709
-Node: Ordinal Functions673725
-Ref: Ordinal Functions-Footnote-1676788
-Ref: Ordinal Functions-Footnote-2677040
-Node: Join Function677250
-Ref: Join Function-Footnote-1679020
-Node: Getlocaltime Function679220
-Node: Readfile Function682962
-Node: Shell Quoting684939
-Node: Isnumeric Function686367
-Node: Data File Management687755
-Node: Filetrans Function688387
-Node: Rewind Function692483
-Node: File Checking694392
-Ref: File Checking-Footnote-1695726
-Node: Empty Files695927
-Node: Ignoring Assigns697906
-Node: Getopt Function699456
-Ref: Getopt Function-Footnote-1714753
-Node: Passwd Functions714953
-Ref: Passwd Functions-Footnote-1723792
-Node: Group Functions723880
-Ref: Group Functions-Footnote-1731778
-Node: Walking Arrays731985
-Node: Library Functions Summary734993
-Node: Library Exercises736399
-Node: Sample Programs736864
-Node: Running Examples737634
-Node: Clones738362
-Node: Cut Program739586
-Node: Egrep Program749726
-Node: Id Program758727
-Node: Split Program768662
-Ref: Split Program-Footnote-1778555
-Node: Tee Program778728
-Node: Uniq Program781518
-Node: Wc Program789106
-Node: Bytes vs. Characters789493
-Node: Using extensions791041
-Node: wc program791795
-Node: Miscellaneous Programs796660
-Node: Dupword Program797873
-Node: Alarm Program799903
-Node: Translate Program804758
-Ref: Translate Program-Footnote-1809323
-Node: Labels Program809593
-Ref: Labels Program-Footnote-1812944
-Node: Word Sorting813028
-Node: History Sorting817100
-Node: Extract Program819325
-Node: Simple Sed827338
-Node: Igawk Program830412
-Ref: Igawk Program-Footnote-1844743
-Ref: Igawk Program-Footnote-2844945
-Ref: Igawk Program-Footnote-3845067
-Node: Anagram Program845182
-Node: Signature Program848244
-Node: Programs Summary849491
-Node: Programs Exercises850705
-Ref: Programs Exercises-Footnote-1854835
-Node: Advanced Features854921
-Node: Nondecimal Data857052
-Node: Boolean Typed Values858650
-Node: Array Sorting860531
-Node: Controlling Array Traversal861236
-Ref: Controlling Array Traversal-Footnote-1869604
-Node: Array Sorting Functions869722
-Ref: Array Sorting Functions-Footnote-1875633
-Node: Two-way I/O875829
-Ref: Two-way I/O-Footnote-1883555
-Ref: Two-way I/O-Footnote-2883742
-Node: TCP/IP Networking883824
-Node: Profiling886900
-Node: Extension Philosophy896209
-Node: Advanced Features Summary897688
-Node: Internationalization899703
-Node: I18N and L10N901377
-Node: Explaining gettext902064
-Ref: Explaining gettext-Footnote-1907956
-Ref: Explaining gettext-Footnote-2908141
-Node: Programmer i18n908306
-Ref: Programmer i18n-Footnote-1913255
-Node: Translator i18n913304
-Node: String Extraction914098
-Ref: String Extraction-Footnote-1915230
-Node: Printf Ordering915316
-Ref: Printf Ordering-Footnote-1918102
-Node: I18N Portability918166
-Ref: I18N Portability-Footnote-1920622
-Node: I18N Example920685
-Ref: I18N Example-Footnote-1923960
-Ref: I18N Example-Footnote-2924033
-Node: Gawk I18N924142
-Node: I18N Summary924764
-Node: Debugger926105
-Node: Debugging927105
-Node: Debugging Concepts927546
-Node: Debugging Terms929355
-Node: Awk Debugging931930
-Ref: Awk Debugging-Footnote-1932875
-Node: Sample Debugging Session933007
-Node: Debugger Invocation933541
-Node: Finding The Bug934927
-Node: List of Debugger Commands941401
-Node: Breakpoint Control942734
-Node: Debugger Execution Control946428
-Node: Viewing And Changing Data949790
-Node: Execution Stack953331
-Node: Debugger Info954968
-Node: Miscellaneous Debugger Commands959039
-Node: Readline Support964101
-Node: Limitations964997
-Node: Debugging Summary967551
-Node: Namespaces968830
-Node: Global Namespace969941
-Node: Qualified Names971339
-Node: Default Namespace972338
-Node: Changing The Namespace973079
-Node: Naming Rules974693
-Node: Internal Name Management976541
-Node: Namespace Example977583
-Node: Namespace And Features980145
-Node: Namespace Summary981580
-Node: Arbitrary Precision Arithmetic983057
-Node: Computer Arithmetic984544
-Ref: table-numeric-ranges988310
-Ref: table-floating-point-ranges988804
-Ref: Computer Arithmetic-Footnote-1989463
-Node: Math Definitions989520
-Ref: table-ieee-formats992496
-Node: MPFR features993064
-Ref: MPFR features-Footnote-1995292
-Node: FP Math Caution995426
-Ref: FP Math Caution-Footnote-1996498
-Node: Inexactness of computations996867
-Node: Inexact representation997898
-Node: Comparing FP Values999258
-Node: Errors accumulate1000499
-Node: Strange values1001955
-Ref: Strange values-Footnote-11004543
-Node: Getting Accuracy1004648
-Node: Try To Round1007358
-Node: Setting precision1008257
-Ref: table-predefined-precision-strings1008954
-Node: Setting the rounding mode1010785
-Ref: table-gawk-rounding-modes1011159
-Ref: Setting the rounding mode-Footnote-11015091
-Node: Arbitrary Precision Integers1015270
-Ref: Arbitrary Precision Integers-Footnote-11018445
-Node: Checking for MPFR1018594
-Node: POSIX Floating Point Problems1020068
-Ref: POSIX Floating Point Problems-Footnote-11024721
-Node: Floating point summary1024759
-Node: Dynamic Extensions1026949
-Node: Extension Intro1028502
-Node: Plugin License1029768
-Node: Extension Mechanism Outline1030565
-Ref: figure-load-extension1031004
-Ref: figure-register-new-function1032570
-Ref: figure-call-new-function1033663
-Node: Extension API Description1035726
-Node: Extension API Functions Introduction1037439
-Ref: table-api-std-headers1039275
-Node: General Data Types1043525
-Ref: General Data Types-Footnote-11052231
-Node: Memory Allocation Functions1052530
-Ref: Memory Allocation Functions-Footnote-11057031
-Node: Constructor Functions1057130
-Node: API Ownership of MPFR and GMP Values1060783
-Node: Registration Functions1062316
-Node: Extension Functions1063016
-Node: Exit Callback Functions1068338
-Node: Extension Version String1069588
-Node: Input Parsers1070251
-Node: Output Wrappers1082972
-Node: Two-way processors1087484
-Node: Printing Messages1089749
-Ref: Printing Messages-Footnote-11090920
-Node: Updating ERRNO1091073
-Node: Requesting Values1091812
-Ref: table-value-types-returned1092549
-Node: Accessing Parameters1093658
-Node: Symbol Table Access1094895
-Node: Symbol table by name1095407
-Ref: Symbol table by name-Footnote-11098432
-Node: Symbol table by cookie1098560
-Ref: Symbol table by cookie-Footnote-11102745
-Node: Cached values1102809
-Ref: Cached values-Footnote-11106345
-Node: Array Manipulation1106498
-Ref: Array Manipulation-Footnote-11107589
-Node: Array Data Types1107626
-Ref: Array Data Types-Footnote-11110284
-Node: Array Functions1110376
-Node: Flattening Arrays1114874
-Node: Creating Arrays1121850
-Node: Redirection API1126617
-Node: Extension API Variables1129450
-Node: Extension Versioning1130161
-Ref: gawk-api-version1130590
-Node: Extension GMP/MPFR Versioning1132322
-Node: Extension API Informational Variables1133950
-Node: Extension API Boilerplate1135023
-Node: Changes from API V11138997
-Node: Finding Extensions1140569
-Node: Extension Example1141128
-Node: Internal File Description1141926
-Node: Internal File Ops1146006
-Ref: Internal File Ops-Footnote-11157356
-Node: Using Internal File Ops1157496
-Ref: Using Internal File Ops-Footnote-11159879
-Node: Extension Samples1160153
-Node: Extension Sample File Functions1161682
-Node: Extension Sample Fnmatch1169331
-Node: Extension Sample Fork1170818
-Node: Extension Sample Inplace1172036
-Node: Extension Sample Ord1175662
-Node: Extension Sample Readdir1176498
-Ref: table-readdir-file-types1177387
-Node: Extension Sample Revout1178455
-Node: Extension Sample Rev2way1179044
-Node: Extension Sample Read write array1179784
-Node: Extension Sample Readfile1182949
-Node: Extension Sample Time1184044
-Node: Extension Sample API Tests1185796
-Node: gawkextlib1186288
-Node: Extension summary1189206
-Node: Extension Exercises1192908
-Node: Language History1194150
-Node: V7/SVR3.11195806
-Node: SVR41197958
-Node: POSIX1199392
-Node: BTL1200773
-Node: POSIX/GNU1201502
-Node: Feature History1207280
-Node: Common Extensions1224455
-Node: Ranges and Locales1225738
-Ref: Ranges and Locales-Footnote-11230354
-Ref: Ranges and Locales-Footnote-21230381
-Ref: Ranges and Locales-Footnote-31230616
-Node: Contributors1230839
-Node: History summary1236836
-Node: Installation1238216
-Node: Gawk Distribution1239160
-Node: Getting1239644
-Node: Extracting1240607
-Node: Distribution contents1242245
-Node: Unix Installation1249306
-Node: Quick Installation1250110
-Node: Compiling with MPFR1252530
-Node: Shell Startup Files1253220
-Node: Additional Configuration Options1254309
-Node: Configuration Philosophy1256624
-Node: Compiling from Git1259020
-Node: Building the Documentation1259575
-Node: Non-Unix Installation1260959
-Node: PC Installation1261419
-Node: PC Binary Installation1262257
-Node: PC Compiling1263130
-Node: PC Using1264247
-Node: Cygwin1267800
-Node: MSYS1269024
-Node: VMS Installation1269626
-Node: VMS Compilation1270345
-Ref: VMS Compilation-Footnote-11271574
-Node: VMS Dynamic Extensions1271632
-Node: VMS Installation Details1273317
-Node: VMS Running1275579
-Node: VMS GNV1279858
-Node: Bugs1280572
-Node: Bug definition1281484
-Node: Bug address1284420
-Node: Usenet1287608
-Node: Performance bugs1288797
-Node: Asking for help1291718
-Node: Maintainers1293685
-Node: Other Versions1294879
-Node: Installation summary1303043
-Node: Notes1304407
-Node: Compatibility Mode1305201
-Node: Additions1305983
-Node: Accessing The Source1306908
-Node: Adding Code1308345
-Node: New Ports1315160
-Node: Derived Files1319535
-Ref: Derived Files-Footnote-11325195
-Ref: Derived Files-Footnote-21325230
-Ref: Derived Files-Footnote-31325828
-Node: Future Extensions1325942
-Node: Implementation Limitations1326600
-Node: Extension Design1327810
-Node: Old Extension Problems1328954
-Ref: Old Extension Problems-Footnote-11330472
-Node: Extension New Mechanism Goals1330529
-Ref: Extension New Mechanism Goals-Footnote-11333893
-Node: Extension Other Design Decisions1334082
-Node: Extension Future Growth1336195
-Node: Notes summary1336801
-Node: Basic Concepts1337959
-Node: Basic High Level1338640
-Ref: figure-general-flow1338922
-Ref: figure-process-flow1339608
-Ref: Basic High Level-Footnote-11342910
-Node: Basic Data Typing1343095
-Node: Glossary1346423
-Node: Copying1378310
-Node: GNU Free Documentation License1415853
-Node: Index1440973
+Node: Foreword345721
+Node: Foreword450163
+Node: Preface51695
+Ref: Preface-Footnote-154554
+Ref: Preface-Footnote-254663
+Ref: Preface-Footnote-354897
+Node: History55039
+Node: Names57391
+Ref: Names-Footnote-158495
+Node: This Manual58642
+Ref: This Manual-Footnote-165281
+Node: Conventions65381
+Node: Manual History67750
+Ref: Manual History-Footnote-170747
+Ref: Manual History-Footnote-270788
+Node: How To Contribute70862
+Node: Acknowledgments71784
+Node: Getting Started76721
+Node: Running gawk79160
+Node: One-shot80350
+Node: Read Terminal81613
+Node: Long83606
+Node: Executable Scripts85119
+Ref: Executable Scripts-Footnote-187752
+Node: Comments87855
+Node: Quoting90339
+Node: DOS Quoting95865
+Node: Sample Data Files97921
+Node: Very Simple100516
+Node: Two Rules106618
+Node: More Complex108503
+Node: Statements/Lines110835
+Ref: Statements/Lines-Footnote-1115319
+Node: Other Features115584
+Node: When116520
+Ref: When-Footnote-1118274
+Node: Intro Summary118339
+Node: Invoking Gawk119223
+Node: Command Line120737
+Node: Options121535
+Ref: Options-Footnote-1139719
+Ref: Options-Footnote-2139950
+Node: Other Arguments139975
+Node: Naming Standard Input143986
+Node: Environment Variables145196
+Node: AWKPATH Variable145754
+Ref: AWKPATH Variable-Footnote-1149166
+Ref: AWKPATH Variable-Footnote-2149200
+Node: AWKLIBPATH Variable149571
+Ref: AWKLIBPATH Variable-Footnote-1151268
+Node: Other Environment Variables151643
+Node: Exit Status155731
+Node: Include Files156408
+Node: Loading Shared Libraries160098
+Node: Obsolete161526
+Node: Undocumented162141
+Node: Invoking Summary162438
+Node: Regexp165279
+Node: Regexp Usage166733
+Node: Escape Sequences168770
+Node: Regexp Operators175012
+Node: Regexp Operator Details175497
+Ref: Regexp Operator Details-Footnote-1182861
+Node: Interval Expressions183008
+Ref: Interval Expressions-Footnote-1185183
+Node: Bracket Expressions185281
+Ref: table-char-classes187757
+Node: Leftmost Longest191084
+Node: Computed Regexps192387
+Node: GNU Regexp Operators195814
+Node: Case-sensitivity199492
+Ref: Case-sensitivity-Footnote-1202358
+Ref: Case-sensitivity-Footnote-2202593
+Node: Regexp Summary202701
+Node: Reading Files204167
+Node: Records206436
+Node: awk split records207511
+Node: gawk split records212211
+Ref: gawk split records-Footnote-1217285
+Node: Fields217322
+Node: Nonconstant Fields220063
+Ref: Nonconstant Fields-Footnote-1222299
+Node: Changing Fields222503
+Node: Field Separators228534
+Node: Default Field Splitting231232
+Node: Regexp Field Splitting232350
+Node: Single Character Fields236027
+Node: Command Line Field Separator237087
+Node: Full Line Fields240305
+Ref: Full Line Fields-Footnote-1241827
+Ref: Full Line Fields-Footnote-2241873
+Node: Field Splitting Summary241974
+Node: Constant Size244048
+Node: Fixed width data244780
+Node: Skipping intervening248247
+Node: Allowing trailing data249045
+Node: Fields with fixed data250082
+Node: Splitting By Content251600
+Ref: Splitting By Content-Footnote-1255436
+Node: More CSV255599
+Node: FS versus FPAT257214
+Node: Testing field creation258374
+Node: Multiple Line259999
+Node: Getline266276
+Node: Plain Getline268745
+Node: Getline/Variable271318
+Node: Getline/File272469
+Node: Getline/Variable/File273857
+Ref: Getline/Variable/File-Footnote-1275462
+Node: Getline/Pipe275550
+Node: Getline/Variable/Pipe278254
+Node: Getline/Coprocess279389
+Node: Getline/Variable/Coprocess280656
+Node: Getline Notes281398
+Node: Getline Summary284195
+Ref: table-getline-variants284619
+Node: Read Timeout285368
+Ref: Read Timeout-Footnote-1289284
+Node: Retrying Input289342
+Node: Command-line directories290541
+Node: Input Summary291447
+Node: Input Exercises294619
+Node: Printing295053
+Node: Print296887
+Node: Print Examples298344
+Node: Output Separators301124
+Node: OFMT303141
+Node: Printf304497
+Node: Basic Printf305282
+Node: Control Letters306856
+Node: Format Modifiers312018
+Node: Printf Examples318033
+Node: Redirection320519
+Node: Special FD327360
+Ref: Special FD-Footnote-1330528
+Node: Special Files330602
+Node: Other Inherited Files331219
+Node: Special Network332220
+Node: Special Caveats333080
+Node: Close Files And Pipes334029
+Ref: table-close-pipe-return-values340936
+Ref: Close Files And Pipes-Footnote-1341750
+Ref: Close Files And Pipes-Footnote-2341898
+Node: Nonfatal342050
+Node: Output Summary344388
+Node: Output Exercises345610
+Node: Expressions346289
+Node: Values347477
+Node: Constants348155
+Node: Scalar Constants348846
+Ref: Scalar Constants-Footnote-1351356
+Node: Nondecimal-numbers351606
+Node: Regexp Constants354607
+Node: Using Constant Regexps355133
+Node: Standard Regexp Constants355755
+Node: Strong Regexp Constants358943
+Node: Variables362658
+Node: Using Variables363315
+Node: Assignment Options365225
+Node: Conversion367696
+Node: Strings And Numbers368220
+Ref: Strings And Numbers-Footnote-1371283
+Node: Locale influences conversions371392
+Ref: table-locale-affects374150
+Node: All Operators374769
+Node: Arithmetic Ops375398
+Node: Concatenation378114
+Ref: Concatenation-Footnote-1380961
+Node: Assignment Ops381068
+Ref: table-assign-ops386059
+Node: Increment Ops387373
+Node: Truth Values and Conditions390833
+Node: Truth Values391907
+Node: Typing and Comparison392955
+Node: Variable Typing393775
+Ref: Variable Typing-Footnote-1400238
+Ref: Variable Typing-Footnote-2400310
+Node: Comparison Operators400387
+Ref: table-relational-ops400806
+Node: POSIX String Comparison404302
+Ref: POSIX String Comparison-Footnote-1405997
+Ref: POSIX String Comparison-Footnote-2406136
+Node: Boolean Ops406220
+Ref: Boolean Ops-Footnote-1410702
+Node: Conditional Exp410794
+Node: Function Calls412530
+Node: Precedence416407
+Node: Locales420066
+Node: Expressions Summary421698
+Node: Patterns and Actions424271
+Node: Pattern Overview425391
+Node: Regexp Patterns427068
+Node: Expression Patterns427610
+Node: Ranges431391
+Node: BEGIN/END434499
+Node: Using BEGIN/END435260
+Ref: Using BEGIN/END-Footnote-1438014
+Node: I/O And BEGIN/END438120
+Node: BEGINFILE/ENDFILE440433
+Node: Empty443664
+Node: Using Shell Variables443981
+Node: Action Overview446255
+Node: Statements448580
+Node: If Statement450428
+Node: While Statement451923
+Node: Do Statement453951
+Node: For Statement455099
+Node: Switch Statement458354
+Node: Break Statement460795
+Node: Continue Statement462887
+Node: Next Statement464714
+Node: Nextfile Statement467097
+Node: Exit Statement469786
+Node: Built-in Variables472189
+Node: User-modified473322
+Node: Auto-set481089
+Ref: Auto-set-Footnote-1497896
+Ref: Auto-set-Footnote-2498102
+Node: ARGC and ARGV498158
+Node: Pattern Action Summary502371
+Node: Arrays504801
+Node: Array Basics506130
+Node: Array Intro506974
+Ref: figure-array-elements508949
+Ref: Array Intro-Footnote-1511654
+Node: Reference to Elements511782
+Node: Assigning Elements514246
+Node: Array Example514737
+Node: Scanning an Array516691
+Node: Controlling Scanning519713
+Ref: Controlling Scanning-Footnote-1526169
+Node: Numeric Array Subscripts526485
+Node: Uninitialized Subscripts528669
+Node: Delete530288
+Ref: Delete-Footnote-1533040
+Node: Multidimensional533097
+Node: Multiscanning536192
+Node: Arrays of Arrays537783
+Node: Arrays Summary542551
+Node: Functions544644
+Node: Built-in545682
+Node: Calling Built-in546835
+Node: Boolean Functions548831
+Node: Numeric Functions549385
+Ref: Numeric Functions-Footnote-1553412
+Ref: Numeric Functions-Footnote-2554060
+Ref: Numeric Functions-Footnote-3554108
+Node: String Functions554380
+Ref: String Functions-Footnote-1579222
+Ref: String Functions-Footnote-2579350
+Ref: String Functions-Footnote-3579598
+Node: Gory Details579685
+Ref: table-sub-escapes581476
+Ref: table-sub-proposed582996
+Ref: table-posix-sub584360
+Ref: table-gensub-escapes585902
+Ref: Gory Details-Footnote-1586726
+Node: I/O Functions586880
+Ref: table-system-return-values593334
+Ref: I/O Functions-Footnote-1595415
+Ref: I/O Functions-Footnote-2595563
+Node: Time Functions595683
+Ref: Time Functions-Footnote-1606354
+Ref: Time Functions-Footnote-2606422
+Ref: Time Functions-Footnote-3606580
+Ref: Time Functions-Footnote-4606691
+Ref: Time Functions-Footnote-5606803
+Ref: Time Functions-Footnote-6607030
+Node: Bitwise Functions607296
+Ref: table-bitwise-ops607890
+Ref: Bitwise Functions-Footnote-1613954
+Ref: Bitwise Functions-Footnote-2614127
+Node: Type Functions614318
+Node: I18N Functions617738
+Node: User-defined619389
+Node: Definition Syntax620201
+Ref: Definition Syntax-Footnote-1625895
+Node: Function Example625966
+Ref: Function Example-Footnote-1628888
+Node: Function Calling628910
+Node: Calling A Function629498
+Node: Variable Scope630456
+Node: Pass By Value/Reference633450
+Node: Function Caveats636094
+Ref: Function Caveats-Footnote-1638141
+Node: Return Statement638261
+Node: Dynamic Typing641240
+Node: Indirect Calls642170
+Node: Functions Summary653097
+Node: Library Functions655802
+Ref: Library Functions-Footnote-1659409
+Ref: Library Functions-Footnote-2659552
+Node: Library Names659723
+Ref: Library Names-Footnote-1663390
+Ref: Library Names-Footnote-2663613
+Node: General Functions663699
+Node: Strtonum Function664881
+Node: Assert Function667903
+Node: Round Function671229
+Node: Cliff Random Function672769
+Node: Ordinal Functions673785
+Ref: Ordinal Functions-Footnote-1676848
+Ref: Ordinal Functions-Footnote-2677100
+Node: Join Function677310
+Ref: Join Function-Footnote-1679080
+Node: Getlocaltime Function679280
+Node: Readfile Function683022
+Node: Shell Quoting684999
+Node: Isnumeric Function686427
+Node: Data File Management687815
+Node: Filetrans Function688447
+Node: Rewind Function692543
+Node: File Checking694452
+Ref: File Checking-Footnote-1695786
+Node: Empty Files695987
+Node: Ignoring Assigns697966
+Node: Getopt Function699516
+Ref: Getopt Function-Footnote-1714813
+Node: Passwd Functions715013
+Ref: Passwd Functions-Footnote-1723852
+Node: Group Functions723940
+Ref: Group Functions-Footnote-1731838
+Node: Walking Arrays732045
+Node: Library Functions Summary735053
+Node: Library Exercises736459
+Node: Sample Programs736924
+Node: Running Examples737694
+Node: Clones738422
+Node: Cut Program739646
+Node: Egrep Program749786
+Node: Id Program758787
+Node: Split Program768722
+Ref: Split Program-Footnote-1778615
+Node: Tee Program778788
+Node: Uniq Program781578
+Node: Wc Program789166
+Node: Bytes vs. Characters789553
+Node: Using extensions791101
+Node: wc program791855
+Node: Miscellaneous Programs796720
+Node: Dupword Program797933
+Node: Alarm Program799963
+Node: Translate Program804818
+Ref: Translate Program-Footnote-1809383
+Node: Labels Program809653
+Ref: Labels Program-Footnote-1813004
+Node: Word Sorting813088
+Node: History Sorting817160
+Node: Extract Program819385
+Node: Simple Sed827398
+Node: Igawk Program830472
+Ref: Igawk Program-Footnote-1844803
+Ref: Igawk Program-Footnote-2845005
+Ref: Igawk Program-Footnote-3845127
+Node: Anagram Program845242
+Node: Signature Program848304
+Node: Programs Summary849551
+Node: Programs Exercises850765
+Ref: Programs Exercises-Footnote-1854895
+Node: Advanced Features854981
+Node: Nondecimal Data857112
+Node: Boolean Typed Values858710
+Node: Array Sorting860591
+Node: Controlling Array Traversal861296
+Ref: Controlling Array Traversal-Footnote-1869664
+Node: Array Sorting Functions869782
+Ref: Array Sorting Functions-Footnote-1875693
+Node: Two-way I/O875889
+Ref: Two-way I/O-Footnote-1883615
+Ref: Two-way I/O-Footnote-2883802
+Node: TCP/IP Networking883884
+Node: Profiling886960
+Node: Extension Philosophy896269
+Node: Advanced Features Summary897748
+Node: Internationalization899763
+Node: I18N and L10N901437
+Node: Explaining gettext902124
+Ref: Explaining gettext-Footnote-1908016
+Ref: Explaining gettext-Footnote-2908201
+Node: Programmer i18n908366
+Ref: Programmer i18n-Footnote-1913315
+Node: Translator i18n913364
+Node: String Extraction914158
+Ref: String Extraction-Footnote-1915290
+Node: Printf Ordering915376
+Ref: Printf Ordering-Footnote-1918162
+Node: I18N Portability918226
+Ref: I18N Portability-Footnote-1920682
+Node: I18N Example920745
+Ref: I18N Example-Footnote-1924020
+Ref: I18N Example-Footnote-2924093
+Node: Gawk I18N924202
+Node: I18N Summary924824
+Node: Debugger926165
+Node: Debugging927165
+Node: Debugging Concepts927606
+Node: Debugging Terms929415
+Node: Awk Debugging931990
+Ref: Awk Debugging-Footnote-1932935
+Node: Sample Debugging Session933067
+Node: Debugger Invocation933601
+Node: Finding The Bug934987
+Node: List of Debugger Commands941461
+Node: Breakpoint Control942794
+Node: Debugger Execution Control946488
+Node: Viewing And Changing Data949850
+Node: Execution Stack953391
+Node: Debugger Info955028
+Node: Miscellaneous Debugger Commands959099
+Node: Readline Support964161
+Node: Limitations965057
+Node: Debugging Summary967611
+Node: Namespaces968890
+Node: Global Namespace970001
+Node: Qualified Names971399
+Node: Default Namespace972398
+Node: Changing The Namespace973139
+Node: Naming Rules974753
+Node: Internal Name Management976601
+Node: Namespace Example977643
+Node: Namespace And Features980205
+Node: Namespace Summary981640
+Node: Arbitrary Precision Arithmetic983117
+Node: Computer Arithmetic984604
+Ref: table-numeric-ranges988370
+Ref: table-floating-point-ranges988864
+Ref: Computer Arithmetic-Footnote-1989523
+Node: Math Definitions989580
+Ref: table-ieee-formats992556
+Node: MPFR features993124
+Node: MPFR Deprecated993570
+Ref: MPFR Deprecated-Footnote-1994500
+Node: MPFR Intro994654
+Node: FP Math Caution996294
+Ref: FP Math Caution-Footnote-1997366
+Node: Inexactness of computations997735
+Node: Inexact representation998766
+Node: Comparing FP Values1000126
+Node: Errors accumulate1001367
+Node: Strange values1002823
+Ref: Strange values-Footnote-11005411
+Node: Getting Accuracy1005516
+Node: Try To Round1008226
+Node: Setting precision1009125
+Ref: table-predefined-precision-strings1009822
+Node: Setting the rounding mode1011653
+Ref: table-gawk-rounding-modes1012027
+Ref: Setting the rounding mode-Footnote-11015959
+Node: Arbitrary Precision Integers1016138
+Ref: Arbitrary Precision Integers-Footnote-11019313
+Node: Checking for MPFR1019462
+Node: POSIX Floating Point Problems1020936
+Ref: POSIX Floating Point Problems-Footnote-11025589
+Node: Floating point summary1025627
+Node: Dynamic Extensions1027817
+Node: Extension Intro1029370
+Node: Plugin License1030636
+Node: Extension Mechanism Outline1031433
+Ref: figure-load-extension1031872
+Ref: figure-register-new-function1033438
+Ref: figure-call-new-function1034531
+Node: Extension API Description1036594
+Node: Extension API Functions Introduction1038307
+Ref: table-api-std-headers1040143
+Node: General Data Types1044393
+Ref: General Data Types-Footnote-11053099
+Node: Memory Allocation Functions1053398
+Ref: Memory Allocation Functions-Footnote-11057899
+Node: Constructor Functions1057998
+Node: API Ownership of MPFR and GMP Values1061651
+Node: Registration Functions1063184
+Node: Extension Functions1063884
+Node: Exit Callback Functions1069206
+Node: Extension Version String1070456
+Node: Input Parsers1071119
+Node: Output Wrappers1083840
+Node: Two-way processors1088352
+Node: Printing Messages1090617
+Ref: Printing Messages-Footnote-11091788
+Node: Updating ERRNO1091941
+Node: Requesting Values1092680
+Ref: table-value-types-returned1093417
+Node: Accessing Parameters1094526
+Node: Symbol Table Access1095763
+Node: Symbol table by name1096275
+Ref: Symbol table by name-Footnote-11099300
+Node: Symbol table by cookie1099428
+Ref: Symbol table by cookie-Footnote-11103613
+Node: Cached values1103677
+Ref: Cached values-Footnote-11107213
+Node: Array Manipulation1107366
+Ref: Array Manipulation-Footnote-11108457
+Node: Array Data Types1108494
+Ref: Array Data Types-Footnote-11111152
+Node: Array Functions1111244
+Node: Flattening Arrays1115742
+Node: Creating Arrays1122718
+Node: Redirection API1127485
+Node: Extension API Variables1130318
+Node: Extension Versioning1131029
+Ref: gawk-api-version1131458
+Node: Extension GMP/MPFR Versioning1133190
+Node: Extension API Informational Variables1134818
+Node: Extension API Boilerplate1135891
+Node: Changes from API V11139865
+Node: Finding Extensions1141437
+Node: Extension Example1141996
+Node: Internal File Description1142794
+Node: Internal File Ops1146874
+Ref: Internal File Ops-Footnote-11158224
+Node: Using Internal File Ops1158364
+Ref: Using Internal File Ops-Footnote-11160747
+Node: Extension Samples1161021
+Node: Extension Sample File Functions1162550
+Node: Extension Sample Fnmatch1170199
+Node: Extension Sample Fork1171686
+Node: Extension Sample Inplace1172904
+Node: Extension Sample Ord1176530
+Node: Extension Sample Readdir1177366
+Ref: table-readdir-file-types1178255
+Node: Extension Sample Revout1179323
+Node: Extension Sample Rev2way1179912
+Node: Extension Sample Read write array1180652
+Node: Extension Sample Readfile1183817
+Node: Extension Sample Time1184912
+Node: Extension Sample API Tests1186664
+Node: gawkextlib1187156
+Node: Extension summary1190074
+Node: Extension Exercises1193776
+Node: Language History1195018
+Node: V7/SVR3.11196674
+Node: SVR41198826
+Node: POSIX1200260
+Node: BTL1201641
+Node: POSIX/GNU1202370
+Node: Feature History1208148
+Node: Common Extensions1225323
+Node: Ranges and Locales1226606
+Ref: Ranges and Locales-Footnote-11231222
+Ref: Ranges and Locales-Footnote-21231249
+Ref: Ranges and Locales-Footnote-31231484
+Node: Contributors1231707
+Node: History summary1237704
+Node: Installation1239084
+Node: Gawk Distribution1240028
+Node: Getting1240512
+Node: Extracting1241475
+Node: Distribution contents1243113
+Node: Unix Installation1250174
+Node: Quick Installation1250978
+Node: Compiling with MPFR1253398
+Node: Shell Startup Files1254088
+Node: Additional Configuration Options1255177
+Node: Configuration Philosophy1257492
+Node: Compiling from Git1259888
+Node: Building the Documentation1260443
+Node: Non-Unix Installation1261827
+Node: PC Installation1262287
+Node: PC Binary Installation1263125
+Node: PC Compiling1263998
+Node: PC Using1265115
+Node: Cygwin1268668
+Node: MSYS1269892
+Node: VMS Installation1270494
+Node: VMS Compilation1271213
+Ref: VMS Compilation-Footnote-11272442
+Node: VMS Dynamic Extensions1272500
+Node: VMS Installation Details1274185
+Node: VMS Running1276447
+Node: VMS GNV1280726
+Node: Bugs1281440
+Node: Bug definition1282352
+Node: Bug address1285288
+Node: Usenet1288476
+Node: Performance bugs1289665
+Node: Asking for help1292586
+Node: Maintainers1294553
+Node: Other Versions1295747
+Node: Installation summary1303911
+Node: Notes1305275
+Node: Compatibility Mode1306069
+Node: Additions1306851
+Node: Accessing The Source1307776
+Node: Adding Code1309213
+Node: New Ports1316028
+Node: Derived Files1320403
+Ref: Derived Files-Footnote-11326063
+Ref: Derived Files-Footnote-21326098
+Ref: Derived Files-Footnote-31326696
+Node: Future Extensions1326810
+Node: Implementation Limitations1327468
+Node: Extension Design1328678
+Node: Old Extension Problems1329822
+Ref: Old Extension Problems-Footnote-11331340
+Node: Extension New Mechanism Goals1331397
+Ref: Extension New Mechanism Goals-Footnote-11334761
+Node: Extension Other Design Decisions1334950
+Node: Extension Future Growth1337063
+Node: Notes summary1337669
+Node: Basic Concepts1338827
+Node: Basic High Level1339508
+Ref: figure-general-flow1339790
+Ref: figure-process-flow1340476
+Ref: Basic High Level-Footnote-11343778
+Node: Basic Data Typing1343963
+Node: Glossary1347291
+Node: Copying1379178
+Node: GNU Free Documentation License1416721
+Node: Index1441841
 
 End Tag Table
 
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 2d0e7f16..8e2c0442 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -926,6 +926,8 @@ particular records in a file and perform operations upon them.
 * Computer Arithmetic::                 A quick intro to computer math.
 * Math Definitions::                    Defining terms used.
 * MPFR features::                       The MPFR features in @command{gawk}.
+* MPFR Deprecated::                     MPFR features are deprecated!
+* MPFR Intro::                          MPFR General introduction.
 * FP Math Caution::                     Things to know.
 * Inexactness of computations::         Floating point math is not exact.
 * Inexact representation::              Numbers are not exactly represented.
@@ -5127,13 +5129,16 @@ It also describes the @code{ordchr} extension.
 This @value{SECTION} describes features and/or command-line options from
 previous releases of @command{gawk} that either are not available in the
 current version or are still supported but deprecated (meaning that
-they will @emph{not} be in the next release).
+they will @emph{not} be in a future release).
 
+@ignore
+@c This happened long enough ago that we can remove it.
 The process-related special files @file{/dev/pid}, @file{/dev/ppid},
 @file{/dev/pgrpid}, and @file{/dev/user} were deprecated in @command{gawk}
 3.1, but still worked.  As of @value{PVERSION} 4.0, they are no longer
 interpreted specially by @command{gawk}.  (Use @code{PROCINFO} instead;
 see @ref{Auto-set}.)
+@end ignore
 
 @ignore
 This @value{SECTION}
@@ -5141,6 +5146,10 @@ is thus essentially a place holder,
 in case some option becomes obsolete in a future version of @command{gawk}.
 @end ignore
 
+The multiprecision arithmetic feature is deprecated as of @command{gawk} @value{PVERSION} 5.2.
+Use of @option{-M}/@option{--bignum} produces a warning message.  The feature
+will be removed in the release of 2024.
+
 @node Undocumented
 @section Undocumented Options and Features
 @cindex undocumented features
@@ -34162,20 +34171,37 @@ one extra bit of significand.
 @node MPFR features
 @section Arbitrary-Precision Arithmetic Features in @command{gawk}
 
-@quotation WARNING
+This @value{SECTION} briefly describes arbitrary-precision
+arithmetic in @command{gawk}.
+
+@menu
+* MPFR Deprecated::             MPFR features are deprecated!
+* MPFR Intro::                  MPFR General introduction.
+@end menu
+
+@node MPFR Deprecated
+@subsection Arbitrary Precision Arithmetic is Deprecated!
+
 As of @value{PVERSION} 5.2,
 arbitrary precision arithmetic in @command{gawk}
 is @emph{deprecated}.  It will be removed from @command{gawk} in 2024.
 
-MPFR support is deprecated because its inclusion was a mistake. It has
+This feature is deprecated because its inclusion was a mistake. It has
 led to endless bug reports, misuse of the feature and public abuse of the
 maintainer, for no real increased value.
 
 If you use this feature, you should start working now to find a different
 toolset with which to accomplish your goals.@footnote{Of course, you can
 always continue to use a version of @command{gawk} that still supports
-MPFR mode. It simply will be unmaintained.}
-@end quotation
+arbitrary precison arithmetic. It simply will be unmaintained.}
+
+If the feature is very important to you, then consider if you are willing
+to volunteer to maintain it, so that it can continue to be included
+in @command{gawk}. If that is the case, contact the maintainer to discuss it
+with him.  You may do so by submitting a bug report.
+
+@node MPFR Intro
+@subsection Arbitrary Precsioon Introduction
 
 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
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index b862af52..063a5428 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -921,6 +921,8 @@ particular records in a file and perform operations upon them.
 * Computer Arithmetic::                 A quick intro to computer math.
 * Math Definitions::                    Defining terms used.
 * MPFR features::                       The MPFR features in @command{gawk}.
+* MPFR Deprecated::                     MPFR features are deprecated!
+* MPFR Intro::                          MPFR General introduction.
 * FP Math Caution::                     Things to know.
 * Inexactness of computations::         Floating point math is not exact.
 * Inexact representation::              Numbers are not exactly represented.
@@ -4993,13 +4995,16 @@ It also describes the @code{ordchr} extension.
 This @value{SECTION} describes features and/or command-line options from
 previous releases of @command{gawk} that either are not available in the
 current version or are still supported but deprecated (meaning that
-they will @emph{not} be in the next release).
+they will @emph{not} be in a future release).
 
+@ignore
+@c This happened long enough ago that we can remove it.
 The process-related special files @file{/dev/pid}, @file{/dev/ppid},
 @file{/dev/pgrpid}, and @file{/dev/user} were deprecated in @command{gawk}
 3.1, but still worked.  As of @value{PVERSION} 4.0, they are no longer
 interpreted specially by @command{gawk}.  (Use @code{PROCINFO} instead;
 see @ref{Auto-set}.)
+@end ignore
 
 @ignore
 This @value{SECTION}
@@ -5007,6 +5012,10 @@ is thus essentially a place holder,
 in case some option becomes obsolete in a future version of @command{gawk}.
 @end ignore
 
+The multiprecision arithmetic feature is deprecated as of @command{gawk} @value{PVERSION} 5.2.
+Use of @option{-M}/@option{--bignum} produces a warning message.  The feature
+will be removed in the release of 2024.
+
 @node Undocumented
 @section Undocumented Options and Features
 @cindex undocumented features
@@ -33044,20 +33053,37 @@ one extra bit of significand.
 @node MPFR features
 @section Arbitrary-Precision Arithmetic Features in @command{gawk}
 
-@quotation WARNING
+This @value{SECTION} briefly describes arbitrary-precision
+arithmetic in @command{gawk}.
+
+@menu
+* MPFR Deprecated::             MPFR features are deprecated!
+* MPFR Intro::                  MPFR General introduction.
+@end menu
+
+@node MPFR Deprecated
+@subsection Arbitrary Precision Arithmetic is Deprecated!
+
 As of @value{PVERSION} 5.2,
 arbitrary precision arithmetic in @command{gawk}
 is @emph{deprecated}.  It will be removed from @command{gawk} in 2024.
 
-MPFR support is deprecated because its inclusion was a mistake. It has
+This feature is deprecated because its inclusion was a mistake. It has
 led to endless bug reports, misuse of the feature and public abuse of the
 maintainer, for no real increased value.
 
 If you use this feature, you should start working now to find a different
 toolset with which to accomplish your goals.@footnote{Of course, you can
 always continue to use a version of @command{gawk} that still supports
-MPFR mode. It simply will be unmaintained.}
-@end quotation
+arbitrary precison arithmetic. It simply will be unmaintained.}
+
+If the feature is very important to you, then consider if you are willing
+to volunteer to maintain it, so that it can continue to be included
+in @command{gawk}. If that is the case, contact the maintainer to discuss it
+with him.  You may do so by submitting a bug report.
+
+@node MPFR Intro
+@subsection Arbitrary Precsioon Introduction
 
 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