More info on CGI.

3 files changed, 537 insertions, 519 deletions

diff --git a/doc/gawk.info b/doc/gawk.info
index f77d742e..3e2ae355 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -2538,8 +2538,8 @@ The following list describes options mandated by the POSIX standard:
      applications that pass arguments through the URL; using this
      option prevents a malicious (or other) user from passing in
      options, assignments, or `awk' source code (via `-e') to the CGI
-     application.  This option should be used with `#!' scripts (*note
-     Executable Scripts::), like so:
+     application.(1) This option should be used with `#!' scripts
+     (*note Executable Scripts::), like so:
 
           #! /usr/local/bin/gawk -E
 
@@ -2756,7 +2756,7 @@ you would add these lines to the `.profile' file in your home directory:
      POSIXLY_CORRECT=true
      export POSIXLY_CORRECT
 
-   For a C shell-compatible shell,(1) you would add this line to the
+   For a C shell-compatible shell,(2) you would add this line to the
 `.login' file in your home directory:
 
      setenv POSIXLY_CORRECT true
@@ -2767,7 +2767,12 @@ environments.
 
    ---------- Footnotes ----------
 
-   (1) Not recommended.
+   (1) For more detail, please see Section 4.4 of RFC 3875
+(http://www.ietf.org/rfc/rfc3875). Also see the explanatory note sent
+to the `gawk' bug mailing list
+(http://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html).
+
+   (2) Not recommended.
 
 
 File: gawk.info,  Node: Other Arguments,  Next: Naming Standard Input,  Prev: Options,  Up: Invoking Gawk
@@ -34332,518 +34337,519 @@ Node: Intro Summary112624
 Node: Invoking Gawk113507
 Node: Command Line115021
 Node: Options115819
-Ref: Options-Footnote-1131750
-Node: Other Arguments131775
-Node: Naming Standard Input134723
-Node: Environment Variables135816
-Node: AWKPATH Variable136374
-Ref: AWKPATH Variable-Footnote-1139677
-Ref: AWKPATH Variable-Footnote-2139722
-Node: AWKLIBPATH Variable139982
-Node: Other Environment Variables141125
-Node: Exit Status144853
-Node: Include Files145529
-Node: Loading Shared Libraries149126
-Node: Obsolete150553
-Node: Undocumented151250
-Node: Invoking Summary151517
-Node: Regexp153181
-Node: Regexp Usage154635
-Node: Escape Sequences156672
-Node: Regexp Operators162683
-Ref: Regexp Operators-Footnote-1170109
-Ref: Regexp Operators-Footnote-2170256
-Node: Bracket Expressions170354
-Ref: table-char-classes172369
-Node: Leftmost Longest175293
-Node: Computed Regexps176595
-Node: GNU Regexp Operators179992
-Node: Case-sensitivity183665
-Ref: Case-sensitivity-Footnote-1186550
-Ref: Case-sensitivity-Footnote-2186785
-Node: Regexp Summary186893
-Node: Reading Files188360
-Node: Records190454
-Node: awk split records191187
-Node: gawk split records196102
-Ref: gawk split records-Footnote-1200642
-Node: Fields200679
-Ref: Fields-Footnote-1203455
-Node: Nonconstant Fields203541
-Ref: Nonconstant Fields-Footnote-1205784
-Node: Changing Fields205988
-Node: Field Separators211917
-Node: Default Field Splitting214622
-Node: Regexp Field Splitting215739
-Node: Single Character Fields219089
-Node: Command Line Field Separator220148
-Node: Full Line Fields223360
-Ref: Full Line Fields-Footnote-1224877
-Ref: Full Line Fields-Footnote-2224923
-Node: Field Splitting Summary225024
-Node: Constant Size227098
-Node: Splitting By Content231687
-Ref: Splitting By Content-Footnote-1235681
-Node: Multiple Line235844
-Ref: Multiple Line-Footnote-1241730
-Node: Getline241909
-Node: Plain Getline244121
-Node: Getline/Variable246761
-Node: Getline/File247909
-Node: Getline/Variable/File249293
-Ref: Getline/Variable/File-Footnote-1250896
-Node: Getline/Pipe250983
-Node: Getline/Variable/Pipe253666
-Node: Getline/Coprocess254797
-Node: Getline/Variable/Coprocess256049
-Node: Getline Notes256788
-Node: Getline Summary259580
-Ref: table-getline-variants259992
-Node: Read Timeout260821
-Ref: Read Timeout-Footnote-1264646
-Node: Command-line directories264704
-Node: Input Summary265609
-Node: Input Exercises268862
-Node: Printing269590
-Node: Print271367
-Node: Print Examples272824
-Node: Output Separators275603
-Node: OFMT277621
-Node: Printf278975
-Node: Basic Printf279760
-Node: Control Letters281329
-Node: Format Modifiers285313
-Node: Printf Examples291314
-Node: Redirection293800
-Node: Special FD300641
-Ref: Special FD-Footnote-1303801
-Node: Special Files303875
-Node: Other Inherited Files304492
-Node: Special Network305492
-Node: Special Caveats306354
-Node: Close Files And Pipes307305
-Ref: Close Files And Pipes-Footnote-1314487
-Ref: Close Files And Pipes-Footnote-2314635
-Node: Output Summary314785
-Node: Output Exercises315783
-Node: Expressions316463
-Node: Values317648
-Node: Constants318326
-Node: Scalar Constants319017
-Ref: Scalar Constants-Footnote-1319876
-Node: Nondecimal-numbers320126
-Node: Regexp Constants323144
-Node: Using Constant Regexps323669
-Node: Variables326812
-Node: Using Variables327467
-Node: Assignment Options329378
-Node: Conversion331253
-Node: Strings And Numbers331777
-Ref: Strings And Numbers-Footnote-1334842
-Node: Locale influences conversions334951
-Ref: table-locale-affects337698
-Node: All Operators338286
-Node: Arithmetic Ops338916
-Node: Concatenation341421
-Ref: Concatenation-Footnote-1344240
-Node: Assignment Ops344346
-Ref: table-assign-ops349325
-Node: Increment Ops350597
-Node: Truth Values and Conditions354035
-Node: Truth Values355120
-Node: Typing and Comparison356169
-Node: Variable Typing356979
-Node: Comparison Operators360632
-Ref: table-relational-ops361042
-Node: POSIX String Comparison364537
-Ref: POSIX String Comparison-Footnote-1365609
-Node: Boolean Ops365747
-Ref: Boolean Ops-Footnote-1370226
-Node: Conditional Exp370317
-Node: Function Calls372044
-Node: Precedence375924
-Node: Locales379585
-Node: Expressions Summary381217
-Node: Patterns and Actions383777
-Node: Pattern Overview384897
-Node: Regexp Patterns386576
-Node: Expression Patterns387119
-Node: Ranges390900
-Node: BEGIN/END394006
-Node: Using BEGIN/END394767
-Ref: Using BEGIN/END-Footnote-1397501
-Node: I/O And BEGIN/END397607
-Node: BEGINFILE/ENDFILE399921
-Node: Empty402822
-Node: Using Shell Variables403139
-Node: Action Overview405412
-Node: Statements407738
-Node: If Statement409586
-Node: While Statement411081
-Node: Do Statement413110
-Node: For Statement414254
-Node: Switch Statement417411
-Node: Break Statement419793
-Node: Continue Statement421834
-Node: Next Statement423661
-Node: Nextfile Statement426042
-Node: Exit Statement428672
-Node: Built-in Variables431075
-Node: User-modified432208
-Ref: User-modified-Footnote-1439889
-Node: Auto-set439951
-Ref: Auto-set-Footnote-1452986
-Ref: Auto-set-Footnote-2453191
-Node: ARGC and ARGV453247
-Node: Pattern Action Summary457465
-Node: Arrays459892
-Node: Array Basics461221
-Node: Array Intro462065
-Ref: figure-array-elements464029
-Ref: Array Intro-Footnote-1466555
-Node: Reference to Elements466683
-Node: Assigning Elements469135
-Node: Array Example469626
-Node: Scanning an Array471384
-Node: Controlling Scanning474400
-Ref: Controlling Scanning-Footnote-1479596
-Node: Numeric Array Subscripts479912
-Node: Uninitialized Subscripts482097
-Node: Delete483714
-Ref: Delete-Footnote-1486457
-Node: Multidimensional486514
-Node: Multiscanning489611
-Node: Arrays of Arrays491200
-Node: Arrays Summary495959
-Node: Functions498051
-Node: Built-in498924
-Node: Calling Built-in500002
-Node: Numeric Functions501993
-Ref: Numeric Functions-Footnote-1506010
-Ref: Numeric Functions-Footnote-2506367
-Ref: Numeric Functions-Footnote-3506415
-Node: String Functions506687
-Ref: String Functions-Footnote-1530162
-Ref: String Functions-Footnote-2530291
-Ref: String Functions-Footnote-3530539
-Node: Gory Details530626
-Ref: table-sub-escapes532407
-Ref: table-sub-proposed533927
-Ref: table-posix-sub535291
-Ref: table-gensub-escapes536827
-Ref: Gory Details-Footnote-1537659
-Node: I/O Functions537810
-Ref: I/O Functions-Footnote-1545028
-Node: Time Functions545175
-Ref: Time Functions-Footnote-1555663
-Ref: Time Functions-Footnote-2555731
-Ref: Time Functions-Footnote-3555889
-Ref: Time Functions-Footnote-4556000
-Ref: Time Functions-Footnote-5556112
-Ref: Time Functions-Footnote-6556339
-Node: Bitwise Functions556605
-Ref: table-bitwise-ops557167
-Ref: Bitwise Functions-Footnote-1561476
-Node: Type Functions561645
-Node: I18N Functions562796
-Node: User-defined564441
-Node: Definition Syntax565246
-Ref: Definition Syntax-Footnote-1570653
-Node: Function Example570724
-Ref: Function Example-Footnote-1573643
-Node: Function Caveats573665
-Node: Calling A Function574183
-Node: Variable Scope575141
-Node: Pass By Value/Reference578129
-Node: Return Statement581624
-Node: Dynamic Typing584605
-Node: Indirect Calls585534
-Ref: Indirect Calls-Footnote-1596836
-Node: Functions Summary596964
-Node: Library Functions599666
-Ref: Library Functions-Footnote-1603275
-Ref: Library Functions-Footnote-2603418
-Node: Library Names603589
-Ref: Library Names-Footnote-1607043
-Ref: Library Names-Footnote-2607266
-Node: General Functions607352
-Node: Strtonum Function608455
-Node: Assert Function611477
-Node: Round Function614801
-Node: Cliff Random Function616342
-Node: Ordinal Functions617358
-Ref: Ordinal Functions-Footnote-1620421
-Ref: Ordinal Functions-Footnote-2620673
-Node: Join Function620884
-Ref: Join Function-Footnote-1622653
-Node: Getlocaltime Function622853
-Node: Readfile Function626597
-Node: Shell Quoting628567
-Node: Data File Management629968
-Node: Filetrans Function630600
-Node: Rewind Function634656
-Node: File Checking636043
-Ref: File Checking-Footnote-1637375
-Node: Empty Files637576
-Node: Ignoring Assigns639555
-Node: Getopt Function641106
-Ref: Getopt Function-Footnote-1652568
-Node: Passwd Functions652768
-Ref: Passwd Functions-Footnote-1661605
-Node: Group Functions661693
-Ref: Group Functions-Footnote-1669587
-Node: Walking Arrays669800
-Node: Library Functions Summary671403
-Node: Library Exercises672804
-Node: Sample Programs674084
-Node: Running Examples674854
-Node: Clones675582
-Node: Cut Program676806
-Node: Egrep Program686525
-Ref: Egrep Program-Footnote-1694023
-Node: Id Program694133
-Node: Split Program697778
-Ref: Split Program-Footnote-1701226
-Node: Tee Program701354
-Node: Uniq Program704143
-Node: Wc Program711562
-Ref: Wc Program-Footnote-1715812
-Node: Miscellaneous Programs715906
-Node: Dupword Program717119
-Node: Alarm Program719150
-Node: Translate Program723954
-Ref: Translate Program-Footnote-1728519
-Node: Labels Program728789
-Ref: Labels Program-Footnote-1732140
-Node: Word Sorting732224
-Node: History Sorting736295
-Node: Extract Program738131
-Node: Simple Sed745656
-Node: Igawk Program748724
-Ref: Igawk Program-Footnote-1763048
-Ref: Igawk Program-Footnote-2763249
-Ref: Igawk Program-Footnote-3763371
-Node: Anagram Program763486
-Node: Signature Program766543
-Node: Programs Summary767790
-Node: Programs Exercises768983
-Ref: Programs Exercises-Footnote-1773114
-Node: Advanced Features773205
-Node: Nondecimal Data775153
-Node: Array Sorting776743
-Node: Controlling Array Traversal777440
-Ref: Controlling Array Traversal-Footnote-1785773
-Node: Array Sorting Functions785891
-Ref: Array Sorting Functions-Footnote-1789780
-Node: Two-way I/O789976
-Ref: Two-way I/O-Footnote-1794917
-Ref: Two-way I/O-Footnote-2795103
-Node: TCP/IP Networking795185
-Node: Profiling798058
-Node: Advanced Features Summary805605
-Node: Internationalization807538
-Node: I18N and L10N809018
-Node: Explaining gettext809704
-Ref: Explaining gettext-Footnote-1814729
-Ref: Explaining gettext-Footnote-2814913
-Node: Programmer i18n815078
-Ref: Programmer i18n-Footnote-1819944
-Node: Translator i18n819993
-Node: String Extraction820787
-Ref: String Extraction-Footnote-1821918
-Node: Printf Ordering822004
-Ref: Printf Ordering-Footnote-1824790
-Node: I18N Portability824854
-Ref: I18N Portability-Footnote-1827309
-Node: I18N Example827372
-Ref: I18N Example-Footnote-1830175
-Node: Gawk I18N830247
-Node: I18N Summary830885
-Node: Debugger832224
-Node: Debugging833246
-Node: Debugging Concepts833687
-Node: Debugging Terms835540
-Node: Awk Debugging838112
-Node: Sample Debugging Session839006
-Node: Debugger Invocation839526
-Node: Finding The Bug840910
-Node: List of Debugger Commands847385
-Node: Breakpoint Control848718
-Node: Debugger Execution Control852414
-Node: Viewing And Changing Data855778
-Node: Execution Stack859156
-Node: Debugger Info860793
-Node: Miscellaneous Debugger Commands864810
-Node: Readline Support869839
-Node: Limitations870731
-Node: Debugging Summary872845
-Node: Arbitrary Precision Arithmetic874013
-Node: Computer Arithmetic875429
-Ref: table-numeric-ranges879027
-Ref: Computer Arithmetic-Footnote-1879886
-Node: Math Definitions879943
-Ref: table-ieee-formats883231
-Ref: Math Definitions-Footnote-1883835
-Node: MPFR features883940
-Node: FP Math Caution885611
-Ref: FP Math Caution-Footnote-1886661
-Node: Inexactness of computations887030
-Node: Inexact representation887989
-Node: Comparing FP Values889346
-Node: Errors accumulate890428
-Node: Getting Accuracy891861
-Node: Try To Round894523
-Node: Setting precision895422
-Ref: table-predefined-precision-strings896106
-Node: Setting the rounding mode897895
-Ref: table-gawk-rounding-modes898259
-Ref: Setting the rounding mode-Footnote-1901714
-Node: Arbitrary Precision Integers901893
-Ref: Arbitrary Precision Integers-Footnote-1904879
-Node: POSIX Floating Point Problems905028
-Ref: POSIX Floating Point Problems-Footnote-1908901
-Node: Floating point summary908939
-Node: Dynamic Extensions911133
-Node: Extension Intro912685
-Node: Plugin License913951
-Node: Extension Mechanism Outline914748
-Ref: figure-load-extension915176
-Ref: figure-register-new-function916656
-Ref: figure-call-new-function917660
-Node: Extension API Description919646
-Node: Extension API Functions Introduction921096
-Node: General Data Types925920
-Ref: General Data Types-Footnote-1931659
-Node: Memory Allocation Functions931958
-Ref: Memory Allocation Functions-Footnote-1934797
-Node: Constructor Functions934893
-Node: Registration Functions936627
-Node: Extension Functions937312
-Node: Exit Callback Functions939609
-Node: Extension Version String940857
-Node: Input Parsers941522
-Node: Output Wrappers951399
-Node: Two-way processors955914
-Node: Printing Messages958118
-Ref: Printing Messages-Footnote-1959194
-Node: Updating `ERRNO'959346
-Node: Requesting Values960086
-Ref: table-value-types-returned960814
-Node: Accessing Parameters961771
-Node: Symbol Table Access963002
-Node: Symbol table by name963516
-Node: Symbol table by cookie965497
-Ref: Symbol table by cookie-Footnote-1969641
-Node: Cached values969704
-Ref: Cached values-Footnote-1973203
-Node: Array Manipulation973294
-Ref: Array Manipulation-Footnote-1974392
-Node: Array Data Types974429
-Ref: Array Data Types-Footnote-1977084
-Node: Array Functions977176
-Node: Flattening Arrays981030
-Node: Creating Arrays987922
-Node: Extension API Variables992691
-Node: Extension Versioning993327
-Node: Extension API Informational Variables995228
-Node: Extension API Boilerplate996316
-Node: Finding Extensions1000125
-Node: Extension Example1000685
-Node: Internal File Description1001457
-Node: Internal File Ops1005524
-Ref: Internal File Ops-Footnote-11017194
-Node: Using Internal File Ops1017334
-Ref: Using Internal File Ops-Footnote-11019717
-Node: Extension Samples1019990
-Node: Extension Sample File Functions1021516
-Node: Extension Sample Fnmatch1029154
-Node: Extension Sample Fork1030645
-Node: Extension Sample Inplace1031860
-Node: Extension Sample Ord1033535
-Node: Extension Sample Readdir1034371
-Ref: table-readdir-file-types1035247
-Node: Extension Sample Revout1036058
-Node: Extension Sample Rev2way1036648
-Node: Extension Sample Read write array1037388
-Node: Extension Sample Readfile1039328
-Node: Extension Sample Time1040423
-Node: Extension Sample API Tests1041772
-Node: gawkextlib1042263
-Node: Extension summary1044921
-Node: Extension Exercises1048598
-Node: Language History1049320
-Node: V7/SVR3.11050976
-Node: SVR41053157
-Node: POSIX1054602
-Node: BTL1055991
-Node: POSIX/GNU1056725
-Node: Feature History1062289
-Node: Common Extensions1075387
-Node: Ranges and Locales1076711
-Ref: Ranges and Locales-Footnote-11081329
-Ref: Ranges and Locales-Footnote-21081356
-Ref: Ranges and Locales-Footnote-31081590
-Node: Contributors1081811
-Node: History summary1087352
-Node: Installation1088722
-Node: Gawk Distribution1089668
-Node: Getting1090152
-Node: Extracting1090975
-Node: Distribution contents1092610
-Node: Unix Installation1098327
-Node: Quick Installation1098944
-Node: Additional Configuration Options1101368
-Node: Configuration Philosophy1103106
-Node: Non-Unix Installation1105475
-Node: PC Installation1105933
-Node: PC Binary Installation1107252
-Node: PC Compiling1109100
-Ref: PC Compiling-Footnote-11112121
-Node: PC Testing1112230
-Node: PC Using1113406
-Node: Cygwin1117521
-Node: MSYS1118344
-Node: VMS Installation1118844
-Node: VMS Compilation1119636
-Ref: VMS Compilation-Footnote-11120858
-Node: VMS Dynamic Extensions1120916
-Node: VMS Installation Details1122600
-Node: VMS Running1124852
-Node: VMS GNV1127688
-Node: VMS Old Gawk1128422
-Node: Bugs1128892
-Node: Other Versions1132775
-Node: Installation summary1139197
-Node: Notes1140253
-Node: Compatibility Mode1141118
-Node: Additions1141900
-Node: Accessing The Source1142825
-Node: Adding Code1144261
-Node: New Ports1150426
-Node: Derived Files1154908
-Ref: Derived Files-Footnote-11160383
-Ref: Derived Files-Footnote-21160417
-Ref: Derived Files-Footnote-31161013
-Node: Future Extensions1161127
-Node: Implementation Limitations1161733
-Node: Extension Design1162981
-Node: Old Extension Problems1164135
-Ref: Old Extension Problems-Footnote-11165652
-Node: Extension New Mechanism Goals1165709
-Ref: Extension New Mechanism Goals-Footnote-11169069
-Node: Extension Other Design Decisions1169258
-Node: Extension Future Growth1171366
-Node: Old Extension Mechanism1172202
-Node: Notes summary1173964
-Node: Basic Concepts1175150
-Node: Basic High Level1175831
-Ref: figure-general-flow1176103
-Ref: figure-process-flow1176702
-Ref: Basic High Level-Footnote-11179931
-Node: Basic Data Typing1180116
-Node: Glossary1183444
-Node: Copying1208602
-Node: GNU Free Documentation License1246158
-Node: Index1271294
+Ref: Options-Footnote-1131752
+Ref: Options-Footnote-2131981
+Node: Other Arguments132006
+Node: Naming Standard Input134954
+Node: Environment Variables136047
+Node: AWKPATH Variable136605
+Ref: AWKPATH Variable-Footnote-1139908
+Ref: AWKPATH Variable-Footnote-2139953
+Node: AWKLIBPATH Variable140213
+Node: Other Environment Variables141356
+Node: Exit Status145084
+Node: Include Files145760
+Node: Loading Shared Libraries149357
+Node: Obsolete150784
+Node: Undocumented151481
+Node: Invoking Summary151748
+Node: Regexp153412
+Node: Regexp Usage154866
+Node: Escape Sequences156903
+Node: Regexp Operators162914
+Ref: Regexp Operators-Footnote-1170340
+Ref: Regexp Operators-Footnote-2170487
+Node: Bracket Expressions170585
+Ref: table-char-classes172600
+Node: Leftmost Longest175524
+Node: Computed Regexps176826
+Node: GNU Regexp Operators180223
+Node: Case-sensitivity183896
+Ref: Case-sensitivity-Footnote-1186781
+Ref: Case-sensitivity-Footnote-2187016
+Node: Regexp Summary187124
+Node: Reading Files188591
+Node: Records190685
+Node: awk split records191418
+Node: gawk split records196333
+Ref: gawk split records-Footnote-1200873
+Node: Fields200910
+Ref: Fields-Footnote-1203686
+Node: Nonconstant Fields203772
+Ref: Nonconstant Fields-Footnote-1206015
+Node: Changing Fields206219
+Node: Field Separators212148
+Node: Default Field Splitting214853
+Node: Regexp Field Splitting215970
+Node: Single Character Fields219320
+Node: Command Line Field Separator220379
+Node: Full Line Fields223591
+Ref: Full Line Fields-Footnote-1225108
+Ref: Full Line Fields-Footnote-2225154
+Node: Field Splitting Summary225255
+Node: Constant Size227329
+Node: Splitting By Content231918
+Ref: Splitting By Content-Footnote-1235912
+Node: Multiple Line236075
+Ref: Multiple Line-Footnote-1241961
+Node: Getline242140
+Node: Plain Getline244352
+Node: Getline/Variable246992
+Node: Getline/File248140
+Node: Getline/Variable/File249524
+Ref: Getline/Variable/File-Footnote-1251127
+Node: Getline/Pipe251214
+Node: Getline/Variable/Pipe253897
+Node: Getline/Coprocess255028
+Node: Getline/Variable/Coprocess256280
+Node: Getline Notes257019
+Node: Getline Summary259811
+Ref: table-getline-variants260223
+Node: Read Timeout261052
+Ref: Read Timeout-Footnote-1264877
+Node: Command-line directories264935
+Node: Input Summary265840
+Node: Input Exercises269093
+Node: Printing269821
+Node: Print271598
+Node: Print Examples273055
+Node: Output Separators275834
+Node: OFMT277852
+Node: Printf279206
+Node: Basic Printf279991
+Node: Control Letters281560
+Node: Format Modifiers285544
+Node: Printf Examples291545
+Node: Redirection294031
+Node: Special FD300872
+Ref: Special FD-Footnote-1304032
+Node: Special Files304106
+Node: Other Inherited Files304723
+Node: Special Network305723
+Node: Special Caveats306585
+Node: Close Files And Pipes307536
+Ref: Close Files And Pipes-Footnote-1314718
+Ref: Close Files And Pipes-Footnote-2314866
+Node: Output Summary315016
+Node: Output Exercises316014
+Node: Expressions316694
+Node: Values317879
+Node: Constants318557
+Node: Scalar Constants319248
+Ref: Scalar Constants-Footnote-1320107
+Node: Nondecimal-numbers320357
+Node: Regexp Constants323375
+Node: Using Constant Regexps323900
+Node: Variables327043
+Node: Using Variables327698
+Node: Assignment Options329609
+Node: Conversion331484
+Node: Strings And Numbers332008
+Ref: Strings And Numbers-Footnote-1335073
+Node: Locale influences conversions335182
+Ref: table-locale-affects337929
+Node: All Operators338517
+Node: Arithmetic Ops339147
+Node: Concatenation341652
+Ref: Concatenation-Footnote-1344471
+Node: Assignment Ops344577
+Ref: table-assign-ops349556
+Node: Increment Ops350828
+Node: Truth Values and Conditions354266
+Node: Truth Values355351
+Node: Typing and Comparison356400
+Node: Variable Typing357210
+Node: Comparison Operators360863
+Ref: table-relational-ops361273
+Node: POSIX String Comparison364768
+Ref: POSIX String Comparison-Footnote-1365840
+Node: Boolean Ops365978
+Ref: Boolean Ops-Footnote-1370457
+Node: Conditional Exp370548
+Node: Function Calls372275
+Node: Precedence376155
+Node: Locales379816
+Node: Expressions Summary381448
+Node: Patterns and Actions384008
+Node: Pattern Overview385128
+Node: Regexp Patterns386807
+Node: Expression Patterns387350
+Node: Ranges391131
+Node: BEGIN/END394237
+Node: Using BEGIN/END394998
+Ref: Using BEGIN/END-Footnote-1397732
+Node: I/O And BEGIN/END397838
+Node: BEGINFILE/ENDFILE400152
+Node: Empty403053
+Node: Using Shell Variables403370
+Node: Action Overview405643
+Node: Statements407969
+Node: If Statement409817
+Node: While Statement411312
+Node: Do Statement413341
+Node: For Statement414485
+Node: Switch Statement417642
+Node: Break Statement420024
+Node: Continue Statement422065
+Node: Next Statement423892
+Node: Nextfile Statement426273
+Node: Exit Statement428903
+Node: Built-in Variables431306
+Node: User-modified432439
+Ref: User-modified-Footnote-1440120
+Node: Auto-set440182
+Ref: Auto-set-Footnote-1453217
+Ref: Auto-set-Footnote-2453422
+Node: ARGC and ARGV453478
+Node: Pattern Action Summary457696
+Node: Arrays460123
+Node: Array Basics461452
+Node: Array Intro462296
+Ref: figure-array-elements464260
+Ref: Array Intro-Footnote-1466786
+Node: Reference to Elements466914
+Node: Assigning Elements469366
+Node: Array Example469857
+Node: Scanning an Array471615
+Node: Controlling Scanning474631
+Ref: Controlling Scanning-Footnote-1479827
+Node: Numeric Array Subscripts480143
+Node: Uninitialized Subscripts482328
+Node: Delete483945
+Ref: Delete-Footnote-1486688
+Node: Multidimensional486745
+Node: Multiscanning489842
+Node: Arrays of Arrays491431
+Node: Arrays Summary496190
+Node: Functions498282
+Node: Built-in499155
+Node: Calling Built-in500233
+Node: Numeric Functions502224
+Ref: Numeric Functions-Footnote-1506241
+Ref: Numeric Functions-Footnote-2506598
+Ref: Numeric Functions-Footnote-3506646
+Node: String Functions506918
+Ref: String Functions-Footnote-1530393
+Ref: String Functions-Footnote-2530522
+Ref: String Functions-Footnote-3530770
+Node: Gory Details530857
+Ref: table-sub-escapes532638
+Ref: table-sub-proposed534158
+Ref: table-posix-sub535522
+Ref: table-gensub-escapes537058
+Ref: Gory Details-Footnote-1537890
+Node: I/O Functions538041
+Ref: I/O Functions-Footnote-1545259
+Node: Time Functions545406
+Ref: Time Functions-Footnote-1555894
+Ref: Time Functions-Footnote-2555962
+Ref: Time Functions-Footnote-3556120
+Ref: Time Functions-Footnote-4556231
+Ref: Time Functions-Footnote-5556343
+Ref: Time Functions-Footnote-6556570
+Node: Bitwise Functions556836
+Ref: table-bitwise-ops557398
+Ref: Bitwise Functions-Footnote-1561707
+Node: Type Functions561876
+Node: I18N Functions563027
+Node: User-defined564672
+Node: Definition Syntax565477
+Ref: Definition Syntax-Footnote-1570884
+Node: Function Example570955
+Ref: Function Example-Footnote-1573874
+Node: Function Caveats573896
+Node: Calling A Function574414
+Node: Variable Scope575372
+Node: Pass By Value/Reference578360
+Node: Return Statement581855
+Node: Dynamic Typing584836
+Node: Indirect Calls585765
+Ref: Indirect Calls-Footnote-1597067
+Node: Functions Summary597195
+Node: Library Functions599897
+Ref: Library Functions-Footnote-1603506
+Ref: Library Functions-Footnote-2603649
+Node: Library Names603820
+Ref: Library Names-Footnote-1607274
+Ref: Library Names-Footnote-2607497
+Node: General Functions607583
+Node: Strtonum Function608686
+Node: Assert Function611708
+Node: Round Function615032
+Node: Cliff Random Function616573
+Node: Ordinal Functions617589
+Ref: Ordinal Functions-Footnote-1620652
+Ref: Ordinal Functions-Footnote-2620904
+Node: Join Function621115
+Ref: Join Function-Footnote-1622884
+Node: Getlocaltime Function623084
+Node: Readfile Function626828
+Node: Shell Quoting628798
+Node: Data File Management630199
+Node: Filetrans Function630831
+Node: Rewind Function634887
+Node: File Checking636274
+Ref: File Checking-Footnote-1637606
+Node: Empty Files637807
+Node: Ignoring Assigns639786
+Node: Getopt Function641337
+Ref: Getopt Function-Footnote-1652799
+Node: Passwd Functions652999
+Ref: Passwd Functions-Footnote-1661836
+Node: Group Functions661924
+Ref: Group Functions-Footnote-1669818
+Node: Walking Arrays670031
+Node: Library Functions Summary671634
+Node: Library Exercises673035
+Node: Sample Programs674315
+Node: Running Examples675085
+Node: Clones675813
+Node: Cut Program677037
+Node: Egrep Program686756
+Ref: Egrep Program-Footnote-1694254
+Node: Id Program694364
+Node: Split Program698009
+Ref: Split Program-Footnote-1701457
+Node: Tee Program701585
+Node: Uniq Program704374
+Node: Wc Program711793
+Ref: Wc Program-Footnote-1716043
+Node: Miscellaneous Programs716137
+Node: Dupword Program717350
+Node: Alarm Program719381
+Node: Translate Program724185
+Ref: Translate Program-Footnote-1728750
+Node: Labels Program729020
+Ref: Labels Program-Footnote-1732371
+Node: Word Sorting732455
+Node: History Sorting736526
+Node: Extract Program738362
+Node: Simple Sed745887
+Node: Igawk Program748955
+Ref: Igawk Program-Footnote-1763279
+Ref: Igawk Program-Footnote-2763480
+Ref: Igawk Program-Footnote-3763602
+Node: Anagram Program763717
+Node: Signature Program766774
+Node: Programs Summary768021
+Node: Programs Exercises769214
+Ref: Programs Exercises-Footnote-1773345
+Node: Advanced Features773436
+Node: Nondecimal Data775384
+Node: Array Sorting776974
+Node: Controlling Array Traversal777671
+Ref: Controlling Array Traversal-Footnote-1786004
+Node: Array Sorting Functions786122
+Ref: Array Sorting Functions-Footnote-1790011
+Node: Two-way I/O790207
+Ref: Two-way I/O-Footnote-1795148
+Ref: Two-way I/O-Footnote-2795334
+Node: TCP/IP Networking795416
+Node: Profiling798289
+Node: Advanced Features Summary805836
+Node: Internationalization807769
+Node: I18N and L10N809249
+Node: Explaining gettext809935
+Ref: Explaining gettext-Footnote-1814960
+Ref: Explaining gettext-Footnote-2815144
+Node: Programmer i18n815309
+Ref: Programmer i18n-Footnote-1820175
+Node: Translator i18n820224
+Node: String Extraction821018
+Ref: String Extraction-Footnote-1822149
+Node: Printf Ordering822235
+Ref: Printf Ordering-Footnote-1825021
+Node: I18N Portability825085
+Ref: I18N Portability-Footnote-1827540
+Node: I18N Example827603
+Ref: I18N Example-Footnote-1830406
+Node: Gawk I18N830478
+Node: I18N Summary831116
+Node: Debugger832455
+Node: Debugging833477
+Node: Debugging Concepts833918
+Node: Debugging Terms835771
+Node: Awk Debugging838343
+Node: Sample Debugging Session839237
+Node: Debugger Invocation839757
+Node: Finding The Bug841141
+Node: List of Debugger Commands847616
+Node: Breakpoint Control848949
+Node: Debugger Execution Control852645
+Node: Viewing And Changing Data856009
+Node: Execution Stack859387
+Node: Debugger Info861024
+Node: Miscellaneous Debugger Commands865041
+Node: Readline Support870070
+Node: Limitations870962
+Node: Debugging Summary873076
+Node: Arbitrary Precision Arithmetic874244
+Node: Computer Arithmetic875660
+Ref: table-numeric-ranges879258
+Ref: Computer Arithmetic-Footnote-1880117
+Node: Math Definitions880174
+Ref: table-ieee-formats883462
+Ref: Math Definitions-Footnote-1884066
+Node: MPFR features884171
+Node: FP Math Caution885842
+Ref: FP Math Caution-Footnote-1886892
+Node: Inexactness of computations887261
+Node: Inexact representation888220
+Node: Comparing FP Values889577
+Node: Errors accumulate890659
+Node: Getting Accuracy892092
+Node: Try To Round894754
+Node: Setting precision895653
+Ref: table-predefined-precision-strings896337
+Node: Setting the rounding mode898126
+Ref: table-gawk-rounding-modes898490
+Ref: Setting the rounding mode-Footnote-1901945
+Node: Arbitrary Precision Integers902124
+Ref: Arbitrary Precision Integers-Footnote-1905110
+Node: POSIX Floating Point Problems905259
+Ref: POSIX Floating Point Problems-Footnote-1909132
+Node: Floating point summary909170
+Node: Dynamic Extensions911364
+Node: Extension Intro912916
+Node: Plugin License914182
+Node: Extension Mechanism Outline914979
+Ref: figure-load-extension915407
+Ref: figure-register-new-function916887
+Ref: figure-call-new-function917891
+Node: Extension API Description919877
+Node: Extension API Functions Introduction921327
+Node: General Data Types926151
+Ref: General Data Types-Footnote-1931890
+Node: Memory Allocation Functions932189
+Ref: Memory Allocation Functions-Footnote-1935028
+Node: Constructor Functions935124
+Node: Registration Functions936858
+Node: Extension Functions937543
+Node: Exit Callback Functions939840
+Node: Extension Version String941088
+Node: Input Parsers941753
+Node: Output Wrappers951630
+Node: Two-way processors956145
+Node: Printing Messages958349
+Ref: Printing Messages-Footnote-1959425
+Node: Updating `ERRNO'959577
+Node: Requesting Values960317
+Ref: table-value-types-returned961045
+Node: Accessing Parameters962002
+Node: Symbol Table Access963233
+Node: Symbol table by name963747
+Node: Symbol table by cookie965728
+Ref: Symbol table by cookie-Footnote-1969872
+Node: Cached values969935
+Ref: Cached values-Footnote-1973434
+Node: Array Manipulation973525
+Ref: Array Manipulation-Footnote-1974623
+Node: Array Data Types974660
+Ref: Array Data Types-Footnote-1977315
+Node: Array Functions977407
+Node: Flattening Arrays981261
+Node: Creating Arrays988153
+Node: Extension API Variables992922
+Node: Extension Versioning993558
+Node: Extension API Informational Variables995459
+Node: Extension API Boilerplate996547
+Node: Finding Extensions1000356
+Node: Extension Example1000916
+Node: Internal File Description1001688
+Node: Internal File Ops1005755
+Ref: Internal File Ops-Footnote-11017425
+Node: Using Internal File Ops1017565
+Ref: Using Internal File Ops-Footnote-11019948
+Node: Extension Samples1020221
+Node: Extension Sample File Functions1021747
+Node: Extension Sample Fnmatch1029385
+Node: Extension Sample Fork1030876
+Node: Extension Sample Inplace1032091
+Node: Extension Sample Ord1033766
+Node: Extension Sample Readdir1034602
+Ref: table-readdir-file-types1035478
+Node: Extension Sample Revout1036289
+Node: Extension Sample Rev2way1036879
+Node: Extension Sample Read write array1037619
+Node: Extension Sample Readfile1039559
+Node: Extension Sample Time1040654
+Node: Extension Sample API Tests1042003
+Node: gawkextlib1042494
+Node: Extension summary1045152
+Node: Extension Exercises1048829
+Node: Language History1049551
+Node: V7/SVR3.11051207
+Node: SVR41053388
+Node: POSIX1054833
+Node: BTL1056222
+Node: POSIX/GNU1056956
+Node: Feature History1062520
+Node: Common Extensions1075618
+Node: Ranges and Locales1076942
+Ref: Ranges and Locales-Footnote-11081560
+Ref: Ranges and Locales-Footnote-21081587
+Ref: Ranges and Locales-Footnote-31081821
+Node: Contributors1082042
+Node: History summary1087583
+Node: Installation1088953
+Node: Gawk Distribution1089899
+Node: Getting1090383
+Node: Extracting1091206
+Node: Distribution contents1092841
+Node: Unix Installation1098558
+Node: Quick Installation1099175
+Node: Additional Configuration Options1101599
+Node: Configuration Philosophy1103337
+Node: Non-Unix Installation1105706
+Node: PC Installation1106164
+Node: PC Binary Installation1107483
+Node: PC Compiling1109331
+Ref: PC Compiling-Footnote-11112352
+Node: PC Testing1112461
+Node: PC Using1113637
+Node: Cygwin1117752
+Node: MSYS1118575
+Node: VMS Installation1119075
+Node: VMS Compilation1119867
+Ref: VMS Compilation-Footnote-11121089
+Node: VMS Dynamic Extensions1121147
+Node: VMS Installation Details1122831
+Node: VMS Running1125083
+Node: VMS GNV1127919
+Node: VMS Old Gawk1128653
+Node: Bugs1129123
+Node: Other Versions1133006
+Node: Installation summary1139428
+Node: Notes1140484
+Node: Compatibility Mode1141349
+Node: Additions1142131
+Node: Accessing The Source1143056
+Node: Adding Code1144492
+Node: New Ports1150657
+Node: Derived Files1155139
+Ref: Derived Files-Footnote-11160614
+Ref: Derived Files-Footnote-21160648
+Ref: Derived Files-Footnote-31161244
+Node: Future Extensions1161358
+Node: Implementation Limitations1161964
+Node: Extension Design1163212
+Node: Old Extension Problems1164366
+Ref: Old Extension Problems-Footnote-11165883
+Node: Extension New Mechanism Goals1165940
+Ref: Extension New Mechanism Goals-Footnote-11169300
+Node: Extension Other Design Decisions1169489
+Node: Extension Future Growth1171597
+Node: Old Extension Mechanism1172433
+Node: Notes summary1174195
+Node: Basic Concepts1175381
+Node: Basic High Level1176062
+Ref: figure-general-flow1176334
+Ref: figure-process-flow1176933
+Ref: Basic High Level-Footnote-11180162
+Node: Basic Data Typing1180347
+Node: Glossary1183675
+Node: Copying1208833
+Node: GNU Free Documentation License1246389
+Node: Index1271525
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 66174009..42196498 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -3932,7 +3932,13 @@ Command-line variable assignments of the form
 This option is particularly necessary for World Wide Web CGI applications
 that pass arguments through the URL; using this option prevents a malicious
 (or other) user from passing in options, assignments, or @command{awk} source
-code (via @option{-e}) to the CGI application.  This option should be used
+code (via @option{-e}) to the CGI application.@footnote{For more detail,
+please see Section 4.4 of @uref{http://www.ietf.org/rfc/rfc3875,
+RFC 3875}. Also see the
+@uref{http://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html,
+explanatory note sent to the @command{gawk} bug
+mailing list}.}
+This option should be used
 with @samp{#!} scripts (@pxref{Executable Scripts}), like so:
 
 @example
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 0f07e210..61e41804 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -3843,7 +3843,13 @@ Command-line variable assignments of the form
 This option is particularly necessary for World Wide Web CGI applications
 that pass arguments through the URL; using this option prevents a malicious
 (or other) user from passing in options, assignments, or @command{awk} source
-code (via @option{-e}) to the CGI application.  This option should be used
+code (via @option{-e}) to the CGI application.@footnote{For more detail,
+please see Section 4.4 of @uref{http://www.ietf.org/rfc/rfc3875,
+RFC 3875}. Also see the
+@uref{http://lists.gnu.org/archive/html/bug-gawk/2014-11/msg00022.html,
+explanatory note sent to the @command{gawk} bug
+mailing list}.}
+This option should be used
 with @samp{#!} scripts (@pxref{Executable Scripts}), like so:
 
 @example