[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gawk-diffs] [SCM] gawk branch, gawk-4.2-stable, updated. gawk-4.1.0-308
|
From: |
Arnold Robbins |
|
Subject: |
[gawk-diffs] [SCM] gawk branch, gawk-4.2-stable, updated. gawk-4.1.0-3083-g7eac083 |
|
Date: |
Mon, 26 Nov 2018 13:46:22 -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, gawk-4.2-stable has been updated
via 7eac08335f61dc6b0f236f9bf7c3ad434576b70f (commit)
from f33f0191191802f34dc2203d64e6cad40b8d6865 (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=7eac08335f61dc6b0f236f9bf7c3ad434576b70f
commit 7eac08335f61dc6b0f236f9bf7c3ad434576b70f
Author: Arnold D. Robbins <address@hidden>
Date: Mon Nov 26 20:46:03 2018 +0200
Doc update on split().
diff --git a/doc/ChangeLog b/doc/ChangeLog
index 0772a7d..87ca389 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,11 @@
+2018-11-26 Arnold D. Robbins <address@hidden>
+
+ * gawktexi.in: Document that split() third arg is like FS, if it's
+ a single character, that character is used, even if it's a
+ regexp metacharacter.
+ * gawk.1: Ditto.
+ Thanks to R <address@hidden> for the report.
+
2018-11-25 Arnold D. Robbins <address@hidden>
* gawktexi.in: Small typo fix.
diff --git a/doc/gawk.1 b/doc/gawk.1
index a244869..7bcef9d 100644
--- a/doc/gawk.1
+++ b/doc/gawk.1
@@ -13,7 +13,7 @@
. if \w'\(rq' .ds rq "\(rq
. \}
.\}
-.TH GAWK 1 "Apr 08 2018" "Free Software Foundation" "Utility Commands"
+.TH GAWK 1 "Nov 26 2018" "Free Software Foundation" "Utility Commands"
.SH NAME
gawk \- pattern scanning and processing language
.SH SYNOPSIS
@@ -3031,7 +3031,7 @@ is the possibly null separator that appeared after
The value of
.B seps[0]
is the possibly null leading separator.
-\&\fRIf
+If
.I r
is omitted,
.B FPAT
@@ -3071,7 +3071,7 @@ between
.BI a[ i ]
and
.BI a[ i +1]\fR.
-\&\fRIf
+If
.I r
is a single space, then leading whitespace in
.I s
@@ -3084,6 +3084,10 @@ where
is the return value of
.BI split( s ", " a ", " r ", " seps )\fR.
Splitting behaves identically to field splitting, described above.
+In particular, if
+.I r
+is a single-character string, that string acts as the separator,
+even if it happens to be a regular expression metacharacter.
.TP
.BI sprintf( fmt , " expr-list" )
Print
diff --git a/doc/gawk.info b/doc/gawk.info
index de67145..5fbeba4 100644
--- a/doc/gawk.info
+++ b/doc/gawk.info
@@ -12956,8 +12956,8 @@ Options::):
into 'SEPS[N]', where N is the return value of 'split()' (i.e., the
number of elements in ARRAY).
- The 'split()' function splits strings into pieces in a manner
- similar to the way input lines are split into fields. For example:
+ The 'split()' function splits strings into pieces in the same way
+ that input lines are split into fields. For example:
split("cul-de-sac", a, "-", seps)
@@ -12981,7 +12981,9 @@ Options::):
separated by runs of whitespace. Also, as with input field
splitting, if FIELDSEP is the null string, each individual
character in the string is split into its own array element.
- (c.e.)
+ (c.e.) Additionally, if FIELDSEP is a single-character string,
+ that string acts as the separator, even if its value is a regular
+ expression metacharacter.
Note, however, that 'RS' has no effect on the way 'split()' works.
Even though 'RS = ""' causes the newline character to also be an
@@ -33021,7 +33023,7 @@ Index
* * (asterisk), * operator, as regexp operator: Regexp Operators.
(line 89)
* * (asterisk), * operator, null strings, matching: String Functions.
- (line 540)
+ (line 542)
* * (asterisk), ** operator: Arithmetic Ops. (line 81)
* * (asterisk), ** operator <1>: Precedence. (line 48)
* * (asterisk), **= operator: Assignment Ops. (line 129)
@@ -33420,7 +33422,7 @@ Index
* asterisk (*), * operator, as regexp operator: Regexp Operators.
(line 89)
* asterisk (*), * operator, null strings, matching: String Functions.
- (line 540)
+ (line 542)
* asterisk (*), ** operator: Arithmetic Ops. (line 81)
* asterisk (*), ** operator <1>: Precedence. (line 48)
* asterisk (*), **= operator: Assignment Ops. (line 129)
@@ -33643,7 +33645,7 @@ Index
* Brian Kernighan's awk <8>: Continue Statement. (line 44)
* Brian Kernighan's awk <9>: Nextfile Statement. (line 47)
* Brian Kernighan's awk <10>: Delete. (line 51)
-* Brian Kernighan's awk <11>: String Functions. (line 496)
+* Brian Kernighan's awk <11>: String Functions. (line 498)
* Brian Kernighan's awk <12>: Gory Details. (line 19)
* Brian Kernighan's awk <13>: I/O Functions. (line 43)
* Brian Kernighan's awk, extensions: BTL. (line 6)
@@ -33686,7 +33688,7 @@ Index
* case sensitivity, and regexps: User-modified. (line 79)
* case sensitivity, and string comparisons: User-modified. (line 79)
* case sensitivity, array indices and: Array Intro. (line 100)
-* case sensitivity, converting case: String Functions. (line 526)
+* case sensitivity, converting case: String Functions. (line 528)
* case sensitivity, example programs: Library Functions. (line 53)
* case sensitivity, gawk: Case-sensitivity. (line 26)
* case sensitivity, regexps and: Case-sensitivity. (line 6)
@@ -33820,9 +33822,9 @@ Index
* control statements: Statements. (line 6)
* controlling array scanning order: Controlling Scanning.
(line 14)
-* convert string to lower case: String Functions. (line 527)
-* convert string to number: String Functions. (line 394)
-* convert string to upper case: String Functions. (line 533)
+* convert string to lower case: String Functions. (line 529)
+* convert string to number: String Functions. (line 396)
+* convert string to upper case: String Functions. (line 535)
* converting integer array subscripts: Numeric Array Subscripts.
(line 31)
* converting, dates to timestamps: Time Functions. (line 78)
@@ -33905,7 +33907,7 @@ Index
(line 149)
* dark corner, regexp constants, as arguments to user-defined functions:
Standard Regexp Constants.
(line 43)
-* dark corner, split() function: String Functions. (line 364)
+* dark corner, split() function: String Functions. (line 366)
* dark corner, string continuation: Scalar Constants. (line 53)
* dark corner, strings, storing: gawk split records. (line 82)
* dark corner, value of ARGV[0]: Auto-set. (line 39)
@@ -34464,7 +34466,7 @@ Index
* format time string: Time Functions. (line 50)
* formats, numeric output: OFMT. (line 6)
* formatting output: Printf. (line 6)
-* formatting strings: String Functions. (line 387)
+* formatting strings: String Functions. (line 389)
* forward slash (/) to enclose regular expressions: Regexp. (line 10)
* forward slash (/), / operator: Precedence. (line 54)
* forward slash (/), /= operator: Assignment Ops. (line 129)
@@ -34738,7 +34740,7 @@ Index
* gsub: Standard Regexp Constants.
(line 43)
* gsub <1>: String Functions. (line 140)
-* gsub() function, arguments of: String Functions. (line 466)
+* gsub() function, arguments of: String Functions. (line 468)
* gsub() function, escape processing: Gory Details. (line 6)
* Guerrero, Juan Manuel: Acknowledgments. (line 60)
* Guerrero, Juan Manuel <1>: Contributors. (line 150)
@@ -35028,7 +35030,7 @@ Index
* matching, expressions, See comparison expressions: Typing and Comparison.
(line 9)
* matching, leftmost longest: Multiple Line. (line 26)
-* matching, null strings: String Functions. (line 540)
+* matching, null strings: String Functions. (line 542)
* mawk utility: Escape Sequences. (line 121)
* mawk utility <1>: Getline/Pipe. (line 62)
* mawk utility <2>: Concatenation. (line 36)
@@ -35118,7 +35120,7 @@ Index
(line 43)
* null strings, converting numbers to strings: Strings And Numbers.
(line 21)
-* null strings, matching: String Functions. (line 540)
+* null strings, matching: String Functions. (line 542)
* number as string of bits: Bitwise Functions. (line 109)
* number of array elements: String Functions. (line 201)
* number sign (#), #! (executable scripts): Executable Scripts.
@@ -35296,7 +35298,7 @@ Index
* portability, operators: Increment Ops. (line 60)
* portability, operators, not in POSIX awk: Precedence. (line 97)
* portability, POSIXLY_CORRECT environment variable: Options. (line 376)
-* portability, substr() function: String Functions. (line 516)
+* portability, substr() function: String Functions. (line 518)
* portable object files: Explaining gettext. (line 37)
* portable object files <1>: Translator i18n. (line 6)
* portable object files, converting to message object files: I18N Example.
@@ -35548,7 +35550,7 @@ Index
* regular expressions, searching for: Egrep Program. (line 6)
* relational operators, See comparison operators: Typing and Comparison.
(line 9)
-* replace in string: String Functions. (line 412)
+* replace in string: String Functions. (line 414)
* retrying input: Retrying Input. (line 6)
* return debugger command: Debugger Execution Control.
(line 54)
@@ -35718,7 +35720,7 @@ Index
(line 37)
* sidebar, Interactive Versus Noninteractive Buffering: I/O Functions.
(line 74)
-* sidebar, Matching the Null String: String Functions. (line 538)
+* sidebar, Matching the Null String: String Functions. (line 540)
* sidebar, Operator Evaluation Order: Increment Ops. (line 58)
* sidebar, Piping into sh: Redirection. (line 134)
* sidebar, Pre-POSIX awk Used OFMT for String Conversion: Strings And Numbers.
@@ -35796,7 +35798,7 @@ Index
* split() function, array elements, deleting: Delete. (line 61)
* split.awk program: Split Program. (line 30)
* sprintf: OFMT. (line 15)
-* sprintf <1>: String Functions. (line 387)
+* sprintf <1>: String Functions. (line 389)
* sprintf() function, OFMT variable and: User-modified. (line 116)
* sprintf() function, print/printf statements and: Round Function.
(line 6)
@@ -35842,7 +35844,7 @@ Index
* strings, continuation across lines: Scalar Constants. (line 53)
* strings, converting: Strings And Numbers. (line 6)
* strings, converting <1>: Bitwise Functions. (line 109)
-* strings, converting letter case: String Functions. (line 526)
+* strings, converting letter case: String Functions. (line 528)
* strings, converting, numbers to: User-modified. (line 30)
* strings, converting, numbers to <1>: User-modified. (line 107)
* strings, empty, See null strings: awk split records. (line 121)
@@ -35853,13 +35855,13 @@ Index
* strings, null: Regexp Field Splitting.
(line 43)
* strings, numeric: Variable Typing. (line 67)
-* strtonum: String Functions. (line 394)
+* strtonum: String Functions. (line 396)
* strtonum() function (gawk), --non-decimal-data option and: Nondecimal Data.
(line 35)
* sub: Standard Regexp Constants.
(line 43)
-* sub <1>: String Functions. (line 412)
-* sub() function, arguments of: String Functions. (line 466)
+* sub <1>: String Functions. (line 414)
+* sub() function, arguments of: String Functions. (line 468)
* sub() function, escape processing: Gory Details. (line 6)
* subscript separators: User-modified. (line 149)
* subscripts in arrays, multidimensional: Multidimensional. (line 10)
@@ -35873,8 +35875,8 @@ Index
* SUBSEP variable, and multidimensional arrays: Multidimensional.
(line 16)
* substitute in string: String Functions. (line 89)
-* substr: String Functions. (line 485)
-* substring: String Functions. (line 485)
+* substr: String Functions. (line 487)
+* substring: String Functions. (line 487)
* Sumner, Andrew: Other Versions. (line 64)
* supplementary groups of gawk process: Auto-set. (line 271)
* switch statement: Switch Statement. (line 6)
@@ -35934,8 +35936,8 @@ Index
* timestamps, converting dates to: Time Functions. (line 78)
* timestamps, formatted: Getlocaltime Function.
(line 6)
-* tolower: String Functions. (line 527)
-* toupper: String Functions. (line 533)
+* tolower: String Functions. (line 529)
+* toupper: String Functions. (line 535)
* tr utility: Translate Program. (line 6)
* trace debugger command: Miscellaneous Debugger Commands.
(line 108)
@@ -35961,7 +35963,7 @@ Index
* troubleshooting, gawk, fatal errors, function arguments: Calling Built-in.
(line 16)
* troubleshooting, getline function: File Checking. (line 25)
-* troubleshooting, gsub()/sub() functions: String Functions. (line 476)
+* troubleshooting, gsub()/sub() functions: String Functions. (line 478)
* troubleshooting, match() function: String Functions. (line 292)
* troubleshooting, print statement, omitting commas: Print Examples.
(line 30)
@@ -35971,7 +35973,7 @@ Index
* troubleshooting, regexp constants vs. string constants: Computed Regexps.
(line 40)
* troubleshooting, string concatenation: Concatenation. (line 27)
-* troubleshooting, substr() function: String Functions. (line 503)
+* troubleshooting, substr() function: String Functions. (line 505)
* troubleshooting, system() function: I/O Functions. (line 128)
* troubleshooting, typographical errors, global variables: Options.
(line 99)
@@ -36373,338 +36375,338 @@ Ref: Numeric Functions-Footnote-1535896
Ref: Numeric Functions-Footnote-2536253
Ref: Numeric Functions-Footnote-3536301
Node: String Functions536573
-Ref: String Functions-Footnote-1560282
-Ref: String Functions-Footnote-2560410
-Ref: String Functions-Footnote-3560658
-Node: Gory Details560745
-Ref: table-sub-escapes562536
-Ref: table-sub-proposed564055
-Ref: table-posix-sub565418
-Ref: table-gensub-escapes566959
-Ref: Gory Details-Footnote-1567782
-Node: I/O Functions567936
-Ref: table-system-return-values574404
-Ref: I/O Functions-Footnote-1576484
-Ref: I/O Functions-Footnote-2576632
-Node: Time Functions576752
-Ref: Time Functions-Footnote-1587423
-Ref: Time Functions-Footnote-2587491
-Ref: Time Functions-Footnote-3587649
-Ref: Time Functions-Footnote-4587760
-Ref: Time Functions-Footnote-5587872
-Ref: Time Functions-Footnote-6588099
-Node: Bitwise Functions588365
-Ref: table-bitwise-ops588959
-Ref: Bitwise Functions-Footnote-1595022
-Ref: Bitwise Functions-Footnote-2595195
-Node: Type Functions595386
-Node: I18N Functions598137
-Node: User-defined599788
-Node: Definition Syntax600593
-Ref: Definition Syntax-Footnote-1606280
-Node: Function Example606351
-Ref: Function Example-Footnote-1609273
-Node: Function Caveats609295
-Node: Calling A Function609813
-Node: Variable Scope610771
-Node: Pass By Value/Reference613765
-Node: Return Statement617264
-Node: Dynamic Typing620243
-Node: Indirect Calls621173
-Ref: Indirect Calls-Footnote-1631425
-Node: Functions Summary631553
-Node: Library Functions634258
-Ref: Library Functions-Footnote-1637865
-Ref: Library Functions-Footnote-2638008
-Node: Library Names638179
-Ref: Library Names-Footnote-1641639
-Ref: Library Names-Footnote-2641862
-Node: General Functions641948
-Node: Strtonum Function643051
-Node: Assert Function646073
-Node: Round Function649399
-Node: Cliff Random Function650939
-Node: Ordinal Functions651955
-Ref: Ordinal Functions-Footnote-1655018
-Ref: Ordinal Functions-Footnote-2655270
-Node: Join Function655480
-Ref: Join Function-Footnote-1657250
-Node: Getlocaltime Function657450
-Node: Readfile Function661192
-Node: Shell Quoting663169
-Node: Data File Management664570
-Node: Filetrans Function665202
-Node: Rewind Function669298
-Node: File Checking671208
-Ref: File Checking-Footnote-1672542
-Node: Empty Files672743
-Node: Ignoring Assigns674722
-Node: Getopt Function676272
-Ref: Getopt Function-Footnote-1687741
-Node: Passwd Functions687941
-Ref: Passwd Functions-Footnote-1696780
-Node: Group Functions696868
-Ref: Group Functions-Footnote-1704766
-Node: Walking Arrays704973
-Node: Library Functions Summary707981
-Node: Library Exercises709387
-Node: Sample Programs709852
-Node: Running Examples710622
-Node: Clones711350
-Node: Cut Program712574
-Node: Egrep Program722503
-Ref: Egrep Program-Footnote-1730015
-Node: Id Program730125
-Node: Split Program733805
-Ref: Split Program-Footnote-1737263
-Node: Tee Program737392
-Node: Uniq Program740182
-Node: Wc Program747608
-Ref: Wc Program-Footnote-1751863
-Node: Miscellaneous Programs751957
-Node: Dupword Program753170
-Node: Alarm Program755200
-Node: Translate Program760055
-Ref: Translate Program-Footnote-1764620
-Node: Labels Program764890
-Ref: Labels Program-Footnote-1768241
-Node: Word Sorting768325
-Node: History Sorting772397
-Node: Extract Program774232
-Node: Simple Sed782286
-Node: Igawk Program785360
-Ref: Igawk Program-Footnote-1799691
-Ref: Igawk Program-Footnote-2799893
-Ref: Igawk Program-Footnote-3800015
-Node: Anagram Program800130
-Node: Signature Program803192
-Node: Programs Summary804439
-Node: Programs Exercises805653
-Ref: Programs Exercises-Footnote-1809782
-Node: Advanced Features809873
-Node: Nondecimal Data811863
-Node: Array Sorting813454
-Node: Controlling Array Traversal814154
-Ref: Controlling Array Traversal-Footnote-1822522
-Node: Array Sorting Functions822640
-Ref: Array Sorting Functions-Footnote-1827731
-Node: Two-way I/O827927
-Ref: Two-way I/O-Footnote-1835647
-Ref: Two-way I/O-Footnote-2835834
-Node: TCP/IP Networking835916
-Node: Profiling839034
-Ref: Profiling-Footnote-1847706
-Node: Advanced Features Summary848029
-Node: Internationalization849873
-Node: I18N and L10N851353
-Node: Explaining gettext852040
-Ref: Explaining gettext-Footnote-1857932
-Ref: Explaining gettext-Footnote-2858117
-Node: Programmer i18n858282
-Ref: Programmer i18n-Footnote-1863231
-Node: Translator i18n863280
-Node: String Extraction864074
-Ref: String Extraction-Footnote-1865206
-Node: Printf Ordering865292
-Ref: Printf Ordering-Footnote-1868078
-Node: I18N Portability868142
-Ref: I18N Portability-Footnote-1870598
-Node: I18N Example870661
-Ref: I18N Example-Footnote-1873467
-Node: Gawk I18N873540
-Node: I18N Summary874185
-Node: Debugger875526
-Node: Debugging876549
-Node: Debugging Concepts876990
-Node: Debugging Terms878799
-Node: Awk Debugging881374
-Node: Sample Debugging Session882280
-Node: Debugger Invocation882814
-Node: Finding The Bug884200
-Node: List of Debugger Commands890678
-Node: Breakpoint Control892011
-Node: Debugger Execution Control895705
-Node: Viewing And Changing Data899067
-Node: Execution Stack902441
-Node: Debugger Info904078
-Node: Miscellaneous Debugger Commands908149
-Node: Readline Support913211
-Node: Limitations914107
-Node: Debugging Summary916216
-Node: Arbitrary Precision Arithmetic917495
-Node: Computer Arithmetic918980
-Ref: table-numeric-ranges922746
-Ref: table-floating-point-ranges923239
-Ref: Computer Arithmetic-Footnote-1923897
-Node: Math Definitions923954
-Ref: table-ieee-formats927270
-Ref: Math Definitions-Footnote-1927873
-Node: MPFR features927978
-Node: FP Math Caution929696
-Ref: FP Math Caution-Footnote-1930768
-Node: Inexactness of computations931137
-Node: Inexact representation932097
-Node: Comparing FP Values933457
-Node: Errors accumulate934698
-Node: Getting Accuracy936131
-Node: Try To Round938841
-Node: Setting precision939740
-Ref: table-predefined-precision-strings940437
-Node: Setting the rounding mode942267
-Ref: table-gawk-rounding-modes942641
-Ref: Setting the rounding mode-Footnote-1946572
-Node: Arbitrary Precision Integers946751
-Ref: Arbitrary Precision Integers-Footnote-1949926
-Node: Checking for MPFR950075
-Node: POSIX Floating Point Problems951549
-Ref: POSIX Floating Point Problems-Footnote-1955834
-Node: Floating point summary955872
-Node: Dynamic Extensions958062
-Node: Extension Intro959615
-Node: Plugin License960881
-Node: Extension Mechanism Outline961678
-Ref: figure-load-extension962117
-Ref: figure-register-new-function963682
-Ref: figure-call-new-function964774
-Node: Extension API Description966836
-Node: Extension API Functions Introduction968478
-Node: General Data Types974018
-Ref: General Data Types-Footnote-1982379
-Node: Memory Allocation Functions982678
-Ref: Memory Allocation Functions-Footnote-1986888
-Node: Constructor Functions986987
-Node: Registration Functions990573
-Node: Extension Functions991258
-Node: Exit Callback Functions996473
-Node: Extension Version String997723
-Node: Input Parsers998386
-Node: Output Wrappers1011107
-Node: Two-way processors1015619
-Node: Printing Messages1017884
-Ref: Printing Messages-Footnote-11019055
-Node: Updating ERRNO1019208
-Node: Requesting Values1019947
-Ref: table-value-types-returned1020684
-Node: Accessing Parameters1021620
-Node: Symbol Table Access1022855
-Node: Symbol table by name1023367
-Node: Symbol table by cookie1025156
-Ref: Symbol table by cookie-Footnote-11029341
-Node: Cached values1029405
-Ref: Cached values-Footnote-11032941
-Node: Array Manipulation1033094
-Ref: Array Manipulation-Footnote-11034185
-Node: Array Data Types1034222
-Ref: Array Data Types-Footnote-11036880
-Node: Array Functions1036972
-Node: Flattening Arrays1041470
-Node: Creating Arrays1048446
-Node: Redirection API1053213
-Node: Extension API Variables1056046
-Node: Extension Versioning1056757
-Ref: gawk-api-version1057186
-Node: Extension GMP/MPFR Versioning1058917
-Node: Extension API Informational Variables1060545
-Node: Extension API Boilerplate1061618
-Node: Changes from API V11065592
-Node: Finding Extensions1067164
-Node: Extension Example1067723
-Node: Internal File Description1068521
-Node: Internal File Ops1072601
-Ref: Internal File Ops-Footnote-11083951
-Node: Using Internal File Ops1084091
-Ref: Using Internal File Ops-Footnote-11086474
-Node: Extension Samples1086748
-Node: Extension Sample File Functions1088277
-Node: Extension Sample Fnmatch1095926
-Node: Extension Sample Fork1097413
-Node: Extension Sample Inplace1098631
-Node: Extension Sample Ord1101848
-Node: Extension Sample Readdir1102684
-Ref: table-readdir-file-types1103573
-Node: Extension Sample Revout1104378
-Node: Extension Sample Rev2way1104967
-Node: Extension Sample Read write array1105707
-Node: Extension Sample Readfile1107649
-Node: Extension Sample Time1108744
-Node: Extension Sample API Tests1110092
-Node: gawkextlib1110584
-Node: Extension summary1113502
-Node: Extension Exercises1117204
-Node: Language History1118702
-Node: V7/SVR3.11120358
-Node: SVR41122510
-Node: POSIX1123944
-Node: BTL1125324
-Node: POSIX/GNU1126053
-Node: Feature History1131831
-Node: Common Extensions1147690
-Node: Ranges and Locales1148973
-Ref: Ranges and Locales-Footnote-11153589
-Ref: Ranges and Locales-Footnote-21153616
-Ref: Ranges and Locales-Footnote-31153851
-Node: Contributors1154072
-Node: History summary1160017
-Node: Installation1161397
-Node: Gawk Distribution1162341
-Node: Getting1162825
-Node: Extracting1163788
-Node: Distribution contents1165426
-Node: Unix Installation1171906
-Node: Quick Installation1172588
-Node: Shell Startup Files1175002
-Node: Additional Configuration Options1176091
-Node: Configuration Philosophy1178384
-Node: Non-Unix Installation1180753
-Node: PC Installation1181213
-Node: PC Binary Installation1182051
-Node: PC Compiling1182486
-Node: PC Using1183603
-Node: Cygwin1186818
-Node: MSYS1187917
-Node: VMS Installation1188418
-Node: VMS Compilation1189209
-Ref: VMS Compilation-Footnote-11190438
-Node: VMS Dynamic Extensions1190496
-Node: VMS Installation Details1192181
-Node: VMS Running1194434
-Node: VMS GNV1198713
-Node: VMS Old Gawk1199448
-Node: Bugs1199919
-Node: Bug address1200582
-Node: Usenet1203564
-Node: Maintainers1204568
-Node: Other Versions1205829
-Node: Installation summary1212387
-Node: Notes1213589
-Node: Compatibility Mode1214383
-Node: Additions1215165
-Node: Accessing The Source1216090
-Node: Adding Code1217527
-Node: New Ports1223746
-Node: Derived Files1228234
-Ref: Derived Files-Footnote-11233880
-Ref: Derived Files-Footnote-21233915
-Ref: Derived Files-Footnote-31234513
-Node: Future Extensions1234627
-Node: Implementation Limitations1235285
-Node: Extension Design1236468
-Node: Old Extension Problems1237612
-Ref: Old Extension Problems-Footnote-11239130
-Node: Extension New Mechanism Goals1239187
-Ref: Extension New Mechanism Goals-Footnote-11242551
-Node: Extension Other Design Decisions1242740
-Node: Extension Future Growth1244853
-Node: Notes summary1245689
-Node: Basic Concepts1246864
-Node: Basic High Level1247545
-Ref: figure-general-flow1247827
-Ref: figure-process-flow1248512
-Ref: Basic High Level-Footnote-11251813
-Node: Basic Data Typing1251998
-Node: Glossary1255326
-Node: Copying1287164
-Node: GNU Free Documentation License1324707
-Node: Index1349827
+Ref: String Functions-Footnote-1560431
+Ref: String Functions-Footnote-2560559
+Ref: String Functions-Footnote-3560807
+Node: Gory Details560894
+Ref: table-sub-escapes562685
+Ref: table-sub-proposed564204
+Ref: table-posix-sub565567
+Ref: table-gensub-escapes567108
+Ref: Gory Details-Footnote-1567931
+Node: I/O Functions568085
+Ref: table-system-return-values574553
+Ref: I/O Functions-Footnote-1576633
+Ref: I/O Functions-Footnote-2576781
+Node: Time Functions576901
+Ref: Time Functions-Footnote-1587572
+Ref: Time Functions-Footnote-2587640
+Ref: Time Functions-Footnote-3587798
+Ref: Time Functions-Footnote-4587909
+Ref: Time Functions-Footnote-5588021
+Ref: Time Functions-Footnote-6588248
+Node: Bitwise Functions588514
+Ref: table-bitwise-ops589108
+Ref: Bitwise Functions-Footnote-1595171
+Ref: Bitwise Functions-Footnote-2595344
+Node: Type Functions595535
+Node: I18N Functions598286
+Node: User-defined599937
+Node: Definition Syntax600742
+Ref: Definition Syntax-Footnote-1606429
+Node: Function Example606500
+Ref: Function Example-Footnote-1609422
+Node: Function Caveats609444
+Node: Calling A Function609962
+Node: Variable Scope610920
+Node: Pass By Value/Reference613914
+Node: Return Statement617413
+Node: Dynamic Typing620392
+Node: Indirect Calls621322
+Ref: Indirect Calls-Footnote-1631574
+Node: Functions Summary631702
+Node: Library Functions634407
+Ref: Library Functions-Footnote-1638014
+Ref: Library Functions-Footnote-2638157
+Node: Library Names638328
+Ref: Library Names-Footnote-1641788
+Ref: Library Names-Footnote-2642011
+Node: General Functions642097
+Node: Strtonum Function643200
+Node: Assert Function646222
+Node: Round Function649548
+Node: Cliff Random Function651088
+Node: Ordinal Functions652104
+Ref: Ordinal Functions-Footnote-1655167
+Ref: Ordinal Functions-Footnote-2655419
+Node: Join Function655629
+Ref: Join Function-Footnote-1657399
+Node: Getlocaltime Function657599
+Node: Readfile Function661341
+Node: Shell Quoting663318
+Node: Data File Management664719
+Node: Filetrans Function665351
+Node: Rewind Function669447
+Node: File Checking671357
+Ref: File Checking-Footnote-1672691
+Node: Empty Files672892
+Node: Ignoring Assigns674871
+Node: Getopt Function676421
+Ref: Getopt Function-Footnote-1687890
+Node: Passwd Functions688090
+Ref: Passwd Functions-Footnote-1696929
+Node: Group Functions697017
+Ref: Group Functions-Footnote-1704915
+Node: Walking Arrays705122
+Node: Library Functions Summary708130
+Node: Library Exercises709536
+Node: Sample Programs710001
+Node: Running Examples710771
+Node: Clones711499
+Node: Cut Program712723
+Node: Egrep Program722652
+Ref: Egrep Program-Footnote-1730164
+Node: Id Program730274
+Node: Split Program733954
+Ref: Split Program-Footnote-1737412
+Node: Tee Program737541
+Node: Uniq Program740331
+Node: Wc Program747757
+Ref: Wc Program-Footnote-1752012
+Node: Miscellaneous Programs752106
+Node: Dupword Program753319
+Node: Alarm Program755349
+Node: Translate Program760204
+Ref: Translate Program-Footnote-1764769
+Node: Labels Program765039
+Ref: Labels Program-Footnote-1768390
+Node: Word Sorting768474
+Node: History Sorting772546
+Node: Extract Program774381
+Node: Simple Sed782435
+Node: Igawk Program785509
+Ref: Igawk Program-Footnote-1799840
+Ref: Igawk Program-Footnote-2800042
+Ref: Igawk Program-Footnote-3800164
+Node: Anagram Program800279
+Node: Signature Program803341
+Node: Programs Summary804588
+Node: Programs Exercises805802
+Ref: Programs Exercises-Footnote-1809931
+Node: Advanced Features810022
+Node: Nondecimal Data812012
+Node: Array Sorting813603
+Node: Controlling Array Traversal814303
+Ref: Controlling Array Traversal-Footnote-1822671
+Node: Array Sorting Functions822789
+Ref: Array Sorting Functions-Footnote-1827880
+Node: Two-way I/O828076
+Ref: Two-way I/O-Footnote-1835796
+Ref: Two-way I/O-Footnote-2835983
+Node: TCP/IP Networking836065
+Node: Profiling839183
+Ref: Profiling-Footnote-1847855
+Node: Advanced Features Summary848178
+Node: Internationalization850022
+Node: I18N and L10N851502
+Node: Explaining gettext852189
+Ref: Explaining gettext-Footnote-1858081
+Ref: Explaining gettext-Footnote-2858266
+Node: Programmer i18n858431
+Ref: Programmer i18n-Footnote-1863380
+Node: Translator i18n863429
+Node: String Extraction864223
+Ref: String Extraction-Footnote-1865355
+Node: Printf Ordering865441
+Ref: Printf Ordering-Footnote-1868227
+Node: I18N Portability868291
+Ref: I18N Portability-Footnote-1870747
+Node: I18N Example870810
+Ref: I18N Example-Footnote-1873616
+Node: Gawk I18N873689
+Node: I18N Summary874334
+Node: Debugger875675
+Node: Debugging876698
+Node: Debugging Concepts877139
+Node: Debugging Terms878948
+Node: Awk Debugging881523
+Node: Sample Debugging Session882429
+Node: Debugger Invocation882963
+Node: Finding The Bug884349
+Node: List of Debugger Commands890827
+Node: Breakpoint Control892160
+Node: Debugger Execution Control895854
+Node: Viewing And Changing Data899216
+Node: Execution Stack902590
+Node: Debugger Info904227
+Node: Miscellaneous Debugger Commands908298
+Node: Readline Support913360
+Node: Limitations914256
+Node: Debugging Summary916365
+Node: Arbitrary Precision Arithmetic917644
+Node: Computer Arithmetic919129
+Ref: table-numeric-ranges922895
+Ref: table-floating-point-ranges923388
+Ref: Computer Arithmetic-Footnote-1924046
+Node: Math Definitions924103
+Ref: table-ieee-formats927419
+Ref: Math Definitions-Footnote-1928022
+Node: MPFR features928127
+Node: FP Math Caution929845
+Ref: FP Math Caution-Footnote-1930917
+Node: Inexactness of computations931286
+Node: Inexact representation932246
+Node: Comparing FP Values933606
+Node: Errors accumulate934847
+Node: Getting Accuracy936280
+Node: Try To Round938990
+Node: Setting precision939889
+Ref: table-predefined-precision-strings940586
+Node: Setting the rounding mode942416
+Ref: table-gawk-rounding-modes942790
+Ref: Setting the rounding mode-Footnote-1946721
+Node: Arbitrary Precision Integers946900
+Ref: Arbitrary Precision Integers-Footnote-1950075
+Node: Checking for MPFR950224
+Node: POSIX Floating Point Problems951698
+Ref: POSIX Floating Point Problems-Footnote-1955983
+Node: Floating point summary956021
+Node: Dynamic Extensions958211
+Node: Extension Intro959764
+Node: Plugin License961030
+Node: Extension Mechanism Outline961827
+Ref: figure-load-extension962266
+Ref: figure-register-new-function963831
+Ref: figure-call-new-function964923
+Node: Extension API Description966985
+Node: Extension API Functions Introduction968627
+Node: General Data Types974167
+Ref: General Data Types-Footnote-1982528
+Node: Memory Allocation Functions982827
+Ref: Memory Allocation Functions-Footnote-1987037
+Node: Constructor Functions987136
+Node: Registration Functions990722
+Node: Extension Functions991407
+Node: Exit Callback Functions996622
+Node: Extension Version String997872
+Node: Input Parsers998535
+Node: Output Wrappers1011256
+Node: Two-way processors1015768
+Node: Printing Messages1018033
+Ref: Printing Messages-Footnote-11019204
+Node: Updating ERRNO1019357
+Node: Requesting Values1020096
+Ref: table-value-types-returned1020833
+Node: Accessing Parameters1021769
+Node: Symbol Table Access1023004
+Node: Symbol table by name1023516
+Node: Symbol table by cookie1025305
+Ref: Symbol table by cookie-Footnote-11029490
+Node: Cached values1029554
+Ref: Cached values-Footnote-11033090
+Node: Array Manipulation1033243
+Ref: Array Manipulation-Footnote-11034334
+Node: Array Data Types1034371
+Ref: Array Data Types-Footnote-11037029
+Node: Array Functions1037121
+Node: Flattening Arrays1041619
+Node: Creating Arrays1048595
+Node: Redirection API1053362
+Node: Extension API Variables1056195
+Node: Extension Versioning1056906
+Ref: gawk-api-version1057335
+Node: Extension GMP/MPFR Versioning1059066
+Node: Extension API Informational Variables1060694
+Node: Extension API Boilerplate1061767
+Node: Changes from API V11065741
+Node: Finding Extensions1067313
+Node: Extension Example1067872
+Node: Internal File Description1068670
+Node: Internal File Ops1072750
+Ref: Internal File Ops-Footnote-11084100
+Node: Using Internal File Ops1084240
+Ref: Using Internal File Ops-Footnote-11086623
+Node: Extension Samples1086897
+Node: Extension Sample File Functions1088426
+Node: Extension Sample Fnmatch1096075
+Node: Extension Sample Fork1097562
+Node: Extension Sample Inplace1098780
+Node: Extension Sample Ord1101997
+Node: Extension Sample Readdir1102833
+Ref: table-readdir-file-types1103722
+Node: Extension Sample Revout1104527
+Node: Extension Sample Rev2way1105116
+Node: Extension Sample Read write array1105856
+Node: Extension Sample Readfile1107798
+Node: Extension Sample Time1108893
+Node: Extension Sample API Tests1110241
+Node: gawkextlib1110733
+Node: Extension summary1113651
+Node: Extension Exercises1117353
+Node: Language History1118851
+Node: V7/SVR3.11120507
+Node: SVR41122659
+Node: POSIX1124093
+Node: BTL1125473
+Node: POSIX/GNU1126202
+Node: Feature History1131980
+Node: Common Extensions1147839
+Node: Ranges and Locales1149122
+Ref: Ranges and Locales-Footnote-11153738
+Ref: Ranges and Locales-Footnote-21153765
+Ref: Ranges and Locales-Footnote-31154000
+Node: Contributors1154221
+Node: History summary1160166
+Node: Installation1161546
+Node: Gawk Distribution1162490
+Node: Getting1162974
+Node: Extracting1163937
+Node: Distribution contents1165575
+Node: Unix Installation1172055
+Node: Quick Installation1172737
+Node: Shell Startup Files1175151
+Node: Additional Configuration Options1176240
+Node: Configuration Philosophy1178533
+Node: Non-Unix Installation1180902
+Node: PC Installation1181362
+Node: PC Binary Installation1182200
+Node: PC Compiling1182635
+Node: PC Using1183752
+Node: Cygwin1186967
+Node: MSYS1188066
+Node: VMS Installation1188567
+Node: VMS Compilation1189358
+Ref: VMS Compilation-Footnote-11190587
+Node: VMS Dynamic Extensions1190645
+Node: VMS Installation Details1192330
+Node: VMS Running1194583
+Node: VMS GNV1198862
+Node: VMS Old Gawk1199597
+Node: Bugs1200068
+Node: Bug address1200731
+Node: Usenet1203713
+Node: Maintainers1204717
+Node: Other Versions1205978
+Node: Installation summary1212536
+Node: Notes1213738
+Node: Compatibility Mode1214532
+Node: Additions1215314
+Node: Accessing The Source1216239
+Node: Adding Code1217676
+Node: New Ports1223895
+Node: Derived Files1228383
+Ref: Derived Files-Footnote-11234029
+Ref: Derived Files-Footnote-21234064
+Ref: Derived Files-Footnote-31234662
+Node: Future Extensions1234776
+Node: Implementation Limitations1235434
+Node: Extension Design1236617
+Node: Old Extension Problems1237761
+Ref: Old Extension Problems-Footnote-11239279
+Node: Extension New Mechanism Goals1239336
+Ref: Extension New Mechanism Goals-Footnote-11242700
+Node: Extension Other Design Decisions1242889
+Node: Extension Future Growth1245002
+Node: Notes summary1245838
+Node: Basic Concepts1247013
+Node: Basic High Level1247694
+Ref: figure-general-flow1247976
+Ref: figure-process-flow1248661
+Ref: Basic High Level-Footnote-11251962
+Node: Basic Data Typing1252147
+Node: Glossary1255475
+Node: Copying1287313
+Node: GNU Free Documentation License1324856
+Node: Index1349976
End Tag Table
diff --git a/doc/gawk.texi b/doc/gawk.texi
index 50555f8..aea89d7 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -8105,7 +8105,6 @@ FPAT = "([^,]*)|(\"[^\"]+\")"
Finally, the @code{patsplit()} function makes the same functionality
available for splitting regular strings (@pxref{String Functions}).
-
@node Testing field creation
@section Checking How @command{gawk} Is Splitting Records
@@ -18406,8 +18405,8 @@ whitespace goes into @address@hidden@var{n}]}, where
@var{n} is the
return value of
@code{split()} (i.e., the number of elements in @var{array}).
-The @code{split()} function splits strings into pieces in a
-manner similar to the way input lines are split into fields. For example:
+The @code{split()} function splits strings into pieces in the same way
+that input lines are split into fields. For example:
@example
split("cul-de-sac", a, "-", seps)
@@ -18443,6 +18442,8 @@ are separated by runs of whitespace.
Also, as with input field splitting, if @var{fieldsep} is the null string, each
individual character in the string is split into its own array element.
@value{COMMONEXT}
+Additionally, if @var{fieldsep} is a single-character string, that string acts
+as the separator, even if its value is a regular expression metacharacter.
Note, however, that @code{RS} has no effect on the way @code{split()}
works. Even though @samp{RS = ""} causes the newline character to also be an
input
diff --git a/doc/gawktexi.in b/doc/gawktexi.in
index dddcf67..51d9afe 100644
--- a/doc/gawktexi.in
+++ b/doc/gawktexi.in
@@ -7704,7 +7704,6 @@ FPAT = "([^,]*)|(\"[^\"]+\")"
Finally, the @code{patsplit()} function makes the same functionality
available for splitting regular strings (@pxref{String Functions}).
-
@node Testing field creation
@section Checking How @command{gawk} Is Splitting Records
@@ -17678,8 +17677,8 @@ whitespace goes into @address@hidden@var{n}]}, where
@var{n} is the
return value of
@code{split()} (i.e., the number of elements in @var{array}).
-The @code{split()} function splits strings into pieces in a
-manner similar to the way input lines are split into fields. For example:
+The @code{split()} function splits strings into pieces in the same way
+that input lines are split into fields. For example:
@example
split("cul-de-sac", a, "-", seps)
@@ -17715,6 +17714,8 @@ are separated by runs of whitespace.
Also, as with input field splitting, if @var{fieldsep} is the null string, each
individual character in the string is split into its own array element.
@value{COMMONEXT}
+Additionally, if @var{fieldsep} is a single-character string, that string acts
+as the separator, even if its value is a regular expression metacharacter.
Note, however, that @code{RS} has no effect on the way @code{split()}
works. Even though @samp{RS = ""} causes the newline character to also be an
input
-----------------------------------------------------------------------
Summary of changes:
doc/ChangeLog | 8 +
doc/gawk.1 | 10 +-
doc/gawk.info | 726 ++++++++++++++++++++++++++++----------------------------
doc/gawk.texi | 7 +-
doc/gawktexi.in | 7 +-
5 files changed, 387 insertions(+), 371 deletions(-)
hooks/post-receive
--
gawk
| [Prev in Thread] |
Current Thread |
[Next in Thread] |
- [gawk-diffs] [SCM] gawk branch, gawk-4.2-stable, updated. gawk-4.1.0-3083-g7eac083,
Arnold Robbins <=