[SCM] gawk branch, gawk-5.1-stable, updated. gawk-4.1.0-4310-g09fa9d2

[Arnold Robbins]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".

The branch, gawk-5.1-stable has been updated
       via  09fa9d26d41cc70e63469522d71674883bae5521 (commit)
      from  0304433c77311b42727485bf187d80665b0eb34c (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=09fa9d26d41cc70e63469522d71674883bae5521

commit 09fa9d26d41cc70e63469522d71674883bae5521
Author: Arnold D. Robbins <arnold@skeeve.com>
Date:   Thu Sep 23 12:42:32 2021 +0300

    Documentation updates.

diff --git a/NEWS b/NEWS
index d3681b6..5563f1e 100644
--- a/NEWS
+++ b/NEWS
@@ -54,10 +54,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 d92ebbd..8d15d5a 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 7485675..8aa0d9c 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -8264,6 +8264,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.
 
@@ -38601,454 +38610,454 @@ Node: Regexp Constants352518
 Node: Using Constant Regexps353044
 Node: Standard Regexp Constants353666
 Node: Strong Regexp Constants356854
-Node: Variables360278
-Node: Using Variables360935
-Node: Assignment Options362845
-Node: Conversion365316
-Node: Strings And Numbers365840
-Ref: Strings And Numbers-Footnote-1368903
-Node: Locale influences conversions369012
-Ref: table-locale-affects371770
-Node: All Operators372388
-Node: Arithmetic Ops373017
-Node: Concatenation375733
-Ref: Concatenation-Footnote-1378580
-Node: Assignment Ops378687
-Ref: table-assign-ops383678
-Node: Increment Ops384991
-Node: Truth Values and Conditions388451
-Node: Truth Values389525
-Node: Typing and Comparison390573
-Node: Variable Typing391393
-Ref: Variable Typing-Footnote-1397856
-Ref: Variable Typing-Footnote-2397928
-Node: Comparison Operators398005
-Ref: table-relational-ops398424
-Node: POSIX String Comparison401919
-Ref: POSIX String Comparison-Footnote-1403614
-Ref: POSIX String Comparison-Footnote-2403753
-Node: Boolean Ops403837
-Ref: Boolean Ops-Footnote-1408319
-Node: Conditional Exp408411
-Node: Function Calls410147
-Node: Precedence414024
-Node: Locales417683
-Node: Expressions Summary419315
-Node: Patterns and Actions421888
-Node: Pattern Overview423008
-Node: Regexp Patterns424685
-Node: Expression Patterns425227
-Node: Ranges429008
-Node: BEGIN/END432116
-Node: Using BEGIN/END432877
-Ref: Using BEGIN/END-Footnote-1435631
-Node: I/O And BEGIN/END435737
-Node: BEGINFILE/ENDFILE438050
-Node: Empty441281
-Node: Using Shell Variables441598
-Node: Action Overview443872
-Node: Statements446197
-Node: If Statement448045
-Node: While Statement449540
-Node: Do Statement451568
-Node: For Statement452716
-Node: Switch Statement455887
-Node: Break Statement458328
-Node: Continue Statement460420
-Node: Next Statement462247
-Node: Nextfile Statement464630
-Node: Exit Statement467319
-Node: Built-in Variables469722
-Node: User-modified470855
-Node: Auto-set478622
-Ref: Auto-set-Footnote-1495429
-Ref: Auto-set-Footnote-2495635
-Node: ARGC and ARGV495691
-Node: Pattern Action Summary499904
-Node: Arrays502334
-Node: Array Basics503663
-Node: Array Intro504507
-Ref: figure-array-elements506482
-Ref: Array Intro-Footnote-1509186
-Node: Reference to Elements509314
-Node: Assigning Elements511778
-Node: Array Example512269
-Node: Scanning an Array514028
-Node: Controlling Scanning517050
-Ref: Controlling Scanning-Footnote-1523506
-Node: Numeric Array Subscripts523822
-Node: Uninitialized Subscripts526006
-Node: Delete527625
-Ref: Delete-Footnote-1530377
-Node: Multidimensional530434
-Node: Multiscanning533529
-Node: Arrays of Arrays535120
-Node: Arrays Summary539888
-Node: Functions541981
-Node: Built-in543019
-Node: Calling Built-in544100
-Node: Numeric Functions546096
-Ref: Numeric Functions-Footnote-1550124
-Ref: Numeric Functions-Footnote-2550772
-Ref: Numeric Functions-Footnote-3550820
-Node: String Functions551092
-Ref: String Functions-Footnote-1575607
-Ref: String Functions-Footnote-2575735
-Ref: String Functions-Footnote-3575983
-Node: Gory Details576070
-Ref: table-sub-escapes577861
-Ref: table-sub-proposed579380
-Ref: table-posix-sub580743
-Ref: table-gensub-escapes582284
-Ref: Gory Details-Footnote-1583107
-Node: I/O Functions583261
-Ref: table-system-return-values589715
-Ref: I/O Functions-Footnote-1591795
-Ref: I/O Functions-Footnote-2591943
-Node: Time Functions592063
-Ref: Time Functions-Footnote-1602734
-Ref: Time Functions-Footnote-2602802
-Ref: Time Functions-Footnote-3602960
-Ref: Time Functions-Footnote-4603071
-Ref: Time Functions-Footnote-5603183
-Ref: Time Functions-Footnote-6603410
-Node: Bitwise Functions603676
-Ref: table-bitwise-ops604270
-Ref: Bitwise Functions-Footnote-1610333
-Ref: Bitwise Functions-Footnote-2610506
-Node: Type Functions610697
-Node: I18N Functions613560
-Node: User-defined615211
-Node: Definition Syntax616023
-Ref: Definition Syntax-Footnote-1621717
-Node: Function Example621788
-Ref: Function Example-Footnote-1624710
-Node: Function Calling624732
-Node: Calling A Function625320
-Node: Variable Scope626278
-Node: Pass By Value/Reference629272
-Node: Function Caveats631916
-Ref: Function Caveats-Footnote-1633963
-Node: Return Statement634083
-Node: Dynamic Typing637062
-Node: Indirect Calls637992
-Ref: Indirect Calls-Footnote-1648244
-Node: Functions Summary648372
-Node: Library Functions651077
-Ref: Library Functions-Footnote-1654684
-Ref: Library Functions-Footnote-2654827
-Node: Library Names654998
-Ref: Library Names-Footnote-1658665
-Ref: Library Names-Footnote-2658888
-Node: General Functions658974
-Node: Strtonum Function660156
-Node: Assert Function663178
-Node: Round Function666504
-Node: Cliff Random Function668044
-Node: Ordinal Functions669060
-Ref: Ordinal Functions-Footnote-1672123
-Ref: Ordinal Functions-Footnote-2672375
-Node: Join Function672585
-Ref: Join Function-Footnote-1674355
-Node: Getlocaltime Function674555
-Node: Readfile Function678297
-Node: Shell Quoting680274
-Node: Isnumeric Function681702
-Node: Data File Management683090
-Node: Filetrans Function683722
-Node: Rewind Function687818
-Node: File Checking689727
-Ref: File Checking-Footnote-1691061
-Node: Empty Files691262
-Node: Ignoring Assigns693241
-Node: Getopt Function694791
-Ref: Getopt Function-Footnote-1710014
-Node: Passwd Functions710214
-Ref: Passwd Functions-Footnote-1719053
-Node: Group Functions719141
-Ref: Group Functions-Footnote-1727039
-Node: Walking Arrays727246
-Node: Library Functions Summary730254
-Node: Library Exercises731660
-Node: Sample Programs732125
-Node: Running Examples732895
-Node: Clones733623
-Node: Cut Program734847
-Node: Egrep Program744987
-Node: Id Program753988
-Node: Split Program763935
-Ref: Split Program-Footnote-1773828
-Node: Tee Program774001
-Node: Uniq Program776791
-Node: Wc Program784379
-Node: Bytes vs. Characters784766
-Node: Using extensions786314
-Node: wc program787068
-Node: Miscellaneous Programs791933
-Node: Dupword Program793146
-Node: Alarm Program795176
-Node: Translate Program800031
-Ref: Translate Program-Footnote-1804596
-Node: Labels Program804866
-Ref: Labels Program-Footnote-1808217
-Node: Word Sorting808301
-Node: History Sorting812373
-Node: Extract Program814598
-Node: Simple Sed822652
-Node: Igawk Program825726
-Ref: Igawk Program-Footnote-1840057
-Ref: Igawk Program-Footnote-2840259
-Ref: Igawk Program-Footnote-3840381
-Node: Anagram Program840496
-Node: Signature Program843558
-Node: Programs Summary844805
-Node: Programs Exercises846019
-Ref: Programs Exercises-Footnote-1850149
-Node: Advanced Features850235
-Node: Nondecimal Data852302
-Node: Array Sorting853893
-Node: Controlling Array Traversal854593
-Ref: Controlling Array Traversal-Footnote-1862961
-Node: Array Sorting Functions863079
-Ref: Array Sorting Functions-Footnote-1868453
-Node: Two-way I/O868649
-Ref: Two-way I/O-Footnote-1876375
-Ref: Two-way I/O-Footnote-2876562
-Node: TCP/IP Networking876644
-Node: Profiling879762
-Node: Extension Philosophy889071
-Node: Advanced Features Summary890550
-Node: Internationalization892565
-Node: I18N and L10N894239
-Node: Explaining gettext894926
-Ref: Explaining gettext-Footnote-1900818
-Ref: Explaining gettext-Footnote-2901003
-Node: Programmer i18n901168
-Ref: Programmer i18n-Footnote-1906117
-Node: Translator i18n906166
-Node: String Extraction906960
-Ref: String Extraction-Footnote-1908092
-Node: Printf Ordering908178
-Ref: Printf Ordering-Footnote-1910964
-Node: I18N Portability911028
-Ref: I18N Portability-Footnote-1913484
-Node: I18N Example913547
-Ref: I18N Example-Footnote-1916822
-Ref: I18N Example-Footnote-2916895
-Node: Gawk I18N917004
-Node: I18N Summary917653
-Node: Debugger918994
-Node: Debugging919994
-Node: Debugging Concepts920435
-Node: Debugging Terms922244
-Node: Awk Debugging924819
-Ref: Awk Debugging-Footnote-1925764
-Node: Sample Debugging Session925896
-Node: Debugger Invocation926430
-Node: Finding The Bug927816
-Node: List of Debugger Commands934290
-Node: Breakpoint Control935623
-Node: Debugger Execution Control939317
-Node: Viewing And Changing Data942679
-Node: Execution Stack946220
-Node: Debugger Info947857
-Node: Miscellaneous Debugger Commands951928
-Node: Readline Support956990
-Node: Limitations957886
-Node: Debugging Summary960440
-Node: Namespaces961719
-Node: Global Namespace962830
-Node: Qualified Names964228
-Node: Default Namespace965227
-Node: Changing The Namespace965968
-Node: Naming Rules967582
-Node: Internal Name Management969430
-Node: Namespace Example970472
-Node: Namespace And Features973034
-Node: Namespace Summary974469
-Node: Arbitrary Precision Arithmetic975946
-Node: Computer Arithmetic977433
-Ref: table-numeric-ranges981199
-Ref: table-floating-point-ranges981692
-Ref: Computer Arithmetic-Footnote-1982350
-Node: Math Definitions982407
-Ref: table-ieee-formats985723
-Ref: Math Definitions-Footnote-1986326
-Node: MPFR features986431
-Node: FP Math Caution988149
-Ref: FP Math Caution-Footnote-1989221
-Node: Inexactness of computations989590
-Node: Inexact representation990550
-Node: Comparing FP Values991910
-Node: Errors accumulate993151
-Node: Getting Accuracy994584
-Node: Try To Round997294
-Node: Setting precision998193
-Ref: table-predefined-precision-strings998890
-Node: Setting the rounding mode1000720
-Ref: table-gawk-rounding-modes1001094
-Ref: Setting the rounding mode-Footnote-11005025
-Node: Arbitrary Precision Integers1005204
-Ref: Arbitrary Precision Integers-Footnote-11008379
-Node: Checking for MPFR1008528
-Node: POSIX Floating Point Problems1010002
-Ref: POSIX Floating Point Problems-Footnote-11014287
-Node: Floating point summary1014325
-Node: Dynamic Extensions1016515
-Node: Extension Intro1018068
-Node: Plugin License1019334
-Node: Extension Mechanism Outline1020131
-Ref: figure-load-extension1020570
-Ref: figure-register-new-function1022135
-Ref: figure-call-new-function1023227
-Node: Extension API Description1025289
-Node: Extension API Functions Introduction1027002
-Ref: table-api-std-headers1028838
-Node: General Data Types1033087
-Ref: General Data Types-Footnote-11041717
-Node: Memory Allocation Functions1042016
-Ref: Memory Allocation Functions-Footnote-11046517
-Node: Constructor Functions1046616
-Node: API Ownership of MPFR and GMP Values1050082
-Node: Registration Functions1051395
-Node: Extension Functions1052095
-Node: Exit Callback Functions1057417
-Node: Extension Version String1058667
-Node: Input Parsers1059330
-Node: Output Wrappers1072051
-Node: Two-way processors1076563
-Node: Printing Messages1078828
-Ref: Printing Messages-Footnote-11079999
-Node: Updating ERRNO1080152
-Node: Requesting Values1080891
-Ref: table-value-types-returned1081628
-Node: Accessing Parameters1082564
-Node: Symbol Table Access1083801
-Node: Symbol table by name1084313
-Ref: Symbol table by name-Footnote-11087337
-Node: Symbol table by cookie1087465
-Ref: Symbol table by cookie-Footnote-11091650
-Node: Cached values1091714
-Ref: Cached values-Footnote-11095250
-Node: Array Manipulation1095403
-Ref: Array Manipulation-Footnote-11096494
-Node: Array Data Types1096531
-Ref: Array Data Types-Footnote-11099189
-Node: Array Functions1099281
-Node: Flattening Arrays1103779
-Node: Creating Arrays1110755
-Node: Redirection API1115522
-Node: Extension API Variables1118355
-Node: Extension Versioning1119066
-Ref: gawk-api-version1119495
-Node: Extension GMP/MPFR Versioning1121226
-Node: Extension API Informational Variables1122854
-Node: Extension API Boilerplate1123927
-Node: Changes from API V11127901
-Node: Finding Extensions1129473
-Node: Extension Example1130032
-Node: Internal File Description1130830
-Node: Internal File Ops1134910
-Ref: Internal File Ops-Footnote-11146260
-Node: Using Internal File Ops1146400
-Ref: Using Internal File Ops-Footnote-11148783
-Node: Extension Samples1149057
-Node: Extension Sample File Functions1150586
-Node: Extension Sample Fnmatch1158235
-Node: Extension Sample Fork1159722
-Node: Extension Sample Inplace1160940
-Node: Extension Sample Ord1164566
-Node: Extension Sample Readdir1165402
-Ref: table-readdir-file-types1166291
-Node: Extension Sample Revout1167358
-Node: Extension Sample Rev2way1167947
-Node: Extension Sample Read write array1168687
-Node: Extension Sample Readfile1170629
-Node: Extension Sample Time1171724
-Node: Extension Sample API Tests1173476
-Node: gawkextlib1173968
-Node: Extension summary1176886
-Node: Extension Exercises1180588
-Node: Language History1181830
-Node: V7/SVR3.11183486
-Node: SVR41185638
-Node: POSIX1187072
-Node: BTL1188453
-Node: POSIX/GNU1189182
-Node: Feature History1194960
-Node: Common Extensions1212135
-Node: Ranges and Locales1213418
-Ref: Ranges and Locales-Footnote-11218034
-Ref: Ranges and Locales-Footnote-21218061
-Ref: Ranges and Locales-Footnote-31218296
-Node: Contributors1218519
-Node: History summary1224516
-Node: Installation1225896
-Node: Gawk Distribution1226840
-Node: Getting1227324
-Node: Extracting1228287
-Node: Distribution contents1229925
-Node: Unix Installation1236405
-Node: Quick Installation1237209
-Node: Compiling with MPFR1239685
-Node: Shell Startup Files1240377
-Node: Additional Configuration Options1241466
-Node: Configuration Philosophy1243781
-Node: Compiling from Git1246177
-Node: Building the Documentation1246732
-Node: Non-Unix Installation1247654
-Node: PC Installation1248114
-Node: PC Binary Installation1248952
-Node: PC Compiling1249387
-Node: PC Using1250504
-Node: Cygwin1254057
-Node: MSYS1255281
-Node: VMS Installation1255883
-Node: VMS Compilation1256602
-Ref: VMS Compilation-Footnote-11257831
-Node: VMS Dynamic Extensions1257889
-Node: VMS Installation Details1259574
-Node: VMS Running1261836
-Node: VMS GNV1266115
-Node: Bugs1266829
-Node: Bug definition1267741
-Node: Bug address1270245
-Node: Usenet1273633
-Node: Performance bugs1274642
-Node: Asking for help1277563
-Node: Maintainers1279525
-Node: Other Versions1280719
-Node: Installation summary1288571
-Node: Notes1289935
-Node: Compatibility Mode1290729
-Node: Additions1291511
-Node: Accessing The Source1292436
-Node: Adding Code1293873
-Node: New Ports1300092
-Node: Derived Files1304467
-Ref: Derived Files-Footnote-11310127
-Ref: Derived Files-Footnote-21310162
-Ref: Derived Files-Footnote-31310760
-Node: Future Extensions1310874
-Node: Implementation Limitations1311532
-Node: Extension Design1312742
-Node: Old Extension Problems1313886
-Ref: Old Extension Problems-Footnote-11315404
-Node: Extension New Mechanism Goals1315461
-Ref: Extension New Mechanism Goals-Footnote-11318825
-Node: Extension Other Design Decisions1319014
-Node: Extension Future Growth1321127
-Node: Notes summary1321733
-Node: Basic Concepts1322891
-Node: Basic High Level1323572
-Ref: figure-general-flow1323854
-Ref: figure-process-flow1324539
-Ref: Basic High Level-Footnote-11327840
-Node: Basic Data Typing1328025
-Node: Glossary1331353
-Node: Copying1363238
-Node: GNU Free Documentation License1400781
-Node: Index1425901
+Node: Variables360567
+Node: Using Variables361224
+Node: Assignment Options363134
+Node: Conversion365605
+Node: Strings And Numbers366129
+Ref: Strings And Numbers-Footnote-1369192
+Node: Locale influences conversions369301
+Ref: table-locale-affects372059
+Node: All Operators372677
+Node: Arithmetic Ops373306
+Node: Concatenation376022
+Ref: Concatenation-Footnote-1378869
+Node: Assignment Ops378976
+Ref: table-assign-ops383967
+Node: Increment Ops385280
+Node: Truth Values and Conditions388740
+Node: Truth Values389814
+Node: Typing and Comparison390862
+Node: Variable Typing391682
+Ref: Variable Typing-Footnote-1398145
+Ref: Variable Typing-Footnote-2398217
+Node: Comparison Operators398294
+Ref: table-relational-ops398713
+Node: POSIX String Comparison402208
+Ref: POSIX String Comparison-Footnote-1403903
+Ref: POSIX String Comparison-Footnote-2404042
+Node: Boolean Ops404126
+Ref: Boolean Ops-Footnote-1408608
+Node: Conditional Exp408700
+Node: Function Calls410436
+Node: Precedence414313
+Node: Locales417972
+Node: Expressions Summary419604
+Node: Patterns and Actions422177
+Node: Pattern Overview423297
+Node: Regexp Patterns424974
+Node: Expression Patterns425516
+Node: Ranges429297
+Node: BEGIN/END432405
+Node: Using BEGIN/END433166
+Ref: Using BEGIN/END-Footnote-1435920
+Node: I/O And BEGIN/END436026
+Node: BEGINFILE/ENDFILE438339
+Node: Empty441570
+Node: Using Shell Variables441887
+Node: Action Overview444161
+Node: Statements446486
+Node: If Statement448334
+Node: While Statement449829
+Node: Do Statement451857
+Node: For Statement453005
+Node: Switch Statement456176
+Node: Break Statement458617
+Node: Continue Statement460709
+Node: Next Statement462536
+Node: Nextfile Statement464919
+Node: Exit Statement467608
+Node: Built-in Variables470011
+Node: User-modified471144
+Node: Auto-set478911
+Ref: Auto-set-Footnote-1495718
+Ref: Auto-set-Footnote-2495924
+Node: ARGC and ARGV495980
+Node: Pattern Action Summary500193
+Node: Arrays502623
+Node: Array Basics503952
+Node: Array Intro504796
+Ref: figure-array-elements506771
+Ref: Array Intro-Footnote-1509475
+Node: Reference to Elements509603
+Node: Assigning Elements512067
+Node: Array Example512558
+Node: Scanning an Array514317
+Node: Controlling Scanning517339
+Ref: Controlling Scanning-Footnote-1523795
+Node: Numeric Array Subscripts524111
+Node: Uninitialized Subscripts526295
+Node: Delete527914
+Ref: Delete-Footnote-1530666
+Node: Multidimensional530723
+Node: Multiscanning533818
+Node: Arrays of Arrays535409
+Node: Arrays Summary540177
+Node: Functions542270
+Node: Built-in543308
+Node: Calling Built-in544389
+Node: Numeric Functions546385
+Ref: Numeric Functions-Footnote-1550413
+Ref: Numeric Functions-Footnote-2551061
+Ref: Numeric Functions-Footnote-3551109
+Node: String Functions551381
+Ref: String Functions-Footnote-1575896
+Ref: String Functions-Footnote-2576024
+Ref: String Functions-Footnote-3576272
+Node: Gory Details576359
+Ref: table-sub-escapes578150
+Ref: table-sub-proposed579669
+Ref: table-posix-sub581032
+Ref: table-gensub-escapes582573
+Ref: Gory Details-Footnote-1583396
+Node: I/O Functions583550
+Ref: table-system-return-values590004
+Ref: I/O Functions-Footnote-1592084
+Ref: I/O Functions-Footnote-2592232
+Node: Time Functions592352
+Ref: Time Functions-Footnote-1603023
+Ref: Time Functions-Footnote-2603091
+Ref: Time Functions-Footnote-3603249
+Ref: Time Functions-Footnote-4603360
+Ref: Time Functions-Footnote-5603472
+Ref: Time Functions-Footnote-6603699
+Node: Bitwise Functions603965
+Ref: table-bitwise-ops604559
+Ref: Bitwise Functions-Footnote-1610622
+Ref: Bitwise Functions-Footnote-2610795
+Node: Type Functions610986
+Node: I18N Functions613849
+Node: User-defined615500
+Node: Definition Syntax616312
+Ref: Definition Syntax-Footnote-1622006
+Node: Function Example622077
+Ref: Function Example-Footnote-1624999
+Node: Function Calling625021
+Node: Calling A Function625609
+Node: Variable Scope626567
+Node: Pass By Value/Reference629561
+Node: Function Caveats632205
+Ref: Function Caveats-Footnote-1634252
+Node: Return Statement634372
+Node: Dynamic Typing637351
+Node: Indirect Calls638281
+Ref: Indirect Calls-Footnote-1648533
+Node: Functions Summary648661
+Node: Library Functions651366
+Ref: Library Functions-Footnote-1654973
+Ref: Library Functions-Footnote-2655116
+Node: Library Names655287
+Ref: Library Names-Footnote-1658954
+Ref: Library Names-Footnote-2659177
+Node: General Functions659263
+Node: Strtonum Function660445
+Node: Assert Function663467
+Node: Round Function666793
+Node: Cliff Random Function668333
+Node: Ordinal Functions669349
+Ref: Ordinal Functions-Footnote-1672412
+Ref: Ordinal Functions-Footnote-2672664
+Node: Join Function672874
+Ref: Join Function-Footnote-1674644
+Node: Getlocaltime Function674844
+Node: Readfile Function678586
+Node: Shell Quoting680563
+Node: Isnumeric Function681991
+Node: Data File Management683379
+Node: Filetrans Function684011
+Node: Rewind Function688107
+Node: File Checking690016
+Ref: File Checking-Footnote-1691350
+Node: Empty Files691551
+Node: Ignoring Assigns693530
+Node: Getopt Function695080
+Ref: Getopt Function-Footnote-1710303
+Node: Passwd Functions710503
+Ref: Passwd Functions-Footnote-1719342
+Node: Group Functions719430
+Ref: Group Functions-Footnote-1727328
+Node: Walking Arrays727535
+Node: Library Functions Summary730543
+Node: Library Exercises731949
+Node: Sample Programs732414
+Node: Running Examples733184
+Node: Clones733912
+Node: Cut Program735136
+Node: Egrep Program745276
+Node: Id Program754277
+Node: Split Program764224
+Ref: Split Program-Footnote-1774117
+Node: Tee Program774290
+Node: Uniq Program777080
+Node: Wc Program784668
+Node: Bytes vs. Characters785055
+Node: Using extensions786603
+Node: wc program787357
+Node: Miscellaneous Programs792222
+Node: Dupword Program793435
+Node: Alarm Program795465
+Node: Translate Program800320
+Ref: Translate Program-Footnote-1804885
+Node: Labels Program805155
+Ref: Labels Program-Footnote-1808506
+Node: Word Sorting808590
+Node: History Sorting812662
+Node: Extract Program814887
+Node: Simple Sed822941
+Node: Igawk Program826015
+Ref: Igawk Program-Footnote-1840346
+Ref: Igawk Program-Footnote-2840548
+Ref: Igawk Program-Footnote-3840670
+Node: Anagram Program840785
+Node: Signature Program843847
+Node: Programs Summary845094
+Node: Programs Exercises846308
+Ref: Programs Exercises-Footnote-1850438
+Node: Advanced Features850524
+Node: Nondecimal Data852591
+Node: Array Sorting854182
+Node: Controlling Array Traversal854882
+Ref: Controlling Array Traversal-Footnote-1863250
+Node: Array Sorting Functions863368
+Ref: Array Sorting Functions-Footnote-1868742
+Node: Two-way I/O868938
+Ref: Two-way I/O-Footnote-1876664
+Ref: Two-way I/O-Footnote-2876851
+Node: TCP/IP Networking876933
+Node: Profiling880051
+Node: Extension Philosophy889360
+Node: Advanced Features Summary890839
+Node: Internationalization892854
+Node: I18N and L10N894528
+Node: Explaining gettext895215
+Ref: Explaining gettext-Footnote-1901107
+Ref: Explaining gettext-Footnote-2901292
+Node: Programmer i18n901457
+Ref: Programmer i18n-Footnote-1906406
+Node: Translator i18n906455
+Node: String Extraction907249
+Ref: String Extraction-Footnote-1908381
+Node: Printf Ordering908467
+Ref: Printf Ordering-Footnote-1911253
+Node: I18N Portability911317
+Ref: I18N Portability-Footnote-1913773
+Node: I18N Example913836
+Ref: I18N Example-Footnote-1917111
+Ref: I18N Example-Footnote-2917184
+Node: Gawk I18N917293
+Node: I18N Summary917942
+Node: Debugger919283
+Node: Debugging920283
+Node: Debugging Concepts920724
+Node: Debugging Terms922533
+Node: Awk Debugging925108
+Ref: Awk Debugging-Footnote-1926053
+Node: Sample Debugging Session926185
+Node: Debugger Invocation926719
+Node: Finding The Bug928105
+Node: List of Debugger Commands934579
+Node: Breakpoint Control935912
+Node: Debugger Execution Control939606
+Node: Viewing And Changing Data942968
+Node: Execution Stack946509
+Node: Debugger Info948146
+Node: Miscellaneous Debugger Commands952217
+Node: Readline Support957279
+Node: Limitations958175
+Node: Debugging Summary960729
+Node: Namespaces962008
+Node: Global Namespace963119
+Node: Qualified Names964517
+Node: Default Namespace965516
+Node: Changing The Namespace966257
+Node: Naming Rules967871
+Node: Internal Name Management969719
+Node: Namespace Example970761
+Node: Namespace And Features973323
+Node: Namespace Summary974758
+Node: Arbitrary Precision Arithmetic976235
+Node: Computer Arithmetic977722
+Ref: table-numeric-ranges981488
+Ref: table-floating-point-ranges981981
+Ref: Computer Arithmetic-Footnote-1982639
+Node: Math Definitions982696
+Ref: table-ieee-formats986012
+Ref: Math Definitions-Footnote-1986615
+Node: MPFR features986720
+Node: FP Math Caution988438
+Ref: FP Math Caution-Footnote-1989510
+Node: Inexactness of computations989879
+Node: Inexact representation990839
+Node: Comparing FP Values992199
+Node: Errors accumulate993440
+Node: Getting Accuracy994873
+Node: Try To Round997583
+Node: Setting precision998482
+Ref: table-predefined-precision-strings999179
+Node: Setting the rounding mode1001009
+Ref: table-gawk-rounding-modes1001383
+Ref: Setting the rounding mode-Footnote-11005314
+Node: Arbitrary Precision Integers1005493
+Ref: Arbitrary Precision Integers-Footnote-11008668
+Node: Checking for MPFR1008817
+Node: POSIX Floating Point Problems1010291
+Ref: POSIX Floating Point Problems-Footnote-11014576
+Node: Floating point summary1014614
+Node: Dynamic Extensions1016804
+Node: Extension Intro1018357
+Node: Plugin License1019623
+Node: Extension Mechanism Outline1020420
+Ref: figure-load-extension1020859
+Ref: figure-register-new-function1022424
+Ref: figure-call-new-function1023516
+Node: Extension API Description1025578
+Node: Extension API Functions Introduction1027291
+Ref: table-api-std-headers1029127
+Node: General Data Types1033376
+Ref: General Data Types-Footnote-11042006
+Node: Memory Allocation Functions1042305
+Ref: Memory Allocation Functions-Footnote-11046806
+Node: Constructor Functions1046905
+Node: API Ownership of MPFR and GMP Values1050371
+Node: Registration Functions1051684
+Node: Extension Functions1052384
+Node: Exit Callback Functions1057706
+Node: Extension Version String1058956
+Node: Input Parsers1059619
+Node: Output Wrappers1072340
+Node: Two-way processors1076852
+Node: Printing Messages1079117
+Ref: Printing Messages-Footnote-11080288
+Node: Updating ERRNO1080441
+Node: Requesting Values1081180
+Ref: table-value-types-returned1081917
+Node: Accessing Parameters1082853
+Node: Symbol Table Access1084090
+Node: Symbol table by name1084602
+Ref: Symbol table by name-Footnote-11087626
+Node: Symbol table by cookie1087754
+Ref: Symbol table by cookie-Footnote-11091939
+Node: Cached values1092003
+Ref: Cached values-Footnote-11095539
+Node: Array Manipulation1095692
+Ref: Array Manipulation-Footnote-11096783
+Node: Array Data Types1096820
+Ref: Array Data Types-Footnote-11099478
+Node: Array Functions1099570
+Node: Flattening Arrays1104068
+Node: Creating Arrays1111044
+Node: Redirection API1115811
+Node: Extension API Variables1118644
+Node: Extension Versioning1119355
+Ref: gawk-api-version1119784
+Node: Extension GMP/MPFR Versioning1121515
+Node: Extension API Informational Variables1123143
+Node: Extension API Boilerplate1124216
+Node: Changes from API V11128190
+Node: Finding Extensions1129762
+Node: Extension Example1130321
+Node: Internal File Description1131119
+Node: Internal File Ops1135199
+Ref: Internal File Ops-Footnote-11146549
+Node: Using Internal File Ops1146689
+Ref: Using Internal File Ops-Footnote-11149072
+Node: Extension Samples1149346
+Node: Extension Sample File Functions1150875
+Node: Extension Sample Fnmatch1158524
+Node: Extension Sample Fork1160011
+Node: Extension Sample Inplace1161229
+Node: Extension Sample Ord1164855
+Node: Extension Sample Readdir1165691
+Ref: table-readdir-file-types1166580
+Node: Extension Sample Revout1167647
+Node: Extension Sample Rev2way1168236
+Node: Extension Sample Read write array1168976
+Node: Extension Sample Readfile1170918
+Node: Extension Sample Time1172013
+Node: Extension Sample API Tests1173765
+Node: gawkextlib1174257
+Node: Extension summary1177175
+Node: Extension Exercises1180877
+Node: Language History1182119
+Node: V7/SVR3.11183775
+Node: SVR41185927
+Node: POSIX1187361
+Node: BTL1188742
+Node: POSIX/GNU1189471
+Node: Feature History1195249
+Node: Common Extensions1212424
+Node: Ranges and Locales1213707
+Ref: Ranges and Locales-Footnote-11218323
+Ref: Ranges and Locales-Footnote-21218350
+Ref: Ranges and Locales-Footnote-31218585
+Node: Contributors1218808
+Node: History summary1224805
+Node: Installation1226185
+Node: Gawk Distribution1227129
+Node: Getting1227613
+Node: Extracting1228576
+Node: Distribution contents1230214
+Node: Unix Installation1236694
+Node: Quick Installation1237498
+Node: Compiling with MPFR1239974
+Node: Shell Startup Files1240666
+Node: Additional Configuration Options1241755
+Node: Configuration Philosophy1244070
+Node: Compiling from Git1246466
+Node: Building the Documentation1247021
+Node: Non-Unix Installation1247943
+Node: PC Installation1248403
+Node: PC Binary Installation1249241
+Node: PC Compiling1249676
+Node: PC Using1250793
+Node: Cygwin1254346
+Node: MSYS1255570
+Node: VMS Installation1256172
+Node: VMS Compilation1256891
+Ref: VMS Compilation-Footnote-11258120
+Node: VMS Dynamic Extensions1258178
+Node: VMS Installation Details1259863
+Node: VMS Running1262125
+Node: VMS GNV1266404
+Node: Bugs1267118
+Node: Bug definition1268030
+Node: Bug address1270534
+Node: Usenet1273922
+Node: Performance bugs1274931
+Node: Asking for help1277852
+Node: Maintainers1279814
+Node: Other Versions1281008
+Node: Installation summary1288860
+Node: Notes1290224
+Node: Compatibility Mode1291018
+Node: Additions1291800
+Node: Accessing The Source1292725
+Node: Adding Code1294162
+Node: New Ports1300381
+Node: Derived Files1304756
+Ref: Derived Files-Footnote-11310416
+Ref: Derived Files-Footnote-21310451
+Ref: Derived Files-Footnote-31311049
+Node: Future Extensions1311163
+Node: Implementation Limitations1311821
+Node: Extension Design1313031
+Node: Old Extension Problems1314175
+Ref: Old Extension Problems-Footnote-11315693
+Node: Extension New Mechanism Goals1315750
+Ref: Extension New Mechanism Goals-Footnote-11319114
+Node: Extension Other Design Decisions1319303
+Node: Extension Future Growth1321416
+Node: Notes summary1322022
+Node: Basic Concepts1323180
+Node: Basic High Level1323861
+Ref: figure-general-flow1324143
+Ref: figure-process-flow1324828
+Ref: Basic High Level-Footnote-11328129
+Node: Basic Data Typing1328314
+Node: Glossary1331642
+Node: Copying1363527
+Node: GNU Free Documentation License1401070
+Node: Index1426190
 
 End Tag Table
 
diff --git a/doc/gawk.texi b/doc/gawk.texi
index a3745eb..5e2ec5d 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -11997,6 +11997,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 d915efd..b5ce6cd 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -11323,6 +11323,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

-----------------------------------------------------------------------

Summary of changes:
 NEWS            |   8 +-
 doc/ChangeLog   |   6 +
 doc/gawk.info   | 905 ++++++++++++++++++++++++++++----------------------------
 doc/gawk.texi   |  11 +
 doc/gawktexi.in |  11 +
 5 files changed, 491 insertions(+), 450 deletions(-)


hooks/post-receive
-- 
gawk