[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[SCM] gawk branch, master, updated. gawk-4.1.0-5398-g02c5147d

From: Arnold Robbins
Subject: [SCM] gawk branch, master, updated. gawk-4.1.0-5398-g02c5147d
Date: Sun, 22 Oct 2023 01:53:54 -0400 (EDT)

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, master has been updated
       via  02c5147dbe1eaea911a2e67bae9251246d28b861 (commit)
      from  ba4dc1f2d640edbce348a9f44d1dd67c01d1a5b3 (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 -----------------------------------------------------------------

commit 02c5147dbe1eaea911a2e67bae9251246d28b861
Author: Arnold D. Robbins <>
Date:   Sun Oct 22 08:53:39 2023 +0300

    Doc fix.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index acee0fc9..8fbb7775 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,10 @@
+2023-10-22         Arnold D. Robbins     <>
+       * gawk.texi (Arrays of Arrays): Remove note at the end about
+       passing uninitialized elements into builtin functions that
+       create arrays, as it now works. Thanks, yet again, to
+       Hermann Peifer for pointing this out.
 2023-10-21         Arnold D. Robbins     <>
        * gawk.texi: Remove notes at end of the file about sidebars.
diff --git a/doc/ b/doc/
index 12892471..9e27f4e8 100644
--- a/doc/
+++ b/doc/
@@ -13018,20 +13018,6 @@ following code prints the elements of our main array 
 *Note Walking Arrays:: for a user-defined function that "walks" an
 arbitrarily dimensioned array of arrays.
-   Recall that a reference to an uninitialized array element yields a
-value of ‘""’, the null string.  This has one important implication when
-you intend to use a subarray as an argument to a function, as
-illustrated by the following example:
-     $ gawk 'BEGIN { split("a b c d", b[1]); print b[1][1] }'
-     error→ gawk: cmd. line:1: fatal: split: second argument is not an array
-   The way to work around this is to first force ‘b[1]’ to be an array
-by creating an arbitrary index:
-     $ gawk 'BEGIN { b[1][1] = ""; split("a b c d", b[1]); print b[1][1] }'
-     ⊣ a
 File:,  Node: Arrays Summary,  Prev: Arrays of Arrays,  Up: Arrays
@@ -39957,380 +39943,380 @@ Ref: Delete-Footnote-1563822
 Node: Multidimensional563879
 Node: Multiscanning567082
 Node: Arrays of Arrays568749
-Node: Arrays Summary573639
-Node: Functions575826
-Node: Built-in576884
-Node: Calling Built-in578073
-Node: Boolean Functions580113
-Node: Numeric Functions580675
-Ref: Numeric Functions-Footnote-1584860
-Ref: Numeric Functions-Footnote-2585544
-Ref: Numeric Functions-Footnote-3585596
-Node: String Functions585872
-Ref: String Functions-Footnote-1612323
-Ref: String Functions-Footnote-2612455
-Ref: String Functions-Footnote-3612711
-Node: Gory Details612798
-Ref: table-sub-escapes614807
-Ref: table-sub-proposed616438
-Ref: table-posix-sub617933
-Ref: table-gensub-escapes619606
-Ref: Gory Details-Footnote-1620525
-Node: I/O Functions620679
-Ref: table-system-return-values627355
-Ref: I/O Functions-Footnote-1629517
-Ref: I/O Functions-Footnote-2629665
-Node: Time Functions629785
-Ref: Time Functions-Footnote-1640867
-Ref: Time Functions-Footnote-2640935
-Ref: Time Functions-Footnote-3641097
-Ref: Time Functions-Footnote-4641208
-Ref: Time Functions-Footnote-5641324
-Ref: Time Functions-Footnote-6641551
-Node: Bitwise Functions641829
-Ref: table-bitwise-ops642427
-Ref: Bitwise Functions-Footnote-1648669
-Ref: Bitwise Functions-Footnote-2648846
-Node: Type Functions649041
-Node: I18N Functions652634
-Node: User-defined654369
-Node: Definition Syntax655189
-Ref: Definition Syntax-Footnote-1661007
-Node: Function Example661082
-Ref: Function Example-Footnote-1664061
-Node: Function Calling664083
-Node: Calling A Function664675
-Node: Variable Scope665645
-Node: Pass By Value/Reference668699
-Node: Function Caveats671427
-Ref: Function Caveats-Footnote-1673518
-Node: Return Statement673638
-Node: Dynamic Typing676693
-Node: Indirect Calls679075
-Node: Functions Summary690210
-Node: Library Functions692979
-Ref: Library Functions-Footnote-1696527
-Ref: Library Functions-Footnote-2696670
-Node: Library Names696845
-Ref: Library Names-Footnote-1700616
-Ref: Library Names-Footnote-2700843
-Node: General Functions700937
-Node: Strtonum Function702207
-Node: Assert Function705289
-Node: Round Function708739
-Node: Cliff Random Function710311
-Node: Ordinal Functions711335
-Ref: Ordinal Functions-Footnote-1714438
-Ref: Ordinal Functions-Footnote-2714690
-Node: Join Function714904
-Ref: Join Function-Footnote-1716702
-Node: Getlocaltime Function716906
-Node: Readfile Function720680
-Node: Shell Quoting722709
-Node: Isnumeric Function724165
-Node: To CSV Function725601
-Node: Data File Management727675
-Node: Filetrans Function728307
-Node: Rewind Function732583
-Node: File Checking734554
-Ref: File Checking-Footnote-1735920
-Node: Empty Files736125
-Node: Ignoring Assigns738188
-Node: Getopt Function739762
-Ref: Getopt Function-Footnote-1755580
-Node: Passwd Functions755792
-Ref: Passwd Functions-Footnote-1764927
-Node: Group Functions765015
-Ref: Group Functions-Footnote-1773139
-Node: Walking Arrays773350
-Node: Library Functions Summary776396
-Node: Library Exercises777816
-Node: Sample Programs778301
-Node: Running Examples779083
-Node: Clones779835
-Node: Cut Program781103
-Node: Egrep Program791527
-Node: Id Program800832
-Node: Split Program810924
-Ref: Split Program-Footnote-1821137
-Node: Tee Program821322
-Node: Uniq Program824228
-Node: Wc Program832088
-Node: Bytes vs. Characters832483
-Node: Using extensions834083
-Node: wc program834861
-Node: Miscellaneous Programs839854
-Node: Dupword Program841079
-Node: Alarm Program843128
-Node: Translate Program848031
-Ref: Translate Program-Footnote-1852740
-Node: Labels Program853018
-Ref: Labels Program-Footnote-1856453
-Node: Word Sorting856537
-Node: History Sorting860711
-Node: Extract Program862984
-Node: Simple Sed871239
-Node: Igawk Program874449
-Ref: Igawk Program-Footnote-1889650
-Ref: Igawk Program-Footnote-2889856
-Ref: Igawk Program-Footnote-3889986
-Node: Anagram Program890113
-Node: Signature Program893199
-Node: Programs Summary894449
-Node: Programs Exercises895703
-Ref: Programs Exercises-Footnote-1900005
-Node: Advanced Features900091
-Node: Nondecimal Data902572
-Node: Boolean Typed Values904202
-Node: Array Sorting906159
-Node: Controlling Array Traversal906888
-Ref: Controlling Array Traversal-Footnote-1915391
-Node: Array Sorting Functions915513
-Ref: Array Sorting Functions-Footnote-1921610
-Node: Two-way I/O921818
-Ref: Two-way I/O-Footnote-1929789
-Ref: Two-way I/O-Footnote-2929980
-Node: TCP/IP Networking930062
-Node: Profiling933230
-Node: Persistent Memory942900
-Ref: Persistent Memory-Footnote-1952472
-Node: Extension Philosophy952603
-Node: Advanced Features Summary954130
-Node: Internationalization956396
-Node: I18N and L10N958098
-Node: Explaining gettext958793
-Ref: Explaining gettext-Footnote-1964929
-Ref: Explaining gettext-Footnote-2965122
-Node: Programmer i18n965287
-Ref: Programmer i18n-Footnote-1970392
-Node: Translator i18n970441
-Node: String Extraction971271
-Ref: String Extraction-Footnote-1972447
-Node: Printf Ordering972545
-Ref: Printf Ordering-Footnote-1975403
-Node: I18N Portability975471
-Ref: I18N Portability-Footnote-1978031
-Node: I18N Example978098
-Ref: I18N Example-Footnote-1981492
-Ref: I18N Example-Footnote-2981565
-Node: Gawk I18N981682
-Node: I18N Summary982336
-Node: Debugger983733
-Node: Debugging984753
-Node: Debugging Concepts985202
-Node: Debugging Terms987019
-Node: Awk Debugging989622
-Ref: Awk Debugging-Footnote-1990595
-Node: Sample Debugging Session990731
-Node: Debugger Invocation991281
-Node: Finding The Bug992906
-Node: List of Debugger Commands999538
-Node: Breakpoint Control1000915
-Node: Debugger Execution Control1004737
-Node: Viewing And Changing Data1008211
-Node: Execution Stack1011945
-Node: Debugger Info1013626
-Node: Miscellaneous Debugger Commands1017921
-Node: Readline Support1023162
-Node: Limitations1024106
-Node: Debugging Summary1026730
-Node: Namespaces1028029
-Node: Global Namespace1029156
-Node: Qualified Names1030590
-Node: Default Namespace1031625
-Node: Changing The Namespace1032398
-Node: Naming Rules1034080
-Node: Internal Name Management1035995
-Node: Namespace Example1037065
-Node: Namespace And Features1039642
-Node: Namespace Summary1041097
-Node: Arbitrary Precision Arithmetic1042608
-Node: Computer Arithmetic1044127
-Ref: table-numeric-ranges1047935
-Ref: table-floating-point-ranges1048432
-Ref: Computer Arithmetic-Footnote-11049090
-Node: Math Definitions1049147
-Ref: table-ieee-formats1052179
-Node: MPFR features1052752
-Node: MPFR On Parole1053205
-Ref: MPFR On Parole-Footnote-11054046
-Node: MPFR Intro1054205
-Node: FP Math Caution1055889
-Ref: FP Math Caution-Footnote-11056961
-Node: Inexactness of computations1057334
-Node: Inexact representation1058365
-Node: Comparing FP Values1059746
-Node: Errors accumulate1061004
-Node: Strange values1062469
-Ref: Strange values-Footnote-11065123
-Node: Getting Accuracy1065228
-Node: Try To Round1067965
-Node: Setting precision1068872
-Ref: table-predefined-precision-strings1069577
-Node: Setting the rounding mode1071461
-Ref: table-gawk-rounding-modes1071843
-Ref: Setting the rounding mode-Footnote-11075895
-Node: Arbitrary Precision Integers1076078
-Ref: Arbitrary Precision Integers-Footnote-11079288
-Node: Checking for MPFR1079441
-Node: POSIX Floating Point Problems1080931
-Ref: POSIX Floating Point Problems-Footnote-11085751
-Node: Floating point summary1085789
-Node: Dynamic Extensions1088045
-Node: Extension Intro1089642
-Node: Plugin License1090944
-Node: Extension Mechanism Outline1091757
-Ref: figure-load-extension1092208
-Ref: figure-register-new-function1093786
-Ref: figure-call-new-function1094895
-Node: Extension API Description1097010
-Node: Extension API Functions Introduction1098739
-Ref: table-api-std-headers1100633
-Node: General Data Types1105074
-Ref: General Data Types-Footnote-11114220
-Node: Memory Allocation Functions1114523
-Ref: Memory Allocation Functions-Footnote-11119240
-Node: Constructor Functions1119339
-Node: API Ownership of MPFR and GMP Values1123240
-Node: Registration Functions1124793
-Node: Extension Functions1125497
-Node: Exit Callback Functions1131071
-Node: Extension Version String1132385
-Node: Input Parsers1133080
-Node: Output Wrappers1147699
-Node: Two-way processors1152541
-Node: Printing Messages1154894
-Ref: Printing Messages-Footnote-11156105
-Node: Updating ERRNO1156258
-Node: Requesting Values1157057
-Ref: table-value-types-returned1157810
-Node: Accessing Parameters1158918
-Node: Symbol Table Access1160199
-Node: Symbol table by name1160711
-Ref: Symbol table by name-Footnote-11163912
-Node: Symbol table by cookie1164044
-Ref: Symbol table by cookie-Footnote-11168313
-Node: Cached values1168377
-Ref: Cached values-Footnote-11172009
-Node: Array Manipulation1172166
-Ref: Array Manipulation-Footnote-11173265
-Node: Array Data Types1173302
-Ref: Array Data Types-Footnote-11176120
-Node: Array Functions1176216
-Node: Flattening Arrays1181245
-Node: Creating Arrays1188293
-Node: Redirection API1193135
-Node: Extension API Variables1196152
-Node: Extension Versioning1196875
-Ref: gawk-api-version1197304
-Node: Extension GMP/MPFR Versioning1199091
-Node: Extension API Informational Variables1200795
-Node: Extension API Boilerplate1202048
-Node: Changes from API V11206178
-Node: Finding Extensions1207810
-Node: Extension Example1208385
-Node: Internal File Description1209207
-Node: Internal File Ops1213499
-Ref: Internal File Ops-Footnote-11225049
-Node: Using Internal File Ops1225197
-Ref: Using Internal File Ops-Footnote-11227628
-Node: Extension Samples1227906
-Node: Extension Sample File Functions1229475
-Node: Extension Sample Fnmatch1237600
-Node: Extension Sample Fork1239195
-Node: Extension Sample Inplace1240471
-Node: Extension Sample Ord1244137
-Node: Extension Sample Readdir1245013
-Ref: table-readdir-file-types1245802
-Node: Extension Sample Revout1247158
-Node: Extension Sample Rev2way1247755
-Node: Extension Sample Read write array1248507
-Node: Extension Sample Readfile1251781
-Node: Extension Sample Time1252912
-Node: Extension Sample API Tests1255200
-Node: gawkextlib1255708
-Node: Extension summary1258740
-Node: Extension Exercises1262588
-Node: Language History1263858
-Node: V7/SVR3.11265570
-Node: SVR41267920
-Node: POSIX1269452
-Node: BTL1270877
-Node: POSIX/GNU1271644
-Node: Feature History1278173
-Node: Common Extensions1297975
-Node: Ranges and Locales1299450
-Ref: Ranges and Locales-Footnote-11304235
-Ref: Ranges and Locales-Footnote-21304262
-Ref: Ranges and Locales-Footnote-31304497
-Node: Contributors1304720
-Node: History summary1310911
-Node: Installation1312353
-Node: Gawk Distribution1313317
-Node: Getting1313809
-Node: Extracting1314808
-Node: Distribution contents1316514
-Node: Unix Installation1324588
-Node: Quick Installation1325408
-Node: Compiling with MPFR1327948
-Node: Shell Startup Files1328654
-Node: Additional Configuration Options1329811
-Node: Configuration Philosophy1332194
-Node: Compiling from Git1334694
-Node: Building the Documentation1335253
-Node: Non-Unix Installation1336665
-Node: PC Installation1337141
-Node: PC Binary Installation1338010
-Node: PC Compiling1338903
-Node: PC Using1340081
-Node: Cygwin1343797
-Node: MSYS1345049
-Node: OpenVMS Installation1345675
-Node: OpenVMS Compilation1346356
-Ref: OpenVMS Compilation-Footnote-11347839
-Node: OpenVMS Dynamic Extensions1347897
-Node: OpenVMS Installation Details1349533
-Node: OpenVMS Running1351964
-Node: OpenVMS GNV1356101
-Node: Bugs1356856
-Node: Bug definition1357776
-Node: Bug address1361377
-Node: Usenet1364946
-Node: Performance bugs1366159
-Node: Asking for help1369175
-Node: Maintainers1371162
-Node: Other Versions1372189
-Node: Installation summary1381488
-Node: Notes1382870
-Node: Compatibility Mode1383680
-Node: Additions1384502
-Node: Accessing The Source1385447
-Node: Adding Code1386978
-Node: New Ports1394089
-Node: Derived Files1398592
-Ref: Derived Files-Footnote-11404403
-Ref: Derived Files-Footnote-21404438
-Ref: Derived Files-Footnote-31405049
-Node: Future Extensions1405163
-Node: Implementation Limitations1405833
-Node: Extension Design1407075
-Node: Old Extension Problems1408235
-Ref: Old Extension Problems-Footnote-11409807
-Node: Extension New Mechanism Goals1409868
-Ref: Extension New Mechanism Goals-Footnote-11413338
-Node: Extension Other Design Decisions1413539
-Node: Extension Future Growth1415736
-Node: Notes summary1416356
-Node: Basic Concepts1417566
-Node: Basic High Level1418251
-Ref: figure-general-flow1418533
-Ref: figure-process-flow1419235
-Ref: Basic High Level-Footnote-11422605
-Node: Basic Data Typing1422794
-Node: Glossary1426202
-Node: Copying1459081
-Node: GNU Free Documentation License1496639
-Node: Index1521762
+Node: Arrays Summary573053
+Node: Functions575240
+Node: Built-in576298
+Node: Calling Built-in577487
+Node: Boolean Functions579527
+Node: Numeric Functions580089
+Ref: Numeric Functions-Footnote-1584274
+Ref: Numeric Functions-Footnote-2584958
+Ref: Numeric Functions-Footnote-3585010
+Node: String Functions585286
+Ref: String Functions-Footnote-1611737
+Ref: String Functions-Footnote-2611869
+Ref: String Functions-Footnote-3612125
+Node: Gory Details612212
+Ref: table-sub-escapes614221
+Ref: table-sub-proposed615852
+Ref: table-posix-sub617347
+Ref: table-gensub-escapes619020
+Ref: Gory Details-Footnote-1619939
+Node: I/O Functions620093
+Ref: table-system-return-values626769
+Ref: I/O Functions-Footnote-1628931
+Ref: I/O Functions-Footnote-2629079
+Node: Time Functions629199
+Ref: Time Functions-Footnote-1640281
+Ref: Time Functions-Footnote-2640349
+Ref: Time Functions-Footnote-3640511
+Ref: Time Functions-Footnote-4640622
+Ref: Time Functions-Footnote-5640738
+Ref: Time Functions-Footnote-6640965
+Node: Bitwise Functions641243
+Ref: table-bitwise-ops641841
+Ref: Bitwise Functions-Footnote-1648083
+Ref: Bitwise Functions-Footnote-2648260
+Node: Type Functions648455
+Node: I18N Functions652048
+Node: User-defined653783
+Node: Definition Syntax654603
+Ref: Definition Syntax-Footnote-1660421
+Node: Function Example660496
+Ref: Function Example-Footnote-1663475
+Node: Function Calling663497
+Node: Calling A Function664089
+Node: Variable Scope665059
+Node: Pass By Value/Reference668113
+Node: Function Caveats670841
+Ref: Function Caveats-Footnote-1672932
+Node: Return Statement673052
+Node: Dynamic Typing676107
+Node: Indirect Calls678489
+Node: Functions Summary689624
+Node: Library Functions692393
+Ref: Library Functions-Footnote-1695941
+Ref: Library Functions-Footnote-2696084
+Node: Library Names696259
+Ref: Library Names-Footnote-1700030
+Ref: Library Names-Footnote-2700257
+Node: General Functions700351
+Node: Strtonum Function701621
+Node: Assert Function704703
+Node: Round Function708153
+Node: Cliff Random Function709725
+Node: Ordinal Functions710749
+Ref: Ordinal Functions-Footnote-1713852
+Ref: Ordinal Functions-Footnote-2714104
+Node: Join Function714318
+Ref: Join Function-Footnote-1716116
+Node: Getlocaltime Function716320
+Node: Readfile Function720094
+Node: Shell Quoting722123
+Node: Isnumeric Function723579
+Node: To CSV Function725015
+Node: Data File Management727089
+Node: Filetrans Function727721
+Node: Rewind Function731997
+Node: File Checking733968
+Ref: File Checking-Footnote-1735334
+Node: Empty Files735539
+Node: Ignoring Assigns737602
+Node: Getopt Function739176
+Ref: Getopt Function-Footnote-1754994
+Node: Passwd Functions755206
+Ref: Passwd Functions-Footnote-1764341
+Node: Group Functions764429
+Ref: Group Functions-Footnote-1772553
+Node: Walking Arrays772764
+Node: Library Functions Summary775810
+Node: Library Exercises777230
+Node: Sample Programs777715
+Node: Running Examples778497
+Node: Clones779249
+Node: Cut Program780517
+Node: Egrep Program790941
+Node: Id Program800246
+Node: Split Program810338
+Ref: Split Program-Footnote-1820551
+Node: Tee Program820736
+Node: Uniq Program823642
+Node: Wc Program831502
+Node: Bytes vs. Characters831897
+Node: Using extensions833497
+Node: wc program834275
+Node: Miscellaneous Programs839268
+Node: Dupword Program840493
+Node: Alarm Program842542
+Node: Translate Program847445
+Ref: Translate Program-Footnote-1852154
+Node: Labels Program852432
+Ref: Labels Program-Footnote-1855867
+Node: Word Sorting855951
+Node: History Sorting860125
+Node: Extract Program862398
+Node: Simple Sed870653
+Node: Igawk Program873863
+Ref: Igawk Program-Footnote-1889064
+Ref: Igawk Program-Footnote-2889270
+Ref: Igawk Program-Footnote-3889400
+Node: Anagram Program889527
+Node: Signature Program892613
+Node: Programs Summary893863
+Node: Programs Exercises895117
+Ref: Programs Exercises-Footnote-1899419
+Node: Advanced Features899505
+Node: Nondecimal Data901986
+Node: Boolean Typed Values903616
+Node: Array Sorting905573
+Node: Controlling Array Traversal906302
+Ref: Controlling Array Traversal-Footnote-1914805
+Node: Array Sorting Functions914927
+Ref: Array Sorting Functions-Footnote-1921024
+Node: Two-way I/O921232
+Ref: Two-way I/O-Footnote-1929203
+Ref: Two-way I/O-Footnote-2929394
+Node: TCP/IP Networking929476
+Node: Profiling932644
+Node: Persistent Memory942314
+Ref: Persistent Memory-Footnote-1951886
+Node: Extension Philosophy952017
+Node: Advanced Features Summary953544
+Node: Internationalization955810
+Node: I18N and L10N957512
+Node: Explaining gettext958207
+Ref: Explaining gettext-Footnote-1964343
+Ref: Explaining gettext-Footnote-2964536
+Node: Programmer i18n964701
+Ref: Programmer i18n-Footnote-1969806
+Node: Translator i18n969855
+Node: String Extraction970685
+Ref: String Extraction-Footnote-1971861
+Node: Printf Ordering971959
+Ref: Printf Ordering-Footnote-1974817
+Node: I18N Portability974885
+Ref: I18N Portability-Footnote-1977445
+Node: I18N Example977512
+Ref: I18N Example-Footnote-1980906
+Ref: I18N Example-Footnote-2980979
+Node: Gawk I18N981096
+Node: I18N Summary981750
+Node: Debugger983147
+Node: Debugging984167
+Node: Debugging Concepts984616
+Node: Debugging Terms986433
+Node: Awk Debugging989036
+Ref: Awk Debugging-Footnote-1990009
+Node: Sample Debugging Session990145
+Node: Debugger Invocation990695
+Node: Finding The Bug992320
+Node: List of Debugger Commands998952
+Node: Breakpoint Control1000329
+Node: Debugger Execution Control1004151
+Node: Viewing And Changing Data1007625
+Node: Execution Stack1011359
+Node: Debugger Info1013040
+Node: Miscellaneous Debugger Commands1017335
+Node: Readline Support1022576
+Node: Limitations1023520
+Node: Debugging Summary1026144
+Node: Namespaces1027443
+Node: Global Namespace1028570
+Node: Qualified Names1030004
+Node: Default Namespace1031039
+Node: Changing The Namespace1031812
+Node: Naming Rules1033494
+Node: Internal Name Management1035409
+Node: Namespace Example1036479
+Node: Namespace And Features1039056
+Node: Namespace Summary1040511
+Node: Arbitrary Precision Arithmetic1042022
+Node: Computer Arithmetic1043541
+Ref: table-numeric-ranges1047349
+Ref: table-floating-point-ranges1047846
+Ref: Computer Arithmetic-Footnote-11048504
+Node: Math Definitions1048561
+Ref: table-ieee-formats1051593
+Node: MPFR features1052166
+Node: MPFR On Parole1052619
+Ref: MPFR On Parole-Footnote-11053460
+Node: MPFR Intro1053619
+Node: FP Math Caution1055303
+Ref: FP Math Caution-Footnote-11056375
+Node: Inexactness of computations1056748
+Node: Inexact representation1057779
+Node: Comparing FP Values1059160
+Node: Errors accumulate1060418
+Node: Strange values1061883
+Ref: Strange values-Footnote-11064537
+Node: Getting Accuracy1064642
+Node: Try To Round1067379
+Node: Setting precision1068286
+Ref: table-predefined-precision-strings1068991
+Node: Setting the rounding mode1070875
+Ref: table-gawk-rounding-modes1071257
+Ref: Setting the rounding mode-Footnote-11075309
+Node: Arbitrary Precision Integers1075492
+Ref: Arbitrary Precision Integers-Footnote-11078702
+Node: Checking for MPFR1078855
+Node: POSIX Floating Point Problems1080345
+Ref: POSIX Floating Point Problems-Footnote-11085165
+Node: Floating point summary1085203
+Node: Dynamic Extensions1087459
+Node: Extension Intro1089056
+Node: Plugin License1090358
+Node: Extension Mechanism Outline1091171
+Ref: figure-load-extension1091622
+Ref: figure-register-new-function1093200
+Ref: figure-call-new-function1094309
+Node: Extension API Description1096424
+Node: Extension API Functions Introduction1098153
+Ref: table-api-std-headers1100047
+Node: General Data Types1104488
+Ref: General Data Types-Footnote-11113634
+Node: Memory Allocation Functions1113937
+Ref: Memory Allocation Functions-Footnote-11118654
+Node: Constructor Functions1118753
+Node: API Ownership of MPFR and GMP Values1122654
+Node: Registration Functions1124207
+Node: Extension Functions1124911
+Node: Exit Callback Functions1130485
+Node: Extension Version String1131799
+Node: Input Parsers1132494
+Node: Output Wrappers1147113
+Node: Two-way processors1151955
+Node: Printing Messages1154308
+Ref: Printing Messages-Footnote-11155519
+Node: Updating ERRNO1155672
+Node: Requesting Values1156471
+Ref: table-value-types-returned1157224
+Node: Accessing Parameters1158332
+Node: Symbol Table Access1159613
+Node: Symbol table by name1160125
+Ref: Symbol table by name-Footnote-11163326
+Node: Symbol table by cookie1163458
+Ref: Symbol table by cookie-Footnote-11167727
+Node: Cached values1167791
+Ref: Cached values-Footnote-11171423
+Node: Array Manipulation1171580
+Ref: Array Manipulation-Footnote-11172679
+Node: Array Data Types1172716
+Ref: Array Data Types-Footnote-11175534
+Node: Array Functions1175630
+Node: Flattening Arrays1180659
+Node: Creating Arrays1187707
+Node: Redirection API1192549
+Node: Extension API Variables1195566
+Node: Extension Versioning1196289
+Ref: gawk-api-version1196718
+Node: Extension GMP/MPFR Versioning1198505
+Node: Extension API Informational Variables1200209
+Node: Extension API Boilerplate1201462
+Node: Changes from API V11205592
+Node: Finding Extensions1207224
+Node: Extension Example1207799
+Node: Internal File Description1208621
+Node: Internal File Ops1212913
+Ref: Internal File Ops-Footnote-11224463
+Node: Using Internal File Ops1224611
+Ref: Using Internal File Ops-Footnote-11227042
+Node: Extension Samples1227320
+Node: Extension Sample File Functions1228889
+Node: Extension Sample Fnmatch1237014
+Node: Extension Sample Fork1238609
+Node: Extension Sample Inplace1239885
+Node: Extension Sample Ord1243551
+Node: Extension Sample Readdir1244427
+Ref: table-readdir-file-types1245216
+Node: Extension Sample Revout1246572
+Node: Extension Sample Rev2way1247169
+Node: Extension Sample Read write array1247921
+Node: Extension Sample Readfile1251195
+Node: Extension Sample Time1252326
+Node: Extension Sample API Tests1254614
+Node: gawkextlib1255122
+Node: Extension summary1258154
+Node: Extension Exercises1262002
+Node: Language History1263272
+Node: V7/SVR3.11264984
+Node: SVR41267334
+Node: POSIX1268866
+Node: BTL1270291
+Node: POSIX/GNU1271058
+Node: Feature History1277587
+Node: Common Extensions1297389
+Node: Ranges and Locales1298864
+Ref: Ranges and Locales-Footnote-11303649
+Ref: Ranges and Locales-Footnote-21303676
+Ref: Ranges and Locales-Footnote-31303911
+Node: Contributors1304134
+Node: History summary1310325
+Node: Installation1311767
+Node: Gawk Distribution1312731
+Node: Getting1313223
+Node: Extracting1314222
+Node: Distribution contents1315928
+Node: Unix Installation1324002
+Node: Quick Installation1324822
+Node: Compiling with MPFR1327362
+Node: Shell Startup Files1328068
+Node: Additional Configuration Options1329225
+Node: Configuration Philosophy1331608
+Node: Compiling from Git1334108
+Node: Building the Documentation1334667
+Node: Non-Unix Installation1336079
+Node: PC Installation1336555
+Node: PC Binary Installation1337424
+Node: PC Compiling1338317
+Node: PC Using1339495
+Node: Cygwin1343211
+Node: MSYS1344463
+Node: OpenVMS Installation1345089
+Node: OpenVMS Compilation1345770
+Ref: OpenVMS Compilation-Footnote-11347253
+Node: OpenVMS Dynamic Extensions1347311
+Node: OpenVMS Installation Details1348947
+Node: OpenVMS Running1351378
+Node: OpenVMS GNV1355515
+Node: Bugs1356270
+Node: Bug definition1357190
+Node: Bug address1360791
+Node: Usenet1364360
+Node: Performance bugs1365573
+Node: Asking for help1368589
+Node: Maintainers1370576
+Node: Other Versions1371603
+Node: Installation summary1380902
+Node: Notes1382284
+Node: Compatibility Mode1383094
+Node: Additions1383916
+Node: Accessing The Source1384861
+Node: Adding Code1386392
+Node: New Ports1393503
+Node: Derived Files1398006
+Ref: Derived Files-Footnote-11403817
+Ref: Derived Files-Footnote-21403852
+Ref: Derived Files-Footnote-31404463
+Node: Future Extensions1404577
+Node: Implementation Limitations1405247
+Node: Extension Design1406489
+Node: Old Extension Problems1407649
+Ref: Old Extension Problems-Footnote-11409221
+Node: Extension New Mechanism Goals1409282
+Ref: Extension New Mechanism Goals-Footnote-11412752
+Node: Extension Other Design Decisions1412953
+Node: Extension Future Growth1415150
+Node: Notes summary1415770
+Node: Basic Concepts1416980
+Node: Basic High Level1417665
+Ref: figure-general-flow1417947
+Ref: figure-process-flow1418649
+Ref: Basic High Level-Footnote-11422019
+Node: Basic Data Typing1422208
+Node: Glossary1425616
+Node: Copying1458495
+Node: GNU Free Documentation License1496053
+Node: Index1521176
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 6f8e26bd..75bcb4a7 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -17860,24 +17860,6 @@ for (i in a) @{
 @xref{Walking Arrays} for a user-defined function that ``walks'' an
 arbitrarily dimensioned array of arrays.
-Recall that a reference to an uninitialized array element yields a value
-of @code{""}, the null string. This has one important implication when you
-intend to use a subarray as an argument to a function, as illustrated by
-the following example:
-$ @kbd{gawk 'BEGIN @{ split("a b c d", b[1]); print b[1][1] @}'}
-@error{} gawk: cmd. line:1: fatal: split: second argument is not an array
-@end example
-The way to work around this is to first force @code{b[1]} to be an array by
-creating an arbitrary index:
-$ @kbd{gawk 'BEGIN @{ b[1][1] = ""; split("a b c d", b[1]); print b[1][1] @}'}
-@print{} a
-@end example
 @node Arrays Summary
 @section Summary


Summary of changes:
 doc/ChangeLog |   7 +
 doc/ | 762 ++++++++++++++++++++++++++++------------------------------
 doc/gawk.texi |  18 --
 3 files changed, 381 insertions(+), 406 deletions(-)


reply via email to

[Prev in Thread] Current Thread [Next in Thread]