diff options
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 473 | ||||
| -rw-r--r-- | doc/gawk.texi | 9 | ||||
| -rw-r--r-- | doc/gawktexi.in | 9 |
4 files changed, 246 insertions, 249 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index fb813a75..2bdbc08e 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2018-11-01 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in (Profiling): Review and update. + 2018-10-30 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in (Arrays of Arrays): Typo fix in code. Thanks to Alto Tom diff --git a/doc/gawk.info b/doc/gawk.info index 64f66d6d..874816f9 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 6d4843b4..2ee504de 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 code.@footnote{@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 -@command{gawk} 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 4f139f2a..9ddf7db9 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 code.@footnote{@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 -@command{gawk} 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 |