diff options
author | Arnold D. Robbins <arnold@skeeve.com> | 2015-04-05 15:18:52 +0300 |
---|---|---|
committer | Arnold D. Robbins <arnold@skeeve.com> | 2015-04-05 15:18:52 +0300 |
commit | f8b283eeed514287482d3bb56103c34ab9ae133b (patch) | |
tree | 4c3725fcd11a32449ae18c3054bdc0c40e595452 | |
parent | 7b6df8af60bfe3e90be216952510a8f7bf2745aa (diff) | |
parent | 1047a04edf933d57b88c264ee3dfb88633332f61 (diff) | |
download | egawk-f8b283eeed514287482d3bb56103c34ab9ae133b.tar.gz egawk-f8b283eeed514287482d3bb56103c34ab9ae133b.tar.bz2 egawk-f8b283eeed514287482d3bb56103c34ab9ae133b.zip |
Merge branch 'master' into feature/regex-type
-rw-r--r-- | doc/ChangeLog | 14 | ||||
-rw-r--r-- | doc/gawk.info | 772 | ||||
-rw-r--r-- | doc/gawk.texi | 28 | ||||
-rw-r--r-- | doc/gawktexi.in | 28 |
4 files changed, 417 insertions, 425 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 0e88c869..4d4b28c7 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,17 @@ +2015-04-05 Andrew J. Schorr <aschorr@telemetry-investments.com> + + * gawktexi.in: Replace http://gawkextlib.sourceforge.net with + http://sourceforge.net/projects/gawkextlib, since the former link + contains obsolete info. Update the gawkextlib build instructions + to point to http://sourceforge.net/projects/gawkextlib/files for the + current info. + +2015-04-05 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in: Fix a figure caption. Thanks to Antonio Colombo + for pointing this out. + * gawktexi.in: Additional typo fix, also thanks to Antonio. + 2015-04-02 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in, gawk.1, awkcard.in: Name change: div() --> intdiv(). diff --git a/doc/gawk.info b/doc/gawk.info index 685df45b..8ca85f4a 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -9453,7 +9453,7 @@ tasks that would otherwise be difficult or impossible to perform: inserting an "input parser"; *note Input Parsers::), you can invoke them at this point, before `gawk' has started processing the file. (This is a _very_ advanced feature, currently used only by the - `gawkextlib' project (http://gawkextlib.sourceforge.net).) + `gawkextlib' project (http://sourceforge.net/projects/gawkextlib).) The `ENDFILE' rule is called when `gawk' has finished processing the last record in an input file. For the last input file, it will be @@ -10446,8 +10446,8 @@ Options::), they are not special: mode, `gawk' does update its own environment when `ENVIRON' is changed, thus changing the environment seen by programs that it creates. You should therefore be especially careful if you modify - `ENVIRON["PATH"]"', which is the search path for finding - executable programs. + `ENVIRON["PATH"]', which is the search path for finding executable + programs. This can also affect the running `gawk' program, since some of the built-in functions may pay attention to certain environment @@ -26305,19 +26305,13 @@ follows. First, build and install `gawk': make && make check Build and check that all is OK make install Install gawk - Next, build `gawkextlib' and test it: - - cd .../path/to/gawkextlib-code - ./update-autotools Generate configure, etc. - You may have to run this command twice - ./configure --with-gawk=/tmp/newgawk Configure, point at "installed" gawk - make && make check Build and check that all is OK - make install Install the extensions - - If you have installed `gawk' in the standard way, then you will -likely not need the `--with-gawk' option when configuring `gawkextlib'. -You may need to use the `sudo' utility to install both `gawk' and -`gawkextlib', depending upon how your system works. + Next, go to `http://sourceforge.net/projects/gawkextlib/files' to +download `gawkextlib' and any extensions that you would like to build. +The `README' file at that site explains how to build the code. If you +installed `gawk' in a non-standard location, you will need to specify +`./configure --with-gawk=/PATH/TO/GAWK' to find it. You may need to +use the `sudo' utility to install both `gawk' and `gawkextlib', +depending upon how your system works. If you write an extension that you wish to share with other `gawk' users, consider doing so through the `gawkextlib' project. See the @@ -35082,378 +35076,378 @@ Node: Using BEGIN/END400162 Ref: Using BEGIN/END-Footnote-1402898 Node: I/O And BEGIN/END403004 Node: BEGINFILE/ENDFILE405319 -Node: Empty408216 -Node: Using Shell Variables408533 -Node: Action Overview410806 -Node: Statements413132 -Node: If Statement414980 -Node: While Statement416475 -Node: Do Statement418503 -Node: For Statement419651 -Node: Switch Statement422809 -Node: Break Statement425191 -Node: Continue Statement427284 -Node: Next Statement429111 -Node: Nextfile Statement431492 -Node: Exit Statement434120 -Node: Built-in Variables436531 -Node: User-modified437664 -Ref: User-modified-Footnote-1445298 -Node: Auto-set445360 -Ref: Auto-set-Footnote-1459593 -Ref: Auto-set-Footnote-2459798 -Node: ARGC and ARGV459854 -Node: Pattern Action Summary464072 -Node: Arrays466505 -Node: Array Basics467834 -Node: Array Intro468678 -Ref: figure-array-elements470615 -Ref: Array Intro-Footnote-1473238 -Node: Reference to Elements473366 -Node: Assigning Elements475828 -Node: Array Example476319 -Node: Scanning an Array478078 -Node: Controlling Scanning481101 -Ref: Controlling Scanning-Footnote-1486495 -Node: Numeric Array Subscripts486811 -Node: Uninitialized Subscripts488996 -Node: Delete490613 -Ref: Delete-Footnote-1493362 -Node: Multidimensional493419 -Node: Multiscanning496516 -Node: Arrays of Arrays498105 -Node: Arrays Summary502859 -Node: Functions504950 -Node: Built-in505989 -Node: Calling Built-in507067 -Node: Numeric Functions509062 -Ref: Numeric Functions-Footnote-1513895 -Ref: Numeric Functions-Footnote-2514252 -Ref: Numeric Functions-Footnote-3514300 -Node: String Functions514572 -Ref: String Functions-Footnote-1538073 -Ref: String Functions-Footnote-2538202 -Ref: String Functions-Footnote-3538450 -Node: Gory Details538537 -Ref: table-sub-escapes540318 -Ref: table-sub-proposed541833 -Ref: table-posix-sub543195 -Ref: table-gensub-escapes544732 -Ref: Gory Details-Footnote-1545565 -Node: I/O Functions545716 -Ref: I/O Functions-Footnote-1552952 -Node: Time Functions553099 -Ref: Time Functions-Footnote-1563608 -Ref: Time Functions-Footnote-2563676 -Ref: Time Functions-Footnote-3563834 -Ref: Time Functions-Footnote-4563945 -Ref: Time Functions-Footnote-5564057 -Ref: Time Functions-Footnote-6564284 -Node: Bitwise Functions564550 -Ref: table-bitwise-ops565112 -Ref: Bitwise Functions-Footnote-1569440 -Node: Type Functions569612 -Node: I18N Functions570764 -Node: User-defined572411 -Node: Definition Syntax573216 -Ref: Definition Syntax-Footnote-1578875 -Node: Function Example578946 -Ref: Function Example-Footnote-1581867 -Node: Function Caveats581889 -Node: Calling A Function582407 -Node: Variable Scope583365 -Node: Pass By Value/Reference586358 -Node: Return Statement589855 -Node: Dynamic Typing592834 -Node: Indirect Calls593763 -Ref: Indirect Calls-Footnote-1604006 -Node: Functions Summary604134 -Node: Library Functions606836 -Ref: Library Functions-Footnote-1610444 -Ref: Library Functions-Footnote-2610587 -Node: Library Names610758 -Ref: Library Names-Footnote-1614216 -Ref: Library Names-Footnote-2614439 -Node: General Functions614525 -Node: Strtonum Function615628 -Node: Assert Function618650 -Node: Round Function621974 -Node: Cliff Random Function623515 -Node: Ordinal Functions624531 -Ref: Ordinal Functions-Footnote-1627594 -Ref: Ordinal Functions-Footnote-2627846 -Node: Join Function628057 -Ref: Join Function-Footnote-1629827 -Node: Getlocaltime Function630027 -Node: Readfile Function633771 -Node: Shell Quoting635743 -Node: Data File Management637144 -Node: Filetrans Function637776 -Node: Rewind Function641872 -Node: File Checking643258 -Ref: File Checking-Footnote-1644591 -Node: Empty Files644792 -Node: Ignoring Assigns646771 -Node: Getopt Function648321 -Ref: Getopt Function-Footnote-1659785 -Node: Passwd Functions659985 -Ref: Passwd Functions-Footnote-1668825 -Node: Group Functions668913 -Ref: Group Functions-Footnote-1676810 -Node: Walking Arrays677015 -Node: Library Functions Summary680021 -Node: Library Exercises681423 -Node: Sample Programs682703 -Node: Running Examples683473 -Node: Clones684201 -Node: Cut Program685425 -Node: Egrep Program695145 -Ref: Egrep Program-Footnote-1702648 -Node: Id Program702758 -Node: Split Program706434 -Ref: Split Program-Footnote-1709888 -Node: Tee Program710016 -Node: Uniq Program712805 -Node: Wc Program720224 -Ref: Wc Program-Footnote-1724474 -Node: Miscellaneous Programs724568 -Node: Dupword Program725781 -Node: Alarm Program727812 -Node: Translate Program732617 -Ref: Translate Program-Footnote-1737180 -Node: Labels Program737450 -Ref: Labels Program-Footnote-1740801 -Node: Word Sorting740885 -Node: History Sorting744955 -Node: Extract Program746790 -Node: Simple Sed754314 -Node: Igawk Program757384 -Ref: Igawk Program-Footnote-1771710 -Ref: Igawk Program-Footnote-2771911 -Ref: Igawk Program-Footnote-3772033 -Node: Anagram Program772148 -Node: Signature Program775209 -Node: Programs Summary776456 -Node: Programs Exercises777677 -Ref: Programs Exercises-Footnote-1781808 -Node: Advanced Features781899 -Node: Nondecimal Data783881 -Node: Array Sorting785471 -Node: Controlling Array Traversal786171 -Ref: Controlling Array Traversal-Footnote-1794537 -Node: Array Sorting Functions794655 -Ref: Array Sorting Functions-Footnote-1798541 -Node: Two-way I/O798737 -Ref: Two-way I/O-Footnote-1803682 -Ref: Two-way I/O-Footnote-2803868 -Node: TCP/IP Networking803950 -Node: Profiling806822 -Node: Advanced Features Summary815093 -Node: Internationalization817026 -Node: I18N and L10N818506 -Node: Explaining gettext819192 -Ref: Explaining gettext-Footnote-1824217 -Ref: Explaining gettext-Footnote-2824401 -Node: Programmer i18n824566 -Ref: Programmer i18n-Footnote-1829442 -Node: Translator i18n829491 -Node: String Extraction830285 -Ref: String Extraction-Footnote-1831416 -Node: Printf Ordering831502 -Ref: Printf Ordering-Footnote-1834288 -Node: I18N Portability834352 -Ref: I18N Portability-Footnote-1836808 -Node: I18N Example836871 -Ref: I18N Example-Footnote-1839674 -Node: Gawk I18N839746 -Node: I18N Summary840390 -Node: Debugger841730 -Node: Debugging842752 -Node: Debugging Concepts843193 -Node: Debugging Terms845003 -Node: Awk Debugging847575 -Node: Sample Debugging Session848481 -Node: Debugger Invocation849015 -Node: Finding The Bug850400 -Node: List of Debugger Commands856879 -Node: Breakpoint Control858211 -Node: Debugger Execution Control861888 -Node: Viewing And Changing Data865247 -Node: Execution Stack868623 -Node: Debugger Info870258 -Node: Miscellaneous Debugger Commands874303 -Node: Readline Support879304 -Node: Limitations880198 -Node: Debugging Summary882313 -Node: Arbitrary Precision Arithmetic883487 -Node: Computer Arithmetic884903 -Ref: table-numeric-ranges888480 -Ref: Computer Arithmetic-Footnote-1889004 -Node: Math Definitions889061 -Ref: table-ieee-formats892356 -Ref: Math Definitions-Footnote-1892960 -Node: MPFR features893065 -Node: FP Math Caution894736 -Ref: FP Math Caution-Footnote-1895786 -Node: Inexactness of computations896155 -Node: Inexact representation897114 -Node: Comparing FP Values898472 -Node: Errors accumulate899554 -Node: Getting Accuracy900986 -Node: Try To Round903690 -Node: Setting precision904589 -Ref: table-predefined-precision-strings905273 -Node: Setting the rounding mode907102 -Ref: table-gawk-rounding-modes907466 -Ref: Setting the rounding mode-Footnote-1910918 -Node: Arbitrary Precision Integers911097 -Ref: Arbitrary Precision Integers-Footnote-1916013 -Node: POSIX Floating Point Problems916162 -Ref: POSIX Floating Point Problems-Footnote-1920041 -Node: Floating point summary920079 -Node: Dynamic Extensions922266 -Node: Extension Intro923818 -Node: Plugin License925083 -Node: Extension Mechanism Outline925880 -Ref: figure-load-extension926308 -Ref: figure-register-new-function927788 -Ref: figure-call-new-function928792 -Node: Extension API Description930779 -Node: Extension API Functions Introduction932313 -Node: General Data Types937182 -Ref: General Data Types-Footnote-1943082 -Node: Memory Allocation Functions943381 -Ref: Memory Allocation Functions-Footnote-1946220 -Node: Constructor Functions946319 -Node: Registration Functions948058 -Node: Extension Functions948743 -Node: Exit Callback Functions951040 -Node: Extension Version String952288 -Node: Input Parsers952951 -Node: Output Wrappers962826 -Node: Two-way processors967339 -Node: Printing Messages969602 -Ref: Printing Messages-Footnote-1970678 -Node: Updating `ERRNO'970830 -Node: Requesting Values971570 -Ref: table-value-types-returned972297 -Node: Accessing Parameters973254 -Node: Symbol Table Access974488 -Node: Symbol table by name975002 -Node: Symbol table by cookie977022 -Ref: Symbol table by cookie-Footnote-1981167 -Node: Cached values981230 -Ref: Cached values-Footnote-1984726 -Node: Array Manipulation984817 -Ref: Array Manipulation-Footnote-1985907 -Node: Array Data Types985944 -Ref: Array Data Types-Footnote-1988599 -Node: Array Functions988691 -Node: Flattening Arrays992550 -Node: Creating Arrays999452 -Node: Redirection API1004223 -Node: Extension API Variables1007048 -Node: Extension Versioning1007681 -Node: Extension API Informational Variables1009572 -Node: Extension API Boilerplate1010637 -Node: Finding Extensions1014446 -Node: Extension Example1015006 -Node: Internal File Description1015778 -Node: Internal File Ops1019845 -Ref: Internal File Ops-Footnote-11031596 -Node: Using Internal File Ops1031736 -Ref: Using Internal File Ops-Footnote-11034119 -Node: Extension Samples1034392 -Node: Extension Sample File Functions1035920 -Node: Extension Sample Fnmatch1043601 -Node: Extension Sample Fork1045089 -Node: Extension Sample Inplace1046304 -Node: Extension Sample Ord1048390 -Node: Extension Sample Readdir1049226 -Ref: table-readdir-file-types1050103 -Node: Extension Sample Revout1050914 -Node: Extension Sample Rev2way1051503 -Node: Extension Sample Read write array1052243 -Node: Extension Sample Readfile1054183 -Node: Extension Sample Time1055278 -Node: Extension Sample API Tests1056626 -Node: gawkextlib1057117 -Node: Extension summary1059818 -Node: Extension Exercises1063507 -Node: Language History1065003 -Node: V7/SVR3.11066659 -Node: SVR41068812 -Node: POSIX1070246 -Node: BTL1071627 -Node: POSIX/GNU1072358 -Node: Feature History1078197 -Node: Common Extensions1091994 -Node: Ranges and Locales1093366 -Ref: Ranges and Locales-Footnote-11097985 -Ref: Ranges and Locales-Footnote-21098012 -Ref: Ranges and Locales-Footnote-31098247 -Node: Contributors1098468 -Node: History summary1104008 -Node: Installation1105387 -Node: Gawk Distribution1106333 -Node: Getting1106817 -Node: Extracting1107640 -Node: Distribution contents1109277 -Node: Unix Installation1115379 -Node: Quick Installation1116062 -Node: Shell Startup Files1118473 -Node: Additional Configuration Options1119552 -Node: Configuration Philosophy1121356 -Node: Non-Unix Installation1123725 -Node: PC Installation1124183 -Node: PC Binary Installation1125503 -Node: PC Compiling1127351 -Ref: PC Compiling-Footnote-11130372 -Node: PC Testing1130481 -Node: PC Using1131657 -Node: Cygwin1135772 -Node: MSYS1136542 -Node: VMS Installation1137043 -Node: VMS Compilation1137835 -Ref: VMS Compilation-Footnote-11139064 -Node: VMS Dynamic Extensions1139122 -Node: VMS Installation Details1140806 -Node: VMS Running1143057 -Node: VMS GNV1145897 -Node: VMS Old Gawk1146632 -Node: Bugs1147102 -Node: Other Versions1150991 -Node: Installation summary1157425 -Node: Notes1158484 -Node: Compatibility Mode1159349 -Node: Additions1160131 -Node: Accessing The Source1161056 -Node: Adding Code1162491 -Node: New Ports1168648 -Node: Derived Files1173130 -Ref: Derived Files-Footnote-11178605 -Ref: Derived Files-Footnote-21178639 -Ref: Derived Files-Footnote-31179235 -Node: Future Extensions1179349 -Node: Implementation Limitations1179955 -Node: Extension Design1181203 -Node: Old Extension Problems1182357 -Ref: Old Extension Problems-Footnote-11183874 -Node: Extension New Mechanism Goals1183931 -Ref: Extension New Mechanism Goals-Footnote-11187291 -Node: Extension Other Design Decisions1187480 -Node: Extension Future Growth1189588 -Node: Old Extension Mechanism1190424 -Node: Notes summary1192186 -Node: Basic Concepts1193372 -Node: Basic High Level1194053 -Ref: figure-general-flow1194325 -Ref: figure-process-flow1194924 -Ref: Basic High Level-Footnote-11198153 -Node: Basic Data Typing1198338 -Node: Glossary1201666 -Node: Copying1233595 -Node: GNU Free Documentation License1271151 -Node: Index1296287 +Node: Empty408225 +Node: Using Shell Variables408542 +Node: Action Overview410815 +Node: Statements413141 +Node: If Statement414989 +Node: While Statement416484 +Node: Do Statement418512 +Node: For Statement419660 +Node: Switch Statement422818 +Node: Break Statement425200 +Node: Continue Statement427293 +Node: Next Statement429120 +Node: Nextfile Statement431501 +Node: Exit Statement434129 +Node: Built-in Variables436540 +Node: User-modified437673 +Ref: User-modified-Footnote-1445307 +Node: Auto-set445369 +Ref: Auto-set-Footnote-1459601 +Ref: Auto-set-Footnote-2459806 +Node: ARGC and ARGV459862 +Node: Pattern Action Summary464080 +Node: Arrays466513 +Node: Array Basics467842 +Node: Array Intro468686 +Ref: figure-array-elements470623 +Ref: Array Intro-Footnote-1473246 +Node: Reference to Elements473374 +Node: Assigning Elements475836 +Node: Array Example476327 +Node: Scanning an Array478086 +Node: Controlling Scanning481109 +Ref: Controlling Scanning-Footnote-1486503 +Node: Numeric Array Subscripts486819 +Node: Uninitialized Subscripts489004 +Node: Delete490621 +Ref: Delete-Footnote-1493370 +Node: Multidimensional493427 +Node: Multiscanning496524 +Node: Arrays of Arrays498113 +Node: Arrays Summary502867 +Node: Functions504958 +Node: Built-in505997 +Node: Calling Built-in507075 +Node: Numeric Functions509070 +Ref: Numeric Functions-Footnote-1513903 +Ref: Numeric Functions-Footnote-2514260 +Ref: Numeric Functions-Footnote-3514308 +Node: String Functions514580 +Ref: String Functions-Footnote-1538081 +Ref: String Functions-Footnote-2538210 +Ref: String Functions-Footnote-3538458 +Node: Gory Details538545 +Ref: table-sub-escapes540326 +Ref: table-sub-proposed541841 +Ref: table-posix-sub543203 +Ref: table-gensub-escapes544740 +Ref: Gory Details-Footnote-1545573 +Node: I/O Functions545724 +Ref: I/O Functions-Footnote-1552960 +Node: Time Functions553107 +Ref: Time Functions-Footnote-1563616 +Ref: Time Functions-Footnote-2563684 +Ref: Time Functions-Footnote-3563842 +Ref: Time Functions-Footnote-4563953 +Ref: Time Functions-Footnote-5564065 +Ref: Time Functions-Footnote-6564292 +Node: Bitwise Functions564558 +Ref: table-bitwise-ops565120 +Ref: Bitwise Functions-Footnote-1569448 +Node: Type Functions569620 +Node: I18N Functions570772 +Node: User-defined572419 +Node: Definition Syntax573224 +Ref: Definition Syntax-Footnote-1578883 +Node: Function Example578954 +Ref: Function Example-Footnote-1581875 +Node: Function Caveats581897 +Node: Calling A Function582415 +Node: Variable Scope583373 +Node: Pass By Value/Reference586366 +Node: Return Statement589863 +Node: Dynamic Typing592842 +Node: Indirect Calls593771 +Ref: Indirect Calls-Footnote-1604014 +Node: Functions Summary604142 +Node: Library Functions606844 +Ref: Library Functions-Footnote-1610452 +Ref: Library Functions-Footnote-2610595 +Node: Library Names610766 +Ref: Library Names-Footnote-1614224 +Ref: Library Names-Footnote-2614447 +Node: General Functions614533 +Node: Strtonum Function615636 +Node: Assert Function618658 +Node: Round Function621982 +Node: Cliff Random Function623523 +Node: Ordinal Functions624539 +Ref: Ordinal Functions-Footnote-1627602 +Ref: Ordinal Functions-Footnote-2627854 +Node: Join Function628065 +Ref: Join Function-Footnote-1629835 +Node: Getlocaltime Function630035 +Node: Readfile Function633779 +Node: Shell Quoting635751 +Node: Data File Management637152 +Node: Filetrans Function637784 +Node: Rewind Function641880 +Node: File Checking643266 +Ref: File Checking-Footnote-1644599 +Node: Empty Files644800 +Node: Ignoring Assigns646779 +Node: Getopt Function648329 +Ref: Getopt Function-Footnote-1659793 +Node: Passwd Functions659993 +Ref: Passwd Functions-Footnote-1668833 +Node: Group Functions668921 +Ref: Group Functions-Footnote-1676818 +Node: Walking Arrays677023 +Node: Library Functions Summary680029 +Node: Library Exercises681431 +Node: Sample Programs682711 +Node: Running Examples683481 +Node: Clones684209 +Node: Cut Program685433 +Node: Egrep Program695153 +Ref: Egrep Program-Footnote-1702656 +Node: Id Program702766 +Node: Split Program706442 +Ref: Split Program-Footnote-1709896 +Node: Tee Program710024 +Node: Uniq Program712813 +Node: Wc Program720232 +Ref: Wc Program-Footnote-1724482 +Node: Miscellaneous Programs724576 +Node: Dupword Program725789 +Node: Alarm Program727820 +Node: Translate Program732625 +Ref: Translate Program-Footnote-1737188 +Node: Labels Program737458 +Ref: Labels Program-Footnote-1740809 +Node: Word Sorting740893 +Node: History Sorting744963 +Node: Extract Program746798 +Node: Simple Sed754322 +Node: Igawk Program757392 +Ref: Igawk Program-Footnote-1771718 +Ref: Igawk Program-Footnote-2771919 +Ref: Igawk Program-Footnote-3772041 +Node: Anagram Program772156 +Node: Signature Program775217 +Node: Programs Summary776464 +Node: Programs Exercises777685 +Ref: Programs Exercises-Footnote-1781816 +Node: Advanced Features781907 +Node: Nondecimal Data783889 +Node: Array Sorting785479 +Node: Controlling Array Traversal786179 +Ref: Controlling Array Traversal-Footnote-1794545 +Node: Array Sorting Functions794663 +Ref: Array Sorting Functions-Footnote-1798549 +Node: Two-way I/O798745 +Ref: Two-way I/O-Footnote-1803690 +Ref: Two-way I/O-Footnote-2803876 +Node: TCP/IP Networking803958 +Node: Profiling806830 +Node: Advanced Features Summary815101 +Node: Internationalization817034 +Node: I18N and L10N818514 +Node: Explaining gettext819200 +Ref: Explaining gettext-Footnote-1824225 +Ref: Explaining gettext-Footnote-2824409 +Node: Programmer i18n824574 +Ref: Programmer i18n-Footnote-1829450 +Node: Translator i18n829499 +Node: String Extraction830293 +Ref: String Extraction-Footnote-1831424 +Node: Printf Ordering831510 +Ref: Printf Ordering-Footnote-1834296 +Node: I18N Portability834360 +Ref: I18N Portability-Footnote-1836816 +Node: I18N Example836879 +Ref: I18N Example-Footnote-1839682 +Node: Gawk I18N839754 +Node: I18N Summary840398 +Node: Debugger841738 +Node: Debugging842760 +Node: Debugging Concepts843201 +Node: Debugging Terms845011 +Node: Awk Debugging847583 +Node: Sample Debugging Session848489 +Node: Debugger Invocation849023 +Node: Finding The Bug850408 +Node: List of Debugger Commands856887 +Node: Breakpoint Control858219 +Node: Debugger Execution Control861896 +Node: Viewing And Changing Data865255 +Node: Execution Stack868631 +Node: Debugger Info870266 +Node: Miscellaneous Debugger Commands874311 +Node: Readline Support879312 +Node: Limitations880206 +Node: Debugging Summary882321 +Node: Arbitrary Precision Arithmetic883495 +Node: Computer Arithmetic884911 +Ref: table-numeric-ranges888488 +Ref: Computer Arithmetic-Footnote-1889012 +Node: Math Definitions889069 +Ref: table-ieee-formats892364 +Ref: Math Definitions-Footnote-1892968 +Node: MPFR features893073 +Node: FP Math Caution894744 +Ref: FP Math Caution-Footnote-1895794 +Node: Inexactness of computations896163 +Node: Inexact representation897122 +Node: Comparing FP Values898480 +Node: Errors accumulate899562 +Node: Getting Accuracy900994 +Node: Try To Round903698 +Node: Setting precision904597 +Ref: table-predefined-precision-strings905281 +Node: Setting the rounding mode907110 +Ref: table-gawk-rounding-modes907474 +Ref: Setting the rounding mode-Footnote-1910926 +Node: Arbitrary Precision Integers911105 +Ref: Arbitrary Precision Integers-Footnote-1916021 +Node: POSIX Floating Point Problems916170 +Ref: POSIX Floating Point Problems-Footnote-1920049 +Node: Floating point summary920087 +Node: Dynamic Extensions922274 +Node: Extension Intro923826 +Node: Plugin License925091 +Node: Extension Mechanism Outline925888 +Ref: figure-load-extension926316 +Ref: figure-register-new-function927796 +Ref: figure-call-new-function928800 +Node: Extension API Description930787 +Node: Extension API Functions Introduction932321 +Node: General Data Types937190 +Ref: General Data Types-Footnote-1943090 +Node: Memory Allocation Functions943389 +Ref: Memory Allocation Functions-Footnote-1946228 +Node: Constructor Functions946327 +Node: Registration Functions948066 +Node: Extension Functions948751 +Node: Exit Callback Functions951048 +Node: Extension Version String952296 +Node: Input Parsers952959 +Node: Output Wrappers962834 +Node: Two-way processors967347 +Node: Printing Messages969610 +Ref: Printing Messages-Footnote-1970686 +Node: Updating `ERRNO'970838 +Node: Requesting Values971578 +Ref: table-value-types-returned972305 +Node: Accessing Parameters973262 +Node: Symbol Table Access974496 +Node: Symbol table by name975010 +Node: Symbol table by cookie977030 +Ref: Symbol table by cookie-Footnote-1981175 +Node: Cached values981238 +Ref: Cached values-Footnote-1984734 +Node: Array Manipulation984825 +Ref: Array Manipulation-Footnote-1985915 +Node: Array Data Types985952 +Ref: Array Data Types-Footnote-1988607 +Node: Array Functions988699 +Node: Flattening Arrays992558 +Node: Creating Arrays999460 +Node: Redirection API1004231 +Node: Extension API Variables1007056 +Node: Extension Versioning1007689 +Node: Extension API Informational Variables1009580 +Node: Extension API Boilerplate1010645 +Node: Finding Extensions1014454 +Node: Extension Example1015014 +Node: Internal File Description1015786 +Node: Internal File Ops1019853 +Ref: Internal File Ops-Footnote-11031604 +Node: Using Internal File Ops1031744 +Ref: Using Internal File Ops-Footnote-11034127 +Node: Extension Samples1034400 +Node: Extension Sample File Functions1035928 +Node: Extension Sample Fnmatch1043609 +Node: Extension Sample Fork1045097 +Node: Extension Sample Inplace1046312 +Node: Extension Sample Ord1048398 +Node: Extension Sample Readdir1049234 +Ref: table-readdir-file-types1050111 +Node: Extension Sample Revout1050922 +Node: Extension Sample Rev2way1051511 +Node: Extension Sample Read write array1052251 +Node: Extension Sample Readfile1054191 +Node: Extension Sample Time1055286 +Node: Extension Sample API Tests1056634 +Node: gawkextlib1057125 +Node: Extension summary1059572 +Node: Extension Exercises1063261 +Node: Language History1064757 +Node: V7/SVR3.11066413 +Node: SVR41068566 +Node: POSIX1070000 +Node: BTL1071381 +Node: POSIX/GNU1072112 +Node: Feature History1077951 +Node: Common Extensions1091748 +Node: Ranges and Locales1093120 +Ref: Ranges and Locales-Footnote-11097739 +Ref: Ranges and Locales-Footnote-21097766 +Ref: Ranges and Locales-Footnote-31098001 +Node: Contributors1098222 +Node: History summary1103762 +Node: Installation1105141 +Node: Gawk Distribution1106087 +Node: Getting1106571 +Node: Extracting1107394 +Node: Distribution contents1109031 +Node: Unix Installation1115133 +Node: Quick Installation1115816 +Node: Shell Startup Files1118227 +Node: Additional Configuration Options1119306 +Node: Configuration Philosophy1121110 +Node: Non-Unix Installation1123479 +Node: PC Installation1123937 +Node: PC Binary Installation1125257 +Node: PC Compiling1127105 +Ref: PC Compiling-Footnote-11130126 +Node: PC Testing1130235 +Node: PC Using1131411 +Node: Cygwin1135526 +Node: MSYS1136296 +Node: VMS Installation1136797 +Node: VMS Compilation1137589 +Ref: VMS Compilation-Footnote-11138818 +Node: VMS Dynamic Extensions1138876 +Node: VMS Installation Details1140560 +Node: VMS Running1142811 +Node: VMS GNV1145651 +Node: VMS Old Gawk1146386 +Node: Bugs1146856 +Node: Other Versions1150745 +Node: Installation summary1157179 +Node: Notes1158238 +Node: Compatibility Mode1159103 +Node: Additions1159885 +Node: Accessing The Source1160810 +Node: Adding Code1162245 +Node: New Ports1168402 +Node: Derived Files1172884 +Ref: Derived Files-Footnote-11178359 +Ref: Derived Files-Footnote-21178393 +Ref: Derived Files-Footnote-31178989 +Node: Future Extensions1179103 +Node: Implementation Limitations1179709 +Node: Extension Design1180957 +Node: Old Extension Problems1182111 +Ref: Old Extension Problems-Footnote-11183628 +Node: Extension New Mechanism Goals1183685 +Ref: Extension New Mechanism Goals-Footnote-11187045 +Node: Extension Other Design Decisions1187234 +Node: Extension Future Growth1189342 +Node: Old Extension Mechanism1190178 +Node: Notes summary1191940 +Node: Basic Concepts1193126 +Node: Basic High Level1193807 +Ref: figure-general-flow1194079 +Ref: figure-process-flow1194678 +Ref: Basic High Level-Footnote-11197907 +Node: Basic Data Typing1198092 +Node: Glossary1201420 +Node: Copying1233349 +Node: GNU Free Documentation License1270905 +Node: Index1296041 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index ca378cca..d2d4107d 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -13640,7 +13640,7 @@ If you have written extensions that modify the record handling (by inserting an ``input parser''; @pxref{Input Parsers}), you can invoke them at this point, before @command{gawk} has started processing the file. (This is a @emph{very} advanced feature, currently used only by the -@uref{http://gawkextlib.sourceforge.net, @code{gawkextlib} project}.) +@uref{http://sourceforge.net/projects/gawkextlib, @code{gawkextlib} project}.) @end itemize The @code{ENDFILE} rule is called when @command{gawk} has finished processing @@ -14928,7 +14928,7 @@ However, beginning with version 4.2, if not in POSIX compatibility mode, @command{gawk} does update its own environment when @code{ENVIRON} is changed, thus changing the environment seen by programs that it creates. You should therefore be especially careful if you -modify @code{ENVIRON["PATH"]"}, which is the search path for finding +modify @code{ENVIRON["PATH"]}, which is the search path for finding executable programs. This can also affect the running @command{gawk} program, since some of the @@ -15668,10 +15668,10 @@ conceptually, if the element values are eight, @code{"foo"}, @float Figure,figure-array-elements @caption{A contiguous array} @ifinfo -@center @image{array-elements, , , Basic Program Stages, txt} +@center @image{array-elements, , , A Contiguous Array, txt} @end ifinfo @ifnotinfo -@center @image{array-elements, , , Basic Program Stages} +@center @image{array-elements, , , A Contiguous Array} @end ifnotinfo @end float @end ifnotdocbook @@ -35353,20 +35353,12 @@ make && make check @ii{Build and check that all is OK} make install @ii{Install gawk} @end example -Next, build @code{gawkextlib} and test it: - -@example -cd .../path/to/gawkextlib-code -./update-autotools @ii{Generate configure, etc.} - @ii{You may have to run this command twice} -./configure --with-gawk=/tmp/newgawk @ii{Configure, point at ``installed'' gawk} -make && make check @ii{Build and check that all is OK} -make install @ii{Install the extensions} -@end example - -If you have installed @command{gawk} in the standard way, then you -will likely not need the @option{--with-gawk} option when configuring -@code{gawkextlib}. You may need to use the @command{sudo} utility +Next, go to @url{http://sourceforge.net/projects/gawkextlib/files} to +download @code{gawkextlib} and any extensions that you would like to build. +The @file{README} file at that site explains how to build the code. If you +installed @command{gawk} in a non-standard location, you will need to +specify @code{./configure --with-gawk=@var{/path/to/gawk}} to find it. +You may need to use the @command{sudo} utility to install both @command{gawk} and @code{gawkextlib}, depending upon how your system works. diff --git a/doc/gawktexi.in b/doc/gawktexi.in index 4cd04763..5fe53190 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -12968,7 +12968,7 @@ If you have written extensions that modify the record handling (by inserting an ``input parser''; @pxref{Input Parsers}), you can invoke them at this point, before @command{gawk} has started processing the file. (This is a @emph{very} advanced feature, currently used only by the -@uref{http://gawkextlib.sourceforge.net, @code{gawkextlib} project}.) +@uref{http://sourceforge.net/projects/gawkextlib, @code{gawkextlib} project}.) @end itemize The @code{ENDFILE} rule is called when @command{gawk} has finished processing @@ -14256,7 +14256,7 @@ However, beginning with version 4.2, if not in POSIX compatibility mode, @command{gawk} does update its own environment when @code{ENVIRON} is changed, thus changing the environment seen by programs that it creates. You should therefore be especially careful if you -modify @code{ENVIRON["PATH"]"}, which is the search path for finding +modify @code{ENVIRON["PATH"]}, which is the search path for finding executable programs. This can also affect the running @command{gawk} program, since some of the @@ -14950,10 +14950,10 @@ conceptually, if the element values are eight, @code{"foo"}, @float Figure,figure-array-elements @caption{A contiguous array} @ifinfo -@center @image{array-elements, , , Basic Program Stages, txt} +@center @image{array-elements, , , A Contiguous Array, txt} @end ifinfo @ifnotinfo -@center @image{array-elements, , , Basic Program Stages} +@center @image{array-elements, , , A Contiguous Array} @end ifnotinfo @end float @end ifnotdocbook @@ -34444,20 +34444,12 @@ make && make check @ii{Build and check that all is OK} make install @ii{Install gawk} @end example -Next, build @code{gawkextlib} and test it: - -@example -cd .../path/to/gawkextlib-code -./update-autotools @ii{Generate configure, etc.} - @ii{You may have to run this command twice} -./configure --with-gawk=/tmp/newgawk @ii{Configure, point at ``installed'' gawk} -make && make check @ii{Build and check that all is OK} -make install @ii{Install the extensions} -@end example - -If you have installed @command{gawk} in the standard way, then you -will likely not need the @option{--with-gawk} option when configuring -@code{gawkextlib}. You may need to use the @command{sudo} utility +Next, go to @url{http://sourceforge.net/projects/gawkextlib/files} to +download @code{gawkextlib} and any extensions that you would like to build. +The @file{README} file at that site explains how to build the code. If you +installed @command{gawk} in a non-standard location, you will need to +specify @code{./configure --with-gawk=@var{/path/to/gawk}} to find it. +You may need to use the @command{sudo} utility to install both @command{gawk} and @code{gawkextlib}, depending upon how your system works. |