diff options
| -rw-r--r-- | NEWS | 4 | ||||
| -rw-r--r-- | doc/ChangeLog | 7 | ||||
| -rw-r--r-- | doc/gawk.1 | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 980 | ||||
| -rw-r--r-- | doc/gawk.texi | 6 | ||||
| -rw-r--r-- | doc/gawktexi.in | 6 |
6 files changed, 508 insertions, 499 deletions
@@ -8,7 +8,9 @@ Changes from 5.0.1 to 5.1.0 --------------------------- 1. The major version of the API is bumped to 3, something that should -have happened at the 5.0.0 release but didn't. + have happened at the 5.0.0 release but didn't. + +2. Several bugs have been fixed. See the ChangeLog for details. Changes from 5.0.0 to 5.0.1 --------------------------- diff --git a/doc/ChangeLog b/doc/ChangeLog index 6bf265e6..959fa3e9 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,10 @@ +2019-07-23 Arnold D. Robbins <arnold@skeeve.com> + + * gawk.1: Fix typo, update edition. Thanks to Antonio + Columbo for the pointers. + * gawktexi.in: Update EDITION. Thanks to Antonio Columbo. + Fix two typos. Thanks to Mark Krauze. + 2019-07-21 Arnold D. Robbins <arnold@skeeve.com> * awkcard.in, gawk.1, gawkinet.texi, gawktexi.in: Copyrights @@ -1,4 +1,4 @@ -1ds PX \s-1POSIX\s+1 +.ds PX \s-1POSIX\s+1 .ds UX \s-1UNIX\s+1 .ds GN \s-1GNU\s+1 .ds AK \s-1AWK\s+1 @@ -4223,7 +4223,7 @@ Alfred V. Aho, Brian W. Kernighan, Peter J. Weinberger, Addison-Wesley, 1988. ISBN 0-201-07981-X. .PP \*(EP, -Edition 5.0, shipped with the +Edition 5.1, shipped with the .I gawk source. The current version of this document is available online at diff --git a/doc/gawk.info b/doc/gawk.info index d43c9701..16ff7247 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -4,7 +4,7 @@ Copyright (C) 1989, 1991, 1992, 1993, 1996-2005, 2007, 2009-2019 Free Software Foundation, Inc. - This is Edition 5.0 of 'GAWK: Effective AWK Programming: A User's + This is Edition 5.1 of 'GAWK: Effective AWK Programming: A User's Guide for GNU Awk', for the 5.1.0 (or later) version of the GNU implementation of AWK. @@ -41,7 +41,7 @@ particular records in a file and perform operations upon them. Free Software Foundation, Inc. - This is Edition 5.0 of 'GAWK: Effective AWK Programming: A User's + This is Edition 5.1 of 'GAWK: Effective AWK Programming: A User's Guide for GNU Awk', for the 5.1.0 (or later) version of the GNU implementation of AWK. @@ -1264,7 +1264,7 @@ For FSF edition 4.0, the content was thoroughly reviewed and updated. All references to 'gawk' versions prior to 4.0 were removed. Of significant note for that edition was the addition of *note Debugger::. - For FSF edition 5.0, the content has been reorganized into parts, and + For FSF edition 5.1, the content has been reorganized into parts, and the major new additions are *note Arbitrary Precision Arithmetic::, and *note Dynamic Extensions::. @@ -5998,7 +5998,7 @@ you want your program to be portable to all 'awk' implementations. NOTE: Unfortunately, 'gawk' has not been consistent in its treatment of a construct like '"echo " "date" | getline'. Most - versions, including the current version, treat it at as '("echo " + versions, including the current version, treat it as '("echo " "date") | getline'. (This is also how BWK 'awk' behaves.) Some versions instead treat it as '"echo " ("date" | getline)'. (This is how 'mawk' behaves.) In short, _always_ use explicit @@ -7752,7 +7752,7 @@ lines by ending the line with a backslash. For example in C: int main() { - printf "hello, \ + printf("hello, \ world\n"); return 0; } @@ -37029,490 +37029,490 @@ Node: Getline/File261934 Node: Getline/Variable/File263322 Ref: Getline/Variable/File-Footnote-1264927 Node: Getline/Pipe265015 -Node: Getline/Variable/Pipe267722 -Node: Getline/Coprocess268857 -Node: Getline/Variable/Coprocess270124 -Node: Getline Notes270866 -Node: Getline Summary273663 -Ref: table-getline-variants274087 -Node: Read Timeout274835 -Ref: Read Timeout-Footnote-1278741 -Node: Retrying Input278799 -Node: Command-line directories279998 -Node: Input Summary280904 -Node: Input Exercises284076 -Node: Printing284510 -Node: Print286344 -Node: Print Examples287801 -Node: Output Separators290581 -Node: OFMT292598 -Node: Printf293954 -Node: Basic Printf294739 -Node: Control Letters296313 -Node: Format Modifiers301477 -Node: Printf Examples307492 -Node: Redirection309978 -Node: Special FD316819 -Ref: Special FD-Footnote-1319987 -Node: Special Files320061 -Node: Other Inherited Files320678 -Node: Special Network321679 -Node: Special Caveats322539 -Node: Close Files And Pipes323488 -Ref: table-close-pipe-return-values330395 -Ref: Close Files And Pipes-Footnote-1331208 -Ref: Close Files And Pipes-Footnote-2331356 -Node: Nonfatal331508 -Node: Output Summary333846 -Node: Output Exercises335068 -Node: Expressions335747 -Node: Values336935 -Node: Constants337613 -Node: Scalar Constants338304 -Ref: Scalar Constants-Footnote-1340828 -Node: Nondecimal-numbers341078 -Node: Regexp Constants344079 -Node: Using Constant Regexps344605 -Node: Standard Regexp Constants345227 -Node: Strong Regexp Constants348415 -Node: Variables351373 -Node: Using Variables352030 -Node: Assignment Options353940 -Node: Conversion356407 -Node: Strings And Numbers356931 -Ref: Strings And Numbers-Footnote-1359994 -Node: Locale influences conversions360103 -Ref: table-locale-affects362861 -Node: All Operators363479 -Node: Arithmetic Ops364108 -Node: Concatenation366614 -Ref: Concatenation-Footnote-1369461 -Node: Assignment Ops369568 -Ref: table-assign-ops374559 -Node: Increment Ops375872 -Node: Truth Values and Conditions379332 -Node: Truth Values380406 -Node: Typing and Comparison381454 -Node: Variable Typing382274 -Ref: Variable Typing-Footnote-1388737 -Ref: Variable Typing-Footnote-2388809 -Node: Comparison Operators388886 -Ref: table-relational-ops389305 -Node: POSIX String Comparison392800 -Ref: POSIX String Comparison-Footnote-1394495 -Ref: POSIX String Comparison-Footnote-2394634 -Node: Boolean Ops394718 -Ref: Boolean Ops-Footnote-1399200 -Node: Conditional Exp399292 -Node: Function Calls401028 -Node: Precedence404905 -Node: Locales408564 -Node: Expressions Summary410196 -Node: Patterns and Actions412769 -Node: Pattern Overview413889 -Node: Regexp Patterns415566 -Node: Expression Patterns416108 -Node: Ranges419889 -Node: BEGIN/END422997 -Node: Using BEGIN/END423758 -Ref: Using BEGIN/END-Footnote-1426494 -Node: I/O And BEGIN/END426600 -Node: BEGINFILE/ENDFILE428914 -Node: Empty431827 -Node: Using Shell Variables432144 -Node: Action Overview434418 -Node: Statements436743 -Node: If Statement438591 -Node: While Statement440086 -Node: Do Statement442114 -Node: For Statement443262 -Node: Switch Statement446433 -Node: Break Statement448819 -Node: Continue Statement450911 -Node: Next Statement452738 -Node: Nextfile Statement455121 -Node: Exit Statement457773 -Node: Built-in Variables460176 -Node: User-modified461309 -Node: Auto-set469076 -Ref: Auto-set-Footnote-1485883 -Ref: Auto-set-Footnote-2486089 -Node: ARGC and ARGV486145 -Node: Pattern Action Summary490358 -Node: Arrays492788 -Node: Array Basics494117 -Node: Array Intro494961 -Ref: figure-array-elements496936 -Ref: Array Intro-Footnote-1499640 -Node: Reference to Elements499768 -Node: Assigning Elements502232 -Node: Array Example502723 -Node: Scanning an Array504482 -Node: Controlling Scanning507504 -Ref: Controlling Scanning-Footnote-1512903 -Node: Numeric Array Subscripts513219 -Node: Uninitialized Subscripts515403 -Node: Delete517022 -Ref: Delete-Footnote-1519774 -Node: Multidimensional519831 -Node: Multiscanning522926 -Node: Arrays of Arrays524517 -Node: Arrays Summary529285 -Node: Functions531378 -Node: Built-in532416 -Node: Calling Built-in533497 -Node: Numeric Functions535493 -Ref: Numeric Functions-Footnote-1539521 -Ref: Numeric Functions-Footnote-2540169 -Ref: Numeric Functions-Footnote-3540217 -Node: String Functions540489 -Ref: String Functions-Footnote-1564347 -Ref: String Functions-Footnote-2564475 -Ref: String Functions-Footnote-3564723 -Node: Gory Details564810 -Ref: table-sub-escapes566601 -Ref: table-sub-proposed568120 -Ref: table-posix-sub569483 -Ref: table-gensub-escapes571024 -Ref: Gory Details-Footnote-1571847 -Node: I/O Functions572001 -Ref: table-system-return-values578469 -Ref: I/O Functions-Footnote-1580549 -Ref: I/O Functions-Footnote-2580697 -Node: Time Functions580817 -Ref: Time Functions-Footnote-1591488 -Ref: Time Functions-Footnote-2591556 -Ref: Time Functions-Footnote-3591714 -Ref: Time Functions-Footnote-4591825 -Ref: Time Functions-Footnote-5591937 -Ref: Time Functions-Footnote-6592164 -Node: Bitwise Functions592430 -Ref: table-bitwise-ops593024 -Ref: Bitwise Functions-Footnote-1599087 -Ref: Bitwise Functions-Footnote-2599260 -Node: Type Functions599451 -Node: I18N Functions602314 -Node: User-defined603965 -Node: Definition Syntax604777 -Ref: Definition Syntax-Footnote-1610464 -Node: Function Example610535 -Ref: Function Example-Footnote-1613457 -Node: Function Calling613479 -Node: Calling A Function614067 -Node: Variable Scope615025 -Node: Pass By Value/Reference618019 -Node: Function Caveats620663 -Ref: Function Caveats-Footnote-1622710 -Node: Return Statement622830 -Node: Dynamic Typing625809 -Node: Indirect Calls626739 -Ref: Indirect Calls-Footnote-1636991 -Node: Functions Summary637119 -Node: Library Functions639824 -Ref: Library Functions-Footnote-1643431 -Ref: Library Functions-Footnote-2643574 -Node: Library Names643745 -Ref: Library Names-Footnote-1647412 -Ref: Library Names-Footnote-2647635 -Node: General Functions647721 -Node: Strtonum Function648824 -Node: Assert Function651846 -Node: Round Function655172 -Node: Cliff Random Function656712 -Node: Ordinal Functions657728 -Ref: Ordinal Functions-Footnote-1660791 -Ref: Ordinal Functions-Footnote-2661043 -Node: Join Function661253 -Ref: Join Function-Footnote-1663023 -Node: Getlocaltime Function663223 -Node: Readfile Function666965 -Node: Shell Quoting668942 -Node: Data File Management670343 -Node: Filetrans Function670975 -Node: Rewind Function675071 -Node: File Checking676980 -Ref: File Checking-Footnote-1678314 -Node: Empty Files678515 -Node: Ignoring Assigns680494 -Node: Getopt Function682044 -Ref: Getopt Function-Footnote-1693513 -Node: Passwd Functions693713 -Ref: Passwd Functions-Footnote-1702552 -Node: Group Functions702640 -Ref: Group Functions-Footnote-1710538 -Node: Walking Arrays710745 -Node: Library Functions Summary713753 -Node: Library Exercises715159 -Node: Sample Programs715624 -Node: Running Examples716394 -Node: Clones717122 -Node: Cut Program718346 -Node: Egrep Program728275 -Ref: Egrep Program-Footnote-1735787 -Node: Id Program735897 -Node: Split Program739577 -Ref: Split Program-Footnote-1743035 -Node: Tee Program743164 -Node: Uniq Program745954 -Node: Wc Program753575 -Ref: Wc Program-Footnote-1757830 -Node: Miscellaneous Programs757924 -Node: Dupword Program759137 -Node: Alarm Program761167 -Node: Translate Program766022 -Ref: Translate Program-Footnote-1770587 -Node: Labels Program770857 -Ref: Labels Program-Footnote-1774208 -Node: Word Sorting774292 -Node: History Sorting778364 -Node: Extract Program780199 -Node: Simple Sed788253 -Node: Igawk Program791327 -Ref: Igawk Program-Footnote-1805658 -Ref: Igawk Program-Footnote-2805860 -Ref: Igawk Program-Footnote-3805982 -Node: Anagram Program806097 -Node: Signature Program809159 -Node: Programs Summary810406 -Node: Programs Exercises811620 -Ref: Programs Exercises-Footnote-1815749 -Node: Advanced Features815840 -Node: Nondecimal Data817830 -Node: Array Sorting819421 -Node: Controlling Array Traversal820121 -Ref: Controlling Array Traversal-Footnote-1828489 -Node: Array Sorting Functions828607 -Ref: Array Sorting Functions-Footnote-1833698 -Node: Two-way I/O833894 -Ref: Two-way I/O-Footnote-1841615 -Ref: Two-way I/O-Footnote-2841802 -Node: TCP/IP Networking841884 -Node: Profiling845002 -Node: Advanced Features Summary854017 -Node: Internationalization855861 -Node: I18N and L10N857341 -Node: Explaining gettext858028 -Ref: Explaining gettext-Footnote-1863920 -Ref: Explaining gettext-Footnote-2864105 -Node: Programmer i18n864270 -Ref: Programmer i18n-Footnote-1869219 -Node: Translator i18n869268 -Node: String Extraction870062 -Ref: String Extraction-Footnote-1871194 -Node: Printf Ordering871280 -Ref: Printf Ordering-Footnote-1874066 -Node: I18N Portability874130 -Ref: I18N Portability-Footnote-1876586 -Node: I18N Example876649 -Ref: I18N Example-Footnote-1879924 -Ref: I18N Example-Footnote-2879997 -Node: Gawk I18N880106 -Node: I18N Summary880755 -Node: Debugger882096 -Node: Debugging883096 -Node: Debugging Concepts883537 -Node: Debugging Terms885346 -Node: Awk Debugging887921 -Ref: Awk Debugging-Footnote-1888866 -Node: Sample Debugging Session888998 -Node: Debugger Invocation889532 -Node: Finding The Bug890918 -Node: List of Debugger Commands897392 -Node: Breakpoint Control898725 -Node: Debugger Execution Control902419 -Node: Viewing And Changing Data905781 -Node: Execution Stack909322 -Node: Debugger Info910959 -Node: Miscellaneous Debugger Commands915030 -Node: Readline Support920092 -Node: Limitations920988 -Node: Debugging Summary923542 -Node: Namespaces924821 -Node: Global Namespace925932 -Node: Qualified Names927330 -Node: Default Namespace928329 -Node: Changing The Namespace929070 -Node: Naming Rules930684 -Node: Internal Name Management932532 -Node: Namespace Example933574 -Node: Namespace And Features936136 -Node: Namespace Summary937571 -Node: Arbitrary Precision Arithmetic939048 -Node: Computer Arithmetic940535 -Ref: table-numeric-ranges944301 -Ref: table-floating-point-ranges944794 -Ref: Computer Arithmetic-Footnote-1945452 -Node: Math Definitions945509 -Ref: table-ieee-formats948825 -Ref: Math Definitions-Footnote-1949428 -Node: MPFR features949533 -Node: FP Math Caution951251 -Ref: FP Math Caution-Footnote-1952323 -Node: Inexactness of computations952692 -Node: Inexact representation953652 -Node: Comparing FP Values955012 -Node: Errors accumulate956253 -Node: Getting Accuracy957686 -Node: Try To Round960396 -Node: Setting precision961295 -Ref: table-predefined-precision-strings961992 -Node: Setting the rounding mode963822 -Ref: table-gawk-rounding-modes964196 -Ref: Setting the rounding mode-Footnote-1968127 -Node: Arbitrary Precision Integers968306 -Ref: Arbitrary Precision Integers-Footnote-1971481 -Node: Checking for MPFR971630 -Node: POSIX Floating Point Problems973104 -Ref: POSIX Floating Point Problems-Footnote-1977389 -Node: Floating point summary977427 -Node: Dynamic Extensions979617 -Node: Extension Intro981170 -Node: Plugin License982436 -Node: Extension Mechanism Outline983233 -Ref: figure-load-extension983672 -Ref: figure-register-new-function985237 -Ref: figure-call-new-function986329 -Node: Extension API Description988391 -Node: Extension API Functions Introduction990033 -Ref: table-api-std-headers991869 -Node: General Data Types995734 -Ref: General Data Types-Footnote-11004095 -Node: Memory Allocation Functions1004394 -Ref: Memory Allocation Functions-Footnote-11008604 -Node: Constructor Functions1008703 -Node: Registration Functions1012289 -Node: Extension Functions1012974 -Node: Exit Callback Functions1018296 -Node: Extension Version String1019546 -Node: Input Parsers1020209 -Node: Output Wrappers1032930 -Node: Two-way processors1037442 -Node: Printing Messages1039707 -Ref: Printing Messages-Footnote-11040878 -Node: Updating ERRNO1041031 -Node: Requesting Values1041770 -Ref: table-value-types-returned1042507 -Node: Accessing Parameters1043443 -Node: Symbol Table Access1044678 -Node: Symbol table by name1045190 -Ref: Symbol table by name-Footnote-11048214 -Node: Symbol table by cookie1048342 -Ref: Symbol table by cookie-Footnote-11052527 -Node: Cached values1052591 -Ref: Cached values-Footnote-11056127 -Node: Array Manipulation1056280 -Ref: Array Manipulation-Footnote-11057371 -Node: Array Data Types1057408 -Ref: Array Data Types-Footnote-11060066 -Node: Array Functions1060158 -Node: Flattening Arrays1064656 -Node: Creating Arrays1071632 -Node: Redirection API1076399 -Node: Extension API Variables1079232 -Node: Extension Versioning1079943 -Ref: gawk-api-version1080372 -Node: Extension GMP/MPFR Versioning1082103 -Node: Extension API Informational Variables1083731 -Node: Extension API Boilerplate1084804 -Node: Changes from API V11088778 -Node: Finding Extensions1090350 -Node: Extension Example1090909 -Node: Internal File Description1091707 -Node: Internal File Ops1095787 -Ref: Internal File Ops-Footnote-11107137 -Node: Using Internal File Ops1107277 -Ref: Using Internal File Ops-Footnote-11109660 -Node: Extension Samples1109934 -Node: Extension Sample File Functions1111463 -Node: Extension Sample Fnmatch1119112 -Node: Extension Sample Fork1120599 -Node: Extension Sample Inplace1121817 -Node: Extension Sample Ord1125442 -Node: Extension Sample Readdir1126278 -Ref: table-readdir-file-types1127167 -Node: Extension Sample Revout1127972 -Node: Extension Sample Rev2way1128561 -Node: Extension Sample Read write array1129301 -Node: Extension Sample Readfile1131243 -Node: Extension Sample Time1132338 -Node: Extension Sample API Tests1133686 -Node: gawkextlib1134178 -Node: Extension summary1137096 -Node: Extension Exercises1140798 -Node: Language History1142040 -Node: V7/SVR3.11143696 -Node: SVR41145848 -Node: POSIX1147282 -Node: BTL1148662 -Node: POSIX/GNU1149391 -Node: Feature History1155169 -Node: Common Extensions1171362 -Node: Ranges and Locales1172645 -Ref: Ranges and Locales-Footnote-11177261 -Ref: Ranges and Locales-Footnote-21177288 -Ref: Ranges and Locales-Footnote-31177523 -Node: Contributors1177744 -Node: History summary1183697 -Node: Installation1185077 -Node: Gawk Distribution1186021 -Node: Getting1186505 -Node: Extracting1187468 -Node: Distribution contents1189106 -Node: Unix Installation1195586 -Node: Quick Installation1196268 -Node: Shell Startup Files1198682 -Node: Additional Configuration Options1199771 -Node: Configuration Philosophy1202086 -Node: Non-Unix Installation1204455 -Node: PC Installation1204915 -Node: PC Binary Installation1205753 -Node: PC Compiling1206188 -Node: PC Using1207305 -Node: Cygwin1210858 -Node: MSYS1211957 -Node: VMS Installation1212458 -Node: VMS Compilation1213249 -Ref: VMS Compilation-Footnote-11214478 -Node: VMS Dynamic Extensions1214536 -Node: VMS Installation Details1216221 -Node: VMS Running1218474 -Node: VMS GNV1222753 -Node: VMS Old Gawk1223488 -Node: Bugs1223959 -Node: Bug address1224622 -Node: Usenet1227604 -Node: Maintainers1228608 -Node: Other Versions1229869 -Node: Installation summary1236957 -Node: Notes1238159 -Node: Compatibility Mode1238953 -Node: Additions1239735 -Node: Accessing The Source1240660 -Node: Adding Code1242097 -Node: New Ports1248316 -Node: Derived Files1252691 -Ref: Derived Files-Footnote-11258351 -Ref: Derived Files-Footnote-21258386 -Ref: Derived Files-Footnote-31258984 -Node: Future Extensions1259098 -Node: Implementation Limitations1259756 -Node: Extension Design1260939 -Node: Old Extension Problems1262083 -Ref: Old Extension Problems-Footnote-11263601 -Node: Extension New Mechanism Goals1263658 -Ref: Extension New Mechanism Goals-Footnote-11267022 -Node: Extension Other Design Decisions1267211 -Node: Extension Future Growth1269324 -Node: Notes summary1270160 -Node: Basic Concepts1271318 -Node: Basic High Level1271999 -Ref: figure-general-flow1272281 -Ref: figure-process-flow1272966 -Ref: Basic High Level-Footnote-11276267 -Node: Basic Data Typing1276452 -Node: Glossary1279780 -Node: Copying1311618 -Node: GNU Free Documentation License1349161 -Node: Index1374281 +Node: Getline/Variable/Pipe267719 +Node: Getline/Coprocess268854 +Node: Getline/Variable/Coprocess270121 +Node: Getline Notes270863 +Node: Getline Summary273660 +Ref: table-getline-variants274084 +Node: Read Timeout274832 +Ref: Read Timeout-Footnote-1278738 +Node: Retrying Input278796 +Node: Command-line directories279995 +Node: Input Summary280901 +Node: Input Exercises284073 +Node: Printing284507 +Node: Print286341 +Node: Print Examples287798 +Node: Output Separators290578 +Node: OFMT292595 +Node: Printf293951 +Node: Basic Printf294736 +Node: Control Letters296310 +Node: Format Modifiers301474 +Node: Printf Examples307489 +Node: Redirection309975 +Node: Special FD316816 +Ref: Special FD-Footnote-1319984 +Node: Special Files320058 +Node: Other Inherited Files320675 +Node: Special Network321676 +Node: Special Caveats322536 +Node: Close Files And Pipes323485 +Ref: table-close-pipe-return-values330392 +Ref: Close Files And Pipes-Footnote-1331205 +Ref: Close Files And Pipes-Footnote-2331353 +Node: Nonfatal331505 +Node: Output Summary333843 +Node: Output Exercises335065 +Node: Expressions335744 +Node: Values336932 +Node: Constants337610 +Node: Scalar Constants338301 +Ref: Scalar Constants-Footnote-1340825 +Node: Nondecimal-numbers341075 +Node: Regexp Constants344076 +Node: Using Constant Regexps344602 +Node: Standard Regexp Constants345224 +Node: Strong Regexp Constants348412 +Node: Variables351370 +Node: Using Variables352027 +Node: Assignment Options353937 +Node: Conversion356404 +Node: Strings And Numbers356928 +Ref: Strings And Numbers-Footnote-1359991 +Node: Locale influences conversions360100 +Ref: table-locale-affects362858 +Node: All Operators363476 +Node: Arithmetic Ops364105 +Node: Concatenation366611 +Ref: Concatenation-Footnote-1369458 +Node: Assignment Ops369565 +Ref: table-assign-ops374556 +Node: Increment Ops375869 +Node: Truth Values and Conditions379329 +Node: Truth Values380403 +Node: Typing and Comparison381451 +Node: Variable Typing382271 +Ref: Variable Typing-Footnote-1388734 +Ref: Variable Typing-Footnote-2388806 +Node: Comparison Operators388883 +Ref: table-relational-ops389302 +Node: POSIX String Comparison392797 +Ref: POSIX String Comparison-Footnote-1394492 +Ref: POSIX String Comparison-Footnote-2394631 +Node: Boolean Ops394715 +Ref: Boolean Ops-Footnote-1399197 +Node: Conditional Exp399289 +Node: Function Calls401025 +Node: Precedence404902 +Node: Locales408561 +Node: Expressions Summary410193 +Node: Patterns and Actions412766 +Node: Pattern Overview413886 +Node: Regexp Patterns415563 +Node: Expression Patterns416105 +Node: Ranges419886 +Node: BEGIN/END422994 +Node: Using BEGIN/END423755 +Ref: Using BEGIN/END-Footnote-1426491 +Node: I/O And BEGIN/END426597 +Node: BEGINFILE/ENDFILE428911 +Node: Empty431824 +Node: Using Shell Variables432141 +Node: Action Overview434415 +Node: Statements436740 +Node: If Statement438588 +Node: While Statement440083 +Node: Do Statement442111 +Node: For Statement443259 +Node: Switch Statement446430 +Node: Break Statement448816 +Node: Continue Statement450908 +Node: Next Statement452735 +Node: Nextfile Statement455118 +Node: Exit Statement457770 +Node: Built-in Variables460173 +Node: User-modified461306 +Node: Auto-set469073 +Ref: Auto-set-Footnote-1485880 +Ref: Auto-set-Footnote-2486086 +Node: ARGC and ARGV486142 +Node: Pattern Action Summary490355 +Node: Arrays492785 +Node: Array Basics494114 +Node: Array Intro494958 +Ref: figure-array-elements496933 +Ref: Array Intro-Footnote-1499637 +Node: Reference to Elements499765 +Node: Assigning Elements502229 +Node: Array Example502720 +Node: Scanning an Array504479 +Node: Controlling Scanning507501 +Ref: Controlling Scanning-Footnote-1512900 +Node: Numeric Array Subscripts513216 +Node: Uninitialized Subscripts515400 +Node: Delete517019 +Ref: Delete-Footnote-1519771 +Node: Multidimensional519828 +Node: Multiscanning522923 +Node: Arrays of Arrays524514 +Node: Arrays Summary529282 +Node: Functions531375 +Node: Built-in532413 +Node: Calling Built-in533494 +Node: Numeric Functions535490 +Ref: Numeric Functions-Footnote-1539518 +Ref: Numeric Functions-Footnote-2540166 +Ref: Numeric Functions-Footnote-3540214 +Node: String Functions540486 +Ref: String Functions-Footnote-1564344 +Ref: String Functions-Footnote-2564472 +Ref: String Functions-Footnote-3564720 +Node: Gory Details564807 +Ref: table-sub-escapes566598 +Ref: table-sub-proposed568117 +Ref: table-posix-sub569480 +Ref: table-gensub-escapes571021 +Ref: Gory Details-Footnote-1571844 +Node: I/O Functions571998 +Ref: table-system-return-values578466 +Ref: I/O Functions-Footnote-1580546 +Ref: I/O Functions-Footnote-2580694 +Node: Time Functions580814 +Ref: Time Functions-Footnote-1591485 +Ref: Time Functions-Footnote-2591553 +Ref: Time Functions-Footnote-3591711 +Ref: Time Functions-Footnote-4591822 +Ref: Time Functions-Footnote-5591934 +Ref: Time Functions-Footnote-6592161 +Node: Bitwise Functions592427 +Ref: table-bitwise-ops593021 +Ref: Bitwise Functions-Footnote-1599084 +Ref: Bitwise Functions-Footnote-2599257 +Node: Type Functions599448 +Node: I18N Functions602311 +Node: User-defined603962 +Node: Definition Syntax604774 +Ref: Definition Syntax-Footnote-1610461 +Node: Function Example610532 +Ref: Function Example-Footnote-1613454 +Node: Function Calling613476 +Node: Calling A Function614064 +Node: Variable Scope615022 +Node: Pass By Value/Reference618016 +Node: Function Caveats620660 +Ref: Function Caveats-Footnote-1622707 +Node: Return Statement622827 +Node: Dynamic Typing625806 +Node: Indirect Calls626736 +Ref: Indirect Calls-Footnote-1636988 +Node: Functions Summary637116 +Node: Library Functions639821 +Ref: Library Functions-Footnote-1643428 +Ref: Library Functions-Footnote-2643571 +Node: Library Names643742 +Ref: Library Names-Footnote-1647409 +Ref: Library Names-Footnote-2647632 +Node: General Functions647718 +Node: Strtonum Function648821 +Node: Assert Function651843 +Node: Round Function655169 +Node: Cliff Random Function656709 +Node: Ordinal Functions657725 +Ref: Ordinal Functions-Footnote-1660788 +Ref: Ordinal Functions-Footnote-2661040 +Node: Join Function661250 +Ref: Join Function-Footnote-1663020 +Node: Getlocaltime Function663220 +Node: Readfile Function666962 +Node: Shell Quoting668939 +Node: Data File Management670340 +Node: Filetrans Function670972 +Node: Rewind Function675068 +Node: File Checking676977 +Ref: File Checking-Footnote-1678311 +Node: Empty Files678512 +Node: Ignoring Assigns680491 +Node: Getopt Function682041 +Ref: Getopt Function-Footnote-1693510 +Node: Passwd Functions693710 +Ref: Passwd Functions-Footnote-1702549 +Node: Group Functions702637 +Ref: Group Functions-Footnote-1710535 +Node: Walking Arrays710742 +Node: Library Functions Summary713750 +Node: Library Exercises715156 +Node: Sample Programs715621 +Node: Running Examples716391 +Node: Clones717119 +Node: Cut Program718343 +Node: Egrep Program728272 +Ref: Egrep Program-Footnote-1735784 +Node: Id Program735894 +Node: Split Program739574 +Ref: Split Program-Footnote-1743032 +Node: Tee Program743161 +Node: Uniq Program745951 +Node: Wc Program753572 +Ref: Wc Program-Footnote-1757827 +Node: Miscellaneous Programs757921 +Node: Dupword Program759134 +Node: Alarm Program761164 +Node: Translate Program766019 +Ref: Translate Program-Footnote-1770584 +Node: Labels Program770854 +Ref: Labels Program-Footnote-1774205 +Node: Word Sorting774289 +Node: History Sorting778361 +Node: Extract Program780196 +Node: Simple Sed788250 +Node: Igawk Program791324 +Ref: Igawk Program-Footnote-1805655 +Ref: Igawk Program-Footnote-2805857 +Ref: Igawk Program-Footnote-3805979 +Node: Anagram Program806094 +Node: Signature Program809156 +Node: Programs Summary810403 +Node: Programs Exercises811617 +Ref: Programs Exercises-Footnote-1815746 +Node: Advanced Features815837 +Node: Nondecimal Data817827 +Node: Array Sorting819418 +Node: Controlling Array Traversal820118 +Ref: Controlling Array Traversal-Footnote-1828486 +Node: Array Sorting Functions828604 +Ref: Array Sorting Functions-Footnote-1833695 +Node: Two-way I/O833891 +Ref: Two-way I/O-Footnote-1841612 +Ref: Two-way I/O-Footnote-2841799 +Node: TCP/IP Networking841881 +Node: Profiling844999 +Node: Advanced Features Summary854014 +Node: Internationalization855858 +Node: I18N and L10N857338 +Node: Explaining gettext858025 +Ref: Explaining gettext-Footnote-1863917 +Ref: Explaining gettext-Footnote-2864102 +Node: Programmer i18n864267 +Ref: Programmer i18n-Footnote-1869216 +Node: Translator i18n869265 +Node: String Extraction870059 +Ref: String Extraction-Footnote-1871191 +Node: Printf Ordering871277 +Ref: Printf Ordering-Footnote-1874063 +Node: I18N Portability874127 +Ref: I18N Portability-Footnote-1876583 +Node: I18N Example876646 +Ref: I18N Example-Footnote-1879921 +Ref: I18N Example-Footnote-2879994 +Node: Gawk I18N880103 +Node: I18N Summary880752 +Node: Debugger882093 +Node: Debugging883093 +Node: Debugging Concepts883534 +Node: Debugging Terms885343 +Node: Awk Debugging887918 +Ref: Awk Debugging-Footnote-1888863 +Node: Sample Debugging Session888995 +Node: Debugger Invocation889529 +Node: Finding The Bug890915 +Node: List of Debugger Commands897389 +Node: Breakpoint Control898722 +Node: Debugger Execution Control902416 +Node: Viewing And Changing Data905778 +Node: Execution Stack909319 +Node: Debugger Info910956 +Node: Miscellaneous Debugger Commands915027 +Node: Readline Support920089 +Node: Limitations920985 +Node: Debugging Summary923539 +Node: Namespaces924818 +Node: Global Namespace925929 +Node: Qualified Names927327 +Node: Default Namespace928326 +Node: Changing The Namespace929067 +Node: Naming Rules930681 +Node: Internal Name Management932529 +Node: Namespace Example933571 +Node: Namespace And Features936133 +Node: Namespace Summary937568 +Node: Arbitrary Precision Arithmetic939045 +Node: Computer Arithmetic940532 +Ref: table-numeric-ranges944298 +Ref: table-floating-point-ranges944791 +Ref: Computer Arithmetic-Footnote-1945449 +Node: Math Definitions945506 +Ref: table-ieee-formats948822 +Ref: Math Definitions-Footnote-1949425 +Node: MPFR features949530 +Node: FP Math Caution951248 +Ref: FP Math Caution-Footnote-1952320 +Node: Inexactness of computations952689 +Node: Inexact representation953649 +Node: Comparing FP Values955009 +Node: Errors accumulate956250 +Node: Getting Accuracy957683 +Node: Try To Round960393 +Node: Setting precision961292 +Ref: table-predefined-precision-strings961989 +Node: Setting the rounding mode963819 +Ref: table-gawk-rounding-modes964193 +Ref: Setting the rounding mode-Footnote-1968124 +Node: Arbitrary Precision Integers968303 +Ref: Arbitrary Precision Integers-Footnote-1971478 +Node: Checking for MPFR971627 +Node: POSIX Floating Point Problems973101 +Ref: POSIX Floating Point Problems-Footnote-1977386 +Node: Floating point summary977424 +Node: Dynamic Extensions979614 +Node: Extension Intro981167 +Node: Plugin License982433 +Node: Extension Mechanism Outline983230 +Ref: figure-load-extension983669 +Ref: figure-register-new-function985234 +Ref: figure-call-new-function986326 +Node: Extension API Description988388 +Node: Extension API Functions Introduction990030 +Ref: table-api-std-headers991866 +Node: General Data Types995731 +Ref: General Data Types-Footnote-11004092 +Node: Memory Allocation Functions1004391 +Ref: Memory Allocation Functions-Footnote-11008601 +Node: Constructor Functions1008700 +Node: Registration Functions1012286 +Node: Extension Functions1012971 +Node: Exit Callback Functions1018293 +Node: Extension Version String1019543 +Node: Input Parsers1020206 +Node: Output Wrappers1032927 +Node: Two-way processors1037439 +Node: Printing Messages1039704 +Ref: Printing Messages-Footnote-11040875 +Node: Updating ERRNO1041028 +Node: Requesting Values1041767 +Ref: table-value-types-returned1042504 +Node: Accessing Parameters1043440 +Node: Symbol Table Access1044675 +Node: Symbol table by name1045187 +Ref: Symbol table by name-Footnote-11048211 +Node: Symbol table by cookie1048339 +Ref: Symbol table by cookie-Footnote-11052524 +Node: Cached values1052588 +Ref: Cached values-Footnote-11056124 +Node: Array Manipulation1056277 +Ref: Array Manipulation-Footnote-11057368 +Node: Array Data Types1057405 +Ref: Array Data Types-Footnote-11060063 +Node: Array Functions1060155 +Node: Flattening Arrays1064653 +Node: Creating Arrays1071629 +Node: Redirection API1076396 +Node: Extension API Variables1079229 +Node: Extension Versioning1079940 +Ref: gawk-api-version1080369 +Node: Extension GMP/MPFR Versioning1082100 +Node: Extension API Informational Variables1083728 +Node: Extension API Boilerplate1084801 +Node: Changes from API V11088775 +Node: Finding Extensions1090347 +Node: Extension Example1090906 +Node: Internal File Description1091704 +Node: Internal File Ops1095784 +Ref: Internal File Ops-Footnote-11107134 +Node: Using Internal File Ops1107274 +Ref: Using Internal File Ops-Footnote-11109657 +Node: Extension Samples1109931 +Node: Extension Sample File Functions1111460 +Node: Extension Sample Fnmatch1119109 +Node: Extension Sample Fork1120596 +Node: Extension Sample Inplace1121814 +Node: Extension Sample Ord1125439 +Node: Extension Sample Readdir1126275 +Ref: table-readdir-file-types1127164 +Node: Extension Sample Revout1127969 +Node: Extension Sample Rev2way1128558 +Node: Extension Sample Read write array1129298 +Node: Extension Sample Readfile1131240 +Node: Extension Sample Time1132335 +Node: Extension Sample API Tests1133683 +Node: gawkextlib1134175 +Node: Extension summary1137093 +Node: Extension Exercises1140795 +Node: Language History1142037 +Node: V7/SVR3.11143693 +Node: SVR41145845 +Node: POSIX1147279 +Node: BTL1148659 +Node: POSIX/GNU1149388 +Node: Feature History1155166 +Node: Common Extensions1171359 +Node: Ranges and Locales1172642 +Ref: Ranges and Locales-Footnote-11177258 +Ref: Ranges and Locales-Footnote-21177285 +Ref: Ranges and Locales-Footnote-31177520 +Node: Contributors1177741 +Node: History summary1183694 +Node: Installation1185074 +Node: Gawk Distribution1186018 +Node: Getting1186502 +Node: Extracting1187465 +Node: Distribution contents1189103 +Node: Unix Installation1195583 +Node: Quick Installation1196265 +Node: Shell Startup Files1198679 +Node: Additional Configuration Options1199768 +Node: Configuration Philosophy1202083 +Node: Non-Unix Installation1204452 +Node: PC Installation1204912 +Node: PC Binary Installation1205750 +Node: PC Compiling1206185 +Node: PC Using1207302 +Node: Cygwin1210855 +Node: MSYS1211954 +Node: VMS Installation1212455 +Node: VMS Compilation1213246 +Ref: VMS Compilation-Footnote-11214475 +Node: VMS Dynamic Extensions1214533 +Node: VMS Installation Details1216218 +Node: VMS Running1218471 +Node: VMS GNV1222750 +Node: VMS Old Gawk1223485 +Node: Bugs1223956 +Node: Bug address1224619 +Node: Usenet1227601 +Node: Maintainers1228605 +Node: Other Versions1229866 +Node: Installation summary1236954 +Node: Notes1238156 +Node: Compatibility Mode1238950 +Node: Additions1239732 +Node: Accessing The Source1240657 +Node: Adding Code1242094 +Node: New Ports1248313 +Node: Derived Files1252688 +Ref: Derived Files-Footnote-11258348 +Ref: Derived Files-Footnote-21258383 +Ref: Derived Files-Footnote-31258981 +Node: Future Extensions1259095 +Node: Implementation Limitations1259753 +Node: Extension Design1260936 +Node: Old Extension Problems1262080 +Ref: Old Extension Problems-Footnote-11263598 +Node: Extension New Mechanism Goals1263655 +Ref: Extension New Mechanism Goals-Footnote-11267019 +Node: Extension Other Design Decisions1267208 +Node: Extension Future Growth1269321 +Node: Notes summary1270157 +Node: Basic Concepts1271315 +Node: Basic High Level1271996 +Ref: figure-general-flow1272278 +Ref: figure-process-flow1272963 +Ref: Basic High Level-Footnote-11276264 +Node: Basic Data Typing1276449 +Node: Glossary1279777 +Node: Copying1311615 +Node: GNU Free Documentation License1349158 +Node: Index1374278 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 46cf5f55..9c6f9e29 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -71,7 +71,7 @@ @set TITLE GAWK: Effective AWK Programming @end ifclear @set SUBTITLE A User's Guide for GNU Awk -@set EDITION 5.0 +@set EDITION 5.1 @iftex @set DOCUMENT book @@ -8836,7 +8836,7 @@ to be portable to all @command{awk} implementations. @quotation NOTE Unfortunately, @command{gawk} has not been consistent in its treatment of a construct like @samp{@w{"echo "} "date" | getline}. -Most versions, including the current version, treat it at as +Most versions, including the current version, treat it as @samp{@w{("echo "} "date") | getline}. (This is also how BWK @command{awk} behaves.) Some versions instead treat it as @@ -11154,7 +11154,7 @@ multiple lines by ending the line with a backslash. For example in C: int main() @{ - printf "hello, \ + printf("hello, \ world\n"); return 0; @} diff --git a/doc/gawktexi.in b/doc/gawktexi.in index a2b2269b..b7dc972b 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -66,7 +66,7 @@ @set TITLE GAWK: Effective AWK Programming @end ifclear @set SUBTITLE A User's Guide for GNU Awk -@set EDITION 5.0 +@set EDITION 5.1 @iftex @set DOCUMENT book @@ -8434,7 +8434,7 @@ to be portable to all @command{awk} implementations. @quotation NOTE Unfortunately, @command{gawk} has not been consistent in its treatment of a construct like @samp{@w{"echo "} "date" | getline}. -Most versions, including the current version, treat it at as +Most versions, including the current version, treat it as @samp{@w{("echo "} "date") | getline}. (This is also how BWK @command{awk} behaves.) Some versions instead treat it as @@ -10639,7 +10639,7 @@ multiple lines by ending the line with a backslash. For example in C: int main() @{ - printf "hello, \ + printf("hello, \ world\n"); return 0; @} |