diff options
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/ChangeLog | 6 | ||||
| -rw-r--r-- | doc/gawk.info | 463 | ||||
| -rw-r--r-- | doc/gawk.texi | 4 | ||||
| -rw-r--r-- | doc/gawktexi.in | 4 |
4 files changed, 244 insertions, 233 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 75b35719..fb813a75 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -15,6 +15,12 @@ Communications Guidelines, with URL. * texinfo.tex: Updated from GNULIB. +2018-10-17 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in (Profiling): Revise example for pattern without + action and note that the profiler distinguishes `print' and + `print $0'. + 2018-09-23 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in (Extracting): Note that patch levels above diff --git a/doc/gawk.info b/doc/gawk.info index 921d121b..64f66d6d 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -20781,10 +20781,11 @@ representation. Also, things such as: come out as: /foo/ { - print $0 + print } -which is correct, but possibly unexpected. +which is correct, but possibly unexpected. (If a program uses both +'print $0' and plain 'print', that distinction is retained.) Besides creating profiles when a program has completed, 'gawk' can produce a profile while it is running. This is useful if your 'awk' @@ -34143,7 +34144,7 @@ Index * dump debugger command: Miscellaneous Debugger Commands. (line 9) * dupword.awk program: Dupword Program. (line 31) -* dynamic profiling: Profiling. (line 177) +* dynamic profiling: Profiling. (line 178) * dynamically loaded extensions: Dynamic Extensions. (line 6) * e debugger command (alias for enable): Breakpoint Control. (line 73) * EBCDIC: Ordinal Functions. (line 45) @@ -34532,7 +34533,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 177) +* gawk program, dynamic profiling: Profiling. (line 178) * gawk version: Auto-set. (line 241) * gawk, ARGIND variable in: Other Arguments. (line 15) * gawk, awk and: Preface. (line 21) @@ -34737,7 +34738,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 209) +* HUP signal, for dynamic profiling: Profiling. (line 210) * hyphen (-), - operator: Precedence. (line 51) * hyphen (-), - operator <1>: Precedence. (line 57) * hyphen (-), -- operator: Increment Ops. (line 48) @@ -34819,7 +34820,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 212) +* INT signal (MS-Windows): Profiling. (line 213) * integer array indices: Numeric Array Subscripts. (line 31) * integers, arbitrary precision: Arbitrary Precision Integers. @@ -34875,7 +34876,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 186) +* kill command, dynamic profiling: Profiling. (line 187) * Knights, jedi: Undocumented. (line 6) * Kwok, Conrad: Contributors. (line 35) * l debugger command (alias for list): Miscellaneous Debugger Commands. @@ -35389,7 +35390,7 @@ Index * PROCINFO, values of sorted_in: Controlling Scanning. (line 26) * profiling awk programs: Profiling. (line 6) -* profiling awk programs, dynamically: Profiling. (line 177) +* profiling awk programs, dynamically: Profiling. (line 178) * program identifiers: Auto-set. (line 193) * program, definition of: Getting Started. (line 21) * programming conventions, --non-decimal-data option: Nondecimal Data. @@ -35426,7 +35427,7 @@ Index * QuikTrim Awk: Other Versions. (line 135) * quit debugger command: Miscellaneous Debugger Commands. (line 100) -* QUIT signal (MS-Windows): Profiling. (line 212) +* QUIT signal (MS-Windows): Profiling. (line 213) * 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) @@ -35716,15 +35717,15 @@ Index (line 130) * sidebar, Using \n in Bracket Expressions of Dynamic Regexps: Computed Regexps. (line 58) -* SIGHUP signal, for dynamic profiling: Profiling. (line 209) -* SIGINT signal (MS-Windows): Profiling. (line 212) -* signals, HUP/SIGHUP, for profiling: Profiling. (line 209) -* signals, INT/SIGINT (MS-Windows): Profiling. (line 212) -* signals, QUIT/SIGQUIT (MS-Windows): Profiling. (line 212) -* signals, USR1/SIGUSR1, for profiling: Profiling. (line 186) +* 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) * signature program: Signature Program. (line 6) -* SIGQUIT signal (MS-Windows): Profiling. (line 212) -* SIGUSR1 signal, for dynamic profiling: Profiling. (line 186) +* SIGQUIT signal (MS-Windows): Profiling. (line 213) +* SIGUSR1 signal, for dynamic profiling: Profiling. (line 187) * silent debugger command: Debugger Execution Control. (line 10) * sin: Numeric Functions. (line 75) @@ -36004,7 +36005,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 186) +* USR1 signal, for dynamic profiling: Profiling. (line 187) * values, numeric: Basic Data Typing. (line 13) * values, string: Basic Data Typing. (line 13) * variable assignments and input files: Other Arguments. (line 26) @@ -36472,218 +36473,218 @@ Ref: Two-way I/O-Footnote-1835053 Ref: Two-way I/O-Footnote-2835240 Node: TCP/IP Networking835322 Node: Profiling838440 -Ref: Profiling-Footnote-1847112 -Node: Advanced Features Summary847435 -Node: Internationalization849279 -Node: I18N and L10N850759 -Node: Explaining gettext851446 -Ref: Explaining gettext-Footnote-1857338 -Ref: Explaining gettext-Footnote-2857523 -Node: Programmer i18n857688 -Ref: Programmer i18n-Footnote-1862637 -Node: Translator i18n862686 -Node: String Extraction863480 -Ref: String Extraction-Footnote-1864612 -Node: Printf Ordering864698 -Ref: Printf Ordering-Footnote-1867484 -Node: I18N Portability867548 -Ref: I18N Portability-Footnote-1870004 -Node: I18N Example870067 -Ref: I18N Example-Footnote-1872873 -Node: Gawk I18N872946 -Node: I18N Summary873591 -Node: Debugger874932 -Node: Debugging875955 -Node: Debugging Concepts876396 -Node: Debugging Terms878205 -Node: Awk Debugging880780 -Node: Sample Debugging Session881686 -Node: Debugger Invocation882220 -Node: Finding The Bug883606 -Node: List of Debugger Commands890084 -Node: Breakpoint Control891417 -Node: Debugger Execution Control895111 -Node: Viewing And Changing Data898473 -Node: Execution Stack901847 -Node: Debugger Info903484 -Node: Miscellaneous Debugger Commands907555 -Node: Readline Support912617 -Node: Limitations913513 -Node: Debugging Summary915622 -Node: Arbitrary Precision Arithmetic916901 -Node: Computer Arithmetic918386 -Ref: table-numeric-ranges922152 -Ref: table-floating-point-ranges922645 -Ref: Computer Arithmetic-Footnote-1923303 -Node: Math Definitions923360 -Ref: table-ieee-formats926676 -Ref: Math Definitions-Footnote-1927279 -Node: MPFR features927384 -Node: FP Math Caution929102 -Ref: FP Math Caution-Footnote-1930174 -Node: Inexactness of computations930543 -Node: Inexact representation931503 -Node: Comparing FP Values932863 -Node: Errors accumulate934104 -Node: Getting Accuracy935537 -Node: Try To Round938247 -Node: Setting precision939146 -Ref: table-predefined-precision-strings939843 -Node: Setting the rounding mode941673 -Ref: table-gawk-rounding-modes942047 -Ref: Setting the rounding mode-Footnote-1945978 -Node: Arbitrary Precision Integers946157 -Ref: Arbitrary Precision Integers-Footnote-1949332 -Node: Checking for MPFR949481 -Node: POSIX Floating Point Problems950955 -Ref: POSIX Floating Point Problems-Footnote-1955240 -Node: Floating point summary955278 -Node: Dynamic Extensions957468 -Node: Extension Intro959021 -Node: Plugin License960287 -Node: Extension Mechanism Outline961084 -Ref: figure-load-extension961523 -Ref: figure-register-new-function963088 -Ref: figure-call-new-function964180 -Node: Extension API Description966242 -Node: Extension API Functions Introduction967884 -Node: General Data Types973424 -Ref: General Data Types-Footnote-1981785 -Node: Memory Allocation Functions982084 -Ref: Memory Allocation Functions-Footnote-1986294 -Node: Constructor Functions986393 -Node: Registration Functions989979 -Node: Extension Functions990664 -Node: Exit Callback Functions995879 -Node: Extension Version String997129 -Node: Input Parsers997792 -Node: Output Wrappers1010513 -Node: Two-way processors1015025 -Node: Printing Messages1017290 -Ref: Printing Messages-Footnote-11018461 -Node: Updating ERRNO1018614 -Node: Requesting Values1019353 -Ref: table-value-types-returned1020090 -Node: Accessing Parameters1021026 -Node: Symbol Table Access1022261 -Node: Symbol table by name1022773 -Node: Symbol table by cookie1024562 -Ref: Symbol table by cookie-Footnote-11028747 -Node: Cached values1028811 -Ref: Cached values-Footnote-11032347 -Node: Array Manipulation1032500 -Ref: Array Manipulation-Footnote-11033591 -Node: Array Data Types1033628 -Ref: Array Data Types-Footnote-11036286 -Node: Array Functions1036378 -Node: Flattening Arrays1040876 -Node: Creating Arrays1047852 -Node: Redirection API1052619 -Node: Extension API Variables1055452 -Node: Extension Versioning1056163 -Ref: gawk-api-version1056592 -Node: Extension GMP/MPFR Versioning1058323 -Node: Extension API Informational Variables1059951 -Node: Extension API Boilerplate1061024 -Node: Changes from API V11064998 -Node: Finding Extensions1066570 -Node: Extension Example1067129 -Node: Internal File Description1067927 -Node: Internal File Ops1072007 -Ref: Internal File Ops-Footnote-11083357 -Node: Using Internal File Ops1083497 -Ref: Using Internal File Ops-Footnote-11085880 -Node: Extension Samples1086154 -Node: Extension Sample File Functions1087683 -Node: Extension Sample Fnmatch1095332 -Node: Extension Sample Fork1096819 -Node: Extension Sample Inplace1098037 -Node: Extension Sample Ord1101254 -Node: Extension Sample Readdir1102090 -Ref: table-readdir-file-types1102979 -Node: Extension Sample Revout1103784 -Node: Extension Sample Rev2way1104373 -Node: Extension Sample Read write array1105113 -Node: Extension Sample Readfile1107055 -Node: Extension Sample Time1108150 -Node: Extension Sample API Tests1109498 -Node: gawkextlib1109990 -Node: Extension summary1112908 -Node: Extension Exercises1116610 -Node: Language History1118108 -Node: V7/SVR3.11119764 -Node: SVR41121916 -Node: POSIX1123350 -Node: BTL1124730 -Node: POSIX/GNU1125459 -Node: Feature History1131237 -Node: Common Extensions1147096 -Node: Ranges and Locales1148379 -Ref: Ranges and Locales-Footnote-11152995 -Ref: Ranges and Locales-Footnote-21153022 -Ref: Ranges and Locales-Footnote-31153257 -Node: Contributors1153478 -Node: History summary1159423 -Node: Installation1160803 -Node: Gawk Distribution1161747 -Node: Getting1162231 -Node: Extracting1163194 -Node: Distribution contents1164832 -Node: Unix Installation1171312 -Node: Quick Installation1171994 -Node: Shell Startup Files1174408 -Node: Additional Configuration Options1175497 -Node: Configuration Philosophy1177662 -Node: Non-Unix Installation1180031 -Node: PC Installation1180491 -Node: PC Binary Installation1181329 -Node: PC Compiling1181764 -Node: PC Using1182881 -Node: Cygwin1186096 -Node: MSYS1187195 -Node: VMS Installation1187696 -Node: VMS Compilation1188487 -Ref: VMS Compilation-Footnote-11189716 -Node: VMS Dynamic Extensions1189774 -Node: VMS Installation Details1191459 -Node: VMS Running1193712 -Node: VMS GNV1197991 -Node: VMS Old Gawk1198726 -Node: Bugs1199197 -Node: Bug address1199860 -Node: Usenet1202842 -Node: Maintainers1203847 -Node: Other Versions1205108 -Node: Installation summary1211666 -Node: Notes1212868 -Node: Compatibility Mode1213662 -Node: Additions1214444 -Node: Accessing The Source1215369 -Node: Adding Code1216806 -Node: New Ports1223025 -Node: Derived Files1227513 -Ref: Derived Files-Footnote-11233159 -Ref: Derived Files-Footnote-21233194 -Ref: Derived Files-Footnote-31233792 -Node: Future Extensions1233906 -Node: Implementation Limitations1234564 -Node: Extension Design1235747 -Node: Old Extension Problems1236891 -Ref: Old Extension Problems-Footnote-11238409 -Node: Extension New Mechanism Goals1238466 -Ref: Extension New Mechanism Goals-Footnote-11241830 -Node: Extension Other Design Decisions1242019 -Node: Extension Future Growth1244132 -Node: Notes summary1244968 -Node: Basic Concepts1246143 -Node: Basic High Level1246824 -Ref: figure-general-flow1247106 -Ref: figure-process-flow1247791 -Ref: Basic High Level-Footnote-11251092 -Node: Basic Data Typing1251277 -Node: Glossary1254605 -Node: Copying1286443 -Node: GNU Free Documentation License1323986 -Node: Index1349106 +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 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index a50aa237..6d4843b4 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -29118,12 +29118,14 @@ come out as: @example /foo/ @{ - print $0 + print @} @end example @noindent which is correct, but possibly unexpected. +(If a program uses both @samp{print $0} and plain +@samp{print}, that distinction is retained.) @cindex profiling @command{awk} programs, dynamically @cindex @command{gawk} program, dynamic profiling diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 27f1e09c..4f139f2a 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -28131,12 +28131,14 @@ come out as: @example /foo/ @{ - print $0 + print @} @end example @noindent which is correct, but possibly unexpected. +(If a program uses both @samp{print $0} and plain +@samp{print}, that distinction is retained.) @cindex profiling @command{awk} programs, dynamically @cindex @command{gawk} program, dynamic profiling |