diff options
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 1053 | ||||
| -rw-r--r-- | doc/gawk.texi | 5 | ||||
| -rw-r--r-- | doc/gawktexi.in | 5 |
4 files changed, 534 insertions, 533 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 887a0d48..3e692a17 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2017-10-08 Andrew J. Schorr <aschorr@telemetry-investments.com> + + * gawktexi.in: Fix discussion of AWKPATH in section on @include. + 2017-10-04 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Update the update month to October. diff --git a/doc/gawk.info b/doc/gawk.info index 8c8e96d9..2393096e 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -3241,9 +3241,8 @@ reducing the need for writing complex and tedious command lines. In particular, '@include' is very useful for writing CGI scripts to be run from web pages. - As mentioned in *note AWKPATH Variable::, the current directory is -always searched first for source files, before searching in 'AWKPATH'; -this also applies to files named with '@include'. + The rules for finding a source file described in *note AWKPATH +Variable:: also apply to files loaded with '@include'. File: gawk.info, Node: Loading Shared Libraries, Next: Obsolete, Prev: Include Files, Up: Invoking Gawk @@ -35939,529 +35938,529 @@ Node: AWKLIBPATH Variable143375 Node: Other Environment Variables144632 Node: Exit Status148453 Node: Include Files149130 -Node: Loading Shared Libraries152725 -Node: Obsolete154153 -Node: Undocumented154845 -Node: Invoking Summary155142 -Node: Regexp156802 -Node: Regexp Usage158256 -Node: Escape Sequences160293 -Node: Regexp Operators166525 -Ref: Regexp Operators-Footnote-1173941 -Ref: Regexp Operators-Footnote-2174088 -Node: Bracket Expressions174186 -Ref: table-char-classes176662 -Node: Leftmost Longest179799 -Node: Computed Regexps181102 -Node: GNU Regexp Operators184529 -Node: Case-sensitivity188208 -Ref: Case-sensitivity-Footnote-1191095 -Ref: Case-sensitivity-Footnote-2191330 -Node: Regexp Summary191438 -Node: Reading Files192904 -Node: Records195173 -Node: awk split records195906 -Node: gawk split records200837 -Ref: gawk split records-Footnote-1205377 -Node: Fields205414 -Node: Nonconstant Fields208155 -Ref: Nonconstant Fields-Footnote-1210391 -Node: Changing Fields210595 -Node: Field Separators216523 -Node: Default Field Splitting219221 -Node: Regexp Field Splitting220339 -Node: Single Character Fields223692 -Node: Command Line Field Separator224752 -Node: Full Line Fields227970 -Ref: Full Line Fields-Footnote-1229492 -Ref: Full Line Fields-Footnote-2229538 -Node: Field Splitting Summary229639 -Node: Constant Size231713 -Node: Fixed width data232445 -Node: Skipping intervening235912 -Node: Allowing trailing data236710 -Node: Fields with fixed data237747 -Node: Splitting By Content239265 -Ref: Splitting By Content-Footnote-1242915 -Node: Testing field creation243078 -Node: Multiple Line244703 -Ref: Multiple Line-Footnote-1250587 -Node: Getline250766 -Node: Plain Getline253235 -Node: Getline/Variable255876 -Node: Getline/File257027 -Node: Getline/Variable/File258415 -Ref: Getline/Variable/File-Footnote-1260020 -Node: Getline/Pipe260108 -Node: Getline/Variable/Pipe262815 -Node: Getline/Coprocess263950 -Node: Getline/Variable/Coprocess265217 -Node: Getline Notes265959 -Node: Getline Summary268756 -Ref: table-getline-variants269180 -Node: Read Timeout269928 -Ref: Read Timeout-Footnote-1273834 -Node: Retrying Input273892 -Node: Command-line directories275091 -Node: Input Summary275997 -Node: Input Exercises279169 -Node: Printing279897 -Node: Print281731 -Node: Print Examples283188 -Node: Output Separators285968 -Node: OFMT287985 -Node: Printf289341 -Node: Basic Printf290126 -Node: Control Letters291700 -Node: Format Modifiers295688 -Node: Printf Examples301703 -Node: Redirection304189 -Node: Special FD311030 -Ref: Special FD-Footnote-1314198 -Node: Special Files314272 -Node: Other Inherited Files314889 -Node: Special Network315890 -Node: Special Caveats316750 -Node: Close Files And Pipes317699 -Ref: table-close-pipe-return-values324606 -Ref: Close Files And Pipes-Footnote-1325389 -Ref: Close Files And Pipes-Footnote-2325537 -Node: Nonfatal325689 -Node: Output Summary328014 -Node: Output Exercises329236 -Node: Expressions329915 -Node: Values331103 -Node: Constants331781 -Node: Scalar Constants332472 -Ref: Scalar Constants-Footnote-1333336 -Node: Nondecimal-numbers333586 -Node: Regexp Constants336587 -Node: Using Constant Regexps337113 -Node: Standard Regexp Constants337735 -Node: Strong Regexp Constants340923 -Node: Variables343881 -Node: Using Variables344538 -Node: Assignment Options346448 -Node: Conversion348321 -Node: Strings And Numbers348845 -Ref: Strings And Numbers-Footnote-1351908 -Node: Locale influences conversions352017 -Ref: table-locale-affects354775 -Node: All Operators355393 -Node: Arithmetic Ops356022 -Node: Concatenation358528 -Ref: Concatenation-Footnote-1361375 -Node: Assignment Ops361482 -Ref: table-assign-ops366473 -Node: Increment Ops367786 -Node: Truth Values and Conditions371246 -Node: Truth Values372320 -Node: Typing and Comparison373368 -Node: Variable Typing374188 -Ref: Variable Typing-Footnote-1380651 -Ref: Variable Typing-Footnote-2380723 -Node: Comparison Operators380800 -Ref: table-relational-ops381219 -Node: POSIX String Comparison384714 -Ref: POSIX String Comparison-Footnote-1386409 -Ref: POSIX String Comparison-Footnote-2386548 -Node: Boolean Ops386632 -Ref: Boolean Ops-Footnote-1391114 -Node: Conditional Exp391206 -Node: Function Calls392942 -Node: Precedence396819 -Node: Locales400478 -Node: Expressions Summary402110 -Node: Patterns and Actions404683 -Node: Pattern Overview405803 -Node: Regexp Patterns407480 -Node: Expression Patterns408022 -Node: Ranges411803 -Node: BEGIN/END414911 -Node: Using BEGIN/END415672 -Ref: Using BEGIN/END-Footnote-1418408 -Node: I/O And BEGIN/END418514 -Node: BEGINFILE/ENDFILE420828 -Node: Empty423741 -Node: Using Shell Variables424058 -Node: Action Overview426332 -Node: Statements428657 -Node: If Statement430505 -Node: While Statement432000 -Node: Do Statement434028 -Node: For Statement435176 -Node: Switch Statement438334 -Node: Break Statement440720 -Node: Continue Statement442812 -Node: Next Statement444639 -Node: Nextfile Statement447022 -Node: Exit Statement449674 -Node: Built-in Variables452077 -Node: User-modified453210 -Node: Auto-set460977 -Ref: Auto-set-Footnote-1477310 -Ref: Auto-set-Footnote-2477516 -Node: ARGC and ARGV477572 -Node: Pattern Action Summary481785 -Node: Arrays484215 -Node: Array Basics485544 -Node: Array Intro486388 -Ref: figure-array-elements488363 -Ref: Array Intro-Footnote-1491067 -Node: Reference to Elements491195 -Node: Assigning Elements493659 -Node: Array Example494150 -Node: Scanning an Array495909 -Node: Controlling Scanning498931 -Ref: Controlling Scanning-Footnote-1504330 -Node: Numeric Array Subscripts504646 -Node: Uninitialized Subscripts506830 -Node: Delete508449 -Ref: Delete-Footnote-1511201 -Node: Multidimensional511258 -Node: Multiscanning514353 -Node: Arrays of Arrays515944 -Node: Arrays Summary520711 -Node: Functions522804 -Node: Built-in523842 -Node: Calling Built-in524923 -Node: Numeric Functions526919 -Ref: Numeric Functions-Footnote-1530947 -Ref: Numeric Functions-Footnote-2531304 -Ref: Numeric Functions-Footnote-3531352 -Node: String Functions531624 -Ref: String Functions-Footnote-1555282 -Ref: String Functions-Footnote-2555410 -Ref: String Functions-Footnote-3555658 -Node: Gory Details555745 -Ref: table-sub-escapes557536 -Ref: table-sub-proposed559055 -Ref: table-posix-sub560418 -Ref: table-gensub-escapes561959 -Ref: Gory Details-Footnote-1562782 -Node: I/O Functions562936 -Ref: table-system-return-values569518 -Ref: I/O Functions-Footnote-1571498 -Ref: I/O Functions-Footnote-2571646 -Node: Time Functions571766 -Ref: Time Functions-Footnote-1582437 -Ref: Time Functions-Footnote-2582505 -Ref: Time Functions-Footnote-3582663 -Ref: Time Functions-Footnote-4582774 -Ref: Time Functions-Footnote-5582886 -Ref: Time Functions-Footnote-6583113 -Node: Bitwise Functions583379 -Ref: table-bitwise-ops583973 -Ref: Bitwise Functions-Footnote-1590006 -Ref: Bitwise Functions-Footnote-2590179 -Node: Type Functions590370 -Node: I18N Functions593287 -Node: User-defined594938 -Node: Definition Syntax595743 -Ref: Definition Syntax-Footnote-1601430 -Node: Function Example601501 -Ref: Function Example-Footnote-1604423 -Node: Function Caveats604445 -Node: Calling A Function604963 -Node: Variable Scope605921 -Node: Pass By Value/Reference608915 -Node: Return Statement612414 -Node: Dynamic Typing615393 -Node: Indirect Calls616323 -Ref: Indirect Calls-Footnote-1626575 -Node: Functions Summary626703 -Node: Library Functions629408 -Ref: Library Functions-Footnote-1633015 -Ref: Library Functions-Footnote-2633158 -Node: Library Names633329 -Ref: Library Names-Footnote-1636789 -Ref: Library Names-Footnote-2637012 -Node: General Functions637098 -Node: Strtonum Function638201 -Node: Assert Function641223 -Node: Round Function644549 -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 Quoting658315 -Node: Data File Management659716 -Node: Filetrans Function660348 -Node: Rewind Function664444 -Node: File Checking666354 -Ref: File Checking-Footnote-1667688 -Node: Empty Files667889 -Node: Ignoring Assigns669868 -Node: Getopt Function671418 -Ref: Getopt Function-Footnote-1682887 -Node: Passwd Functions683087 -Ref: Passwd Functions-Footnote-1691926 -Node: Group Functions692014 -Ref: Group Functions-Footnote-1699912 -Node: Walking Arrays700119 -Node: Library Functions Summary703127 -Node: Library Exercises704533 -Node: Sample Programs704998 -Node: Running Examples705768 -Node: Clones706496 -Node: Cut Program707720 -Node: Egrep Program717649 -Ref: Egrep Program-Footnote-1725161 -Node: Id Program725271 -Node: Split Program728951 -Ref: Split Program-Footnote-1732410 -Node: Tee Program732539 -Node: Uniq Program735329 -Node: Wc Program742755 -Ref: Wc Program-Footnote-1747010 -Node: Miscellaneous Programs747104 -Node: Dupword Program748317 -Node: Alarm Program750347 -Node: Translate Program755202 -Ref: Translate Program-Footnote-1759767 -Node: Labels Program760037 -Ref: Labels Program-Footnote-1763388 -Node: Word Sorting763472 -Node: History Sorting767544 -Node: Extract Program769379 -Node: Simple Sed776909 -Node: Igawk Program779983 -Ref: Igawk Program-Footnote-1794314 -Ref: Igawk Program-Footnote-2794516 -Ref: Igawk Program-Footnote-3794638 -Node: Anagram Program794753 -Node: Signature Program797815 -Node: Programs Summary799062 -Node: Programs Exercises800276 -Ref: Programs Exercises-Footnote-1804405 -Node: Advanced Features804496 -Node: Nondecimal Data806486 -Node: Array Sorting808077 -Node: Controlling Array Traversal808777 -Ref: Controlling Array Traversal-Footnote-1817144 -Node: Array Sorting Functions817262 -Ref: Array Sorting Functions-Footnote-1822353 -Node: Two-way I/O822549 -Ref: Two-way I/O-Footnote-1829101 -Ref: Two-way I/O-Footnote-2829288 -Node: TCP/IP Networking829370 -Node: Profiling832488 -Ref: Profiling-Footnote-1841160 -Node: Advanced Features Summary841483 -Node: Internationalization843327 -Node: I18N and L10N844807 -Node: Explaining gettext845494 -Ref: Explaining gettext-Footnote-1851386 -Ref: Explaining gettext-Footnote-2851571 -Node: Programmer i18n851736 -Ref: Programmer i18n-Footnote-1856685 -Node: Translator i18n856734 -Node: String Extraction857528 -Ref: String Extraction-Footnote-1858660 -Node: Printf Ordering858746 -Ref: Printf Ordering-Footnote-1861532 -Node: I18N Portability861596 -Ref: I18N Portability-Footnote-1864052 -Node: I18N Example864115 -Ref: I18N Example-Footnote-1866921 -Node: Gawk I18N866994 -Node: I18N Summary867639 -Node: Debugger868980 -Node: Debugging870003 -Node: Debugging Concepts870444 -Node: Debugging Terms872253 -Node: Awk Debugging874828 -Node: Sample Debugging Session875734 -Node: Debugger Invocation876268 -Node: Finding The Bug877654 -Node: List of Debugger Commands884132 -Node: Breakpoint Control885465 -Node: Debugger Execution Control889159 -Node: Viewing And Changing Data892521 -Node: Execution Stack895895 -Node: Debugger Info897532 -Node: Miscellaneous Debugger Commands901603 -Node: Readline Support906691 -Node: Limitations907587 -Node: Debugging Summary909696 -Node: Arbitrary Precision Arithmetic910975 -Node: Computer Arithmetic912460 -Ref: table-numeric-ranges916051 -Ref: Computer Arithmetic-Footnote-1916773 -Node: Math Definitions916830 -Ref: table-ieee-formats920146 -Ref: Math Definitions-Footnote-1920749 -Node: MPFR features920854 -Node: FP Math Caution922572 -Ref: FP Math Caution-Footnote-1923644 -Node: Inexactness of computations924013 -Node: Inexact representation924973 -Node: Comparing FP Values926333 -Node: Errors accumulate927415 -Node: Getting Accuracy928848 -Node: Try To Round931558 -Node: Setting precision932457 -Ref: table-predefined-precision-strings933154 -Node: Setting the rounding mode934984 -Ref: table-gawk-rounding-modes935358 -Ref: Setting the rounding mode-Footnote-1938766 -Node: Arbitrary Precision Integers938945 -Ref: Arbitrary Precision Integers-Footnote-1942120 -Node: Checking for MPFR942269 -Node: POSIX Floating Point Problems943566 -Ref: POSIX Floating Point Problems-Footnote-1947437 -Node: Floating point summary947475 -Node: Dynamic Extensions949665 -Node: Extension Intro951218 -Node: Plugin License952484 -Node: Extension Mechanism Outline953281 -Ref: figure-load-extension953720 -Ref: figure-register-new-function955285 -Ref: figure-call-new-function956377 -Node: Extension API Description958439 -Node: Extension API Functions Introduction960081 -Node: General Data Types965621 -Ref: General Data Types-Footnote-1973742 -Node: Memory Allocation Functions974041 -Ref: Memory Allocation Functions-Footnote-1978249 -Node: Constructor Functions978348 -Node: Registration Functions981934 -Node: Extension Functions982619 -Node: Exit Callback Functions987834 -Node: Extension Version String989084 -Node: Input Parsers989747 -Node: Output Wrappers1002468 -Node: Two-way processors1006980 -Node: Printing Messages1009245 -Ref: Printing Messages-Footnote-11010416 -Node: Updating ERRNO1010569 -Node: Requesting Values1011308 -Ref: table-value-types-returned1012045 -Node: Accessing Parameters1012981 -Node: Symbol Table Access1014216 -Node: Symbol table by name1014728 -Node: Symbol table by cookie1016517 -Ref: Symbol table by cookie-Footnote-11020702 -Node: Cached values1020766 -Ref: Cached values-Footnote-11024302 -Node: Array Manipulation1024455 -Ref: Array Manipulation-Footnote-11025546 -Node: Array Data Types1025583 -Ref: Array Data Types-Footnote-11028241 -Node: Array Functions1028333 -Node: Flattening Arrays1032831 -Node: Creating Arrays1039807 -Node: Redirection API1044576 -Node: Extension API Variables1047409 -Node: Extension Versioning1048120 -Ref: gawk-api-version1048549 -Node: Extension GMP/MPFR Versioning1050277 -Node: Extension API Informational Variables1051905 -Node: Extension API Boilerplate1052978 -Node: Changes from API V11056952 -Node: Finding Extensions1057612 -Node: Extension Example1058171 -Node: Internal File Description1058969 -Node: Internal File Ops1063049 -Ref: Internal File Ops-Footnote-11074449 -Node: Using Internal File Ops1074589 -Ref: Using Internal File Ops-Footnote-11076972 -Node: Extension Samples1077246 -Node: Extension Sample File Functions1078775 -Node: Extension Sample Fnmatch1086424 -Node: Extension Sample Fork1087911 -Node: Extension Sample Inplace1089129 -Node: Extension Sample Ord1092346 -Node: Extension Sample Readdir1093182 -Ref: table-readdir-file-types1094071 -Node: Extension Sample Revout1094876 -Node: Extension Sample Rev2way1095465 -Node: Extension Sample Read write array1096205 -Node: Extension Sample Readfile1098147 -Node: Extension Sample Time1099242 -Node: Extension Sample API Tests1100590 -Node: gawkextlib1101082 -Node: Extension summary1103538 -Node: Extension Exercises1107240 -Node: Language History1108738 -Node: V7/SVR3.11110394 -Node: SVR41112546 -Node: POSIX1113980 -Node: BTL1115360 -Node: POSIX/GNU1116089 -Node: Feature History1121867 -Node: Common Extensions1137726 -Node: Ranges and Locales1139009 -Ref: Ranges and Locales-Footnote-11143625 -Ref: Ranges and Locales-Footnote-21143652 -Ref: Ranges and Locales-Footnote-31143887 -Node: Contributors1144108 -Node: History summary1150053 -Node: Installation1151433 -Node: Gawk Distribution1152377 -Node: Getting1152861 -Node: Extracting1153824 -Node: Distribution contents1155462 -Node: Unix Installation1161942 -Node: Quick Installation1162624 -Node: Shell Startup Files1165038 -Node: Additional Configuration Options1166127 -Node: Configuration Philosophy1168116 -Node: Non-Unix Installation1170485 -Node: PC Installation1170945 -Node: PC Binary Installation1171783 -Node: PC Compiling1172218 -Node: PC Using1173335 -Node: Cygwin1176380 -Node: MSYS1177150 -Node: VMS Installation1177651 -Node: VMS Compilation1178442 -Ref: VMS Compilation-Footnote-11179671 -Node: VMS Dynamic Extensions1179729 -Node: VMS Installation Details1181414 -Node: VMS Running1183667 -Node: VMS GNV1187946 -Node: VMS Old Gawk1188681 -Node: Bugs1189152 -Node: Bug address1189815 -Node: Usenet1192607 -Node: Maintainers1193384 -Node: Other Versions1194645 -Node: Installation summary1201440 -Node: Notes1202642 -Node: Compatibility Mode1203507 -Node: Additions1204289 -Node: Accessing The Source1205214 -Node: Adding Code1206651 -Node: New Ports1212870 -Node: Derived Files1217358 -Ref: Derived Files-Footnote-11223004 -Ref: Derived Files-Footnote-21223039 -Ref: Derived Files-Footnote-31223637 -Node: Future Extensions1223751 -Node: Implementation Limitations1224409 -Node: Extension Design1225592 -Node: Old Extension Problems1226746 -Ref: Old Extension Problems-Footnote-11228264 -Node: Extension New Mechanism Goals1228321 -Ref: Extension New Mechanism Goals-Footnote-11231685 -Node: Extension Other Design Decisions1231874 -Node: Extension Future Growth1233987 -Node: Old Extension Mechanism1234823 -Node: Notes summary1236586 -Node: Basic Concepts1237768 -Node: Basic High Level1238449 -Ref: figure-general-flow1238731 -Ref: figure-process-flow1239416 -Ref: Basic High Level-Footnote-11242717 -Node: Basic Data Typing1242902 -Node: Glossary1246230 -Node: Copying1278180 -Node: GNU Free Documentation License1315719 -Node: Index1340837 +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 Modifiers295618 +Node: Printf Examples301633 +Node: Redirection304119 +Node: Special FD310960 +Ref: Special FD-Footnote-1314128 +Node: Special Files314202 +Node: Other Inherited Files314819 +Node: Special Network315820 +Node: Special Caveats316680 +Node: Close Files And Pipes317629 +Ref: table-close-pipe-return-values324536 +Ref: Close Files And Pipes-Footnote-1325319 +Ref: Close Files And Pipes-Footnote-2325467 +Node: Nonfatal325619 +Node: Output Summary327944 +Node: Output Exercises329166 +Node: Expressions329845 +Node: Values331033 +Node: Constants331711 +Node: Scalar Constants332402 +Ref: Scalar Constants-Footnote-1333266 +Node: Nondecimal-numbers333516 +Node: Regexp Constants336517 +Node: Using Constant Regexps337043 +Node: Standard Regexp Constants337665 +Node: Strong Regexp Constants340853 +Node: Variables343811 +Node: Using Variables344468 +Node: Assignment Options346378 +Node: Conversion348251 +Node: Strings And Numbers348775 +Ref: Strings And Numbers-Footnote-1351838 +Node: Locale influences conversions351947 +Ref: table-locale-affects354705 +Node: All Operators355323 +Node: Arithmetic Ops355952 +Node: Concatenation358458 +Ref: Concatenation-Footnote-1361305 +Node: Assignment Ops361412 +Ref: table-assign-ops366403 +Node: Increment Ops367716 +Node: Truth Values and Conditions371176 +Node: Truth Values372250 +Node: Typing and Comparison373298 +Node: Variable Typing374118 +Ref: Variable Typing-Footnote-1380581 +Ref: Variable Typing-Footnote-2380653 +Node: Comparison Operators380730 +Ref: table-relational-ops381149 +Node: POSIX String Comparison384644 +Ref: POSIX String Comparison-Footnote-1386339 +Ref: POSIX String Comparison-Footnote-2386478 +Node: Boolean Ops386562 +Ref: Boolean Ops-Footnote-1391044 +Node: Conditional Exp391136 +Node: Function Calls392872 +Node: Precedence396749 +Node: Locales400408 +Node: Expressions Summary402040 +Node: Patterns and Actions404613 +Node: Pattern Overview405733 +Node: Regexp Patterns407410 +Node: Expression Patterns407952 +Node: Ranges411733 +Node: BEGIN/END414841 +Node: Using BEGIN/END415602 +Ref: Using BEGIN/END-Footnote-1418338 +Node: I/O And BEGIN/END418444 +Node: BEGINFILE/ENDFILE420758 +Node: Empty423671 +Node: Using Shell Variables423988 +Node: Action Overview426262 +Node: Statements428587 +Node: If Statement430435 +Node: While Statement431930 +Node: Do Statement433958 +Node: For Statement435106 +Node: Switch Statement438264 +Node: Break Statement440650 +Node: Continue Statement442742 +Node: Next Statement444569 +Node: Nextfile Statement446952 +Node: Exit Statement449604 +Node: Built-in Variables452007 +Node: User-modified453140 +Node: Auto-set460907 +Ref: Auto-set-Footnote-1477240 +Ref: Auto-set-Footnote-2477446 +Node: ARGC and ARGV477502 +Node: Pattern Action Summary481715 +Node: Arrays484145 +Node: Array Basics485474 +Node: Array Intro486318 +Ref: figure-array-elements488293 +Ref: Array Intro-Footnote-1490997 +Node: Reference to Elements491125 +Node: Assigning Elements493589 +Node: Array Example494080 +Node: Scanning an Array495839 +Node: Controlling Scanning498861 +Ref: Controlling Scanning-Footnote-1504260 +Node: Numeric Array Subscripts504576 +Node: Uninitialized Subscripts506760 +Node: Delete508379 +Ref: Delete-Footnote-1511131 +Node: Multidimensional511188 +Node: Multiscanning514283 +Node: Arrays of Arrays515874 +Node: Arrays Summary520641 +Node: Functions522734 +Node: Built-in523772 +Node: Calling Built-in524853 +Node: Numeric Functions526849 +Ref: Numeric Functions-Footnote-1530877 +Ref: Numeric Functions-Footnote-2531234 +Ref: Numeric Functions-Footnote-3531282 +Node: String Functions531554 +Ref: String Functions-Footnote-1555212 +Ref: String Functions-Footnote-2555340 +Ref: String Functions-Footnote-3555588 +Node: Gory Details555675 +Ref: table-sub-escapes557466 +Ref: table-sub-proposed558985 +Ref: table-posix-sub560348 +Ref: table-gensub-escapes561889 +Ref: Gory Details-Footnote-1562712 +Node: I/O Functions562866 +Ref: table-system-return-values569448 +Ref: I/O Functions-Footnote-1571428 +Ref: I/O Functions-Footnote-2571576 +Node: Time Functions571696 +Ref: Time Functions-Footnote-1582367 +Ref: Time Functions-Footnote-2582435 +Ref: Time Functions-Footnote-3582593 +Ref: Time Functions-Footnote-4582704 +Ref: Time Functions-Footnote-5582816 +Ref: Time Functions-Footnote-6583043 +Node: Bitwise Functions583309 +Ref: table-bitwise-ops583903 +Ref: Bitwise Functions-Footnote-1589936 +Ref: Bitwise Functions-Footnote-2590109 +Node: Type Functions590300 +Node: I18N Functions593217 +Node: User-defined594868 +Node: Definition Syntax595673 +Ref: Definition Syntax-Footnote-1601360 +Node: Function Example601431 +Ref: Function Example-Footnote-1604353 +Node: Function Caveats604375 +Node: Calling A Function604893 +Node: Variable Scope605851 +Node: Pass By Value/Reference608845 +Node: Return Statement612344 +Node: Dynamic Typing615323 +Node: Indirect Calls616253 +Ref: Indirect Calls-Footnote-1626505 +Node: Functions Summary626633 +Node: Library Functions629338 +Ref: Library Functions-Footnote-1632945 +Ref: Library Functions-Footnote-2633088 +Node: Library Names633259 +Ref: Library Names-Footnote-1636719 +Ref: Library Names-Footnote-2636942 +Node: General Functions637028 +Node: Strtonum Function638131 +Node: Assert Function641153 +Node: Round Function644479 +Node: Cliff Random Function646020 +Node: Ordinal Functions647036 +Ref: Ordinal Functions-Footnote-1650099 +Ref: Ordinal Functions-Footnote-2650351 +Node: Join Function650561 +Ref: Join Function-Footnote-1652331 +Node: Getlocaltime Function652531 +Node: Readfile Function656273 +Node: Shell Quoting658245 +Node: Data File Management659646 +Node: Filetrans Function660278 +Node: Rewind Function664374 +Node: File Checking666284 +Ref: File Checking-Footnote-1667618 +Node: Empty Files667819 +Node: Ignoring Assigns669798 +Node: Getopt Function671348 +Ref: Getopt Function-Footnote-1682817 +Node: Passwd Functions683017 +Ref: Passwd Functions-Footnote-1691856 +Node: Group Functions691944 +Ref: Group Functions-Footnote-1699842 +Node: Walking Arrays700049 +Node: Library Functions Summary703057 +Node: Library Exercises704463 +Node: Sample Programs704928 +Node: Running Examples705698 +Node: Clones706426 +Node: Cut Program707650 +Node: Egrep Program717579 +Ref: Egrep Program-Footnote-1725091 +Node: Id Program725201 +Node: Split Program728881 +Ref: Split Program-Footnote-1732340 +Node: Tee Program732469 +Node: Uniq Program735259 +Node: Wc Program742685 +Ref: Wc Program-Footnote-1746940 +Node: Miscellaneous Programs747034 +Node: Dupword Program748247 +Node: Alarm Program750277 +Node: Translate Program755132 +Ref: Translate Program-Footnote-1759697 +Node: Labels Program759967 +Ref: Labels Program-Footnote-1763318 +Node: Word Sorting763402 +Node: History Sorting767474 +Node: Extract Program769309 +Node: Simple Sed776839 +Node: Igawk Program779913 +Ref: Igawk Program-Footnote-1794244 +Ref: Igawk Program-Footnote-2794446 +Ref: Igawk Program-Footnote-3794568 +Node: Anagram Program794683 +Node: Signature Program797745 +Node: Programs Summary798992 +Node: Programs Exercises800206 +Ref: Programs Exercises-Footnote-1804335 +Node: Advanced Features804426 +Node: Nondecimal Data806416 +Node: Array Sorting808007 +Node: Controlling Array Traversal808707 +Ref: Controlling Array Traversal-Footnote-1817074 +Node: Array Sorting Functions817192 +Ref: Array Sorting Functions-Footnote-1822283 +Node: Two-way I/O822479 +Ref: Two-way I/O-Footnote-1829031 +Ref: Two-way I/O-Footnote-2829218 +Node: TCP/IP Networking829300 +Node: Profiling832418 +Ref: Profiling-Footnote-1841090 +Node: Advanced Features Summary841413 +Node: Internationalization843257 +Node: I18N and L10N844737 +Node: Explaining gettext845424 +Ref: Explaining gettext-Footnote-1851316 +Ref: Explaining gettext-Footnote-2851501 +Node: Programmer i18n851666 +Ref: Programmer i18n-Footnote-1856615 +Node: Translator i18n856664 +Node: String Extraction857458 +Ref: String Extraction-Footnote-1858590 +Node: Printf Ordering858676 +Ref: Printf Ordering-Footnote-1861462 +Node: I18N Portability861526 +Ref: I18N Portability-Footnote-1863982 +Node: I18N Example864045 +Ref: I18N Example-Footnote-1866851 +Node: Gawk I18N866924 +Node: I18N Summary867569 +Node: Debugger868910 +Node: Debugging869933 +Node: Debugging Concepts870374 +Node: Debugging Terms872183 +Node: Awk Debugging874758 +Node: Sample Debugging Session875664 +Node: Debugger Invocation876198 +Node: Finding The Bug877584 +Node: List of Debugger Commands884062 +Node: Breakpoint Control885395 +Node: Debugger Execution Control889089 +Node: Viewing And Changing Data892451 +Node: Execution Stack895825 +Node: Debugger Info897462 +Node: Miscellaneous Debugger Commands901533 +Node: Readline Support906621 +Node: Limitations907517 +Node: Debugging Summary909626 +Node: Arbitrary Precision Arithmetic910905 +Node: Computer Arithmetic912390 +Ref: table-numeric-ranges915981 +Ref: Computer Arithmetic-Footnote-1916703 +Node: Math Definitions916760 +Ref: table-ieee-formats920076 +Ref: Math Definitions-Footnote-1920679 +Node: MPFR features920784 +Node: FP Math Caution922502 +Ref: FP Math Caution-Footnote-1923574 +Node: Inexactness of computations923943 +Node: Inexact representation924903 +Node: Comparing FP Values926263 +Node: Errors accumulate927345 +Node: Getting Accuracy928778 +Node: Try To Round931488 +Node: Setting precision932387 +Ref: table-predefined-precision-strings933084 +Node: Setting the rounding mode934914 +Ref: table-gawk-rounding-modes935288 +Ref: Setting the rounding mode-Footnote-1938696 +Node: Arbitrary Precision Integers938875 +Ref: Arbitrary Precision Integers-Footnote-1942050 +Node: Checking for MPFR942199 +Node: POSIX Floating Point Problems943496 +Ref: POSIX Floating Point Problems-Footnote-1947367 +Node: Floating point summary947405 +Node: Dynamic Extensions949595 +Node: Extension Intro951148 +Node: Plugin License952414 +Node: Extension Mechanism Outline953211 +Ref: figure-load-extension953650 +Ref: figure-register-new-function955215 +Ref: figure-call-new-function956307 +Node: Extension API Description958369 +Node: Extension API Functions Introduction960011 +Node: General Data Types965551 +Ref: General Data Types-Footnote-1973672 +Node: Memory Allocation Functions973971 +Ref: Memory Allocation Functions-Footnote-1978179 +Node: Constructor Functions978278 +Node: Registration Functions981864 +Node: Extension Functions982549 +Node: Exit Callback Functions987764 +Node: Extension Version String989014 +Node: Input Parsers989677 +Node: Output Wrappers1002398 +Node: Two-way processors1006910 +Node: Printing Messages1009175 +Ref: Printing Messages-Footnote-11010346 +Node: Updating ERRNO1010499 +Node: Requesting Values1011238 +Ref: table-value-types-returned1011975 +Node: Accessing Parameters1012911 +Node: Symbol Table Access1014146 +Node: Symbol table by name1014658 +Node: Symbol table by cookie1016447 +Ref: Symbol table by cookie-Footnote-11020632 +Node: Cached values1020696 +Ref: Cached values-Footnote-11024232 +Node: Array Manipulation1024385 +Ref: Array Manipulation-Footnote-11025476 +Node: Array Data Types1025513 +Ref: Array Data Types-Footnote-11028171 +Node: Array Functions1028263 +Node: Flattening Arrays1032761 +Node: Creating Arrays1039737 +Node: Redirection API1044506 +Node: Extension API Variables1047339 +Node: Extension Versioning1048050 +Ref: gawk-api-version1048479 +Node: Extension GMP/MPFR Versioning1050207 +Node: Extension API Informational Variables1051835 +Node: Extension API Boilerplate1052908 +Node: Changes from API V11056882 +Node: Finding Extensions1057542 +Node: Extension Example1058101 +Node: Internal File Description1058899 +Node: Internal File Ops1062979 +Ref: Internal File Ops-Footnote-11074379 +Node: Using Internal File Ops1074519 +Ref: Using Internal File Ops-Footnote-11076902 +Node: Extension Samples1077176 +Node: Extension Sample File Functions1078705 +Node: Extension Sample Fnmatch1086354 +Node: Extension Sample Fork1087841 +Node: Extension Sample Inplace1089059 +Node: Extension Sample Ord1092276 +Node: Extension Sample Readdir1093112 +Ref: table-readdir-file-types1094001 +Node: Extension Sample Revout1094806 +Node: Extension Sample Rev2way1095395 +Node: Extension Sample Read write array1096135 +Node: Extension Sample Readfile1098077 +Node: Extension Sample Time1099172 +Node: Extension Sample API Tests1100520 +Node: gawkextlib1101012 +Node: Extension summary1103468 +Node: Extension Exercises1107170 +Node: Language History1108668 +Node: V7/SVR3.11110324 +Node: SVR41112476 +Node: POSIX1113910 +Node: BTL1115290 +Node: POSIX/GNU1116019 +Node: Feature History1121797 +Node: Common Extensions1137656 +Node: Ranges and Locales1138939 +Ref: Ranges and Locales-Footnote-11143555 +Ref: Ranges and Locales-Footnote-21143582 +Ref: Ranges and Locales-Footnote-31143817 +Node: Contributors1144038 +Node: History summary1149983 +Node: Installation1151363 +Node: Gawk Distribution1152307 +Node: Getting1152791 +Node: Extracting1153754 +Node: Distribution contents1155392 +Node: Unix Installation1161872 +Node: Quick Installation1162554 +Node: Shell Startup Files1164968 +Node: Additional Configuration Options1166057 +Node: Configuration Philosophy1168046 +Node: Non-Unix Installation1170415 +Node: PC Installation1170875 +Node: PC Binary Installation1171713 +Node: PC Compiling1172148 +Node: PC Using1173265 +Node: Cygwin1176310 +Node: MSYS1177080 +Node: VMS Installation1177581 +Node: VMS Compilation1178372 +Ref: VMS Compilation-Footnote-11179601 +Node: VMS Dynamic Extensions1179659 +Node: VMS Installation Details1181344 +Node: VMS Running1183597 +Node: VMS GNV1187876 +Node: VMS Old Gawk1188611 +Node: Bugs1189082 +Node: Bug address1189745 +Node: Usenet1192537 +Node: Maintainers1193314 +Node: Other Versions1194575 +Node: Installation summary1201370 +Node: Notes1202572 +Node: Compatibility Mode1203437 +Node: Additions1204219 +Node: Accessing The Source1205144 +Node: Adding Code1206581 +Node: New Ports1212800 +Node: Derived Files1217288 +Ref: Derived Files-Footnote-11222934 +Ref: Derived Files-Footnote-21222969 +Ref: Derived Files-Footnote-31223567 +Node: Future Extensions1223681 +Node: Implementation Limitations1224339 +Node: Extension Design1225522 +Node: Old Extension Problems1226676 +Ref: Old Extension Problems-Footnote-11228194 +Node: Extension New Mechanism Goals1228251 +Ref: Extension New Mechanism Goals-Footnote-11231615 +Node: Extension Other Design Decisions1231804 +Node: Extension Future Growth1233917 +Node: Old Extension Mechanism1234753 +Node: Notes summary1236516 +Node: Basic Concepts1237698 +Node: Basic High Level1238379 +Ref: figure-general-flow1238661 +Ref: figure-process-flow1239346 +Ref: Basic High Level-Footnote-11242647 +Node: Basic Data Typing1242832 +Node: Glossary1246160 +Node: Copying1278110 +Node: GNU Free Documentation License1315649 +Node: Index1340767 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 50d58099..e689cb66 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -4839,9 +4839,8 @@ thus reducing the need for writing complex and tedious command lines. In particular, @code{@@include} is very useful for writing CGI scripts to be run from web pages. -As mentioned in @ref{AWKPATH Variable}, the current directory is always -searched first for source files, before searching in @env{AWKPATH}; -this also applies to files named with @code{@@include}. +The rules for finding a source file described in @ref{AWKPATH Variable} also +apply to files loaded with @code{@@include}. @node Loading Shared Libraries @section Loading Dynamic Extensions into Your Program diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 986e8957..2d7bcd69 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -4750,9 +4750,8 @@ thus reducing the need for writing complex and tedious command lines. In particular, @code{@@include} is very useful for writing CGI scripts to be run from web pages. -As mentioned in @ref{AWKPATH Variable}, the current directory is always -searched first for source files, before searching in @env{AWKPATH}; -this also applies to files named with @code{@@include}. +The rules for finding a source file described in @ref{AWKPATH Variable} also +apply to files loaded with @code{@@include}. @node Loading Shared Libraries @section Loading Dynamic Extensions into Your Program |