[gawk-diffs] [SCM] gawk branch, feature/fix-comments, updated. gawk-4.1.0-3513-g55dd6a0

[Arnold Robbins]

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

The branch, feature/fix-comments has been updated
       via  55dd6a0d24a9433e606a23b24650e84b5d3c3678 (commit)
      from  249657989189d3c6a79ab6b1a2990450e7898381 (commit)

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

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

commit 55dd6a0d24a9433e606a23b24650e84b5d3c3678
Author: Arnold D. Robbins <address@hidden>
Date:   Thu Nov 1 20:48:13 2018 +0200

    Doc updates on profiler/pretty printer.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index fb813a7..2bdbc08 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2018-11-01         Arnold D. Robbins     <address@hidden>
+
+       * gawktexi.in (Profiling): Review and update.
+
 2018-10-30         Arnold D. Robbins     <address@hidden>
 
        * gawktexi.in (Arrays of Arrays): Typo fix in code. Thanks to Alto Tom
diff --git a/doc/gawk.info b/doc/gawk.info
index 64f66d6..874816f 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -20759,7 +20759,8 @@ output.  They are as follows:
      structure of the program and the precedence rules.  For example,
      '(3 + 5) * 4' means add three and five, then multiply the total by
      four.  However, '3 + 5 * 4' has no parentheses, and means '3 + (5 *
-     4)'.
+     4)'.  However, explicit parentheses in the source program are
+     retained.
 
    * Parentheses are used around the arguments to 'print' and 'printf'
      only when the 'print' or 'printf' statement is followed by a
@@ -20841,7 +20842,10 @@ without any execution counts.
 profiling, and that created when pretty-printing.  Pretty-printed output
 preserves the original comments that were in the program, although their
 placement may not correspond exactly to their original locations in the
-source code.(1)
+source code.  However, no comments should be lost.  Also, 'gawk' does
+the best it can to preserve the distinction between comments at the end
+of a statement and comments on lines by themselves.  This isn't always
+perfect, though.
 
    However, as a deliberate design decision, profiling output _omits_
 the original program's comments.  This allows you to focus on the
@@ -20861,14 +20865,6 @@ disable 'gawk''s default optimizations.
 constants; if you used an octal or hexadecimal value in your source
 code, it will appear that way in the output.
 
-   ---------- Footnotes ----------
-
-   (1) 'gawk' does the best it can to preserve the distinction between
-comments at the end of a statement and comments on lines by themselves.
-Due to implementation constraints, it does not always do so correctly,
-particularly for 'switch' statements.  The 'gawk' maintainers hope to
-improve this in a subsequent release.
-
 
 File: gawk.info,  Node: Advanced Features Summary,  Prev: Profiling,  Up: 
Advanced Features
 
@@ -34144,7 +34140,7 @@ Index
 * dump debugger command:                 Miscellaneous Debugger Commands.
                                                               (line   9)
 * dupword.awk program:                   Dupword Program.     (line  31)
-* dynamic profiling:                     Profiling.           (line 178)
+* dynamic profiling:                     Profiling.           (line 179)
 * dynamically loaded extensions:         Dynamic Extensions.  (line   6)
 * e debugger command (alias for enable): Breakpoint Control.  (line  73)
 * EBCDIC:                                Ordinal Functions.   (line  45)
@@ -34533,7 +34529,7 @@ Index
 * G., Daniel Richard:                    Acknowledgments.     (line  60)
 * G., Daniel Richard <1>:                Maintainers.         (line  14)
 * Garfinkle, Scott:                      Contributors.        (line  35)
-* gawk program, dynamic profiling:       Profiling.           (line 178)
+* gawk program, dynamic profiling:       Profiling.           (line 179)
 * gawk version:                          Auto-set.            (line 241)
 * gawk, ARGIND variable in:              Other Arguments.     (line  15)
 * gawk, awk and:                         Preface.             (line  21)
@@ -34738,7 +34734,7 @@ Index
 * history expansion, in debugger:        Readline Support.    (line   6)
 * histsort.awk program:                  History Sorting.     (line  25)
 * Hughes, Phil:                          Acknowledgments.     (line  43)
-* HUP signal, for dynamic profiling:     Profiling.           (line 210)
+* HUP signal, for dynamic profiling:     Profiling.           (line 211)
 * hyphen (-), - operator:                Precedence.          (line  51)
 * hyphen (-), - operator <1>:            Precedence.          (line  57)
 * hyphen (-), -- operator:               Increment Ops.       (line  48)
@@ -34820,7 +34816,7 @@ Index
 * installing gawk:                       Installation.        (line   6)
 * instruction tracing, in debugger:      Debugger Info.       (line  90)
 * int:                                   Numeric Functions.   (line  24)
-* INT signal (MS-Windows):               Profiling.           (line 213)
+* INT signal (MS-Windows):               Profiling.           (line 214)
 * integer array indices:                 Numeric Array Subscripts.
                                                               (line  31)
 * integers, arbitrary precision:         Arbitrary Precision Integers.
@@ -34876,7 +34872,7 @@ Index
 * Kernighan, Brian <8>:                  Other Versions.      (line  13)
 * Kernighan, Brian <9>:                  Basic Data Typing.   (line  54)
 * Kernighan, Brian <10>:                 Glossary.            (line 204)
-* kill command, dynamic profiling:       Profiling.           (line 187)
+* kill command, dynamic profiling:       Profiling.           (line 188)
 * Knights, jedi:                         Undocumented.        (line   6)
 * Kwok, Conrad:                          Contributors.        (line  35)
 * l debugger command (alias for list):   Miscellaneous Debugger Commands.
@@ -35390,7 +35386,7 @@ Index
 * PROCINFO, values of sorted_in:         Controlling Scanning.
                                                               (line  26)
 * profiling awk programs:                Profiling.           (line   6)
-* profiling awk programs, dynamically:   Profiling.           (line 178)
+* profiling awk programs, dynamically:   Profiling.           (line 179)
 * program identifiers:                   Auto-set.            (line 193)
 * program, definition of:                Getting Started.     (line  21)
 * programming conventions, --non-decimal-data option: Nondecimal Data.
@@ -35427,7 +35423,7 @@ Index
 * QuikTrim Awk:                          Other Versions.      (line 135)
 * quit debugger command:                 Miscellaneous Debugger Commands.
                                                               (line 100)
-* QUIT signal (MS-Windows):              Profiling.           (line 213)
+* QUIT signal (MS-Windows):              Profiling.           (line 214)
 * quoting in gawk command lines:         Long.                (line  26)
 * quoting in gawk command lines, tricks for: Quoting.         (line  91)
 * quoting, for small awk programs:       Comments.            (line  27)
@@ -35717,15 +35713,15 @@ Index
                                                               (line 130)
 * sidebar, Using \n in Bracket Expressions of Dynamic Regexps: Computed 
Regexps.
                                                               (line  58)
-* SIGHUP signal, for dynamic profiling:  Profiling.           (line 210)
-* SIGINT signal (MS-Windows):            Profiling.           (line 213)
-* signals, HUP/SIGHUP, for profiling:    Profiling.           (line 210)
-* signals, INT/SIGINT (MS-Windows):      Profiling.           (line 213)
-* signals, QUIT/SIGQUIT (MS-Windows):    Profiling.           (line 213)
-* signals, USR1/SIGUSR1, for profiling:  Profiling.           (line 187)
+* SIGHUP signal, for dynamic profiling:  Profiling.           (line 211)
+* SIGINT signal (MS-Windows):            Profiling.           (line 214)
+* signals, HUP/SIGHUP, for profiling:    Profiling.           (line 211)
+* signals, INT/SIGINT (MS-Windows):      Profiling.           (line 214)
+* signals, QUIT/SIGQUIT (MS-Windows):    Profiling.           (line 214)
+* signals, USR1/SIGUSR1, for profiling:  Profiling.           (line 188)
 * signature program:                     Signature Program.   (line   6)
-* SIGQUIT signal (MS-Windows):           Profiling.           (line 213)
-* SIGUSR1 signal, for dynamic profiling: Profiling.           (line 187)
+* SIGQUIT signal (MS-Windows):           Profiling.           (line 214)
+* SIGUSR1 signal, for dynamic profiling: Profiling.           (line 188)
 * silent debugger command:               Debugger Execution Control.
                                                               (line  10)
 * sin:                                   Numeric Functions.   (line  75)
@@ -36005,7 +36001,7 @@ Index
 * user-modifiable variables:             User-modified.       (line   6)
 * users, information about, printing:    Id Program.          (line   6)
 * users, information about, retrieving:  Passwd Functions.    (line  16)
-* USR1 signal, for dynamic profiling:    Profiling.           (line 187)
+* USR1 signal, for dynamic profiling:    Profiling.           (line 188)
 * values, numeric:                       Basic Data Typing.   (line  13)
 * values, string:                        Basic Data Typing.   (line  13)
 * variable assignments and input files:  Other Arguments.     (line  26)
@@ -36473,218 +36469,217 @@ Ref: Two-way I/O-Footnote-1835053
 Ref: Two-way I/O-Footnote-2835240
 Node: TCP/IP Networking835322
 Node: Profiling838440
-Ref: Profiling-Footnote-1847195
-Node: Advanced Features Summary847518
-Node: Internationalization849362
-Node: I18N and L10N850842
-Node: Explaining gettext851529
-Ref: Explaining gettext-Footnote-1857421
-Ref: Explaining gettext-Footnote-2857606
-Node: Programmer i18n857771
-Ref: Programmer i18n-Footnote-1862720
-Node: Translator i18n862769
-Node: String Extraction863563
-Ref: String Extraction-Footnote-1864695
-Node: Printf Ordering864781
-Ref: Printf Ordering-Footnote-1867567
-Node: I18N Portability867631
-Ref: I18N Portability-Footnote-1870087
-Node: I18N Example870150
-Ref: I18N Example-Footnote-1872956
-Node: Gawk I18N873029
-Node: I18N Summary873674
-Node: Debugger875015
-Node: Debugging876038
-Node: Debugging Concepts876479
-Node: Debugging Terms878288
-Node: Awk Debugging880863
-Node: Sample Debugging Session881769
-Node: Debugger Invocation882303
-Node: Finding The Bug883689
-Node: List of Debugger Commands890167
-Node: Breakpoint Control891500
-Node: Debugger Execution Control895194
-Node: Viewing And Changing Data898556
-Node: Execution Stack901930
-Node: Debugger Info903567
-Node: Miscellaneous Debugger Commands907638
-Node: Readline Support912700
-Node: Limitations913596
-Node: Debugging Summary915705
-Node: Arbitrary Precision Arithmetic916984
-Node: Computer Arithmetic918469
-Ref: table-numeric-ranges922235
-Ref: table-floating-point-ranges922728
-Ref: Computer Arithmetic-Footnote-1923386
-Node: Math Definitions923443
-Ref: table-ieee-formats926759
-Ref: Math Definitions-Footnote-1927362
-Node: MPFR features927467
-Node: FP Math Caution929185
-Ref: FP Math Caution-Footnote-1930257
-Node: Inexactness of computations930626
-Node: Inexact representation931586
-Node: Comparing FP Values932946
-Node: Errors accumulate934187
-Node: Getting Accuracy935620
-Node: Try To Round938330
-Node: Setting precision939229
-Ref: table-predefined-precision-strings939926
-Node: Setting the rounding mode941756
-Ref: table-gawk-rounding-modes942130
-Ref: Setting the rounding mode-Footnote-1946061
-Node: Arbitrary Precision Integers946240
-Ref: Arbitrary Precision Integers-Footnote-1949415
-Node: Checking for MPFR949564
-Node: POSIX Floating Point Problems951038
-Ref: POSIX Floating Point Problems-Footnote-1955323
-Node: Floating point summary955361
-Node: Dynamic Extensions957551
-Node: Extension Intro959104
-Node: Plugin License960370
-Node: Extension Mechanism Outline961167
-Ref: figure-load-extension961606
-Ref: figure-register-new-function963171
-Ref: figure-call-new-function964263
-Node: Extension API Description966325
-Node: Extension API Functions Introduction967967
-Node: General Data Types973507
-Ref: General Data Types-Footnote-1981868
-Node: Memory Allocation Functions982167
-Ref: Memory Allocation Functions-Footnote-1986377
-Node: Constructor Functions986476
-Node: Registration Functions990062
-Node: Extension Functions990747
-Node: Exit Callback Functions995962
-Node: Extension Version String997212
-Node: Input Parsers997875
-Node: Output Wrappers1010596
-Node: Two-way processors1015108
-Node: Printing Messages1017373
-Ref: Printing Messages-Footnote-11018544
-Node: Updating ERRNO1018697
-Node: Requesting Values1019436
-Ref: table-value-types-returned1020173
-Node: Accessing Parameters1021109
-Node: Symbol Table Access1022344
-Node: Symbol table by name1022856
-Node: Symbol table by cookie1024645
-Ref: Symbol table by cookie-Footnote-11028830
-Node: Cached values1028894
-Ref: Cached values-Footnote-11032430
-Node: Array Manipulation1032583
-Ref: Array Manipulation-Footnote-11033674
-Node: Array Data Types1033711
-Ref: Array Data Types-Footnote-11036369
-Node: Array Functions1036461
-Node: Flattening Arrays1040959
-Node: Creating Arrays1047935
-Node: Redirection API1052702
-Node: Extension API Variables1055535
-Node: Extension Versioning1056246
-Ref: gawk-api-version1056675
-Node: Extension GMP/MPFR Versioning1058406
-Node: Extension API Informational Variables1060034
-Node: Extension API Boilerplate1061107
-Node: Changes from API V11065081
-Node: Finding Extensions1066653
-Node: Extension Example1067212
-Node: Internal File Description1068010
-Node: Internal File Ops1072090
-Ref: Internal File Ops-Footnote-11083440
-Node: Using Internal File Ops1083580
-Ref: Using Internal File Ops-Footnote-11085963
-Node: Extension Samples1086237
-Node: Extension Sample File Functions1087766
-Node: Extension Sample Fnmatch1095415
-Node: Extension Sample Fork1096902
-Node: Extension Sample Inplace1098120
-Node: Extension Sample Ord1101337
-Node: Extension Sample Readdir1102173
-Ref: table-readdir-file-types1103062
-Node: Extension Sample Revout1103867
-Node: Extension Sample Rev2way1104456
-Node: Extension Sample Read write array1105196
-Node: Extension Sample Readfile1107138
-Node: Extension Sample Time1108233
-Node: Extension Sample API Tests1109581
-Node: gawkextlib1110073
-Node: Extension summary1112991
-Node: Extension Exercises1116693
-Node: Language History1118191
-Node: V7/SVR3.11119847
-Node: SVR41121999
-Node: POSIX1123433
-Node: BTL1124813
-Node: POSIX/GNU1125542
-Node: Feature History1131320
-Node: Common Extensions1147179
-Node: Ranges and Locales1148462
-Ref: Ranges and Locales-Footnote-11153078
-Ref: Ranges and Locales-Footnote-21153105
-Ref: Ranges and Locales-Footnote-31153340
-Node: Contributors1153561
-Node: History summary1159506
-Node: Installation1160886
-Node: Gawk Distribution1161830
-Node: Getting1162314
-Node: Extracting1163277
-Node: Distribution contents1164915
-Node: Unix Installation1171395
-Node: Quick Installation1172077
-Node: Shell Startup Files1174491
-Node: Additional Configuration Options1175580
-Node: Configuration Philosophy1177745
-Node: Non-Unix Installation1180114
-Node: PC Installation1180574
-Node: PC Binary Installation1181412
-Node: PC Compiling1181847
-Node: PC Using1182964
-Node: Cygwin1186179
-Node: MSYS1187278
-Node: VMS Installation1187779
-Node: VMS Compilation1188570
-Ref: VMS Compilation-Footnote-11189799
-Node: VMS Dynamic Extensions1189857
-Node: VMS Installation Details1191542
-Node: VMS Running1193795
-Node: VMS GNV1198074
-Node: VMS Old Gawk1198809
-Node: Bugs1199280
-Node: Bug address1199943
-Node: Usenet1202925
-Node: Maintainers1203930
-Node: Other Versions1205191
-Node: Installation summary1211749
-Node: Notes1212951
-Node: Compatibility Mode1213745
-Node: Additions1214527
-Node: Accessing The Source1215452
-Node: Adding Code1216889
-Node: New Ports1223108
-Node: Derived Files1227596
-Ref: Derived Files-Footnote-11233242
-Ref: Derived Files-Footnote-21233277
-Ref: Derived Files-Footnote-31233875
-Node: Future Extensions1233989
-Node: Implementation Limitations1234647
-Node: Extension Design1235830
-Node: Old Extension Problems1236974
-Ref: Old Extension Problems-Footnote-11238492
-Node: Extension New Mechanism Goals1238549
-Ref: Extension New Mechanism Goals-Footnote-11241913
-Node: Extension Other Design Decisions1242102
-Node: Extension Future Growth1244215
-Node: Notes summary1245051
-Node: Basic Concepts1246226
-Node: Basic High Level1246907
-Ref: figure-general-flow1247189
-Ref: figure-process-flow1247874
-Ref: Basic High Level-Footnote-11251175
-Node: Basic Data Typing1251360
-Node: Glossary1254688
-Node: Copying1286526
-Node: GNU Free Documentation License1324069
-Node: Index1349189
+Node: Advanced Features Summary847445
+Node: Internationalization849289
+Node: I18N and L10N850769
+Node: Explaining gettext851456
+Ref: Explaining gettext-Footnote-1857348
+Ref: Explaining gettext-Footnote-2857533
+Node: Programmer i18n857698
+Ref: Programmer i18n-Footnote-1862647
+Node: Translator i18n862696
+Node: String Extraction863490
+Ref: String Extraction-Footnote-1864622
+Node: Printf Ordering864708
+Ref: Printf Ordering-Footnote-1867494
+Node: I18N Portability867558
+Ref: I18N Portability-Footnote-1870014
+Node: I18N Example870077
+Ref: I18N Example-Footnote-1872883
+Node: Gawk I18N872956
+Node: I18N Summary873601
+Node: Debugger874942
+Node: Debugging875965
+Node: Debugging Concepts876406
+Node: Debugging Terms878215
+Node: Awk Debugging880790
+Node: Sample Debugging Session881696
+Node: Debugger Invocation882230
+Node: Finding The Bug883616
+Node: List of Debugger Commands890094
+Node: Breakpoint Control891427
+Node: Debugger Execution Control895121
+Node: Viewing And Changing Data898483
+Node: Execution Stack901857
+Node: Debugger Info903494
+Node: Miscellaneous Debugger Commands907565
+Node: Readline Support912627
+Node: Limitations913523
+Node: Debugging Summary915632
+Node: Arbitrary Precision Arithmetic916911
+Node: Computer Arithmetic918396
+Ref: table-numeric-ranges922162
+Ref: table-floating-point-ranges922655
+Ref: Computer Arithmetic-Footnote-1923313
+Node: Math Definitions923370
+Ref: table-ieee-formats926686
+Ref: Math Definitions-Footnote-1927289
+Node: MPFR features927394
+Node: FP Math Caution929112
+Ref: FP Math Caution-Footnote-1930184
+Node: Inexactness of computations930553
+Node: Inexact representation931513
+Node: Comparing FP Values932873
+Node: Errors accumulate934114
+Node: Getting Accuracy935547
+Node: Try To Round938257
+Node: Setting precision939156
+Ref: table-predefined-precision-strings939853
+Node: Setting the rounding mode941683
+Ref: table-gawk-rounding-modes942057
+Ref: Setting the rounding mode-Footnote-1945988
+Node: Arbitrary Precision Integers946167
+Ref: Arbitrary Precision Integers-Footnote-1949342
+Node: Checking for MPFR949491
+Node: POSIX Floating Point Problems950965
+Ref: POSIX Floating Point Problems-Footnote-1955250
+Node: Floating point summary955288
+Node: Dynamic Extensions957478
+Node: Extension Intro959031
+Node: Plugin License960297
+Node: Extension Mechanism Outline961094
+Ref: figure-load-extension961533
+Ref: figure-register-new-function963098
+Ref: figure-call-new-function964190
+Node: Extension API Description966252
+Node: Extension API Functions Introduction967894
+Node: General Data Types973434
+Ref: General Data Types-Footnote-1981795
+Node: Memory Allocation Functions982094
+Ref: Memory Allocation Functions-Footnote-1986304
+Node: Constructor Functions986403
+Node: Registration Functions989989
+Node: Extension Functions990674
+Node: Exit Callback Functions995889
+Node: Extension Version String997139
+Node: Input Parsers997802
+Node: Output Wrappers1010523
+Node: Two-way processors1015035
+Node: Printing Messages1017300
+Ref: Printing Messages-Footnote-11018471
+Node: Updating ERRNO1018624
+Node: Requesting Values1019363
+Ref: table-value-types-returned1020100
+Node: Accessing Parameters1021036
+Node: Symbol Table Access1022271
+Node: Symbol table by name1022783
+Node: Symbol table by cookie1024572
+Ref: Symbol table by cookie-Footnote-11028757
+Node: Cached values1028821
+Ref: Cached values-Footnote-11032357
+Node: Array Manipulation1032510
+Ref: Array Manipulation-Footnote-11033601
+Node: Array Data Types1033638
+Ref: Array Data Types-Footnote-11036296
+Node: Array Functions1036388
+Node: Flattening Arrays1040886
+Node: Creating Arrays1047862
+Node: Redirection API1052629
+Node: Extension API Variables1055462
+Node: Extension Versioning1056173
+Ref: gawk-api-version1056602
+Node: Extension GMP/MPFR Versioning1058333
+Node: Extension API Informational Variables1059961
+Node: Extension API Boilerplate1061034
+Node: Changes from API V11065008
+Node: Finding Extensions1066580
+Node: Extension Example1067139
+Node: Internal File Description1067937
+Node: Internal File Ops1072017
+Ref: Internal File Ops-Footnote-11083367
+Node: Using Internal File Ops1083507
+Ref: Using Internal File Ops-Footnote-11085890
+Node: Extension Samples1086164
+Node: Extension Sample File Functions1087693
+Node: Extension Sample Fnmatch1095342
+Node: Extension Sample Fork1096829
+Node: Extension Sample Inplace1098047
+Node: Extension Sample Ord1101264
+Node: Extension Sample Readdir1102100
+Ref: table-readdir-file-types1102989
+Node: Extension Sample Revout1103794
+Node: Extension Sample Rev2way1104383
+Node: Extension Sample Read write array1105123
+Node: Extension Sample Readfile1107065
+Node: Extension Sample Time1108160
+Node: Extension Sample API Tests1109508
+Node: gawkextlib1110000
+Node: Extension summary1112918
+Node: Extension Exercises1116620
+Node: Language History1118118
+Node: V7/SVR3.11119774
+Node: SVR41121926
+Node: POSIX1123360
+Node: BTL1124740
+Node: POSIX/GNU1125469
+Node: Feature History1131247
+Node: Common Extensions1147106
+Node: Ranges and Locales1148389
+Ref: Ranges and Locales-Footnote-11153005
+Ref: Ranges and Locales-Footnote-21153032
+Ref: Ranges and Locales-Footnote-31153267
+Node: Contributors1153488
+Node: History summary1159433
+Node: Installation1160813
+Node: Gawk Distribution1161757
+Node: Getting1162241
+Node: Extracting1163204
+Node: Distribution contents1164842
+Node: Unix Installation1171322
+Node: Quick Installation1172004
+Node: Shell Startup Files1174418
+Node: Additional Configuration Options1175507
+Node: Configuration Philosophy1177672
+Node: Non-Unix Installation1180041
+Node: PC Installation1180501
+Node: PC Binary Installation1181339
+Node: PC Compiling1181774
+Node: PC Using1182891
+Node: Cygwin1186106
+Node: MSYS1187205
+Node: VMS Installation1187706
+Node: VMS Compilation1188497
+Ref: VMS Compilation-Footnote-11189726
+Node: VMS Dynamic Extensions1189784
+Node: VMS Installation Details1191469
+Node: VMS Running1193722
+Node: VMS GNV1198001
+Node: VMS Old Gawk1198736
+Node: Bugs1199207
+Node: Bug address1199870
+Node: Usenet1202852
+Node: Maintainers1203857
+Node: Other Versions1205118
+Node: Installation summary1211676
+Node: Notes1212878
+Node: Compatibility Mode1213672
+Node: Additions1214454
+Node: Accessing The Source1215379
+Node: Adding Code1216816
+Node: New Ports1223035
+Node: Derived Files1227523
+Ref: Derived Files-Footnote-11233169
+Ref: Derived Files-Footnote-21233204
+Ref: Derived Files-Footnote-31233802
+Node: Future Extensions1233916
+Node: Implementation Limitations1234574
+Node: Extension Design1235757
+Node: Old Extension Problems1236901
+Ref: Old Extension Problems-Footnote-11238419
+Node: Extension New Mechanism Goals1238476
+Ref: Extension New Mechanism Goals-Footnote-11241840
+Node: Extension Other Design Decisions1242029
+Node: Extension Future Growth1244142
+Node: Notes summary1244978
+Node: Basic Concepts1246153
+Node: Basic High Level1246834
+Ref: figure-general-flow1247116
+Ref: figure-process-flow1247801
+Ref: Basic High Level-Footnote-11251102
+Node: Basic Data Typing1251287
+Node: Glossary1254615
+Node: Copying1286453
+Node: GNU Free Documentation License1323996
+Node: Index1349116
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 6d4843b..2ee504d 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -29080,6 +29080,7 @@ of the program and the precedence rules.
 For example, @samp{(3 + 5) * 4} means add three and five, then multiply
 the total by four.  However, @samp{3 + 5 * 4} has no parentheses, and
 means @samp{3 + (5 * 4)}.
+However, explicit parentheses in the source program are retained.
 
 @ignore
 @item
@@ -29210,12 +29211,10 @@ There is a significant difference between the output 
created when
 profiling, and that created when pretty-printing.  Pretty-printed output
 preserves the original comments that were in the program, although their
 placement may not correspond exactly to their original locations in the
-source address@hidden@command{gawk} does the best it can to preserve
+source code. However, no comments should be lost.
+Also, @command{gawk} does the best it can to preserve
 the distinction between comments at the end of a statement and comments
-on lines by themselves. Due to implementation constraints, it does not
-always do so correctly, particularly for @code{switch} statements. The
address@hidden maintainers hope to improve this in a subsequent
-release.}
+on lines by themselves. This isn't always perfect, though.
 
 However, as a deliberate design decision, profiling output @emph{omits}
 the original program's comments. This allows you to focus on the
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index 4f139f2..9ddf7db 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -28093,6 +28093,7 @@ of the program and the precedence rules.
 For example, @samp{(3 + 5) * 4} means add three and five, then multiply
 the total by four.  However, @samp{3 + 5 * 4} has no parentheses, and
 means @samp{3 + (5 * 4)}.
+However, explicit parentheses in the source program are retained.
 
 @ignore
 @item
@@ -28223,12 +28224,10 @@ There is a significant difference between the output 
created when
 profiling, and that created when pretty-printing.  Pretty-printed output
 preserves the original comments that were in the program, although their
 placement may not correspond exactly to their original locations in the
-source address@hidden@command{gawk} does the best it can to preserve
+source code. However, no comments should be lost.
+Also, @command{gawk} does the best it can to preserve
 the distinction between comments at the end of a statement and comments
-on lines by themselves. Due to implementation constraints, it does not
-always do so correctly, particularly for @code{switch} statements. The
address@hidden maintainers hope to improve this in a subsequent
-release.}
+on lines by themselves. This isn't always perfect, though.
 
 However, as a deliberate design decision, profiling output @emph{omits}
 the original program's comments. This allows you to focus on the

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

Summary of changes:
 doc/ChangeLog   |   4 +
 doc/gawk.info   | 473 ++++++++++++++++++++++++++++----------------------------
 doc/gawk.texi   |   9 +-
 doc/gawktexi.in |   9 +-
 4 files changed, 246 insertions(+), 249 deletions(-)


hooks/post-receive
-- 
gawk