[Top][All Lists]

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

[SCM] gawk branch, master, updated. gawk-4.1.0-3900-g61838f2

From: Arnold Robbins
Subject: [SCM] gawk branch, master, updated. gawk-4.1.0-3900-g61838f2
Date: Wed, 4 Mar 2020 06:36:42 -0500 (EST)

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, master has been updated
       via  61838f25587d50e864afe21308d20bdb46b9324e (commit)
      from  b80124d7d5073b195d56302f5d78f463edd581e9 (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 61838f25587d50e864afe21308d20bdb46b9324e
Author: Arnold D. Robbins <address@hidden>
Date:   Wed Mar 4 04:35:18 2020 -0700

    Doc update.

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 01ee092..3444c58 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,8 @@
+2020-03-03         Arnold D. Robbins     <address@hidden>
+       * Revised info on default values for AWKPATH
+       and AWKLIBPATH. Thanks to Jannick for the push.
 2020-02-02         Arnold D. Robbins     <address@hidden>
        * (Getopt Function): Add support for long options,
diff --git a/doc/ b/doc/
index ed11747..2ad4e19 100644
--- a/doc/
+++ b/doc/
@@ -3066,8 +3066,10 @@ been found, and 'gawk' no longer needs to use 'AWKPATH'.
    (2) Your version of 'gawk' may use a different directory; it will
 depend upon how 'gawk' was built and installed.  The actual directory is
-the value of '$(datadir)' generated when 'gawk' was configured.  You
-probably don't need to worry about this, though.
+the value of '$(pkgdatadir)' generated when 'gawk' was configured.  (For
+more detail, see the 'INSTALL' file in the source distribution, and see
+*note Quick Installation::.  You probably don't need to worry about
+this, though.)
 File:,  Node: AWKLIBPATH Variable,  Next: Other Environment 
Variables,  Prev: AWKPATH Variable,  Up: Environment Variables
@@ -3087,7 +3089,7 @@ keyword (*note Loading Shared Libraries::).
    If 'AWKLIBPATH' does not exist in the environment, or if it has an
 empty value, 'gawk' uses a default path; this is typically
 '/usr/local/lib/gawk', although it can vary depending upon how 'gawk'
-was built.
+was built.(1)
    *Note Shell Startup Files::, for information on functions that help
 to manipulate the 'AWKLIBPATH' variable.
@@ -3103,6 +3105,15 @@ requested extensions, and they are loaded before the 
program starts to
 run.  Once your program is running, all the extensions have been found,
 and 'gawk' no longer needs to use 'AWKLIBPATH'.
+   ---------- Footnotes ----------
+   (1) Your version of 'gawk' may use a different directory; it will
+depend upon how 'gawk' was built and installed.  The actual directory is
+the value of '$(pkgextensiondir)' generated when 'gawk' was configured.
+(For more detail, see the 'INSTALL' file in the source distribution, and
+see *note Quick Installation::.  You probably don't need to worry about
+this, though.)
 File:,  Node: Other Environment Variables,  Prev: AWKLIBPATH 
Variable,  Up: Environment Variables
@@ -37266,550 +37277,551 @@ Node: Environment Variables141818
 Node: AWKPATH Variable142376
 Ref: AWKPATH Variable-Footnote-1145788
 Ref: AWKPATH Variable-Footnote-2145822
-Node: AWKLIBPATH Variable146083
-Node: Other Environment Variables147741
-Node: Exit Status151562
-Node: Include Files152239
-Node: Loading Shared Libraries155929
-Node: Obsolete157357
-Node: Undocumented158049
-Node: Invoking Summary158346
-Node: Regexp161187
-Node: Regexp Usage162641
-Node: Escape Sequences164678
-Node: Regexp Operators170919
-Node: Regexp Operator Details171404
-Ref: Regexp Operator Details-Footnote-1177836
-Node: Interval Expressions177983
-Ref: Interval Expressions-Footnote-1179404
-Node: Bracket Expressions179502
-Ref: table-char-classes181978
-Node: Leftmost Longest185304
-Node: Computed Regexps186607
-Node: GNU Regexp Operators190034
-Node: Case-sensitivity193713
-Ref: Case-sensitivity-Footnote-1196579
-Ref: Case-sensitivity-Footnote-2196814
-Node: Regexp Summary196922
-Node: Reading Files198388
-Node: Records200657
-Node: awk split records201732
-Node: gawk split records207007
-Ref: gawk split records-Footnote-1211740
-Node: Fields211777
-Node: Nonconstant Fields214518
-Ref: Nonconstant Fields-Footnote-1216754
-Node: Changing Fields216958
-Node: Field Separators222989
-Node: Default Field Splitting225687
-Node: Regexp Field Splitting226805
-Node: Single Character Fields230158
-Node: Command Line Field Separator231218
-Node: Full Line Fields234436
-Ref: Full Line Fields-Footnote-1235958
-Ref: Full Line Fields-Footnote-2236004
-Node: Field Splitting Summary236105
-Node: Constant Size238179
-Node: Fixed width data238911
-Node: Skipping intervening242378
-Node: Allowing trailing data243176
-Node: Fields with fixed data244213
-Node: Splitting By Content245731
-Ref: Splitting By Content-Footnote-1249381
-Node: Testing field creation249544
-Node: Multiple Line251169
-Node: Getline257446
-Node: Plain Getline259915
-Node: Getline/Variable262488
-Node: Getline/File263639
-Node: Getline/Variable/File265027
-Ref: Getline/Variable/File-Footnote-1266632
-Node: Getline/Pipe266720
-Node: Getline/Variable/Pipe269424
-Node: Getline/Coprocess270559
-Node: Getline/Variable/Coprocess271826
-Node: Getline Notes272568
-Node: Getline Summary275365
-Ref: table-getline-variants275789
-Node: Read Timeout276537
-Ref: Read Timeout-Footnote-1280443
-Node: Retrying Input280501
-Node: Command-line directories281700
-Node: Input Summary282606
-Node: Input Exercises285778
-Node: Printing286212
-Node: Print288046
-Node: Print Examples289503
-Node: Output Separators292283
-Node: OFMT294300
-Node: Printf295656
-Node: Basic Printf296441
-Node: Control Letters298015
-Node: Format Modifiers303179
-Node: Printf Examples309194
-Node: Redirection311680
-Node: Special FD318521
-Ref: Special FD-Footnote-1321689
-Node: Special Files321763
-Node: Other Inherited Files322380
-Node: Special Network323381
-Node: Special Caveats324241
-Node: Close Files And Pipes325190
-Ref: table-close-pipe-return-values332097
-Ref: Close Files And Pipes-Footnote-1332910
-Ref: Close Files And Pipes-Footnote-2333058
-Node: Nonfatal333210
-Node: Output Summary335548
-Node: Output Exercises336770
-Node: Expressions337449
-Node: Values338637
-Node: Constants339315
-Node: Scalar Constants340006
-Ref: Scalar Constants-Footnote-1342530
-Node: Nondecimal-numbers342780
-Node: Regexp Constants345781
-Node: Using Constant Regexps346307
-Node: Standard Regexp Constants346929
-Node: Strong Regexp Constants350117
-Node: Variables353075
-Node: Using Variables353732
-Node: Assignment Options355642
-Node: Conversion358113
-Node: Strings And Numbers358637
-Ref: Strings And Numbers-Footnote-1361700
-Node: Locale influences conversions361809
-Ref: table-locale-affects364567
-Node: All Operators365185
-Node: Arithmetic Ops365814
-Node: Concatenation368320
-Ref: Concatenation-Footnote-1371167
-Node: Assignment Ops371274
-Ref: table-assign-ops376265
-Node: Increment Ops377578
-Node: Truth Values and Conditions381038
-Node: Truth Values382112
-Node: Typing and Comparison383160
-Node: Variable Typing383980
-Ref: Variable Typing-Footnote-1390443
-Ref: Variable Typing-Footnote-2390515
-Node: Comparison Operators390592
-Ref: table-relational-ops391011
-Node: POSIX String Comparison394506
-Ref: POSIX String Comparison-Footnote-1396201
-Ref: POSIX String Comparison-Footnote-2396340
-Node: Boolean Ops396424
-Ref: Boolean Ops-Footnote-1400906
-Node: Conditional Exp400998
-Node: Function Calls402734
-Node: Precedence406611
-Node: Locales410270
-Node: Expressions Summary411902
-Node: Patterns and Actions414475
-Node: Pattern Overview415595
-Node: Regexp Patterns417272
-Node: Expression Patterns417814
-Node: Ranges421595
-Node: BEGIN/END424703
-Node: Using BEGIN/END425464
-Ref: Using BEGIN/END-Footnote-1428200
-Node: I/O And BEGIN/END428306
-Node: Empty433533
-Node: Using Shell Variables433850
-Node: Action Overview436124
-Node: Statements438449
-Node: If Statement440297
-Node: While Statement441792
-Node: Do Statement443820
-Node: For Statement444968
-Node: Switch Statement448139
-Node: Break Statement450525
-Node: Continue Statement452617
-Node: Next Statement454444
-Node: Nextfile Statement456827
-Node: Exit Statement459479
-Node: Built-in Variables461882
-Node: User-modified463015
-Node: Auto-set470782
-Ref: Auto-set-Footnote-1487589
-Ref: Auto-set-Footnote-2487795
-Node: ARGC and ARGV487851
-Node: Pattern Action Summary492064
-Node: Arrays494494
-Node: Array Basics495823
-Node: Array Intro496667
-Ref: figure-array-elements498642
-Ref: Array Intro-Footnote-1501346
-Node: Reference to Elements501474
-Node: Assigning Elements503938
-Node: Array Example504429
-Node: Scanning an Array506188
-Node: Controlling Scanning509210
-Ref: Controlling Scanning-Footnote-1514910
-Node: Numeric Array Subscripts515226
-Node: Uninitialized Subscripts517410
-Node: Delete519029
-Ref: Delete-Footnote-1521781
-Node: Multidimensional521838
-Node: Multiscanning524933
-Node: Arrays of Arrays526524
-Node: Arrays Summary531292
-Node: Functions533385
-Node: Built-in534423
-Node: Calling Built-in535504
-Node: Numeric Functions537500
-Ref: Numeric Functions-Footnote-1541528
-Ref: Numeric Functions-Footnote-2542176
-Ref: Numeric Functions-Footnote-3542224
-Node: String Functions542496
-Ref: String Functions-Footnote-1566680
-Ref: String Functions-Footnote-2566808
-Ref: String Functions-Footnote-3567056
-Node: Gory Details567143
-Ref: table-sub-escapes568934
-Ref: table-sub-proposed570453
-Ref: table-posix-sub571816
-Ref: table-gensub-escapes573357
-Ref: Gory Details-Footnote-1574180
-Node: I/O Functions574334
-Ref: table-system-return-values580802
-Ref: I/O Functions-Footnote-1582882
-Ref: I/O Functions-Footnote-2583030
-Node: Time Functions583150
-Ref: Time Functions-Footnote-1593821
-Ref: Time Functions-Footnote-2593889
-Ref: Time Functions-Footnote-3594047
-Ref: Time Functions-Footnote-4594158
-Ref: Time Functions-Footnote-5594270
-Ref: Time Functions-Footnote-6594497
-Node: Bitwise Functions594763
-Ref: table-bitwise-ops595357
-Ref: Bitwise Functions-Footnote-1601420
-Ref: Bitwise Functions-Footnote-2601593
-Node: Type Functions601784
-Node: I18N Functions604647
-Node: User-defined606298
-Node: Definition Syntax607110
-Ref: Definition Syntax-Footnote-1612797
-Node: Function Example612868
-Ref: Function Example-Footnote-1615790
-Node: Function Calling615812
-Node: Calling A Function616400
-Node: Variable Scope617358
-Node: Pass By Value/Reference620352
-Node: Function Caveats622996
-Ref: Function Caveats-Footnote-1625043
-Node: Return Statement625163
-Node: Dynamic Typing628142
-Node: Indirect Calls629072
-Ref: Indirect Calls-Footnote-1639324
-Node: Functions Summary639452
-Node: Library Functions642157
-Ref: Library Functions-Footnote-1645764
-Ref: Library Functions-Footnote-2645907
-Node: Library Names646078
-Ref: Library Names-Footnote-1649745
-Ref: Library Names-Footnote-2649968
-Node: General Functions650054
-Node: Strtonum Function651157
-Node: Assert Function654179
-Node: Round Function657505
-Node: Cliff Random Function659045
-Node: Ordinal Functions660061
-Ref: Ordinal Functions-Footnote-1663124
-Ref: Ordinal Functions-Footnote-2663376
-Node: Join Function663586
-Ref: Join Function-Footnote-1665356
-Node: Getlocaltime Function665556
-Node: Readfile Function669298
-Node: Shell Quoting671275
-Node: Data File Management672676
-Node: Filetrans Function673308
-Node: Rewind Function677404
-Node: File Checking679313
-Ref: File Checking-Footnote-1680647
-Node: Empty Files680848
-Node: Ignoring Assigns682827
-Node: Getopt Function684377
-Ref: Getopt Function-Footnote-1699591
-Node: Passwd Functions699791
-Ref: Passwd Functions-Footnote-1708630
-Node: Group Functions708718
-Ref: Group Functions-Footnote-1716616
-Node: Walking Arrays716823
-Node: Library Functions Summary719831
-Node: Library Exercises721237
-Node: Sample Programs721702
-Node: Running Examples722472
-Node: Clones723200
-Node: Cut Program724424
-Node: Egrep Program734353
-Ref: Egrep Program-Footnote-1741865
-Node: Id Program741975
-Node: Split Program745655
-Ref: Split Program-Footnote-1749113
-Node: Tee Program749242
-Node: Uniq Program752032
-Node: Wc Program759653
-Ref: Wc Program-Footnote-1763908
-Node: Miscellaneous Programs764002
-Node: Dupword Program765215
-Node: Alarm Program767245
-Node: Translate Program772100
-Ref: Translate Program-Footnote-1776665
-Node: Labels Program776935
-Ref: Labels Program-Footnote-1780286
-Node: Word Sorting780370
-Node: History Sorting784442
-Node: Extract Program786667
-Node: Simple Sed794721
-Node: Igawk Program797795
-Ref: Igawk Program-Footnote-1812126
-Ref: Igawk Program-Footnote-2812328
-Ref: Igawk Program-Footnote-3812450
-Node: Anagram Program812565
-Node: Signature Program815627
-Node: Programs Summary816874
-Node: Programs Exercises818088
-Ref: Programs Exercises-Footnote-1822217
-Node: Advanced Features822308
-Node: Nondecimal Data824298
-Node: Array Sorting825889
-Node: Controlling Array Traversal826589
-Ref: Controlling Array Traversal-Footnote-1834957
-Node: Array Sorting Functions835075
-Ref: Array Sorting Functions-Footnote-1840166
-Node: Two-way I/O840362
-Ref: Two-way I/O-Footnote-1848083
-Ref: Two-way I/O-Footnote-2848270
-Node: TCP/IP Networking848352
-Node: Profiling851470
-Node: Advanced Features Summary860485
-Node: Internationalization862329
-Node: I18N and L10N863809
-Node: Explaining gettext864496
-Ref: Explaining gettext-Footnote-1870388
-Ref: Explaining gettext-Footnote-2870573
-Node: Programmer i18n870738
-Ref: Programmer i18n-Footnote-1875687
-Node: Translator i18n875736
-Node: String Extraction876530
-Ref: String Extraction-Footnote-1877662
-Node: Printf Ordering877748
-Ref: Printf Ordering-Footnote-1880534
-Node: I18N Portability880598
-Ref: I18N Portability-Footnote-1883054
-Node: I18N Example883117
-Ref: I18N Example-Footnote-1886392
-Ref: I18N Example-Footnote-2886465
-Node: Gawk I18N886574
-Node: I18N Summary887223
-Node: Debugger888564
-Node: Debugging889564
-Node: Debugging Concepts890005
-Node: Debugging Terms891814
-Node: Awk Debugging894389
-Ref: Awk Debugging-Footnote-1895334
-Node: Sample Debugging Session895466
-Node: Debugger Invocation896000
-Node: Finding The Bug897386
-Node: List of Debugger Commands903860
-Node: Breakpoint Control905193
-Node: Debugger Execution Control908887
-Node: Viewing And Changing Data912249
-Node: Execution Stack915790
-Node: Debugger Info917427
-Node: Miscellaneous Debugger Commands921498
-Node: Readline Support926560
-Node: Limitations927456
-Node: Debugging Summary930010
-Node: Namespaces931289
-Node: Global Namespace932400
-Node: Qualified Names933798
-Node: Default Namespace934797
-Node: Changing The Namespace935538
-Node: Naming Rules937152
-Node: Internal Name Management939000
-Node: Namespace Example940042
-Node: Namespace And Features942604
-Node: Namespace Summary944039
-Node: Arbitrary Precision Arithmetic945516
-Node: Computer Arithmetic947003
-Ref: table-numeric-ranges950769
-Ref: table-floating-point-ranges951262
-Ref: Computer Arithmetic-Footnote-1951920
-Node: Math Definitions951977
-Ref: table-ieee-formats955293
-Ref: Math Definitions-Footnote-1955896
-Node: MPFR features956001
-Node: FP Math Caution957719
-Ref: FP Math Caution-Footnote-1958791
-Node: Inexactness of computations959160
-Node: Inexact representation960120
-Node: Comparing FP Values961480
-Node: Errors accumulate962721
-Node: Getting Accuracy964154
-Node: Try To Round966864
-Node: Setting precision967763
-Ref: table-predefined-precision-strings968460
-Node: Setting the rounding mode970290
-Ref: table-gawk-rounding-modes970664
-Ref: Setting the rounding mode-Footnote-1974595
-Node: Arbitrary Precision Integers974774
-Ref: Arbitrary Precision Integers-Footnote-1977949
-Node: Checking for MPFR978098
-Node: POSIX Floating Point Problems979572
-Ref: POSIX Floating Point Problems-Footnote-1983857
-Node: Floating point summary983895
-Node: Dynamic Extensions986085
-Node: Extension Intro987638
-Node: Plugin License988904
-Node: Extension Mechanism Outline989701
-Ref: figure-load-extension990140
-Ref: figure-register-new-function991705
-Ref: figure-call-new-function992797
-Node: Extension API Description994859
-Node: Extension API Functions Introduction996501
-Ref: table-api-std-headers998337
-Node: General Data Types1002202
-Ref: General Data Types-Footnote-11010563
-Node: Memory Allocation Functions1010862
-Ref: Memory Allocation Functions-Footnote-11015072
-Node: Constructor Functions1015171
-Node: Registration Functions1018757
-Node: Extension Functions1019442
-Node: Exit Callback Functions1024764
-Node: Extension Version String1026014
-Node: Input Parsers1026677
-Node: Output Wrappers1039398
-Node: Two-way processors1043910
-Node: Printing Messages1046175
-Ref: Printing Messages-Footnote-11047346
-Node: Updating ERRNO1047499
-Node: Requesting Values1048238
-Ref: table-value-types-returned1048975
-Node: Accessing Parameters1049911
-Node: Symbol Table Access1051146
-Node: Symbol table by name1051658
-Ref: Symbol table by name-Footnote-11054682
-Node: Symbol table by cookie1054810
-Ref: Symbol table by cookie-Footnote-11058995
-Node: Cached values1059059
-Ref: Cached values-Footnote-11062595
-Node: Array Manipulation1062748
-Ref: Array Manipulation-Footnote-11063839
-Node: Array Data Types1063876
-Ref: Array Data Types-Footnote-11066534
-Node: Array Functions1066626
-Node: Flattening Arrays1071124
-Node: Creating Arrays1078100
-Node: Redirection API1082867
-Node: Extension API Variables1085700
-Node: Extension Versioning1086411
-Ref: gawk-api-version1086840
-Node: Extension GMP/MPFR Versioning1088571
-Node: Extension API Informational Variables1090199
-Node: Extension API Boilerplate1091272
-Node: Changes from API V11095246
-Node: Finding Extensions1096818
-Node: Extension Example1097377
-Node: Internal File Description1098175
-Node: Internal File Ops1102255
-Ref: Internal File Ops-Footnote-11113605
-Node: Using Internal File Ops1113745
-Ref: Using Internal File Ops-Footnote-11116128
-Node: Extension Samples1116402
-Node: Extension Sample File Functions1117931
-Node: Extension Sample Fnmatch1125580
-Node: Extension Sample Fork1127067
-Node: Extension Sample Inplace1128285
-Node: Extension Sample Ord1131910
-Node: Extension Sample Readdir1132746
-Ref: table-readdir-file-types1133635
-Node: Extension Sample Revout1134702
-Node: Extension Sample Rev2way1135291
-Node: Extension Sample Read write array1136031
-Node: Extension Sample Readfile1137973
-Node: Extension Sample Time1139068
-Node: Extension Sample API Tests1140820
-Node: gawkextlib1141312
-Node: Extension summary1144230
-Node: Extension Exercises1147932
-Node: Language History1149174
-Node: V7/SVR3.11150830
-Node: SVR41152982
-Node: POSIX1154416
-Node: BTL1155796
-Node: POSIX/GNU1156525
-Node: Feature History1162303
-Node: Common Extensions1178496
-Node: Ranges and Locales1179779
-Ref: Ranges and Locales-Footnote-11184395
-Ref: Ranges and Locales-Footnote-21184422
-Ref: Ranges and Locales-Footnote-31184657
-Node: Contributors1184878
-Node: History summary1190831
-Node: Installation1192211
-Node: Gawk Distribution1193155
-Node: Getting1193639
-Node: Extracting1194602
-Node: Distribution contents1196240
-Node: Unix Installation1202720
-Node: Quick Installation1203402
-Node: Shell Startup Files1205816
-Node: Additional Configuration Options1206905
-Node: Configuration Philosophy1209220
-Node: Non-Unix Installation1211589
-Node: PC Installation1212049
-Node: PC Binary Installation1212887
-Node: PC Compiling1213322
-Node: PC Using1214439
-Node: Cygwin1217992
-Node: MSYS1219216
-Node: VMS Installation1219717
-Node: VMS Compilation1220508
-Ref: VMS Compilation-Footnote-11221737
-Node: VMS Dynamic Extensions1221795
-Node: VMS Installation Details1223480
-Node: VMS Running1225733
-Node: VMS GNV1230012
-Node: VMS Old Gawk1230747
-Node: Bugs1231218
-Node: Bug address1231881
-Node: Usenet1234863
-Node: Maintainers1235867
-Node: Other Versions1237128
-Node: Installation summary1244216
-Node: Notes1245418
-Node: Compatibility Mode1246212
-Node: Additions1246994
-Node: Accessing The Source1247919
-Node: Adding Code1249356
-Node: New Ports1255575
-Node: Derived Files1259950
-Ref: Derived Files-Footnote-11265610
-Ref: Derived Files-Footnote-21265645
-Ref: Derived Files-Footnote-31266243
-Node: Future Extensions1266357
-Node: Implementation Limitations1267015
-Node: Extension Design1268198
-Node: Old Extension Problems1269342
-Ref: Old Extension Problems-Footnote-11270860
-Node: Extension New Mechanism Goals1270917
-Ref: Extension New Mechanism Goals-Footnote-11274281
-Node: Extension Other Design Decisions1274470
-Node: Extension Future Growth1276583
-Node: Notes summary1277419
-Node: Basic Concepts1278577
-Node: Basic High Level1279258
-Ref: figure-general-flow1279540
-Ref: figure-process-flow1280225
-Ref: Basic High Level-Footnote-11283526
-Node: Basic Data Typing1283711
-Node: Glossary1287039
-Node: Copying1318877
-Node: GNU Free Documentation License1356420
-Node: Index1381540
+Node: AWKLIBPATH Variable146193
+Ref: AWKLIBPATH Variable-Footnote-1147890
+Node: Other Environment Variables148265
+Node: Exit Status152086
+Node: Include Files152763
+Node: Loading Shared Libraries156453
+Node: Obsolete157881
+Node: Undocumented158573
+Node: Invoking Summary158870
+Node: Regexp161711
+Node: Regexp Usage163165
+Node: Escape Sequences165202
+Node: Regexp Operators171443
+Node: Regexp Operator Details171928
+Ref: Regexp Operator Details-Footnote-1178360
+Node: Interval Expressions178507
+Ref: Interval Expressions-Footnote-1179928
+Node: Bracket Expressions180026
+Ref: table-char-classes182502
+Node: Leftmost Longest185828
+Node: Computed Regexps187131
+Node: GNU Regexp Operators190558
+Node: Case-sensitivity194237
+Ref: Case-sensitivity-Footnote-1197103
+Ref: Case-sensitivity-Footnote-2197338
+Node: Regexp Summary197446
+Node: Reading Files198912
+Node: Records201181
+Node: awk split records202256
+Node: gawk split records207531
+Ref: gawk split records-Footnote-1212264
+Node: Fields212301
+Node: Nonconstant Fields215042
+Ref: Nonconstant Fields-Footnote-1217278
+Node: Changing Fields217482
+Node: Field Separators223513
+Node: Default Field Splitting226211
+Node: Regexp Field Splitting227329
+Node: Single Character Fields230682
+Node: Command Line Field Separator231742
+Node: Full Line Fields234960
+Ref: Full Line Fields-Footnote-1236482
+Ref: Full Line Fields-Footnote-2236528
+Node: Field Splitting Summary236629
+Node: Constant Size238703
+Node: Fixed width data239435
+Node: Skipping intervening242902
+Node: Allowing trailing data243700
+Node: Fields with fixed data244737
+Node: Splitting By Content246255
+Ref: Splitting By Content-Footnote-1249905
+Node: Testing field creation250068
+Node: Multiple Line251693
+Node: Getline257970
+Node: Plain Getline260439
+Node: Getline/Variable263012
+Node: Getline/File264163
+Node: Getline/Variable/File265551
+Ref: Getline/Variable/File-Footnote-1267156
+Node: Getline/Pipe267244
+Node: Getline/Variable/Pipe269948
+Node: Getline/Coprocess271083
+Node: Getline/Variable/Coprocess272350
+Node: Getline Notes273092
+Node: Getline Summary275889
+Ref: table-getline-variants276313
+Node: Read Timeout277061
+Ref: Read Timeout-Footnote-1280967
+Node: Retrying Input281025
+Node: Command-line directories282224
+Node: Input Summary283130
+Node: Input Exercises286302
+Node: Printing286736
+Node: Print288570
+Node: Print Examples290027
+Node: Output Separators292807
+Node: OFMT294824
+Node: Printf296180
+Node: Basic Printf296965
+Node: Control Letters298539
+Node: Format Modifiers303703
+Node: Printf Examples309718
+Node: Redirection312204
+Node: Special FD319045
+Ref: Special FD-Footnote-1322213
+Node: Special Files322287
+Node: Other Inherited Files322904
+Node: Special Network323905
+Node: Special Caveats324765
+Node: Close Files And Pipes325714
+Ref: table-close-pipe-return-values332621
+Ref: Close Files And Pipes-Footnote-1333434
+Ref: Close Files And Pipes-Footnote-2333582
+Node: Nonfatal333734
+Node: Output Summary336072
+Node: Output Exercises337294
+Node: Expressions337973
+Node: Values339161
+Node: Constants339839
+Node: Scalar Constants340530
+Ref: Scalar Constants-Footnote-1343054
+Node: Nondecimal-numbers343304
+Node: Regexp Constants346305
+Node: Using Constant Regexps346831
+Node: Standard Regexp Constants347453
+Node: Strong Regexp Constants350641
+Node: Variables353599
+Node: Using Variables354256
+Node: Assignment Options356166
+Node: Conversion358637
+Node: Strings And Numbers359161
+Ref: Strings And Numbers-Footnote-1362224
+Node: Locale influences conversions362333
+Ref: table-locale-affects365091
+Node: All Operators365709
+Node: Arithmetic Ops366338
+Node: Concatenation368844
+Ref: Concatenation-Footnote-1371691
+Node: Assignment Ops371798
+Ref: table-assign-ops376789
+Node: Increment Ops378102
+Node: Truth Values and Conditions381562
+Node: Truth Values382636
+Node: Typing and Comparison383684
+Node: Variable Typing384504
+Ref: Variable Typing-Footnote-1390967
+Ref: Variable Typing-Footnote-2391039
+Node: Comparison Operators391116
+Ref: table-relational-ops391535
+Node: POSIX String Comparison395030
+Ref: POSIX String Comparison-Footnote-1396725
+Ref: POSIX String Comparison-Footnote-2396864
+Node: Boolean Ops396948
+Ref: Boolean Ops-Footnote-1401430
+Node: Conditional Exp401522
+Node: Function Calls403258
+Node: Precedence407135
+Node: Locales410794
+Node: Expressions Summary412426
+Node: Patterns and Actions414999
+Node: Pattern Overview416119
+Node: Regexp Patterns417796
+Node: Expression Patterns418338
+Node: Ranges422119
+Node: BEGIN/END425227
+Node: Using BEGIN/END425988
+Ref: Using BEGIN/END-Footnote-1428724
+Node: I/O And BEGIN/END428830
+Node: Empty434057
+Node: Using Shell Variables434374
+Node: Action Overview436648
+Node: Statements438973
+Node: If Statement440821
+Node: While Statement442316
+Node: Do Statement444344
+Node: For Statement445492
+Node: Switch Statement448663
+Node: Break Statement451049
+Node: Continue Statement453141
+Node: Next Statement454968
+Node: Nextfile Statement457351
+Node: Exit Statement460003
+Node: Built-in Variables462406
+Node: User-modified463539
+Node: Auto-set471306
+Ref: Auto-set-Footnote-1488113
+Ref: Auto-set-Footnote-2488319
+Node: ARGC and ARGV488375
+Node: Pattern Action Summary492588
+Node: Arrays495018
+Node: Array Basics496347
+Node: Array Intro497191
+Ref: figure-array-elements499166
+Ref: Array Intro-Footnote-1501870
+Node: Reference to Elements501998
+Node: Assigning Elements504462
+Node: Array Example504953
+Node: Scanning an Array506712
+Node: Controlling Scanning509734
+Ref: Controlling Scanning-Footnote-1515434
+Node: Numeric Array Subscripts515750
+Node: Uninitialized Subscripts517934
+Node: Delete519553
+Ref: Delete-Footnote-1522305
+Node: Multidimensional522362
+Node: Multiscanning525457
+Node: Arrays of Arrays527048
+Node: Arrays Summary531816
+Node: Functions533909
+Node: Built-in534947
+Node: Calling Built-in536028
+Node: Numeric Functions538024
+Ref: Numeric Functions-Footnote-1542052
+Ref: Numeric Functions-Footnote-2542700
+Ref: Numeric Functions-Footnote-3542748
+Node: String Functions543020
+Ref: String Functions-Footnote-1567204
+Ref: String Functions-Footnote-2567332
+Ref: String Functions-Footnote-3567580
+Node: Gory Details567667
+Ref: table-sub-escapes569458
+Ref: table-sub-proposed570977
+Ref: table-posix-sub572340
+Ref: table-gensub-escapes573881
+Ref: Gory Details-Footnote-1574704
+Node: I/O Functions574858
+Ref: table-system-return-values581326
+Ref: I/O Functions-Footnote-1583406
+Ref: I/O Functions-Footnote-2583554
+Node: Time Functions583674
+Ref: Time Functions-Footnote-1594345
+Ref: Time Functions-Footnote-2594413
+Ref: Time Functions-Footnote-3594571
+Ref: Time Functions-Footnote-4594682
+Ref: Time Functions-Footnote-5594794
+Ref: Time Functions-Footnote-6595021
+Node: Bitwise Functions595287
+Ref: table-bitwise-ops595881
+Ref: Bitwise Functions-Footnote-1601944
+Ref: Bitwise Functions-Footnote-2602117
+Node: Type Functions602308
+Node: I18N Functions605171
+Node: User-defined606822
+Node: Definition Syntax607634
+Ref: Definition Syntax-Footnote-1613321
+Node: Function Example613392
+Ref: Function Example-Footnote-1616314
+Node: Function Calling616336
+Node: Calling A Function616924
+Node: Variable Scope617882
+Node: Pass By Value/Reference620876
+Node: Function Caveats623520
+Ref: Function Caveats-Footnote-1625567
+Node: Return Statement625687
+Node: Dynamic Typing628666
+Node: Indirect Calls629596
+Ref: Indirect Calls-Footnote-1639848
+Node: Functions Summary639976
+Node: Library Functions642681
+Ref: Library Functions-Footnote-1646288
+Ref: Library Functions-Footnote-2646431
+Node: Library Names646602
+Ref: Library Names-Footnote-1650269
+Ref: Library Names-Footnote-2650492
+Node: General Functions650578
+Node: Strtonum Function651681
+Node: Assert Function654703
+Node: Round Function658029
+Node: Cliff Random Function659569
+Node: Ordinal Functions660585
+Ref: Ordinal Functions-Footnote-1663648
+Ref: Ordinal Functions-Footnote-2663900
+Node: Join Function664110
+Ref: Join Function-Footnote-1665880
+Node: Getlocaltime Function666080
+Node: Readfile Function669822
+Node: Shell Quoting671799
+Node: Data File Management673200
+Node: Filetrans Function673832
+Node: Rewind Function677928
+Node: File Checking679837
+Ref: File Checking-Footnote-1681171
+Node: Empty Files681372
+Node: Ignoring Assigns683351
+Node: Getopt Function684901
+Ref: Getopt Function-Footnote-1700115
+Node: Passwd Functions700315
+Ref: Passwd Functions-Footnote-1709154
+Node: Group Functions709242
+Ref: Group Functions-Footnote-1717140
+Node: Walking Arrays717347
+Node: Library Functions Summary720355
+Node: Library Exercises721761
+Node: Sample Programs722226
+Node: Running Examples722996
+Node: Clones723724
+Node: Cut Program724948
+Node: Egrep Program734877
+Ref: Egrep Program-Footnote-1742389
+Node: Id Program742499
+Node: Split Program746179
+Ref: Split Program-Footnote-1749637
+Node: Tee Program749766
+Node: Uniq Program752556
+Node: Wc Program760177
+Ref: Wc Program-Footnote-1764432
+Node: Miscellaneous Programs764526
+Node: Dupword Program765739
+Node: Alarm Program767769
+Node: Translate Program772624
+Ref: Translate Program-Footnote-1777189
+Node: Labels Program777459
+Ref: Labels Program-Footnote-1780810
+Node: Word Sorting780894
+Node: History Sorting784966
+Node: Extract Program787191
+Node: Simple Sed795245
+Node: Igawk Program798319
+Ref: Igawk Program-Footnote-1812650
+Ref: Igawk Program-Footnote-2812852
+Ref: Igawk Program-Footnote-3812974
+Node: Anagram Program813089
+Node: Signature Program816151
+Node: Programs Summary817398
+Node: Programs Exercises818612
+Ref: Programs Exercises-Footnote-1822741
+Node: Advanced Features822832
+Node: Nondecimal Data824822
+Node: Array Sorting826413
+Node: Controlling Array Traversal827113
+Ref: Controlling Array Traversal-Footnote-1835481
+Node: Array Sorting Functions835599
+Ref: Array Sorting Functions-Footnote-1840690
+Node: Two-way I/O840886
+Ref: Two-way I/O-Footnote-1848607
+Ref: Two-way I/O-Footnote-2848794
+Node: TCP/IP Networking848876
+Node: Profiling851994
+Node: Advanced Features Summary861009
+Node: Internationalization862853
+Node: I18N and L10N864333
+Node: Explaining gettext865020
+Ref: Explaining gettext-Footnote-1870912
+Ref: Explaining gettext-Footnote-2871097
+Node: Programmer i18n871262
+Ref: Programmer i18n-Footnote-1876211
+Node: Translator i18n876260
+Node: String Extraction877054
+Ref: String Extraction-Footnote-1878186
+Node: Printf Ordering878272
+Ref: Printf Ordering-Footnote-1881058
+Node: I18N Portability881122
+Ref: I18N Portability-Footnote-1883578
+Node: I18N Example883641
+Ref: I18N Example-Footnote-1886916
+Ref: I18N Example-Footnote-2886989
+Node: Gawk I18N887098
+Node: I18N Summary887747
+Node: Debugger889088
+Node: Debugging890088
+Node: Debugging Concepts890529
+Node: Debugging Terms892338
+Node: Awk Debugging894913
+Ref: Awk Debugging-Footnote-1895858
+Node: Sample Debugging Session895990
+Node: Debugger Invocation896524
+Node: Finding The Bug897910
+Node: List of Debugger Commands904384
+Node: Breakpoint Control905717
+Node: Debugger Execution Control909411
+Node: Viewing And Changing Data912773
+Node: Execution Stack916314
+Node: Debugger Info917951
+Node: Miscellaneous Debugger Commands922022
+Node: Readline Support927084
+Node: Limitations927980
+Node: Debugging Summary930534
+Node: Namespaces931813
+Node: Global Namespace932924
+Node: Qualified Names934322
+Node: Default Namespace935321
+Node: Changing The Namespace936062
+Node: Naming Rules937676
+Node: Internal Name Management939524
+Node: Namespace Example940566
+Node: Namespace And Features943128
+Node: Namespace Summary944563
+Node: Arbitrary Precision Arithmetic946040
+Node: Computer Arithmetic947527
+Ref: table-numeric-ranges951293
+Ref: table-floating-point-ranges951786
+Ref: Computer Arithmetic-Footnote-1952444
+Node: Math Definitions952501
+Ref: table-ieee-formats955817
+Ref: Math Definitions-Footnote-1956420
+Node: MPFR features956525
+Node: FP Math Caution958243
+Ref: FP Math Caution-Footnote-1959315
+Node: Inexactness of computations959684
+Node: Inexact representation960644
+Node: Comparing FP Values962004
+Node: Errors accumulate963245
+Node: Getting Accuracy964678
+Node: Try To Round967388
+Node: Setting precision968287
+Ref: table-predefined-precision-strings968984
+Node: Setting the rounding mode970814
+Ref: table-gawk-rounding-modes971188
+Ref: Setting the rounding mode-Footnote-1975119
+Node: Arbitrary Precision Integers975298
+Ref: Arbitrary Precision Integers-Footnote-1978473
+Node: Checking for MPFR978622
+Node: POSIX Floating Point Problems980096
+Ref: POSIX Floating Point Problems-Footnote-1984381
+Node: Floating point summary984419
+Node: Dynamic Extensions986609
+Node: Extension Intro988162
+Node: Plugin License989428
+Node: Extension Mechanism Outline990225
+Ref: figure-load-extension990664
+Ref: figure-register-new-function992229
+Ref: figure-call-new-function993321
+Node: Extension API Description995383
+Node: Extension API Functions Introduction997025
+Ref: table-api-std-headers998861
+Node: General Data Types1002726
+Ref: General Data Types-Footnote-11011087
+Node: Memory Allocation Functions1011386
+Ref: Memory Allocation Functions-Footnote-11015596
+Node: Constructor Functions1015695
+Node: Registration Functions1019281
+Node: Extension Functions1019966
+Node: Exit Callback Functions1025288
+Node: Extension Version String1026538
+Node: Input Parsers1027201
+Node: Output Wrappers1039922
+Node: Two-way processors1044434
+Node: Printing Messages1046699
+Ref: Printing Messages-Footnote-11047870
+Node: Updating ERRNO1048023
+Node: Requesting Values1048762
+Ref: table-value-types-returned1049499
+Node: Accessing Parameters1050435
+Node: Symbol Table Access1051670
+Node: Symbol table by name1052182
+Ref: Symbol table by name-Footnote-11055206
+Node: Symbol table by cookie1055334
+Ref: Symbol table by cookie-Footnote-11059519
+Node: Cached values1059583
+Ref: Cached values-Footnote-11063119
+Node: Array Manipulation1063272
+Ref: Array Manipulation-Footnote-11064363
+Node: Array Data Types1064400
+Ref: Array Data Types-Footnote-11067058
+Node: Array Functions1067150
+Node: Flattening Arrays1071648
+Node: Creating Arrays1078624
+Node: Redirection API1083391
+Node: Extension API Variables1086224
+Node: Extension Versioning1086935
+Ref: gawk-api-version1087364
+Node: Extension GMP/MPFR Versioning1089095
+Node: Extension API Informational Variables1090723
+Node: Extension API Boilerplate1091796
+Node: Changes from API V11095770
+Node: Finding Extensions1097342
+Node: Extension Example1097901
+Node: Internal File Description1098699
+Node: Internal File Ops1102779
+Ref: Internal File Ops-Footnote-11114129
+Node: Using Internal File Ops1114269
+Ref: Using Internal File Ops-Footnote-11116652
+Node: Extension Samples1116926
+Node: Extension Sample File Functions1118455
+Node: Extension Sample Fnmatch1126104
+Node: Extension Sample Fork1127591
+Node: Extension Sample Inplace1128809
+Node: Extension Sample Ord1132434
+Node: Extension Sample Readdir1133270
+Ref: table-readdir-file-types1134159
+Node: Extension Sample Revout1135226
+Node: Extension Sample Rev2way1135815
+Node: Extension Sample Read write array1136555
+Node: Extension Sample Readfile1138497
+Node: Extension Sample Time1139592
+Node: Extension Sample API Tests1141344
+Node: gawkextlib1141836
+Node: Extension summary1144754
+Node: Extension Exercises1148456
+Node: Language History1149698
+Node: V7/SVR3.11151354
+Node: SVR41153506
+Node: POSIX1154940
+Node: BTL1156320
+Node: POSIX/GNU1157049
+Node: Feature History1162827
+Node: Common Extensions1179020
+Node: Ranges and Locales1180303
+Ref: Ranges and Locales-Footnote-11184919
+Ref: Ranges and Locales-Footnote-21184946
+Ref: Ranges and Locales-Footnote-31185181
+Node: Contributors1185402
+Node: History summary1191355
+Node: Installation1192735
+Node: Gawk Distribution1193679
+Node: Getting1194163
+Node: Extracting1195126
+Node: Distribution contents1196764
+Node: Unix Installation1203244
+Node: Quick Installation1203926
+Node: Shell Startup Files1206340
+Node: Additional Configuration Options1207429
+Node: Configuration Philosophy1209744
+Node: Non-Unix Installation1212113
+Node: PC Installation1212573
+Node: PC Binary Installation1213411
+Node: PC Compiling1213846
+Node: PC Using1214963
+Node: Cygwin1218516
+Node: MSYS1219740
+Node: VMS Installation1220241
+Node: VMS Compilation1221032
+Ref: VMS Compilation-Footnote-11222261
+Node: VMS Dynamic Extensions1222319
+Node: VMS Installation Details1224004
+Node: VMS Running1226257
+Node: VMS GNV1230536
+Node: VMS Old Gawk1231271
+Node: Bugs1231742
+Node: Bug address1232405
+Node: Usenet1235387
+Node: Maintainers1236391
+Node: Other Versions1237652
+Node: Installation summary1244740
+Node: Notes1245942
+Node: Compatibility Mode1246736
+Node: Additions1247518
+Node: Accessing The Source1248443
+Node: Adding Code1249880
+Node: New Ports1256099
+Node: Derived Files1260474
+Ref: Derived Files-Footnote-11266134
+Ref: Derived Files-Footnote-21266169
+Ref: Derived Files-Footnote-31266767
+Node: Future Extensions1266881
+Node: Implementation Limitations1267539
+Node: Extension Design1268722
+Node: Old Extension Problems1269866
+Ref: Old Extension Problems-Footnote-11271384
+Node: Extension New Mechanism Goals1271441
+Ref: Extension New Mechanism Goals-Footnote-11274805
+Node: Extension Other Design Decisions1274994
+Node: Extension Future Growth1277107
+Node: Notes summary1277943
+Node: Basic Concepts1279101
+Node: Basic High Level1279782
+Ref: figure-general-flow1280064
+Ref: figure-process-flow1280749
+Ref: Basic High Level-Footnote-11284050
+Node: Basic Data Typing1284235
+Node: Glossary1287563
+Node: Copying1319401
+Node: GNU Free Documentation License1356944
+Node: Index1382064
 End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index d646175..2a859fc 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -4611,9 +4611,12 @@ The default value for @env{AWKPATH} is
 @samp{.:/usr/local/share/awk}.@footnote{Your version of @command{gawk}
 may use a different directory; it
 will depend upon how @command{gawk} was built and installed. The actual
-directory is the value of @code{$(datadir)} generated when
-@command{gawk} was configured.  You probably don't need to worry about this,
-though.}  Since @file{.} is included at the beginning, @command{gawk}
+directory is the value of @code{$(pkgdatadir)} generated when
+@command{gawk} was configured.
+(For more detail, see the @file{INSTALL} file in the source distribution,
+and see @ref{Quick Installation}.
+You probably don't need to worry about this,
+though.)}  Since @file{.} is included at the beginning, @command{gawk}
 searches first in the current directory and then in 
 In practice, this means that you will rarely need to change the
 value of @env{AWKPATH}.
@@ -4651,7 +4654,15 @@ via the @code{@@load} keyword (@pxref{Loading Shared 
 If @env{AWKLIBPATH} does not exist in the environment, or if it has
 an empty value, @command{gawk} uses a default path; this
 is typically @samp{/usr/local/lib/gawk}, although it can vary depending
-upon how @command{gawk} was built.
+upon how @command{gawk} was built.@footnote{Your version of @command{gawk}
+may use a different directory; it
+will depend upon how @command{gawk} was built and installed. The actual
+directory is the value of @code{$(pkgextensiondir)} generated when
+@command{gawk} was configured.
+(For more detail, see the @file{INSTALL} file in the source distribution,
+and see @ref{Quick Installation}.
+You probably don't need to worry about this,
 @xref{Shell Startup Files}, for information on functions that help to
 manipulate the @env{AWKLIBPATH} variable.
diff --git a/doc/ b/doc/
index 2d4409b..0bce3dd 100644
--- a/doc/
+++ b/doc/
@@ -4521,9 +4521,12 @@ The default value for @env{AWKPATH} is
 @samp{.:/usr/local/share/awk}.@footnote{Your version of @command{gawk}
 may use a different directory; it
 will depend upon how @command{gawk} was built and installed. The actual
-directory is the value of @code{$(datadir)} generated when
-@command{gawk} was configured.  You probably don't need to worry about this,
-though.}  Since @file{.} is included at the beginning, @command{gawk}
+directory is the value of @code{$(pkgdatadir)} generated when
+@command{gawk} was configured.
+(For more detail, see the @file{INSTALL} file in the source distribution,
+and see @ref{Quick Installation}.
+You probably don't need to worry about this,
+though.)}  Since @file{.} is included at the beginning, @command{gawk}
 searches first in the current directory and then in 
 In practice, this means that you will rarely need to change the
 value of @env{AWKPATH}.
@@ -4561,7 +4564,15 @@ via the @code{@@load} keyword (@pxref{Loading Shared 
 If @env{AWKLIBPATH} does not exist in the environment, or if it has
 an empty value, @command{gawk} uses a default path; this
 is typically @samp{/usr/local/lib/gawk}, although it can vary depending
-upon how @command{gawk} was built.
+upon how @command{gawk} was built.@footnote{Your version of @command{gawk}
+may use a different directory; it
+will depend upon how @command{gawk} was built and installed. The actual
+directory is the value of @code{$(pkgextensiondir)} generated when
+@command{gawk} was configured.
+(For more detail, see the @file{INSTALL} file in the source distribution,
+and see @ref{Quick Installation}.
+You probably don't need to worry about this,
 @xref{Shell Startup Files}, for information on functions that help to
 manipulate the @env{AWKLIBPATH} variable.


Summary of changes:
 doc/ChangeLog   |    5 +
 doc/   | 1106 ++++++++++++++++++++++++++++---------------------------
 doc/gawk.texi   |   19 +-
 doc/ |   19 +-
 4 files changed, 594 insertions(+), 555 deletions(-)


reply via email to

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