diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2017-12-28 21:07:11 +0200 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2017-12-28 21:07:11 +0200 |
commit | 5d7845e424e3ccb9fed4ba6bbb03be322a1c40f0 (patch) | |
tree | fccda1af035648aeba04d0d35e414caed8f991c3 | |
parent | 57801f2be5b7548e2dba148a54c0b0542a4240c7 (diff) | |
parent | fb0b2663915846fb275ce9c04b78370c6bf9f2e4 (diff) | |
download | egawk-5d7845e424e3ccb9fed4ba6bbb03be322a1c40f0.tar.gz egawk-5d7845e424e3ccb9fed4ba6bbb03be322a1c40f0.tar.bz2 egawk-5d7845e424e3ccb9fed4ba6bbb03be322a1c40f0.zip |
Merge branch 'gawk-4.2-stable'
-rw-r--r-- | doc/ChangeLog | 2 | ||||
-rw-r--r-- | doc/gawk.info | 1134 | ||||
-rw-r--r-- | doc/gawk.texi | 35 | ||||
-rw-r--r-- | doc/gawktexi.in | 35 |
4 files changed, 589 insertions, 617 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 3bd0dd5c..b19a57b6 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,6 +1,8 @@ 2017-12-28 Arnold D. Robbins <arnold@skeeve.com> * texinfo.tex: Updated. + * gawktexi.in (How To Contribute): Update to point to + awklang.org. 2017-12-22 Arnold D. Robbins <arnold@skeeve.com> diff --git a/doc/gawk.info b/doc/gawk.info index 66d2b9b3..c3c4e8e7 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -1274,8 +1274,16 @@ keep the 'gawk' distribution down to manageable size. The initial collection of material, such as it is, is still available at <ftp://ftp.freefriends.org/arnold/Awkstuff>. - If you are _seriously_ interested in helping set up a website for -'awk'-language related things, please contact me. + In the hopes of doing something more broad, I acquired the +'awklang.org' domain. Late in 2017, a volunteer took on the task of +managing it. + + If you have written an interesting 'awk' program, that you would like +to share with the rest of the world, please see <http://www.awklang.org> +and use the "Contact" link. + + If you have written a 'gawk' extension, please see *note +gawkextlib::. File: gawk.info, Node: Acknowledgments, Prev: How To Contribute, Up: Preface @@ -35953,566 +35961,566 @@ Node: Manual History65248 Ref: Manual History-Footnote-168245 Ref: Manual History-Footnote-268286 Node: How To Contribute68360 -Node: Acknowledgments69011 -Node: Getting Started73919 -Node: Running gawk76358 -Node: One-shot77548 -Node: Read Terminal78811 -Node: Long80804 -Node: Executable Scripts82317 -Ref: Executable Scripts-Footnote-185112 -Node: Comments85215 -Node: Quoting87699 -Node: DOS Quoting93216 -Node: Sample Data Files95272 -Node: Very Simple97867 -Node: Two Rules102769 -Node: More Complex104654 -Node: Statements/Lines107520 -Ref: Statements/Lines-Footnote-1111979 -Node: Other Features112244 -Node: When113180 -Ref: When-Footnote-1114934 -Node: Intro Summary114999 -Node: Invoking Gawk115883 -Node: Command Line117397 -Node: Options118195 -Ref: Options-Footnote-1134814 -Ref: Options-Footnote-2135045 -Node: Other Arguments135070 -Node: Naming Standard Input138017 -Node: Environment Variables139110 -Node: AWKPATH Variable139668 -Ref: AWKPATH Variable-Footnote-1143080 -Ref: AWKPATH Variable-Footnote-2143114 -Node: AWKLIBPATH Variable143375 -Node: Other Environment Variables144632 -Node: Exit Status148453 -Node: Include Files149130 -Node: Loading Shared Libraries152655 -Node: Obsolete154083 -Node: Undocumented154775 -Node: Invoking Summary155072 -Node: Regexp156732 -Node: Regexp Usage158186 -Node: Escape Sequences160223 -Node: Regexp Operators166455 -Ref: Regexp Operators-Footnote-1173871 -Ref: Regexp Operators-Footnote-2174018 -Node: Bracket Expressions174116 -Ref: table-char-classes176592 -Node: Leftmost Longest179729 -Node: Computed Regexps181032 -Node: GNU Regexp Operators184459 -Node: Case-sensitivity188138 -Ref: Case-sensitivity-Footnote-1191025 -Ref: Case-sensitivity-Footnote-2191260 -Node: Regexp Summary191368 -Node: Reading Files192834 -Node: Records195103 -Node: awk split records195836 -Node: gawk split records200767 -Ref: gawk split records-Footnote-1205307 -Node: Fields205344 -Node: Nonconstant Fields208085 -Ref: Nonconstant Fields-Footnote-1210321 -Node: Changing Fields210525 -Node: Field Separators216453 -Node: Default Field Splitting219151 -Node: Regexp Field Splitting220269 -Node: Single Character Fields223622 -Node: Command Line Field Separator224682 -Node: Full Line Fields227900 -Ref: Full Line Fields-Footnote-1229422 -Ref: Full Line Fields-Footnote-2229468 -Node: Field Splitting Summary229569 -Node: Constant Size231643 -Node: Fixed width data232375 -Node: Skipping intervening235842 -Node: Allowing trailing data236640 -Node: Fields with fixed data237677 -Node: Splitting By Content239195 -Ref: Splitting By Content-Footnote-1242845 -Node: Testing field creation243008 -Node: Multiple Line244633 -Ref: Multiple Line-Footnote-1250517 -Node: Getline250696 -Node: Plain Getline253165 -Node: Getline/Variable255806 -Node: Getline/File256957 -Node: Getline/Variable/File258345 -Ref: Getline/Variable/File-Footnote-1259950 -Node: Getline/Pipe260038 -Node: Getline/Variable/Pipe262745 -Node: Getline/Coprocess263880 -Node: Getline/Variable/Coprocess265147 -Node: Getline Notes265889 -Node: Getline Summary268686 -Ref: table-getline-variants269110 -Node: Read Timeout269858 -Ref: Read Timeout-Footnote-1273764 -Node: Retrying Input273822 -Node: Command-line directories275021 -Node: Input Summary275927 -Node: Input Exercises279099 -Node: Printing279827 -Node: Print281661 -Node: Print Examples283118 -Node: Output Separators285898 -Node: OFMT287915 -Node: Printf289271 -Node: Basic Printf290056 -Node: Control Letters291630 -Node: Format Modifiers295626 -Node: Printf Examples301641 -Node: Redirection304127 -Node: Special FD310968 -Ref: Special FD-Footnote-1314136 -Node: Special Files314210 -Node: Other Inherited Files314827 -Node: Special Network315828 -Node: Special Caveats316688 -Node: Close Files And Pipes317637 -Ref: table-close-pipe-return-values324544 -Ref: Close Files And Pipes-Footnote-1325357 -Ref: Close Files And Pipes-Footnote-2325505 -Node: Nonfatal325657 -Node: Output Summary327995 -Node: Output Exercises329217 -Node: Expressions329896 -Node: Values331084 -Node: Constants331762 -Node: Scalar Constants332453 -Ref: Scalar Constants-Footnote-1333317 -Node: Nondecimal-numbers333567 -Node: Regexp Constants336568 -Node: Using Constant Regexps337094 -Node: Standard Regexp Constants337716 -Node: Strong Regexp Constants340904 -Node: Variables343862 -Node: Using Variables344519 -Node: Assignment Options346429 -Node: Conversion348302 -Node: Strings And Numbers348826 -Ref: Strings And Numbers-Footnote-1351889 -Node: Locale influences conversions351998 -Ref: table-locale-affects354756 -Node: All Operators355374 -Node: Arithmetic Ops356003 -Node: Concatenation358509 -Ref: Concatenation-Footnote-1361356 -Node: Assignment Ops361463 -Ref: table-assign-ops366454 -Node: Increment Ops367767 -Node: Truth Values and Conditions371227 -Node: Truth Values372301 -Node: Typing and Comparison373349 -Node: Variable Typing374169 -Ref: Variable Typing-Footnote-1380632 -Ref: Variable Typing-Footnote-2380704 -Node: Comparison Operators380781 -Ref: table-relational-ops381200 -Node: POSIX String Comparison384695 -Ref: POSIX String Comparison-Footnote-1386390 -Ref: POSIX String Comparison-Footnote-2386529 -Node: Boolean Ops386613 -Ref: Boolean Ops-Footnote-1391095 -Node: Conditional Exp391187 -Node: Function Calls392923 -Node: Precedence396800 -Node: Locales400459 -Node: Expressions Summary402091 -Node: Patterns and Actions404664 -Node: Pattern Overview405784 -Node: Regexp Patterns407461 -Node: Expression Patterns408003 -Node: Ranges411784 -Node: BEGIN/END414892 -Node: Using BEGIN/END415653 -Ref: Using BEGIN/END-Footnote-1418389 -Node: I/O And BEGIN/END418495 -Node: BEGINFILE/ENDFILE420809 -Node: Empty423722 -Node: Using Shell Variables424039 -Node: Action Overview426313 -Node: Statements428638 -Node: If Statement430486 -Node: While Statement431981 -Node: Do Statement434009 -Node: For Statement435157 -Node: Switch Statement438328 -Node: Break Statement440714 -Node: Continue Statement442806 -Node: Next Statement444633 -Node: Nextfile Statement447016 -Node: Exit Statement449668 -Node: Built-in Variables452071 -Node: User-modified453204 -Node: Auto-set460971 -Ref: Auto-set-Footnote-1477304 -Ref: Auto-set-Footnote-2477510 -Node: ARGC and ARGV477566 -Node: Pattern Action Summary481779 -Node: Arrays484209 -Node: Array Basics485538 -Node: Array Intro486382 -Ref: figure-array-elements488357 -Ref: Array Intro-Footnote-1491061 -Node: Reference to Elements491189 -Node: Assigning Elements493653 -Node: Array Example494144 -Node: Scanning an Array495903 -Node: Controlling Scanning498925 -Ref: Controlling Scanning-Footnote-1504324 -Node: Numeric Array Subscripts504640 -Node: Uninitialized Subscripts506824 -Node: Delete508443 -Ref: Delete-Footnote-1511195 -Node: Multidimensional511252 -Node: Multiscanning514347 -Node: Arrays of Arrays515938 -Node: Arrays Summary520705 -Node: Functions522798 -Node: Built-in523836 -Node: Calling Built-in524917 -Node: Numeric Functions526913 -Ref: Numeric Functions-Footnote-1530941 -Ref: Numeric Functions-Footnote-2531298 -Ref: Numeric Functions-Footnote-3531346 -Node: String Functions531618 -Ref: String Functions-Footnote-1555276 -Ref: String Functions-Footnote-2555404 -Ref: String Functions-Footnote-3555652 -Node: Gory Details555739 -Ref: table-sub-escapes557530 -Ref: table-sub-proposed559049 -Ref: table-posix-sub560412 -Ref: table-gensub-escapes561953 -Ref: Gory Details-Footnote-1562776 -Node: I/O Functions562930 -Ref: table-system-return-values569398 -Ref: I/O Functions-Footnote-1571378 -Ref: I/O Functions-Footnote-2571526 -Node: Time Functions571646 -Ref: Time Functions-Footnote-1582317 -Ref: Time Functions-Footnote-2582385 -Ref: Time Functions-Footnote-3582543 -Ref: Time Functions-Footnote-4582654 -Ref: Time Functions-Footnote-5582766 -Ref: Time Functions-Footnote-6582993 -Node: Bitwise Functions583259 -Ref: table-bitwise-ops583853 -Ref: Bitwise Functions-Footnote-1589898 -Ref: Bitwise Functions-Footnote-2590071 -Node: Type Functions590262 -Node: I18N Functions593013 -Node: User-defined594664 -Node: Definition Syntax595469 -Ref: Definition Syntax-Footnote-1601156 -Node: Function Example601227 -Ref: Function Example-Footnote-1604149 -Node: Function Caveats604171 -Node: Calling A Function604689 -Node: Variable Scope605647 -Node: Pass By Value/Reference608641 -Node: Return Statement612140 -Node: Dynamic Typing615119 -Node: Indirect Calls616049 -Ref: Indirect Calls-Footnote-1626301 -Node: Functions Summary626429 -Node: Library Functions629134 -Ref: Library Functions-Footnote-1632741 -Ref: Library Functions-Footnote-2632884 -Node: Library Names633055 -Ref: Library Names-Footnote-1636515 -Ref: Library Names-Footnote-2636738 -Node: General Functions636824 -Node: Strtonum Function637927 -Node: Assert Function640949 -Node: Round Function644275 -Node: Cliff Random Function645815 -Node: Ordinal Functions646831 -Ref: Ordinal Functions-Footnote-1649894 -Ref: Ordinal Functions-Footnote-2650146 -Node: Join Function650356 -Ref: Join Function-Footnote-1652126 -Node: Getlocaltime Function652326 -Node: Readfile Function656068 -Node: Shell Quoting658045 -Node: Data File Management659446 -Node: Filetrans Function660078 -Node: Rewind Function664174 -Node: File Checking666084 -Ref: File Checking-Footnote-1667418 -Node: Empty Files667619 -Node: Ignoring Assigns669598 -Node: Getopt Function671148 -Ref: Getopt Function-Footnote-1682617 -Node: Passwd Functions682817 -Ref: Passwd Functions-Footnote-1691656 -Node: Group Functions691744 -Ref: Group Functions-Footnote-1699642 -Node: Walking Arrays699849 -Node: Library Functions Summary702857 -Node: Library Exercises704263 -Node: Sample Programs704728 -Node: Running Examples705498 -Node: Clones706226 -Node: Cut Program707450 -Node: Egrep Program717379 -Ref: Egrep Program-Footnote-1724891 -Node: Id Program725001 -Node: Split Program728681 -Ref: Split Program-Footnote-1732139 -Node: Tee Program732268 -Node: Uniq Program735058 -Node: Wc Program742484 -Ref: Wc Program-Footnote-1746739 -Node: Miscellaneous Programs746833 -Node: Dupword Program748046 -Node: Alarm Program750076 -Node: Translate Program754931 -Ref: Translate Program-Footnote-1759496 -Node: Labels Program759766 -Ref: Labels Program-Footnote-1763117 -Node: Word Sorting763201 -Node: History Sorting767273 -Node: Extract Program769108 -Node: Simple Sed776638 -Node: Igawk Program779712 -Ref: Igawk Program-Footnote-1794043 -Ref: Igawk Program-Footnote-2794245 -Ref: Igawk Program-Footnote-3794367 -Node: Anagram Program794482 -Node: Signature Program797544 -Node: Programs Summary798791 -Node: Programs Exercises800005 -Ref: Programs Exercises-Footnote-1804134 -Node: Advanced Features804225 -Node: Nondecimal Data806215 -Node: Array Sorting807806 -Node: Controlling Array Traversal808506 -Ref: Controlling Array Traversal-Footnote-1816874 -Node: Array Sorting Functions816992 -Ref: Array Sorting Functions-Footnote-1822083 -Node: Two-way I/O822279 -Ref: Two-way I/O-Footnote-1828831 -Ref: Two-way I/O-Footnote-2829018 -Node: TCP/IP Networking829100 -Node: Profiling832218 -Ref: Profiling-Footnote-1840890 -Node: Advanced Features Summary841213 -Node: Internationalization843057 -Node: I18N and L10N844537 -Node: Explaining gettext845224 -Ref: Explaining gettext-Footnote-1851116 -Ref: Explaining gettext-Footnote-2851301 -Node: Programmer i18n851466 -Ref: Programmer i18n-Footnote-1856415 -Node: Translator i18n856464 -Node: String Extraction857258 -Ref: String Extraction-Footnote-1858390 -Node: Printf Ordering858476 -Ref: Printf Ordering-Footnote-1861262 -Node: I18N Portability861326 -Ref: I18N Portability-Footnote-1863782 -Node: I18N Example863845 -Ref: I18N Example-Footnote-1866651 -Node: Gawk I18N866724 -Node: I18N Summary867369 -Node: Debugger868710 -Node: Debugging869733 -Node: Debugging Concepts870174 -Node: Debugging Terms871983 -Node: Awk Debugging874558 -Node: Sample Debugging Session875464 -Node: Debugger Invocation875998 -Node: Finding The Bug877384 -Node: List of Debugger Commands883862 -Node: Breakpoint Control885195 -Node: Debugger Execution Control888889 -Node: Viewing And Changing Data892251 -Node: Execution Stack895625 -Node: Debugger Info897262 -Node: Miscellaneous Debugger Commands901333 -Node: Readline Support906395 -Node: Limitations907291 -Node: Debugging Summary909400 -Node: Arbitrary Precision Arithmetic910679 -Node: Computer Arithmetic912164 -Ref: table-numeric-ranges915930 -Ref: table-floating-point-ranges916423 -Ref: Computer Arithmetic-Footnote-1917081 -Node: Math Definitions917138 -Ref: table-ieee-formats920454 -Ref: Math Definitions-Footnote-1921057 -Node: MPFR features921162 -Node: FP Math Caution922880 -Ref: FP Math Caution-Footnote-1923952 -Node: Inexactness of computations924321 -Node: Inexact representation925281 -Node: Comparing FP Values926641 -Node: Errors accumulate927723 -Node: Getting Accuracy929156 -Node: Try To Round931866 -Node: Setting precision932765 -Ref: table-predefined-precision-strings933462 -Node: Setting the rounding mode935292 -Ref: table-gawk-rounding-modes935666 -Ref: Setting the rounding mode-Footnote-1939041 -Node: Arbitrary Precision Integers939220 -Ref: Arbitrary Precision Integers-Footnote-1942395 -Node: Checking for MPFR942544 -Node: POSIX Floating Point Problems943841 -Ref: POSIX Floating Point Problems-Footnote-1947712 -Node: Floating point summary947750 -Node: Dynamic Extensions949940 -Node: Extension Intro951493 -Node: Plugin License952759 -Node: Extension Mechanism Outline953556 -Ref: figure-load-extension953995 -Ref: figure-register-new-function955560 -Ref: figure-call-new-function956652 -Node: Extension API Description958714 -Node: Extension API Functions Introduction960356 -Node: General Data Types965896 -Ref: General Data Types-Footnote-1974257 -Node: Memory Allocation Functions974556 -Ref: Memory Allocation Functions-Footnote-1978766 -Node: Constructor Functions978865 -Node: Registration Functions982451 -Node: Extension Functions983136 -Node: Exit Callback Functions988351 -Node: Extension Version String989601 -Node: Input Parsers990264 -Node: Output Wrappers1002985 -Node: Two-way processors1007497 -Node: Printing Messages1009762 -Ref: Printing Messages-Footnote-11010933 -Node: Updating ERRNO1011086 -Node: Requesting Values1011825 -Ref: table-value-types-returned1012562 -Node: Accessing Parameters1013498 -Node: Symbol Table Access1014733 -Node: Symbol table by name1015245 -Node: Symbol table by cookie1017034 -Ref: Symbol table by cookie-Footnote-11021219 -Node: Cached values1021283 -Ref: Cached values-Footnote-11024819 -Node: Array Manipulation1024972 -Ref: Array Manipulation-Footnote-11026063 -Node: Array Data Types1026100 -Ref: Array Data Types-Footnote-11028758 -Node: Array Functions1028850 -Node: Flattening Arrays1033348 -Node: Creating Arrays1040324 -Node: Redirection API1045091 -Node: Extension API Variables1047924 -Node: Extension Versioning1048635 -Ref: gawk-api-version1049064 -Node: Extension GMP/MPFR Versioning1050795 -Node: Extension API Informational Variables1052423 -Node: Extension API Boilerplate1053496 -Node: Changes from API V11057470 -Node: Finding Extensions1059042 -Node: Extension Example1059601 -Node: Internal File Description1060399 -Node: Internal File Ops1064479 -Ref: Internal File Ops-Footnote-11075830 -Node: Using Internal File Ops1075970 -Ref: Using Internal File Ops-Footnote-11078353 -Node: Extension Samples1078627 -Node: Extension Sample File Functions1080156 -Node: Extension Sample Fnmatch1087805 -Node: Extension Sample Fork1089292 -Node: Extension Sample Inplace1090510 -Node: Extension Sample Ord1093727 -Node: Extension Sample Readdir1094563 -Ref: table-readdir-file-types1095452 -Node: Extension Sample Revout1096257 -Node: Extension Sample Rev2way1096846 -Node: Extension Sample Read write array1097586 -Node: Extension Sample Readfile1099528 -Node: Extension Sample Time1100623 -Node: Extension Sample API Tests1101971 -Node: gawkextlib1102463 -Node: Extension summary1104919 -Node: Extension Exercises1108621 -Node: Language History1110119 -Node: V7/SVR3.11111775 -Node: SVR41113927 -Node: POSIX1115361 -Node: BTL1116741 -Node: POSIX/GNU1117470 -Node: Feature History1123248 -Node: Common Extensions1139107 -Node: Ranges and Locales1140390 -Ref: Ranges and Locales-Footnote-11145006 -Ref: Ranges and Locales-Footnote-21145033 -Ref: Ranges and Locales-Footnote-31145268 -Node: Contributors1145489 -Node: History summary1151434 -Node: Installation1152814 -Node: Gawk Distribution1153758 -Node: Getting1154242 -Node: Extracting1155205 -Node: Distribution contents1156843 -Node: Unix Installation1163323 -Node: Quick Installation1164005 -Node: Shell Startup Files1166419 -Node: Additional Configuration Options1167508 -Node: Configuration Philosophy1169673 -Node: Non-Unix Installation1172042 -Node: PC Installation1172502 -Node: PC Binary Installation1173340 -Node: PC Compiling1173775 -Node: PC Using1174892 -Node: Cygwin1177937 -Node: MSYS1178707 -Node: VMS Installation1179208 -Node: VMS Compilation1179999 -Ref: VMS Compilation-Footnote-11181228 -Node: VMS Dynamic Extensions1181286 -Node: VMS Installation Details1182971 -Node: VMS Running1185224 -Node: VMS GNV1189503 -Node: VMS Old Gawk1190238 -Node: Bugs1190709 -Node: Bug address1191372 -Node: Usenet1194164 -Node: Maintainers1194941 -Node: Other Versions1196202 -Node: Installation summary1202964 -Node: Notes1204166 -Node: Compatibility Mode1205031 -Node: Additions1205813 -Node: Accessing The Source1206738 -Node: Adding Code1208175 -Node: New Ports1214394 -Node: Derived Files1218882 -Ref: Derived Files-Footnote-11224528 -Ref: Derived Files-Footnote-21224563 -Ref: Derived Files-Footnote-31225161 -Node: Future Extensions1225275 -Node: Implementation Limitations1225933 -Node: Extension Design1227116 -Node: Old Extension Problems1228270 -Ref: Old Extension Problems-Footnote-11229788 -Node: Extension New Mechanism Goals1229845 -Ref: Extension New Mechanism Goals-Footnote-11233209 -Node: Extension Other Design Decisions1233398 -Node: Extension Future Growth1235511 -Node: Old Extension Mechanism1236347 -Node: Notes summary1238110 -Node: Basic Concepts1239292 -Node: Basic High Level1239973 -Ref: figure-general-flow1240255 -Ref: figure-process-flow1240940 -Ref: Basic High Level-Footnote-11244241 -Node: Basic Data Typing1244426 -Node: Glossary1247754 -Node: Copying1279592 -Node: GNU Free Documentation License1317131 -Node: Index1342249 +Node: Acknowledgments69286 +Node: Getting Started74194 +Node: Running gawk76633 +Node: One-shot77823 +Node: Read Terminal79086 +Node: Long81079 +Node: Executable Scripts82592 +Ref: Executable Scripts-Footnote-185387 +Node: Comments85490 +Node: Quoting87974 +Node: DOS Quoting93491 +Node: Sample Data Files95547 +Node: Very Simple98142 +Node: Two Rules103044 +Node: More Complex104929 +Node: Statements/Lines107795 +Ref: Statements/Lines-Footnote-1112254 +Node: Other Features112519 +Node: When113455 +Ref: When-Footnote-1115209 +Node: Intro Summary115274 +Node: Invoking Gawk116158 +Node: Command Line117672 +Node: Options118470 +Ref: Options-Footnote-1135089 +Ref: Options-Footnote-2135320 +Node: Other Arguments135345 +Node: Naming Standard Input138292 +Node: Environment Variables139385 +Node: AWKPATH Variable139943 +Ref: AWKPATH Variable-Footnote-1143355 +Ref: AWKPATH Variable-Footnote-2143389 +Node: AWKLIBPATH Variable143650 +Node: Other Environment Variables144907 +Node: Exit Status148728 +Node: Include Files149405 +Node: Loading Shared Libraries152930 +Node: Obsolete154358 +Node: Undocumented155050 +Node: Invoking Summary155347 +Node: Regexp157007 +Node: Regexp Usage158461 +Node: Escape Sequences160498 +Node: Regexp Operators166730 +Ref: Regexp Operators-Footnote-1174146 +Ref: Regexp Operators-Footnote-2174293 +Node: Bracket Expressions174391 +Ref: table-char-classes176867 +Node: Leftmost Longest180004 +Node: Computed Regexps181307 +Node: GNU Regexp Operators184734 +Node: Case-sensitivity188413 +Ref: Case-sensitivity-Footnote-1191300 +Ref: Case-sensitivity-Footnote-2191535 +Node: Regexp Summary191643 +Node: Reading Files193109 +Node: Records195378 +Node: awk split records196111 +Node: gawk split records201042 +Ref: gawk split records-Footnote-1205582 +Node: Fields205619 +Node: Nonconstant Fields208360 +Ref: Nonconstant Fields-Footnote-1210596 +Node: Changing Fields210800 +Node: Field Separators216728 +Node: Default Field Splitting219426 +Node: Regexp Field Splitting220544 +Node: Single Character Fields223897 +Node: Command Line Field Separator224957 +Node: Full Line Fields228175 +Ref: Full Line Fields-Footnote-1229697 +Ref: Full Line Fields-Footnote-2229743 +Node: Field Splitting Summary229844 +Node: Constant Size231918 +Node: Fixed width data232650 +Node: Skipping intervening236117 +Node: Allowing trailing data236915 +Node: Fields with fixed data237952 +Node: Splitting By Content239470 +Ref: Splitting By Content-Footnote-1243120 +Node: Testing field creation243283 +Node: Multiple Line244908 +Ref: Multiple Line-Footnote-1250792 +Node: Getline250971 +Node: Plain Getline253440 +Node: Getline/Variable256081 +Node: Getline/File257232 +Node: Getline/Variable/File258620 +Ref: Getline/Variable/File-Footnote-1260225 +Node: Getline/Pipe260313 +Node: Getline/Variable/Pipe263020 +Node: Getline/Coprocess264155 +Node: Getline/Variable/Coprocess265422 +Node: Getline Notes266164 +Node: Getline Summary268961 +Ref: table-getline-variants269385 +Node: Read Timeout270133 +Ref: Read Timeout-Footnote-1274039 +Node: Retrying Input274097 +Node: Command-line directories275296 +Node: Input Summary276202 +Node: Input Exercises279374 +Node: Printing280102 +Node: Print281936 +Node: Print Examples283393 +Node: Output Separators286173 +Node: OFMT288190 +Node: Printf289546 +Node: Basic Printf290331 +Node: Control Letters291905 +Node: Format Modifiers295901 +Node: Printf Examples301916 +Node: Redirection304402 +Node: Special FD311243 +Ref: Special FD-Footnote-1314411 +Node: Special Files314485 +Node: Other Inherited Files315102 +Node: Special Network316103 +Node: Special Caveats316963 +Node: Close Files And Pipes317912 +Ref: table-close-pipe-return-values324819 +Ref: Close Files And Pipes-Footnote-1325632 +Ref: Close Files And Pipes-Footnote-2325780 +Node: Nonfatal325932 +Node: Output Summary328270 +Node: Output Exercises329492 +Node: Expressions330171 +Node: Values331359 +Node: Constants332037 +Node: Scalar Constants332728 +Ref: Scalar Constants-Footnote-1333592 +Node: Nondecimal-numbers333842 +Node: Regexp Constants336843 +Node: Using Constant Regexps337369 +Node: Standard Regexp Constants337991 +Node: Strong Regexp Constants341179 +Node: Variables344137 +Node: Using Variables344794 +Node: Assignment Options346704 +Node: Conversion348577 +Node: Strings And Numbers349101 +Ref: Strings And Numbers-Footnote-1352164 +Node: Locale influences conversions352273 +Ref: table-locale-affects355031 +Node: All Operators355649 +Node: Arithmetic Ops356278 +Node: Concatenation358784 +Ref: Concatenation-Footnote-1361631 +Node: Assignment Ops361738 +Ref: table-assign-ops366729 +Node: Increment Ops368042 +Node: Truth Values and Conditions371502 +Node: Truth Values372576 +Node: Typing and Comparison373624 +Node: Variable Typing374444 +Ref: Variable Typing-Footnote-1380907 +Ref: Variable Typing-Footnote-2380979 +Node: Comparison Operators381056 +Ref: table-relational-ops381475 +Node: POSIX String Comparison384970 +Ref: POSIX String Comparison-Footnote-1386665 +Ref: POSIX String Comparison-Footnote-2386804 +Node: Boolean Ops386888 +Ref: Boolean Ops-Footnote-1391370 +Node: Conditional Exp391462 +Node: Function Calls393198 +Node: Precedence397075 +Node: Locales400734 +Node: Expressions Summary402366 +Node: Patterns and Actions404939 +Node: Pattern Overview406059 +Node: Regexp Patterns407736 +Node: Expression Patterns408278 +Node: Ranges412059 +Node: BEGIN/END415167 +Node: Using BEGIN/END415928 +Ref: Using BEGIN/END-Footnote-1418664 +Node: I/O And BEGIN/END418770 +Node: BEGINFILE/ENDFILE421084 +Node: Empty423997 +Node: Using Shell Variables424314 +Node: Action Overview426588 +Node: Statements428913 +Node: If Statement430761 +Node: While Statement432256 +Node: Do Statement434284 +Node: For Statement435432 +Node: Switch Statement438603 +Node: Break Statement440989 +Node: Continue Statement443081 +Node: Next Statement444908 +Node: Nextfile Statement447291 +Node: Exit Statement449943 +Node: Built-in Variables452346 +Node: User-modified453479 +Node: Auto-set461246 +Ref: Auto-set-Footnote-1477579 +Ref: Auto-set-Footnote-2477785 +Node: ARGC and ARGV477841 +Node: Pattern Action Summary482054 +Node: Arrays484484 +Node: Array Basics485813 +Node: Array Intro486657 +Ref: figure-array-elements488632 +Ref: Array Intro-Footnote-1491336 +Node: Reference to Elements491464 +Node: Assigning Elements493928 +Node: Array Example494419 +Node: Scanning an Array496178 +Node: Controlling Scanning499200 +Ref: Controlling Scanning-Footnote-1504599 +Node: Numeric Array Subscripts504915 +Node: Uninitialized Subscripts507099 +Node: Delete508718 +Ref: Delete-Footnote-1511470 +Node: Multidimensional511527 +Node: Multiscanning514622 +Node: Arrays of Arrays516213 +Node: Arrays Summary520980 +Node: Functions523073 +Node: Built-in524111 +Node: Calling Built-in525192 +Node: Numeric Functions527188 +Ref: Numeric Functions-Footnote-1531216 +Ref: Numeric Functions-Footnote-2531573 +Ref: Numeric Functions-Footnote-3531621 +Node: String Functions531893 +Ref: String Functions-Footnote-1555551 +Ref: String Functions-Footnote-2555679 +Ref: String Functions-Footnote-3555927 +Node: Gory Details556014 +Ref: table-sub-escapes557805 +Ref: table-sub-proposed559324 +Ref: table-posix-sub560687 +Ref: table-gensub-escapes562228 +Ref: Gory Details-Footnote-1563051 +Node: I/O Functions563205 +Ref: table-system-return-values569673 +Ref: I/O Functions-Footnote-1571653 +Ref: I/O Functions-Footnote-2571801 +Node: Time Functions571921 +Ref: Time Functions-Footnote-1582592 +Ref: Time Functions-Footnote-2582660 +Ref: Time Functions-Footnote-3582818 +Ref: Time Functions-Footnote-4582929 +Ref: Time Functions-Footnote-5583041 +Ref: Time Functions-Footnote-6583268 +Node: Bitwise Functions583534 +Ref: table-bitwise-ops584128 +Ref: Bitwise Functions-Footnote-1590173 +Ref: Bitwise Functions-Footnote-2590346 +Node: Type Functions590537 +Node: I18N Functions593288 +Node: User-defined594939 +Node: Definition Syntax595744 +Ref: Definition Syntax-Footnote-1601431 +Node: Function Example601502 +Ref: Function Example-Footnote-1604424 +Node: Function Caveats604446 +Node: Calling A Function604964 +Node: Variable Scope605922 +Node: Pass By Value/Reference608916 +Node: Return Statement612415 +Node: Dynamic Typing615394 +Node: Indirect Calls616324 +Ref: Indirect Calls-Footnote-1626576 +Node: Functions Summary626704 +Node: Library Functions629409 +Ref: Library Functions-Footnote-1633016 +Ref: Library Functions-Footnote-2633159 +Node: Library Names633330 +Ref: Library Names-Footnote-1636790 +Ref: Library Names-Footnote-2637013 +Node: General Functions637099 +Node: Strtonum Function638202 +Node: Assert Function641224 +Node: Round Function644550 +Node: Cliff Random Function646090 +Node: Ordinal Functions647106 +Ref: Ordinal Functions-Footnote-1650169 +Ref: Ordinal Functions-Footnote-2650421 +Node: Join Function650631 +Ref: Join Function-Footnote-1652401 +Node: Getlocaltime Function652601 +Node: Readfile Function656343 +Node: Shell Quoting658320 +Node: Data File Management659721 +Node: Filetrans Function660353 +Node: Rewind Function664449 +Node: File Checking666359 +Ref: File Checking-Footnote-1667693 +Node: Empty Files667894 +Node: Ignoring Assigns669873 +Node: Getopt Function671423 +Ref: Getopt Function-Footnote-1682892 +Node: Passwd Functions683092 +Ref: Passwd Functions-Footnote-1691931 +Node: Group Functions692019 +Ref: Group Functions-Footnote-1699917 +Node: Walking Arrays700124 +Node: Library Functions Summary703132 +Node: Library Exercises704538 +Node: Sample Programs705003 +Node: Running Examples705773 +Node: Clones706501 +Node: Cut Program707725 +Node: Egrep Program717654 +Ref: Egrep Program-Footnote-1725166 +Node: Id Program725276 +Node: Split Program728956 +Ref: Split Program-Footnote-1732414 +Node: Tee Program732543 +Node: Uniq Program735333 +Node: Wc Program742759 +Ref: Wc Program-Footnote-1747014 +Node: Miscellaneous Programs747108 +Node: Dupword Program748321 +Node: Alarm Program750351 +Node: Translate Program755206 +Ref: Translate Program-Footnote-1759771 +Node: Labels Program760041 +Ref: Labels Program-Footnote-1763392 +Node: Word Sorting763476 +Node: History Sorting767548 +Node: Extract Program769383 +Node: Simple Sed776913 +Node: Igawk Program779987 +Ref: Igawk Program-Footnote-1794318 +Ref: Igawk Program-Footnote-2794520 +Ref: Igawk Program-Footnote-3794642 +Node: Anagram Program794757 +Node: Signature Program797819 +Node: Programs Summary799066 +Node: Programs Exercises800280 +Ref: Programs Exercises-Footnote-1804409 +Node: Advanced Features804500 +Node: Nondecimal Data806490 +Node: Array Sorting808081 +Node: Controlling Array Traversal808781 +Ref: Controlling Array Traversal-Footnote-1817149 +Node: Array Sorting Functions817267 +Ref: Array Sorting Functions-Footnote-1822358 +Node: Two-way I/O822554 +Ref: Two-way I/O-Footnote-1829106 +Ref: Two-way I/O-Footnote-2829293 +Node: TCP/IP Networking829375 +Node: Profiling832493 +Ref: Profiling-Footnote-1841165 +Node: Advanced Features Summary841488 +Node: Internationalization843332 +Node: I18N and L10N844812 +Node: Explaining gettext845499 +Ref: Explaining gettext-Footnote-1851391 +Ref: Explaining gettext-Footnote-2851576 +Node: Programmer i18n851741 +Ref: Programmer i18n-Footnote-1856690 +Node: Translator i18n856739 +Node: String Extraction857533 +Ref: String Extraction-Footnote-1858665 +Node: Printf Ordering858751 +Ref: Printf Ordering-Footnote-1861537 +Node: I18N Portability861601 +Ref: I18N Portability-Footnote-1864057 +Node: I18N Example864120 +Ref: I18N Example-Footnote-1866926 +Node: Gawk I18N866999 +Node: I18N Summary867644 +Node: Debugger868985 +Node: Debugging870008 +Node: Debugging Concepts870449 +Node: Debugging Terms872258 +Node: Awk Debugging874833 +Node: Sample Debugging Session875739 +Node: Debugger Invocation876273 +Node: Finding The Bug877659 +Node: List of Debugger Commands884137 +Node: Breakpoint Control885470 +Node: Debugger Execution Control889164 +Node: Viewing And Changing Data892526 +Node: Execution Stack895900 +Node: Debugger Info897537 +Node: Miscellaneous Debugger Commands901608 +Node: Readline Support906670 +Node: Limitations907566 +Node: Debugging Summary909675 +Node: Arbitrary Precision Arithmetic910954 +Node: Computer Arithmetic912439 +Ref: table-numeric-ranges916205 +Ref: table-floating-point-ranges916698 +Ref: Computer Arithmetic-Footnote-1917356 +Node: Math Definitions917413 +Ref: table-ieee-formats920729 +Ref: Math Definitions-Footnote-1921332 +Node: MPFR features921437 +Node: FP Math Caution923155 +Ref: FP Math Caution-Footnote-1924227 +Node: Inexactness of computations924596 +Node: Inexact representation925556 +Node: Comparing FP Values926916 +Node: Errors accumulate927998 +Node: Getting Accuracy929431 +Node: Try To Round932141 +Node: Setting precision933040 +Ref: table-predefined-precision-strings933737 +Node: Setting the rounding mode935567 +Ref: table-gawk-rounding-modes935941 +Ref: Setting the rounding mode-Footnote-1939316 +Node: Arbitrary Precision Integers939495 +Ref: Arbitrary Precision Integers-Footnote-1942670 +Node: Checking for MPFR942819 +Node: POSIX Floating Point Problems944116 +Ref: POSIX Floating Point Problems-Footnote-1947987 +Node: Floating point summary948025 +Node: Dynamic Extensions950215 +Node: Extension Intro951768 +Node: Plugin License953034 +Node: Extension Mechanism Outline953831 +Ref: figure-load-extension954270 +Ref: figure-register-new-function955835 +Ref: figure-call-new-function956927 +Node: Extension API Description958989 +Node: Extension API Functions Introduction960631 +Node: General Data Types966171 +Ref: General Data Types-Footnote-1974532 +Node: Memory Allocation Functions974831 +Ref: Memory Allocation Functions-Footnote-1979041 +Node: Constructor Functions979140 +Node: Registration Functions982726 +Node: Extension Functions983411 +Node: Exit Callback Functions988626 +Node: Extension Version String989876 +Node: Input Parsers990539 +Node: Output Wrappers1003260 +Node: Two-way processors1007772 +Node: Printing Messages1010037 +Ref: Printing Messages-Footnote-11011208 +Node: Updating ERRNO1011361 +Node: Requesting Values1012100 +Ref: table-value-types-returned1012837 +Node: Accessing Parameters1013773 +Node: Symbol Table Access1015008 +Node: Symbol table by name1015520 +Node: Symbol table by cookie1017309 +Ref: Symbol table by cookie-Footnote-11021494 +Node: Cached values1021558 +Ref: Cached values-Footnote-11025094 +Node: Array Manipulation1025247 +Ref: Array Manipulation-Footnote-11026338 +Node: Array Data Types1026375 +Ref: Array Data Types-Footnote-11029033 +Node: Array Functions1029125 +Node: Flattening Arrays1033623 +Node: Creating Arrays1040599 +Node: Redirection API1045366 +Node: Extension API Variables1048199 +Node: Extension Versioning1048910 +Ref: gawk-api-version1049339 +Node: Extension GMP/MPFR Versioning1051070 +Node: Extension API Informational Variables1052698 +Node: Extension API Boilerplate1053771 +Node: Changes from API V11057745 +Node: Finding Extensions1059317 +Node: Extension Example1059876 +Node: Internal File Description1060674 +Node: Internal File Ops1064754 +Ref: Internal File Ops-Footnote-11076105 +Node: Using Internal File Ops1076245 +Ref: Using Internal File Ops-Footnote-11078628 +Node: Extension Samples1078902 +Node: Extension Sample File Functions1080431 +Node: Extension Sample Fnmatch1088080 +Node: Extension Sample Fork1089567 +Node: Extension Sample Inplace1090785 +Node: Extension Sample Ord1094002 +Node: Extension Sample Readdir1094838 +Ref: table-readdir-file-types1095727 +Node: Extension Sample Revout1096532 +Node: Extension Sample Rev2way1097121 +Node: Extension Sample Read write array1097861 +Node: Extension Sample Readfile1099803 +Node: Extension Sample Time1100898 +Node: Extension Sample API Tests1102246 +Node: gawkextlib1102738 +Node: Extension summary1105194 +Node: Extension Exercises1108896 +Node: Language History1110394 +Node: V7/SVR3.11112050 +Node: SVR41114202 +Node: POSIX1115636 +Node: BTL1117016 +Node: POSIX/GNU1117745 +Node: Feature History1123523 +Node: Common Extensions1139382 +Node: Ranges and Locales1140665 +Ref: Ranges and Locales-Footnote-11145281 +Ref: Ranges and Locales-Footnote-21145308 +Ref: Ranges and Locales-Footnote-31145543 +Node: Contributors1145764 +Node: History summary1151709 +Node: Installation1153089 +Node: Gawk Distribution1154033 +Node: Getting1154517 +Node: Extracting1155480 +Node: Distribution contents1157118 +Node: Unix Installation1163598 +Node: Quick Installation1164280 +Node: Shell Startup Files1166694 +Node: Additional Configuration Options1167783 +Node: Configuration Philosophy1169948 +Node: Non-Unix Installation1172317 +Node: PC Installation1172777 +Node: PC Binary Installation1173615 +Node: PC Compiling1174050 +Node: PC Using1175167 +Node: Cygwin1178212 +Node: MSYS1178982 +Node: VMS Installation1179483 +Node: VMS Compilation1180274 +Ref: VMS Compilation-Footnote-11181503 +Node: VMS Dynamic Extensions1181561 +Node: VMS Installation Details1183246 +Node: VMS Running1185499 +Node: VMS GNV1189778 +Node: VMS Old Gawk1190513 +Node: Bugs1190984 +Node: Bug address1191647 +Node: Usenet1194439 +Node: Maintainers1195216 +Node: Other Versions1196477 +Node: Installation summary1203239 +Node: Notes1204441 +Node: Compatibility Mode1205306 +Node: Additions1206088 +Node: Accessing The Source1207013 +Node: Adding Code1208450 +Node: New Ports1214669 +Node: Derived Files1219157 +Ref: Derived Files-Footnote-11224803 +Ref: Derived Files-Footnote-21224838 +Ref: Derived Files-Footnote-31225436 +Node: Future Extensions1225550 +Node: Implementation Limitations1226208 +Node: Extension Design1227391 +Node: Old Extension Problems1228545 +Ref: Old Extension Problems-Footnote-11230063 +Node: Extension New Mechanism Goals1230120 +Ref: Extension New Mechanism Goals-Footnote-11233484 +Node: Extension Other Design Decisions1233673 +Node: Extension Future Growth1235786 +Node: Old Extension Mechanism1236622 +Node: Notes summary1238385 +Node: Basic Concepts1239567 +Node: Basic High Level1240248 +Ref: figure-general-flow1240530 +Ref: figure-process-flow1241215 +Ref: Basic High Level-Footnote-11244516 +Node: Basic Data Typing1244701 +Node: Glossary1248029 +Node: Copying1279867 +Node: GNU Free Documentation License1317406 +Node: Index1342524 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index bca4eb39..ba042aae 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -2079,35 +2079,16 @@ helps keep the @command{gawk} distribution down to manageable size. The initial collection of material, such as it is, is still available at @uref{ftp://ftp.freefriends.org/arnold/Awkstuff}. -If you are @emph{seriously} interested in helping set up a website -for @command{awk}-language related things, please contact me. +In the hopes of doing something more broad, I acquired the +@code{awklang.org} domain. Late in 2017, a volunteer took on the task +of managing it. -@ignore -In the hopes of -doing something more broad, I acquired the @code{awk.info} domain. - -However, I found that I could not dedicate enough time to managing -contributed code: the archive did not grow and the domain went unused -for several years. - -Late in 2008, a volunteer took on the task of setting up -an @command{awk}-related website---@uref{http://awk.info}---and did a very -nice job. +If you have written an interesting @command{awk} program, that +you would like to share with the rest of the world, please see +@uref{http://www.awklang.org} and use the ``Contact'' link. -If you have written an interesting @command{awk} program, or have written -a @command{gawk} extension that you would like to share with the rest -of the world, please see @uref{http://awk.info/?contribute} for how to -contribute it to the website. - -As of this writing, this website is in search of a maintainer; please -contact me if you are interested. -@end ignore - -@ignore -Other links: - -https://www.reddit.com/r/linux/comments/dtect/composing_music_in_awk/ -@end ignore +If you have written a @command{gawk} extension, please see +@ref{gawkextlib}. @end ifclear @node Acknowledgments diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 8ec07642..dab833d4 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -2046,35 +2046,16 @@ helps keep the @command{gawk} distribution down to manageable size. The initial collection of material, such as it is, is still available at @uref{ftp://ftp.freefriends.org/arnold/Awkstuff}. -If you are @emph{seriously} interested in helping set up a website -for @command{awk}-language related things, please contact me. +In the hopes of doing something more broad, I acquired the +@code{awklang.org} domain. Late in 2017, a volunteer took on the task +of managing it. -@ignore -In the hopes of -doing something more broad, I acquired the @code{awk.info} domain. - -However, I found that I could not dedicate enough time to managing -contributed code: the archive did not grow and the domain went unused -for several years. - -Late in 2008, a volunteer took on the task of setting up -an @command{awk}-related website---@uref{http://awk.info}---and did a very -nice job. +If you have written an interesting @command{awk} program, that +you would like to share with the rest of the world, please see +@uref{http://www.awklang.org} and use the ``Contact'' link. -If you have written an interesting @command{awk} program, or have written -a @command{gawk} extension that you would like to share with the rest -of the world, please see @uref{http://awk.info/?contribute} for how to -contribute it to the website. - -As of this writing, this website is in search of a maintainer; please -contact me if you are interested. -@end ignore - -@ignore -Other links: - -https://www.reddit.com/r/linux/comments/dtect/composing_music_in_awk/ -@end ignore +If you have written a @command{gawk} extension, please see +@ref{gawkextlib}. @end ifclear @node Acknowledgments |