Merge branch 'gawk-5.1-stable'

5 files changed, 494 insertions, 453 deletions

diff --git a/NEWS b/NEWS
index 589bf886..a90d6842 100644
--- a/NEWS
+++ b/NEWS
@@ -74,10 +74,14 @@ Changes from 5.1.0 to 5.1.1
 14. The manual has been updated with much more information about what is
     and is not a bug, and the changes in the gawk mailing lists.
 
-15. Similar to item #4 above, division by zero is now fatal in MPFR
+15. The behavior of strongly-typed regexp constants when passed as the
+    third argument to sub() or gsub() has been clarified in the code and
+    in the manual.
+
+16. Similar to item #4 above, division by zero is now fatal in MPFR
     mode, as it is in regular mode.
 
-16. There have been numerous minor code cleanups and bug fixes. See the
+17. There have been numerous minor code cleanups and bug fixes. See the
     ChangeLog for details.
 
 Changes from 5.0.1 to 5.1.0
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 06a8ddf6..8a00b6ab 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2021-09-23         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* gawktexi.in (Strong Regexp Constants): Document that they
+	can be assigned with -v. Thanks to J Naman <jnaman2@gmail.com>
+	for the report.
+
 2021-09-22         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* gawktexi.in (Compiling from Git): New node.
diff --git a/doc/gawk.info b/doc/gawk.info
index 469b7e0f..11971ca1 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -8270,6 +8270,15 @@ more confusing.  Instead, you may use them only in certain contexts:
      one of the built-in functions listed above, or passed as a
      parameter to a user-defined function.
 
+   You may use the '-v' option (*note Options::) to assign a
+strongly-typed regexp constant to a variable on the command line, like
+so:
+
+     gawk -v pattern='@/something(interesting)+/' ...
+
+You may also make such assignments as regular command-line arguments
+(*note Other Arguments::).
+
    You may use the 'typeof()' built-in function (*note Type Functions::)
 to determine if a variable or function parameter is a regexp variable.
 
@@ -38728,457 +38737,457 @@ Node: Regexp Constants352918
 Node: Using Constant Regexps353444
 Node: Standard Regexp Constants354066
 Node: Strong Regexp Constants357254
-Node: Variables360678
-Node: Using Variables361335
-Node: Assignment Options363245
-Node: Conversion365716
-Node: Strings And Numbers366240
-Ref: Strings And Numbers-Footnote-1369303
-Node: Locale influences conversions369412
-Ref: table-locale-affects372170
-Node: All Operators372788
-Node: Arithmetic Ops373417
-Node: Concatenation376133
-Ref: Concatenation-Footnote-1378980
-Node: Assignment Ops379087
-Ref: table-assign-ops384078
-Node: Increment Ops385391
-Node: Truth Values and Conditions388851
-Node: Truth Values389925
-Node: Typing and Comparison390973
-Node: Variable Typing391793
-Ref: Variable Typing-Footnote-1398256
-Ref: Variable Typing-Footnote-2398328
-Node: Comparison Operators398405
-Ref: table-relational-ops398824
-Node: POSIX String Comparison402319
-Ref: POSIX String Comparison-Footnote-1404014
-Ref: POSIX String Comparison-Footnote-2404153
-Node: Boolean Ops404237
-Ref: Boolean Ops-Footnote-1408719
-Node: Conditional Exp408811
-Node: Function Calls410547
-Node: Precedence414424
-Node: Locales418083
-Node: Expressions Summary419715
-Node: Patterns and Actions422288
-Node: Pattern Overview423408
-Node: Regexp Patterns425085
-Node: Expression Patterns425627
-Node: Ranges429408
-Node: BEGIN/END432516
-Node: Using BEGIN/END433277
-Ref: Using BEGIN/END-Footnote-1436031
-Node: I/O And BEGIN/END436137
-Node: BEGINFILE/ENDFILE438450
-Node: Empty441681
-Node: Using Shell Variables441998
-Node: Action Overview444272
-Node: Statements446597
-Node: If Statement448445
-Node: While Statement449940
-Node: Do Statement451968
-Node: For Statement453116
-Node: Switch Statement456287
-Node: Break Statement458728
-Node: Continue Statement460820
-Node: Next Statement462647
-Node: Nextfile Statement465030
-Node: Exit Statement467719
-Node: Built-in Variables470122
-Node: User-modified471255
-Node: Auto-set479022
-Ref: Auto-set-Footnote-1495829
-Ref: Auto-set-Footnote-2496035
-Node: ARGC and ARGV496091
-Node: Pattern Action Summary500304
-Node: Arrays502734
-Node: Array Basics504063
-Node: Array Intro504907
-Ref: figure-array-elements506882
-Ref: Array Intro-Footnote-1509586
-Node: Reference to Elements509714
-Node: Assigning Elements512178
-Node: Array Example512669
-Node: Scanning an Array514428
-Node: Controlling Scanning517450
-Ref: Controlling Scanning-Footnote-1523906
-Node: Numeric Array Subscripts524222
-Node: Uninitialized Subscripts526406
-Node: Delete528025
-Ref: Delete-Footnote-1530777
-Node: Multidimensional530834
-Node: Multiscanning533929
-Node: Arrays of Arrays535520
-Node: Arrays Summary540288
-Node: Functions542381
-Node: Built-in543419
-Node: Calling Built-in544572
-Node: Boolean Functions546568
-Node: Numeric Functions547122
-Ref: Numeric Functions-Footnote-1551149
-Ref: Numeric Functions-Footnote-2551797
-Ref: Numeric Functions-Footnote-3551845
-Node: String Functions552117
-Ref: String Functions-Footnote-1576632
-Ref: String Functions-Footnote-2576760
-Ref: String Functions-Footnote-3577008
-Node: Gory Details577095
-Ref: table-sub-escapes578886
-Ref: table-sub-proposed580405
-Ref: table-posix-sub581768
-Ref: table-gensub-escapes583309
-Ref: Gory Details-Footnote-1584132
-Node: I/O Functions584286
-Ref: table-system-return-values590740
-Ref: I/O Functions-Footnote-1592820
-Ref: I/O Functions-Footnote-2592968
-Node: Time Functions593088
-Ref: Time Functions-Footnote-1603759
-Ref: Time Functions-Footnote-2603827
-Ref: Time Functions-Footnote-3603985
-Ref: Time Functions-Footnote-4604096
-Ref: Time Functions-Footnote-5604208
-Ref: Time Functions-Footnote-6604435
-Node: Bitwise Functions604701
-Ref: table-bitwise-ops605295
-Ref: Bitwise Functions-Footnote-1611358
-Ref: Bitwise Functions-Footnote-2611531
-Node: Type Functions611722
-Node: I18N Functions614676
-Node: User-defined616327
-Node: Definition Syntax617139
-Ref: Definition Syntax-Footnote-1622833
-Node: Function Example622904
-Ref: Function Example-Footnote-1625826
-Node: Function Calling625848
-Node: Calling A Function626436
-Node: Variable Scope627394
-Node: Pass By Value/Reference630388
-Node: Function Caveats633032
-Ref: Function Caveats-Footnote-1635079
-Node: Return Statement635199
-Node: Dynamic Typing638178
-Node: Indirect Calls639108
-Ref: Indirect Calls-Footnote-1649363
-Node: Functions Summary649491
-Node: Library Functions652196
-Ref: Library Functions-Footnote-1655803
-Ref: Library Functions-Footnote-2655946
-Node: Library Names656117
-Ref: Library Names-Footnote-1659784
-Ref: Library Names-Footnote-2660007
-Node: General Functions660093
-Node: Strtonum Function661275
-Node: Assert Function664297
-Node: Round Function667623
-Node: Cliff Random Function669163
-Node: Ordinal Functions670179
-Ref: Ordinal Functions-Footnote-1673242
-Ref: Ordinal Functions-Footnote-2673494
-Node: Join Function673704
-Ref: Join Function-Footnote-1675474
-Node: Getlocaltime Function675674
-Node: Readfile Function679416
-Node: Shell Quoting681393
-Node: Isnumeric Function682821
-Node: Data File Management684209
-Node: Filetrans Function684841
-Node: Rewind Function688937
-Node: File Checking690846
-Ref: File Checking-Footnote-1692180
-Node: Empty Files692381
-Node: Ignoring Assigns694360
-Node: Getopt Function695910
-Ref: Getopt Function-Footnote-1711133
-Node: Passwd Functions711333
-Ref: Passwd Functions-Footnote-1720172
-Node: Group Functions720260
-Ref: Group Functions-Footnote-1728158
-Node: Walking Arrays728365
-Node: Library Functions Summary731373
-Node: Library Exercises732779
-Node: Sample Programs733244
-Node: Running Examples734014
-Node: Clones734742
-Node: Cut Program735966
-Node: Egrep Program746106
-Node: Id Program755107
-Node: Split Program765054
-Ref: Split Program-Footnote-1774947
-Node: Tee Program775120
-Node: Uniq Program777910
-Node: Wc Program785498
-Node: Bytes vs. Characters785885
-Node: Using extensions787433
-Node: wc program788187
-Node: Miscellaneous Programs793052
-Node: Dupword Program794265
-Node: Alarm Program796295
-Node: Translate Program801150
-Ref: Translate Program-Footnote-1805715
-Node: Labels Program805985
-Ref: Labels Program-Footnote-1809336
-Node: Word Sorting809420
-Node: History Sorting813492
-Node: Extract Program815717
-Node: Simple Sed823771
-Node: Igawk Program826845
-Ref: Igawk Program-Footnote-1841176
-Ref: Igawk Program-Footnote-2841378
-Ref: Igawk Program-Footnote-3841500
-Node: Anagram Program841615
-Node: Signature Program844677
-Node: Programs Summary845924
-Node: Programs Exercises847138
-Ref: Programs Exercises-Footnote-1851268
-Node: Advanced Features851354
-Node: Nondecimal Data853485
-Node: Boolean Typed Values855083
-Node: Array Sorting856964
-Node: Controlling Array Traversal857669
-Ref: Controlling Array Traversal-Footnote-1866037
-Node: Array Sorting Functions866155
-Ref: Array Sorting Functions-Footnote-1871529
-Node: Two-way I/O871725
-Ref: Two-way I/O-Footnote-1879451
-Ref: Two-way I/O-Footnote-2879638
-Node: TCP/IP Networking879720
-Node: Profiling882838
-Node: Extension Philosophy892147
-Node: Advanced Features Summary893626
-Node: Internationalization895641
-Node: I18N and L10N897315
-Node: Explaining gettext898002
-Ref: Explaining gettext-Footnote-1903894
-Ref: Explaining gettext-Footnote-2904079
-Node: Programmer i18n904244
-Ref: Programmer i18n-Footnote-1909193
-Node: Translator i18n909242
-Node: String Extraction910036
-Ref: String Extraction-Footnote-1911168
-Node: Printf Ordering911254
-Ref: Printf Ordering-Footnote-1914040
-Node: I18N Portability914104
-Ref: I18N Portability-Footnote-1916560
-Node: I18N Example916623
-Ref: I18N Example-Footnote-1919898
-Ref: I18N Example-Footnote-2919971
-Node: Gawk I18N920080
-Node: I18N Summary920729
-Node: Debugger922070
-Node: Debugging923070
-Node: Debugging Concepts923511
-Node: Debugging Terms925320
-Node: Awk Debugging927895
-Ref: Awk Debugging-Footnote-1928840
-Node: Sample Debugging Session928972
-Node: Debugger Invocation929506
-Node: Finding The Bug930892
-Node: List of Debugger Commands937366
-Node: Breakpoint Control938699
-Node: Debugger Execution Control942393
-Node: Viewing And Changing Data945755
-Node: Execution Stack949296
-Node: Debugger Info950933
-Node: Miscellaneous Debugger Commands955004
-Node: Readline Support960066
-Node: Limitations960962
-Node: Debugging Summary963516
-Node: Namespaces964795
-Node: Global Namespace965906
-Node: Qualified Names967304
-Node: Default Namespace968303
-Node: Changing The Namespace969044
-Node: Naming Rules970658
-Node: Internal Name Management972506
-Node: Namespace Example973548
-Node: Namespace And Features976110
-Node: Namespace Summary977545
-Node: Arbitrary Precision Arithmetic979022
-Node: Computer Arithmetic980509
-Ref: table-numeric-ranges984275
-Ref: table-floating-point-ranges984768
-Ref: Computer Arithmetic-Footnote-1985426
-Node: Math Definitions985483
-Ref: table-ieee-formats988459
-Node: MPFR features989026
-Node: FP Math Caution990744
-Ref: FP Math Caution-Footnote-1991816
-Node: Inexactness of computations992185
-Node: Inexact representation993216
-Node: Comparing FP Values994576
-Node: Errors accumulate995817
-Node: Strange values997273
-Ref: Strange values-Footnote-1999861
-Node: Getting Accuracy999966
-Node: Try To Round1002676
-Node: Setting precision1003575
-Ref: table-predefined-precision-strings1004272
-Node: Setting the rounding mode1006102
-Ref: table-gawk-rounding-modes1006476
-Ref: Setting the rounding mode-Footnote-11010407
-Node: Arbitrary Precision Integers1010586
-Ref: Arbitrary Precision Integers-Footnote-11013761
-Node: Checking for MPFR1013910
-Node: POSIX Floating Point Problems1015384
-Ref: POSIX Floating Point Problems-Footnote-11019669
-Node: Floating point summary1019707
-Node: Dynamic Extensions1021897
-Node: Extension Intro1023450
-Node: Plugin License1024716
-Node: Extension Mechanism Outline1025513
-Ref: figure-load-extension1025952
-Ref: figure-register-new-function1027517
-Ref: figure-call-new-function1028609
-Node: Extension API Description1030671
-Node: Extension API Functions Introduction1032384
-Ref: table-api-std-headers1034220
-Node: General Data Types1038469
-Ref: General Data Types-Footnote-11047175
-Node: Memory Allocation Functions1047474
-Ref: Memory Allocation Functions-Footnote-11051975
-Node: Constructor Functions1052074
-Node: API Ownership of MPFR and GMP Values1055727
-Node: Registration Functions1057040
-Node: Extension Functions1057740
-Node: Exit Callback Functions1063062
-Node: Extension Version String1064312
-Node: Input Parsers1064975
-Node: Output Wrappers1077696
-Node: Two-way processors1082208
-Node: Printing Messages1084473
-Ref: Printing Messages-Footnote-11085644
-Node: Updating ERRNO1085797
-Node: Requesting Values1086536
-Ref: table-value-types-returned1087273
-Node: Accessing Parameters1088381
-Node: Symbol Table Access1089618
-Node: Symbol table by name1090130
-Ref: Symbol table by name-Footnote-11093154
-Node: Symbol table by cookie1093282
-Ref: Symbol table by cookie-Footnote-11097467
-Node: Cached values1097531
-Ref: Cached values-Footnote-11101067
-Node: Array Manipulation1101220
-Ref: Array Manipulation-Footnote-11102311
-Node: Array Data Types1102348
-Ref: Array Data Types-Footnote-11105006
-Node: Array Functions1105098
-Node: Flattening Arrays1109596
-Node: Creating Arrays1116572
-Node: Redirection API1121339
-Node: Extension API Variables1124172
-Node: Extension Versioning1124883
-Ref: gawk-api-version1125312
-Node: Extension GMP/MPFR Versioning1127043
-Node: Extension API Informational Variables1128671
-Node: Extension API Boilerplate1129744
-Node: Changes from API V11133718
-Node: Finding Extensions1135290
-Node: Extension Example1135849
-Node: Internal File Description1136647
-Node: Internal File Ops1140727
-Ref: Internal File Ops-Footnote-11152077
-Node: Using Internal File Ops1152217
-Ref: Using Internal File Ops-Footnote-11154600
-Node: Extension Samples1154874
-Node: Extension Sample File Functions1156403
-Node: Extension Sample Fnmatch1164052
-Node: Extension Sample Fork1165539
-Node: Extension Sample Inplace1166757
-Node: Extension Sample Ord1170383
-Node: Extension Sample Readdir1171219
-Ref: table-readdir-file-types1172108
-Node: Extension Sample Revout1173175
-Node: Extension Sample Rev2way1173764
-Node: Extension Sample Read write array1174504
-Node: Extension Sample Readfile1176446
-Node: Extension Sample Time1177541
-Node: Extension Sample API Tests1179293
-Node: gawkextlib1179785
-Node: Extension summary1182703
-Node: Extension Exercises1186405
-Node: Language History1187647
-Node: V7/SVR3.11189303
-Node: SVR41191455
-Node: POSIX1192889
-Node: BTL1194270
-Node: POSIX/GNU1194999
-Node: Feature History1200777
-Node: Common Extensions1217952
-Node: Ranges and Locales1219235
-Ref: Ranges and Locales-Footnote-11223851
-Ref: Ranges and Locales-Footnote-21223878
-Ref: Ranges and Locales-Footnote-31224113
-Node: Contributors1224336
-Node: History summary1230333
-Node: Installation1231713
-Node: Gawk Distribution1232657
-Node: Getting1233141
-Node: Extracting1234104
-Node: Distribution contents1235742
-Node: Unix Installation1242222
-Node: Quick Installation1243026
-Node: Compiling with MPFR1245502
-Node: Shell Startup Files1246194
-Node: Additional Configuration Options1247283
-Node: Configuration Philosophy1249598
-Node: Compiling from Git1251994
-Node: Building the Documentation1252549
-Node: Non-Unix Installation1253471
-Node: PC Installation1253931
-Node: PC Binary Installation1254769
-Node: PC Compiling1255204
-Node: PC Using1256321
-Node: Cygwin1259874
-Node: MSYS1261098
-Node: VMS Installation1261700
-Node: VMS Compilation1262419
-Ref: VMS Compilation-Footnote-11263648
-Node: VMS Dynamic Extensions1263706
-Node: VMS Installation Details1265391
-Node: VMS Running1267653
-Node: VMS GNV1271932
-Node: Bugs1272646
-Node: Bug definition1273558
-Node: Bug address1276062
-Node: Usenet1279450
-Node: Performance bugs1280459
-Node: Asking for help1283380
-Node: Maintainers1285342
-Node: Other Versions1286536
-Node: Installation summary1294388
-Node: Notes1295752
-Node: Compatibility Mode1296546
-Node: Additions1297328
-Node: Accessing The Source1298253
-Node: Adding Code1299690
-Node: New Ports1305909
-Node: Derived Files1310284
-Ref: Derived Files-Footnote-11315944
-Ref: Derived Files-Footnote-21315979
-Ref: Derived Files-Footnote-31316577
-Node: Future Extensions1316691
-Node: Implementation Limitations1317349
-Node: Extension Design1318559
-Node: Old Extension Problems1319703
-Ref: Old Extension Problems-Footnote-11321221
-Node: Extension New Mechanism Goals1321278
-Ref: Extension New Mechanism Goals-Footnote-11324642
-Node: Extension Other Design Decisions1324831
-Node: Extension Future Growth1326944
-Node: Notes summary1327550
-Node: Basic Concepts1328708
-Node: Basic High Level1329389
-Ref: figure-general-flow1329671
-Ref: figure-process-flow1330356
-Ref: Basic High Level-Footnote-11333657
-Node: Basic Data Typing1333842
-Node: Glossary1337170
-Node: Copying1369057
-Node: GNU Free Documentation License1406600
-Node: Index1431720
+Node: Variables360967
+Node: Using Variables361624
+Node: Assignment Options363534
+Node: Conversion366005
+Node: Strings And Numbers366529
+Ref: Strings And Numbers-Footnote-1369592
+Node: Locale influences conversions369701
+Ref: table-locale-affects372459
+Node: All Operators373077
+Node: Arithmetic Ops373706
+Node: Concatenation376422
+Ref: Concatenation-Footnote-1379269
+Node: Assignment Ops379376
+Ref: table-assign-ops384367
+Node: Increment Ops385680
+Node: Truth Values and Conditions389140
+Node: Truth Values390214
+Node: Typing and Comparison391262
+Node: Variable Typing392082
+Ref: Variable Typing-Footnote-1398545
+Ref: Variable Typing-Footnote-2398617
+Node: Comparison Operators398694
+Ref: table-relational-ops399113
+Node: POSIX String Comparison402608
+Ref: POSIX String Comparison-Footnote-1404303
+Ref: POSIX String Comparison-Footnote-2404442
+Node: Boolean Ops404526
+Ref: Boolean Ops-Footnote-1409008
+Node: Conditional Exp409100
+Node: Function Calls410836
+Node: Precedence414713
+Node: Locales418372
+Node: Expressions Summary420004
+Node: Patterns and Actions422577
+Node: Pattern Overview423697
+Node: Regexp Patterns425374
+Node: Expression Patterns425916
+Node: Ranges429697
+Node: BEGIN/END432805
+Node: Using BEGIN/END433566
+Ref: Using BEGIN/END-Footnote-1436320
+Node: I/O And BEGIN/END436426
+Node: BEGINFILE/ENDFILE438739
+Node: Empty441970
+Node: Using Shell Variables442287
+Node: Action Overview444561
+Node: Statements446886
+Node: If Statement448734
+Node: While Statement450229
+Node: Do Statement452257
+Node: For Statement453405
+Node: Switch Statement456576
+Node: Break Statement459017
+Node: Continue Statement461109
+Node: Next Statement462936
+Node: Nextfile Statement465319
+Node: Exit Statement468008
+Node: Built-in Variables470411
+Node: User-modified471544
+Node: Auto-set479311
+Ref: Auto-set-Footnote-1496118
+Ref: Auto-set-Footnote-2496324
+Node: ARGC and ARGV496380
+Node: Pattern Action Summary500593
+Node: Arrays503023
+Node: Array Basics504352
+Node: Array Intro505196
+Ref: figure-array-elements507171
+Ref: Array Intro-Footnote-1509875
+Node: Reference to Elements510003
+Node: Assigning Elements512467
+Node: Array Example512958
+Node: Scanning an Array514717
+Node: Controlling Scanning517739
+Ref: Controlling Scanning-Footnote-1524195
+Node: Numeric Array Subscripts524511
+Node: Uninitialized Subscripts526695
+Node: Delete528314
+Ref: Delete-Footnote-1531066
+Node: Multidimensional531123
+Node: Multiscanning534218
+Node: Arrays of Arrays535809
+Node: Arrays Summary540577
+Node: Functions542670
+Node: Built-in543708
+Node: Calling Built-in544861
+Node: Boolean Functions546857
+Node: Numeric Functions547411
+Ref: Numeric Functions-Footnote-1551438
+Ref: Numeric Functions-Footnote-2552086
+Ref: Numeric Functions-Footnote-3552134
+Node: String Functions552406
+Ref: String Functions-Footnote-1576921
+Ref: String Functions-Footnote-2577049
+Ref: String Functions-Footnote-3577297
+Node: Gory Details577384
+Ref: table-sub-escapes579175
+Ref: table-sub-proposed580694
+Ref: table-posix-sub582057
+Ref: table-gensub-escapes583598
+Ref: Gory Details-Footnote-1584421
+Node: I/O Functions584575
+Ref: table-system-return-values591029
+Ref: I/O Functions-Footnote-1593109
+Ref: I/O Functions-Footnote-2593257
+Node: Time Functions593377
+Ref: Time Functions-Footnote-1604048
+Ref: Time Functions-Footnote-2604116
+Ref: Time Functions-Footnote-3604274
+Ref: Time Functions-Footnote-4604385
+Ref: Time Functions-Footnote-5604497
+Ref: Time Functions-Footnote-6604724
+Node: Bitwise Functions604990
+Ref: table-bitwise-ops605584
+Ref: Bitwise Functions-Footnote-1611647
+Ref: Bitwise Functions-Footnote-2611820
+Node: Type Functions612011
+Node: I18N Functions614965
+Node: User-defined616616
+Node: Definition Syntax617428
+Ref: Definition Syntax-Footnote-1623122
+Node: Function Example623193
+Ref: Function Example-Footnote-1626115
+Node: Function Calling626137
+Node: Calling A Function626725
+Node: Variable Scope627683
+Node: Pass By Value/Reference630677
+Node: Function Caveats633321
+Ref: Function Caveats-Footnote-1635368
+Node: Return Statement635488
+Node: Dynamic Typing638467
+Node: Indirect Calls639397
+Ref: Indirect Calls-Footnote-1649652
+Node: Functions Summary649780
+Node: Library Functions652485
+Ref: Library Functions-Footnote-1656092
+Ref: Library Functions-Footnote-2656235
+Node: Library Names656406
+Ref: Library Names-Footnote-1660073
+Ref: Library Names-Footnote-2660296
+Node: General Functions660382
+Node: Strtonum Function661564
+Node: Assert Function664586
+Node: Round Function667912
+Node: Cliff Random Function669452
+Node: Ordinal Functions670468
+Ref: Ordinal Functions-Footnote-1673531
+Ref: Ordinal Functions-Footnote-2673783
+Node: Join Function673993
+Ref: Join Function-Footnote-1675763
+Node: Getlocaltime Function675963
+Node: Readfile Function679705
+Node: Shell Quoting681682
+Node: Isnumeric Function683110
+Node: Data File Management684498
+Node: Filetrans Function685130
+Node: Rewind Function689226
+Node: File Checking691135
+Ref: File Checking-Footnote-1692469
+Node: Empty Files692670
+Node: Ignoring Assigns694649
+Node: Getopt Function696199
+Ref: Getopt Function-Footnote-1711422
+Node: Passwd Functions711622
+Ref: Passwd Functions-Footnote-1720461
+Node: Group Functions720549
+Ref: Group Functions-Footnote-1728447
+Node: Walking Arrays728654
+Node: Library Functions Summary731662
+Node: Library Exercises733068
+Node: Sample Programs733533
+Node: Running Examples734303
+Node: Clones735031
+Node: Cut Program736255
+Node: Egrep Program746395
+Node: Id Program755396
+Node: Split Program765343
+Ref: Split Program-Footnote-1775236
+Node: Tee Program775409
+Node: Uniq Program778199
+Node: Wc Program785787
+Node: Bytes vs. Characters786174
+Node: Using extensions787722
+Node: wc program788476
+Node: Miscellaneous Programs793341
+Node: Dupword Program794554
+Node: Alarm Program796584
+Node: Translate Program801439
+Ref: Translate Program-Footnote-1806004
+Node: Labels Program806274
+Ref: Labels Program-Footnote-1809625
+Node: Word Sorting809709
+Node: History Sorting813781
+Node: Extract Program816006
+Node: Simple Sed824060
+Node: Igawk Program827134
+Ref: Igawk Program-Footnote-1841465
+Ref: Igawk Program-Footnote-2841667
+Ref: Igawk Program-Footnote-3841789
+Node: Anagram Program841904
+Node: Signature Program844966
+Node: Programs Summary846213
+Node: Programs Exercises847427
+Ref: Programs Exercises-Footnote-1851557
+Node: Advanced Features851643
+Node: Nondecimal Data853774
+Node: Boolean Typed Values855372
+Node: Array Sorting857253
+Node: Controlling Array Traversal857958
+Ref: Controlling Array Traversal-Footnote-1866326
+Node: Array Sorting Functions866444
+Ref: Array Sorting Functions-Footnote-1871818
+Node: Two-way I/O872014
+Ref: Two-way I/O-Footnote-1879740
+Ref: Two-way I/O-Footnote-2879927
+Node: TCP/IP Networking880009
+Node: Profiling883127
+Node: Extension Philosophy892436
+Node: Advanced Features Summary893915
+Node: Internationalization895930
+Node: I18N and L10N897604
+Node: Explaining gettext898291
+Ref: Explaining gettext-Footnote-1904183
+Ref: Explaining gettext-Footnote-2904368
+Node: Programmer i18n904533
+Ref: Programmer i18n-Footnote-1909482
+Node: Translator i18n909531
+Node: String Extraction910325
+Ref: String Extraction-Footnote-1911457
+Node: Printf Ordering911543
+Ref: Printf Ordering-Footnote-1914329
+Node: I18N Portability914393
+Ref: I18N Portability-Footnote-1916849
+Node: I18N Example916912
+Ref: I18N Example-Footnote-1920187
+Ref: I18N Example-Footnote-2920260
+Node: Gawk I18N920369
+Node: I18N Summary921018
+Node: Debugger922359
+Node: Debugging923359
+Node: Debugging Concepts923800
+Node: Debugging Terms925609
+Node: Awk Debugging928184
+Ref: Awk Debugging-Footnote-1929129
+Node: Sample Debugging Session929261
+Node: Debugger Invocation929795
+Node: Finding The Bug931181
+Node: List of Debugger Commands937655
+Node: Breakpoint Control938988
+Node: Debugger Execution Control942682
+Node: Viewing And Changing Data946044
+Node: Execution Stack949585
+Node: Debugger Info951222
+Node: Miscellaneous Debugger Commands955293
+Node: Readline Support960355
+Node: Limitations961251
+Node: Debugging Summary963805
+Node: Namespaces965084
+Node: Global Namespace966195
+Node: Qualified Names967593
+Node: Default Namespace968592
+Node: Changing The Namespace969333
+Node: Naming Rules970947
+Node: Internal Name Management972795
+Node: Namespace Example973837
+Node: Namespace And Features976399
+Node: Namespace Summary977834
+Node: Arbitrary Precision Arithmetic979311
+Node: Computer Arithmetic980798
+Ref: table-numeric-ranges984564
+Ref: table-floating-point-ranges985057
+Ref: Computer Arithmetic-Footnote-1985715
+Node: Math Definitions985772
+Ref: table-ieee-formats988748
+Node: MPFR features989315
+Node: FP Math Caution991033
+Ref: FP Math Caution-Footnote-1992105
+Node: Inexactness of computations992474
+Node: Inexact representation993505
+Node: Comparing FP Values994865
+Node: Errors accumulate996106
+Node: Strange values997562
+Ref: Strange values-Footnote-11000150
+Node: Getting Accuracy1000255
+Node: Try To Round1002965
+Node: Setting precision1003864
+Ref: table-predefined-precision-strings1004561
+Node: Setting the rounding mode1006391
+Ref: table-gawk-rounding-modes1006765
+Ref: Setting the rounding mode-Footnote-11010696
+Node: Arbitrary Precision Integers1010875
+Ref: Arbitrary Precision Integers-Footnote-11014050
+Node: Checking for MPFR1014199
+Node: POSIX Floating Point Problems1015673
+Ref: POSIX Floating Point Problems-Footnote-11019958
+Node: Floating point summary1019996
+Node: Dynamic Extensions1022186
+Node: Extension Intro1023739
+Node: Plugin License1025005
+Node: Extension Mechanism Outline1025802
+Ref: figure-load-extension1026241
+Ref: figure-register-new-function1027806
+Ref: figure-call-new-function1028898
+Node: Extension API Description1030960
+Node: Extension API Functions Introduction1032673
+Ref: table-api-std-headers1034509
+Node: General Data Types1038758
+Ref: General Data Types-Footnote-11047464
+Node: Memory Allocation Functions1047763
+Ref: Memory Allocation Functions-Footnote-11052264
+Node: Constructor Functions1052363
+Node: API Ownership of MPFR and GMP Values1056016
+Node: Registration Functions1057329
+Node: Extension Functions1058029
+Node: Exit Callback Functions1063351
+Node: Extension Version String1064601
+Node: Input Parsers1065264
+Node: Output Wrappers1077985
+Node: Two-way processors1082497
+Node: Printing Messages1084762
+Ref: Printing Messages-Footnote-11085933
+Node: Updating ERRNO1086086
+Node: Requesting Values1086825
+Ref: table-value-types-returned1087562
+Node: Accessing Parameters1088670
+Node: Symbol Table Access1089907
+Node: Symbol table by name1090419
+Ref: Symbol table by name-Footnote-11093443
+Node: Symbol table by cookie1093571
+Ref: Symbol table by cookie-Footnote-11097756
+Node: Cached values1097820
+Ref: Cached values-Footnote-11101356
+Node: Array Manipulation1101509
+Ref: Array Manipulation-Footnote-11102600
+Node: Array Data Types1102637
+Ref: Array Data Types-Footnote-11105295
+Node: Array Functions1105387
+Node: Flattening Arrays1109885
+Node: Creating Arrays1116861
+Node: Redirection API1121628
+Node: Extension API Variables1124461
+Node: Extension Versioning1125172
+Ref: gawk-api-version1125601
+Node: Extension GMP/MPFR Versioning1127332
+Node: Extension API Informational Variables1128960
+Node: Extension API Boilerplate1130033
+Node: Changes from API V11134007
+Node: Finding Extensions1135579
+Node: Extension Example1136138
+Node: Internal File Description1136936
+Node: Internal File Ops1141016
+Ref: Internal File Ops-Footnote-11152366
+Node: Using Internal File Ops1152506
+Ref: Using Internal File Ops-Footnote-11154889
+Node: Extension Samples1155163
+Node: Extension Sample File Functions1156692
+Node: Extension Sample Fnmatch1164341
+Node: Extension Sample Fork1165828
+Node: Extension Sample Inplace1167046
+Node: Extension Sample Ord1170672
+Node: Extension Sample Readdir1171508
+Ref: table-readdir-file-types1172397
+Node: Extension Sample Revout1173464
+Node: Extension Sample Rev2way1174053
+Node: Extension Sample Read write array1174793
+Node: Extension Sample Readfile1176735
+Node: Extension Sample Time1177830
+Node: Extension Sample API Tests1179582
+Node: gawkextlib1180074
+Node: Extension summary1182992
+Node: Extension Exercises1186694
+Node: Language History1187936
+Node: V7/SVR3.11189592
+Node: SVR41191744
+Node: POSIX1193178
+Node: BTL1194559
+Node: POSIX/GNU1195288
+Node: Feature History1201066
+Node: Common Extensions1218241
+Node: Ranges and Locales1219524
+Ref: Ranges and Locales-Footnote-11224140
+Ref: Ranges and Locales-Footnote-21224167
+Ref: Ranges and Locales-Footnote-31224402
+Node: Contributors1224625
+Node: History summary1230622
+Node: Installation1232002
+Node: Gawk Distribution1232946
+Node: Getting1233430
+Node: Extracting1234393
+Node: Distribution contents1236031
+Node: Unix Installation1242511
+Node: Quick Installation1243315
+Node: Compiling with MPFR1245791
+Node: Shell Startup Files1246483
+Node: Additional Configuration Options1247572
+Node: Configuration Philosophy1249887
+Node: Compiling from Git1252283
+Node: Building the Documentation1252838
+Node: Non-Unix Installation1253760
+Node: PC Installation1254220
+Node: PC Binary Installation1255058
+Node: PC Compiling1255493
+Node: PC Using1256610
+Node: Cygwin1260163
+Node: MSYS1261387
+Node: VMS Installation1261989
+Node: VMS Compilation1262708
+Ref: VMS Compilation-Footnote-11263937
+Node: VMS Dynamic Extensions1263995
+Node: VMS Installation Details1265680
+Node: VMS Running1267942
+Node: VMS GNV1272221
+Node: Bugs1272935
+Node: Bug definition1273847
+Node: Bug address1276351
+Node: Usenet1279739
+Node: Performance bugs1280748
+Node: Asking for help1283669
+Node: Maintainers1285631
+Node: Other Versions1286825
+Node: Installation summary1294677
+Node: Notes1296041
+Node: Compatibility Mode1296835
+Node: Additions1297617
+Node: Accessing The Source1298542
+Node: Adding Code1299979
+Node: New Ports1306198
+Node: Derived Files1310573
+Ref: Derived Files-Footnote-11316233
+Ref: Derived Files-Footnote-21316268
+Ref: Derived Files-Footnote-31316866
+Node: Future Extensions1316980
+Node: Implementation Limitations1317638
+Node: Extension Design1318848
+Node: Old Extension Problems1319992
+Ref: Old Extension Problems-Footnote-11321510
+Node: Extension New Mechanism Goals1321567
+Ref: Extension New Mechanism Goals-Footnote-11324931
+Node: Extension Other Design Decisions1325120
+Node: Extension Future Growth1327233
+Node: Notes summary1327839
+Node: Basic Concepts1328997
+Node: Basic High Level1329678
+Ref: figure-general-flow1329960
+Ref: figure-process-flow1330645
+Ref: Basic High Level-Footnote-11333946
+Node: Basic Data Typing1334131
+Node: Glossary1337459
+Node: Copying1369346
+Node: GNU Free Documentation License1406889
+Node: Index1432009
 
 End Tag Table
 
diff --git a/doc/gawk.texi b/doc/gawk.texi
index c877c925..1bde9543 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -12005,6 +12005,17 @@ can be used with @samp{~} and @samp{!~}, passed to one of the built-in functions
 listed above, or passed as a parameter to a user-defined function.
 @end itemize
 
+You may use the @option{-v} option (@pxref{Options}) to assign a
+strongly-typed regexp constant to a variable on the command line, like so:
+
+@example
+gawk -v pattern='@@/something(interesting)+/' @dots{}
+@end example
+
+@noindent
+You may also make such assignments as regular command-line arguments
+(@pxref{Other Arguments}).
+
 You may use the @code{typeof()} built-in function
 (@pxref{Type Functions})
 to determine if a variable or function parameter is
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index cafc5d68..58aba431 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -11331,6 +11331,17 @@ can be used with @samp{~} and @samp{!~}, passed to one of the built-in functions
 listed above, or passed as a parameter to a user-defined function.
 @end itemize
 
+You may use the @option{-v} option (@pxref{Options}) to assign a
+strongly-typed regexp constant to a variable on the command line, like so:
+
+@example
+gawk -v pattern='@@/something(interesting)+/' @dots{}
+@end example
+
+@noindent
+You may also make such assignments as regular command-line arguments
+(@pxref{Other Arguments}).
+
 You may use the @code{typeof()} built-in function
 (@pxref{Type Functions})
 to determine if a variable or function parameter is