diff options
author | Andrew J. Schorr <aschorr@telemetry-investments.com> | 2015-01-05 13:45:40 -0500 |
---|---|---|
committer | Andrew J. Schorr <aschorr@telemetry-investments.com> | 2015-01-05 13:45:40 -0500 |
commit | e81b32fd38fb79595e7773670818f78e9a3e2df2 (patch) | |
tree | 9695d7afb58526580f66043ddbf362d71d428fdb | |
parent | 4323eba6170c7aee1661d834a9b7c177a10b7764 (diff) | |
download | egawk-e81b32fd38fb79595e7773670818f78e9a3e2df2.tar.gz egawk-e81b32fd38fb79595e7773670818f78e9a3e2df2.tar.bz2 egawk-e81b32fd38fb79595e7773670818f78e9a3e2df2.zip |
In texinfo docs, replace "Retrying I/O" with more accurate "Retrying Input".
-rw-r--r-- | doc/ChangeLog | 5 | ||||
-rw-r--r-- | doc/gawk.info | 1143 | ||||
-rw-r--r-- | doc/gawk.texi | 20 | ||||
-rw-r--r-- | doc/gawktexi.in | 20 |
4 files changed, 597 insertions, 591 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index de948bda..a995b66d 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2015-01-05 Andrew J. Schorr <aschorr@telemetry-investments.com> + + * gawktexi.in: Replace "Retrying I/O" with "Retrying Input", since this + feature pertains to input, not output. + 2015-01-04 Andrew J. Schorr <aschorr@telemetry-investments.com> * gawktexi.in: Document the get_file API function. diff --git a/doc/gawk.info b/doc/gawk.info index 9513e5d6..60e0f6f9 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -217,7 +217,7 @@ entitled "GNU Free Documentation License". `getline'. * Getline Summary:: Summary of `getline' Variants. * Read Timeout:: Reading input with a timeout. -* Retrying I/O:: Retrying I/O after certain errors. +* Retrying Input:: Retrying input after certain errors. * Command-line directories:: What happens if you put a directory on the command line. * Input Summary:: Input summary. @@ -4170,7 +4170,7 @@ have to be named on the `awk' command line (*note Getline::). * Getline:: Reading files under explicit program control using the `getline' function. * Read Timeout:: Reading input with a timeout. -* Retrying I/O:: Retrying I/O after certain errors. +* Retrying Input:: Retrying input after certain errors. * Command-line directories:: What happens if you put a directory on the command line. * Input Summary:: Input summary. @@ -5445,7 +5445,7 @@ record, such as a file that cannot be opened, then `getline' returns describing the error that occurred. If the `errno' variable indicates that the I/O operation may be retried, and `PROCINFO["input", "RETRY"]' is set, then -2 will be returned instead of -1, and further calls to -`getline' may be attemped. *Note Retrying I/O::, for further +`getline' may be attemped. *Note Retrying Input::, for further information about this feature. In the following examples, COMMAND stands for a string value that @@ -5883,7 +5883,7 @@ VAR Table 4.1: `getline' variants and what they set -File: gawk.info, Node: Read Timeout, Next: Retrying I/O, Prev: Getline, Up: Reading Files +File: gawk.info, Node: Read Timeout, Next: Retrying Input, Prev: Getline, Up: Reading Files 4.10 Reading Input with a Timeout ================================= @@ -5963,7 +5963,7 @@ a per command or connection basis. attempt to read from the underlying device may succeed in a later attempt. This is a limitation, and it also means that you cannot use this to multiplex input from two or more sources. *Note Retrying -I/O::, for a way to enable later I/O attempts to succeed. +Input::, for a way to enable later I/O attempts to succeed. Assigning a timeout value prevents read operations from blocking indefinitely. But bear in mind that there are other ways `gawk' can @@ -5978,10 +5978,10 @@ writing. (1) This assumes that standard input is the keyboard. -File: gawk.info, Node: Retrying I/O, Next: Command-line directories, Prev: Read Timeout, Up: Reading Files +File: gawk.info, Node: Retrying Input, Next: Command-line directories, Prev: Read Timeout, Up: Reading Files -4.11 Retrying I/O on Certain Input Errors -========================================= +4.11 Retrying Reads After Certain Input Errors +============================================== This minor node describes a feature that is specific to `gawk'. @@ -6005,7 +6005,7 @@ EAGAIN, EWOULDBLOCK, EINTR, or ETIMEDOUT. configured to behave in a non-blocking fashion. -File: gawk.info, Node: Command-line directories, Next: Input Summary, Prev: Retrying I/O, Up: Reading Files +File: gawk.info, Node: Command-line directories, Next: Input Summary, Prev: Retrying Input, Up: Reading Files 4.12 Directories on the Command Line ==================================== @@ -10565,9 +10565,9 @@ Options::), they are not special: open input file, pipe, or coprocess. *Note Read Timeout::, for more information. - * It may be used to indicate that I/O may be retried when it - fails due to certain errors. *Note Retrying I/O::, for more - information. + * It may be used to indicate that input may be retried when it + fails due to certain errors. *Note Retrying Input::, for + more information. * It may be used to cause coprocesses to communicate over pseudo-ttys instead of through two-way pipes; this is @@ -32580,7 +32580,8 @@ Index (line 43) * differences in awk and gawk, regular expressions: Case-sensitivity. (line 26) -* differences in awk and gawk, retrying I/O: Retrying I/O. (line 6) +* differences in awk and gawk, retrying input: Retrying Input. + (line 6) * differences in awk and gawk, RS/RT variables: gawk split records. (line 58) * differences in awk and gawk, RT variable: Auto-set. (line 292) @@ -33973,7 +33974,7 @@ Index * relational operators, See comparison operators: Typing and Comparison. (line 9) * replace in string: String Functions. (line 408) -* retrying I/O: Retrying I/O. (line 6) +* retrying input: Retrying Input. (line 6) * return debugger command: Debugger Execution Control. (line 54) * return statement, user-defined functions: Return Statement. (line 6) @@ -34562,562 +34563,562 @@ Index Tag Table: Node: Top1204 -Node: Foreword342383 -Node: Foreword446825 -Node: Preface48347 -Ref: Preface-Footnote-151218 -Ref: Preface-Footnote-251325 -Ref: Preface-Footnote-351558 -Node: History51700 -Node: Names54046 -Ref: Names-Footnote-155140 -Node: This Manual55286 -Ref: This Manual-Footnote-161773 -Node: Conventions61873 -Node: Manual History64211 -Ref: Manual History-Footnote-167193 -Ref: Manual History-Footnote-267234 -Node: How To Contribute67308 -Node: Acknowledgments68437 -Node: Getting Started73242 -Node: Running gawk75675 -Node: One-shot76865 -Node: Read Terminal78113 -Node: Long80140 -Node: Executable Scripts81656 -Ref: Executable Scripts-Footnote-184445 -Node: Comments84548 -Node: Quoting87030 -Node: DOS Quoting92554 -Node: Sample Data Files93229 -Node: Very Simple95824 -Node: Two Rules100722 -Node: More Complex102608 -Node: Statements/Lines105470 -Ref: Statements/Lines-Footnote-1109925 -Node: Other Features110190 -Node: When111121 -Ref: When-Footnote-1112875 -Node: Intro Summary112940 -Node: Invoking Gawk113823 -Node: Command Line115337 -Node: Options116135 -Ref: Options-Footnote-1131939 -Ref: Options-Footnote-2132168 -Node: Other Arguments132193 -Node: Naming Standard Input135141 -Node: Environment Variables136234 -Node: AWKPATH Variable136792 -Ref: AWKPATH Variable-Footnote-1140205 -Ref: AWKPATH Variable-Footnote-2140250 -Node: AWKLIBPATH Variable140510 -Node: Other Environment Variables141766 -Node: Exit Status145254 -Node: Include Files145930 -Node: Loading Shared Libraries149527 -Node: Obsolete150954 -Node: Undocumented151651 -Node: Invoking Summary151918 -Node: Regexp153582 -Node: Regexp Usage155036 -Node: Escape Sequences157073 -Node: Regexp Operators163314 -Ref: Regexp Operators-Footnote-1170740 -Ref: Regexp Operators-Footnote-2170887 -Node: Bracket Expressions170985 -Ref: table-char-classes173000 -Node: Leftmost Longest175924 -Node: Computed Regexps177226 -Node: GNU Regexp Operators180623 -Node: Case-sensitivity184296 -Ref: Case-sensitivity-Footnote-1187181 -Ref: Case-sensitivity-Footnote-2187416 -Node: Regexp Summary187524 -Node: Reading Files188991 -Node: Records191152 -Node: awk split records191885 -Node: gawk split records196800 -Ref: gawk split records-Footnote-1201344 -Node: Fields201381 -Ref: Fields-Footnote-1204157 -Node: Nonconstant Fields204243 -Ref: Nonconstant Fields-Footnote-1206486 -Node: Changing Fields206690 -Node: Field Separators212619 -Node: Default Field Splitting215324 -Node: Regexp Field Splitting216441 -Node: Single Character Fields219791 -Node: Command Line Field Separator220850 -Node: Full Line Fields224062 -Ref: Full Line Fields-Footnote-1225579 -Ref: Full Line Fields-Footnote-2225625 -Node: Field Splitting Summary225726 -Node: Constant Size227800 -Node: Splitting By Content232389 -Ref: Splitting By Content-Footnote-1236383 -Node: Multiple Line236546 -Ref: Multiple Line-Footnote-1242432 -Node: Getline242611 -Node: Plain Getline245093 -Node: Getline/Variable247733 -Node: Getline/File248881 -Node: Getline/Variable/File250265 -Ref: Getline/Variable/File-Footnote-1251868 -Node: Getline/Pipe251955 -Node: Getline/Variable/Pipe254638 -Node: Getline/Coprocess255769 -Node: Getline/Variable/Coprocess257021 -Node: Getline Notes257760 -Node: Getline Summary260552 -Ref: table-getline-variants260964 -Node: Read Timeout261793 -Ref: Read Timeout-Footnote-1265680 -Node: Retrying I/O265738 -Node: Command-line directories266921 -Node: Input Summary267826 -Node: Input Exercises271127 -Node: Printing271855 -Node: Print273632 -Node: Print Examples275089 -Node: Output Separators277868 -Node: OFMT279886 -Node: Printf281240 -Node: Basic Printf282025 -Node: Control Letters283595 -Node: Format Modifiers287578 -Node: Printf Examples293587 -Node: Redirection296073 -Node: Special FD302914 -Ref: Special FD-Footnote-1306074 -Node: Special Files306148 -Node: Other Inherited Files306765 -Node: Special Network307765 -Node: Special Caveats308627 -Node: Close Files And Pipes309578 -Ref: Close Files And Pipes-Footnote-1316760 -Ref: Close Files And Pipes-Footnote-2316908 -Node: Output Summary317058 -Node: Output Exercises318056 -Node: Expressions318736 -Node: Values319921 -Node: Constants320599 -Node: Scalar Constants321290 -Ref: Scalar Constants-Footnote-1322149 -Node: Nondecimal-numbers322399 -Node: Regexp Constants325417 -Node: Using Constant Regexps325942 -Node: Variables329085 -Node: Using Variables329740 -Node: Assignment Options331651 -Node: Conversion333526 -Node: Strings And Numbers334050 -Ref: Strings And Numbers-Footnote-1337115 -Node: Locale influences conversions337224 -Ref: table-locale-affects339971 -Node: All Operators340559 -Node: Arithmetic Ops341189 -Node: Concatenation343694 -Ref: Concatenation-Footnote-1346513 -Node: Assignment Ops346619 -Ref: table-assign-ops351598 -Node: Increment Ops352870 -Node: Truth Values and Conditions356308 -Node: Truth Values357393 -Node: Typing and Comparison358442 -Node: Variable Typing359252 -Node: Comparison Operators362905 -Ref: table-relational-ops363315 -Node: POSIX String Comparison366810 -Ref: POSIX String Comparison-Footnote-1367882 -Node: Boolean Ops368020 -Ref: Boolean Ops-Footnote-1372499 -Node: Conditional Exp372590 -Node: Function Calls374317 -Node: Precedence378197 -Node: Locales381858 -Node: Expressions Summary383490 -Node: Patterns and Actions386050 -Node: Pattern Overview387170 -Node: Regexp Patterns388849 -Node: Expression Patterns389392 -Node: Ranges393102 -Node: BEGIN/END396208 -Node: Using BEGIN/END396969 -Ref: Using BEGIN/END-Footnote-1399703 -Node: I/O And BEGIN/END399809 -Node: BEGINFILE/ENDFILE402123 -Node: Empty405024 -Node: Using Shell Variables405341 -Node: Action Overview407614 -Node: Statements409940 -Node: If Statement411788 -Node: While Statement413283 -Node: Do Statement415312 -Node: For Statement416456 -Node: Switch Statement419613 -Node: Break Statement421995 -Node: Continue Statement424036 -Node: Next Statement425863 -Node: Nextfile Statement428244 -Node: Exit Statement430874 -Node: Built-in Variables433277 -Node: User-modified434410 -Ref: User-modified-Footnote-1442091 -Node: Auto-set442153 -Ref: Auto-set-Footnote-1456365 -Ref: Auto-set-Footnote-2456570 -Node: ARGC and ARGV456626 -Node: Pattern Action Summary460844 -Node: Arrays463271 -Node: Array Basics464600 -Node: Array Intro465444 -Ref: figure-array-elements467408 -Ref: Array Intro-Footnote-1469934 -Node: Reference to Elements470062 -Node: Assigning Elements472514 -Node: Array Example473005 -Node: Scanning an Array474763 -Node: Controlling Scanning477779 -Ref: Controlling Scanning-Footnote-1482975 -Node: Numeric Array Subscripts483291 -Node: Uninitialized Subscripts485476 -Node: Delete487093 -Ref: Delete-Footnote-1489836 -Node: Multidimensional489893 -Node: Multiscanning492990 -Node: Arrays of Arrays494579 -Node: Arrays Summary499338 -Node: Functions501430 -Node: Built-in502329 -Node: Calling Built-in503407 -Node: Numeric Functions505398 -Ref: Numeric Functions-Footnote-1510217 -Ref: Numeric Functions-Footnote-2510574 -Ref: Numeric Functions-Footnote-3510622 -Node: String Functions510894 -Ref: String Functions-Footnote-1534369 -Ref: String Functions-Footnote-2534498 -Ref: String Functions-Footnote-3534746 -Node: Gory Details534833 -Ref: table-sub-escapes536614 -Ref: table-sub-proposed538134 -Ref: table-posix-sub539498 -Ref: table-gensub-escapes541034 -Ref: Gory Details-Footnote-1541866 -Node: I/O Functions542017 -Ref: I/O Functions-Footnote-1549235 -Node: Time Functions549382 -Ref: Time Functions-Footnote-1559870 -Ref: Time Functions-Footnote-2559938 -Ref: Time Functions-Footnote-3560096 -Ref: Time Functions-Footnote-4560207 -Ref: Time Functions-Footnote-5560319 -Ref: Time Functions-Footnote-6560546 -Node: Bitwise Functions560812 -Ref: table-bitwise-ops561374 -Ref: Bitwise Functions-Footnote-1565683 -Node: Type Functions565852 -Node: I18N Functions567003 -Node: User-defined568648 -Node: Definition Syntax569453 -Ref: Definition Syntax-Footnote-1574860 -Node: Function Example574931 -Ref: Function Example-Footnote-1577850 -Node: Function Caveats577872 -Node: Calling A Function578390 -Node: Variable Scope579348 -Node: Pass By Value/Reference582336 -Node: Return Statement585831 -Node: Dynamic Typing588812 -Node: Indirect Calls589741 -Ref: Indirect Calls-Footnote-1601043 -Node: Functions Summary601171 -Node: Library Functions603873 -Ref: Library Functions-Footnote-1607482 -Ref: Library Functions-Footnote-2607625 -Node: Library Names607796 -Ref: Library Names-Footnote-1611250 -Ref: Library Names-Footnote-2611473 -Node: General Functions611559 -Node: Strtonum Function612662 -Node: Assert Function615684 -Node: Round Function619008 -Node: Cliff Random Function620549 -Node: Ordinal Functions621565 -Ref: Ordinal Functions-Footnote-1624628 -Ref: Ordinal Functions-Footnote-2624880 -Node: Join Function625091 -Ref: Join Function-Footnote-1626860 -Node: Getlocaltime Function627060 -Node: Readfile Function630804 -Node: Shell Quoting632774 -Node: Data File Management634175 -Node: Filetrans Function634807 -Node: Rewind Function638863 -Node: File Checking640250 -Ref: File Checking-Footnote-1641582 -Node: Empty Files641783 -Node: Ignoring Assigns643762 -Node: Getopt Function645313 -Ref: Getopt Function-Footnote-1656775 -Node: Passwd Functions656975 -Ref: Passwd Functions-Footnote-1665812 -Node: Group Functions665900 -Ref: Group Functions-Footnote-1673794 -Node: Walking Arrays674007 -Node: Library Functions Summary675610 -Node: Library Exercises677011 -Node: Sample Programs678291 -Node: Running Examples679061 -Node: Clones679789 -Node: Cut Program681013 -Node: Egrep Program690732 -Ref: Egrep Program-Footnote-1698230 -Node: Id Program698340 -Node: Split Program701985 -Ref: Split Program-Footnote-1705433 -Node: Tee Program705561 -Node: Uniq Program708350 -Node: Wc Program715769 -Ref: Wc Program-Footnote-1720019 -Node: Miscellaneous Programs720113 -Node: Dupword Program721326 -Node: Alarm Program723357 -Node: Translate Program728161 -Ref: Translate Program-Footnote-1732726 -Node: Labels Program732996 -Ref: Labels Program-Footnote-1736347 -Node: Word Sorting736431 -Node: History Sorting740502 -Node: Extract Program742338 -Node: Simple Sed749863 -Node: Igawk Program752931 -Ref: Igawk Program-Footnote-1767255 -Ref: Igawk Program-Footnote-2767456 -Ref: Igawk Program-Footnote-3767578 -Node: Anagram Program767693 -Node: Signature Program770750 -Node: Programs Summary771997 -Node: Programs Exercises773190 -Ref: Programs Exercises-Footnote-1777321 -Node: Advanced Features777412 -Node: Nondecimal Data779360 -Node: Array Sorting780950 -Node: Controlling Array Traversal781647 -Ref: Controlling Array Traversal-Footnote-1789980 -Node: Array Sorting Functions790098 -Ref: Array Sorting Functions-Footnote-1793987 -Node: Two-way I/O794183 -Ref: Two-way I/O-Footnote-1799128 -Ref: Two-way I/O-Footnote-2799314 -Node: TCP/IP Networking799396 -Node: Profiling802269 -Node: Advanced Features Summary810546 -Node: Internationalization812479 -Node: I18N and L10N813959 -Node: Explaining gettext814645 -Ref: Explaining gettext-Footnote-1819670 -Ref: Explaining gettext-Footnote-2819854 -Node: Programmer i18n820019 -Ref: Programmer i18n-Footnote-1824885 -Node: Translator i18n824934 -Node: String Extraction825728 -Ref: String Extraction-Footnote-1826859 -Node: Printf Ordering826945 -Ref: Printf Ordering-Footnote-1829731 -Node: I18N Portability829795 -Ref: I18N Portability-Footnote-1832250 -Node: I18N Example832313 -Ref: I18N Example-Footnote-1835116 -Node: Gawk I18N835188 -Node: I18N Summary835826 -Node: Debugger837165 -Node: Debugging838187 -Node: Debugging Concepts838628 -Node: Debugging Terms840481 -Node: Awk Debugging843053 -Node: Sample Debugging Session843947 -Node: Debugger Invocation844467 -Node: Finding The Bug845851 -Node: List of Debugger Commands852326 -Node: Breakpoint Control853659 -Node: Debugger Execution Control857355 -Node: Viewing And Changing Data860719 -Node: Execution Stack864097 -Node: Debugger Info865734 -Node: Miscellaneous Debugger Commands869751 -Node: Readline Support874780 -Node: Limitations875672 -Node: Debugging Summary877786 -Node: Arbitrary Precision Arithmetic878954 -Node: Computer Arithmetic880370 -Ref: table-numeric-ranges883968 -Ref: Computer Arithmetic-Footnote-1884827 -Node: Math Definitions884884 -Ref: table-ieee-formats888172 -Ref: Math Definitions-Footnote-1888776 -Node: MPFR features888881 -Node: FP Math Caution890552 -Ref: FP Math Caution-Footnote-1891602 -Node: Inexactness of computations891971 -Node: Inexact representation892930 -Node: Comparing FP Values894287 -Node: Errors accumulate895369 -Node: Getting Accuracy896802 -Node: Try To Round899464 -Node: Setting precision900363 -Ref: table-predefined-precision-strings901047 -Node: Setting the rounding mode902836 -Ref: table-gawk-rounding-modes903200 -Ref: Setting the rounding mode-Footnote-1906655 -Node: Arbitrary Precision Integers906834 -Ref: Arbitrary Precision Integers-Footnote-1911733 -Node: POSIX Floating Point Problems911882 -Ref: POSIX Floating Point Problems-Footnote-1915755 -Node: Floating point summary915793 -Node: Dynamic Extensions917987 -Node: Extension Intro919539 -Node: Plugin License920805 -Node: Extension Mechanism Outline921602 -Ref: figure-load-extension922030 -Ref: figure-register-new-function923510 -Ref: figure-call-new-function924514 -Node: Extension API Description926500 -Node: Extension API Functions Introduction928034 -Node: General Data Types932906 -Ref: General Data Types-Footnote-1938645 -Node: Memory Allocation Functions938944 -Ref: Memory Allocation Functions-Footnote-1941783 -Node: Constructor Functions941879 -Node: Registration Functions943613 -Node: Extension Functions944298 -Node: Exit Callback Functions946595 -Node: Extension Version String947843 -Node: Input Parsers948508 -Node: Output Wrappers958387 -Node: Two-way processors962902 -Node: Printing Messages965106 -Ref: Printing Messages-Footnote-1966182 -Node: Updating `ERRNO'966334 -Node: Requesting Values967074 -Ref: table-value-types-returned967802 -Node: Accessing Parameters968759 -Node: Symbol Table Access969990 -Node: Symbol table by name970504 -Node: Symbol table by cookie972485 -Ref: Symbol table by cookie-Footnote-1976629 -Node: Cached values976692 -Ref: Cached values-Footnote-1980191 -Node: Array Manipulation980282 -Ref: Array Manipulation-Footnote-1981372 -Node: Array Data Types981409 -Ref: Array Data Types-Footnote-1984064 -Node: Array Functions984156 -Node: Flattening Arrays988010 -Node: Creating Arrays994902 -Node: Redirection API999673 -Node: Extension API Variables1001869 -Node: Extension Versioning1002502 -Node: Extension API Informational Variables1004403 -Node: Extension API Boilerplate1005468 -Node: Finding Extensions1009277 -Node: Extension Example1009837 -Node: Internal File Description1010609 -Node: Internal File Ops1014676 -Ref: Internal File Ops-Footnote-11026346 -Node: Using Internal File Ops1026486 -Ref: Using Internal File Ops-Footnote-11028869 -Node: Extension Samples1029142 -Node: Extension Sample File Functions1030668 -Node: Extension Sample Fnmatch1038306 -Node: Extension Sample Fork1039797 -Node: Extension Sample Inplace1041012 -Node: Extension Sample Ord1042687 -Node: Extension Sample Readdir1043523 -Ref: table-readdir-file-types1044399 -Node: Extension Sample Revout1045210 -Node: Extension Sample Rev2way1045800 -Node: Extension Sample Read write array1046540 -Node: Extension Sample Readfile1048480 -Node: Extension Sample Time1049575 -Node: Extension Sample API Tests1050924 -Node: gawkextlib1051415 -Node: Extension summary1054073 -Node: Extension Exercises1057762 -Node: Language History1058484 -Node: V7/SVR3.11060140 -Node: SVR41062321 -Node: POSIX1063766 -Node: BTL1065155 -Node: POSIX/GNU1065889 -Node: Feature History1071513 -Node: Common Extensions1084611 -Node: Ranges and Locales1085935 -Ref: Ranges and Locales-Footnote-11090553 -Ref: Ranges and Locales-Footnote-21090580 -Ref: Ranges and Locales-Footnote-31090814 -Node: Contributors1091035 -Node: History summary1096576 -Node: Installation1097946 -Node: Gawk Distribution1098892 -Node: Getting1099376 -Node: Extracting1100199 -Node: Distribution contents1101834 -Node: Unix Installation1107899 -Node: Quick Installation1108582 -Node: Shell Startup Files1110993 -Node: Additional Configuration Options1112072 -Node: Configuration Philosophy1113811 -Node: Non-Unix Installation1116180 -Node: PC Installation1116638 -Node: PC Binary Installation1117957 -Node: PC Compiling1119805 -Ref: PC Compiling-Footnote-11122826 -Node: PC Testing1122935 -Node: PC Using1124111 -Node: Cygwin1128226 -Node: MSYS1129049 -Node: VMS Installation1129549 -Node: VMS Compilation1130341 -Ref: VMS Compilation-Footnote-11131563 -Node: VMS Dynamic Extensions1131621 -Node: VMS Installation Details1133305 -Node: VMS Running1135557 -Node: VMS GNV1138393 -Node: VMS Old Gawk1139127 -Node: Bugs1139597 -Node: Other Versions1143480 -Node: Installation summary1149908 -Node: Notes1150964 -Node: Compatibility Mode1151829 -Node: Additions1152611 -Node: Accessing The Source1153536 -Node: Adding Code1154972 -Node: New Ports1161137 -Node: Derived Files1165619 -Ref: Derived Files-Footnote-11171094 -Ref: Derived Files-Footnote-21171128 -Ref: Derived Files-Footnote-31171724 -Node: Future Extensions1171838 -Node: Implementation Limitations1172444 -Node: Extension Design1173692 -Node: Old Extension Problems1174846 -Ref: Old Extension Problems-Footnote-11176363 -Node: Extension New Mechanism Goals1176420 -Ref: Extension New Mechanism Goals-Footnote-11179780 -Node: Extension Other Design Decisions1179969 -Node: Extension Future Growth1182077 -Node: Old Extension Mechanism1182913 -Node: Notes summary1184675 -Node: Basic Concepts1185861 -Node: Basic High Level1186542 -Ref: figure-general-flow1186814 -Ref: figure-process-flow1187413 -Ref: Basic High Level-Footnote-11190642 -Node: Basic Data Typing1190827 -Node: Glossary1194155 -Node: Copying1219313 -Node: GNU Free Documentation License1256869 -Node: Index1282005 +Node: Foreword342385 +Node: Foreword446827 +Node: Preface48349 +Ref: Preface-Footnote-151220 +Ref: Preface-Footnote-251327 +Ref: Preface-Footnote-351560 +Node: History51702 +Node: Names54048 +Ref: Names-Footnote-155142 +Node: This Manual55288 +Ref: This Manual-Footnote-161775 +Node: Conventions61875 +Node: Manual History64213 +Ref: Manual History-Footnote-167195 +Ref: Manual History-Footnote-267236 +Node: How To Contribute67310 +Node: Acknowledgments68439 +Node: Getting Started73244 +Node: Running gawk75677 +Node: One-shot76867 +Node: Read Terminal78115 +Node: Long80142 +Node: Executable Scripts81658 +Ref: Executable Scripts-Footnote-184447 +Node: Comments84550 +Node: Quoting87032 +Node: DOS Quoting92556 +Node: Sample Data Files93231 +Node: Very Simple95826 +Node: Two Rules100724 +Node: More Complex102610 +Node: Statements/Lines105472 +Ref: Statements/Lines-Footnote-1109927 +Node: Other Features110192 +Node: When111123 +Ref: When-Footnote-1112877 +Node: Intro Summary112942 +Node: Invoking Gawk113825 +Node: Command Line115339 +Node: Options116137 +Ref: Options-Footnote-1131941 +Ref: Options-Footnote-2132170 +Node: Other Arguments132195 +Node: Naming Standard Input135143 +Node: Environment Variables136236 +Node: AWKPATH Variable136794 +Ref: AWKPATH Variable-Footnote-1140207 +Ref: AWKPATH Variable-Footnote-2140252 +Node: AWKLIBPATH Variable140512 +Node: Other Environment Variables141768 +Node: Exit Status145256 +Node: Include Files145932 +Node: Loading Shared Libraries149529 +Node: Obsolete150956 +Node: Undocumented151653 +Node: Invoking Summary151920 +Node: Regexp153584 +Node: Regexp Usage155038 +Node: Escape Sequences157075 +Node: Regexp Operators163316 +Ref: Regexp Operators-Footnote-1170742 +Ref: Regexp Operators-Footnote-2170889 +Node: Bracket Expressions170987 +Ref: table-char-classes173002 +Node: Leftmost Longest175926 +Node: Computed Regexps177228 +Node: GNU Regexp Operators180625 +Node: Case-sensitivity184298 +Ref: Case-sensitivity-Footnote-1187183 +Ref: Case-sensitivity-Footnote-2187418 +Node: Regexp Summary187526 +Node: Reading Files188993 +Node: Records191156 +Node: awk split records191889 +Node: gawk split records196804 +Ref: gawk split records-Footnote-1201348 +Node: Fields201385 +Ref: Fields-Footnote-1204161 +Node: Nonconstant Fields204247 +Ref: Nonconstant Fields-Footnote-1206490 +Node: Changing Fields206694 +Node: Field Separators212623 +Node: Default Field Splitting215328 +Node: Regexp Field Splitting216445 +Node: Single Character Fields219795 +Node: Command Line Field Separator220854 +Node: Full Line Fields224066 +Ref: Full Line Fields-Footnote-1225583 +Ref: Full Line Fields-Footnote-2225629 +Node: Field Splitting Summary225730 +Node: Constant Size227804 +Node: Splitting By Content232393 +Ref: Splitting By Content-Footnote-1236387 +Node: Multiple Line236550 +Ref: Multiple Line-Footnote-1242436 +Node: Getline242615 +Node: Plain Getline245099 +Node: Getline/Variable247739 +Node: Getline/File248887 +Node: Getline/Variable/File250271 +Ref: Getline/Variable/File-Footnote-1251874 +Node: Getline/Pipe251961 +Node: Getline/Variable/Pipe254644 +Node: Getline/Coprocess255775 +Node: Getline/Variable/Coprocess257027 +Node: Getline Notes257766 +Node: Getline Summary260558 +Ref: table-getline-variants260970 +Node: Read Timeout261799 +Ref: Read Timeout-Footnote-1265690 +Node: Retrying Input265748 +Node: Command-line directories266943 +Node: Input Summary267850 +Node: Input Exercises271151 +Node: Printing271879 +Node: Print273656 +Node: Print Examples275113 +Node: Output Separators277892 +Node: OFMT279910 +Node: Printf281264 +Node: Basic Printf282049 +Node: Control Letters283619 +Node: Format Modifiers287602 +Node: Printf Examples293611 +Node: Redirection296097 +Node: Special FD302938 +Ref: Special FD-Footnote-1306098 +Node: Special Files306172 +Node: Other Inherited Files306789 +Node: Special Network307789 +Node: Special Caveats308651 +Node: Close Files And Pipes309602 +Ref: Close Files And Pipes-Footnote-1316784 +Ref: Close Files And Pipes-Footnote-2316932 +Node: Output Summary317082 +Node: Output Exercises318080 +Node: Expressions318760 +Node: Values319945 +Node: Constants320623 +Node: Scalar Constants321314 +Ref: Scalar Constants-Footnote-1322173 +Node: Nondecimal-numbers322423 +Node: Regexp Constants325441 +Node: Using Constant Regexps325966 +Node: Variables329109 +Node: Using Variables329764 +Node: Assignment Options331675 +Node: Conversion333550 +Node: Strings And Numbers334074 +Ref: Strings And Numbers-Footnote-1337139 +Node: Locale influences conversions337248 +Ref: table-locale-affects339995 +Node: All Operators340583 +Node: Arithmetic Ops341213 +Node: Concatenation343718 +Ref: Concatenation-Footnote-1346537 +Node: Assignment Ops346643 +Ref: table-assign-ops351622 +Node: Increment Ops352894 +Node: Truth Values and Conditions356332 +Node: Truth Values357417 +Node: Typing and Comparison358466 +Node: Variable Typing359276 +Node: Comparison Operators362929 +Ref: table-relational-ops363339 +Node: POSIX String Comparison366834 +Ref: POSIX String Comparison-Footnote-1367906 +Node: Boolean Ops368044 +Ref: Boolean Ops-Footnote-1372523 +Node: Conditional Exp372614 +Node: Function Calls374341 +Node: Precedence378221 +Node: Locales381882 +Node: Expressions Summary383514 +Node: Patterns and Actions386074 +Node: Pattern Overview387194 +Node: Regexp Patterns388873 +Node: Expression Patterns389416 +Node: Ranges393126 +Node: BEGIN/END396232 +Node: Using BEGIN/END396993 +Ref: Using BEGIN/END-Footnote-1399727 +Node: I/O And BEGIN/END399833 +Node: BEGINFILE/ENDFILE402147 +Node: Empty405048 +Node: Using Shell Variables405365 +Node: Action Overview407638 +Node: Statements409964 +Node: If Statement411812 +Node: While Statement413307 +Node: Do Statement415336 +Node: For Statement416480 +Node: Switch Statement419637 +Node: Break Statement422019 +Node: Continue Statement424060 +Node: Next Statement425887 +Node: Nextfile Statement428268 +Node: Exit Statement430898 +Node: Built-in Variables433301 +Node: User-modified434434 +Ref: User-modified-Footnote-1442115 +Node: Auto-set442177 +Ref: Auto-set-Footnote-1456393 +Ref: Auto-set-Footnote-2456598 +Node: ARGC and ARGV456654 +Node: Pattern Action Summary460872 +Node: Arrays463299 +Node: Array Basics464628 +Node: Array Intro465472 +Ref: figure-array-elements467436 +Ref: Array Intro-Footnote-1469962 +Node: Reference to Elements470090 +Node: Assigning Elements472542 +Node: Array Example473033 +Node: Scanning an Array474791 +Node: Controlling Scanning477807 +Ref: Controlling Scanning-Footnote-1483003 +Node: Numeric Array Subscripts483319 +Node: Uninitialized Subscripts485504 +Node: Delete487121 +Ref: Delete-Footnote-1489864 +Node: Multidimensional489921 +Node: Multiscanning493018 +Node: Arrays of Arrays494607 +Node: Arrays Summary499366 +Node: Functions501458 +Node: Built-in502357 +Node: Calling Built-in503435 +Node: Numeric Functions505426 +Ref: Numeric Functions-Footnote-1510245 +Ref: Numeric Functions-Footnote-2510602 +Ref: Numeric Functions-Footnote-3510650 +Node: String Functions510922 +Ref: String Functions-Footnote-1534397 +Ref: String Functions-Footnote-2534526 +Ref: String Functions-Footnote-3534774 +Node: Gory Details534861 +Ref: table-sub-escapes536642 +Ref: table-sub-proposed538162 +Ref: table-posix-sub539526 +Ref: table-gensub-escapes541062 +Ref: Gory Details-Footnote-1541894 +Node: I/O Functions542045 +Ref: I/O Functions-Footnote-1549263 +Node: Time Functions549410 +Ref: Time Functions-Footnote-1559898 +Ref: Time Functions-Footnote-2559966 +Ref: Time Functions-Footnote-3560124 +Ref: Time Functions-Footnote-4560235 +Ref: Time Functions-Footnote-5560347 +Ref: Time Functions-Footnote-6560574 +Node: Bitwise Functions560840 +Ref: table-bitwise-ops561402 +Ref: Bitwise Functions-Footnote-1565711 +Node: Type Functions565880 +Node: I18N Functions567031 +Node: User-defined568676 +Node: Definition Syntax569481 +Ref: Definition Syntax-Footnote-1574888 +Node: Function Example574959 +Ref: Function Example-Footnote-1577878 +Node: Function Caveats577900 +Node: Calling A Function578418 +Node: Variable Scope579376 +Node: Pass By Value/Reference582364 +Node: Return Statement585859 +Node: Dynamic Typing588840 +Node: Indirect Calls589769 +Ref: Indirect Calls-Footnote-1601071 +Node: Functions Summary601199 +Node: Library Functions603901 +Ref: Library Functions-Footnote-1607510 +Ref: Library Functions-Footnote-2607653 +Node: Library Names607824 +Ref: Library Names-Footnote-1611278 +Ref: Library Names-Footnote-2611501 +Node: General Functions611587 +Node: Strtonum Function612690 +Node: Assert Function615712 +Node: Round Function619036 +Node: Cliff Random Function620577 +Node: Ordinal Functions621593 +Ref: Ordinal Functions-Footnote-1624656 +Ref: Ordinal Functions-Footnote-2624908 +Node: Join Function625119 +Ref: Join Function-Footnote-1626888 +Node: Getlocaltime Function627088 +Node: Readfile Function630832 +Node: Shell Quoting632802 +Node: Data File Management634203 +Node: Filetrans Function634835 +Node: Rewind Function638891 +Node: File Checking640278 +Ref: File Checking-Footnote-1641610 +Node: Empty Files641811 +Node: Ignoring Assigns643790 +Node: Getopt Function645341 +Ref: Getopt Function-Footnote-1656803 +Node: Passwd Functions657003 +Ref: Passwd Functions-Footnote-1665840 +Node: Group Functions665928 +Ref: Group Functions-Footnote-1673822 +Node: Walking Arrays674035 +Node: Library Functions Summary675638 +Node: Library Exercises677039 +Node: Sample Programs678319 +Node: Running Examples679089 +Node: Clones679817 +Node: Cut Program681041 +Node: Egrep Program690760 +Ref: Egrep Program-Footnote-1698258 +Node: Id Program698368 +Node: Split Program702013 +Ref: Split Program-Footnote-1705461 +Node: Tee Program705589 +Node: Uniq Program708378 +Node: Wc Program715797 +Ref: Wc Program-Footnote-1720047 +Node: Miscellaneous Programs720141 +Node: Dupword Program721354 +Node: Alarm Program723385 +Node: Translate Program728189 +Ref: Translate Program-Footnote-1732754 +Node: Labels Program733024 +Ref: Labels Program-Footnote-1736375 +Node: Word Sorting736459 +Node: History Sorting740530 +Node: Extract Program742366 +Node: Simple Sed749891 +Node: Igawk Program752959 +Ref: Igawk Program-Footnote-1767283 +Ref: Igawk Program-Footnote-2767484 +Ref: Igawk Program-Footnote-3767606 +Node: Anagram Program767721 +Node: Signature Program770778 +Node: Programs Summary772025 +Node: Programs Exercises773218 +Ref: Programs Exercises-Footnote-1777349 +Node: Advanced Features777440 +Node: Nondecimal Data779388 +Node: Array Sorting780978 +Node: Controlling Array Traversal781675 +Ref: Controlling Array Traversal-Footnote-1790008 +Node: Array Sorting Functions790126 +Ref: Array Sorting Functions-Footnote-1794015 +Node: Two-way I/O794211 +Ref: Two-way I/O-Footnote-1799156 +Ref: Two-way I/O-Footnote-2799342 +Node: TCP/IP Networking799424 +Node: Profiling802297 +Node: Advanced Features Summary810574 +Node: Internationalization812507 +Node: I18N and L10N813987 +Node: Explaining gettext814673 +Ref: Explaining gettext-Footnote-1819698 +Ref: Explaining gettext-Footnote-2819882 +Node: Programmer i18n820047 +Ref: Programmer i18n-Footnote-1824913 +Node: Translator i18n824962 +Node: String Extraction825756 +Ref: String Extraction-Footnote-1826887 +Node: Printf Ordering826973 +Ref: Printf Ordering-Footnote-1829759 +Node: I18N Portability829823 +Ref: I18N Portability-Footnote-1832278 +Node: I18N Example832341 +Ref: I18N Example-Footnote-1835144 +Node: Gawk I18N835216 +Node: I18N Summary835854 +Node: Debugger837193 +Node: Debugging838215 +Node: Debugging Concepts838656 +Node: Debugging Terms840509 +Node: Awk Debugging843081 +Node: Sample Debugging Session843975 +Node: Debugger Invocation844495 +Node: Finding The Bug845879 +Node: List of Debugger Commands852354 +Node: Breakpoint Control853687 +Node: Debugger Execution Control857383 +Node: Viewing And Changing Data860747 +Node: Execution Stack864125 +Node: Debugger Info865762 +Node: Miscellaneous Debugger Commands869779 +Node: Readline Support874808 +Node: Limitations875700 +Node: Debugging Summary877814 +Node: Arbitrary Precision Arithmetic878982 +Node: Computer Arithmetic880398 +Ref: table-numeric-ranges883996 +Ref: Computer Arithmetic-Footnote-1884855 +Node: Math Definitions884912 +Ref: table-ieee-formats888200 +Ref: Math Definitions-Footnote-1888804 +Node: MPFR features888909 +Node: FP Math Caution890580 +Ref: FP Math Caution-Footnote-1891630 +Node: Inexactness of computations891999 +Node: Inexact representation892958 +Node: Comparing FP Values894315 +Node: Errors accumulate895397 +Node: Getting Accuracy896830 +Node: Try To Round899492 +Node: Setting precision900391 +Ref: table-predefined-precision-strings901075 +Node: Setting the rounding mode902864 +Ref: table-gawk-rounding-modes903228 +Ref: Setting the rounding mode-Footnote-1906683 +Node: Arbitrary Precision Integers906862 +Ref: Arbitrary Precision Integers-Footnote-1911761 +Node: POSIX Floating Point Problems911910 +Ref: POSIX Floating Point Problems-Footnote-1915783 +Node: Floating point summary915821 +Node: Dynamic Extensions918015 +Node: Extension Intro919567 +Node: Plugin License920833 +Node: Extension Mechanism Outline921630 +Ref: figure-load-extension922058 +Ref: figure-register-new-function923538 +Ref: figure-call-new-function924542 +Node: Extension API Description926528 +Node: Extension API Functions Introduction928062 +Node: General Data Types932934 +Ref: General Data Types-Footnote-1938673 +Node: Memory Allocation Functions938972 +Ref: Memory Allocation Functions-Footnote-1941811 +Node: Constructor Functions941907 +Node: Registration Functions943641 +Node: Extension Functions944326 +Node: Exit Callback Functions946623 +Node: Extension Version String947871 +Node: Input Parsers948536 +Node: Output Wrappers958415 +Node: Two-way processors962930 +Node: Printing Messages965134 +Ref: Printing Messages-Footnote-1966210 +Node: Updating `ERRNO'966362 +Node: Requesting Values967102 +Ref: table-value-types-returned967830 +Node: Accessing Parameters968787 +Node: Symbol Table Access970018 +Node: Symbol table by name970532 +Node: Symbol table by cookie972513 +Ref: Symbol table by cookie-Footnote-1976657 +Node: Cached values976720 +Ref: Cached values-Footnote-1980219 +Node: Array Manipulation980310 +Ref: Array Manipulation-Footnote-1981400 +Node: Array Data Types981437 +Ref: Array Data Types-Footnote-1984092 +Node: Array Functions984184 +Node: Flattening Arrays988038 +Node: Creating Arrays994930 +Node: Redirection API999701 +Node: Extension API Variables1001897 +Node: Extension Versioning1002530 +Node: Extension API Informational Variables1004431 +Node: Extension API Boilerplate1005496 +Node: Finding Extensions1009305 +Node: Extension Example1009865 +Node: Internal File Description1010637 +Node: Internal File Ops1014704 +Ref: Internal File Ops-Footnote-11026374 +Node: Using Internal File Ops1026514 +Ref: Using Internal File Ops-Footnote-11028897 +Node: Extension Samples1029170 +Node: Extension Sample File Functions1030696 +Node: Extension Sample Fnmatch1038334 +Node: Extension Sample Fork1039825 +Node: Extension Sample Inplace1041040 +Node: Extension Sample Ord1042715 +Node: Extension Sample Readdir1043551 +Ref: table-readdir-file-types1044427 +Node: Extension Sample Revout1045238 +Node: Extension Sample Rev2way1045828 +Node: Extension Sample Read write array1046568 +Node: Extension Sample Readfile1048508 +Node: Extension Sample Time1049603 +Node: Extension Sample API Tests1050952 +Node: gawkextlib1051443 +Node: Extension summary1054101 +Node: Extension Exercises1057790 +Node: Language History1058512 +Node: V7/SVR3.11060168 +Node: SVR41062349 +Node: POSIX1063794 +Node: BTL1065183 +Node: POSIX/GNU1065917 +Node: Feature History1071541 +Node: Common Extensions1084639 +Node: Ranges and Locales1085963 +Ref: Ranges and Locales-Footnote-11090581 +Ref: Ranges and Locales-Footnote-21090608 +Ref: Ranges and Locales-Footnote-31090842 +Node: Contributors1091063 +Node: History summary1096604 +Node: Installation1097974 +Node: Gawk Distribution1098920 +Node: Getting1099404 +Node: Extracting1100227 +Node: Distribution contents1101862 +Node: Unix Installation1107927 +Node: Quick Installation1108610 +Node: Shell Startup Files1111021 +Node: Additional Configuration Options1112100 +Node: Configuration Philosophy1113839 +Node: Non-Unix Installation1116208 +Node: PC Installation1116666 +Node: PC Binary Installation1117985 +Node: PC Compiling1119833 +Ref: PC Compiling-Footnote-11122854 +Node: PC Testing1122963 +Node: PC Using1124139 +Node: Cygwin1128254 +Node: MSYS1129077 +Node: VMS Installation1129577 +Node: VMS Compilation1130369 +Ref: VMS Compilation-Footnote-11131591 +Node: VMS Dynamic Extensions1131649 +Node: VMS Installation Details1133333 +Node: VMS Running1135585 +Node: VMS GNV1138421 +Node: VMS Old Gawk1139155 +Node: Bugs1139625 +Node: Other Versions1143508 +Node: Installation summary1149936 +Node: Notes1150992 +Node: Compatibility Mode1151857 +Node: Additions1152639 +Node: Accessing The Source1153564 +Node: Adding Code1155000 +Node: New Ports1161165 +Node: Derived Files1165647 +Ref: Derived Files-Footnote-11171122 +Ref: Derived Files-Footnote-21171156 +Ref: Derived Files-Footnote-31171752 +Node: Future Extensions1171866 +Node: Implementation Limitations1172472 +Node: Extension Design1173720 +Node: Old Extension Problems1174874 +Ref: Old Extension Problems-Footnote-11176391 +Node: Extension New Mechanism Goals1176448 +Ref: Extension New Mechanism Goals-Footnote-11179808 +Node: Extension Other Design Decisions1179997 +Node: Extension Future Growth1182105 +Node: Old Extension Mechanism1182941 +Node: Notes summary1184703 +Node: Basic Concepts1185889 +Node: Basic High Level1186570 +Ref: figure-general-flow1186842 +Ref: figure-process-flow1187441 +Ref: Basic High Level-Footnote-11190670 +Node: Basic Data Typing1190855 +Node: Glossary1194183 +Node: Copying1219341 +Node: GNU Free Documentation License1256897 +Node: Index1282033 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index a222c23e..dc9087ba 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -603,7 +603,7 @@ particular records in a file and perform operations upon them. @code{getline}. * Getline Summary:: Summary of @code{getline} Variants. * Read Timeout:: Reading input with a timeout. -* Retrying I/O:: Retrying I/O after certain errors. +* Retrying Input:: Retrying input after certain errors. * Command-line directories:: What happens if you put a directory on the command line. * Input Summary:: Input summary. @@ -6337,7 +6337,7 @@ used with it do not have to be named on the @command{awk} command line * Getline:: Reading files under explicit program control using the @code{getline} function. * Read Timeout:: Reading input with a timeout. -* Retrying I/O:: Retrying I/O after certain errors. +* Retrying Input:: Retrying input after certain errors. * Command-line directories:: What happens if you put a directory on the command line. * Input Summary:: Input summary. @@ -8148,7 +8148,7 @@ returns @minus{}1. In this case, @command{gawk} sets the variable If the @code{errno} variable indicates that the I/O operation may be retried, and @code{PROCINFO["input", "RETRY"]} is set, then @minus{}2 will be returned instead of @minus{}1, and further calls to @code{getline} -may be attemped. @DBXREF{Retrying I/O} for further information about +may be attemped. @DBXREF{Retrying Input} for further information about this feature. In the following examples, @var{command} stands for a string value that @@ -8802,7 +8802,7 @@ on a per command or connection basis. the attempt to read from the underlying device may succeed in a later attempt. This is a limitation, and it also means that you cannot use this to multiplex input from -two or more sources. @DBXREF{Retrying I/O} for a way to enable +two or more sources. @DBXREF{Retrying Input} for a way to enable later I/O attempts to succeed. Assigning a timeout value prevents read operations from @@ -8813,11 +8813,11 @@ a connection before it can start reading any data, or the attempt to open a FIFO special file for reading can block indefinitely until some other process opens it for writing. -@node Retrying I/O -@section Retrying I/O on Certain Input Errors -@cindex retrying I/O +@node Retrying Input +@section Retrying Reads After Certain Input Errors +@cindex retrying input -@cindex differences in @command{awk} and @command{gawk}, retrying I/O +@cindex differences in @command{awk} and @command{gawk}, retrying input This @value{SECTION} describes a feature that is specific to @command{gawk}. When @command{gawk} encounters an error while reading input, it will by default @@ -15196,9 +15196,9 @@ open input file, pipe, or coprocess. @DBXREF{Read Timeout} for more information. @item -It may be used to indicate that I/O may be retried when it fails due to +It may be used to indicate that input may be retried when it fails due to certain errors. -@DBXREF{Retrying I/O} for more information. +@DBXREF{Retrying Input} for more information. @item It may be used to cause coprocesses to communicate over pseudo-ttys diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 706512f9..85a1d83c 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -598,7 +598,7 @@ particular records in a file and perform operations upon them. @code{getline}. * Getline Summary:: Summary of @code{getline} Variants. * Read Timeout:: Reading input with a timeout. -* Retrying I/O:: Retrying I/O after certain errors. +* Retrying Input:: Retrying input after certain errors. * Command-line directories:: What happens if you put a directory on the command line. * Input Summary:: Input summary. @@ -6121,7 +6121,7 @@ used with it do not have to be named on the @command{awk} command line * Getline:: Reading files under explicit program control using the @code{getline} function. * Read Timeout:: Reading input with a timeout. -* Retrying I/O:: Retrying I/O after certain errors. +* Retrying Input:: Retrying input after certain errors. * Command-line directories:: What happens if you put a directory on the command line. * Input Summary:: Input summary. @@ -7749,7 +7749,7 @@ returns @minus{}1. In this case, @command{gawk} sets the variable If the @code{errno} variable indicates that the I/O operation may be retried, and @code{PROCINFO["input", "RETRY"]} is set, then @minus{}2 will be returned instead of @minus{}1, and further calls to @code{getline} -may be attemped. @DBXREF{Retrying I/O} for further information about +may be attemped. @DBXREF{Retrying Input} for further information about this feature. In the following examples, @var{command} stands for a string value that @@ -8403,7 +8403,7 @@ on a per command or connection basis. the attempt to read from the underlying device may succeed in a later attempt. This is a limitation, and it also means that you cannot use this to multiplex input from -two or more sources. @DBXREF{Retrying I/O} for a way to enable +two or more sources. @DBXREF{Retrying Input} for a way to enable later I/O attempts to succeed. Assigning a timeout value prevents read operations from @@ -8414,11 +8414,11 @@ a connection before it can start reading any data, or the attempt to open a FIFO special file for reading can block indefinitely until some other process opens it for writing. -@node Retrying I/O -@section Retrying I/O on Certain Input Errors -@cindex retrying I/O +@node Retrying Input +@section Retrying Reads After Certain Input Errors +@cindex retrying input -@cindex differences in @command{awk} and @command{gawk}, retrying I/O +@cindex differences in @command{awk} and @command{gawk}, retrying input This @value{SECTION} describes a feature that is specific to @command{gawk}. When @command{gawk} encounters an error while reading input, it will by default @@ -14525,9 +14525,9 @@ open input file, pipe, or coprocess. @DBXREF{Read Timeout} for more information. @item -It may be used to indicate that I/O may be retried when it fails due to +It may be used to indicate that input may be retried when it fails due to certain errors. -@DBXREF{Retrying I/O} for more information. +@DBXREF{Retrying Input} for more information. @item It may be used to cause coprocesses to communicate over pseudo-ttys |