summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorArnold D. Robbins <arnold@skeeve.com>2013-03-04 15:57:08 +0200
committerArnold D. Robbins <arnold@skeeve.com>2013-03-04 15:57:08 +0200
commitc7cf0616ac46f08398bf6ebaf38ca2ef32a05cdc (patch)
tree584dfc286d80ad6c3ff143674eba1ad7b027c7d2 /doc
parent43e3058aef28766dfd7750adbb5ce862baf8c16a (diff)
downloadgawk-c7cf0616ac46f08398bf6ebaf38ca2ef32a05cdc.tar.gz
Add a nice quote to the doc.
Diffstat (limited to 'doc')
-rw-r--r--doc/ChangeLog4
-rw-r--r--doc/gawk.info866
-rw-r--r--doc/gawk.texi7
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