Add info to ChangeLog. Update doc some more.

4 files changed, 330 insertions, 318 deletions

diff --git a/ChangeLog b/ChangeLog
index deef7012..59eff5c8 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,7 @@
+2016-03-10         Arnold D. Robbins     <arnold@skeeve.com>
+
+	* builtin.c (do_system): Improve return values of system().
+
 2016-03-08         Arnold D. Robbins     <arnold@skeeve.com>
 
 	* profile.c (print_instruction): Fix duplicate case not caught
diff --git a/doc/gawk.info b/doc/gawk.info
index 0a56ebd6..f18229bc 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -12811,12 +12811,12 @@ parameters are enclosed in square brackets ([ ]):
      Traditionally, 'awk''s 'system()' function has simply returned the
      exit status value divided by 256.  In the normal case this gives
      the exit status but in the case of death-by-signal it yields a
-     fractional floating-point value.  POSIX states that 'awk''s
+     fractional floating-point value.(2)  POSIX states that 'awk''s
      'system()' should return the full 16-bit value.
 
      'gawk' steers a middle ground.  By default, it returns just the
      exit status.  The '--traditional' option causes 'gawk' to divide
-     the return vaue by 356, just as Brian Kernighan's 'awk' does.  With
+     the return vaue by 256, just as Brian Kernighan's 'awk' does.  With
      '--posix', it returns the full 16-bit value.
 
      If the process was killed by a signal, 'gawk''s 'system()' returns
@@ -12876,6 +12876,9 @@ would see the latter (undesirable) output.
 terminal device.  On modern systems, this means your keyboard and
 screen.
 
+   (2) In private correspondance, Dr. Kernighan has indicated to me that
+the way this was done was probably a mistake.
+
 
 File: gawk.info,  Node: Time Functions,  Next: Bitwise Functions,  Prev: I/O Functions,  Up: Built-in
 
@@ -34899,317 +34902,318 @@ Ref: table-posix-sub537317
 Ref: table-gensub-escapes538858
 Ref: Gory Details-Footnote-1539681
 Node: I/O Functions539832
-Ref: I/O Functions-Footnote-1548337
-Node: Time Functions548485
-Ref: Time Functions-Footnote-1558990
-Ref: Time Functions-Footnote-2559058
-Ref: Time Functions-Footnote-3559216
-Ref: Time Functions-Footnote-4559327
-Ref: Time Functions-Footnote-5559439
-Ref: Time Functions-Footnote-6559666
-Node: Bitwise Functions559932
-Ref: table-bitwise-ops560526
-Ref: Bitwise Functions-Footnote-1564864
-Node: Type Functions565037
-Node: I18N Functions566193
-Node: User-defined567844
-Node: Definition Syntax568649
-Ref: Definition Syntax-Footnote-1574336
-Node: Function Example574407
-Ref: Function Example-Footnote-1577329
-Node: Function Caveats577351
-Node: Calling A Function577869
-Node: Variable Scope578827
-Node: Pass By Value/Reference581821
-Node: Return Statement585320
-Node: Dynamic Typing588299
-Node: Indirect Calls589229
-Ref: Indirect Calls-Footnote-1599480
-Node: Functions Summary599608
-Node: Library Functions602313
-Ref: Library Functions-Footnote-1605920
-Ref: Library Functions-Footnote-2606063
-Node: Library Names606234
-Ref: Library Names-Footnote-1609694
-Ref: Library Names-Footnote-2609917
-Node: General Functions610003
-Node: Strtonum Function611106
-Node: Assert Function614128
-Node: Round Function617454
-Node: Cliff Random Function618995
-Node: Ordinal Functions620011
-Ref: Ordinal Functions-Footnote-1623074
-Ref: Ordinal Functions-Footnote-2623326
-Node: Join Function623536
-Ref: Join Function-Footnote-1625306
-Node: Getlocaltime Function625506
-Node: Readfile Function629248
-Node: Shell Quoting631220
-Node: Data File Management632621
-Node: Filetrans Function633253
-Node: Rewind Function637349
-Node: File Checking639254
-Ref: File Checking-Footnote-1640588
-Node: Empty Files640789
-Node: Ignoring Assigns642768
-Node: Getopt Function644318
-Ref: Getopt Function-Footnote-1655787
-Node: Passwd Functions655987
-Ref: Passwd Functions-Footnote-1664826
-Node: Group Functions664914
-Ref: Group Functions-Footnote-1672811
-Node: Walking Arrays673018
-Node: Library Functions Summary676026
-Node: Library Exercises677432
-Node: Sample Programs677897
-Node: Running Examples678667
-Node: Clones679395
-Node: Cut Program680619
-Node: Egrep Program690548
-Ref: Egrep Program-Footnote-1698060
-Node: Id Program698170
-Node: Split Program701850
-Ref: Split Program-Footnote-1705309
-Node: Tee Program705438
-Node: Uniq Program708228
-Node: Wc Program715654
-Ref: Wc Program-Footnote-1719909
-Node: Miscellaneous Programs720003
-Node: Dupword Program721216
-Node: Alarm Program723246
-Node: Translate Program728101
-Ref: Translate Program-Footnote-1732666
-Node: Labels Program732936
-Ref: Labels Program-Footnote-1736287
-Node: Word Sorting736371
-Node: History Sorting740443
-Node: Extract Program742278
-Node: Simple Sed749807
-Node: Igawk Program752881
-Ref: Igawk Program-Footnote-1767212
-Ref: Igawk Program-Footnote-2767414
-Ref: Igawk Program-Footnote-3767536
-Node: Anagram Program767651
-Node: Signature Program770713
-Node: Programs Summary771960
-Node: Programs Exercises773174
-Ref: Programs Exercises-Footnote-1777303
-Node: Advanced Features777394
-Node: Nondecimal Data779384
-Node: Array Sorting780975
-Node: Controlling Array Traversal781675
-Ref: Controlling Array Traversal-Footnote-1790042
-Node: Array Sorting Functions790160
-Ref: Array Sorting Functions-Footnote-1795251
-Node: Two-way I/O795447
-Ref: Two-way I/O-Footnote-1801267
-Ref: Two-way I/O-Footnote-2801454
-Node: TCP/IP Networking801536
-Node: Profiling804654
-Node: Advanced Features Summary812193
-Node: Internationalization814129
-Node: I18N and L10N815609
-Node: Explaining gettext816296
-Ref: Explaining gettext-Footnote-1821319
-Ref: Explaining gettext-Footnote-2821504
-Node: Programmer i18n821669
-Ref: Programmer i18n-Footnote-1826524
-Node: Translator i18n826573
-Node: String Extraction827367
-Ref: String Extraction-Footnote-1828499
-Node: Printf Ordering828585
-Ref: Printf Ordering-Footnote-1831371
-Node: I18N Portability831435
-Ref: I18N Portability-Footnote-1833891
-Node: I18N Example833954
-Ref: I18N Example-Footnote-1836760
-Node: Gawk I18N836833
-Node: I18N Summary837478
-Node: Debugger838819
-Node: Debugging839841
-Node: Debugging Concepts840282
-Node: Debugging Terms842091
-Node: Awk Debugging844666
-Node: Sample Debugging Session845572
-Node: Debugger Invocation846106
-Node: Finding The Bug847492
-Node: List of Debugger Commands853970
-Node: Breakpoint Control855303
-Node: Debugger Execution Control858997
-Node: Viewing And Changing Data862359
-Node: Execution Stack865733
-Node: Debugger Info867370
-Node: Miscellaneous Debugger Commands871441
-Node: Readline Support876529
-Node: Limitations877425
-Node: Debugging Summary879534
-Node: Arbitrary Precision Arithmetic880707
-Node: Computer Arithmetic882123
-Ref: table-numeric-ranges885714
-Ref: Computer Arithmetic-Footnote-1886436
-Node: Math Definitions886493
-Ref: table-ieee-formats889807
-Ref: Math Definitions-Footnote-1890410
-Node: MPFR features890515
-Node: FP Math Caution892232
-Ref: FP Math Caution-Footnote-1893304
-Node: Inexactness of computations893673
-Node: Inexact representation894633
-Node: Comparing FP Values895993
-Node: Errors accumulate897075
-Node: Getting Accuracy898508
-Node: Try To Round901218
-Node: Setting precision902117
-Ref: table-predefined-precision-strings902814
-Node: Setting the rounding mode904644
-Ref: table-gawk-rounding-modes905018
-Ref: Setting the rounding mode-Footnote-1908426
-Node: Arbitrary Precision Integers908605
-Ref: Arbitrary Precision Integers-Footnote-1911589
-Node: POSIX Floating Point Problems911738
-Ref: POSIX Floating Point Problems-Footnote-1915620
-Node: Floating point summary915658
-Node: Dynamic Extensions917848
-Node: Extension Intro919401
-Node: Plugin License920667
-Node: Extension Mechanism Outline921464
-Ref: figure-load-extension921903
-Ref: figure-register-new-function923468
-Ref: figure-call-new-function924560
-Node: Extension API Description926622
-Node: Extension API Functions Introduction928070
-Node: General Data Types932882
-Ref: General Data Types-Footnote-1938837
-Node: Memory Allocation Functions939136
-Ref: Memory Allocation Functions-Footnote-1941981
-Node: Constructor Functions942080
-Node: Registration Functions943825
-Node: Extension Functions944510
-Node: Exit Callback Functions946809
-Node: Extension Version String948059
-Node: Input Parsers948722
-Node: Output Wrappers958607
-Node: Two-way processors963119
-Node: Printing Messages965383
-Ref: Printing Messages-Footnote-1966457
-Node: Updating ERRNO966610
-Node: Requesting Values967349
-Ref: table-value-types-returned968086
-Node: Accessing Parameters968969
-Node: Symbol Table Access970204
-Node: Symbol table by name970716
-Node: Symbol table by cookie972737
-Ref: Symbol table by cookie-Footnote-1976886
-Node: Cached values976950
-Ref: Cached values-Footnote-1980451
-Node: Array Manipulation980542
-Ref: Array Manipulation-Footnote-1981641
-Node: Array Data Types981678
-Ref: Array Data Types-Footnote-1984336
-Node: Array Functions984428
-Node: Flattening Arrays988286
-Node: Creating Arrays995194
-Node: Extension API Variables999965
-Node: Extension Versioning1000601
-Node: Extension API Informational Variables1002492
-Node: Extension API Boilerplate1003556
-Node: Finding Extensions1007370
-Node: Extension Example1007929
-Node: Internal File Description1008727
-Node: Internal File Ops1012807
-Ref: Internal File Ops-Footnote-11024569
-Node: Using Internal File Ops1024709
-Ref: Using Internal File Ops-Footnote-11027092
-Node: Extension Samples1027366
-Node: Extension Sample File Functions1028895
-Node: Extension Sample Fnmatch1036544
-Node: Extension Sample Fork1038031
-Node: Extension Sample Inplace1039249
-Node: Extension Sample Ord1042459
-Node: Extension Sample Readdir1043295
-Ref: table-readdir-file-types1044184
-Node: Extension Sample Revout1044989
-Node: Extension Sample Rev2way1045578
-Node: Extension Sample Read write array1046318
-Node: Extension Sample Readfile1048260
-Node: Extension Sample Time1049355
-Node: Extension Sample API Tests1050703
-Node: gawkextlib1051195
-Node: Extension summary1053619
-Node: Extension Exercises1057311
-Node: Language History1058808
-Node: V7/SVR3.11060464
-Node: SVR41062616
-Node: POSIX1064050
-Node: BTL1065429
-Node: POSIX/GNU1066158
-Node: Feature History1071679
-Node: Common Extensions1085008
-Node: Ranges and Locales1086291
-Ref: Ranges and Locales-Footnote-11090907
-Ref: Ranges and Locales-Footnote-21090934
-Ref: Ranges and Locales-Footnote-31091169
-Node: Contributors1091390
-Node: History summary1096959
-Node: Installation1098339
-Node: Gawk Distribution1099283
-Node: Getting1099767
-Node: Extracting1100728
-Node: Distribution contents1102366
-Node: Unix Installation1108117
-Node: Quick Installation1108733
-Node: Additional Configuration Options1111160
-Node: Configuration Philosophy1112964
-Node: Non-Unix Installation1115333
-Node: PC Installation1115791
-Node: PC Binary Installation1117111
-Node: PC Compiling1118963
-Ref: PC Compiling-Footnote-11121987
-Node: PC Testing1122096
-Node: PC Using1123276
-Node: Cygwin1127390
-Node: MSYS1128160
-Node: VMS Installation1128661
-Node: VMS Compilation1129452
-Ref: VMS Compilation-Footnote-11130681
-Node: VMS Dynamic Extensions1130739
-Node: VMS Installation Details1132424
-Node: VMS Running1134677
-Node: VMS GNV1138956
-Node: VMS Old Gawk1139691
-Node: Bugs1140162
-Node: Other Versions1144359
-Node: Installation summary1150943
-Node: Notes1152001
-Node: Compatibility Mode1152866
-Node: Additions1153648
-Node: Accessing The Source1154573
-Node: Adding Code1156008
-Node: New Ports1162227
-Node: Derived Files1166715
-Ref: Derived Files-Footnote-11172200
-Ref: Derived Files-Footnote-21172235
-Ref: Derived Files-Footnote-31172833
-Node: Future Extensions1172947
-Node: Implementation Limitations1173605
-Node: Extension Design1174788
-Node: Old Extension Problems1175942
-Ref: Old Extension Problems-Footnote-11177460
-Node: Extension New Mechanism Goals1177517
-Ref: Extension New Mechanism Goals-Footnote-11180881
-Node: Extension Other Design Decisions1181070
-Node: Extension Future Growth1183183
-Node: Old Extension Mechanism1184019
-Node: Notes summary1185782
-Node: Basic Concepts1186964
-Node: Basic High Level1187645
-Ref: figure-general-flow1187927
-Ref: figure-process-flow1188612
-Ref: Basic High Level-Footnote-11191913
-Node: Basic Data Typing1192098
-Node: Glossary1195426
-Node: Copying1227372
-Node: GNU Free Documentation License1264911
-Node: Index1290029
+Ref: I/O Functions-Footnote-1548340
+Ref: I/O Functions-Footnote-2548488
+Node: Time Functions548608
+Ref: Time Functions-Footnote-1559113
+Ref: Time Functions-Footnote-2559181
+Ref: Time Functions-Footnote-3559339
+Ref: Time Functions-Footnote-4559450
+Ref: Time Functions-Footnote-5559562
+Ref: Time Functions-Footnote-6559789
+Node: Bitwise Functions560055
+Ref: table-bitwise-ops560649
+Ref: Bitwise Functions-Footnote-1564987
+Node: Type Functions565160
+Node: I18N Functions566316
+Node: User-defined567967
+Node: Definition Syntax568772
+Ref: Definition Syntax-Footnote-1574459
+Node: Function Example574530
+Ref: Function Example-Footnote-1577452
+Node: Function Caveats577474
+Node: Calling A Function577992
+Node: Variable Scope578950
+Node: Pass By Value/Reference581944
+Node: Return Statement585443
+Node: Dynamic Typing588422
+Node: Indirect Calls589352
+Ref: Indirect Calls-Footnote-1599603
+Node: Functions Summary599731
+Node: Library Functions602436
+Ref: Library Functions-Footnote-1606043
+Ref: Library Functions-Footnote-2606186
+Node: Library Names606357
+Ref: Library Names-Footnote-1609817
+Ref: Library Names-Footnote-2610040
+Node: General Functions610126
+Node: Strtonum Function611229
+Node: Assert Function614251
+Node: Round Function617577
+Node: Cliff Random Function619118
+Node: Ordinal Functions620134
+Ref: Ordinal Functions-Footnote-1623197
+Ref: Ordinal Functions-Footnote-2623449
+Node: Join Function623659
+Ref: Join Function-Footnote-1625429
+Node: Getlocaltime Function625629
+Node: Readfile Function629371
+Node: Shell Quoting631343
+Node: Data File Management632744
+Node: Filetrans Function633376
+Node: Rewind Function637472
+Node: File Checking639377
+Ref: File Checking-Footnote-1640711
+Node: Empty Files640912
+Node: Ignoring Assigns642891
+Node: Getopt Function644441
+Ref: Getopt Function-Footnote-1655910
+Node: Passwd Functions656110
+Ref: Passwd Functions-Footnote-1664949
+Node: Group Functions665037
+Ref: Group Functions-Footnote-1672934
+Node: Walking Arrays673141
+Node: Library Functions Summary676149
+Node: Library Exercises677555
+Node: Sample Programs678020
+Node: Running Examples678790
+Node: Clones679518
+Node: Cut Program680742
+Node: Egrep Program690671
+Ref: Egrep Program-Footnote-1698183
+Node: Id Program698293
+Node: Split Program701973
+Ref: Split Program-Footnote-1705432
+Node: Tee Program705561
+Node: Uniq Program708351
+Node: Wc Program715777
+Ref: Wc Program-Footnote-1720032
+Node: Miscellaneous Programs720126
+Node: Dupword Program721339
+Node: Alarm Program723369
+Node: Translate Program728224
+Ref: Translate Program-Footnote-1732789
+Node: Labels Program733059
+Ref: Labels Program-Footnote-1736410
+Node: Word Sorting736494
+Node: History Sorting740566
+Node: Extract Program742401
+Node: Simple Sed749930
+Node: Igawk Program753004
+Ref: Igawk Program-Footnote-1767335
+Ref: Igawk Program-Footnote-2767537
+Ref: Igawk Program-Footnote-3767659
+Node: Anagram Program767774
+Node: Signature Program770836
+Node: Programs Summary772083
+Node: Programs Exercises773297
+Ref: Programs Exercises-Footnote-1777426
+Node: Advanced Features777517
+Node: Nondecimal Data779507
+Node: Array Sorting781098
+Node: Controlling Array Traversal781798
+Ref: Controlling Array Traversal-Footnote-1790165
+Node: Array Sorting Functions790283
+Ref: Array Sorting Functions-Footnote-1795374
+Node: Two-way I/O795570
+Ref: Two-way I/O-Footnote-1801390
+Ref: Two-way I/O-Footnote-2801577
+Node: TCP/IP Networking801659
+Node: Profiling804777
+Node: Advanced Features Summary812316
+Node: Internationalization814252
+Node: I18N and L10N815732
+Node: Explaining gettext816419
+Ref: Explaining gettext-Footnote-1821442
+Ref: Explaining gettext-Footnote-2821627
+Node: Programmer i18n821792
+Ref: Programmer i18n-Footnote-1826647
+Node: Translator i18n826696
+Node: String Extraction827490
+Ref: String Extraction-Footnote-1828622
+Node: Printf Ordering828708
+Ref: Printf Ordering-Footnote-1831494
+Node: I18N Portability831558
+Ref: I18N Portability-Footnote-1834014
+Node: I18N Example834077
+Ref: I18N Example-Footnote-1836883
+Node: Gawk I18N836956
+Node: I18N Summary837601
+Node: Debugger838942
+Node: Debugging839964
+Node: Debugging Concepts840405
+Node: Debugging Terms842214
+Node: Awk Debugging844789
+Node: Sample Debugging Session845695
+Node: Debugger Invocation846229
+Node: Finding The Bug847615
+Node: List of Debugger Commands854093
+Node: Breakpoint Control855426
+Node: Debugger Execution Control859120
+Node: Viewing And Changing Data862482
+Node: Execution Stack865856
+Node: Debugger Info867493
+Node: Miscellaneous Debugger Commands871564
+Node: Readline Support876652
+Node: Limitations877548
+Node: Debugging Summary879657
+Node: Arbitrary Precision Arithmetic880830
+Node: Computer Arithmetic882246
+Ref: table-numeric-ranges885837
+Ref: Computer Arithmetic-Footnote-1886559
+Node: Math Definitions886616
+Ref: table-ieee-formats889930
+Ref: Math Definitions-Footnote-1890533
+Node: MPFR features890638
+Node: FP Math Caution892355
+Ref: FP Math Caution-Footnote-1893427
+Node: Inexactness of computations893796
+Node: Inexact representation894756
+Node: Comparing FP Values896116
+Node: Errors accumulate897198
+Node: Getting Accuracy898631
+Node: Try To Round901341
+Node: Setting precision902240
+Ref: table-predefined-precision-strings902937
+Node: Setting the rounding mode904767
+Ref: table-gawk-rounding-modes905141
+Ref: Setting the rounding mode-Footnote-1908549
+Node: Arbitrary Precision Integers908728
+Ref: Arbitrary Precision Integers-Footnote-1911712
+Node: POSIX Floating Point Problems911861
+Ref: POSIX Floating Point Problems-Footnote-1915743
+Node: Floating point summary915781
+Node: Dynamic Extensions917971
+Node: Extension Intro919524
+Node: Plugin License920790
+Node: Extension Mechanism Outline921587
+Ref: figure-load-extension922026
+Ref: figure-register-new-function923591
+Ref: figure-call-new-function924683
+Node: Extension API Description926745
+Node: Extension API Functions Introduction928193
+Node: General Data Types933005
+Ref: General Data Types-Footnote-1938960
+Node: Memory Allocation Functions939259
+Ref: Memory Allocation Functions-Footnote-1942104
+Node: Constructor Functions942203
+Node: Registration Functions943948
+Node: Extension Functions944633
+Node: Exit Callback Functions946932
+Node: Extension Version String948182
+Node: Input Parsers948845
+Node: Output Wrappers958730
+Node: Two-way processors963242
+Node: Printing Messages965506
+Ref: Printing Messages-Footnote-1966580
+Node: Updating ERRNO966733
+Node: Requesting Values967472
+Ref: table-value-types-returned968209
+Node: Accessing Parameters969092
+Node: Symbol Table Access970327
+Node: Symbol table by name970839
+Node: Symbol table by cookie972860
+Ref: Symbol table by cookie-Footnote-1977009
+Node: Cached values977073
+Ref: Cached values-Footnote-1980574
+Node: Array Manipulation980665
+Ref: Array Manipulation-Footnote-1981764
+Node: Array Data Types981801
+Ref: Array Data Types-Footnote-1984459
+Node: Array Functions984551
+Node: Flattening Arrays988409
+Node: Creating Arrays995317
+Node: Extension API Variables1000088
+Node: Extension Versioning1000724
+Node: Extension API Informational Variables1002615
+Node: Extension API Boilerplate1003679
+Node: Finding Extensions1007493
+Node: Extension Example1008052
+Node: Internal File Description1008850
+Node: Internal File Ops1012930
+Ref: Internal File Ops-Footnote-11024692
+Node: Using Internal File Ops1024832
+Ref: Using Internal File Ops-Footnote-11027215
+Node: Extension Samples1027489
+Node: Extension Sample File Functions1029018
+Node: Extension Sample Fnmatch1036667
+Node: Extension Sample Fork1038154
+Node: Extension Sample Inplace1039372
+Node: Extension Sample Ord1042582
+Node: Extension Sample Readdir1043418
+Ref: table-readdir-file-types1044307
+Node: Extension Sample Revout1045112
+Node: Extension Sample Rev2way1045701
+Node: Extension Sample Read write array1046441
+Node: Extension Sample Readfile1048383
+Node: Extension Sample Time1049478
+Node: Extension Sample API Tests1050826
+Node: gawkextlib1051318
+Node: Extension summary1053742
+Node: Extension Exercises1057434
+Node: Language History1058931
+Node: V7/SVR3.11060587
+Node: SVR41062739
+Node: POSIX1064173
+Node: BTL1065552
+Node: POSIX/GNU1066281
+Node: Feature History1071802
+Node: Common Extensions1085131
+Node: Ranges and Locales1086414
+Ref: Ranges and Locales-Footnote-11091030
+Ref: Ranges and Locales-Footnote-21091057
+Ref: Ranges and Locales-Footnote-31091292
+Node: Contributors1091513
+Node: History summary1097082
+Node: Installation1098462
+Node: Gawk Distribution1099406
+Node: Getting1099890
+Node: Extracting1100851
+Node: Distribution contents1102489
+Node: Unix Installation1108240
+Node: Quick Installation1108856
+Node: Additional Configuration Options1111283
+Node: Configuration Philosophy1113087
+Node: Non-Unix Installation1115456
+Node: PC Installation1115914
+Node: PC Binary Installation1117234
+Node: PC Compiling1119086
+Ref: PC Compiling-Footnote-11122110
+Node: PC Testing1122219
+Node: PC Using1123399
+Node: Cygwin1127513
+Node: MSYS1128283
+Node: VMS Installation1128784
+Node: VMS Compilation1129575
+Ref: VMS Compilation-Footnote-11130804
+Node: VMS Dynamic Extensions1130862
+Node: VMS Installation Details1132547
+Node: VMS Running1134800
+Node: VMS GNV1139079
+Node: VMS Old Gawk1139814
+Node: Bugs1140285
+Node: Other Versions1144482
+Node: Installation summary1151066
+Node: Notes1152124
+Node: Compatibility Mode1152989
+Node: Additions1153771
+Node: Accessing The Source1154696
+Node: Adding Code1156131
+Node: New Ports1162350
+Node: Derived Files1166838
+Ref: Derived Files-Footnote-11172323
+Ref: Derived Files-Footnote-21172358
+Ref: Derived Files-Footnote-31172956
+Node: Future Extensions1173070
+Node: Implementation Limitations1173728
+Node: Extension Design1174911
+Node: Old Extension Problems1176065
+Ref: Old Extension Problems-Footnote-11177583
+Node: Extension New Mechanism Goals1177640
+Ref: Extension New Mechanism Goals-Footnote-11181004
+Node: Extension Other Design Decisions1181193
+Node: Extension Future Growth1183306
+Node: Old Extension Mechanism1184142
+Node: Notes summary1185905
+Node: Basic Concepts1187087
+Node: Basic High Level1187768
+Ref: figure-general-flow1188050
+Ref: figure-process-flow1188735
+Ref: Basic High Level-Footnote-11192036
+Node: Basic Data Typing1192221
+Node: Glossary1195549
+Node: Copying1227495
+Node: GNU Free Documentation License1265034
+Node: Index1290152
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 30826891..2c24c8af 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -18385,13 +18385,15 @@ signal (bit 7) and if so, the guilty signal number (bits 0--6).
 Traditionally, @command{awk}'s @code{system()} function has simply
 returned the exit status value divided by 256. In the normal case this
 gives the exit status but in the case of death-by-signal it yields
-a fractional floating-point value. POSIX states that @command{awk}'s
+a fractional floating-point value.@footnote{In private correspondance,
+Dr.@: Kernighan has indicated to me that the way this was done
+was probably a mistake.} POSIX states that @command{awk}'s
 @code{system()} should return the full 16-bit value.
 
 @command{gawk} steers a middle ground.
 By default, it returns just the exit status. The
 @option{--traditional} option causes @command{gawk} to divide
-the return vaue by 356, just as Brian Kernighan's @command{awk} does.
+the return vaue by 256, just as Brian Kernighan's @command{awk} does.
 With @option{--posix}, it returns the full 16-bit value.
 
 If the process was killed by a signal, @command{gawk}'s @code{system()}
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 3831d6ef..c284f848 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -17577,13 +17577,15 @@ signal (bit 7) and if so, the guilty signal number (bits 0--6).
 Traditionally, @command{awk}'s @code{system()} function has simply
 returned the exit status value divided by 256. In the normal case this
 gives the exit status but in the case of death-by-signal it yields
-a fractional floating-point value. POSIX states that @command{awk}'s
+a fractional floating-point value.@footnote{In private correspondance,
+Dr.@: Kernighan has indicated to me that the way this was done
+was probably a mistake.} POSIX states that @command{awk}'s
 @code{system()} should return the full 16-bit value.
 
 @command{gawk} steers a middle ground.
 By default, it returns just the exit status. The
 @option{--traditional} option causes @command{gawk} to divide
-the return vaue by 356, just as Brian Kernighan's @command{awk} does.
+the return vaue by 256, just as Brian Kernighan's @command{awk} does.
 With @option{--posix}, it returns the full 16-bit value.
 
 If the process was killed by a signal, @command{gawk}'s @code{system()}