diff options
| -rw-r--r-- | doc/ChangeLog | 4 | ||||
| -rw-r--r-- | doc/gawk.info | 733 | ||||
| -rw-r--r-- | doc/gawk.texi | 23 | ||||
| -rw-r--r-- | doc/gawktexi.in | 23 |
4 files changed, 419 insertions, 364 deletions
diff --git a/doc/ChangeLog b/doc/ChangeLog index 32f4ecb5..24929efc 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,7 @@ +2016-07-12 Arnold D. Robbins <arnold@skeeve.com> + + * gawktexi.in (Auto-set): Add example use of multiply function. + 2016-06-10 Arnold D. Robbins <arnold@skeeve.com> * gawktexi.in: Fix a typo, and replace hard-coded "section" with diff --git a/doc/gawk.info b/doc/gawk.info index e2869769..fab22030 100644 --- a/doc/gawk.info +++ b/doc/gawk.info @@ -10541,6 +10541,19 @@ they are not special: return SYMTAB[variable] *= amount } + You would use it like this: + + BEGIN { + answer = 10.5 + multiply("answer", 4) + print "The answer is", answer + } + + When run, this produces: + + $ gawk -f answer.awk + -| The answer is 42 + NOTE: In order to avoid severe time-travel paradoxes,(2) neither 'FUNCTAB' nor 'SYMTAB' is available as an element within the 'SYMTAB' array. @@ -32454,7 +32467,7 @@ Index * dark corner, field separators: Full Line Fields. (line 22) * dark corner, FILENAME variable: Getline Notes. (line 19) * dark corner, FILENAME variable <1>: Auto-set. (line 89) -* dark corner, FNR/NR variables: Auto-set. (line 313) +* dark corner, FNR/NR variables: Auto-set. (line 326) * dark corner, format-control characters: Control Letters. (line 18) * dark corner, format-control characters <1>: Control Letters. (line 93) @@ -33010,7 +33023,7 @@ Index (line 12) * FNR variable: Records. (line 6) * FNR variable <1>: Auto-set. (line 99) -* FNR variable, changing: Auto-set. (line 313) +* FNR variable, changing: Auto-set. (line 326) * for statement: For Statement. (line 6) * for statement, looping over arrays: Scanning an Array. (line 20) * fork() extension function: Extension Sample Fork. @@ -33658,7 +33671,7 @@ Index * not Boolean-logic operator: Boolean Ops. (line 6) * NR variable: Records. (line 6) * NR variable <1>: Auto-set. (line 124) -* NR variable, changing: Auto-set. (line 313) +* NR variable, changing: Auto-set. (line 326) * null strings: awk split records. (line 114) * null strings <1>: Regexp Field Splitting. (line 43) @@ -34259,7 +34272,7 @@ Index (line 103) * sidebar, Changing FS Does Not Affect the Fields: Full Line Fields. (line 14) -* sidebar, Changing NR and FNR: Auto-set. (line 311) +* sidebar, Changing NR and FNR: Auto-set. (line 324) * sidebar, Controlling Output Buffering with system(): I/O Functions. (line 164) * sidebar, Escape Sequences for Metacharacters: Escape Sequences. @@ -34875,361 +34888,361 @@ Node: Built-in Variables432462 Node: User-modified433595 Ref: User-modified-Footnote-1441220 Node: Auto-set441282 -Ref: Auto-set-Footnote-1454372 -Ref: Auto-set-Footnote-2454578 -Node: ARGC and ARGV454634 -Node: Pattern Action Summary458847 -Node: Arrays461277 -Node: Array Basics462606 -Node: Array Intro463450 -Ref: figure-array-elements465425 -Ref: Array Intro-Footnote-1468129 -Node: Reference to Elements468257 -Node: Assigning Elements470721 -Node: Array Example471212 -Node: Scanning an Array472971 -Node: Controlling Scanning475993 -Ref: Controlling Scanning-Footnote-1481392 -Node: Numeric Array Subscripts481708 -Node: Uninitialized Subscripts483892 -Node: Delete485511 -Ref: Delete-Footnote-1488263 -Node: Multidimensional488320 -Node: Multiscanning491415 -Node: Arrays of Arrays493006 -Node: Arrays Summary497773 -Node: Functions499866 -Node: Built-in500904 -Node: Calling Built-in501985 -Node: Numeric Functions503981 -Ref: Numeric Functions-Footnote-1508009 -Ref: Numeric Functions-Footnote-2508366 -Ref: Numeric Functions-Footnote-3508414 -Node: String Functions508686 -Ref: String Functions-Footnote-1532190 -Ref: String Functions-Footnote-2532318 -Ref: String Functions-Footnote-3532566 -Node: Gory Details532653 -Ref: table-sub-escapes534444 -Ref: table-sub-proposed535963 -Ref: table-posix-sub537326 -Ref: table-gensub-escapes538867 -Ref: Gory Details-Footnote-1539690 -Node: I/O Functions539844 -Ref: table-system-return-values546426 -Ref: I/O Functions-Footnote-1548406 -Ref: I/O Functions-Footnote-2548554 -Node: Time Functions548674 -Ref: Time Functions-Footnote-1559179 -Ref: Time Functions-Footnote-2559247 -Ref: Time Functions-Footnote-3559405 -Ref: Time Functions-Footnote-4559516 -Ref: Time Functions-Footnote-5559628 -Ref: Time Functions-Footnote-6559855 -Node: Bitwise Functions560121 -Ref: table-bitwise-ops560715 -Ref: Bitwise Functions-Footnote-1565053 -Node: Type Functions565226 -Node: I18N Functions566382 -Node: User-defined568033 -Node: Definition Syntax568838 -Ref: Definition Syntax-Footnote-1574525 -Node: Function Example574596 -Ref: Function Example-Footnote-1577518 -Node: Function Caveats577540 -Node: Calling A Function578058 -Node: Variable Scope579016 -Node: Pass By Value/Reference582010 -Node: Return Statement585509 -Node: Dynamic Typing588488 -Node: Indirect Calls589418 -Ref: Indirect Calls-Footnote-1599669 -Node: Functions Summary599797 -Node: Library Functions602502 -Ref: Library Functions-Footnote-1606109 -Ref: Library Functions-Footnote-2606252 -Node: Library Names606423 -Ref: Library Names-Footnote-1609883 -Ref: Library Names-Footnote-2610106 -Node: General Functions610192 -Node: Strtonum Function611295 -Node: Assert Function614317 -Node: Round Function617643 -Node: Cliff Random Function619184 -Node: Ordinal Functions620200 -Ref: Ordinal Functions-Footnote-1623263 -Ref: Ordinal Functions-Footnote-2623515 -Node: Join Function623725 -Ref: Join Function-Footnote-1625495 -Node: Getlocaltime Function625695 -Node: Readfile Function629437 -Node: Shell Quoting631409 -Node: Data File Management632810 -Node: Filetrans Function633442 -Node: Rewind Function637538 -Node: File Checking639443 -Ref: File Checking-Footnote-1640777 -Node: Empty Files640978 -Node: Ignoring Assigns642957 -Node: Getopt Function644507 -Ref: Getopt Function-Footnote-1655976 -Node: Passwd Functions656176 -Ref: Passwd Functions-Footnote-1665015 -Node: Group Functions665103 -Ref: Group Functions-Footnote-1673000 -Node: Walking Arrays673207 -Node: Library Functions Summary676215 -Node: Library Exercises677621 -Node: Sample Programs678086 -Node: Running Examples678856 -Node: Clones679584 -Node: Cut Program680808 -Node: Egrep Program690737 -Ref: Egrep Program-Footnote-1698249 -Node: Id Program698359 -Node: Split Program702039 -Ref: Split Program-Footnote-1705498 -Node: Tee Program705627 -Node: Uniq Program708417 -Node: Wc Program715843 -Ref: Wc Program-Footnote-1720098 -Node: Miscellaneous Programs720192 -Node: Dupword Program721405 -Node: Alarm Program723435 -Node: Translate Program728290 -Ref: Translate Program-Footnote-1732855 -Node: Labels Program733125 -Ref: Labels Program-Footnote-1736476 -Node: Word Sorting736560 -Node: History Sorting740632 -Node: Extract Program742467 -Node: Simple Sed749996 -Node: Igawk Program753070 -Ref: Igawk Program-Footnote-1767401 -Ref: Igawk Program-Footnote-2767603 -Ref: Igawk Program-Footnote-3767725 -Node: Anagram Program767840 -Node: Signature Program770902 -Node: Programs Summary772149 -Node: Programs Exercises773363 -Ref: Programs Exercises-Footnote-1777492 -Node: Advanced Features777583 -Node: Nondecimal Data779573 -Node: Array Sorting781164 -Node: Controlling Array Traversal781864 -Ref: Controlling Array Traversal-Footnote-1790231 -Node: Array Sorting Functions790349 -Ref: Array Sorting Functions-Footnote-1795440 -Node: Two-way I/O795636 -Ref: Two-way I/O-Footnote-1801930 -Ref: Two-way I/O-Footnote-2802117 -Node: TCP/IP Networking802199 -Node: Profiling805317 -Node: Advanced Features Summary812856 -Node: Internationalization814792 -Node: I18N and L10N816272 -Node: Explaining gettext816959 -Ref: Explaining gettext-Footnote-1821982 -Ref: Explaining gettext-Footnote-2822167 -Node: Programmer i18n822332 -Ref: Programmer i18n-Footnote-1827187 -Node: Translator i18n827236 -Node: String Extraction828030 -Ref: String Extraction-Footnote-1829162 -Node: Printf Ordering829248 -Ref: Printf Ordering-Footnote-1832034 -Node: I18N Portability832098 -Ref: I18N Portability-Footnote-1834554 -Node: I18N Example834617 -Ref: I18N Example-Footnote-1837423 -Node: Gawk I18N837496 -Node: I18N Summary838141 -Node: Debugger839482 -Node: Debugging840504 -Node: Debugging Concepts840945 -Node: Debugging Terms842754 -Node: Awk Debugging845329 -Node: Sample Debugging Session846235 -Node: Debugger Invocation846769 -Node: Finding The Bug848155 -Node: List of Debugger Commands854633 -Node: Breakpoint Control855966 -Node: Debugger Execution Control859660 -Node: Viewing And Changing Data863022 -Node: Execution Stack866396 -Node: Debugger Info868033 -Node: Miscellaneous Debugger Commands872104 -Node: Readline Support877192 -Node: Limitations878088 -Node: Debugging Summary880197 -Node: Arbitrary Precision Arithmetic881370 -Node: Computer Arithmetic882786 -Ref: table-numeric-ranges886377 -Ref: Computer Arithmetic-Footnote-1887099 -Node: Math Definitions887156 -Ref: table-ieee-formats890470 -Ref: Math Definitions-Footnote-1891073 -Node: MPFR features891178 -Node: FP Math Caution892895 -Ref: FP Math Caution-Footnote-1893967 -Node: Inexactness of computations894336 -Node: Inexact representation895296 -Node: Comparing FP Values896656 -Node: Errors accumulate897738 -Node: Getting Accuracy899171 -Node: Try To Round901881 -Node: Setting precision902780 -Ref: table-predefined-precision-strings903477 -Node: Setting the rounding mode905307 -Ref: table-gawk-rounding-modes905681 -Ref: Setting the rounding mode-Footnote-1909089 -Node: Arbitrary Precision Integers909268 -Ref: Arbitrary Precision Integers-Footnote-1912252 -Node: POSIX Floating Point Problems912401 -Ref: POSIX Floating Point Problems-Footnote-1916283 -Node: Floating point summary916321 -Node: Dynamic Extensions918511 -Node: Extension Intro920064 -Node: Plugin License921330 -Node: Extension Mechanism Outline922127 -Ref: figure-load-extension922566 -Ref: figure-register-new-function924131 -Ref: figure-call-new-function925223 -Node: Extension API Description927285 -Node: Extension API Functions Introduction928733 -Node: General Data Types933545 -Ref: General Data Types-Footnote-1939500 -Node: Memory Allocation Functions939799 -Ref: Memory Allocation Functions-Footnote-1942644 -Node: Constructor Functions942743 -Node: Registration Functions944488 -Node: Extension Functions945173 -Node: Exit Callback Functions947472 -Node: Extension Version String948722 -Node: Input Parsers949385 -Node: Output Wrappers959267 -Node: Two-way processors963779 -Node: Printing Messages966044 -Ref: Printing Messages-Footnote-1967118 -Node: Updating ERRNO967271 -Node: Requesting Values968010 -Ref: table-value-types-returned968747 -Node: Accessing Parameters969630 -Node: Symbol Table Access970865 -Node: Symbol table by name971377 -Node: Symbol table by cookie973398 -Ref: Symbol table by cookie-Footnote-1977550 -Node: Cached values977614 -Ref: Cached values-Footnote-1981121 -Node: Array Manipulation981212 -Ref: Array Manipulation-Footnote-1982311 -Node: Array Data Types982348 -Ref: Array Data Types-Footnote-1985006 -Node: Array Functions985098 -Node: Flattening Arrays988956 -Node: Creating Arrays995864 -Node: Extension API Variables1000633 -Node: Extension Versioning1001269 -Ref: gawk-api-version1001706 -Node: Extension API Informational Variables1003462 -Node: Extension API Boilerplate1004526 -Node: Finding Extensions1008340 -Node: Extension Example1008899 -Node: Internal File Description1009697 -Node: Internal File Ops1013777 -Ref: Internal File Ops-Footnote-11025539 -Node: Using Internal File Ops1025679 -Ref: Using Internal File Ops-Footnote-11028062 -Node: Extension Samples1028336 -Node: Extension Sample File Functions1029865 -Node: Extension Sample Fnmatch1037514 -Node: Extension Sample Fork1039001 -Node: Extension Sample Inplace1040219 -Node: Extension Sample Ord1043429 -Node: Extension Sample Readdir1044265 -Ref: table-readdir-file-types1045154 -Node: Extension Sample Revout1045959 -Node: Extension Sample Rev2way1046548 -Node: Extension Sample Read write array1047288 -Node: Extension Sample Readfile1049230 -Node: Extension Sample Time1050325 -Node: Extension Sample API Tests1051673 -Node: gawkextlib1052165 -Node: Extension summary1054589 -Node: Extension Exercises1058281 -Node: Language History1059778 -Node: V7/SVR3.11061434 -Node: SVR41063586 -Node: POSIX1065020 -Node: BTL1066399 -Node: POSIX/GNU1067128 -Node: Feature History1072649 -Node: Common Extensions1085978 -Node: Ranges and Locales1087261 -Ref: Ranges and Locales-Footnote-11091877 -Ref: Ranges and Locales-Footnote-21091904 -Ref: Ranges and Locales-Footnote-31092139 -Node: Contributors1092360 -Node: History summary1097929 -Node: Installation1099309 -Node: Gawk Distribution1100253 -Node: Getting1100737 -Node: Extracting1101698 -Node: Distribution contents1103336 -Node: Unix Installation1109087 -Node: Quick Installation1109703 -Node: Additional Configuration Options1112130 -Node: Configuration Philosophy1113934 -Node: Non-Unix Installation1116303 -Node: PC Installation1116761 -Node: PC Binary Installation1118081 -Node: PC Compiling1119933 -Ref: PC Compiling-Footnote-11122957 -Node: PC Testing1123066 -Node: PC Using1124246 -Node: Cygwin1128360 -Node: MSYS1129130 -Node: VMS Installation1129631 -Node: VMS Compilation1130422 -Ref: VMS Compilation-Footnote-11131651 -Node: VMS Dynamic Extensions1131709 -Node: VMS Installation Details1133394 -Node: VMS Running1135647 -Node: VMS GNV1139926 -Node: VMS Old Gawk1140661 -Node: Bugs1141132 -Node: Other Versions1145329 -Node: Installation summary1151913 -Node: Notes1152971 -Node: Compatibility Mode1153836 -Node: Additions1154618 -Node: Accessing The Source1155543 -Node: Adding Code1156978 -Node: New Ports1163197 -Node: Derived Files1167685 -Ref: Derived Files-Footnote-11173170 -Ref: Derived Files-Footnote-21173205 -Ref: Derived Files-Footnote-31173803 -Node: Future Extensions1173917 -Node: Implementation Limitations1174575 -Node: Extension Design1175758 -Node: Old Extension Problems1176912 -Ref: Old Extension Problems-Footnote-11178430 -Node: Extension New Mechanism Goals1178487 -Ref: Extension New Mechanism Goals-Footnote-11181851 -Node: Extension Other Design Decisions1182040 -Node: Extension Future Growth1184153 -Node: Old Extension Mechanism1184989 -Node: Notes summary1186752 -Node: Basic Concepts1187934 -Node: Basic High Level1188615 -Ref: figure-general-flow1188897 -Ref: figure-process-flow1189582 -Ref: Basic High Level-Footnote-11192883 -Node: Basic Data Typing1193068 -Node: Glossary1196396 -Node: Copying1228342 -Node: GNU Free Documentation License1265881 -Node: Index1290999 +Ref: Auto-set-Footnote-1454638 +Ref: Auto-set-Footnote-2454844 +Node: ARGC and ARGV454900 +Node: Pattern Action Summary459113 +Node: Arrays461543 +Node: Array Basics462872 +Node: Array Intro463716 +Ref: figure-array-elements465691 +Ref: Array Intro-Footnote-1468395 +Node: Reference to Elements468523 +Node: Assigning Elements470987 +Node: Array Example471478 +Node: Scanning an Array473237 +Node: Controlling Scanning476259 +Ref: Controlling Scanning-Footnote-1481658 +Node: Numeric Array Subscripts481974 +Node: Uninitialized Subscripts484158 +Node: Delete485777 +Ref: Delete-Footnote-1488529 +Node: Multidimensional488586 +Node: Multiscanning491681 +Node: Arrays of Arrays493272 +Node: Arrays Summary498039 +Node: Functions500132 +Node: Built-in501170 +Node: Calling Built-in502251 +Node: Numeric Functions504247 +Ref: Numeric Functions-Footnote-1508275 +Ref: Numeric Functions-Footnote-2508632 +Ref: Numeric Functions-Footnote-3508680 +Node: String Functions508952 +Ref: String Functions-Footnote-1532456 +Ref: String Functions-Footnote-2532584 +Ref: String Functions-Footnote-3532832 +Node: Gory Details532919 +Ref: table-sub-escapes534710 +Ref: table-sub-proposed536229 +Ref: table-posix-sub537592 +Ref: table-gensub-escapes539133 +Ref: Gory Details-Footnote-1539956 +Node: I/O Functions540110 +Ref: table-system-return-values546692 +Ref: I/O Functions-Footnote-1548672 +Ref: I/O Functions-Footnote-2548820 +Node: Time Functions548940 +Ref: Time Functions-Footnote-1559445 +Ref: Time Functions-Footnote-2559513 +Ref: Time Functions-Footnote-3559671 +Ref: Time Functions-Footnote-4559782 +Ref: Time Functions-Footnote-5559894 +Ref: Time Functions-Footnote-6560121 +Node: Bitwise Functions560387 +Ref: table-bitwise-ops560981 +Ref: Bitwise Functions-Footnote-1565319 +Node: Type Functions565492 +Node: I18N Functions566648 +Node: User-defined568299 +Node: Definition Syntax569104 +Ref: Definition Syntax-Footnote-1574791 +Node: Function Example574862 +Ref: Function Example-Footnote-1577784 +Node: Function Caveats577806 +Node: Calling A Function578324 +Node: Variable Scope579282 +Node: Pass By Value/Reference582276 +Node: Return Statement585775 +Node: Dynamic Typing588754 +Node: Indirect Calls589684 +Ref: Indirect Calls-Footnote-1599935 +Node: Functions Summary600063 +Node: Library Functions602768 +Ref: Library Functions-Footnote-1606375 +Ref: Library Functions-Footnote-2606518 +Node: Library Names606689 +Ref: Library Names-Footnote-1610149 +Ref: Library Names-Footnote-2610372 +Node: General Functions610458 +Node: Strtonum Function611561 +Node: Assert Function614583 +Node: Round Function617909 +Node: Cliff Random Function619450 +Node: Ordinal Functions620466 +Ref: Ordinal Functions-Footnote-1623529 +Ref: Ordinal Functions-Footnote-2623781 +Node: Join Function623991 +Ref: Join Function-Footnote-1625761 +Node: Getlocaltime Function625961 +Node: Readfile Function629703 +Node: Shell Quoting631675 +Node: Data File Management633076 +Node: Filetrans Function633708 +Node: Rewind Function637804 +Node: File Checking639709 +Ref: File Checking-Footnote-1641043 +Node: Empty Files641244 +Node: Ignoring Assigns643223 +Node: Getopt Function644773 +Ref: Getopt Function-Footnote-1656242 +Node: Passwd Functions656442 +Ref: Passwd Functions-Footnote-1665281 +Node: Group Functions665369 +Ref: Group Functions-Footnote-1673266 +Node: Walking Arrays673473 +Node: Library Functions Summary676481 +Node: Library Exercises677887 +Node: Sample Programs678352 +Node: Running Examples679122 +Node: Clones679850 +Node: Cut Program681074 +Node: Egrep Program691003 +Ref: Egrep Program-Footnote-1698515 +Node: Id Program698625 +Node: Split Program702305 +Ref: Split Program-Footnote-1705764 +Node: Tee Program705893 +Node: Uniq Program708683 +Node: Wc Program716109 +Ref: Wc Program-Footnote-1720364 +Node: Miscellaneous Programs720458 +Node: Dupword Program721671 +Node: Alarm Program723701 +Node: Translate Program728556 +Ref: Translate Program-Footnote-1733121 +Node: Labels Program733391 +Ref: Labels Program-Footnote-1736742 +Node: Word Sorting736826 +Node: History Sorting740898 +Node: Extract Program742733 +Node: Simple Sed750262 +Node: Igawk Program753336 +Ref: Igawk Program-Footnote-1767667 +Ref: Igawk Program-Footnote-2767869 +Ref: Igawk Program-Footnote-3767991 +Node: Anagram Program768106 +Node: Signature Program771168 +Node: Programs Summary772415 +Node: Programs Exercises773629 +Ref: Programs Exercises-Footnote-1777758 +Node: Advanced Features777849 +Node: Nondecimal Data779839 +Node: Array Sorting781430 +Node: Controlling Array Traversal782130 +Ref: Controlling Array Traversal-Footnote-1790497 +Node: Array Sorting Functions790615 +Ref: Array Sorting Functions-Footnote-1795706 +Node: Two-way I/O795902 +Ref: Two-way I/O-Footnote-1802196 +Ref: Two-way I/O-Footnote-2802383 +Node: TCP/IP Networking802465 +Node: Profiling805583 +Node: Advanced Features Summary813122 +Node: Internationalization815058 +Node: I18N and L10N816538 +Node: Explaining gettext817225 +Ref: Explaining gettext-Footnote-1822248 +Ref: Explaining gettext-Footnote-2822433 +Node: Programmer i18n822598 +Ref: Programmer i18n-Footnote-1827453 +Node: Translator i18n827502 +Node: String Extraction828296 +Ref: String Extraction-Footnote-1829428 +Node: Printf Ordering829514 +Ref: Printf Ordering-Footnote-1832300 +Node: I18N Portability832364 +Ref: I18N Portability-Footnote-1834820 +Node: I18N Example834883 +Ref: I18N Example-Footnote-1837689 +Node: Gawk I18N837762 +Node: I18N Summary838407 +Node: Debugger839748 +Node: Debugging840770 +Node: Debugging Concepts841211 +Node: Debugging Terms843020 +Node: Awk Debugging845595 +Node: Sample Debugging Session846501 +Node: Debugger Invocation847035 +Node: Finding The Bug848421 +Node: List of Debugger Commands854899 +Node: Breakpoint Control856232 +Node: Debugger Execution Control859926 +Node: Viewing And Changing Data863288 +Node: Execution Stack866662 +Node: Debugger Info868299 +Node: Miscellaneous Debugger Commands872370 +Node: Readline Support877458 +Node: Limitations878354 +Node: Debugging Summary880463 +Node: Arbitrary Precision Arithmetic881636 +Node: Computer Arithmetic883052 +Ref: table-numeric-ranges886643 +Ref: Computer Arithmetic-Footnote-1887365 +Node: Math Definitions887422 +Ref: table-ieee-formats890736 +Ref: Math Definitions-Footnote-1891339 +Node: MPFR features891444 +Node: FP Math Caution893161 +Ref: FP Math Caution-Footnote-1894233 +Node: Inexactness of computations894602 +Node: Inexact representation895562 +Node: Comparing FP Values896922 +Node: Errors accumulate898004 +Node: Getting Accuracy899437 +Node: Try To Round902147 +Node: Setting precision903046 +Ref: table-predefined-precision-strings903743 +Node: Setting the rounding mode905573 +Ref: table-gawk-rounding-modes905947 +Ref: Setting the rounding mode-Footnote-1909355 +Node: Arbitrary Precision Integers909534 +Ref: Arbitrary Precision Integers-Footnote-1912518 +Node: POSIX Floating Point Problems912667 +Ref: POSIX Floating Point Problems-Footnote-1916549 +Node: Floating point summary916587 +Node: Dynamic Extensions918777 +Node: Extension Intro920330 +Node: Plugin License921596 +Node: Extension Mechanism Outline922393 +Ref: figure-load-extension922832 +Ref: figure-register-new-function924397 +Ref: figure-call-new-function925489 +Node: Extension API Description927551 +Node: Extension API Functions Introduction928999 +Node: General Data Types933811 +Ref: General Data Types-Footnote-1939766 +Node: Memory Allocation Functions940065 +Ref: Memory Allocation Functions-Footnote-1942910 +Node: Constructor Functions943009 +Node: Registration Functions944754 +Node: Extension Functions945439 +Node: Exit Callback Functions947738 +Node: Extension Version String948988 +Node: Input Parsers949651 +Node: Output Wrappers959533 +Node: Two-way processors964045 +Node: Printing Messages966310 +Ref: Printing Messages-Footnote-1967384 +Node: Updating ERRNO967537 +Node: Requesting Values968276 +Ref: table-value-types-returned969013 +Node: Accessing Parameters969896 +Node: Symbol Table Access971131 +Node: Symbol table by name971643 +Node: Symbol table by cookie973664 +Ref: Symbol table by cookie-Footnote-1977816 +Node: Cached values977880 +Ref: Cached values-Footnote-1981387 +Node: Array Manipulation981478 +Ref: Array Manipulation-Footnote-1982577 +Node: Array Data Types982614 +Ref: Array Data Types-Footnote-1985272 +Node: Array Functions985364 +Node: Flattening Arrays989222 +Node: Creating Arrays996130 +Node: Extension API Variables1000899 +Node: Extension Versioning1001535 +Ref: gawk-api-version1001972 +Node: Extension API Informational Variables1003728 +Node: Extension API Boilerplate1004792 +Node: Finding Extensions1008606 +Node: Extension Example1009165 +Node: Internal File Description1009963 +Node: Internal File Ops1014043 +Ref: Internal File Ops-Footnote-11025805 +Node: Using Internal File Ops1025945 +Ref: Using Internal File Ops-Footnote-11028328 +Node: Extension Samples1028602 +Node: Extension Sample File Functions1030131 +Node: Extension Sample Fnmatch1037780 +Node: Extension Sample Fork1039267 +Node: Extension Sample Inplace1040485 +Node: Extension Sample Ord1043695 +Node: Extension Sample Readdir1044531 +Ref: table-readdir-file-types1045420 +Node: Extension Sample Revout1046225 +Node: Extension Sample Rev2way1046814 +Node: Extension Sample Read write array1047554 +Node: Extension Sample Readfile1049496 +Node: Extension Sample Time1050591 +Node: Extension Sample API Tests1051939 +Node: gawkextlib1052431 +Node: Extension summary1054855 +Node: Extension Exercises1058547 +Node: Language History1060044 +Node: V7/SVR3.11061700 +Node: SVR41063852 +Node: POSIX1065286 +Node: BTL1066665 +Node: POSIX/GNU1067394 +Node: Feature History1072915 +Node: Common Extensions1086244 +Node: Ranges and Locales1087527 +Ref: Ranges and Locales-Footnote-11092143 +Ref: Ranges and Locales-Footnote-21092170 +Ref: Ranges and Locales-Footnote-31092405 +Node: Contributors1092626 +Node: History summary1098195 +Node: Installation1099575 +Node: Gawk Distribution1100519 +Node: Getting1101003 +Node: Extracting1101964 +Node: Distribution contents1103602 +Node: Unix Installation1109353 +Node: Quick Installation1109969 +Node: Additional Configuration Options1112396 +Node: Configuration Philosophy1114200 +Node: Non-Unix Installation1116569 +Node: PC Installation1117027 +Node: PC Binary Installation1118347 +Node: PC Compiling1120199 +Ref: PC Compiling-Footnote-11123223 +Node: PC Testing1123332 +Node: PC Using1124512 +Node: Cygwin1128626 +Node: MSYS1129396 +Node: VMS Installation1129897 +Node: VMS Compilation1130688 +Ref: VMS Compilation-Footnote-11131917 +Node: VMS Dynamic Extensions1131975 +Node: VMS Installation Details1133660 +Node: VMS Running1135913 +Node: VMS GNV1140192 +Node: VMS Old Gawk1140927 +Node: Bugs1141398 +Node: Other Versions1145595 +Node: Installation summary1152179 +Node: Notes1153237 +Node: Compatibility Mode1154102 +Node: Additions1154884 +Node: Accessing The Source1155809 +Node: Adding Code1157244 +Node: New Ports1163463 +Node: Derived Files1167951 +Ref: Derived Files-Footnote-11173436 +Ref: Derived Files-Footnote-21173471 +Ref: Derived Files-Footnote-31174069 +Node: Future Extensions1174183 +Node: Implementation Limitations1174841 +Node: Extension Design1176024 +Node: Old Extension Problems1177178 +Ref: Old Extension Problems-Footnote-11178696 +Node: Extension New Mechanism Goals1178753 +Ref: Extension New Mechanism Goals-Footnote-11182117 +Node: Extension Other Design Decisions1182306 +Node: Extension Future Growth1184419 +Node: Old Extension Mechanism1185255 +Node: Notes summary1187018 +Node: Basic Concepts1188200 +Node: Basic High Level1188881 +Ref: figure-general-flow1189163 +Ref: figure-process-flow1189848 +Ref: Basic High Level-Footnote-11193149 +Node: Basic Data Typing1193334 +Node: Glossary1196662 +Node: Copying1228608 +Node: GNU Free Documentation License1266147 +Node: Index1291265 End Tag Table diff --git a/doc/gawk.texi b/doc/gawk.texi index 92cb57dc..6b2cf3cf 100644 --- a/doc/gawk.texi +++ b/doc/gawk.texi @@ -15119,9 +15119,28 @@ function multiply(variable, amount) @} @end example +@noindent +You would use it like this: + +@example +BEGIN @{ + answer = 10.5 + multiply("answer", 4) + print "The answer is", answer +@} +@end example + +@noindent +When run, this produces: + +@example +$ @kbd{gawk -f answer.awk} +@print{} The answer is 42 +@end example + @quotation NOTE -In order to avoid severe time-travel paradoxes,@footnote{Not to mention difficult -implementation issues.} neither @code{FUNCTAB} nor @code{SYMTAB} +In order to avoid severe time-travel paradoxes,@footnote{Not to mention +difficult implementation issues.} neither @code{FUNCTAB} nor @code{SYMTAB} is available as an element within the @code{SYMTAB} array. @end quotation @end table diff --git a/doc/gawktexi.in b/doc/gawktexi.in index d06fa4b9..6bf97aec 100644 --- a/doc/gawktexi.in +++ b/doc/gawktexi.in @@ -14447,9 +14447,28 @@ function multiply(variable, amount) @} @end example +@noindent +You would use it like this: + +@example +BEGIN @{ + answer = 10.5 + multiply("answer", 4) + print "The answer is", answer +@} +@end example + +@noindent +When run, this produces: + +@example +$ @kbd{gawk -f answer.awk} +@print{} The answer is 42 +@end example + @quotation NOTE -In order to avoid severe time-travel paradoxes,@footnote{Not to mention difficult -implementation issues.} neither @code{FUNCTAB} nor @code{SYMTAB} +In order to avoid severe time-travel paradoxes,@footnote{Not to mention +difficult implementation issues.} neither @code{FUNCTAB} nor @code{SYMTAB} is available as an element within the @code{SYMTAB} array. @end quotation @end table |