[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[gawk-diffs] [SCM] gawk branch, gawk-4.1-stable, updated. gawk-4.1.0-933

From: Arnold Robbins
Subject: [gawk-diffs] [SCM] gawk branch, gawk-4.1-stable, updated. gawk-4.1.0-933-g1bf8cb3
Date: Tue, 12 Jul 2016 02:46:47 +0000 (UTC)

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "gawk".

The branch, gawk-4.1-stable has been updated
       via  1bf8cb336c599fdd14a2c37d719f7c8879dd830a (commit)
      from  c5c3cc18943913fb91a15d372a0d949d6436d0a7 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------

commit 1bf8cb336c599fdd14a2c37d719f7c8879dd830a
Author: Arnold D. Robbins <address@hidden>
Date:   Tue Jul 12 05:46:28 2016 +0300

    Improve doc on use of SYMTAB.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 32f4ecb..24929ef 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+2016-07-12         Arnold D. Robbins     <address@hidden>
+       * (Auto-set): Add example use of multiply function.
 2016-06-10         Arnold D. Robbins     <address@hidden>
        * Fix a typo, and replace hard-coded "section" with
diff --git a/doc/ b/doc/
index e286976..fab2203 100644
--- a/doc/
+++ b/doc/
@@ -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 92cb57d..6b2cf3c 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -15119,9 +15119,28 @@ function multiply(variable, amount)
 @end example
+You would use it like this:
+    answer = 10.5
+    multiply("answer", 4)
+    print "The answer is", answer
address@hidden example
+When run, this produces:
+$ @kbd{gawk -f answer.awk}
address@hidden The answer is 42
address@hidden example
 @quotation NOTE
-In order to avoid severe time-travel paradoxes,@footnote{Not to mention 
-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/ b/doc/
index d06fa4b..6bf97ae 100644
--- a/doc/
+++ b/doc/
@@ -14447,9 +14447,28 @@ function multiply(variable, amount)
 @end example
+You would use it like this:
+    answer = 10.5
+    multiply("answer", 4)
+    print "The answer is", answer
address@hidden example
+When run, this produces:
+$ @kbd{gawk -f answer.awk}
address@hidden The answer is 42
address@hidden example
 @quotation NOTE
-In order to avoid severe time-travel paradoxes,@footnote{Not to mention 
-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


Summary of changes:
 doc/ChangeLog   |    4 +
 doc/   |  733 ++++++++++++++++++++++++++++---------------------------
 doc/gawk.texi   |   23 +-
 doc/ |   23 +-
 4 files changed, 419 insertions(+), 364 deletions(-)


reply via email to

[Prev in Thread] Current Thread [Next in Thread]