Merge branch 'master' into feature/fix-comments

1 files changed, 16 insertions, 10 deletions

diff --git a/doc/gawk.texi b/doc/gawk.texi
index 6f5f4f81..d9f6bc9c 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
 
@@ -15762,19 +15761,18 @@ This element gives a string indicating the platform for which
 @item "vms"
 OpenVMS or Vax/VMS.
 
-@item "macosx"
-Mac OS X.
-
-@item "cygwin"
-@itemx "djgpp"
+@item "djgpp"
 @itemx "mingw"
-Microsoft Windows, using either Cygwin, DJGPP, or MinGW, respectively.
+Microsoft Windows, using either DJGPP or MinGW, respectively.
 
 @item "os2"
 OS/2.
 
+@item "os390"
+OS/390.
+
 @item "posix"
-GNU/Linux and legacy Unix systems.
+GNU/Linux, Cygwin, Mac OS X, and legacy Unix systems.
 @end table
 
 @item PROCINFO["pgrpid"]
@@ -18431,8 +18429,8 @@ whitespace goes into @code{@var{seps}[@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)
@@ -18468,6 +18466,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
@@ -40049,6 +40049,12 @@ appropriate @samp{-v BINMODE=@var{N}} option on the command line.
 @code{BINMODE} is set at the time a file or pipe is opened and cannot be
 changed midstream.
 
+On POSIX-compatible systems, this variable's value has no effect.
+Thus, if you think your program will run on multiple different systems
+and that you may need to use @code{BINMODE}, you should simply set it
+(in the program or on the command line) unconditionally, and not worry
+about the operating system on which your program is running.
+
 The name @code{BINMODE} was chosen to match @command{mawk}
 (@pxref{Other Versions}).
 @command{mawk} and @command{gawk} handle @code{BINMODE} similarly; however,