Merge branch 'master' into feature/fix-comments

4 files changed, 351 insertions, 324 deletions

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 4cdf8377..73421635 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,5 +1,10 @@
 2017-07-28         Arnold D. Robbins     <arnold@skeeve.com>
 
+	* gawktexi.in (Type Functions): Improve the example
+	for untyped variables.
+
+2017-07-28         Arnold D. Robbins     <arnold@skeeve.com>
+
 	* gawktexi.in (Extension Sample Inplace): Apply GPL to
 	inplace.awk; should have done that when it was first
 	added. Oops.
diff --git a/doc/gawk.info b/doc/gawk.info
index 66ba25c4..41b10fda 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -13976,15 +13976,23 @@ contexts.
 
      '"untyped"'
           X has not yet been used yet at all; it can become a scalar or
-          an array.  For example:
+          an array.  The typing could even conceivably differ from run
+          to run of the same program!  For example:
 
                BEGIN {
-                   print typeof(x)     # x never used --> untyped
-                   mk_arr(x)
-                   print typeof(x)     # x now an array --> array
+                   print "initially, typeof(v) = ", typeof(v)
+
+                   if ("FOO" in ENVIRON)
+                       make_scalar(v)
+                   else
+                       make_array(v)
+
+                   print "typeof(v) =", typeof(v)
                }
 
-               function mk_arr(a) { a[1] = 1 }
+               function make_scalar(p,    l) { l = p }
+
+               function make_array(p) { p[1] = 1 }
 
    'isarray()' is meant for use in two circumstances.  The first is when
 traversing a multidimensional array: you can test if an element is
@@ -36018,312 +36026,312 @@ Ref: table-bitwise-ops583993
 Ref: Bitwise Functions-Footnote-1590026
 Ref: Bitwise Functions-Footnote-2590199
 Node: Type Functions590390
-Node: I18N Functions593065
-Node: User-defined594716
-Node: Definition Syntax595521
-Ref: Definition Syntax-Footnote-1601208
-Node: Function Example601279
-Ref: Function Example-Footnote-1604201
-Node: Function Caveats604223
-Node: Calling A Function604741
-Node: Variable Scope605699
-Node: Pass By Value/Reference608693
-Node: Return Statement612192
-Node: Dynamic Typing615171
-Node: Indirect Calls616101
-Ref: Indirect Calls-Footnote-1626352
-Node: Functions Summary626480
-Node: Library Functions629185
-Ref: Library Functions-Footnote-1632792
-Ref: Library Functions-Footnote-2632935
-Node: Library Names633106
-Ref: Library Names-Footnote-1636566
-Ref: Library Names-Footnote-2636789
-Node: General Functions636875
-Node: Strtonum Function637978
-Node: Assert Function641000
-Node: Round Function644326
-Node: Cliff Random Function645867
-Node: Ordinal Functions646883
-Ref: Ordinal Functions-Footnote-1649946
-Ref: Ordinal Functions-Footnote-2650198
-Node: Join Function650408
-Ref: Join Function-Footnote-1652178
-Node: Getlocaltime Function652378
-Node: Readfile Function656120
-Node: Shell Quoting658092
-Node: Data File Management659493
-Node: Filetrans Function660125
-Node: Rewind Function664221
-Node: File Checking666131
-Ref: File Checking-Footnote-1667465
-Node: Empty Files667666
-Node: Ignoring Assigns669645
-Node: Getopt Function671195
-Ref: Getopt Function-Footnote-1682664
-Node: Passwd Functions682864
-Ref: Passwd Functions-Footnote-1691703
-Node: Group Functions691791
-Ref: Group Functions-Footnote-1699689
-Node: Walking Arrays699896
-Node: Library Functions Summary702904
-Node: Library Exercises704310
-Node: Sample Programs704775
-Node: Running Examples705545
-Node: Clones706273
-Node: Cut Program707497
-Node: Egrep Program717426
-Ref: Egrep Program-Footnote-1724938
-Node: Id Program725048
-Node: Split Program728728
-Ref: Split Program-Footnote-1732187
-Node: Tee Program732316
-Node: Uniq Program735106
-Node: Wc Program742532
-Ref: Wc Program-Footnote-1746787
-Node: Miscellaneous Programs746881
-Node: Dupword Program748094
-Node: Alarm Program750124
-Node: Translate Program754979
-Ref: Translate Program-Footnote-1759544
-Node: Labels Program759814
-Ref: Labels Program-Footnote-1763165
-Node: Word Sorting763249
-Node: History Sorting767321
-Node: Extract Program769156
-Node: Simple Sed776685
-Node: Igawk Program779759
-Ref: Igawk Program-Footnote-1794090
-Ref: Igawk Program-Footnote-2794292
-Ref: Igawk Program-Footnote-3794414
-Node: Anagram Program794529
-Node: Signature Program797591
-Node: Programs Summary798838
-Node: Programs Exercises800052
-Ref: Programs Exercises-Footnote-1804181
-Node: Advanced Features804272
-Node: Nondecimal Data806262
-Node: Array Sorting807853
-Node: Controlling Array Traversal808553
-Ref: Controlling Array Traversal-Footnote-1816920
-Node: Array Sorting Functions817038
-Ref: Array Sorting Functions-Footnote-1822129
-Node: Two-way I/O822325
-Ref: Two-way I/O-Footnote-1828876
-Ref: Two-way I/O-Footnote-2829063
-Node: TCP/IP Networking829145
-Node: Profiling832263
-Ref: Profiling-Footnote-1840935
-Node: Advanced Features Summary841258
-Node: Internationalization843102
-Node: I18N and L10N844582
-Node: Explaining gettext845269
-Ref: Explaining gettext-Footnote-1851161
-Ref: Explaining gettext-Footnote-2851346
-Node: Programmer i18n851511
-Ref: Programmer i18n-Footnote-1856460
-Node: Translator i18n856509
-Node: String Extraction857303
-Ref: String Extraction-Footnote-1858435
-Node: Printf Ordering858521
-Ref: Printf Ordering-Footnote-1861307
-Node: I18N Portability861371
-Ref: I18N Portability-Footnote-1863827
-Node: I18N Example863890
-Ref: I18N Example-Footnote-1866696
-Node: Gawk I18N866769
-Node: I18N Summary867414
-Node: Debugger868755
-Node: Debugging869777
-Node: Debugging Concepts870218
-Node: Debugging Terms872027
-Node: Awk Debugging874602
-Node: Sample Debugging Session875508
-Node: Debugger Invocation876042
-Node: Finding The Bug877428
-Node: List of Debugger Commands883906
-Node: Breakpoint Control885239
-Node: Debugger Execution Control888933
-Node: Viewing And Changing Data892295
-Node: Execution Stack895669
-Node: Debugger Info897306
-Node: Miscellaneous Debugger Commands901377
-Node: Readline Support906465
-Node: Limitations907361
-Node: Debugging Summary909470
-Node: Arbitrary Precision Arithmetic910749
-Node: Computer Arithmetic912234
-Ref: table-numeric-ranges915825
-Ref: Computer Arithmetic-Footnote-1916547
-Node: Math Definitions916604
-Ref: table-ieee-formats919918
-Ref: Math Definitions-Footnote-1920521
-Node: MPFR features920626
-Node: FP Math Caution922343
-Ref: FP Math Caution-Footnote-1923415
-Node: Inexactness of computations923784
-Node: Inexact representation924744
-Node: Comparing FP Values926104
-Node: Errors accumulate927186
-Node: Getting Accuracy928619
-Node: Try To Round931329
-Node: Setting precision932228
-Ref: table-predefined-precision-strings932925
-Node: Setting the rounding mode934755
-Ref: table-gawk-rounding-modes935129
-Ref: Setting the rounding mode-Footnote-1938537
-Node: Arbitrary Precision Integers938716
-Ref: Arbitrary Precision Integers-Footnote-1943621
-Node: Checking for MPFR943770
-Node: POSIX Floating Point Problems945067
-Ref: POSIX Floating Point Problems-Footnote-1948938
-Node: Floating point summary948976
-Node: Dynamic Extensions951166
-Node: Extension Intro952719
-Node: Plugin License953985
-Node: Extension Mechanism Outline954782
-Ref: figure-load-extension955221
-Ref: figure-register-new-function956786
-Ref: figure-call-new-function957878
-Node: Extension API Description959940
-Node: Extension API Functions Introduction961582
-Node: General Data Types966916
-Ref: General Data Types-Footnote-1974121
-Node: Memory Allocation Functions974420
-Ref: Memory Allocation Functions-Footnote-1977572
-Node: Constructor Functions977671
-Node: Registration Functions980670
-Node: Extension Functions981355
-Node: Exit Callback Functions986568
-Node: Extension Version String987818
-Node: Input Parsers988481
-Node: Output Wrappers1001188
-Node: Two-way processors1005700
-Node: Printing Messages1007965
-Ref: Printing Messages-Footnote-11009136
-Node: Updating ERRNO1009289
-Node: Requesting Values1010028
-Ref: table-value-types-returned1010765
-Node: Accessing Parameters1011701
-Node: Symbol Table Access1012936
-Node: Symbol table by name1013448
-Node: Symbol table by cookie1015237
-Ref: Symbol table by cookie-Footnote-11019422
-Node: Cached values1019486
-Ref: Cached values-Footnote-11023022
-Node: Array Manipulation1023113
-Ref: Array Manipulation-Footnote-11024204
-Node: Array Data Types1024241
-Ref: Array Data Types-Footnote-11026899
-Node: Array Functions1026991
-Node: Flattening Arrays1031390
-Node: Creating Arrays1038331
-Node: Redirection API1043100
-Node: Extension API Variables1045942
-Node: Extension Versioning1046575
-Ref: gawk-api-version1047012
-Node: Extension API Informational Variables1048740
-Node: Extension API Boilerplate1049804
-Node: Changes from API V11053666
-Node: Finding Extensions1054326
-Node: Extension Example1054885
-Node: Internal File Description1055683
-Node: Internal File Ops1059763
-Ref: Internal File Ops-Footnote-11071163
-Node: Using Internal File Ops1071303
-Ref: Using Internal File Ops-Footnote-11073686
-Node: Extension Samples1073960
-Node: Extension Sample File Functions1075489
-Node: Extension Sample Fnmatch1083138
-Node: Extension Sample Fork1084625
-Node: Extension Sample Inplace1085843
-Node: Extension Sample Ord1089060
-Node: Extension Sample Readdir1089896
-Ref: table-readdir-file-types1090785
-Node: Extension Sample Revout1091590
-Node: Extension Sample Rev2way1092179
-Node: Extension Sample Read write array1092919
-Node: Extension Sample Readfile1094861
-Node: Extension Sample Time1095956
-Node: Extension Sample API Tests1097304
-Node: gawkextlib1097796
-Node: Extension summary1100243
-Node: Extension Exercises1103945
-Node: Language History1105443
-Node: V7/SVR3.11107099
-Node: SVR41109251
-Node: POSIX1110685
-Node: BTL1112064
-Node: POSIX/GNU1112793
-Node: Feature History1118685
-Node: Common Extensions1133109
-Node: Ranges and Locales1134392
-Ref: Ranges and Locales-Footnote-11139008
-Ref: Ranges and Locales-Footnote-21139035
-Ref: Ranges and Locales-Footnote-31139270
-Node: Contributors1139491
-Node: History summary1145051
-Node: Installation1146431
-Node: Gawk Distribution1147375
-Node: Getting1147859
-Node: Extracting1148820
-Node: Distribution contents1150458
-Node: Unix Installation1156800
-Node: Quick Installation1157482
-Node: Shell Startup Files1159896
-Node: Additional Configuration Options1160985
-Node: Configuration Philosophy1162974
-Node: Non-Unix Installation1165343
-Node: PC Installation1165803
-Node: PC Binary Installation1166641
-Node: PC Compiling1167076
-Node: PC Using1168193
-Node: Cygwin1171238
-Node: MSYS1172008
-Node: VMS Installation1172509
-Node: VMS Compilation1173300
-Ref: VMS Compilation-Footnote-11174529
-Node: VMS Dynamic Extensions1174587
-Node: VMS Installation Details1176272
-Node: VMS Running1178525
-Node: VMS GNV1182804
-Node: VMS Old Gawk1183539
-Node: Bugs1184010
-Node: Bug address1184673
-Node: Usenet1187070
-Node: Maintainers1187847
-Node: Other Versions1189223
-Node: Installation summary1195807
-Node: Notes1196842
-Node: Compatibility Mode1197707
-Node: Additions1198489
-Node: Accessing The Source1199414
-Node: Adding Code1200849
-Node: New Ports1207067
-Node: Derived Files1211555
-Ref: Derived Files-Footnote-11217040
-Ref: Derived Files-Footnote-21217075
-Ref: Derived Files-Footnote-31217673
-Node: Future Extensions1217787
-Node: Implementation Limitations1218445
-Node: Extension Design1219628
-Node: Old Extension Problems1220782
-Ref: Old Extension Problems-Footnote-11222300
-Node: Extension New Mechanism Goals1222357
-Ref: Extension New Mechanism Goals-Footnote-11225721
-Node: Extension Other Design Decisions1225910
-Node: Extension Future Growth1228023
-Node: Old Extension Mechanism1228859
-Node: Notes summary1230622
-Node: Basic Concepts1231804
-Node: Basic High Level1232485
-Ref: figure-general-flow1232767
-Ref: figure-process-flow1233452
-Ref: Basic High Level-Footnote-11236753
-Node: Basic Data Typing1236938
-Node: Glossary1240266
-Node: Copying1272213
-Node: GNU Free Documentation License1309752
-Node: Index1334870
+Node: I18N Functions593307
+Node: User-defined594958
+Node: Definition Syntax595763
+Ref: Definition Syntax-Footnote-1601450
+Node: Function Example601521
+Ref: Function Example-Footnote-1604443
+Node: Function Caveats604465
+Node: Calling A Function604983
+Node: Variable Scope605941
+Node: Pass By Value/Reference608935
+Node: Return Statement612434
+Node: Dynamic Typing615413
+Node: Indirect Calls616343
+Ref: Indirect Calls-Footnote-1626594
+Node: Functions Summary626722
+Node: Library Functions629427
+Ref: Library Functions-Footnote-1633034
+Ref: Library Functions-Footnote-2633177
+Node: Library Names633348
+Ref: Library Names-Footnote-1636808
+Ref: Library Names-Footnote-2637031
+Node: General Functions637117
+Node: Strtonum Function638220
+Node: Assert Function641242
+Node: Round Function644568
+Node: Cliff Random Function646109
+Node: Ordinal Functions647125
+Ref: Ordinal Functions-Footnote-1650188
+Ref: Ordinal Functions-Footnote-2650440
+Node: Join Function650650
+Ref: Join Function-Footnote-1652420
+Node: Getlocaltime Function652620
+Node: Readfile Function656362
+Node: Shell Quoting658334
+Node: Data File Management659735
+Node: Filetrans Function660367
+Node: Rewind Function664463
+Node: File Checking666373
+Ref: File Checking-Footnote-1667707
+Node: Empty Files667908
+Node: Ignoring Assigns669887
+Node: Getopt Function671437
+Ref: Getopt Function-Footnote-1682906
+Node: Passwd Functions683106
+Ref: Passwd Functions-Footnote-1691945
+Node: Group Functions692033
+Ref: Group Functions-Footnote-1699931
+Node: Walking Arrays700138
+Node: Library Functions Summary703146
+Node: Library Exercises704552
+Node: Sample Programs705017
+Node: Running Examples705787
+Node: Clones706515
+Node: Cut Program707739
+Node: Egrep Program717668
+Ref: Egrep Program-Footnote-1725180
+Node: Id Program725290
+Node: Split Program728970
+Ref: Split Program-Footnote-1732429
+Node: Tee Program732558
+Node: Uniq Program735348
+Node: Wc Program742774
+Ref: Wc Program-Footnote-1747029
+Node: Miscellaneous Programs747123
+Node: Dupword Program748336
+Node: Alarm Program750366
+Node: Translate Program755221
+Ref: Translate Program-Footnote-1759786
+Node: Labels Program760056
+Ref: Labels Program-Footnote-1763407
+Node: Word Sorting763491
+Node: History Sorting767563
+Node: Extract Program769398
+Node: Simple Sed776927
+Node: Igawk Program780001
+Ref: Igawk Program-Footnote-1794332
+Ref: Igawk Program-Footnote-2794534
+Ref: Igawk Program-Footnote-3794656
+Node: Anagram Program794771
+Node: Signature Program797833
+Node: Programs Summary799080
+Node: Programs Exercises800294
+Ref: Programs Exercises-Footnote-1804423
+Node: Advanced Features804514
+Node: Nondecimal Data806504
+Node: Array Sorting808095
+Node: Controlling Array Traversal808795
+Ref: Controlling Array Traversal-Footnote-1817162
+Node: Array Sorting Functions817280
+Ref: Array Sorting Functions-Footnote-1822371
+Node: Two-way I/O822567
+Ref: Two-way I/O-Footnote-1829118
+Ref: Two-way I/O-Footnote-2829305
+Node: TCP/IP Networking829387
+Node: Profiling832505
+Ref: Profiling-Footnote-1841177
+Node: Advanced Features Summary841500
+Node: Internationalization843344
+Node: I18N and L10N844824
+Node: Explaining gettext845511
+Ref: Explaining gettext-Footnote-1851403
+Ref: Explaining gettext-Footnote-2851588
+Node: Programmer i18n851753
+Ref: Programmer i18n-Footnote-1856702
+Node: Translator i18n856751
+Node: String Extraction857545
+Ref: String Extraction-Footnote-1858677
+Node: Printf Ordering858763
+Ref: Printf Ordering-Footnote-1861549
+Node: I18N Portability861613
+Ref: I18N Portability-Footnote-1864069
+Node: I18N Example864132
+Ref: I18N Example-Footnote-1866938
+Node: Gawk I18N867011
+Node: I18N Summary867656
+Node: Debugger868997
+Node: Debugging870019
+Node: Debugging Concepts870460
+Node: Debugging Terms872269
+Node: Awk Debugging874844
+Node: Sample Debugging Session875750
+Node: Debugger Invocation876284
+Node: Finding The Bug877670
+Node: List of Debugger Commands884148
+Node: Breakpoint Control885481
+Node: Debugger Execution Control889175
+Node: Viewing And Changing Data892537
+Node: Execution Stack895911
+Node: Debugger Info897548
+Node: Miscellaneous Debugger Commands901619
+Node: Readline Support906707
+Node: Limitations907603
+Node: Debugging Summary909712
+Node: Arbitrary Precision Arithmetic910991
+Node: Computer Arithmetic912476
+Ref: table-numeric-ranges916067
+Ref: Computer Arithmetic-Footnote-1916789
+Node: Math Definitions916846
+Ref: table-ieee-formats920160
+Ref: Math Definitions-Footnote-1920763
+Node: MPFR features920868
+Node: FP Math Caution922585
+Ref: FP Math Caution-Footnote-1923657
+Node: Inexactness of computations924026
+Node: Inexact representation924986
+Node: Comparing FP Values926346
+Node: Errors accumulate927428
+Node: Getting Accuracy928861
+Node: Try To Round931571
+Node: Setting precision932470
+Ref: table-predefined-precision-strings933167
+Node: Setting the rounding mode934997
+Ref: table-gawk-rounding-modes935371
+Ref: Setting the rounding mode-Footnote-1938779
+Node: Arbitrary Precision Integers938958
+Ref: Arbitrary Precision Integers-Footnote-1943863
+Node: Checking for MPFR944012
+Node: POSIX Floating Point Problems945309
+Ref: POSIX Floating Point Problems-Footnote-1949180
+Node: Floating point summary949218
+Node: Dynamic Extensions951408
+Node: Extension Intro952961
+Node: Plugin License954227
+Node: Extension Mechanism Outline955024
+Ref: figure-load-extension955463
+Ref: figure-register-new-function957028
+Ref: figure-call-new-function958120
+Node: Extension API Description960182
+Node: Extension API Functions Introduction961824
+Node: General Data Types967158
+Ref: General Data Types-Footnote-1974363
+Node: Memory Allocation Functions974662
+Ref: Memory Allocation Functions-Footnote-1977814
+Node: Constructor Functions977913
+Node: Registration Functions980912
+Node: Extension Functions981597
+Node: Exit Callback Functions986810
+Node: Extension Version String988060
+Node: Input Parsers988723
+Node: Output Wrappers1001430
+Node: Two-way processors1005942
+Node: Printing Messages1008207
+Ref: Printing Messages-Footnote-11009378
+Node: Updating ERRNO1009531
+Node: Requesting Values1010270
+Ref: table-value-types-returned1011007
+Node: Accessing Parameters1011943
+Node: Symbol Table Access1013178
+Node: Symbol table by name1013690
+Node: Symbol table by cookie1015479
+Ref: Symbol table by cookie-Footnote-11019664
+Node: Cached values1019728
+Ref: Cached values-Footnote-11023264
+Node: Array Manipulation1023355
+Ref: Array Manipulation-Footnote-11024446
+Node: Array Data Types1024483
+Ref: Array Data Types-Footnote-11027141
+Node: Array Functions1027233
+Node: Flattening Arrays1031632
+Node: Creating Arrays1038573
+Node: Redirection API1043342
+Node: Extension API Variables1046184
+Node: Extension Versioning1046817
+Ref: gawk-api-version1047254
+Node: Extension API Informational Variables1048982
+Node: Extension API Boilerplate1050046
+Node: Changes from API V11053908
+Node: Finding Extensions1054568
+Node: Extension Example1055127
+Node: Internal File Description1055925
+Node: Internal File Ops1060005
+Ref: Internal File Ops-Footnote-11071405
+Node: Using Internal File Ops1071545
+Ref: Using Internal File Ops-Footnote-11073928
+Node: Extension Samples1074202
+Node: Extension Sample File Functions1075731
+Node: Extension Sample Fnmatch1083380
+Node: Extension Sample Fork1084867
+Node: Extension Sample Inplace1086085
+Node: Extension Sample Ord1089302
+Node: Extension Sample Readdir1090138
+Ref: table-readdir-file-types1091027
+Node: Extension Sample Revout1091832
+Node: Extension Sample Rev2way1092421
+Node: Extension Sample Read write array1093161
+Node: Extension Sample Readfile1095103
+Node: Extension Sample Time1096198
+Node: Extension Sample API Tests1097546
+Node: gawkextlib1098038
+Node: Extension summary1100485
+Node: Extension Exercises1104187
+Node: Language History1105685
+Node: V7/SVR3.11107341
+Node: SVR41109493
+Node: POSIX1110927
+Node: BTL1112306
+Node: POSIX/GNU1113035
+Node: Feature History1118927
+Node: Common Extensions1133351
+Node: Ranges and Locales1134634
+Ref: Ranges and Locales-Footnote-11139250
+Ref: Ranges and Locales-Footnote-21139277
+Ref: Ranges and Locales-Footnote-31139512
+Node: Contributors1139733
+Node: History summary1145293
+Node: Installation1146673
+Node: Gawk Distribution1147617
+Node: Getting1148101
+Node: Extracting1149062
+Node: Distribution contents1150700
+Node: Unix Installation1157042
+Node: Quick Installation1157724
+Node: Shell Startup Files1160138
+Node: Additional Configuration Options1161227
+Node: Configuration Philosophy1163216
+Node: Non-Unix Installation1165585
+Node: PC Installation1166045
+Node: PC Binary Installation1166883
+Node: PC Compiling1167318
+Node: PC Using1168435
+Node: Cygwin1171480
+Node: MSYS1172250
+Node: VMS Installation1172751
+Node: VMS Compilation1173542
+Ref: VMS Compilation-Footnote-11174771
+Node: VMS Dynamic Extensions1174829
+Node: VMS Installation Details1176514
+Node: VMS Running1178767
+Node: VMS GNV1183046
+Node: VMS Old Gawk1183781
+Node: Bugs1184252
+Node: Bug address1184915
+Node: Usenet1187312
+Node: Maintainers1188089
+Node: Other Versions1189465
+Node: Installation summary1196049
+Node: Notes1197084
+Node: Compatibility Mode1197949
+Node: Additions1198731
+Node: Accessing The Source1199656
+Node: Adding Code1201091
+Node: New Ports1207309
+Node: Derived Files1211797
+Ref: Derived Files-Footnote-11217282
+Ref: Derived Files-Footnote-21217317
+Ref: Derived Files-Footnote-31217915
+Node: Future Extensions1218029
+Node: Implementation Limitations1218687
+Node: Extension Design1219870
+Node: Old Extension Problems1221024
+Ref: Old Extension Problems-Footnote-11222542
+Node: Extension New Mechanism Goals1222599
+Ref: Extension New Mechanism Goals-Footnote-11225963
+Node: Extension Other Design Decisions1226152
+Node: Extension Future Growth1228265
+Node: Old Extension Mechanism1229101
+Node: Notes summary1230864
+Node: Basic Concepts1232046
+Node: Basic High Level1232727
+Ref: figure-general-flow1233009
+Ref: figure-process-flow1233694
+Ref: Basic High Level-Footnote-11236995
+Node: Basic Data Typing1237180
+Node: Glossary1240508
+Node: Copying1272455
+Node: GNU Free Documentation License1309994
+Node: Index1335112
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index b75c2d00..66312691 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -20042,17 +20042,24 @@ BEGIN @{
 
 @item "untyped"
 @var{x} has not yet been used yet at all; it can become a scalar or an
-array.
-For example:
+array.  The typing could even conceivably differ from run to run of
+the same program! For example:
 
 @example
 BEGIN @{
-    print typeof(x)     # x never used --> untyped
-    mk_arr(x)
-    print typeof(x)     # x now an array --> array
+    print "initially, typeof(v) = ", typeof(v)
+
+    if ("FOO" in ENVIRON)
+        make_scalar(v)
+    else
+        make_array(v)
+
+    print "typeof(v) =", typeof(v)
 @}
 
-function mk_arr(a) @{ a[1] = 1 @}
+function make_scalar(p,    l) @{ l = p @}
+
+function make_array(p) @{ p[1] = 1 @}
 @end example
 
 @end table
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index d13ea969..f7d396bf 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -19086,17 +19086,24 @@ BEGIN @{
 
 @item "untyped"
 @var{x} has not yet been used yet at all; it can become a scalar or an
-array.
-For example:
+array.  The typing could even conceivably differ from run to run of
+the same program! For example:
 
 @example
 BEGIN @{
-    print typeof(x)     # x never used --> untyped
-    mk_arr(x)
-    print typeof(x)     # x now an array --> array
+    print "initially, typeof(v) = ", typeof(v)
+
+    if ("FOO" in ENVIRON)
+        make_scalar(v)
+    else
+        make_array(v)
+
+    print "typeof(v) =", typeof(v)
 @}
 
-function mk_arr(a) @{ a[1] = 1 @}
+function make_scalar(p,    l) @{ l = p @}
+
+function make_array(p) @{ p[1] = 1 @}
 @end example
 
 @end table