[gawk-diffs] [SCM] gawk branch, feature/fix-comments, updated. gawk-4.1.0-1713-g1a4eaf4

[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  1a4eaf4f7cbef6e407fe49437c8176e1650baa88 (commit)
      from  3a154919fe4c0e820f989e2bb347d6f8b87a7a79 (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=1a4eaf4f7cbef6e407fe49437c8176e1650baa88

commit 1a4eaf4f7cbef6e407fe49437c8176e1650baa88
Author: Arnold D. Robbins <address@hidden>
Date:   Sun Mar 27 21:39:01 2016 +0300

    Doc update about comments in pretty printing.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index f7400d1..68f0630 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2016-03-27         Arnold D. Robbins     <address@hidden>
+
+       * gawkinet.texi: Small update about end of line vs full
+       comments when pretty printing.
+
 2016-03-21         Arnold D. Robbins     <address@hidden>
 
        * gawkinet.texi: Update UDP client and discussion, update
diff --git a/doc/gawk.info b/doc/gawk.info
index 4e1608d..c1e44de 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -20290,7 +20290,7 @@ 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.
+source code.(1)
 
    However, as a deliberate design decision, profiling output _omits_
 the original program's comments.  This allows you to focus on the
@@ -20306,6 +20306,14 @@ result as the final version of your program.
 recreate an 'awk' program, profiling and pretty-printing automatically
 disable 'gawk''s default optimizations.
 
+   ---------- 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
 
@@ -35581,213 +35589,214 @@ Ref: Two-way I/O-Footnote-1813052
 Ref: Two-way I/O-Footnote-2813239
 Node: TCP/IP Networking813321
 Node: Profiling816439
-Node: Advanced Features Summary824893
-Node: Internationalization826737
-Node: I18N and L10N828217
-Node: Explaining gettext828904
-Ref: Explaining gettext-Footnote-1833927
-Ref: Explaining gettext-Footnote-2834112
-Node: Programmer i18n834277
-Ref: Programmer i18n-Footnote-1839132
-Node: Translator i18n839181
-Node: String Extraction839975
-Ref: String Extraction-Footnote-1841107
-Node: Printf Ordering841193
-Ref: Printf Ordering-Footnote-1843979
-Node: I18N Portability844043
-Ref: I18N Portability-Footnote-1846499
-Node: I18N Example846562
-Ref: I18N Example-Footnote-1849368
-Node: Gawk I18N849441
-Node: I18N Summary850086
-Node: Debugger851427
-Node: Debugging852449
-Node: Debugging Concepts852890
-Node: Debugging Terms854699
-Node: Awk Debugging857274
-Node: Sample Debugging Session858180
-Node: Debugger Invocation858714
-Node: Finding The Bug860100
-Node: List of Debugger Commands866578
-Node: Breakpoint Control867911
-Node: Debugger Execution Control871605
-Node: Viewing And Changing Data874967
-Node: Execution Stack878341
-Node: Debugger Info879978
-Node: Miscellaneous Debugger Commands884049
-Node: Readline Support889137
-Node: Limitations890033
-Ref: Limitations-Footnote-1894264
-Node: Debugging Summary894315
-Node: Arbitrary Precision Arithmetic895594
-Node: Computer Arithmetic897010
-Ref: table-numeric-ranges900601
-Ref: Computer Arithmetic-Footnote-1901323
-Node: Math Definitions901380
-Ref: table-ieee-formats904694
-Ref: Math Definitions-Footnote-1905297
-Node: MPFR features905402
-Node: FP Math Caution907119
-Ref: FP Math Caution-Footnote-1908191
-Node: Inexactness of computations908560
-Node: Inexact representation909520
-Node: Comparing FP Values910880
-Node: Errors accumulate911962
-Node: Getting Accuracy913395
-Node: Try To Round916105
-Node: Setting precision917004
-Ref: table-predefined-precision-strings917701
-Node: Setting the rounding mode919531
-Ref: table-gawk-rounding-modes919905
-Ref: Setting the rounding mode-Footnote-1923313
-Node: Arbitrary Precision Integers923492
-Ref: Arbitrary Precision Integers-Footnote-1928409
-Node: POSIX Floating Point Problems928558
-Ref: POSIX Floating Point Problems-Footnote-1932440
-Node: Floating point summary932478
-Node: Dynamic Extensions934668
-Node: Extension Intro936221
-Node: Plugin License937487
-Node: Extension Mechanism Outline938284
-Ref: figure-load-extension938723
-Ref: figure-register-new-function940288
-Ref: figure-call-new-function941380
-Node: Extension API Description943442
-Node: Extension API Functions Introduction944974
-Node: General Data Types949833
-Ref: General Data Types-Footnote-1955788
-Node: Memory Allocation Functions956087
-Ref: Memory Allocation Functions-Footnote-1958932
-Node: Constructor Functions959031
-Node: Registration Functions960776
-Node: Extension Functions961461
-Node: Exit Callback Functions963760
-Node: Extension Version String965010
-Node: Input Parsers965673
-Node: Output Wrappers975558
-Node: Two-way processors980070
-Node: Printing Messages982334
-Ref: Printing Messages-Footnote-1983408
-Node: Updating ERRNO983561
-Node: Requesting Values984300
-Ref: table-value-types-returned985037
-Node: Accessing Parameters985920
-Node: Symbol Table Access987155
-Node: Symbol table by name987667
-Node: Symbol table by cookie989688
-Ref: Symbol table by cookie-Footnote-1993837
-Node: Cached values993901
-Ref: Cached values-Footnote-1997402
-Node: Array Manipulation997493
-Ref: Array Manipulation-Footnote-1998584
-Node: Array Data Types998621
-Ref: Array Data Types-Footnote-11001279
-Node: Array Functions1001371
-Node: Flattening Arrays1005229
-Node: Creating Arrays1012137
-Node: Redirection API1016908
-Node: Extension API Variables1019739
-Node: Extension Versioning1020372
-Node: Extension API Informational Variables1022263
-Node: Extension API Boilerplate1023327
-Node: Finding Extensions1027141
-Node: Extension Example1027700
-Node: Internal File Description1028498
-Node: Internal File Ops1032578
-Ref: Internal File Ops-Footnote-11044340
-Node: Using Internal File Ops1044480
-Ref: Using Internal File Ops-Footnote-11046863
-Node: Extension Samples1047137
-Node: Extension Sample File Functions1048666
-Node: Extension Sample Fnmatch1056315
-Node: Extension Sample Fork1057802
-Node: Extension Sample Inplace1059020
-Node: Extension Sample Ord1062230
-Node: Extension Sample Readdir1063066
-Ref: table-readdir-file-types1063955
-Node: Extension Sample Revout1064760
-Node: Extension Sample Rev2way1065349
-Node: Extension Sample Read write array1066089
-Node: Extension Sample Readfile1068031
-Node: Extension Sample Time1069126
-Node: Extension Sample API Tests1070474
-Node: gawkextlib1070966
-Node: Extension summary1073413
-Node: Extension Exercises1077105
-Node: Language History1078602
-Node: V7/SVR3.11080258
-Node: SVR41082410
-Node: POSIX1083844
-Node: BTL1085223
-Node: POSIX/GNU1085952
-Node: Feature History1091814
-Node: Common Extensions1106184
-Node: Ranges and Locales1107467
-Ref: Ranges and Locales-Footnote-11112083
-Ref: Ranges and Locales-Footnote-21112110
-Ref: Ranges and Locales-Footnote-31112345
-Node: Contributors1112566
-Node: History summary1118135
-Node: Installation1119515
-Node: Gawk Distribution1120459
-Node: Getting1120943
-Node: Extracting1121904
-Node: Distribution contents1123542
-Node: Unix Installation1129636
-Node: Quick Installation1130318
-Node: Shell Startup Files1132732
-Node: Additional Configuration Options1133810
-Node: Configuration Philosophy1135615
-Node: Non-Unix Installation1137984
-Node: PC Installation1138442
-Node: PC Binary Installation1139762
-Node: PC Compiling1141614
-Ref: PC Compiling-Footnote-11144638
-Node: PC Testing1144747
-Node: PC Using1145927
-Node: Cygwin1150041
-Node: MSYS1150811
-Node: VMS Installation1151312
-Node: VMS Compilation1152103
-Ref: VMS Compilation-Footnote-11153332
-Node: VMS Dynamic Extensions1153390
-Node: VMS Installation Details1155075
-Node: VMS Running1157328
-Node: VMS GNV1161607
-Node: VMS Old Gawk1162342
-Node: Bugs1162813
-Node: Other Versions1167010
-Node: Installation summary1173594
-Node: Notes1174652
-Node: Compatibility Mode1175517
-Node: Additions1176299
-Node: Accessing The Source1177224
-Node: Adding Code1178659
-Node: New Ports1184878
-Node: Derived Files1189366
-Ref: Derived Files-Footnote-11194851
-Ref: Derived Files-Footnote-21194886
-Ref: Derived Files-Footnote-31195484
-Node: Future Extensions1195598
-Node: Implementation Limitations1196256
-Node: Extension Design1197439
-Node: Old Extension Problems1198593
-Ref: Old Extension Problems-Footnote-11200111
-Node: Extension New Mechanism Goals1200168
-Ref: Extension New Mechanism Goals-Footnote-11203532
-Node: Extension Other Design Decisions1203721
-Node: Extension Future Growth1205834
-Node: Old Extension Mechanism1206670
-Node: Notes summary1208433
-Node: Basic Concepts1209615
-Node: Basic High Level1210296
-Ref: figure-general-flow1210578
-Ref: figure-process-flow1211263
-Ref: Basic High Level-Footnote-11214564
-Node: Basic Data Typing1214749
-Node: Glossary1218077
-Node: Copying1250023
-Node: GNU Free Documentation License1287562
-Node: Index1312680
+Ref: Profiling-Footnote-1824932
+Node: Advanced Features Summary825255
+Node: Internationalization827099
+Node: I18N and L10N828579
+Node: Explaining gettext829266
+Ref: Explaining gettext-Footnote-1834289
+Ref: Explaining gettext-Footnote-2834474
+Node: Programmer i18n834639
+Ref: Programmer i18n-Footnote-1839494
+Node: Translator i18n839543
+Node: String Extraction840337
+Ref: String Extraction-Footnote-1841469
+Node: Printf Ordering841555
+Ref: Printf Ordering-Footnote-1844341
+Node: I18N Portability844405
+Ref: I18N Portability-Footnote-1846861
+Node: I18N Example846924
+Ref: I18N Example-Footnote-1849730
+Node: Gawk I18N849803
+Node: I18N Summary850448
+Node: Debugger851789
+Node: Debugging852811
+Node: Debugging Concepts853252
+Node: Debugging Terms855061
+Node: Awk Debugging857636
+Node: Sample Debugging Session858542
+Node: Debugger Invocation859076
+Node: Finding The Bug860462
+Node: List of Debugger Commands866940
+Node: Breakpoint Control868273
+Node: Debugger Execution Control871967
+Node: Viewing And Changing Data875329
+Node: Execution Stack878703
+Node: Debugger Info880340
+Node: Miscellaneous Debugger Commands884411
+Node: Readline Support889499
+Node: Limitations890395
+Ref: Limitations-Footnote-1894626
+Node: Debugging Summary894677
+Node: Arbitrary Precision Arithmetic895956
+Node: Computer Arithmetic897372
+Ref: table-numeric-ranges900963
+Ref: Computer Arithmetic-Footnote-1901685
+Node: Math Definitions901742
+Ref: table-ieee-formats905056
+Ref: Math Definitions-Footnote-1905659
+Node: MPFR features905764
+Node: FP Math Caution907481
+Ref: FP Math Caution-Footnote-1908553
+Node: Inexactness of computations908922
+Node: Inexact representation909882
+Node: Comparing FP Values911242
+Node: Errors accumulate912324
+Node: Getting Accuracy913757
+Node: Try To Round916467
+Node: Setting precision917366
+Ref: table-predefined-precision-strings918063
+Node: Setting the rounding mode919893
+Ref: table-gawk-rounding-modes920267
+Ref: Setting the rounding mode-Footnote-1923675
+Node: Arbitrary Precision Integers923854
+Ref: Arbitrary Precision Integers-Footnote-1928771
+Node: POSIX Floating Point Problems928920
+Ref: POSIX Floating Point Problems-Footnote-1932802
+Node: Floating point summary932840
+Node: Dynamic Extensions935030
+Node: Extension Intro936583
+Node: Plugin License937849
+Node: Extension Mechanism Outline938646
+Ref: figure-load-extension939085
+Ref: figure-register-new-function940650
+Ref: figure-call-new-function941742
+Node: Extension API Description943804
+Node: Extension API Functions Introduction945336
+Node: General Data Types950195
+Ref: General Data Types-Footnote-1956150
+Node: Memory Allocation Functions956449
+Ref: Memory Allocation Functions-Footnote-1959294
+Node: Constructor Functions959393
+Node: Registration Functions961138
+Node: Extension Functions961823
+Node: Exit Callback Functions964122
+Node: Extension Version String965372
+Node: Input Parsers966035
+Node: Output Wrappers975920
+Node: Two-way processors980432
+Node: Printing Messages982696
+Ref: Printing Messages-Footnote-1983770
+Node: Updating ERRNO983923
+Node: Requesting Values984662
+Ref: table-value-types-returned985399
+Node: Accessing Parameters986282
+Node: Symbol Table Access987517
+Node: Symbol table by name988029
+Node: Symbol table by cookie990050
+Ref: Symbol table by cookie-Footnote-1994199
+Node: Cached values994263
+Ref: Cached values-Footnote-1997764
+Node: Array Manipulation997855
+Ref: Array Manipulation-Footnote-1998946
+Node: Array Data Types998983
+Ref: Array Data Types-Footnote-11001641
+Node: Array Functions1001733
+Node: Flattening Arrays1005591
+Node: Creating Arrays1012499
+Node: Redirection API1017270
+Node: Extension API Variables1020101
+Node: Extension Versioning1020734
+Node: Extension API Informational Variables1022625
+Node: Extension API Boilerplate1023689
+Node: Finding Extensions1027503
+Node: Extension Example1028062
+Node: Internal File Description1028860
+Node: Internal File Ops1032940
+Ref: Internal File Ops-Footnote-11044702
+Node: Using Internal File Ops1044842
+Ref: Using Internal File Ops-Footnote-11047225
+Node: Extension Samples1047499
+Node: Extension Sample File Functions1049028
+Node: Extension Sample Fnmatch1056677
+Node: Extension Sample Fork1058164
+Node: Extension Sample Inplace1059382
+Node: Extension Sample Ord1062592
+Node: Extension Sample Readdir1063428
+Ref: table-readdir-file-types1064317
+Node: Extension Sample Revout1065122
+Node: Extension Sample Rev2way1065711
+Node: Extension Sample Read write array1066451
+Node: Extension Sample Readfile1068393
+Node: Extension Sample Time1069488
+Node: Extension Sample API Tests1070836
+Node: gawkextlib1071328
+Node: Extension summary1073775
+Node: Extension Exercises1077467
+Node: Language History1078964
+Node: V7/SVR3.11080620
+Node: SVR41082772
+Node: POSIX1084206
+Node: BTL1085585
+Node: POSIX/GNU1086314
+Node: Feature History1092176
+Node: Common Extensions1106546
+Node: Ranges and Locales1107829
+Ref: Ranges and Locales-Footnote-11112445
+Ref: Ranges and Locales-Footnote-21112472
+Ref: Ranges and Locales-Footnote-31112707
+Node: Contributors1112928
+Node: History summary1118497
+Node: Installation1119877
+Node: Gawk Distribution1120821
+Node: Getting1121305
+Node: Extracting1122266
+Node: Distribution contents1123904
+Node: Unix Installation1129998
+Node: Quick Installation1130680
+Node: Shell Startup Files1133094
+Node: Additional Configuration Options1134172
+Node: Configuration Philosophy1135977
+Node: Non-Unix Installation1138346
+Node: PC Installation1138804
+Node: PC Binary Installation1140124
+Node: PC Compiling1141976
+Ref: PC Compiling-Footnote-11145000
+Node: PC Testing1145109
+Node: PC Using1146289
+Node: Cygwin1150403
+Node: MSYS1151173
+Node: VMS Installation1151674
+Node: VMS Compilation1152465
+Ref: VMS Compilation-Footnote-11153694
+Node: VMS Dynamic Extensions1153752
+Node: VMS Installation Details1155437
+Node: VMS Running1157690
+Node: VMS GNV1161969
+Node: VMS Old Gawk1162704
+Node: Bugs1163175
+Node: Other Versions1167372
+Node: Installation summary1173956
+Node: Notes1175014
+Node: Compatibility Mode1175879
+Node: Additions1176661
+Node: Accessing The Source1177586
+Node: Adding Code1179021
+Node: New Ports1185240
+Node: Derived Files1189728
+Ref: Derived Files-Footnote-11195213
+Ref: Derived Files-Footnote-21195248
+Ref: Derived Files-Footnote-31195846
+Node: Future Extensions1195960
+Node: Implementation Limitations1196618
+Node: Extension Design1197801
+Node: Old Extension Problems1198955
+Ref: Old Extension Problems-Footnote-11200473
+Node: Extension New Mechanism Goals1200530
+Ref: Extension New Mechanism Goals-Footnote-11203894
+Node: Extension Other Design Decisions1204083
+Node: Extension Future Growth1206196
+Node: Old Extension Mechanism1207032
+Node: Notes summary1208795
+Node: Basic Concepts1209977
+Node: Basic High Level1210658
+Ref: figure-general-flow1210940
+Ref: figure-process-flow1211625
+Ref: Basic High Level-Footnote-11214926
+Node: Basic Data Typing1215111
+Node: Glossary1218439
+Node: Copying1250385
+Node: GNU Free Documentation License1287924
+Node: Index1313042
 
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index fb05d52..8c515a3 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -28331,7 +28331,12 @@ 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 code.
+source address@hidden@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.}
 
 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 d420ad6..3e0f6bb 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -27422,7 +27422,12 @@ 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 code.
+source address@hidden@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.}
 
 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   |    5 +
 doc/gawk.info   |  427 ++++++++++++++++++++++++++++---------------------------
 doc/gawk.texi   |    7 +-
 doc/gawktexi.in |    7 +-
 4 files changed, 235 insertions(+), 211 deletions(-)


hooks/post-receive
-- 
gawk