[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[SCM] gawk branch, gawk-5.3-stable, updated. gawk-4.1.0-5577-g3b4d4661
|
From: |
Arnold Robbins |
|
Subject: |
[SCM] gawk branch, gawk-5.3-stable, updated. gawk-4.1.0-5577-g3b4d4661 |
|
Date: |
Sun, 20 Oct 2024 08:15:50 -0400 (EDT) |
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-5.3-stable has been updated
via 3b4d466117be48c47562b94c0560bb216e8b0d88 (commit)
from 374b32f6a93ed0a4655d868dae73f0b01d550cd5 (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 -----------------------------------------------------------------
http://git.sv.gnu.org/cgit/gawk.git/commit/?id=3b4d466117be48c47562b94c0560bb216e8b0d88
commit 3b4d466117be48c47562b94c0560bb216e8b0d88
Author: Arnold D. Robbins <arnold@skeeve.com>
Date: Sun Oct 20 15:15:33 2024 +0300
Doc fixes.
diff --git a/awklib/eg/misc/simple-csv.awk b/awklib/eg/misc/simple-csv.awk
index cb718729..0961973a 100644
--- a/awklib/eg/misc/simple-csv.awk
+++ b/awklib/eg/misc/simple-csv.awk
@@ -1,5 +1,5 @@
BEGIN {
- FPAT = "([^,]+)|(\"[^\"]+\")"
+ FPAT = "([^,]*)|(\"[^\"]+\")"
}
{
diff --git a/doc/ChangeLog b/doc/ChangeLog
index cfe3d4dc..37b37e38 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,9 @@
+2024-10-20 Arnold D. Robbins <arnold@skeeve.com>
+
+ * gawk.texi [PVERSION]: Nuked. All uses changed to straight
+ "version". Some other small fixes. Thanks to Antonio Colombo
+ for the motivation.
+
2024-10-15 Arnold D. Robbins <arnold@skeeve.com>
* gawk.texi (Gory Details): Use @multitable for the tables
diff --git a/doc/gawk.info b/doc/gawk.info
index e0e99be8..6c84f2c3 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -5837,7 +5837,7 @@ this as a string requires us to escape the double quotes,
leading to:
Putting this to use, here is a simple program to parse the data:
BEGIN {
- FPAT = "([^,]+)|(\"[^\"]+\")"
+ FPAT = "([^,]*)|(\"[^\"]+\")"
}
{
@@ -5921,7 +5921,7 @@ not all.
For a more general solution to working with CSV data, see *note Comma
Separated Fields::. If your version of âgawkâ is prior to version 5.3,
we recommend that you use Manuel Collado's âCSVMODEâ library for âgawkâ
-(http://mcollado.z15.es/xgawk/).
+(http://mcollado.z15.es/gawk-extras/).
As with âFSâ, the âIGNORECASEâ variable (*note User-modified::)
affects field splitting with âFPATâ.
@@ -14034,7 +14034,7 @@ You type âsub()â sees âsub()â generates
--------------------------------------------------------------------------
â\\\\\\&â â\\\&â A literal â\&â
â \\\\&â â \\&â A literal â\â, followed by the
matched
- te t
+ text
â \\&â â \&â A literal â&â
â \\qâ â \qâ A literal â\qâ
â \\\\â â \\â â\â
@@ -31547,8 +31547,7 @@ Info file, in approximate chronological order:
⢠John Naman contributed the original text for *note Shadowed
Variables::.
- â¢
- Stuart Ferguson reworked the text in *note Splitting By Content::.
+ ⢠Stuart Ferguson reworked the text in *note Splitting By Content::.
⢠The development of the extension API first released with âgawkâ 4.1
was driven primarily by Arnold Robbins and Andrew Schorr, with
@@ -37152,7 +37151,7 @@ Index
* collating elements: Bracket Expressions. (line 90)
* collating symbols: Bracket Expressions. (line 97)
* Colombo, Antonio: Acknowledgments. (line 60)
-* Colombo, Antonio <1>: Contributors. (line 149)
+* Colombo, Antonio <1>: Contributors. (line 148)
* colon (:), :: namespace separator: Qualified Names. (line 6)
* colon (:), ?: operator: Precedence. (line 91)
* columns, aligning: Print Examples. (line 69)
@@ -37298,7 +37297,7 @@ Index
* CSVMODE library for gawk: Splitting By Content.
(line 133)
* ctime() user-defined function: Function Example. (line 74)
-* Curreli, Marco: Contributors. (line 153)
+* Curreli, Marco: Contributors. (line 152)
* currency symbols, localization: Explaining gettext. (line 104)
* current namespace, pushing and popping: Changing The Namespace.
(line 29)
@@ -37929,7 +37928,7 @@ Index
* features, undocumented: Undocumented. (line 6)
* Fenlason, Jay: History. (line 34)
* Fenlason, Jay <1>: Contributors. (line 19)
-* Ferguson, Stuar: Contributors. (line 139)
+* Ferguson, Stuart: Contributors. (line 139)
* fflush: I/O Functions. (line 28)
* field numbers: Nonconstant Fields. (line 6)
* field operator $: Fields. (line 19)
@@ -38377,7 +38376,7 @@ Index
* gsub() function, arguments of: String Functions. (line 492)
* gsub() function, escape processing: Gory Details. (line 6)
* Guerrero, Juan Manuel: Acknowledgments. (line 60)
-* Guerrero, Juan Manuel <1>: Contributors. (line 156)
+* Guerrero, Juan Manuel <1>: Contributors. (line 155)
* h debugger command (alias for help): Miscellaneous Debugger Commands.
(line 67)
* Hankerson, Darrel: Acknowledgments. (line 60)
@@ -38529,7 +38528,7 @@ Index
* Jacobs, Andrew: Passwd Functions. (line 90)
* Jaegermann, Michal: Acknowledgments. (line 60)
* Jaegermann, Michal <1>: Contributors. (line 46)
-* Jannick: Contributors. (line 158)
+* Jannick: Contributors. (line 157)
* Java implementation of awk: Other Versions. (line 146)
* Java programming language: Glossary. (line 466)
* jawk: Other Versions. (line 146)
@@ -38682,7 +38681,7 @@ Index
* mailing labels, printing: Labels Program. (line 6)
* mailing list, GNITS: Acknowledgments. (line 52)
* Malmberg, John: Acknowledgments. (line 60)
-* Malmberg, John <1>: Contributors. (line 146)
+* Malmberg, John <1>: Contributors. (line 145)
* Malmberg, John <2>: Maintainers. (line 14)
* mark parity: Ordinal Functions. (line 45)
* marked string extraction (internationalization): String Extraction.
@@ -39357,7 +39356,7 @@ Index
* Robbins, Arnold <2>: Passwd Functions. (line 90)
* Robbins, Arnold <3>: Alarm Program. (line 6)
* Robbins, Arnold <4>: General Data Types. (line 6)
-* Robbins, Arnold <5>: Contributors. (line 160)
+* Robbins, Arnold <5>: Contributors. (line 159)
* Robbins, Arnold <6>: Maintainers. (line 14)
* Robbins, Arnold <7>: Future Extensions. (line 6)
* Robbins, Bill: Getline/Pipe. (line 40)
@@ -39404,7 +39403,7 @@ Index
* scanning multidimensional arrays: Multiscanning. (line 11)
* Schorr, Andrew: Acknowledgments. (line 60)
* Schorr, Andrew <1>: Auto-set. (line 386)
-* Schorr, Andrew <2>: Contributors. (line 142)
+* Schorr, Andrew <2>: Contributors. (line 141)
* Schreiber, Bert: Acknowledgments. (line 38)
* Schreiber, Rita: Acknowledgments. (line 38)
* search and replace in strings: String Functions. (line 98)
@@ -40099,459 +40098,459 @@ Node: Skipping intervening265917
Node: Allowing trailing data266719
Node: Fields with fixed data267780
Node: Splitting By Content269402
-Ref: Splitting By Content-Footnote-1274896
-Node: FS versus FPAT275059
-Node: Testing field creation276242
-Node: Multiple Line278016
-Node: Getline284485
-Node: Plain Getline287073
-Node: Getline/Variable289721
-Node: Getline/File290917
-Node: Getline/Variable/File292365
-Ref: Getline/Variable/File-Footnote-1294010
-Node: Getline/Pipe294106
-Node: Getline/Variable/Pipe296914
-Node: Getline/Coprocess298097
-Node: Getline/Variable/Coprocess299420
-Node: Getline Notes300186
-Node: Getline Summary304163
-Ref: table-getline-variants304607
-Node: Read Timeout305511
-Ref: Read Timeout-Footnote-1309473
-Node: Retrying Input309531
-Node: Command-line directories310798
-Node: Input Summary311736
-Node: Input Exercises315116
-Node: Printing315554
-Node: Print317497
-Node: Print Examples318998
-Node: Output Separators321843
-Node: OFMT323950
-Node: Printf325663
-Node: Basic Printf326468
-Node: Control Letters328103
-Node: Format Modifiers333549
-Node: Printf Examples339821
-Node: Redirection342362
-Node: Special FD350134
-Ref: Special FD-Footnote-1353432
-Node: Special Files353510
-Node: Other Inherited Files354139
-Node: Special Network355204
-Node: Special Caveats356092
-Node: Close Files And Pipes357075
-Ref: Close Files And Pipes-Footnote-1363199
-Node: Close Return Value363347
-Ref: table-close-pipe-return-values364618
-Ref: Close Return Value-Footnote-1365449
-Node: Noflush365605
-Node: Nonfatal367113
-Node: Output Summary369528
-Node: Output Exercises370814
-Node: Expressions371505
-Node: Values372705
-Node: Constants373383
-Node: Scalar Constants374078
-Ref: Scalar Constants-Footnote-1376654
-Ref: Scalar Constants-Footnote-2376904
-Node: Nondecimal-numbers376984
-Node: Regexp Constants380097
-Node: Using Constant Regexps380643
-Node: Standard Regexp Constants381289
-Node: Strong Regexp Constants384585
-Node: Variables388428
-Node: Using Variables389093
-Node: Assignment Options391067
-Node: Conversion393618
-Node: Strings And Numbers394150
-Ref: Strings And Numbers-Footnote-1397360
-Node: Locale influences conversions397469
-Ref: table-locale-affects400307
-Node: All Operators400949
-Node: Arithmetic Ops401590
-Node: Concatenation404413
-Ref: Concatenation-Footnote-1407349
-Node: Assignment Ops407468
-Ref: table-assign-ops412595
-Node: Increment Ops413976
-Node: Truth Values and Conditions417567
-Node: Truth Values418661
-Node: Typing and Comparison419741
-Node: Variable Typing420573
-Ref: Variable Typing-Footnote-1427217
-Ref: Variable Typing-Footnote-2427297
-Node: Comparison Operators427378
-Ref: table-relational-ops427805
-Node: POSIX String Comparison431481
-Ref: POSIX String Comparison-Footnote-1433238
-Ref: POSIX String Comparison-Footnote-2433381
-Node: Boolean Ops433465
-Ref: Boolean Ops-Footnote-1438139
-Node: Conditional Exp438235
-Node: Function Calls440015
-Node: Precedence443962
-Node: Locales447825
-Node: Expressions Summary449501
-Node: Patterns and Actions452156
-Node: Pattern Overview453292
-Node: Regexp Patterns455017
-Node: Expression Patterns455563
-Node: Ranges459468
-Node: BEGIN/END462642
-Node: Using BEGIN/END463451
-Ref: Using BEGIN/END-Footnote-1466359
-Node: I/O And BEGIN/END466469
-Node: BEGINFILE/ENDFILE468951
-Node: Empty472381
-Node: Using Shell Variables472698
-Node: Action Overview475034
-Node: Statements477470
-Node: If Statement479366
-Node: While Statement480929
-Node: Do Statement483017
-Node: For Statement484201
-Node: Switch Statement487556
-Node: Break Statement490105
-Node: Continue Statement492297
-Node: Next Statement494228
-Node: Nextfile Statement496707
-Node: Exit Statement499560
-Node: Built-in Variables502087
-Node: User-modified503264
-Node: Auto-set511471
-Ref: Auto-set-Footnote-1529555
-Ref: Auto-set-Footnote-2529773
-Node: ARGC and ARGV529829
-Node: Pattern Action Summary534258
-Node: Arrays536864
-Node: Array Basics538237
-Node: Array Intro539085
-Ref: figure-array-elements541096
-Ref: Array Intro-Footnote-1543949
-Node: Reference to Elements544081
-Node: Assigning Elements546601
-Node: Array Example547096
-Node: Scanning an Array549058
-Node: Controlling Scanning552153
-Ref: Controlling Scanning-Footnote-1558788
-Node: Numeric Array Subscripts559112
-Node: Uninitialized Subscripts561380
-Node: Delete563053
-Ref: Delete-Footnote-1565865
-Node: Multidimensional565922
-Node: Multiscanning569125
-Node: Arrays of Arrays570792
-Node: Arrays Summary575096
-Node: Functions577283
-Node: Built-in578485
-Node: Calling Built-in579674
-Node: Boolean Functions581714
-Node: Numeric Functions582276
-Ref: Numeric Functions-Footnote-1586461
-Ref: Numeric Functions-Footnote-2587144
-Ref: Numeric Functions-Footnote-3587196
-Node: String Functions587472
-Ref: String Functions-Footnote-1613923
-Ref: String Functions-Footnote-2614055
-Ref: String Functions-Footnote-3614311
-Node: Gory Details614398
-Ref: table-sub-escapes616407
-Ref: table-sub-proposed617959
-Ref: table-posix-sub619433
-Ref: table-gensub-escapes621085
-Ref: Gory Details-Footnote-1621913
-Node: I/O Functions622067
-Ref: table-system-return-values628743
-Ref: I/O Functions-Footnote-1630905
-Ref: I/O Functions-Footnote-2631053
-Node: Time Functions631173
-Ref: Time Functions-Footnote-1642885
-Ref: Time Functions-Footnote-2642953
-Ref: Time Functions-Footnote-3643115
-Ref: Time Functions-Footnote-4643226
-Ref: Time Functions-Footnote-5643342
-Ref: Time Functions-Footnote-6643569
-Node: Bitwise Functions643847
-Ref: table-bitwise-ops644445
-Ref: Bitwise Functions-Footnote-1650687
-Ref: Bitwise Functions-Footnote-2650864
-Node: Type Functions651059
-Node: I18N Functions653230
-Node: User-defined654965
-Node: Definition Syntax655711
-Ref: Definition Syntax-Footnote-1661566
-Node: Function Example661641
-Ref: Function Example-Footnote-1664620
-Node: Function Calling664642
-Node: Calling A Function665234
-Node: Variable Scope666204
-Node: Pass By Value/Reference669258
-Node: Function Caveats671986
-Ref: Function Caveats-Footnote-1674077
-Node: Return Statement674197
-Node: Dynamic Typing677229
-Node: Dynamic Typing Awk677811
-Node: Dynamic Typing Gawk679949
-Node: Shadowed Variables683319
-Node: Indirect Calls685667
-Node: Functions Summary696808
-Node: Library Functions699774
-Ref: Library Functions-Footnote-1703322
-Ref: Library Functions-Footnote-2703467
-Node: Library Names703642
-Ref: Library Names-Footnote-1707413
-Ref: Library Names-Footnote-2707640
-Node: General Functions707734
-Node: Strtonum Function709004
-Node: Assert Function712086
-Node: Round Function715536
-Node: Cliff Random Function717108
-Node: Ordinal Functions718132
-Ref: Ordinal Functions-Footnote-1721235
-Ref: Ordinal Functions-Footnote-2721487
-Node: Join Function721701
-Ref: Join Function-Footnote-1723499
-Node: Getlocaltime Function723703
-Node: Readfile Function727477
-Node: Shell Quoting729506
-Node: Isnumeric Function730962
-Node: To CSV Function732398
-Node: Data File Management734490
-Node: Filetrans Function735122
-Node: Rewind Function739398
-Node: File Checking741369
-Ref: File Checking-Footnote-1742735
-Node: Empty Files742940
-Node: Ignoring Assigns745003
-Node: Getopt Function746577
-Ref: Getopt Function-Footnote-1762395
-Node: Passwd Functions762607
-Ref: Passwd Functions-Footnote-1771742
-Node: Group Functions771830
-Ref: Group Functions-Footnote-1779954
-Node: Walking Arrays780165
-Node: Library Functions Summary783211
-Node: Library Exercises784631
-Node: Sample Programs785116
-Node: Running Examples785898
-Node: Clones786650
-Node: Cut Program787918
-Node: Egrep Program798342
-Node: Id Program807641
-Node: Split Program817733
-Ref: Split Program-Footnote-1827946
-Node: Tee Program828131
-Node: Uniq Program831037
-Node: Wc Program838897
-Node: Bytes vs. Characters839292
-Node: Using extensions840892
-Node: wc program841670
-Node: Miscellaneous Programs846663
-Node: Dupword Program847888
-Node: Alarm Program849937
-Node: Translate Program854840
-Ref: Translate Program-Footnote-1859549
-Node: Labels Program859827
-Ref: Labels Program-Footnote-1863262
-Node: Word Sorting863346
-Node: History Sorting867520
-Node: Extract Program869793
-Node: Simple Sed878046
-Node: Igawk Program881256
-Ref: Igawk Program-Footnote-1896466
-Ref: Igawk Program-Footnote-2896672
-Ref: Igawk Program-Footnote-3896802
-Node: Anagram Program896929
-Node: Signature Program900015
-Node: Programs Summary901265
-Node: Programs Exercises902519
-Ref: Programs Exercises-Footnote-1907348
-Node: Advanced Features907434
-Node: Nondecimal Data909915
-Node: Boolean Typed Values911545
-Node: Array Sorting913502
-Node: Controlling Array Traversal914231
-Ref: Controlling Array Traversal-Footnote-1922734
-Node: Array Sorting Functions922856
-Ref: Array Sorting Functions-Footnote-1928953
-Node: Two-way I/O929161
-Ref: Two-way I/O-Footnote-1937132
-Ref: Two-way I/O-Footnote-2937323
-Node: TCP/IP Networking937405
-Node: Profiling940573
-Node: Persistent Memory950243
-Ref: Persistent Memory-Footnote-1959815
-Node: Extension Philosophy959946
-Node: Advanced Features Summary961473
-Node: Internationalization963739
-Node: I18N and L10N965441
-Node: Explaining gettext966136
-Ref: Explaining gettext-Footnote-1972272
-Ref: Explaining gettext-Footnote-2972465
-Node: Programmer i18n972630
-Ref: Programmer i18n-Footnote-1977742
-Node: Translator i18n977791
-Node: String Extraction978621
-Ref: String Extraction-Footnote-1979797
-Node: Printf Ordering979895
-Ref: Printf Ordering-Footnote-1982753
-Node: I18N Portability982821
-Ref: I18N Portability-Footnote-1985381
-Node: I18N Example985448
-Ref: I18N Example-Footnote-1988842
-Ref: I18N Example-Footnote-2988915
-Node: Gawk I18N989032
-Node: I18N Summary989686
-Node: Debugger991083
-Node: Debugging992103
-Node: Debugging Concepts992552
-Node: Debugging Terms994369
-Node: Awk Debugging996972
-Ref: Awk Debugging-Footnote-1997945
-Node: Sample Debugging Session998081
-Node: Debugger Invocation998631
-Node: Finding The Bug1000256
-Node: List of Debugger Commands1006888
-Node: Breakpoint Control1008265
-Node: Debugger Execution Control1012087
-Node: Viewing And Changing Data1015561
-Node: Execution Stack1019295
-Node: Debugger Info1020976
-Node: Miscellaneous Debugger Commands1025271
-Node: Readline Support1030512
-Node: Limitations1031456
-Node: Debugging Summary1034080
-Node: Namespaces1035379
-Node: Global Namespace1036506
-Node: Qualified Names1037940
-Node: Default Namespace1038975
-Node: Changing The Namespace1039748
-Node: Naming Rules1041430
-Node: Internal Name Management1043385
-Node: Namespace Example1044455
-Node: Namespace And Features1047032
-Node: Namespace Summary1048487
-Node: Arbitrary Precision Arithmetic1049998
-Node: Computer Arithmetic1051517
-Ref: table-numeric-ranges1055442
-Ref: table-floating-point-ranges1055939
-Ref: Computer Arithmetic-Footnote-11056597
-Node: Math Definitions1056654
-Ref: table-ieee-formats1059686
-Node: MPFR features1060259
-Node: MPFR On Parole1060712
-Ref: MPFR On Parole-Footnote-11061553
-Node: MPFR Intro1061712
-Node: FP Math Caution1063396
-Ref: FP Math Caution-Footnote-11064468
-Node: Inexactness of computations1064841
-Node: Inexact representation1065872
-Node: Comparing FP Values1067253
-Node: Errors accumulate1068511
-Node: Strange values1069976
-Ref: Strange values-Footnote-11072630
-Node: Getting Accuracy1072735
-Node: Try To Round1075472
-Node: Setting precision1076379
-Ref: table-predefined-precision-strings1077084
-Node: Setting the rounding mode1078968
-Ref: table-gawk-rounding-modes1079350
-Ref: Setting the rounding mode-Footnote-11083402
-Node: Arbitrary Precision Integers1083587
-Ref: Arbitrary Precision Integers-Footnote-11086797
-Node: Checking for MPFR1086950
-Node: POSIX Floating Point Problems1088440
-Ref: POSIX Floating Point Problems-Footnote-11093260
-Node: Floating point summary1093298
-Node: Dynamic Extensions1095554
-Node: Extension Intro1097151
-Node: Plugin License1098453
-Node: Extension Mechanism Outline1099266
-Ref: figure-load-extension1099717
-Ref: figure-register-new-function1101295
-Ref: figure-call-new-function1102404
-Node: Extension API Description1104519
-Node: Extension API Functions Introduction1106248
-Ref: table-api-std-headers1108142
-Node: General Data Types1112583
-Ref: General Data Types-Footnote-11121729
-Node: Memory Allocation Functions1122032
-Ref: Memory Allocation Functions-Footnote-11126747
-Node: Constructor Functions1126846
-Node: API Ownership of MPFR and GMP Values1130747
-Node: Registration Functions1132300
-Node: Extension Functions1133004
-Node: Exit Callback Functions1138578
-Node: Extension Version String1139892
-Node: Input Parsers1140587
-Node: Output Wrappers1155206
-Node: Two-way processors1160048
-Node: Printing Messages1162401
-Ref: Printing Messages-Footnote-11163612
-Node: Updating ERRNO1163765
-Node: Requesting Values1164564
-Ref: table-value-types-returned1165317
-Node: Accessing Parameters1167376
-Node: Symbol Table Access1168657
-Node: Symbol table by name1169169
-Ref: Symbol table by name-Footnote-11172370
-Node: Symbol table by cookie1172502
-Ref: Symbol table by cookie-Footnote-11176771
-Node: Cached values1176835
-Ref: Cached values-Footnote-11180467
-Node: Array Manipulation1180624
-Ref: Array Manipulation-Footnote-11181723
-Node: Array Data Types1181760
-Ref: Array Data Types-Footnote-11184578
-Node: Array Functions1184674
-Node: Flattening Arrays1189703
-Node: Creating Arrays1196751
-Node: Redirection API1201593
-Node: Extension API Variables1204610
-Node: Extension Versioning1205333
-Ref: gawk-api-version1205762
-Node: Extension GMP/MPFR Versioning1207549
-Node: Extension API Informational Variables1209253
-Node: Extension API Boilerplate1210506
-Node: Changes from API V11214636
-Node: Finding Extensions1216268
-Node: Extension Example1216843
-Node: Internal File Description1217665
-Node: Internal File Ops1221957
-Ref: Internal File Ops-Footnote-11233507
-Node: Using Internal File Ops1233655
-Ref: Using Internal File Ops-Footnote-11236088
-Node: Extension Samples1236366
-Node: Extension Sample File Functions1237935
-Node: Extension Sample Fnmatch1246060
-Node: Extension Sample Fork1247655
-Node: Extension Sample Inplace1248931
-Node: Extension Sample Ord1253033
-Node: Extension Sample Readdir1253909
-Ref: table-readdir-file-types1254698
-Node: Extension Sample Revout1256054
-Node: Extension Sample Rev2way1256651
-Node: Extension Sample Read write array1257403
-Node: Extension Sample Readfile1260677
-Node: Extension Sample Time1261808
-Node: Extension Sample API Tests1263808
-Node: gawkextlib1264316
-Node: Extension summary1267348
-Node: Extension Exercises1271196
-Node: Language History1272466
-Node: V7/SVR3.11274178
-Node: SVR41276528
-Node: POSIX1278060
-Node: BTL1279485
-Node: POSIX/GNU1280252
-Ref: Gawk Extension Functions1283642
-Node: Feature History1287066
-Node: Common Extensions1306907
-Node: Ranges and Locales1308382
-Ref: Ranges and Locales-Footnote-11313167
-Ref: Ranges and Locales-Footnote-21313194
-Ref: Ranges and Locales-Footnote-31313429
-Node: Contributors1313652
+Ref: Splitting By Content-Footnote-1274902
+Node: FS versus FPAT275065
+Node: Testing field creation276248
+Node: Multiple Line278022
+Node: Getline284491
+Node: Plain Getline287079
+Node: Getline/Variable289727
+Node: Getline/File290923
+Node: Getline/Variable/File292371
+Ref: Getline/Variable/File-Footnote-1294016
+Node: Getline/Pipe294112
+Node: Getline/Variable/Pipe296920
+Node: Getline/Coprocess298103
+Node: Getline/Variable/Coprocess299426
+Node: Getline Notes300192
+Node: Getline Summary304169
+Ref: table-getline-variants304613
+Node: Read Timeout305517
+Ref: Read Timeout-Footnote-1309479
+Node: Retrying Input309537
+Node: Command-line directories310804
+Node: Input Summary311742
+Node: Input Exercises315122
+Node: Printing315560
+Node: Print317503
+Node: Print Examples319004
+Node: Output Separators321849
+Node: OFMT323956
+Node: Printf325669
+Node: Basic Printf326474
+Node: Control Letters328109
+Node: Format Modifiers333555
+Node: Printf Examples339827
+Node: Redirection342368
+Node: Special FD350140
+Ref: Special FD-Footnote-1353438
+Node: Special Files353516
+Node: Other Inherited Files354145
+Node: Special Network355210
+Node: Special Caveats356098
+Node: Close Files And Pipes357081
+Ref: Close Files And Pipes-Footnote-1363205
+Node: Close Return Value363353
+Ref: table-close-pipe-return-values364624
+Ref: Close Return Value-Footnote-1365455
+Node: Noflush365611
+Node: Nonfatal367119
+Node: Output Summary369534
+Node: Output Exercises370820
+Node: Expressions371511
+Node: Values372711
+Node: Constants373389
+Node: Scalar Constants374084
+Ref: Scalar Constants-Footnote-1376660
+Ref: Scalar Constants-Footnote-2376910
+Node: Nondecimal-numbers376990
+Node: Regexp Constants380103
+Node: Using Constant Regexps380649
+Node: Standard Regexp Constants381295
+Node: Strong Regexp Constants384591
+Node: Variables388434
+Node: Using Variables389099
+Node: Assignment Options391073
+Node: Conversion393624
+Node: Strings And Numbers394156
+Ref: Strings And Numbers-Footnote-1397366
+Node: Locale influences conversions397475
+Ref: table-locale-affects400313
+Node: All Operators400955
+Node: Arithmetic Ops401596
+Node: Concatenation404419
+Ref: Concatenation-Footnote-1407355
+Node: Assignment Ops407474
+Ref: table-assign-ops412601
+Node: Increment Ops413982
+Node: Truth Values and Conditions417573
+Node: Truth Values418667
+Node: Typing and Comparison419747
+Node: Variable Typing420579
+Ref: Variable Typing-Footnote-1427223
+Ref: Variable Typing-Footnote-2427303
+Node: Comparison Operators427384
+Ref: table-relational-ops427811
+Node: POSIX String Comparison431487
+Ref: POSIX String Comparison-Footnote-1433244
+Ref: POSIX String Comparison-Footnote-2433387
+Node: Boolean Ops433471
+Ref: Boolean Ops-Footnote-1438145
+Node: Conditional Exp438241
+Node: Function Calls440021
+Node: Precedence443968
+Node: Locales447831
+Node: Expressions Summary449507
+Node: Patterns and Actions452162
+Node: Pattern Overview453298
+Node: Regexp Patterns455023
+Node: Expression Patterns455569
+Node: Ranges459474
+Node: BEGIN/END462648
+Node: Using BEGIN/END463457
+Ref: Using BEGIN/END-Footnote-1466365
+Node: I/O And BEGIN/END466475
+Node: BEGINFILE/ENDFILE468957
+Node: Empty472387
+Node: Using Shell Variables472704
+Node: Action Overview475040
+Node: Statements477476
+Node: If Statement479372
+Node: While Statement480935
+Node: Do Statement483023
+Node: For Statement484207
+Node: Switch Statement487562
+Node: Break Statement490111
+Node: Continue Statement492303
+Node: Next Statement494234
+Node: Nextfile Statement496713
+Node: Exit Statement499566
+Node: Built-in Variables502093
+Node: User-modified503270
+Node: Auto-set511477
+Ref: Auto-set-Footnote-1529561
+Ref: Auto-set-Footnote-2529779
+Node: ARGC and ARGV529835
+Node: Pattern Action Summary534264
+Node: Arrays536870
+Node: Array Basics538243
+Node: Array Intro539091
+Ref: figure-array-elements541102
+Ref: Array Intro-Footnote-1543955
+Node: Reference to Elements544087
+Node: Assigning Elements546607
+Node: Array Example547102
+Node: Scanning an Array549064
+Node: Controlling Scanning552159
+Ref: Controlling Scanning-Footnote-1558794
+Node: Numeric Array Subscripts559118
+Node: Uninitialized Subscripts561386
+Node: Delete563059
+Ref: Delete-Footnote-1565871
+Node: Multidimensional565928
+Node: Multiscanning569131
+Node: Arrays of Arrays570798
+Node: Arrays Summary575102
+Node: Functions577289
+Node: Built-in578491
+Node: Calling Built-in579680
+Node: Boolean Functions581720
+Node: Numeric Functions582282
+Ref: Numeric Functions-Footnote-1586467
+Ref: Numeric Functions-Footnote-2587150
+Ref: Numeric Functions-Footnote-3587202
+Node: String Functions587478
+Ref: String Functions-Footnote-1613929
+Ref: String Functions-Footnote-2614061
+Ref: String Functions-Footnote-3614317
+Node: Gory Details614404
+Ref: table-sub-escapes616413
+Ref: table-sub-proposed617965
+Ref: table-posix-sub619439
+Ref: table-gensub-escapes621091
+Ref: Gory Details-Footnote-1621919
+Node: I/O Functions622073
+Ref: table-system-return-values628749
+Ref: I/O Functions-Footnote-1630911
+Ref: I/O Functions-Footnote-2631059
+Node: Time Functions631179
+Ref: Time Functions-Footnote-1642891
+Ref: Time Functions-Footnote-2642959
+Ref: Time Functions-Footnote-3643121
+Ref: Time Functions-Footnote-4643232
+Ref: Time Functions-Footnote-5643348
+Ref: Time Functions-Footnote-6643575
+Node: Bitwise Functions643853
+Ref: table-bitwise-ops644451
+Ref: Bitwise Functions-Footnote-1650693
+Ref: Bitwise Functions-Footnote-2650870
+Node: Type Functions651065
+Node: I18N Functions653236
+Node: User-defined654971
+Node: Definition Syntax655717
+Ref: Definition Syntax-Footnote-1661572
+Node: Function Example661647
+Ref: Function Example-Footnote-1664626
+Node: Function Calling664648
+Node: Calling A Function665240
+Node: Variable Scope666210
+Node: Pass By Value/Reference669264
+Node: Function Caveats671992
+Ref: Function Caveats-Footnote-1674083
+Node: Return Statement674203
+Node: Dynamic Typing677235
+Node: Dynamic Typing Awk677817
+Node: Dynamic Typing Gawk679955
+Node: Shadowed Variables683325
+Node: Indirect Calls685673
+Node: Functions Summary696814
+Node: Library Functions699780
+Ref: Library Functions-Footnote-1703328
+Ref: Library Functions-Footnote-2703473
+Node: Library Names703648
+Ref: Library Names-Footnote-1707419
+Ref: Library Names-Footnote-2707646
+Node: General Functions707740
+Node: Strtonum Function709010
+Node: Assert Function712092
+Node: Round Function715542
+Node: Cliff Random Function717114
+Node: Ordinal Functions718138
+Ref: Ordinal Functions-Footnote-1721241
+Ref: Ordinal Functions-Footnote-2721493
+Node: Join Function721707
+Ref: Join Function-Footnote-1723505
+Node: Getlocaltime Function723709
+Node: Readfile Function727483
+Node: Shell Quoting729512
+Node: Isnumeric Function730968
+Node: To CSV Function732404
+Node: Data File Management734496
+Node: Filetrans Function735128
+Node: Rewind Function739404
+Node: File Checking741375
+Ref: File Checking-Footnote-1742741
+Node: Empty Files742946
+Node: Ignoring Assigns745009
+Node: Getopt Function746583
+Ref: Getopt Function-Footnote-1762401
+Node: Passwd Functions762613
+Ref: Passwd Functions-Footnote-1771748
+Node: Group Functions771836
+Ref: Group Functions-Footnote-1779960
+Node: Walking Arrays780171
+Node: Library Functions Summary783217
+Node: Library Exercises784637
+Node: Sample Programs785122
+Node: Running Examples785904
+Node: Clones786656
+Node: Cut Program787924
+Node: Egrep Program798348
+Node: Id Program807647
+Node: Split Program817739
+Ref: Split Program-Footnote-1827952
+Node: Tee Program828137
+Node: Uniq Program831043
+Node: Wc Program838903
+Node: Bytes vs. Characters839298
+Node: Using extensions840898
+Node: wc program841676
+Node: Miscellaneous Programs846669
+Node: Dupword Program847894
+Node: Alarm Program849943
+Node: Translate Program854846
+Ref: Translate Program-Footnote-1859555
+Node: Labels Program859833
+Ref: Labels Program-Footnote-1863268
+Node: Word Sorting863352
+Node: History Sorting867526
+Node: Extract Program869799
+Node: Simple Sed878052
+Node: Igawk Program881262
+Ref: Igawk Program-Footnote-1896472
+Ref: Igawk Program-Footnote-2896678
+Ref: Igawk Program-Footnote-3896808
+Node: Anagram Program896935
+Node: Signature Program900021
+Node: Programs Summary901271
+Node: Programs Exercises902525
+Ref: Programs Exercises-Footnote-1907354
+Node: Advanced Features907440
+Node: Nondecimal Data909921
+Node: Boolean Typed Values911551
+Node: Array Sorting913508
+Node: Controlling Array Traversal914237
+Ref: Controlling Array Traversal-Footnote-1922740
+Node: Array Sorting Functions922862
+Ref: Array Sorting Functions-Footnote-1928959
+Node: Two-way I/O929167
+Ref: Two-way I/O-Footnote-1937138
+Ref: Two-way I/O-Footnote-2937329
+Node: TCP/IP Networking937411
+Node: Profiling940579
+Node: Persistent Memory950249
+Ref: Persistent Memory-Footnote-1959821
+Node: Extension Philosophy959952
+Node: Advanced Features Summary961479
+Node: Internationalization963745
+Node: I18N and L10N965447
+Node: Explaining gettext966142
+Ref: Explaining gettext-Footnote-1972278
+Ref: Explaining gettext-Footnote-2972471
+Node: Programmer i18n972636
+Ref: Programmer i18n-Footnote-1977748
+Node: Translator i18n977797
+Node: String Extraction978627
+Ref: String Extraction-Footnote-1979803
+Node: Printf Ordering979901
+Ref: Printf Ordering-Footnote-1982759
+Node: I18N Portability982827
+Ref: I18N Portability-Footnote-1985387
+Node: I18N Example985454
+Ref: I18N Example-Footnote-1988848
+Ref: I18N Example-Footnote-2988921
+Node: Gawk I18N989038
+Node: I18N Summary989692
+Node: Debugger991089
+Node: Debugging992109
+Node: Debugging Concepts992558
+Node: Debugging Terms994375
+Node: Awk Debugging996978
+Ref: Awk Debugging-Footnote-1997951
+Node: Sample Debugging Session998087
+Node: Debugger Invocation998637
+Node: Finding The Bug1000262
+Node: List of Debugger Commands1006894
+Node: Breakpoint Control1008271
+Node: Debugger Execution Control1012093
+Node: Viewing And Changing Data1015567
+Node: Execution Stack1019301
+Node: Debugger Info1020982
+Node: Miscellaneous Debugger Commands1025277
+Node: Readline Support1030518
+Node: Limitations1031462
+Node: Debugging Summary1034086
+Node: Namespaces1035385
+Node: Global Namespace1036512
+Node: Qualified Names1037946
+Node: Default Namespace1038981
+Node: Changing The Namespace1039754
+Node: Naming Rules1041436
+Node: Internal Name Management1043391
+Node: Namespace Example1044461
+Node: Namespace And Features1047038
+Node: Namespace Summary1048493
+Node: Arbitrary Precision Arithmetic1050004
+Node: Computer Arithmetic1051523
+Ref: table-numeric-ranges1055448
+Ref: table-floating-point-ranges1055945
+Ref: Computer Arithmetic-Footnote-11056603
+Node: Math Definitions1056660
+Ref: table-ieee-formats1059692
+Node: MPFR features1060265
+Node: MPFR On Parole1060718
+Ref: MPFR On Parole-Footnote-11061559
+Node: MPFR Intro1061718
+Node: FP Math Caution1063402
+Ref: FP Math Caution-Footnote-11064474
+Node: Inexactness of computations1064847
+Node: Inexact representation1065878
+Node: Comparing FP Values1067259
+Node: Errors accumulate1068517
+Node: Strange values1069982
+Ref: Strange values-Footnote-11072636
+Node: Getting Accuracy1072741
+Node: Try To Round1075478
+Node: Setting precision1076385
+Ref: table-predefined-precision-strings1077090
+Node: Setting the rounding mode1078974
+Ref: table-gawk-rounding-modes1079356
+Ref: Setting the rounding mode-Footnote-11083408
+Node: Arbitrary Precision Integers1083593
+Ref: Arbitrary Precision Integers-Footnote-11086803
+Node: Checking for MPFR1086956
+Node: POSIX Floating Point Problems1088446
+Ref: POSIX Floating Point Problems-Footnote-11093266
+Node: Floating point summary1093304
+Node: Dynamic Extensions1095560
+Node: Extension Intro1097157
+Node: Plugin License1098459
+Node: Extension Mechanism Outline1099272
+Ref: figure-load-extension1099723
+Ref: figure-register-new-function1101301
+Ref: figure-call-new-function1102410
+Node: Extension API Description1104525
+Node: Extension API Functions Introduction1106254
+Ref: table-api-std-headers1108148
+Node: General Data Types1112589
+Ref: General Data Types-Footnote-11121735
+Node: Memory Allocation Functions1122038
+Ref: Memory Allocation Functions-Footnote-11126753
+Node: Constructor Functions1126852
+Node: API Ownership of MPFR and GMP Values1130753
+Node: Registration Functions1132306
+Node: Extension Functions1133010
+Node: Exit Callback Functions1138584
+Node: Extension Version String1139898
+Node: Input Parsers1140593
+Node: Output Wrappers1155212
+Node: Two-way processors1160054
+Node: Printing Messages1162407
+Ref: Printing Messages-Footnote-11163618
+Node: Updating ERRNO1163771
+Node: Requesting Values1164570
+Ref: table-value-types-returned1165323
+Node: Accessing Parameters1167382
+Node: Symbol Table Access1168663
+Node: Symbol table by name1169175
+Ref: Symbol table by name-Footnote-11172376
+Node: Symbol table by cookie1172508
+Ref: Symbol table by cookie-Footnote-11176777
+Node: Cached values1176841
+Ref: Cached values-Footnote-11180473
+Node: Array Manipulation1180630
+Ref: Array Manipulation-Footnote-11181729
+Node: Array Data Types1181766
+Ref: Array Data Types-Footnote-11184584
+Node: Array Functions1184680
+Node: Flattening Arrays1189709
+Node: Creating Arrays1196757
+Node: Redirection API1201599
+Node: Extension API Variables1204616
+Node: Extension Versioning1205339
+Ref: gawk-api-version1205768
+Node: Extension GMP/MPFR Versioning1207555
+Node: Extension API Informational Variables1209259
+Node: Extension API Boilerplate1210512
+Node: Changes from API V11214642
+Node: Finding Extensions1216274
+Node: Extension Example1216849
+Node: Internal File Description1217671
+Node: Internal File Ops1221963
+Ref: Internal File Ops-Footnote-11233513
+Node: Using Internal File Ops1233661
+Ref: Using Internal File Ops-Footnote-11236094
+Node: Extension Samples1236372
+Node: Extension Sample File Functions1237941
+Node: Extension Sample Fnmatch1246066
+Node: Extension Sample Fork1247661
+Node: Extension Sample Inplace1248937
+Node: Extension Sample Ord1253039
+Node: Extension Sample Readdir1253915
+Ref: table-readdir-file-types1254704
+Node: Extension Sample Revout1256060
+Node: Extension Sample Rev2way1256657
+Node: Extension Sample Read write array1257409
+Node: Extension Sample Readfile1260683
+Node: Extension Sample Time1261814
+Node: Extension Sample API Tests1263814
+Node: gawkextlib1264322
+Node: Extension summary1267354
+Node: Extension Exercises1271202
+Node: Language History1272472
+Node: V7/SVR3.11274184
+Node: SVR41276534
+Node: POSIX1278066
+Node: BTL1279491
+Node: POSIX/GNU1280258
+Ref: Gawk Extension Functions1283648
+Node: Feature History1287072
+Node: Common Extensions1306913
+Node: Ranges and Locales1308388
+Ref: Ranges and Locales-Footnote-11313173
+Ref: Ranges and Locales-Footnote-21313200
+Ref: Ranges and Locales-Footnote-31313435
+Node: Contributors1313658
Node: History summary1320010
Node: Installation1321452
Node: Gawk Distribution1322416
diff --git a/doc/gawk.texi b/doc/gawk.texi
index bd3e1d71..a78eb6d9 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -195,14 +195,12 @@
@set FFN File name
@set DF data file
@set DDF Data file
-@set PVERSION version
@end ifclear
@ifset FOR_PRINT
@set FN filename
@set FFN Filename
@set DF datafile
@set DDF Datafile
-@set PVERSION version
@end ifset
@c For HTML, spell out email addresses, to avoid problems with
@@ -1542,11 +1540,11 @@ wrote the bulk of
@cite{@value{GAWKINETTITLE}}
(a separate document, available as part of the @command{gawk} distribution).
His code finally became part of the main @command{gawk} distribution
-with @command{gawk} @value{PVERSION} 3.1.
+with @command{gawk} version 3.1.
John Haque rewrote the @command{gawk} internals, in the process providing
an @command{awk}-level debugger. This version became available as
-@command{gawk} @value{PVERSION} 4.0 in 2011.
+@command{gawk} version 4.0 in 2011.
@xref{Contributors}
for a full list of those who have made important contributions to
@command{gawk}.
@@ -4020,7 +4018,7 @@ a newline character (even if it doesn't). This makes
building
the total program easier.
@quotation CAUTION
-Prior to @value{PVERSION} 5.0, there was
+Prior to version 5.0, there was
no requirement that each @var{program-text}
be a full syntactic unit. I.e., the following worked:
@@ -4216,7 +4214,7 @@ if @command{gawk} is not compiled to use the GNU MPFR and
MP libraries
@cindex @env{GAWK_NO_MPFR_WARN} environment variable
@cindex environment variables @subentry @env{GAWK_NO_MPFR_WARN}
@end ignore
-As of @value{PVERSION} 5.2,
+As of version 5.2,
the arbitrary precision arithmetic features in @command{gawk}
are ``on parole.''
The primary maintainer is no longer willing to support this feature,
@@ -4721,7 +4719,7 @@ as an entry in the path or write a null entry in the path.
Different past versions of @command{gawk} would also look explicitly in
the current directory, either before or after the path search. As of
-@value{PVERSION} 4.1.2, this no longer happens; if you wish to look
+version 4.1.2, this no longer happens; if you wish to look
in the current directory, you must include @file{.} either as a separate
entry or as a null entry in the search path.
@end quotation
@@ -5174,7 +5172,7 @@ they will @emph{not} be in a future release).
@c This happened long enough ago that we can remove it.
The process-related special files @file{/dev/pid}, @file{/dev/ppid},
@file{/dev/pgrpid}, and @file{/dev/user} were deprecated in @command{gawk}
-3.1, but still worked. As of @value{PVERSION} 4.0, they are no longer
+3.1, but still worked. As of version 4.0, they are no longer
interpreted specially by @command{gawk}. (Use @code{PROCINFO} instead;
see @ref{Auto-set}.)
@end ignore
@@ -5186,7 +5184,7 @@ in case some option becomes obsolete in a future version
of @command{gawk}.
@end ignore
As of
-@command{gawk} @value{PVERSION} 5.2,
+@command{gawk} version 5.2,
the arbitrary precision arithmetic feature is ``on parole.''
This feature is now being
supported by a volunteer in the development team and not by the primary
@@ -5615,7 +5613,7 @@ hexadecimal digits into the value until a non-hexadecimal
digit
or the end of the string was encountered.
However, using more than two hexadecimal digits produced
undefined results.
-As of @value{PVERSION} 4.2, only two digits
+As of version 4.2, only two digits
are processed.
@end quotation
@@ -6038,7 +6036,7 @@ constants,
@command{gawk} did @emph{not} match interval expressions
in regexps.
-However, beginning with @value{PVERSION} 4.0,
+However, beginning with version 4.0,
@command{gawk} does match interval expressions by default.
This is because compatibility with POSIX has become more
important to most @command{gawk} users than compatibility with
@@ -6057,7 +6055,7 @@ in a way that cannot be interpreted as an interval
expression
@cindex BWK @command{awk} @subentry interval expressions in
As mentioned, interval expressions were not traditionally available
in @command{awk}. In March of 2019, BWK @command{awk} (finally) acquired them.
-Starting with @value{PVERSION} 5.2, @command{gawk}'s
+Starting with version 5.2, @command{gawk}'s
@option{--traditional} option no longer disables interval
expressions in regular expressions.
@@ -6701,9 +6699,9 @@ a program case insensitive without having to edit it.
@c @cindex ISO Latin-1
In multibyte locales, the equivalences between upper- and lowercase
characters are tested based on the wide-character values of the locale's
-character set. Prior to @value{PVERSION} 5.0, single-byte characters were
+character set. Prior to version 5.0, single-byte characters were
tested based on the ISO-8859-1 (ISO Latin-1) character set. However, as
-of @value{PVERSION} 5.0, single-byte characters are also tested based on
+of version 5.0, single-byte characters are also tested based on
the values of the locale's character set.@footnote{If you don't understand
this, don't worry about it; it just means that @command{gawk} does the
right thing.}
@@ -8186,7 +8184,7 @@ a system with card readers is another story!)
@node Skipping intervening
@subsection Skipping Intervening Fields
-Starting in @value{PVERSION} 4.2, each field width may optionally be
+Starting in version 4.2, each field width may optionally be
preceded by a colon-separated value specifying the number of characters
to skip before the field starts. Thus, the preceding program could be
rewritten to specify @code{FIELDWIDTHS} like so:
@@ -8215,7 +8213,7 @@ There are times when fixed-width data may be followed by
additional data
that has no fixed length. Such data may or may not be present, but if
it is, it should be possible to get at it from an @command{awk} program.
-Starting with @value{PVERSION} 4.2, in order to provide a way to say ``anything
+Starting with version 4.2, in order to provide a way to say ``anything
else in the record after the defined fields,'' @command{gawk}
allows you to add a final @samp{*} character to the value of
@code{FIELDWIDTHS}. There can only be one such character, and it must
@@ -8240,7 +8238,7 @@ should be based on the contents of @code{FIELDWIDTHS}?
Or, what happens
if there is more data than expected?
For many years, what happens in these cases was not well defined. Starting
-with @value{PVERSION} 4.2, the rules are as follows:
+with version 4.2, the rules are as follows:
@table @asis
@item Enough data for some fields
@@ -8341,7 +8339,7 @@ Putting this to use, here is a simple program to parse
the data:
@c file eg/misc/simple-csv.awk
@group
BEGIN @{
- FPAT = "([^,]+)|(\"[^\"]+\")"
+ FPAT = "([^,]*)|(\"[^\"]+\")"
@}
@end group
@@ -8458,7 +8456,7 @@ parsing is an elegant approach for the majority of cases,
but not all.
For a more general solution to working with CSV data, see
@ref{Comma Separated Fields}. If your version of @command{gawk}
is prior to version 5.3, we recommend that you use Manuel Collado's
-@uref{http://mcollado.z15.es/xgawk/, @code{CSVMODE} library for
+@uref{http://mcollado.z15.es/gawk-extras/, @code{CSVMODE} library for
@command{gawk}}.
As with @code{FS}, the @code{IGNORECASE} variable (@pxref{User-modified})
@@ -11109,10 +11107,10 @@ a system problem closing the file or process.
In these cases, @command{gawk} sets the predefined variable
@code{ERRNO} to a string describing the problem.
-In @command{gawk}, starting with @value{PVERSION} 4.2, when closing a pipe or
+In @command{gawk}, starting with version 4.2, when closing a pipe or
coprocess (input or output), the return value is the exit status of the
command, as described in @ref{table-close-pipe-return-values}.@footnote{Prior
-to @value{PVERSION} 4.2, the return value from closing a pipe or co-process
+to version 4.2, the return value from closing a pipe or co-process
was the full 16-bit exit value as defined by the @code{wait()} system
call.} Otherwise, it is the return value from the system's @code{close()}
or @code{fclose()} C functions when closing input or output files,
@@ -13415,7 +13413,7 @@ a <= b && a >= b
@end quotation
@cindex POSIX mode
-As of @value{PVERSION} 4.2, @command{gawk} continues to use locale
+As of version 4.2, @command{gawk} continues to use locale
collating order for @code{<}, @code{<=}, @code{>}, and @code{>=} only
in POSIX mode.
@@ -14523,9 +14521,9 @@ The bodies of the @code{BEGINFILE} rules execute just
before
@command{gawk} reads the first record from a file. @code{FILENAME}
is set to the name of the current file, and @code{FNR} is set to zero.
-Prior to @value{PVERSION} 5.1.1 of @command{gawk}, as an accident of the
+Prior to version 5.1.1 of @command{gawk}, as an accident of the
implementation, @code{$0} and the fields retained any previous values
-they had in @code{BEGINFILE} rules. Starting with @value{PVERSION}
+they had in @code{BEGINFILE} rules. Starting with version
5.1.1, @code{$0} and the fields are cleared, since no record has been
read yet from the file that is about to be processed.
@@ -15570,7 +15568,7 @@ Its default value is @code{"%.6g"}.
@item FIELDWIDTHS #
A space-separated list of columns that tells @command{gawk}
how to split input with fixed columnar boundaries.
-Starting in @value{PVERSION} 4.2, each field width may optionally be
+Starting in version 4.2, each field width may optionally be
preceded by a colon-separated value specifying the number of characters to skip
before the field starts.
Assigning a value to @code{FIELDWIDTHS}
@@ -15838,7 +15836,7 @@ For POSIX @command{awk}, changing this array does not
affect the
environment passed on to any programs that @command{awk} may spawn via
redirection or the @code{system()} function.
-However, beginning with @value{PVERSION} 4.2, if not in POSIX
+However, beginning with version 4.2, if not in POSIX
compatibility mode, @command{gawk} does update its own environment when
@code{ENVIRON} is changed, thus changing the environment seen by programs
that it creates. You should therefore be especially careful if you
@@ -16232,7 +16230,7 @@ if an element in @code{SYMTAB} is an array.
Also, you may not use the @code{delete} statement with the
@code{SYMTAB} array.
-Prior to @value{PVERSION} 5.0 of @command{gawk}, you could
+Prior to version 5.0 of @command{gawk}, you could
use an index for @code{SYMTAB} that was not a predefined identifier:
@example
@@ -18168,7 +18166,7 @@ sequences of random numbers. However, nothing requires
that an
@command{awk} version of @code{rand()}. In fact, for many years,
@command{gawk} used the BSD @code{random()} function, which is
considerably better than @code{rand()}, to produce random numbers.
-From @value{PVERSION} 4.1.4, courtesy of Nelson H.F.@: Beebe, @command{gawk}
+From version 4.1.4, courtesy of Nelson H.F.@: Beebe, @command{gawk}
uses the Bays-Durham shuffle buffer algorithm which considerably extends
the period of the random number generator, and eliminates short-range and
long-range correlations that might exist in the original generator.}
@@ -19287,7 +19285,7 @@ These rules are presented in @ref{table-posix-sub}.
@multitable @columnfractions .20 .20 .60
@headitem You type @tab @code{sub()} sees @tab @code{sub()} generates
@item @code{\\\\\\&} @tab @code{\\\&} @tab A literal @samp{\&}
-@item @code{@ @ \\\\&} @tab @code{@ \\&} @tab A literal @samp{\}, followed by
the matched te@ t
+@item @code{@ @ \\\\&} @tab @code{@ \\&} @tab A literal @samp{\}, followed by
the matched text
@item @code{@ @ @ @ \\&} @tab @code{@ @ \&} @tab A literal @samp{&}
@item @code{@ @ @ @ \\q} @tab @code{@ @ \q} @tab A literal @samp{\q}
@item @code{@ @ @ \\\\} @tab @code{@ @ \\} @tab @code{\}
@@ -19344,17 +19342,17 @@ _bigskip}
The only case where the difference is noticeable is the last one: @samp{\\\\}
is seen as @samp{\\} and produces @samp{\} instead of @samp{\\}.
-Starting with @value{PVERSION} 3.1.4, @command{gawk} followed the POSIX rules
+Starting with version 3.1.4, @command{gawk} followed the POSIX rules
when @option{--posix} was specified (@pxref{Options}). Otherwise,
it continued to follow the proposed rules, as
that had been its behavior for many years.
-When @value{PVERSION} 4.0.0 was released, the @command{gawk} maintainer
+When version 4.0.0 was released, the @command{gawk} maintainer
made the POSIX rules the default, breaking well over a decade's worth
of backward compatibility.@footnote{This was rather naive of him, despite
there being a note in this @value{SECTION} indicating that the next major
version
would move to the POSIX rules.} Needless to say, this was a bad idea,
-and as of @value{PVERSION} 4.0.1, @command{gawk} resumed its historical
+and as of version 4.0.1, @command{gawk} resumed its historical
behavior, and only follows the POSIX rules when @option{--posix} is given.
The rules for @code{gensub()} are considerably simpler. At the runtime
@@ -19497,7 +19495,7 @@ then @command{awk} flushes the buffers for @emph{all}
open output files
and pipes.
@quotation NOTE
-Prior to @value{PVERSION} 4.0.2, @command{gawk}
+Prior to version 4.0.2, @command{gawk}
would flush only the standard output if there was no argument,
and flush all output files and pipes if the argument was the null
string. This was changed in order to be compatible with BWK
@@ -20294,7 +20292,7 @@ Return the bitwise XOR of the arguments. There must be
at least two.
@end table
@quotation CAUTION
-Beginning with @command{gawk} @value{PVERSION} 4.2, negative
+Beginning with @command{gawk} version 4.2, negative
operands are not allowed for any of these functions. A negative
operand produces a fatal error. See the sidebar
``Beware The Smoke and Mirrors!'' for more information as to why.
@@ -21513,7 +21511,7 @@ $ @kbd{gawk 'BEGIN @{ print typeof(x["foo"]) @}'}
@print{} untyped
@end example
-Note that prior to @value{PVERSION} 5.2, array elements
+Note that prior to version 5.2, array elements
that come into existence simply by referencing them
were different, they were automatically forced to be scalars:
@@ -21946,7 +21944,7 @@ processing arrays. This is described in @ref{Walking
Arrays}.
Remember that you must supply a leading @samp{@@} in front of an indirect
function call.
-Starting with @value{PVERSION} 4.1.2 of @command{gawk}, indirect function
+Starting with version 4.1.2 of @command{gawk}, indirect function
calls may also be used with built-in functions and with extension functions
(@pxref{Dynamic Extensions}). There are some limitations when calling
built-in functions indirectly, as follows.
@@ -22274,7 +22272,7 @@ The conventions presented in this @value{SECTION} are
exactly
that: conventions. You are not required to write your programs this
way---we merely recommend that you do so.
-Beginning with @value{PVERSION} 5.0, @command{gawk} provides
+Beginning with version 5.0, @command{gawk} provides
a powerful mechanism for solving the problems described in this
section: @dfn{namespaces}. Namespaces and their use are described
in detail in @ref{Namespaces}.
@@ -30684,7 +30682,7 @@ code, it will appear that way in the output.
@cindex persistent memory
@cindex PMA memory allocator
-Starting with @value{PVERSION} 5.2, @command{gawk} supports
+Starting with version 5.2, @command{gawk} supports
@dfn{persistent memory}. This experimental feature stores the values of
all of @command{gawk}'s variables, arrays and user-defined functions
in a persistent heap, which resides in a file in
@@ -31904,7 +31902,7 @@ complete detail in
@end ifnotinfo
As of this writing, the latest version of GNU @command{gettext} is
@uref{ftp://ftp.gnu.org/gnu/gettext/gettext-0.19.8.1.tar.gz,
-@value{PVERSION} 0.19.8.1}.
+version 0.19.8.1}.
If a translation of @command{gawk}'s messages exists,
then @command{gawk} produces usage messages, warnings,
@@ -33493,7 +33491,7 @@ are much fewer namespaces in use by any given program,
and thus much
less chance for collisions.) These facilities are sometimes referred
to as @dfn{packages} or @dfn{modules}.
-Starting with @value{PVERSION} 5.0, @command{gawk} provides a
+Starting with version 5.0, @command{gawk} provides a
simple mechanism to put functions and global variables into separate
namespaces.
@node Qualified Names
@@ -34183,7 +34181,7 @@ arithmetic in @command{gawk}.
@node MPFR On Parole
@subsection Arbitrary Precision Arithmetic is On Parole!
-As of @value{PVERSION} 5.2,
+As of version 5.2,
arbitrary precision arithmetic in @command{gawk}
is ``on parole.'' The primary @command{gawk} maintainer is no
longer maintaining it. Fortunately, a volunteer from the development
@@ -35330,7 +35328,7 @@ Thus, @samp{+nan} and @samp{+NaN} are the same.
@cindex POSIX mode
Besides handling input, @command{gawk} also needs to print ``correct'' values
on
-output when a value is either NaN or infinity. Starting with @value{PVERSION}
+output when a value is either NaN or infinity. Starting with version
4.2.2, for such values @command{gawk} prints one of the four strings
just described: @samp{+inf}, @samp{-inf}, @samp{+nan}, or @samp{-nan}.
Similarly, in POSIX mode, @command{gawk} prints the result of
@@ -40891,7 +40889,7 @@ long options
@item
Support for the following obsolete systems was removed from the code
-and the documentation for @command{gawk} @value{PVERSION} 4.0:
+and the documentation for @command{gawk} version 4.0:
@c nested table
@itemize @value{MINUS}
@@ -40935,7 +40933,7 @@ GCC for Alpha has not been tested for a while.
@item
Support for the following obsolete system was removed from the code
-for @command{gawk} @value{PVERSION} 4.1:
+for @command{gawk} version 4.1:
@c nested table
@itemize @value{MINUS}
@@ -40945,7 +40943,7 @@ Ultrix
@item
Support for the following systems was removed from the code
-for @command{gawk} @value{PVERSION} 4.2:
+for @command{gawk} version 4.2:
@c nested table
@itemize @value{MINUS}
@@ -40958,7 +40956,7 @@ GNU/Linux on Alpha
@item
Support for the following systems was removed from the code
-for @command{gawk} @value{PVERSION} 5.2:
+for @command{gawk} version 5.2:
@c nested table
@@ -41963,7 +41961,7 @@ like, ``Why does @samp{[A-Z]} match lowercase
letters?!?''
This situation existed for close to 10 years, if not more, and
the @command{gawk} maintainer grew weary of trying to explain that
@command{gawk} was being nicely standards-compliant, and that the issue
-was in the user's locale. During the development of @value{PVERSION} 4.0,
+was in the user's locale. During the development of version 4.0,
he modified @command{gawk} to always treat ranges in the original,
pre-POSIX fashion, unless @option{--posix} was used
(@pxref{Options}).@footnote{And
thus was born the Campaign for Rational Range Interpretation (or
@@ -42232,9 +42230,8 @@ Efraim Yawitz contributed the original text for
@ref{Debugger}.
@cindex Naman, John
John Naman contributed the original text for @ref{Shadowed Variables}.
-@cindex Ferguson, Stuar
+@cindex Ferguson, Stuart
@item
-
Stuart Ferguson reworked the text in @ref{Splitting By Content}.
@item
-----------------------------------------------------------------------
Summary of changes:
awklib/eg/misc/simple-csv.awk | 2 +-
doc/ChangeLog | 6 +
doc/gawk.info | 931 +++++++++++++++++++++---------------------
doc/gawk.texi | 95 +++--
4 files changed, 518 insertions(+), 516 deletions(-)
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [SCM] gawk branch, gawk-5.3-stable, updated. gawk-4.1.0-5577-g3b4d4661,
Arnold Robbins <=