diff options
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 866 | ||||
| -rw-r--r-- | doc/gawk.texi | 7 |
3 files changed, 446 insertions, 431 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 6a8214b0..34997fab 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2013-03-04 Arnold D. Robbins <arnold@skeeve.com> + + * gawk.texi (Getline/Pipe): Add a nice quote from BWK. + 2013-02-08 Arnold D. Robbins <arnold@skeeve.com> * gawk.texi: Restore centering of text images. diff --git a/doc/gawk.info b/doc/gawk.info index f5358d8d..25120ddb 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -5295,7 +5295,11 @@ File: gawk.info, Node: Getline/Pipe, Next: Getline/Variable/Pipe, Prev: Getli 4.9.5 Using `getline' from a Pipe --------------------------------- -The output of a command can also be piped into `getline', using + Omniscience has much to recommend it. Failing that, attention to + details would be useful. + Brian Kernighan + + The output of a command can also be piped into `getline', using `COMMAND | getline'. In this case, the string COMMAND is run as a shell command and its output is piped into `awk' to be used as input. This form of `getline' reads one record at a time from the pipe. For @@ -29801,7 +29805,7 @@ Index * close() function <1>: I/O Functions. (line 10) * close() function <2>: Close Files And Pipes. (line 18) -* close() function <3>: Getline/Pipe. (line 24) +* close() function <3>: Getline/Pipe. (line 28) * close() function: Getline/Variable/File. (line 30) * close() function, return values: Close Files And Pipes. @@ -30755,7 +30759,7 @@ Index * input files, reading: Reading Files. (line 6) * input files, running awk without: Read Terminal. (line 6) * input files, variable assignments and: Other Arguments. (line 19) -* input pipeline: Getline/Pipe. (line 6) +* input pipeline: Getline/Pipe. (line 10) * input redirection: Getline/File. (line 6) * input, data, nondecimal: Nondecimal Data. (line 6) * input, explicit: Getline. (line 6) @@ -31073,7 +31077,7 @@ Index * operators, input/output <1>: Precedence. (line 65) * operators, input/output <2>: Redirection. (line 22) * operators, input/output <3>: Getline/Coprocess. (line 6) -* operators, input/output <4>: Getline/Pipe. (line 6) +* operators, input/output <4>: Getline/Pipe. (line 10) * operators, input/output: Getline/File. (line 6) * operators, logical, See Boolean expressions: Boolean Ops. (line 6) * operators, precedence <1>: Precedence. (line 6) @@ -31151,7 +31155,7 @@ Index * Peterson, Hal: Contributors. (line 40) * pipes, closing: Close Files And Pipes. (line 6) -* pipes, input: Getline/Pipe. (line 6) +* pipes, input: Getline/Pipe. (line 10) * pipes, output: Redirection. (line 57) * Pitts, Dave <1>: Bugs. (line 73) * Pitts, Dave: Acknowledgments. (line 60) @@ -31238,7 +31242,7 @@ Index * POSIX awk, printf format strings and: Format Modifiers. (line 159) * POSIX awk, regular expressions and: Regexp Operators. (line 161) * POSIX awk, timestamps and: Time Functions. (line 6) -* POSIX awk, | I/O operator and: Getline/Pipe. (line 52) +* POSIX awk, | I/O operator and: Getline/Pipe. (line 56) * POSIX mode: Options. (line 247) * POSIX, awk and: Preface. (line 23) * POSIX, gawk extensions not included in: POSIX/GNU. (line 6) @@ -31440,14 +31444,14 @@ Index * Robbins, Arnold <3>: Contributors. (line 108) * Robbins, Arnold <4>: Alarm Program. (line 6) * Robbins, Arnold <5>: Passwd Functions. (line 90) -* Robbins, Arnold <6>: Getline/Pipe. (line 36) +* Robbins, Arnold <6>: Getline/Pipe. (line 40) * Robbins, Arnold: Command Line Field Separator. (line 80) -* Robbins, Bill: Getline/Pipe. (line 36) +* Robbins, Bill: Getline/Pipe. (line 40) * Robbins, Harry: Acknowledgments. (line 83) * Robbins, Jean: Acknowledgments. (line 83) * Robbins, Miriam <1>: Passwd Functions. (line 90) -* Robbins, Miriam <2>: Getline/Pipe. (line 36) +* Robbins, Miriam <2>: Getline/Pipe. (line 40) * Robbins, Miriam: Acknowledgments. (line 83) * Rommel, Kai Uwe: Contributors. (line 43) * round() user-defined function: Round Function. (line 16) @@ -31828,7 +31832,7 @@ Index * variables, user-defined: Variables. (line 6) * vertical bar (|): Regexp Operators. (line 69) * vertical bar (|), | operator (I/O) <1>: Precedence. (line 65) -* vertical bar (|), | operator (I/O): Getline/Pipe. (line 6) +* vertical bar (|), | operator (I/O): Getline/Pipe. (line 10) * vertical bar (|), |& operator (I/O) <1>: Two-way I/O. (line 44) * vertical bar (|), |& operator (I/O) <2>: Precedence. (line 65) * vertical bar (|), |& operator (I/O): Getline/Coprocess. (line 6) @@ -31884,7 +31888,7 @@ Index * | (vertical bar): Regexp Operators. (line 69) * | (vertical bar), | operator (I/O) <1>: Precedence. (line 65) * | (vertical bar), | operator (I/O) <2>: Redirection. (line 57) -* | (vertical bar), | operator (I/O): Getline/Pipe. (line 6) +* | (vertical bar), | operator (I/O): Getline/Pipe. (line 10) * | (vertical bar), |& operator (I/O) <1>: Two-way I/O. (line 44) * | (vertical bar), |& operator (I/O) <2>: Precedence. (line 65) * | (vertical bar), |& operator (I/O) <3>: Redirection. (line 102) @@ -31999,425 +32003,425 @@ Node: Getline/File232609 Node: Getline/Variable/File233931 Ref: Getline/Variable/File-Footnote-1235530 Node: Getline/Pipe235617 -Node: Getline/Variable/Pipe238177 -Node: Getline/Coprocess239284 -Node: Getline/Variable/Coprocess240527 -Node: Getline Notes241241 -Node: Getline Summary244028 -Ref: table-getline-variants244436 -Node: Read Timeout245294 -Ref: Read Timeout-Footnote-1249039 -Node: Command line directories249096 -Node: Printing249726 -Node: Print251357 -Node: Print Examples252694 -Node: Output Separators255478 -Node: OFMT257238 -Node: Printf258596 -Node: Basic Printf259502 -Node: Control Letters261041 -Node: Format Modifiers264853 -Node: Printf Examples270862 -Node: Redirection273577 -Node: Special Files280561 -Node: Special FD281094 -Ref: Special FD-Footnote-1284719 -Node: Special Network284793 -Node: Special Caveats285643 -Node: Close Files And Pipes286439 -Ref: Close Files And Pipes-Footnote-1293462 -Ref: Close Files And Pipes-Footnote-2293610 -Node: Expressions293760 -Node: Values294892 -Node: Constants295568 -Node: Scalar Constants296248 -Ref: Scalar Constants-Footnote-1297107 -Node: Nondecimal-numbers297289 -Node: Regexp Constants300348 -Node: Using Constant Regexps300823 -Node: Variables303878 -Node: Using Variables304533 -Node: Assignment Options306257 -Node: Conversion308129 -Ref: table-locale-affects313620 -Ref: Conversion-Footnote-1314244 -Node: All Operators314353 -Node: Arithmetic Ops314983 -Node: Concatenation317488 -Ref: Concatenation-Footnote-1320281 -Node: Assignment Ops320401 -Ref: table-assign-ops325389 -Node: Increment Ops326797 -Node: Truth Values and Conditions330267 -Node: Truth Values331350 -Node: Typing and Comparison332399 -Node: Variable Typing333188 -Ref: Variable Typing-Footnote-1337085 -Node: Comparison Operators337207 -Ref: table-relational-ops337617 -Node: POSIX String Comparison341166 -Ref: POSIX String Comparison-Footnote-1342122 -Node: Boolean Ops342260 -Ref: Boolean Ops-Footnote-1346338 -Node: Conditional Exp346429 -Node: Function Calls348161 -Node: Precedence351755 -Node: Locales355424 -Node: Patterns and Actions356513 -Node: Pattern Overview357567 -Node: Regexp Patterns359236 -Node: Expression Patterns359779 -Node: Ranges363464 -Node: BEGIN/END366430 -Node: Using BEGIN/END367192 -Ref: Using BEGIN/END-Footnote-1369923 -Node: I/O And BEGIN/END370029 -Node: BEGINFILE/ENDFILE372311 -Node: Empty375215 -Node: Using Shell Variables375531 -Node: Action Overview377816 -Node: Statements380173 -Node: If Statement382027 -Node: While Statement383526 -Node: Do Statement385570 -Node: For Statement386726 -Node: Switch Statement389878 -Node: Break Statement391975 -Node: Continue Statement393965 -Node: Next Statement395758 -Node: Nextfile Statement398148 -Node: Exit Statement400789 -Node: Built-in Variables403205 -Node: User-modified404300 -Ref: User-modified-Footnote-1412655 -Node: Auto-set412717 -Ref: Auto-set-Footnote-1425068 -Ref: Auto-set-Footnote-2425273 -Node: ARGC and ARGV425329 -Node: Arrays429180 -Node: Array Basics430685 -Node: Array Intro431511 -Node: Reference to Elements435829 -Node: Assigning Elements438099 -Node: Array Example438590 -Node: Scanning an Array440322 -Node: Controlling Scanning442636 -Ref: Controlling Scanning-Footnote-1447569 -Node: Delete447885 -Ref: Delete-Footnote-1450650 -Node: Numeric Array Subscripts450707 -Node: Uninitialized Subscripts452890 -Node: Multi-dimensional454518 -Node: Multi-scanning457612 -Node: Arrays of Arrays459203 -Node: Functions463848 -Node: Built-in464667 -Node: Calling Built-in465745 -Node: Numeric Functions467733 -Ref: Numeric Functions-Footnote-1471565 -Ref: Numeric Functions-Footnote-2471922 -Ref: Numeric Functions-Footnote-3471970 -Node: String Functions472239 -Ref: String Functions-Footnote-1495736 -Ref: String Functions-Footnote-2495865 -Ref: String Functions-Footnote-3496113 -Node: Gory Details496200 -Ref: table-sub-escapes497879 -Ref: table-sub-posix-92499233 -Ref: table-sub-proposed500584 -Ref: table-posix-sub501938 -Ref: table-gensub-escapes503483 -Ref: Gory Details-Footnote-1504690 -Ref: Gory Details-Footnote-2504741 -Node: I/O Functions504892 -Ref: I/O Functions-Footnote-1511997 -Node: Time Functions512144 -Ref: Time Functions-Footnote-1523077 -Ref: Time Functions-Footnote-2523145 -Ref: Time Functions-Footnote-3523303 -Ref: Time Functions-Footnote-4523414 -Ref: Time Functions-Footnote-5523526 -Ref: Time Functions-Footnote-6523753 -Node: Bitwise Functions524019 -Ref: table-bitwise-ops524577 -Ref: Bitwise Functions-Footnote-1528798 -Node: Type Functions528982 -Node: I18N Functions529452 -Node: User-defined531079 -Node: Definition Syntax531883 -Ref: Definition Syntax-Footnote-1536793 -Node: Function Example536862 -Node: Function Caveats539456 -Node: Calling A Function539877 -Node: Variable Scope540992 -Node: Pass By Value/Reference543955 -Node: Return Statement547395 -Node: Dynamic Typing550376 -Node: Indirect Calls551307 -Node: Library Functions560992 -Ref: Library Functions-Footnote-1564505 -Ref: Library Functions-Footnote-2564648 -Node: Library Names564819 -Ref: Library Names-Footnote-1568290 -Ref: Library Names-Footnote-2568510 -Node: General Functions568596 -Node: Strtonum Function569549 -Node: Assert Function572479 -Node: Round Function575805 -Node: Cliff Random Function577348 -Node: Ordinal Functions578364 -Ref: Ordinal Functions-Footnote-1581434 -Ref: Ordinal Functions-Footnote-2581686 -Node: Join Function581895 -Ref: Join Function-Footnote-1583666 -Node: Getlocaltime Function583866 -Node: Data File Management587581 -Node: Filetrans Function588213 -Node: Rewind Function592352 -Node: File Checking593739 -Node: Empty Files594833 -Node: Ignoring Assigns597063 -Node: Getopt Function598616 -Ref: Getopt Function-Footnote-1609920 -Node: Passwd Functions610123 -Ref: Passwd Functions-Footnote-1619098 -Node: Group Functions619186 -Node: Walking Arrays627270 -Node: Sample Programs628839 -Node: Running Examples629516 -Node: Clones630244 -Node: Cut Program631468 -Node: Egrep Program641313 -Ref: Egrep Program-Footnote-1649086 -Node: Id Program649196 -Node: Split Program652812 -Ref: Split Program-Footnote-1656331 -Node: Tee Program656459 -Node: Uniq Program659262 -Node: Wc Program666691 -Ref: Wc Program-Footnote-1670957 -Ref: Wc Program-Footnote-2671157 -Node: Miscellaneous Programs671249 -Node: Dupword Program672437 -Node: Alarm Program674468 -Node: Translate Program679217 -Ref: Translate Program-Footnote-1683604 -Ref: Translate Program-Footnote-2683832 -Node: Labels Program683966 -Ref: Labels Program-Footnote-1687337 -Node: Word Sorting687421 -Node: History Sorting691305 -Node: Extract Program693144 -Ref: Extract Program-Footnote-1700627 -Node: Simple Sed700755 -Node: Igawk Program703817 -Ref: Igawk Program-Footnote-1718974 -Ref: Igawk Program-Footnote-2719175 -Node: Anagram Program719313 -Node: Signature Program722381 -Node: Internationalization723481 -Node: I18N and L10N724913 -Node: Explaining gettext725599 -Ref: Explaining gettext-Footnote-1730665 -Ref: Explaining gettext-Footnote-2730849 -Node: Programmer i18n731014 -Node: Translator i18n735214 -Node: String Extraction736007 -Ref: String Extraction-Footnote-1736968 -Node: Printf Ordering737054 -Ref: Printf Ordering-Footnote-1739838 -Node: I18N Portability739902 -Ref: I18N Portability-Footnote-1742351 -Node: I18N Example742414 -Ref: I18N Example-Footnote-1745049 -Node: Gawk I18N745121 -Node: Advanced Features745738 -Node: Nondecimal Data747242 -Node: Array Sorting748825 -Node: Controlling Array Traversal749522 -Node: Array Sorting Functions757760 -Ref: Array Sorting Functions-Footnote-1761434 -Ref: Array Sorting Functions-Footnote-2761527 -Node: Two-way I/O761721 -Ref: Two-way I/O-Footnote-1767153 -Node: TCP/IP Networking767223 -Node: Profiling770067 -Node: Debugger777521 -Node: Debugging778489 -Node: Debugging Concepts778922 -Node: Debugging Terms780778 -Node: Awk Debugging783375 -Node: Sample Debugging Session784267 -Node: Debugger Invocation784787 -Node: Finding The Bug786116 -Node: List of Debugger Commands792604 -Node: Breakpoint Control793938 -Node: Debugger Execution Control797602 -Node: Viewing And Changing Data800962 -Node: Execution Stack804318 -Node: Debugger Info805785 -Node: Miscellaneous Debugger Commands809766 -Node: Readline Support815211 -Node: Limitations816042 -Node: Arbitrary Precision Arithmetic818294 -Ref: Arbitrary Precision Arithmetic-Footnote-1819936 -Node: General Arithmetic820084 -Node: Floating Point Issues821804 -Node: String Conversion Precision822685 -Ref: String Conversion Precision-Footnote-1824391 -Node: Unexpected Results824500 -Node: POSIX Floating Point Problems826653 -Ref: POSIX Floating Point Problems-Footnote-1830478 -Node: Integer Programming830516 -Node: Floating-point Programming832269 -Ref: Floating-point Programming-Footnote-1838578 -Node: Floating-point Representation838842 -Node: Floating-point Context840007 -Ref: table-ieee-formats840849 -Node: Rounding Mode842233 -Ref: table-rounding-modes842712 -Ref: Rounding Mode-Footnote-1845716 -Node: Gawk and MPFR845897 -Node: Arbitrary Precision Floats847139 -Ref: Arbitrary Precision Floats-Footnote-1849568 -Node: Setting Precision849879 -Node: Setting Rounding Mode852612 -Ref: table-gawk-rounding-modes853016 -Node: Floating-point Constants854196 -Node: Changing Precision855620 -Ref: Changing Precision-Footnote-1857020 -Node: Exact Arithmetic857194 -Node: Arbitrary Precision Integers860302 -Ref: Arbitrary Precision Integers-Footnote-1863302 -Node: Dynamic Extensions863449 -Node: Extension Intro864826 -Node: Plugin License866034 -Node: Extension Mechanism Outline866719 -Ref: load-extension867136 -Ref: load-new-function868614 -Ref: call-new-function869609 -Node: Extension API Description871617 -Node: Extension API Functions Introduction872956 -Node: General Data Types877734 -Ref: General Data Types-Footnote-1883336 -Node: Requesting Values883635 -Ref: table-value-types-returned884366 -Node: Constructor Functions885320 -Node: Registration Functions888316 -Node: Extension Functions889001 -Node: Exit Callback Functions891175 -Node: Extension Version String892418 -Node: Input Parsers893068 -Node: Output Wrappers902785 -Node: Two-way processors907201 -Node: Printing Messages909331 -Ref: Printing Messages-Footnote-1910408 -Node: Updating `ERRNO'910560 -Node: Accessing Parameters911299 -Node: Symbol Table Access912529 -Node: Symbol table by name913041 -Node: Symbol table by cookie914614 -Ref: Symbol table by cookie-Footnote-1918743 -Node: Cached values918806 -Ref: Cached values-Footnote-1922249 -Node: Array Manipulation922340 -Ref: Array Manipulation-Footnote-1923438 -Node: Array Data Types923477 -Ref: Array Data Types-Footnote-1926180 -Node: Array Functions926272 -Node: Flattening Arrays930038 -Node: Creating Arrays936877 -Node: Extension API Variables941672 -Node: Extension Versioning942308 -Node: Extension API Informational Variables944209 -Node: Extension API Boilerplate945295 -Node: Finding Extensions949126 -Node: Extension Example949673 -Node: Internal File Description950411 -Node: Internal File Ops954099 -Ref: Internal File Ops-Footnote-1965546 -Node: Using Internal File Ops965686 -Ref: Using Internal File Ops-Footnote-1968039 -Node: Extension Samples968305 -Node: Extension Sample File Functions969829 -Node: Extension Sample Fnmatch978302 -Node: Extension Sample Fork980028 -Node: Extension Sample Inplace981246 -Node: Extension Sample Ord983038 -Node: Extension Sample Readdir983817 -Node: Extension Sample Revout985321 -Node: Extension Sample Rev2way985914 -Node: Extension Sample Read write array986604 -Node: Extension Sample Readfile988487 -Node: Extension Sample API Tests989244 -Node: Extension Sample Time989769 -Node: gawkextlib991076 -Node: Language History993457 -Node: V7/SVR3.1994979 -Node: SVR4997300 -Node: POSIX998742 -Node: BTL999750 -Node: POSIX/GNU1000555 -Node: Common Extensions1006090 -Node: Ranges and Locales1007197 -Ref: Ranges and Locales-Footnote-11011815 -Ref: Ranges and Locales-Footnote-21011842 -Ref: Ranges and Locales-Footnote-31012102 -Node: Contributors1012323 -Node: Installation1016619 -Node: Gawk Distribution1017513 -Node: Getting1017997 -Node: Extracting1018823 -Node: Distribution contents1020515 -Node: Unix Installation1025776 -Node: Quick Installation1026393 -Node: Additional Configuration Options1028355 -Node: Configuration Philosophy1029832 -Node: Non-Unix Installation1032174 -Node: PC Installation1032632 -Node: PC Binary Installation1033931 -Node: PC Compiling1035779 -Node: PC Testing1038723 -Node: PC Using1039899 -Node: Cygwin1044084 -Node: MSYS1045084 -Node: VMS Installation1045598 -Node: VMS Compilation1046201 -Ref: VMS Compilation-Footnote-11047208 -Node: VMS Installation Details1047266 -Node: VMS Running1048901 -Node: VMS Old Gawk1050508 -Node: Bugs1050982 -Node: Other Versions1054834 -Node: Notes1060164 -Node: Compatibility Mode1060964 -Node: Additions1061747 -Node: Accessing The Source1062674 -Node: Adding Code1064277 -Node: New Ports1070319 -Node: Derived Files1074454 -Ref: Derived Files-Footnote-11079775 -Ref: Derived Files-Footnote-21079809 -Ref: Derived Files-Footnote-31080409 -Node: Future Extensions1080507 -Node: Implementation Limitations1081088 -Node: Extension Design1082340 -Node: Old Extension Problems1083489 -Ref: Old Extension Problems-Footnote-11084997 -Node: Extension New Mechanism Goals1085054 -Ref: Extension New Mechanism Goals-Footnote-11088413 -Node: Extension Other Design Decisions1088599 -Node: Extension Future Growth1090705 -Node: Old Extension Mechansim1091526 -Node: Basic Concepts1093283 -Node: Basic High Level1093964 -Ref: figure-general-flow1094235 -Ref: figure-process-flow1094834 -Ref: Basic High Level-Footnote-11098063 -Node: Basic Data Typing1098248 -Node: Glossary1101603 -Node: Copying1126914 -Node: GNU Free Documentation License1164471 -Node: Index1189608 +Node: Getline/Variable/Pipe238303 +Node: Getline/Coprocess239410 +Node: Getline/Variable/Coprocess240653 +Node: Getline Notes241367 +Node: Getline Summary244154 +Ref: table-getline-variants244562 +Node: Read Timeout245420 +Ref: Read Timeout-Footnote-1249165 +Node: Command line directories249222 +Node: Printing249852 +Node: Print251483 +Node: Print Examples252820 +Node: Output Separators255604 +Node: OFMT257364 +Node: Printf258722 +Node: Basic Printf259628 +Node: Control Letters261167 +Node: Format Modifiers264979 +Node: Printf Examples270988 +Node: Redirection273703 +Node: Special Files280687 +Node: Special FD281220 +Ref: Special FD-Footnote-1284845 +Node: Special Network284919 +Node: Special Caveats285769 +Node: Close Files And Pipes286565 +Ref: Close Files And Pipes-Footnote-1293588 +Ref: Close Files And Pipes-Footnote-2293736 +Node: Expressions293886 +Node: Values295018 +Node: Constants295694 +Node: Scalar Constants296374 +Ref: Scalar Constants-Footnote-1297233 +Node: Nondecimal-numbers297415 +Node: Regexp Constants300474 +Node: Using Constant Regexps300949 +Node: Variables304004 +Node: Using Variables304659 +Node: Assignment Options306383 +Node: Conversion308255 +Ref: table-locale-affects313746 +Ref: Conversion-Footnote-1314370 +Node: All Operators314479 +Node: Arithmetic Ops315109 +Node: Concatenation317614 +Ref: Concatenation-Footnote-1320407 +Node: Assignment Ops320527 +Ref: table-assign-ops325515 +Node: Increment Ops326923 +Node: Truth Values and Conditions330393 +Node: Truth Values331476 +Node: Typing and Comparison332525 +Node: Variable Typing333314 +Ref: Variable Typing-Footnote-1337211 +Node: Comparison Operators337333 +Ref: table-relational-ops337743 +Node: POSIX String Comparison341292 +Ref: POSIX String Comparison-Footnote-1342248 +Node: Boolean Ops342386 +Ref: Boolean Ops-Footnote-1346464 +Node: Conditional Exp346555 +Node: Function Calls348287 +Node: Precedence351881 +Node: Locales355550 +Node: Patterns and Actions356639 +Node: Pattern Overview357693 +Node: Regexp Patterns359362 +Node: Expression Patterns359905 +Node: Ranges363590 +Node: BEGIN/END366556 +Node: Using BEGIN/END367318 +Ref: Using BEGIN/END-Footnote-1370049 +Node: I/O And BEGIN/END370155 +Node: BEGINFILE/ENDFILE372437 +Node: Empty375341 +Node: Using Shell Variables375657 +Node: Action Overview377942 +Node: Statements380299 +Node: If Statement382153 +Node: While Statement383652 +Node: Do Statement385696 +Node: For Statement386852 +Node: Switch Statement390004 +Node: Break Statement392101 +Node: Continue Statement394091 +Node: Next Statement395884 +Node: Nextfile Statement398274 +Node: Exit Statement400915 +Node: Built-in Variables403331 +Node: User-modified404426 +Ref: User-modified-Footnote-1412781 +Node: Auto-set412843 +Ref: Auto-set-Footnote-1425194 +Ref: Auto-set-Footnote-2425399 +Node: ARGC and ARGV425455 +Node: Arrays429306 +Node: Array Basics430811 +Node: Array Intro431637 +Node: Reference to Elements435955 +Node: Assigning Elements438225 +Node: Array Example438716 +Node: Scanning an Array440448 +Node: Controlling Scanning442762 +Ref: Controlling Scanning-Footnote-1447695 +Node: Delete448011 +Ref: Delete-Footnote-1450776 +Node: Numeric Array Subscripts450833 +Node: Uninitialized Subscripts453016 +Node: Multi-dimensional454644 +Node: Multi-scanning457738 +Node: Arrays of Arrays459329 +Node: Functions463974 +Node: Built-in464793 +Node: Calling Built-in465871 +Node: Numeric Functions467859 +Ref: Numeric Functions-Footnote-1471691 +Ref: Numeric Functions-Footnote-2472048 +Ref: Numeric Functions-Footnote-3472096 +Node: String Functions472365 +Ref: String Functions-Footnote-1495862 +Ref: String Functions-Footnote-2495991 +Ref: String Functions-Footnote-3496239 +Node: Gory Details496326 +Ref: table-sub-escapes498005 +Ref: table-sub-posix-92499359 +Ref: table-sub-proposed500710 +Ref: table-posix-sub502064 +Ref: table-gensub-escapes503609 +Ref: Gory Details-Footnote-1504816 +Ref: Gory Details-Footnote-2504867 +Node: I/O Functions505018 +Ref: I/O Functions-Footnote-1512123 +Node: Time Functions512270 +Ref: Time Functions-Footnote-1523203 +Ref: Time Functions-Footnote-2523271 +Ref: Time Functions-Footnote-3523429 +Ref: Time Functions-Footnote-4523540 +Ref: Time Functions-Footnote-5523652 +Ref: Time Functions-Footnote-6523879 +Node: Bitwise Functions524145 +Ref: table-bitwise-ops524703 +Ref: Bitwise Functions-Footnote-1528924 +Node: Type Functions529108 +Node: I18N Functions529578 +Node: User-defined531205 +Node: Definition Syntax532009 +Ref: Definition Syntax-Footnote-1536919 +Node: Function Example536988 +Node: Function Caveats539582 +Node: Calling A Function540003 +Node: Variable Scope541118 +Node: Pass By Value/Reference544081 +Node: Return Statement547521 +Node: Dynamic Typing550502 +Node: Indirect Calls551433 +Node: Library Functions561118 +Ref: Library Functions-Footnote-1564631 +Ref: Library Functions-Footnote-2564774 +Node: Library Names564945 +Ref: Library Names-Footnote-1568416 +Ref: Library Names-Footnote-2568636 +Node: General Functions568722 +Node: Strtonum Function569675 +Node: Assert Function572605 +Node: Round Function575931 +Node: Cliff Random Function577474 +Node: Ordinal Functions578490 +Ref: Ordinal Functions-Footnote-1581560 +Ref: Ordinal Functions-Footnote-2581812 +Node: Join Function582021 +Ref: Join Function-Footnote-1583792 +Node: Getlocaltime Function583992 +Node: Data File Management587707 +Node: Filetrans Function588339 +Node: Rewind Function592478 +Node: File Checking593865 +Node: Empty Files594959 +Node: Ignoring Assigns597189 +Node: Getopt Function598742 +Ref: Getopt Function-Footnote-1610046 +Node: Passwd Functions610249 +Ref: Passwd Functions-Footnote-1619224 +Node: Group Functions619312 +Node: Walking Arrays627396 +Node: Sample Programs628965 +Node: Running Examples629642 +Node: Clones630370 +Node: Cut Program631594 +Node: Egrep Program641439 +Ref: Egrep Program-Footnote-1649212 +Node: Id Program649322 +Node: Split Program652938 +Ref: Split Program-Footnote-1656457 +Node: Tee Program656585 +Node: Uniq Program659388 +Node: Wc Program666817 +Ref: Wc Program-Footnote-1671083 +Ref: Wc Program-Footnote-2671283 +Node: Miscellaneous Programs671375 +Node: Dupword Program672563 +Node: Alarm Program674594 +Node: Translate Program679343 +Ref: Translate Program-Footnote-1683730 +Ref: Translate Program-Footnote-2683958 +Node: Labels Program684092 +Ref: Labels Program-Footnote-1687463 +Node: Word Sorting687547 +Node: History Sorting691431 +Node: Extract Program693270 +Ref: Extract Program-Footnote-1700753 +Node: Simple Sed700881 +Node: Igawk Program703943 +Ref: Igawk Program-Footnote-1719100 +Ref: Igawk Program-Footnote-2719301 +Node: Anagram Program719439 +Node: Signature Program722507 +Node: Internationalization723607 +Node: I18N and L10N725039 +Node: Explaining gettext725725 +Ref: Explaining gettext-Footnote-1730791 +Ref: Explaining gettext-Footnote-2730975 +Node: Programmer i18n731140 +Node: Translator i18n735340 +Node: String Extraction736133 +Ref: String Extraction-Footnote-1737094 +Node: Printf Ordering737180 +Ref: Printf Ordering-Footnote-1739964 +Node: I18N Portability740028 +Ref: I18N Portability-Footnote-1742477 +Node: I18N Example742540 +Ref: I18N Example-Footnote-1745175 +Node: Gawk I18N745247 +Node: Advanced Features745864 +Node: Nondecimal Data747368 +Node: Array Sorting748951 +Node: Controlling Array Traversal749648 +Node: Array Sorting Functions757886 +Ref: Array Sorting Functions-Footnote-1761560 +Ref: Array Sorting Functions-Footnote-2761653 +Node: Two-way I/O761847 +Ref: Two-way I/O-Footnote-1767279 +Node: TCP/IP Networking767349 +Node: Profiling770193 +Node: Debugger777647 +Node: Debugging778615 +Node: Debugging Concepts779048 +Node: Debugging Terms780904 +Node: Awk Debugging783501 +Node: Sample Debugging Session784393 +Node: Debugger Invocation784913 +Node: Finding The Bug786242 +Node: List of Debugger Commands792730 +Node: Breakpoint Control794064 +Node: Debugger Execution Control797728 +Node: Viewing And Changing Data801088 +Node: Execution Stack804444 +Node: Debugger Info805911 +Node: Miscellaneous Debugger Commands809892 +Node: Readline Support815337 +Node: Limitations816168 +Node: Arbitrary Precision Arithmetic818420 +Ref: Arbitrary Precision Arithmetic-Footnote-1820062 +Node: General Arithmetic820210 +Node: Floating Point Issues821930 +Node: String Conversion Precision822811 +Ref: String Conversion Precision-Footnote-1824517 +Node: Unexpected Results824626 +Node: POSIX Floating Point Problems826779 +Ref: POSIX Floating Point Problems-Footnote-1830604 +Node: Integer Programming830642 +Node: Floating-point Programming832395 +Ref: Floating-point Programming-Footnote-1838704 +Node: Floating-point Representation838968 +Node: Floating-point Context840133 +Ref: table-ieee-formats840975 +Node: Rounding Mode842359 +Ref: table-rounding-modes842838 +Ref: Rounding Mode-Footnote-1845842 +Node: Gawk and MPFR846023 +Node: Arbitrary Precision Floats847265 +Ref: Arbitrary Precision Floats-Footnote-1849694 +Node: Setting Precision850005 +Node: Setting Rounding Mode852738 +Ref: table-gawk-rounding-modes853142 +Node: Floating-point Constants854322 +Node: Changing Precision855746 +Ref: Changing Precision-Footnote-1857146 +Node: Exact Arithmetic857320 +Node: Arbitrary Precision Integers860428 +Ref: Arbitrary Precision Integers-Footnote-1863428 +Node: Dynamic Extensions863575 +Node: Extension Intro864952 +Node: Plugin License866160 +Node: Extension Mechanism Outline866845 +Ref: load-extension867262 +Ref: load-new-function868740 +Ref: call-new-function869735 +Node: Extension API Description871743 +Node: Extension API Functions Introduction873082 +Node: General Data Types877860 +Ref: General Data Types-Footnote-1883462 +Node: Requesting Values883761 +Ref: table-value-types-returned884492 +Node: Constructor Functions885446 +Node: Registration Functions888442 +Node: Extension Functions889127 +Node: Exit Callback Functions891301 +Node: Extension Version String892544 +Node: Input Parsers893194 +Node: Output Wrappers902911 +Node: Two-way processors907327 +Node: Printing Messages909457 +Ref: Printing Messages-Footnote-1910534 +Node: Updating `ERRNO'910686 +Node: Accessing Parameters911425 +Node: Symbol Table Access912655 +Node: Symbol table by name913167 +Node: Symbol table by cookie914740 +Ref: Symbol table by cookie-Footnote-1918869 +Node: Cached values918932 +Ref: Cached values-Footnote-1922375 +Node: Array Manipulation922466 +Ref: Array Manipulation-Footnote-1923564 +Node: Array Data Types923603 +Ref: Array Data Types-Footnote-1926306 +Node: Array Functions926398 +Node: Flattening Arrays930164 +Node: Creating Arrays937003 +Node: Extension API Variables941798 +Node: Extension Versioning942434 +Node: Extension API Informational Variables944335 +Node: Extension API Boilerplate945421 +Node: Finding Extensions949252 +Node: Extension Example949799 +Node: Internal File Description950537 +Node: Internal File Ops954225 +Ref: Internal File Ops-Footnote-1965672 +Node: Using Internal File Ops965812 +Ref: Using Internal File Ops-Footnote-1968165 +Node: Extension Samples968431 +Node: Extension Sample File Functions969955 +Node: Extension Sample Fnmatch978428 +Node: Extension Sample Fork980154 +Node: Extension Sample Inplace981372 +Node: Extension Sample Ord983164 +Node: Extension Sample Readdir983943 +Node: Extension Sample Revout985447 +Node: Extension Sample Rev2way986040 +Node: Extension Sample Read write array986730 +Node: Extension Sample Readfile988613 +Node: Extension Sample API Tests989370 +Node: Extension Sample Time989895 +Node: gawkextlib991202 +Node: Language History993583 +Node: V7/SVR3.1995105 +Node: SVR4997426 +Node: POSIX998868 +Node: BTL999876 +Node: POSIX/GNU1000681 +Node: Common Extensions1006216 +Node: Ranges and Locales1007323 +Ref: Ranges and Locales-Footnote-11011941 +Ref: Ranges and Locales-Footnote-21011968 +Ref: Ranges and Locales-Footnote-31012228 +Node: Contributors1012449 +Node: Installation1016745 +Node: Gawk Distribution1017639 +Node: Getting1018123 +Node: Extracting1018949 +Node: Distribution contents1020641 +Node: Unix Installation1025902 +Node: Quick Installation1026519 +Node: Additional Configuration Options1028481 +Node: Configuration Philosophy1029958 +Node: Non-Unix Installation1032300 +Node: PC Installation1032758 +Node: PC Binary Installation1034057 +Node: PC Compiling1035905 +Node: PC Testing1038849 +Node: PC Using1040025 +Node: Cygwin1044210 +Node: MSYS1045210 +Node: VMS Installation1045724 +Node: VMS Compilation1046327 +Ref: VMS Compilation-Footnote-11047334 +Node: VMS Installation Details1047392 +Node: VMS Running1049027 +Node: VMS Old Gawk1050634 +Node: Bugs1051108 +Node: Other Versions1054960 +Node: Notes1060290 +Node: Compatibility Mode1061090 +Node: Additions1061873 +Node: Accessing The Source1062800 +Node: Adding Code1064403 +Node: New Ports1070445 +Node: Derived Files1074580 +Ref: Derived Files-Footnote-11079901 +Ref: Derived Files-Footnote-21079935 +Ref: Derived Files-Footnote-31080535 +Node: Future Extensions1080633 +Node: Implementation Limitations1081214 +Node: Extension Design1082466 +Node: Old Extension Problems1083615 +Ref: Old Extension Problems-Footnote-11085123 +Node: Extension New Mechanism Goals1085180 +Ref: Extension New Mechanism Goals-Footnote-11088539 +Node: Extension Other Design Decisions1088725 +Node: Extension Future Growth1090831 +Node: Old Extension Mechansim1091652 +Node: Basic Concepts1093409 +Node: Basic High Level1094090 +Ref: figure-general-flow1094361 +Ref: figure-process-flow1094960 +Ref: Basic High Level-Footnote-11098189 +Node: Basic Data Typing1098374 +Node: Glossary1101729 +Node: Copying1127040 +Node: GNU Free Documentation License1164597 +Node: Index1189734 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 307f21b5..a5b57712 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -7198,6 +7198,13 @@ that does handle nested @samp{@@include} statements. @node Getline/Pipe @subsection Using @code{getline} from a Pipe +@c From private email, dated October 2, 1988. Used by permission, March 2013. +@quotation +@i{Omniscience has much to recommend it. +Failing that, attention to details would be useful.}@* +Brian Kernighan +@end quotation + @cindex @code{|} (vertical bar), @code{|} operator (I/O) @cindex vertical bar (@code{|}), @code{|} operator (I/O) @cindex input pipeline |