diff options
Diffstat (limited to 'doc/gawk.info')
| -rw-r--r-- | doc/gawk.info | 427 |
1 files changed, 218 insertions, 209 deletions
diff --git a/doc/gawk.info b/doc/gawk.info index 4e1608df..c1e44de8 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 |