diff options
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 832 | ||||
| -rw-r--r-- | doc/gawk.texi | 5 |
3 files changed, 423 insertions, 418 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 4371cbf0..b8ddde70 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2013-04-03 Arnold D. Robbins <arnold@skeeve.com> + + * gawk.texi: Continue cleanup. + 2013-04-02 Arnold D. Robbins <arnold@skeeve.com> * gawk.texi: Start a simple cleanup pass before the release. diff --git a/doc/gawk.info b/doc/gawk.info index ff07b9f0..872e31fa 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -5560,8 +5560,8 @@ special element in the `PROCINFO' array: PROCINFO["input_name", "READ_TIMEOUT"] = TIMEOUT IN MILLISECONDS - When set, this will cause `gawk' to time out and return failure if -no data is available to read within the specified timeout period. For + When set, this causes `gawk' to time out and return failure if no +data is available to read within the specified timeout period. For example, a TCP client can decide to give up on receiving any response from the server after a certain amount of time: @@ -6514,7 +6514,7 @@ redirection, the value must be a string. It is a common error to omit the quotes, which leads to confusing results. Finally, using the `close()' function on a file name of the form -`"/dev/fd/N"', for file descriptor numbers above two, will actually +`"/dev/fd/N"', for file descriptor numbers above two, does actually close the given file descriptor. The `/dev/stdin', `/dev/stdout', and `/dev/stderr' special files are @@ -32039,418 +32039,418 @@ Node: Getline Notes242255 Node: Getline Summary245042 Ref: table-getline-variants245450 Node: Read Timeout246308 -Ref: Read Timeout-Footnote-1250053 -Node: Command line directories250110 -Node: Printing250740 -Node: Print252371 -Node: Print Examples253708 -Node: Output Separators256492 -Node: OFMT258252 -Node: Printf259610 -Node: Basic Printf260516 -Node: Control Letters262055 -Node: Format Modifiers265867 -Node: Printf Examples271876 -Node: Redirection274591 -Node: Special Files281575 -Node: Special FD282108 -Ref: Special FD-Footnote-1285733 -Node: Special Network285807 -Node: Special Caveats286657 -Node: Close Files And Pipes287453 -Ref: Close Files And Pipes-Footnote-1294476 -Ref: Close Files And Pipes-Footnote-2294624 -Node: Expressions294774 -Node: Values295906 -Node: Constants296582 -Node: Scalar Constants297262 -Ref: Scalar Constants-Footnote-1298121 -Node: Nondecimal-numbers298303 -Node: Regexp Constants301362 -Node: Using Constant Regexps301837 -Node: Variables304892 -Node: Using Variables305547 -Node: Assignment Options307271 -Node: Conversion309143 -Ref: table-locale-affects314634 -Ref: Conversion-Footnote-1315258 -Node: All Operators315367 -Node: Arithmetic Ops315997 -Node: Concatenation318502 -Ref: Concatenation-Footnote-1321295 -Node: Assignment Ops321415 -Ref: table-assign-ops326403 -Node: Increment Ops327811 -Node: Truth Values and Conditions331281 -Node: Truth Values332364 -Node: Typing and Comparison333413 -Node: Variable Typing334202 -Ref: Variable Typing-Footnote-1338099 -Node: Comparison Operators338221 -Ref: table-relational-ops338631 -Node: POSIX String Comparison342180 -Ref: POSIX String Comparison-Footnote-1343136 -Node: Boolean Ops343274 -Ref: Boolean Ops-Footnote-1347352 -Node: Conditional Exp347443 -Node: Function Calls349175 -Node: Precedence352769 -Node: Locales356438 -Node: Patterns and Actions357527 -Node: Pattern Overview358581 -Node: Regexp Patterns360250 -Node: Expression Patterns360793 -Node: Ranges364478 -Node: BEGIN/END367444 -Node: Using BEGIN/END368206 -Ref: Using BEGIN/END-Footnote-1370937 -Node: I/O And BEGIN/END371043 -Node: BEGINFILE/ENDFILE373325 -Node: Empty376229 -Node: Using Shell Variables376545 -Node: Action Overview378830 -Node: Statements381187 -Node: If Statement383041 -Node: While Statement384540 -Node: Do Statement386584 -Node: For Statement387740 -Node: Switch Statement390892 -Node: Break Statement392989 -Node: Continue Statement394979 -Node: Next Statement396772 -Node: Nextfile Statement399162 -Node: Exit Statement401803 -Node: Built-in Variables404219 -Node: User-modified405314 -Ref: User-modified-Footnote-1413669 -Node: Auto-set413731 -Ref: Auto-set-Footnote-1426082 -Ref: Auto-set-Footnote-2426287 -Node: ARGC and ARGV426343 -Node: Arrays430194 -Node: Array Basics431699 -Node: Array Intro432525 -Node: Reference to Elements436843 -Node: Assigning Elements439113 -Node: Array Example439604 -Node: Scanning an Array441336 -Node: Controlling Scanning443650 -Ref: Controlling Scanning-Footnote-1448583 -Node: Delete448899 -Ref: Delete-Footnote-1451664 -Node: Numeric Array Subscripts451721 -Node: Uninitialized Subscripts453904 -Node: Multi-dimensional455532 -Node: Multi-scanning458626 -Node: Arrays of Arrays460217 -Node: Functions464862 -Node: Built-in465681 -Node: Calling Built-in466759 -Node: Numeric Functions468747 -Ref: Numeric Functions-Footnote-1472579 -Ref: Numeric Functions-Footnote-2472936 -Ref: Numeric Functions-Footnote-3472984 -Node: String Functions473253 -Ref: String Functions-Footnote-1496750 -Ref: String Functions-Footnote-2496879 -Ref: String Functions-Footnote-3497127 -Node: Gory Details497214 -Ref: table-sub-escapes498893 -Ref: table-sub-posix-92500247 -Ref: table-sub-proposed501598 -Ref: table-posix-sub502952 -Ref: table-gensub-escapes504497 -Ref: Gory Details-Footnote-1505704 -Ref: Gory Details-Footnote-2505755 -Node: I/O Functions505906 -Ref: I/O Functions-Footnote-1513011 -Node: Time Functions513158 -Ref: Time Functions-Footnote-1524091 -Ref: Time Functions-Footnote-2524159 -Ref: Time Functions-Footnote-3524317 -Ref: Time Functions-Footnote-4524428 -Ref: Time Functions-Footnote-5524540 -Ref: Time Functions-Footnote-6524767 -Node: Bitwise Functions525033 -Ref: table-bitwise-ops525591 -Ref: Bitwise Functions-Footnote-1529812 -Node: Type Functions529996 -Node: I18N Functions530466 -Node: User-defined532093 -Node: Definition Syntax532897 -Ref: Definition Syntax-Footnote-1537807 -Node: Function Example537876 -Node: Function Caveats540470 -Node: Calling A Function540891 -Node: Variable Scope542006 -Node: Pass By Value/Reference544969 -Node: Return Statement548409 -Node: Dynamic Typing551390 -Node: Indirect Calls552321 -Node: Library Functions562006 -Ref: Library Functions-Footnote-1565519 -Ref: Library Functions-Footnote-2565662 -Node: Library Names565833 -Ref: Library Names-Footnote-1569304 -Ref: Library Names-Footnote-2569524 -Node: General Functions569610 -Node: Strtonum Function570563 -Node: Assert Function573493 -Node: Round Function576819 -Node: Cliff Random Function578362 -Node: Ordinal Functions579378 -Ref: Ordinal Functions-Footnote-1582448 -Ref: Ordinal Functions-Footnote-2582700 -Node: Join Function582909 -Ref: Join Function-Footnote-1584680 -Node: Getlocaltime Function584880 -Node: Data File Management588595 -Node: Filetrans Function589227 -Node: Rewind Function593366 -Node: File Checking594753 -Node: Empty Files595847 -Node: Ignoring Assigns598077 -Node: Getopt Function599630 -Ref: Getopt Function-Footnote-1610934 -Node: Passwd Functions611137 -Ref: Passwd Functions-Footnote-1620112 -Node: Group Functions620200 -Node: Walking Arrays628284 -Node: Sample Programs629853 -Node: Running Examples630530 -Node: Clones631258 -Node: Cut Program632482 -Node: Egrep Program642327 -Ref: Egrep Program-Footnote-1650100 -Node: Id Program650210 -Node: Split Program653826 -Ref: Split Program-Footnote-1657345 -Node: Tee Program657473 -Node: Uniq Program660276 -Node: Wc Program667705 -Ref: Wc Program-Footnote-1671971 -Ref: Wc Program-Footnote-2672171 -Node: Miscellaneous Programs672263 -Node: Dupword Program673451 -Node: Alarm Program675482 -Node: Translate Program680231 -Ref: Translate Program-Footnote-1684618 -Ref: Translate Program-Footnote-2684846 -Node: Labels Program684980 -Ref: Labels Program-Footnote-1688351 -Node: Word Sorting688435 -Node: History Sorting692319 -Node: Extract Program694158 -Ref: Extract Program-Footnote-1701659 -Node: Simple Sed701787 -Node: Igawk Program704849 -Ref: Igawk Program-Footnote-1720006 -Ref: Igawk Program-Footnote-2720207 -Node: Anagram Program720345 -Node: Signature Program723413 -Node: Internationalization724513 -Node: I18N and L10N725945 -Node: Explaining gettext726631 -Ref: Explaining gettext-Footnote-1731697 -Ref: Explaining gettext-Footnote-2731881 -Node: Programmer i18n732046 -Node: Translator i18n736246 -Node: String Extraction737039 -Ref: String Extraction-Footnote-1738000 -Node: Printf Ordering738086 -Ref: Printf Ordering-Footnote-1740870 -Node: I18N Portability740934 -Ref: I18N Portability-Footnote-1743383 -Node: I18N Example743446 -Ref: I18N Example-Footnote-1746081 -Node: Gawk I18N746153 -Node: Advanced Features746770 -Node: Nondecimal Data748274 -Node: Array Sorting749857 -Node: Controlling Array Traversal750554 -Node: Array Sorting Functions758792 -Ref: Array Sorting Functions-Footnote-1762466 -Ref: Array Sorting Functions-Footnote-2762559 -Node: Two-way I/O762753 -Ref: Two-way I/O-Footnote-1768185 -Node: TCP/IP Networking768255 -Node: Profiling771099 -Node: Debugger778553 -Node: Debugging779521 -Node: Debugging Concepts779954 -Node: Debugging Terms781810 -Node: Awk Debugging784407 -Node: Sample Debugging Session785299 -Node: Debugger Invocation785819 -Node: Finding The Bug787148 -Node: List of Debugger Commands793636 -Node: Breakpoint Control794970 -Node: Debugger Execution Control798634 -Node: Viewing And Changing Data801994 -Node: Execution Stack805350 -Node: Debugger Info806817 -Node: Miscellaneous Debugger Commands810799 -Node: Readline Support816244 -Node: Limitations817075 -Node: Arbitrary Precision Arithmetic819327 -Ref: Arbitrary Precision Arithmetic-Footnote-1820969 -Node: General Arithmetic821117 -Node: Floating Point Issues822837 -Node: String Conversion Precision823718 -Ref: String Conversion Precision-Footnote-1825424 -Node: Unexpected Results825533 -Node: POSIX Floating Point Problems827686 -Ref: POSIX Floating Point Problems-Footnote-1831511 -Node: Integer Programming831549 -Node: Floating-point Programming833302 -Ref: Floating-point Programming-Footnote-1839611 -Node: Floating-point Representation839875 -Node: Floating-point Context841040 -Ref: table-ieee-formats841882 -Node: Rounding Mode843266 -Ref: table-rounding-modes843745 -Ref: Rounding Mode-Footnote-1846749 -Node: Gawk and MPFR846930 -Node: Arbitrary Precision Floats848172 -Ref: Arbitrary Precision Floats-Footnote-1850601 -Node: Setting Precision850912 -Node: Setting Rounding Mode853645 -Ref: table-gawk-rounding-modes854049 -Node: Floating-point Constants855229 -Node: Changing Precision856653 -Ref: Changing Precision-Footnote-1858053 -Node: Exact Arithmetic858227 -Node: Arbitrary Precision Integers861335 -Ref: Arbitrary Precision Integers-Footnote-1864335 -Node: Dynamic Extensions864482 -Node: Extension Intro865859 -Node: Plugin License867067 -Node: Extension Mechanism Outline867752 -Ref: load-extension868169 -Ref: load-new-function869647 -Ref: call-new-function870642 -Node: Extension API Description872650 -Node: Extension API Functions Introduction873989 -Node: General Data Types878767 -Ref: General Data Types-Footnote-1884369 -Node: Requesting Values884668 -Ref: table-value-types-returned885399 -Node: Constructor Functions886353 -Node: Registration Functions889349 -Node: Extension Functions890034 -Node: Exit Callback Functions892208 -Node: Extension Version String893451 -Node: Input Parsers894101 -Node: Output Wrappers903818 -Node: Two-way processors908234 -Node: Printing Messages910364 -Ref: Printing Messages-Footnote-1911441 -Node: Updating `ERRNO'911593 -Node: Accessing Parameters912332 -Node: Symbol Table Access913562 -Node: Symbol table by name914074 -Node: Symbol table by cookie915647 -Ref: Symbol table by cookie-Footnote-1919776 -Node: Cached values919839 -Ref: Cached values-Footnote-1923282 -Node: Array Manipulation923373 -Ref: Array Manipulation-Footnote-1924471 -Node: Array Data Types924510 -Ref: Array Data Types-Footnote-1927213 -Node: Array Functions927305 -Node: Flattening Arrays931071 -Node: Creating Arrays937910 -Node: Extension API Variables942705 -Node: Extension Versioning943341 -Node: Extension API Informational Variables945242 -Node: Extension API Boilerplate946328 -Node: Finding Extensions950159 -Node: Extension Example950706 -Node: Internal File Description951444 -Node: Internal File Ops955132 -Ref: Internal File Ops-Footnote-1966579 -Node: Using Internal File Ops966719 -Ref: Using Internal File Ops-Footnote-1969072 -Node: Extension Samples969338 -Node: Extension Sample File Functions970862 -Node: Extension Sample Fnmatch979335 -Node: Extension Sample Fork981061 -Node: Extension Sample Inplace982279 -Node: Extension Sample Ord984071 -Node: Extension Sample Readdir984850 -Node: Extension Sample Revout986354 -Node: Extension Sample Rev2way986947 -Node: Extension Sample Read write array987637 -Node: Extension Sample Readfile989520 -Node: Extension Sample API Tests990277 -Node: Extension Sample Time990802 -Node: gawkextlib992109 -Node: Language History994490 -Node: V7/SVR3.1996012 -Node: SVR4998333 -Node: POSIX999775 -Node: BTL1000783 -Node: POSIX/GNU1001588 -Node: Common Extensions1007123 -Node: Ranges and Locales1008230 -Ref: Ranges and Locales-Footnote-11012848 -Ref: Ranges and Locales-Footnote-21012875 -Ref: Ranges and Locales-Footnote-31013135 -Node: Contributors1013356 -Node: Installation1017652 -Node: Gawk Distribution1018546 -Node: Getting1019030 -Node: Extracting1019856 -Node: Distribution contents1021548 -Node: Unix Installation1026809 -Node: Quick Installation1027426 -Node: Additional Configuration Options1029388 -Node: Configuration Philosophy1030865 -Node: Non-Unix Installation1033207 -Node: PC Installation1033665 -Node: PC Binary Installation1034964 -Node: PC Compiling1036812 -Node: PC Testing1039756 -Node: PC Using1040932 -Node: Cygwin1045117 -Node: MSYS1046117 -Node: VMS Installation1046631 -Node: VMS Compilation1047234 -Ref: VMS Compilation-Footnote-11048241 -Node: VMS Installation Details1048299 -Node: VMS Running1049934 -Node: VMS Old Gawk1051541 -Node: Bugs1052015 -Node: Other Versions1055867 -Node: Notes1061197 -Node: Compatibility Mode1061997 -Node: Additions1062780 -Node: Accessing The Source1063707 -Node: Adding Code1065310 -Node: New Ports1071352 -Node: Derived Files1075487 -Ref: Derived Files-Footnote-11080808 -Ref: Derived Files-Footnote-21080842 -Ref: Derived Files-Footnote-31081442 -Node: Future Extensions1081540 -Node: Implementation Limitations1082121 -Node: Extension Design1083373 -Node: Old Extension Problems1084522 -Ref: Old Extension Problems-Footnote-11086030 -Node: Extension New Mechanism Goals1086087 -Ref: Extension New Mechanism Goals-Footnote-11089446 -Node: Extension Other Design Decisions1089632 -Node: Extension Future Growth1091738 -Node: Old Extension Mechansim1092559 -Node: Basic Concepts1094316 -Node: Basic High Level1094997 -Ref: figure-general-flow1095268 -Ref: figure-process-flow1095867 -Ref: Basic High Level-Footnote-11099096 -Node: Basic Data Typing1099281 -Node: Glossary1102636 -Node: Copying1127947 -Node: GNU Free Documentation License1165504 -Node: Index1190641 +Ref: Read Timeout-Footnote-1250049 +Node: Command line directories250106 +Node: Printing250736 +Node: Print252367 +Node: Print Examples253704 +Node: Output Separators256488 +Node: OFMT258248 +Node: Printf259606 +Node: Basic Printf260512 +Node: Control Letters262051 +Node: Format Modifiers265863 +Node: Printf Examples271872 +Node: Redirection274587 +Node: Special Files281571 +Node: Special FD282104 +Ref: Special FD-Footnote-1285729 +Node: Special Network285803 +Node: Special Caveats286653 +Node: Close Files And Pipes287449 +Ref: Close Files And Pipes-Footnote-1294472 +Ref: Close Files And Pipes-Footnote-2294620 +Node: Expressions294770 +Node: Values295902 +Node: Constants296578 +Node: Scalar Constants297258 +Ref: Scalar Constants-Footnote-1298117 +Node: Nondecimal-numbers298299 +Node: Regexp Constants301358 +Node: Using Constant Regexps301833 +Node: Variables304888 +Node: Using Variables305543 +Node: Assignment Options307267 +Node: Conversion309139 +Ref: table-locale-affects314630 +Ref: Conversion-Footnote-1315254 +Node: All Operators315363 +Node: Arithmetic Ops315993 +Node: Concatenation318498 +Ref: Concatenation-Footnote-1321291 +Node: Assignment Ops321411 +Ref: table-assign-ops326399 +Node: Increment Ops327807 +Node: Truth Values and Conditions331277 +Node: Truth Values332360 +Node: Typing and Comparison333409 +Node: Variable Typing334198 +Ref: Variable Typing-Footnote-1338095 +Node: Comparison Operators338217 +Ref: table-relational-ops338627 +Node: POSIX String Comparison342176 +Ref: POSIX String Comparison-Footnote-1343132 +Node: Boolean Ops343270 +Ref: Boolean Ops-Footnote-1347348 +Node: Conditional Exp347439 +Node: Function Calls349171 +Node: Precedence352765 +Node: Locales356434 +Node: Patterns and Actions357523 +Node: Pattern Overview358577 +Node: Regexp Patterns360246 +Node: Expression Patterns360789 +Node: Ranges364474 +Node: BEGIN/END367440 +Node: Using BEGIN/END368202 +Ref: Using BEGIN/END-Footnote-1370933 +Node: I/O And BEGIN/END371039 +Node: BEGINFILE/ENDFILE373321 +Node: Empty376225 +Node: Using Shell Variables376541 +Node: Action Overview378826 +Node: Statements381183 +Node: If Statement383037 +Node: While Statement384536 +Node: Do Statement386580 +Node: For Statement387736 +Node: Switch Statement390888 +Node: Break Statement392985 +Node: Continue Statement394975 +Node: Next Statement396768 +Node: Nextfile Statement399158 +Node: Exit Statement401799 +Node: Built-in Variables404215 +Node: User-modified405310 +Ref: User-modified-Footnote-1413665 +Node: Auto-set413727 +Ref: Auto-set-Footnote-1426078 +Ref: Auto-set-Footnote-2426283 +Node: ARGC and ARGV426339 +Node: Arrays430190 +Node: Array Basics431695 +Node: Array Intro432521 +Node: Reference to Elements436839 +Node: Assigning Elements439109 +Node: Array Example439600 +Node: Scanning an Array441332 +Node: Controlling Scanning443646 +Ref: Controlling Scanning-Footnote-1448579 +Node: Delete448895 +Ref: Delete-Footnote-1451660 +Node: Numeric Array Subscripts451717 +Node: Uninitialized Subscripts453900 +Node: Multi-dimensional455528 +Node: Multi-scanning458622 +Node: Arrays of Arrays460213 +Node: Functions464858 +Node: Built-in465677 +Node: Calling Built-in466755 +Node: Numeric Functions468743 +Ref: Numeric Functions-Footnote-1472575 +Ref: Numeric Functions-Footnote-2472932 +Ref: Numeric Functions-Footnote-3472980 +Node: String Functions473249 +Ref: String Functions-Footnote-1496746 +Ref: String Functions-Footnote-2496875 +Ref: String Functions-Footnote-3497123 +Node: Gory Details497210 +Ref: table-sub-escapes498889 +Ref: table-sub-posix-92500243 +Ref: table-sub-proposed501594 +Ref: table-posix-sub502948 +Ref: table-gensub-escapes504493 +Ref: Gory Details-Footnote-1505700 +Ref: Gory Details-Footnote-2505751 +Node: I/O Functions505902 +Ref: I/O Functions-Footnote-1513007 +Node: Time Functions513154 +Ref: Time Functions-Footnote-1524087 +Ref: Time Functions-Footnote-2524155 +Ref: Time Functions-Footnote-3524313 +Ref: Time Functions-Footnote-4524424 +Ref: Time Functions-Footnote-5524536 +Ref: Time Functions-Footnote-6524763 +Node: Bitwise Functions525029 +Ref: table-bitwise-ops525587 +Ref: Bitwise Functions-Footnote-1529808 +Node: Type Functions529992 +Node: I18N Functions530462 +Node: User-defined532089 +Node: Definition Syntax532893 +Ref: Definition Syntax-Footnote-1537803 +Node: Function Example537872 +Node: Function Caveats540466 +Node: Calling A Function540887 +Node: Variable Scope542002 +Node: Pass By Value/Reference544965 +Node: Return Statement548405 +Node: Dynamic Typing551386 +Node: Indirect Calls552317 +Node: Library Functions562002 +Ref: Library Functions-Footnote-1565515 +Ref: Library Functions-Footnote-2565658 +Node: Library Names565829 +Ref: Library Names-Footnote-1569300 +Ref: Library Names-Footnote-2569520 +Node: General Functions569606 +Node: Strtonum Function570559 +Node: Assert Function573489 +Node: Round Function576815 +Node: Cliff Random Function578358 +Node: Ordinal Functions579374 +Ref: Ordinal Functions-Footnote-1582444 +Ref: Ordinal Functions-Footnote-2582696 +Node: Join Function582905 +Ref: Join Function-Footnote-1584676 +Node: Getlocaltime Function584876 +Node: Data File Management588591 +Node: Filetrans Function589223 +Node: Rewind Function593362 +Node: File Checking594749 +Node: Empty Files595843 +Node: Ignoring Assigns598073 +Node: Getopt Function599626 +Ref: Getopt Function-Footnote-1610930 +Node: Passwd Functions611133 +Ref: Passwd Functions-Footnote-1620108 +Node: Group Functions620196 +Node: Walking Arrays628280 +Node: Sample Programs629849 +Node: Running Examples630526 +Node: Clones631254 +Node: Cut Program632478 +Node: Egrep Program642323 +Ref: Egrep Program-Footnote-1650096 +Node: Id Program650206 +Node: Split Program653822 +Ref: Split Program-Footnote-1657341 +Node: Tee Program657469 +Node: Uniq Program660272 +Node: Wc Program667701 +Ref: Wc Program-Footnote-1671967 +Ref: Wc Program-Footnote-2672167 +Node: Miscellaneous Programs672259 +Node: Dupword Program673447 +Node: Alarm Program675478 +Node: Translate Program680227 +Ref: Translate Program-Footnote-1684614 +Ref: Translate Program-Footnote-2684842 +Node: Labels Program684976 +Ref: Labels Program-Footnote-1688347 +Node: Word Sorting688431 +Node: History Sorting692315 +Node: Extract Program694154 +Ref: Extract Program-Footnote-1701655 +Node: Simple Sed701783 +Node: Igawk Program704845 +Ref: Igawk Program-Footnote-1720002 +Ref: Igawk Program-Footnote-2720203 +Node: Anagram Program720341 +Node: Signature Program723409 +Node: Internationalization724509 +Node: I18N and L10N725941 +Node: Explaining gettext726627 +Ref: Explaining gettext-Footnote-1731693 +Ref: Explaining gettext-Footnote-2731877 +Node: Programmer i18n732042 +Node: Translator i18n736242 +Node: String Extraction737035 +Ref: String Extraction-Footnote-1737996 +Node: Printf Ordering738082 +Ref: Printf Ordering-Footnote-1740866 +Node: I18N Portability740930 +Ref: I18N Portability-Footnote-1743379 +Node: I18N Example743442 +Ref: I18N Example-Footnote-1746077 +Node: Gawk I18N746149 +Node: Advanced Features746766 +Node: Nondecimal Data748270 +Node: Array Sorting749853 +Node: Controlling Array Traversal750550 +Node: Array Sorting Functions758788 +Ref: Array Sorting Functions-Footnote-1762462 +Ref: Array Sorting Functions-Footnote-2762555 +Node: Two-way I/O762749 +Ref: Two-way I/O-Footnote-1768181 +Node: TCP/IP Networking768251 +Node: Profiling771095 +Node: Debugger778549 +Node: Debugging779517 +Node: Debugging Concepts779950 +Node: Debugging Terms781806 +Node: Awk Debugging784403 +Node: Sample Debugging Session785295 +Node: Debugger Invocation785815 +Node: Finding The Bug787144 +Node: List of Debugger Commands793632 +Node: Breakpoint Control794966 +Node: Debugger Execution Control798630 +Node: Viewing And Changing Data801990 +Node: Execution Stack805346 +Node: Debugger Info806813 +Node: Miscellaneous Debugger Commands810795 +Node: Readline Support816240 +Node: Limitations817071 +Node: Arbitrary Precision Arithmetic819323 +Ref: Arbitrary Precision Arithmetic-Footnote-1820965 +Node: General Arithmetic821113 +Node: Floating Point Issues822833 +Node: String Conversion Precision823714 +Ref: String Conversion Precision-Footnote-1825420 +Node: Unexpected Results825529 +Node: POSIX Floating Point Problems827682 +Ref: POSIX Floating Point Problems-Footnote-1831507 +Node: Integer Programming831545 +Node: Floating-point Programming833298 +Ref: Floating-point Programming-Footnote-1839607 +Node: Floating-point Representation839871 +Node: Floating-point Context841036 +Ref: table-ieee-formats841878 +Node: Rounding Mode843262 +Ref: table-rounding-modes843741 +Ref: Rounding Mode-Footnote-1846745 +Node: Gawk and MPFR846926 +Node: Arbitrary Precision Floats848168 +Ref: Arbitrary Precision Floats-Footnote-1850597 +Node: Setting Precision850908 +Node: Setting Rounding Mode853641 +Ref: table-gawk-rounding-modes854045 +Node: Floating-point Constants855225 +Node: Changing Precision856649 +Ref: Changing Precision-Footnote-1858049 +Node: Exact Arithmetic858223 +Node: Arbitrary Precision Integers861331 +Ref: Arbitrary Precision Integers-Footnote-1864331 +Node: Dynamic Extensions864478 +Node: Extension Intro865855 +Node: Plugin License867063 +Node: Extension Mechanism Outline867748 +Ref: load-extension868165 +Ref: load-new-function869643 +Ref: call-new-function870638 +Node: Extension API Description872646 +Node: Extension API Functions Introduction873985 +Node: General Data Types878763 +Ref: General Data Types-Footnote-1884365 +Node: Requesting Values884664 +Ref: table-value-types-returned885395 +Node: Constructor Functions886349 +Node: Registration Functions889345 +Node: Extension Functions890030 +Node: Exit Callback Functions892204 +Node: Extension Version String893447 +Node: Input Parsers894097 +Node: Output Wrappers903814 +Node: Two-way processors908230 +Node: Printing Messages910360 +Ref: Printing Messages-Footnote-1911437 +Node: Updating `ERRNO'911589 +Node: Accessing Parameters912328 +Node: Symbol Table Access913558 +Node: Symbol table by name914070 +Node: Symbol table by cookie915643 +Ref: Symbol table by cookie-Footnote-1919772 +Node: Cached values919835 +Ref: Cached values-Footnote-1923278 +Node: Array Manipulation923369 +Ref: Array Manipulation-Footnote-1924467 +Node: Array Data Types924506 +Ref: Array Data Types-Footnote-1927209 +Node: Array Functions927301 +Node: Flattening Arrays931067 +Node: Creating Arrays937906 +Node: Extension API Variables942701 +Node: Extension Versioning943337 +Node: Extension API Informational Variables945238 +Node: Extension API Boilerplate946324 +Node: Finding Extensions950155 +Node: Extension Example950702 +Node: Internal File Description951440 +Node: Internal File Ops955128 +Ref: Internal File Ops-Footnote-1966575 +Node: Using Internal File Ops966715 +Ref: Using Internal File Ops-Footnote-1969068 +Node: Extension Samples969334 +Node: Extension Sample File Functions970858 +Node: Extension Sample Fnmatch979331 +Node: Extension Sample Fork981057 +Node: Extension Sample Inplace982275 +Node: Extension Sample Ord984067 +Node: Extension Sample Readdir984846 +Node: Extension Sample Revout986350 +Node: Extension Sample Rev2way986943 +Node: Extension Sample Read write array987633 +Node: Extension Sample Readfile989516 +Node: Extension Sample API Tests990273 +Node: Extension Sample Time990798 +Node: gawkextlib992105 +Node: Language History994486 +Node: V7/SVR3.1996008 +Node: SVR4998329 +Node: POSIX999771 +Node: BTL1000779 +Node: POSIX/GNU1001584 +Node: Common Extensions1007119 +Node: Ranges and Locales1008226 +Ref: Ranges and Locales-Footnote-11012844 +Ref: Ranges and Locales-Footnote-21012871 +Ref: Ranges and Locales-Footnote-31013131 +Node: Contributors1013352 +Node: Installation1017648 +Node: Gawk Distribution1018542 +Node: Getting1019026 +Node: Extracting1019852 +Node: Distribution contents1021544 +Node: Unix Installation1026805 +Node: Quick Installation1027422 +Node: Additional Configuration Options1029384 +Node: Configuration Philosophy1030861 +Node: Non-Unix Installation1033203 +Node: PC Installation1033661 +Node: PC Binary Installation1034960 +Node: PC Compiling1036808 +Node: PC Testing1039752 +Node: PC Using1040928 +Node: Cygwin1045113 +Node: MSYS1046113 +Node: VMS Installation1046627 +Node: VMS Compilation1047230 +Ref: VMS Compilation-Footnote-11048237 +Node: VMS Installation Details1048295 +Node: VMS Running1049930 +Node: VMS Old Gawk1051537 +Node: Bugs1052011 +Node: Other Versions1055863 +Node: Notes1061193 +Node: Compatibility Mode1061993 +Node: Additions1062776 +Node: Accessing The Source1063703 +Node: Adding Code1065306 +Node: New Ports1071348 +Node: Derived Files1075483 +Ref: Derived Files-Footnote-11080804 +Ref: Derived Files-Footnote-21080838 +Ref: Derived Files-Footnote-31081438 +Node: Future Extensions1081536 +Node: Implementation Limitations1082117 +Node: Extension Design1083369 +Node: Old Extension Problems1084518 +Ref: Old Extension Problems-Footnote-11086026 +Node: Extension New Mechanism Goals1086083 +Ref: Extension New Mechanism Goals-Footnote-11089442 +Node: Extension Other Design Decisions1089628 +Node: Extension Future Growth1091734 +Node: Old Extension Mechansim1092555 +Node: Basic Concepts1094312 +Node: Basic High Level1094993 +Ref: figure-general-flow1095264 +Ref: figure-process-flow1095863 +Ref: Basic High Level-Footnote-11099092 +Node: Basic Data Typing1099277 +Node: Glossary1102632 +Node: Copying1127943 +Node: GNU Free Documentation License1165500 +Node: Index1190637 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 38f4855f..2cf38283 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -7562,7 +7562,7 @@ in the @code{PROCINFO} array: PROCINFO["input_name", "READ_TIMEOUT"] = @var{timeout in milliseconds} @end example -When set, this will cause @command{gawk} to time out and return failure +When set, this causes @command{gawk} to time out and return failure if no data is available to read within the specified timeout period. For example, a TCP client can decide to give up on receiving any response from the server after a certain amount of time: @@ -8807,7 +8807,7 @@ to confusing results. Finally, using the @code{close()} function on a @value{FN} of the form @code{"/dev/fd/@var{N}"}, for file descriptor numbers -above two, will actually close the given file descriptor. +above two, does actually close the given file descriptor. The @file{/dev/stdin}, @file{/dev/stdout}, and @file{/dev/stderr} special files are also recognized internally by several other @@ -37476,3 +37476,4 @@ Suggestions: % 1. Standardize the error messages from the functions and programs % in the two sample code chapters. % 2. Nuke the BBS stuff and use something that won't be obsolete +% 3. Turn the advanced notes into sidebars by using @cartouche |