From 06e47b84ed3eb2ec562ee9910d192853f351a0bc Mon Sep 17 00:00:00 2001 From: "Arnold D. Robbins" Date: Wed, 24 Dec 2014 19:39:05 +0200 Subject: Update foreword from Mike Brennan. --- doc/gawk.info | 1109 +++++++++++++++++++++++++++++---------------------------- 1 file changed, 556 insertions(+), 553 deletions(-) (limited to 'doc/gawk.info') diff --git a/doc/gawk.info b/doc/gawk.info index d6fccecd..0224c7d5 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -797,6 +797,9 @@ module loads the C/C++ module as a dynamic plug-in. *note Dynamic Extensions::, has all the details, and as expected, many examples to help you learn the ins and outs. + I enjoy programming in AWK and had fun (re)reading this book. I +think you will too. + Michael Brennan Author of `mawk' October 2014 @@ -31853,7 +31856,7 @@ Index * Brennan, Michael <2>: Simple Sed. (line 25) * Brennan, Michael <3>: Delete. (line 56) * Brennan, Michael <4>: Acknowledgments. (line 78) -* Brennan, Michael <5>: Foreword4. (line 30) +* Brennan, Michael <5>: Foreword4. (line 33) * Brennan, Michael: Foreword3. (line 84) * Brian Kernighan's awk <1>: I/O Functions. (line 43) * Brian Kernighan's awk <2>: Gory Details. (line 19) @@ -34299,557 +34302,557 @@ Tag Table: Node: Top1204 Node: Foreword342156 Node: Foreword446598 -Node: Preface48031 -Ref: Preface-Footnote-150902 -Ref: Preface-Footnote-251009 -Ref: Preface-Footnote-351242 -Node: History51384 -Node: Names53730 -Ref: Names-Footnote-154824 -Node: This Manual54970 -Ref: This Manual-Footnote-161457 -Node: Conventions61557 -Node: Manual History63895 -Ref: Manual History-Footnote-166877 -Ref: Manual History-Footnote-266918 -Node: How To Contribute66992 -Node: Acknowledgments68121 -Node: Getting Started72926 -Node: Running gawk75359 -Node: One-shot76549 -Node: Read Terminal77797 -Node: Long79824 -Node: Executable Scripts81340 -Ref: Executable Scripts-Footnote-184129 -Node: Comments84232 -Node: Quoting86714 -Node: DOS Quoting92238 -Node: Sample Data Files92913 -Node: Very Simple95508 -Node: Two Rules100406 -Node: More Complex102292 -Node: Statements/Lines105154 -Ref: Statements/Lines-Footnote-1109609 -Node: Other Features109874 -Node: When110805 -Ref: When-Footnote-1112559 -Node: Intro Summary112624 -Node: Invoking Gawk113507 -Node: Command Line115021 -Node: Options115819 -Ref: Options-Footnote-1131752 -Ref: Options-Footnote-2131981 -Node: Other Arguments132006 -Node: Naming Standard Input134954 -Node: Environment Variables136047 -Node: AWKPATH Variable136605 -Ref: AWKPATH Variable-Footnote-1139908 -Ref: AWKPATH Variable-Footnote-2139953 -Node: AWKLIBPATH Variable140213 -Node: Other Environment Variables141356 -Node: Exit Status145084 -Node: Include Files145760 -Node: Loading Shared Libraries149357 -Node: Obsolete150784 -Node: Undocumented151481 -Node: Invoking Summary151748 -Node: Regexp153412 -Node: Regexp Usage154866 -Node: Escape Sequences156903 -Node: Regexp Operators162914 -Ref: Regexp Operators-Footnote-1170340 -Ref: Regexp Operators-Footnote-2170487 -Node: Bracket Expressions170585 -Ref: table-char-classes172600 -Node: Leftmost Longest175524 -Node: Computed Regexps176826 -Node: GNU Regexp Operators180223 -Node: Case-sensitivity183896 -Ref: Case-sensitivity-Footnote-1186781 -Ref: Case-sensitivity-Footnote-2187016 -Node: Regexp Summary187124 -Node: Reading Files188591 -Node: Records190685 -Node: awk split records191418 -Node: gawk split records196333 -Ref: gawk split records-Footnote-1200877 -Node: Fields200914 -Ref: Fields-Footnote-1203690 -Node: Nonconstant Fields203776 -Ref: Nonconstant Fields-Footnote-1206019 -Node: Changing Fields206223 -Node: Field Separators212152 -Node: Default Field Splitting214857 -Node: Regexp Field Splitting215974 -Node: Single Character Fields219324 -Node: Command Line Field Separator220383 -Node: Full Line Fields223595 -Ref: Full Line Fields-Footnote-1225112 -Ref: Full Line Fields-Footnote-2225158 -Node: Field Splitting Summary225259 -Node: Constant Size227333 -Node: Splitting By Content231922 -Ref: Splitting By Content-Footnote-1235916 -Node: Multiple Line236079 -Ref: Multiple Line-Footnote-1241965 -Node: Getline242144 -Node: Plain Getline244356 -Node: Getline/Variable246996 -Node: Getline/File248144 -Node: Getline/Variable/File249528 -Ref: Getline/Variable/File-Footnote-1251131 -Node: Getline/Pipe251218 -Node: Getline/Variable/Pipe253901 -Node: Getline/Coprocess255032 -Node: Getline/Variable/Coprocess256284 -Node: Getline Notes257023 -Node: Getline Summary259815 -Ref: table-getline-variants260227 -Node: Read Timeout261056 -Ref: Read Timeout-Footnote-1264881 -Node: Command-line directories264939 -Node: Input Summary265844 -Node: Input Exercises269145 -Node: Printing269873 -Node: Print271650 -Node: Print Examples273107 -Node: Output Separators275886 -Node: OFMT277904 -Node: Printf279258 -Node: Basic Printf280043 -Node: Control Letters281613 -Node: Format Modifiers285596 -Node: Printf Examples291605 -Node: Redirection294091 -Node: Special FD300932 -Ref: Special FD-Footnote-1304092 -Node: Special Files304166 -Node: Other Inherited Files304783 -Node: Special Network305783 -Node: Special Caveats306645 -Node: Close Files And Pipes307596 -Ref: Close Files And Pipes-Footnote-1314778 -Ref: Close Files And Pipes-Footnote-2314926 -Node: Output Summary315076 -Node: Output Exercises316074 -Node: Expressions316754 -Node: Values317939 -Node: Constants318617 -Node: Scalar Constants319308 -Ref: Scalar Constants-Footnote-1320167 -Node: Nondecimal-numbers320417 -Node: Regexp Constants323435 -Node: Using Constant Regexps323960 -Node: Variables327103 -Node: Using Variables327758 -Node: Assignment Options329669 -Node: Conversion331544 -Node: Strings And Numbers332068 -Ref: Strings And Numbers-Footnote-1335133 -Node: Locale influences conversions335242 -Ref: table-locale-affects337989 -Node: All Operators338577 -Node: Arithmetic Ops339207 -Node: Concatenation341712 -Ref: Concatenation-Footnote-1344531 -Node: Assignment Ops344637 -Ref: table-assign-ops349616 -Node: Increment Ops350888 -Node: Truth Values and Conditions354326 -Node: Truth Values355411 -Node: Typing and Comparison356460 -Node: Variable Typing357270 -Node: Comparison Operators360923 -Ref: table-relational-ops361333 -Node: POSIX String Comparison364828 -Ref: POSIX String Comparison-Footnote-1365900 -Node: Boolean Ops366038 -Ref: Boolean Ops-Footnote-1370517 -Node: Conditional Exp370608 -Node: Function Calls372335 -Node: Precedence376215 -Node: Locales379876 -Node: Expressions Summary381508 -Node: Patterns and Actions384068 -Node: Pattern Overview385188 -Node: Regexp Patterns386867 -Node: Expression Patterns387410 -Node: Ranges391120 -Node: BEGIN/END394226 -Node: Using BEGIN/END394987 -Ref: Using BEGIN/END-Footnote-1397721 -Node: I/O And BEGIN/END397827 -Node: BEGINFILE/ENDFILE400141 -Node: Empty403042 -Node: Using Shell Variables403359 -Node: Action Overview405632 -Node: Statements407958 -Node: If Statement409806 -Node: While Statement411301 -Node: Do Statement413330 -Node: For Statement414474 -Node: Switch Statement417631 -Node: Break Statement420013 -Node: Continue Statement422054 -Node: Next Statement423881 -Node: Nextfile Statement426262 -Node: Exit Statement428892 -Node: Built-in Variables431295 -Node: User-modified432428 -Ref: User-modified-Footnote-1440109 -Node: Auto-set440171 -Ref: Auto-set-Footnote-1453206 -Ref: Auto-set-Footnote-2453411 -Node: ARGC and ARGV453467 -Node: Pattern Action Summary457685 -Node: Arrays460112 -Node: Array Basics461441 -Node: Array Intro462285 -Ref: figure-array-elements464249 -Ref: Array Intro-Footnote-1466775 -Node: Reference to Elements466903 -Node: Assigning Elements469355 -Node: Array Example469846 -Node: Scanning an Array471604 -Node: Controlling Scanning474620 -Ref: Controlling Scanning-Footnote-1479816 -Node: Numeric Array Subscripts480132 -Node: Uninitialized Subscripts482317 -Node: Delete483934 -Ref: Delete-Footnote-1486677 -Node: Multidimensional486734 -Node: Multiscanning489831 -Node: Arrays of Arrays491420 -Node: Arrays Summary496179 -Node: Functions498271 -Node: Built-in499170 -Node: Calling Built-in500248 -Node: Numeric Functions502239 -Ref: Numeric Functions-Footnote-1506256 -Ref: Numeric Functions-Footnote-2506613 -Ref: Numeric Functions-Footnote-3506661 -Node: String Functions506933 -Ref: String Functions-Footnote-1530408 -Ref: String Functions-Footnote-2530537 -Ref: String Functions-Footnote-3530785 -Node: Gory Details530872 -Ref: table-sub-escapes532653 -Ref: table-sub-proposed534173 -Ref: table-posix-sub535537 -Ref: table-gensub-escapes537073 -Ref: Gory Details-Footnote-1537905 -Node: I/O Functions538056 -Ref: I/O Functions-Footnote-1545274 -Node: Time Functions545421 -Ref: Time Functions-Footnote-1555909 -Ref: Time Functions-Footnote-2555977 -Ref: Time Functions-Footnote-3556135 -Ref: Time Functions-Footnote-4556246 -Ref: Time Functions-Footnote-5556358 -Ref: Time Functions-Footnote-6556585 -Node: Bitwise Functions556851 -Ref: table-bitwise-ops557413 -Ref: Bitwise Functions-Footnote-1561722 -Node: Type Functions561891 -Node: I18N Functions563042 -Node: User-defined564687 -Node: Definition Syntax565492 -Ref: Definition Syntax-Footnote-1570899 -Node: Function Example570970 -Ref: Function Example-Footnote-1573889 -Node: Function Caveats573911 -Node: Calling A Function574429 -Node: Variable Scope575387 -Node: Pass By Value/Reference578375 -Node: Return Statement581870 -Node: Dynamic Typing584851 -Node: Indirect Calls585780 -Ref: Indirect Calls-Footnote-1597082 -Node: Functions Summary597210 -Node: Library Functions599912 -Ref: Library Functions-Footnote-1603521 -Ref: Library Functions-Footnote-2603664 -Node: Library Names603835 -Ref: Library Names-Footnote-1607289 -Ref: Library Names-Footnote-2607512 -Node: General Functions607598 -Node: Strtonum Function608701 -Node: Assert Function611723 -Node: Round Function615047 -Node: Cliff Random Function616588 -Node: Ordinal Functions617604 -Ref: Ordinal Functions-Footnote-1620667 -Ref: Ordinal Functions-Footnote-2620919 -Node: Join Function621130 -Ref: Join Function-Footnote-1622899 -Node: Getlocaltime Function623099 -Node: Readfile Function626843 -Node: Shell Quoting628813 -Node: Data File Management630214 -Node: Filetrans Function630846 -Node: Rewind Function634902 -Node: File Checking636289 -Ref: File Checking-Footnote-1637621 -Node: Empty Files637822 -Node: Ignoring Assigns639801 -Node: Getopt Function641352 -Ref: Getopt Function-Footnote-1652814 -Node: Passwd Functions653014 -Ref: Passwd Functions-Footnote-1661851 -Node: Group Functions661939 -Ref: Group Functions-Footnote-1669833 -Node: Walking Arrays670046 -Node: Library Functions Summary671649 -Node: Library Exercises673050 -Node: Sample Programs674330 -Node: Running Examples675100 -Node: Clones675828 -Node: Cut Program677052 -Node: Egrep Program686771 -Ref: Egrep Program-Footnote-1694269 -Node: Id Program694379 -Node: Split Program698024 -Ref: Split Program-Footnote-1701472 -Node: Tee Program701600 -Node: Uniq Program704389 -Node: Wc Program711808 -Ref: Wc Program-Footnote-1716058 -Node: Miscellaneous Programs716152 -Node: Dupword Program717365 -Node: Alarm Program719396 -Node: Translate Program724200 -Ref: Translate Program-Footnote-1728765 -Node: Labels Program729035 -Ref: Labels Program-Footnote-1732386 -Node: Word Sorting732470 -Node: History Sorting736541 -Node: Extract Program738377 -Node: Simple Sed745902 -Node: Igawk Program748970 -Ref: Igawk Program-Footnote-1763294 -Ref: Igawk Program-Footnote-2763495 -Ref: Igawk Program-Footnote-3763617 -Node: Anagram Program763732 -Node: Signature Program766789 -Node: Programs Summary768036 -Node: Programs Exercises769229 -Ref: Programs Exercises-Footnote-1773360 -Node: Advanced Features773451 -Node: Nondecimal Data775399 -Node: Array Sorting776989 -Node: Controlling Array Traversal777686 -Ref: Controlling Array Traversal-Footnote-1786019 -Node: Array Sorting Functions786137 -Ref: Array Sorting Functions-Footnote-1790026 -Node: Two-way I/O790222 -Ref: Two-way I/O-Footnote-1795167 -Ref: Two-way I/O-Footnote-2795353 -Node: TCP/IP Networking795435 -Node: Profiling798308 -Node: Advanced Features Summary805855 -Node: Internationalization807788 -Node: I18N and L10N809268 -Node: Explaining gettext809954 -Ref: Explaining gettext-Footnote-1814979 -Ref: Explaining gettext-Footnote-2815163 -Node: Programmer i18n815328 -Ref: Programmer i18n-Footnote-1820194 -Node: Translator i18n820243 -Node: String Extraction821037 -Ref: String Extraction-Footnote-1822168 -Node: Printf Ordering822254 -Ref: Printf Ordering-Footnote-1825040 -Node: I18N Portability825104 -Ref: I18N Portability-Footnote-1827559 -Node: I18N Example827622 -Ref: I18N Example-Footnote-1830425 -Node: Gawk I18N830497 -Node: I18N Summary831135 -Node: Debugger832474 -Node: Debugging833496 -Node: Debugging Concepts833937 -Node: Debugging Terms835790 -Node: Awk Debugging838362 -Node: Sample Debugging Session839256 -Node: Debugger Invocation839776 -Node: Finding The Bug841160 -Node: List of Debugger Commands847635 -Node: Breakpoint Control848968 -Node: Debugger Execution Control852664 -Node: Viewing And Changing Data856028 -Node: Execution Stack859406 -Node: Debugger Info861043 -Node: Miscellaneous Debugger Commands865060 -Node: Readline Support870089 -Node: Limitations870981 -Node: Debugging Summary873095 -Node: Arbitrary Precision Arithmetic874263 -Node: Computer Arithmetic875679 -Ref: table-numeric-ranges879277 -Ref: Computer Arithmetic-Footnote-1880136 -Node: Math Definitions880193 -Ref: table-ieee-formats883481 -Ref: Math Definitions-Footnote-1884085 -Node: MPFR features884190 -Node: FP Math Caution885861 -Ref: FP Math Caution-Footnote-1886911 -Node: Inexactness of computations887280 -Node: Inexact representation888239 -Node: Comparing FP Values889596 -Node: Errors accumulate890678 -Node: Getting Accuracy892111 -Node: Try To Round894773 -Node: Setting precision895672 -Ref: table-predefined-precision-strings896356 -Node: Setting the rounding mode898145 -Ref: table-gawk-rounding-modes898509 -Ref: Setting the rounding mode-Footnote-1901964 -Node: Arbitrary Precision Integers902143 -Ref: Arbitrary Precision Integers-Footnote-1905129 -Node: POSIX Floating Point Problems905278 -Ref: POSIX Floating Point Problems-Footnote-1909151 -Node: Floating point summary909189 -Node: Dynamic Extensions911383 -Node: Extension Intro912935 -Node: Plugin License914201 -Node: Extension Mechanism Outline914998 -Ref: figure-load-extension915426 -Ref: figure-register-new-function916906 -Ref: figure-call-new-function917910 -Node: Extension API Description919896 -Node: Extension API Functions Introduction921346 -Node: General Data Types926170 -Ref: General Data Types-Footnote-1931909 -Node: Memory Allocation Functions932208 -Ref: Memory Allocation Functions-Footnote-1935047 -Node: Constructor Functions935143 -Node: Registration Functions936877 -Node: Extension Functions937562 -Node: Exit Callback Functions939859 -Node: Extension Version String941107 -Node: Input Parsers941772 -Node: Output Wrappers951651 -Node: Two-way processors956166 -Node: Printing Messages958370 -Ref: Printing Messages-Footnote-1959446 -Node: Updating `ERRNO'959598 -Node: Requesting Values960338 -Ref: table-value-types-returned961066 -Node: Accessing Parameters962023 -Node: Symbol Table Access963254 -Node: Symbol table by name963768 -Node: Symbol table by cookie965749 -Ref: Symbol table by cookie-Footnote-1969893 -Node: Cached values969956 -Ref: Cached values-Footnote-1973455 -Node: Array Manipulation973546 -Ref: Array Manipulation-Footnote-1974644 -Node: Array Data Types974681 -Ref: Array Data Types-Footnote-1977336 -Node: Array Functions977428 -Node: Flattening Arrays981282 -Node: Creating Arrays988174 -Node: Extension API Variables992945 -Node: Extension Versioning993581 -Node: Extension API Informational Variables995482 -Node: Extension API Boilerplate996547 -Node: Finding Extensions1000356 -Node: Extension Example1000916 -Node: Internal File Description1001688 -Node: Internal File Ops1005755 -Ref: Internal File Ops-Footnote-11017425 -Node: Using Internal File Ops1017565 -Ref: Using Internal File Ops-Footnote-11019948 -Node: Extension Samples1020221 -Node: Extension Sample File Functions1021747 -Node: Extension Sample Fnmatch1029385 -Node: Extension Sample Fork1030876 -Node: Extension Sample Inplace1032091 -Node: Extension Sample Ord1033766 -Node: Extension Sample Readdir1034602 -Ref: table-readdir-file-types1035478 -Node: Extension Sample Revout1036289 -Node: Extension Sample Rev2way1036879 -Node: Extension Sample Read write array1037619 -Node: Extension Sample Readfile1039559 -Node: Extension Sample Time1040654 -Node: Extension Sample API Tests1042003 -Node: gawkextlib1042494 -Node: Extension summary1045152 -Node: Extension Exercises1048841 -Node: Language History1049563 -Node: V7/SVR3.11051219 -Node: SVR41053400 -Node: POSIX1054845 -Node: BTL1056234 -Node: POSIX/GNU1056968 -Node: Feature History1062532 -Node: Common Extensions1075630 -Node: Ranges and Locales1076954 -Ref: Ranges and Locales-Footnote-11081572 -Ref: Ranges and Locales-Footnote-21081599 -Ref: Ranges and Locales-Footnote-31081833 -Node: Contributors1082054 -Node: History summary1087595 -Node: Installation1088965 -Node: Gawk Distribution1089911 -Node: Getting1090395 -Node: Extracting1091218 -Node: Distribution contents1092853 -Node: Unix Installation1098570 -Node: Quick Installation1099187 -Node: Additional Configuration Options1101611 -Node: Configuration Philosophy1103349 -Node: Non-Unix Installation1105718 -Node: PC Installation1106176 -Node: PC Binary Installation1107495 -Node: PC Compiling1109343 -Ref: PC Compiling-Footnote-11112364 -Node: PC Testing1112473 -Node: PC Using1113649 -Node: Cygwin1117764 -Node: MSYS1118587 -Node: VMS Installation1119087 -Node: VMS Compilation1119879 -Ref: VMS Compilation-Footnote-11121101 -Node: VMS Dynamic Extensions1121159 -Node: VMS Installation Details1122843 -Node: VMS Running1125095 -Node: VMS GNV1127931 -Node: VMS Old Gawk1128665 -Node: Bugs1129135 -Node: Other Versions1133018 -Node: Installation summary1139446 -Node: Notes1140502 -Node: Compatibility Mode1141367 -Node: Additions1142149 -Node: Accessing The Source1143074 -Node: Adding Code1144510 -Node: New Ports1150675 -Node: Derived Files1155157 -Ref: Derived Files-Footnote-11160632 -Ref: Derived Files-Footnote-21160666 -Ref: Derived Files-Footnote-31161262 -Node: Future Extensions1161376 -Node: Implementation Limitations1161982 -Node: Extension Design1163230 -Node: Old Extension Problems1164384 -Ref: Old Extension Problems-Footnote-11165901 -Node: Extension New Mechanism Goals1165958 -Ref: Extension New Mechanism Goals-Footnote-11169318 -Node: Extension Other Design Decisions1169507 -Node: Extension Future Growth1171615 -Node: Old Extension Mechanism1172451 -Node: Notes summary1174213 -Node: Basic Concepts1175399 -Node: Basic High Level1176080 -Ref: figure-general-flow1176352 -Ref: figure-process-flow1176951 -Ref: Basic High Level-Footnote-11180180 -Node: Basic Data Typing1180365 -Node: Glossary1183693 -Node: Copying1208851 -Node: GNU Free Documentation License1246407 -Node: Index1271543 +Node: Preface48120 +Ref: Preface-Footnote-150991 +Ref: Preface-Footnote-251098 +Ref: Preface-Footnote-351331 +Node: History51473 +Node: Names53819 +Ref: Names-Footnote-154913 +Node: This Manual55059 +Ref: This Manual-Footnote-161546 +Node: Conventions61646 +Node: Manual History63984 +Ref: Manual History-Footnote-166966 +Ref: Manual History-Footnote-267007 +Node: How To Contribute67081 +Node: Acknowledgments68210 +Node: Getting Started73015 +Node: Running gawk75448 +Node: One-shot76638 +Node: Read Terminal77886 +Node: Long79913 +Node: Executable Scripts81429 +Ref: Executable Scripts-Footnote-184218 +Node: Comments84321 +Node: Quoting86803 +Node: DOS Quoting92327 +Node: Sample Data Files93002 +Node: Very Simple95597 +Node: Two Rules100495 +Node: More Complex102381 +Node: Statements/Lines105243 +Ref: Statements/Lines-Footnote-1109698 +Node: Other Features109963 +Node: When110894 +Ref: When-Footnote-1112648 +Node: Intro Summary112713 +Node: Invoking Gawk113596 +Node: Command Line115110 +Node: Options115908 +Ref: Options-Footnote-1131841 +Ref: Options-Footnote-2132070 +Node: Other Arguments132095 +Node: Naming Standard Input135043 +Node: Environment Variables136136 +Node: AWKPATH Variable136694 +Ref: AWKPATH Variable-Footnote-1139997 +Ref: AWKPATH Variable-Footnote-2140042 +Node: AWKLIBPATH Variable140302 +Node: Other Environment Variables141445 +Node: Exit Status145173 +Node: Include Files145849 +Node: Loading Shared Libraries149446 +Node: Obsolete150873 +Node: Undocumented151570 +Node: Invoking Summary151837 +Node: Regexp153501 +Node: Regexp Usage154955 +Node: Escape Sequences156992 +Node: Regexp Operators163003 +Ref: Regexp Operators-Footnote-1170429 +Ref: Regexp Operators-Footnote-2170576 +Node: Bracket Expressions170674 +Ref: table-char-classes172689 +Node: Leftmost Longest175613 +Node: Computed Regexps176915 +Node: GNU Regexp Operators180312 +Node: Case-sensitivity183985 +Ref: Case-sensitivity-Footnote-1186870 +Ref: Case-sensitivity-Footnote-2187105 +Node: Regexp Summary187213 +Node: Reading Files188680 +Node: Records190774 +Node: awk split records191507 +Node: gawk split records196422 +Ref: gawk split records-Footnote-1200966 +Node: Fields201003 +Ref: Fields-Footnote-1203779 +Node: Nonconstant Fields203865 +Ref: Nonconstant Fields-Footnote-1206108 +Node: Changing Fields206312 +Node: Field Separators212241 +Node: Default Field Splitting214946 +Node: Regexp Field Splitting216063 +Node: Single Character Fields219413 +Node: Command Line Field Separator220472 +Node: Full Line Fields223684 +Ref: Full Line Fields-Footnote-1225201 +Ref: Full Line Fields-Footnote-2225247 +Node: Field Splitting Summary225348 +Node: Constant Size227422 +Node: Splitting By Content232011 +Ref: Splitting By Content-Footnote-1236005 +Node: Multiple Line236168 +Ref: Multiple Line-Footnote-1242054 +Node: Getline242233 +Node: Plain Getline244445 +Node: Getline/Variable247085 +Node: Getline/File248233 +Node: Getline/Variable/File249617 +Ref: Getline/Variable/File-Footnote-1251220 +Node: Getline/Pipe251307 +Node: Getline/Variable/Pipe253990 +Node: Getline/Coprocess255121 +Node: Getline/Variable/Coprocess256373 +Node: Getline Notes257112 +Node: Getline Summary259904 +Ref: table-getline-variants260316 +Node: Read Timeout261145 +Ref: Read Timeout-Footnote-1264970 +Node: Command-line directories265028 +Node: Input Summary265933 +Node: Input Exercises269234 +Node: Printing269962 +Node: Print271739 +Node: Print Examples273196 +Node: Output Separators275975 +Node: OFMT277993 +Node: Printf279347 +Node: Basic Printf280132 +Node: Control Letters281702 +Node: Format Modifiers285685 +Node: Printf Examples291694 +Node: Redirection294180 +Node: Special FD301021 +Ref: Special FD-Footnote-1304181 +Node: Special Files304255 +Node: Other Inherited Files304872 +Node: Special Network305872 +Node: Special Caveats306734 +Node: Close Files And Pipes307685 +Ref: Close Files And Pipes-Footnote-1314867 +Ref: Close Files And Pipes-Footnote-2315015 +Node: Output Summary315165 +Node: Output Exercises316163 +Node: Expressions316843 +Node: Values318028 +Node: Constants318706 +Node: Scalar Constants319397 +Ref: Scalar Constants-Footnote-1320256 +Node: Nondecimal-numbers320506 +Node: Regexp Constants323524 +Node: Using Constant Regexps324049 +Node: Variables327192 +Node: Using Variables327847 +Node: Assignment Options329758 +Node: Conversion331633 +Node: Strings And Numbers332157 +Ref: Strings And Numbers-Footnote-1335222 +Node: Locale influences conversions335331 +Ref: table-locale-affects338078 +Node: All Operators338666 +Node: Arithmetic Ops339296 +Node: Concatenation341801 +Ref: Concatenation-Footnote-1344620 +Node: Assignment Ops344726 +Ref: table-assign-ops349705 +Node: Increment Ops350977 +Node: Truth Values and Conditions354415 +Node: Truth Values355500 +Node: Typing and Comparison356549 +Node: Variable Typing357359 +Node: Comparison Operators361012 +Ref: table-relational-ops361422 +Node: POSIX String Comparison364917 +Ref: POSIX String Comparison-Footnote-1365989 +Node: Boolean Ops366127 +Ref: Boolean Ops-Footnote-1370606 +Node: Conditional Exp370697 +Node: Function Calls372424 +Node: Precedence376304 +Node: Locales379965 +Node: Expressions Summary381597 +Node: Patterns and Actions384157 +Node: Pattern Overview385277 +Node: Regexp Patterns386956 +Node: Expression Patterns387499 +Node: Ranges391209 +Node: BEGIN/END394315 +Node: Using BEGIN/END395076 +Ref: Using BEGIN/END-Footnote-1397810 +Node: I/O And BEGIN/END397916 +Node: BEGINFILE/ENDFILE400230 +Node: Empty403131 +Node: Using Shell Variables403448 +Node: Action Overview405721 +Node: Statements408047 +Node: If Statement409895 +Node: While Statement411390 +Node: Do Statement413419 +Node: For Statement414563 +Node: Switch Statement417720 +Node: Break Statement420102 +Node: Continue Statement422143 +Node: Next Statement423970 +Node: Nextfile Statement426351 +Node: Exit Statement428981 +Node: Built-in Variables431384 +Node: User-modified432517 +Ref: User-modified-Footnote-1440198 +Node: Auto-set440260 +Ref: Auto-set-Footnote-1453295 +Ref: Auto-set-Footnote-2453500 +Node: ARGC and ARGV453556 +Node: Pattern Action Summary457774 +Node: Arrays460201 +Node: Array Basics461530 +Node: Array Intro462374 +Ref: figure-array-elements464338 +Ref: Array Intro-Footnote-1466864 +Node: Reference to Elements466992 +Node: Assigning Elements469444 +Node: Array Example469935 +Node: Scanning an Array471693 +Node: Controlling Scanning474709 +Ref: Controlling Scanning-Footnote-1479905 +Node: Numeric Array Subscripts480221 +Node: Uninitialized Subscripts482406 +Node: Delete484023 +Ref: Delete-Footnote-1486766 +Node: Multidimensional486823 +Node: Multiscanning489920 +Node: Arrays of Arrays491509 +Node: Arrays Summary496268 +Node: Functions498360 +Node: Built-in499259 +Node: Calling Built-in500337 +Node: Numeric Functions502328 +Ref: Numeric Functions-Footnote-1506345 +Ref: Numeric Functions-Footnote-2506702 +Ref: Numeric Functions-Footnote-3506750 +Node: String Functions507022 +Ref: String Functions-Footnote-1530497 +Ref: String Functions-Footnote-2530626 +Ref: String Functions-Footnote-3530874 +Node: Gory Details530961 +Ref: table-sub-escapes532742 +Ref: table-sub-proposed534262 +Ref: table-posix-sub535626 +Ref: table-gensub-escapes537162 +Ref: Gory Details-Footnote-1537994 +Node: I/O Functions538145 +Ref: I/O Functions-Footnote-1545363 +Node: Time Functions545510 +Ref: Time Functions-Footnote-1555998 +Ref: Time Functions-Footnote-2556066 +Ref: Time Functions-Footnote-3556224 +Ref: Time Functions-Footnote-4556335 +Ref: Time Functions-Footnote-5556447 +Ref: Time Functions-Footnote-6556674 +Node: Bitwise Functions556940 +Ref: table-bitwise-ops557502 +Ref: Bitwise Functions-Footnote-1561811 +Node: Type Functions561980 +Node: I18N Functions563131 +Node: User-defined564776 +Node: Definition Syntax565581 +Ref: Definition Syntax-Footnote-1570988 +Node: Function Example571059 +Ref: Function Example-Footnote-1573978 +Node: Function Caveats574000 +Node: Calling A Function574518 +Node: Variable Scope575476 +Node: Pass By Value/Reference578464 +Node: Return Statement581959 +Node: Dynamic Typing584940 +Node: Indirect Calls585869 +Ref: Indirect Calls-Footnote-1597171 +Node: Functions Summary597299 +Node: Library Functions600001 +Ref: Library Functions-Footnote-1603610 +Ref: Library Functions-Footnote-2603753 +Node: Library Names603924 +Ref: Library Names-Footnote-1607378 +Ref: Library Names-Footnote-2607601 +Node: General Functions607687 +Node: Strtonum Function608790 +Node: Assert Function611812 +Node: Round Function615136 +Node: Cliff Random Function616677 +Node: Ordinal Functions617693 +Ref: Ordinal Functions-Footnote-1620756 +Ref: Ordinal Functions-Footnote-2621008 +Node: Join Function621219 +Ref: Join Function-Footnote-1622988 +Node: Getlocaltime Function623188 +Node: Readfile Function626932 +Node: Shell Quoting628902 +Node: Data File Management630303 +Node: Filetrans Function630935 +Node: Rewind Function634991 +Node: File Checking636378 +Ref: File Checking-Footnote-1637710 +Node: Empty Files637911 +Node: Ignoring Assigns639890 +Node: Getopt Function641441 +Ref: Getopt Function-Footnote-1652903 +Node: Passwd Functions653103 +Ref: Passwd Functions-Footnote-1661940 +Node: Group Functions662028 +Ref: Group Functions-Footnote-1669922 +Node: Walking Arrays670135 +Node: Library Functions Summary671738 +Node: Library Exercises673139 +Node: Sample Programs674419 +Node: Running Examples675189 +Node: Clones675917 +Node: Cut Program677141 +Node: Egrep Program686860 +Ref: Egrep Program-Footnote-1694358 +Node: Id Program694468 +Node: Split Program698113 +Ref: Split Program-Footnote-1701561 +Node: Tee Program701689 +Node: Uniq Program704478 +Node: Wc Program711897 +Ref: Wc Program-Footnote-1716147 +Node: Miscellaneous Programs716241 +Node: Dupword Program717454 +Node: Alarm Program719485 +Node: Translate Program724289 +Ref: Translate Program-Footnote-1728854 +Node: Labels Program729124 +Ref: Labels Program-Footnote-1732475 +Node: Word Sorting732559 +Node: History Sorting736630 +Node: Extract Program738466 +Node: Simple Sed745991 +Node: Igawk Program749059 +Ref: Igawk Program-Footnote-1763383 +Ref: Igawk Program-Footnote-2763584 +Ref: Igawk Program-Footnote-3763706 +Node: Anagram Program763821 +Node: Signature Program766878 +Node: Programs Summary768125 +Node: Programs Exercises769318 +Ref: Programs Exercises-Footnote-1773449 +Node: Advanced Features773540 +Node: Nondecimal Data775488 +Node: Array Sorting777078 +Node: Controlling Array Traversal777775 +Ref: Controlling Array Traversal-Footnote-1786108 +Node: Array Sorting Functions786226 +Ref: Array Sorting Functions-Footnote-1790115 +Node: Two-way I/O790311 +Ref: Two-way I/O-Footnote-1795256 +Ref: Two-way I/O-Footnote-2795442 +Node: TCP/IP Networking795524 +Node: Profiling798397 +Node: Advanced Features Summary805944 +Node: Internationalization807877 +Node: I18N and L10N809357 +Node: Explaining gettext810043 +Ref: Explaining gettext-Footnote-1815068 +Ref: Explaining gettext-Footnote-2815252 +Node: Programmer i18n815417 +Ref: Programmer i18n-Footnote-1820283 +Node: Translator i18n820332 +Node: String Extraction821126 +Ref: String Extraction-Footnote-1822257 +Node: Printf Ordering822343 +Ref: Printf Ordering-Footnote-1825129 +Node: I18N Portability825193 +Ref: I18N Portability-Footnote-1827648 +Node: I18N Example827711 +Ref: I18N Example-Footnote-1830514 +Node: Gawk I18N830586 +Node: I18N Summary831224 +Node: Debugger832563 +Node: Debugging833585 +Node: Debugging Concepts834026 +Node: Debugging Terms835879 +Node: Awk Debugging838451 +Node: Sample Debugging Session839345 +Node: Debugger Invocation839865 +Node: Finding The Bug841249 +Node: List of Debugger Commands847724 +Node: Breakpoint Control849057 +Node: Debugger Execution Control852753 +Node: Viewing And Changing Data856117 +Node: Execution Stack859495 +Node: Debugger Info861132 +Node: Miscellaneous Debugger Commands865149 +Node: Readline Support870178 +Node: Limitations871070 +Node: Debugging Summary873184 +Node: Arbitrary Precision Arithmetic874352 +Node: Computer Arithmetic875768 +Ref: table-numeric-ranges879366 +Ref: Computer Arithmetic-Footnote-1880225 +Node: Math Definitions880282 +Ref: table-ieee-formats883570 +Ref: Math Definitions-Footnote-1884174 +Node: MPFR features884279 +Node: FP Math Caution885950 +Ref: FP Math Caution-Footnote-1887000 +Node: Inexactness of computations887369 +Node: Inexact representation888328 +Node: Comparing FP Values889685 +Node: Errors accumulate890767 +Node: Getting Accuracy892200 +Node: Try To Round894862 +Node: Setting precision895761 +Ref: table-predefined-precision-strings896445 +Node: Setting the rounding mode898234 +Ref: table-gawk-rounding-modes898598 +Ref: Setting the rounding mode-Footnote-1902053 +Node: Arbitrary Precision Integers902232 +Ref: Arbitrary Precision Integers-Footnote-1905218 +Node: POSIX Floating Point Problems905367 +Ref: POSIX Floating Point Problems-Footnote-1909240 +Node: Floating point summary909278 +Node: Dynamic Extensions911472 +Node: Extension Intro913024 +Node: Plugin License914290 +Node: Extension Mechanism Outline915087 +Ref: figure-load-extension915515 +Ref: figure-register-new-function916995 +Ref: figure-call-new-function917999 +Node: Extension API Description919985 +Node: Extension API Functions Introduction921435 +Node: General Data Types926259 +Ref: General Data Types-Footnote-1931998 +Node: Memory Allocation Functions932297 +Ref: Memory Allocation Functions-Footnote-1935136 +Node: Constructor Functions935232 +Node: Registration Functions936966 +Node: Extension Functions937651 +Node: Exit Callback Functions939948 +Node: Extension Version String941196 +Node: Input Parsers941861 +Node: Output Wrappers951740 +Node: Two-way processors956255 +Node: Printing Messages958459 +Ref: Printing Messages-Footnote-1959535 +Node: Updating `ERRNO'959687 +Node: Requesting Values960427 +Ref: table-value-types-returned961155 +Node: Accessing Parameters962112 +Node: Symbol Table Access963343 +Node: Symbol table by name963857 +Node: Symbol table by cookie965838 +Ref: Symbol table by cookie-Footnote-1969982 +Node: Cached values970045 +Ref: Cached values-Footnote-1973544 +Node: Array Manipulation973635 +Ref: Array Manipulation-Footnote-1974733 +Node: Array Data Types974770 +Ref: Array Data Types-Footnote-1977425 +Node: Array Functions977517 +Node: Flattening Arrays981371 +Node: Creating Arrays988263 +Node: Extension API Variables993034 +Node: Extension Versioning993670 +Node: Extension API Informational Variables995571 +Node: Extension API Boilerplate996636 +Node: Finding Extensions1000445 +Node: Extension Example1001005 +Node: Internal File Description1001777 +Node: Internal File Ops1005844 +Ref: Internal File Ops-Footnote-11017514 +Node: Using Internal File Ops1017654 +Ref: Using Internal File Ops-Footnote-11020037 +Node: Extension Samples1020310 +Node: Extension Sample File Functions1021836 +Node: Extension Sample Fnmatch1029474 +Node: Extension Sample Fork1030965 +Node: Extension Sample Inplace1032180 +Node: Extension Sample Ord1033855 +Node: Extension Sample Readdir1034691 +Ref: table-readdir-file-types1035567 +Node: Extension Sample Revout1036378 +Node: Extension Sample Rev2way1036968 +Node: Extension Sample Read write array1037708 +Node: Extension Sample Readfile1039648 +Node: Extension Sample Time1040743 +Node: Extension Sample API Tests1042092 +Node: gawkextlib1042583 +Node: Extension summary1045241 +Node: Extension Exercises1048930 +Node: Language History1049652 +Node: V7/SVR3.11051308 +Node: SVR41053489 +Node: POSIX1054934 +Node: BTL1056323 +Node: POSIX/GNU1057057 +Node: Feature History1062621 +Node: Common Extensions1075719 +Node: Ranges and Locales1077043 +Ref: Ranges and Locales-Footnote-11081661 +Ref: Ranges and Locales-Footnote-21081688 +Ref: Ranges and Locales-Footnote-31081922 +Node: Contributors1082143 +Node: History summary1087684 +Node: Installation1089054 +Node: Gawk Distribution1090000 +Node: Getting1090484 +Node: Extracting1091307 +Node: Distribution contents1092942 +Node: Unix Installation1098659 +Node: Quick Installation1099276 +Node: Additional Configuration Options1101700 +Node: Configuration Philosophy1103438 +Node: Non-Unix Installation1105807 +Node: PC Installation1106265 +Node: PC Binary Installation1107584 +Node: PC Compiling1109432 +Ref: PC Compiling-Footnote-11112453 +Node: PC Testing1112562 +Node: PC Using1113738 +Node: Cygwin1117853 +Node: MSYS1118676 +Node: VMS Installation1119176 +Node: VMS Compilation1119968 +Ref: VMS Compilation-Footnote-11121190 +Node: VMS Dynamic Extensions1121248 +Node: VMS Installation Details1122932 +Node: VMS Running1125184 +Node: VMS GNV1128020 +Node: VMS Old Gawk1128754 +Node: Bugs1129224 +Node: Other Versions1133107 +Node: Installation summary1139535 +Node: Notes1140591 +Node: Compatibility Mode1141456 +Node: Additions1142238 +Node: Accessing The Source1143163 +Node: Adding Code1144599 +Node: New Ports1150764 +Node: Derived Files1155246 +Ref: Derived Files-Footnote-11160721 +Ref: Derived Files-Footnote-21160755 +Ref: Derived Files-Footnote-31161351 +Node: Future Extensions1161465 +Node: Implementation Limitations1162071 +Node: Extension Design1163319 +Node: Old Extension Problems1164473 +Ref: Old Extension Problems-Footnote-11165990 +Node: Extension New Mechanism Goals1166047 +Ref: Extension New Mechanism Goals-Footnote-11169407 +Node: Extension Other Design Decisions1169596 +Node: Extension Future Growth1171704 +Node: Old Extension Mechanism1172540 +Node: Notes summary1174302 +Node: Basic Concepts1175488 +Node: Basic High Level1176169 +Ref: figure-general-flow1176441 +Ref: figure-process-flow1177040 +Ref: Basic High Level-Footnote-11180269 +Node: Basic Data Typing1180454 +Node: Glossary1183782 +Node: Copying1208940 +Node: GNU Free Documentation License1246496 +Node: Index1271632  End Tag Table -- cgit v1.2.3 From 4160a0e1fe1aaf4919162010a33550bc22af9454 Mon Sep 17 00:00:00 2001 From: "Arnold D. Robbins" Date: Fri, 26 Dec 2014 09:41:09 +0200 Subject: Sort the glossary. --- doc/gawk.info | 70 +++++++++++++++++++++++++++++------------------------------ 1 file changed, 35 insertions(+), 35 deletions(-) (limited to 'doc/gawk.info') diff --git a/doc/gawk.info b/doc/gawk.info index 0224c7d5..4b016405 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -29549,13 +29549,11 @@ CHEM Brian Kernighan and Jon Bentley, and is available from `http://netlib.sandia.gov/netlib/typesetting/chem.gz'. -Cookie - A peculiar goodie, token, saying or remembrance produced by or - presented to a program. (With thanks to Professor Doug McIlroy.) - -Coprocess - A subordinate program with which two-way communications is - possible. +Comparison Expression + A relation that is either true or false, such as `a < b'. + Comparison expressions are used in `if', `while', `do', and `for' + statements, and in patterns to select which input records to + process. (*Note Typing and Comparison::.) Compiler A program that translates human-readable source code into @@ -29579,11 +29577,13 @@ Conditional Expression otherwise the value is EXPR3. In either case, only one of EXPR2 and EXPR3 is evaluated. (*Note Conditional Exp::.) -Comparison Expression - A relation that is either true or false, such as `a < b'. - Comparison expressions are used in `if', `while', `do', and `for' - statements, and in patterns to select which input records to - process. (*Note Typing and Comparison::.) +Cookie + A peculiar goodie, token, saying or remembrance produced by or + presented to a program. (With thanks to Professor Doug McIlroy.) + +Coprocess + A subordinate program with which two-way communications is + possible. Curly Braces See "Braces." @@ -29625,15 +29625,15 @@ Dynamic Regular Expression `"foo"', but it may also be an expression whose value can vary. (*Note Computed Regexps::.) +Empty String + See "Null String." + Environment A collection of strings, of the form `NAME=VAL', that each program has available to it. Users generally place values into the environment in order to provide information to various programs. Typical examples are the environment variables `HOME' and `PATH'. -Empty String - See "Null String." - Epoch The date used as the "beginning of time" for timestamps. Time values in most systems are represented as seconds since the epoch, @@ -29688,20 +29688,20 @@ Free Documentation License published and may be copied. (*Note GNU Free Documentation License::.) -Function - A specialized group of statements used to encapsulate general or - program-specific tasks. `awk' has a number of built-in functions, - and also allows you to define your own. (*Note Functions::.) - -FSF - See "Free Software Foundation." - Free Software Foundation A nonprofit organization dedicated to the production and distribution of freely distributable software. It was founded by Richard M. Stallman, the author of the original Emacs editor. GNU Emacs is the most widely used version of Emacs today. +FSF + See "Free Software Foundation." + +Function + A specialized group of statements used to encapsulate general or + program-specific tasks. `awk' has a number of built-in functions, + and also allows you to define your own. (*Note Functions::.) + `gawk' The GNU implementation of `awk'. @@ -29801,12 +29801,12 @@ Lesser General Public License archives or shared objects, and their source code may be distributed. -Linux - See "GNU/Linux." - LGPL See "Lesser General Public License." +Linux + See "GNU/Linux." + Localization The process of providing the data necessary for an internationalized program to work in a particular language. @@ -29945,13 +29945,13 @@ Search Path source files. In the shell, a list of directories to search for executable programs. +`sed' + See "Stream Editor." + Seed The initial value, or starting point, for a sequence of random numbers. -`sed' - See "Stream Editor." - Shell The command interpreter for Unix and POSIX-compliant systems. The shell works both interactively, and as a programming language for @@ -32010,7 +32010,7 @@ Index * compatibility mode (gawk), octal numbers: Nondecimal-numbers. (line 60) * compatibility mode (gawk), specifying: Options. (line 81) -* compiled programs <1>: Glossary. (line 157) +* compiled programs <1>: Glossary. (line 155) * compiled programs: Basic High Level. (line 15) * compiling gawk for Cygwin: Cygwin. (line 6) * compiling gawk for MS-DOS and MS-Windows: PC Compiling. (line 13) @@ -32056,7 +32056,7 @@ Index * CONVFMT variable: Strings And Numbers. (line 29) * CONVFMT variable, and array subscripts: Numeric Array Subscripts. (line 6) -* cookie: Glossary. (line 149) +* cookie: Glossary. (line 177) * coprocesses <1>: Two-way I/O. (line 25) * coprocesses: Redirection. (line 96) * coprocesses, closing: Close Files And Pipes. @@ -32672,7 +32672,7 @@ Index * frame debugger command: Execution Stack. (line 27) * Free Documentation License (FDL): GNU Free Documentation License. (line 7) -* Free Software Foundation (FSF) <1>: Glossary. (line 296) +* Free Software Foundation (FSF) <1>: Glossary. (line 288) * Free Software Foundation (FSF) <2>: Getting. (line 10) * Free Software Foundation (FSF): Manual History. (line 6) * FreeBSD: Glossary. (line 611) @@ -32689,7 +32689,7 @@ Index * FS, containing ^: Regexp Field Splitting. (line 59) * FS, in multiline records: Multiple Line. (line 41) -* FSF (Free Software Foundation) <1>: Glossary. (line 296) +* FSF (Free Software Foundation) <1>: Glossary. (line 288) * FSF (Free Software Foundation) <2>: Getting. (line 10) * FSF (Free Software Foundation): Manual History. (line 6) * fts() extension function: Extension Sample File Functions. @@ -33208,7 +33208,7 @@ Index * mawk utility <4>: Getline/Pipe. (line 62) * mawk utility: Escape Sequences. (line 117) * maximum precision supported by MPFR library: Auto-set. (line 221) -* McIlroy, Doug: Glossary. (line 149) +* McIlroy, Doug: Glossary. (line 177) * McPhee, Patrick: Contributors. (line 100) * message object files: Explaining gettext. (line 42) * message object files, converting from portable object files: I18N Example. @@ -33959,7 +33959,7 @@ Index * square root: Numeric Functions. (line 77) * srand: Numeric Functions. (line 81) * stack frame: Debugging Terms. (line 10) -* Stallman, Richard <1>: Glossary. (line 296) +* Stallman, Richard <1>: Glossary. (line 288) * Stallman, Richard <2>: Contributors. (line 23) * Stallman, Richard <3>: Acknowledgments. (line 18) * Stallman, Richard: Manual History. (line 6) -- cgit v1.2.3