Merge branch 'master' into array-iface

1 files changed, 17 insertions, 7 deletions

diff --git a/doc/gawk.texi b/doc/gawk.texi
index fb008d74..6abc337f 100644
--- a/doc/gawk.texi
+++ b/doc/gawk.texi
@@ -16013,12 +16013,22 @@ not available if @option{--posix} has been specified on the
 command line (@pxref{Options}).
 
 @cindex @command{gawk}, @code{fflush()} function in
-@command{gawk} extends the @code{fflush()} function in two ways.  The first
-is to allow no argument at all. In this case, the buffer for the
-standard output is flushed.  The second is to allow the null string
-(@w{@code{""}}) as the argument. In this case, the buffers for
-@emph{all} open output files and pipes are flushed.
-Brian Kernighan's @command{awk} also supports these extensions.
+@command{gawk} extends the @code{fflush()} function, as follows: If there
+is no argument, or if the argument is the null string (@w{@code{""}}),
+@command{gawk} flushes the buffers for @emph{all} open output files
+and pipes.  Brian Kernighan's @command{awk} also works this way.
+
+@quotation NOTE
+Prior to version @strong{FIXME: VERSION}, @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 Brian
+Kernighan's @command{awk}, in the hope that standardizing this
+feature in POSIX would then be easier.
+
+You can use @samp{fflush("/dev/stdout")} if you wish to flush
+only the standard output.
+@end quotation
 
 @c @cindex automatic warnings
 @c @cindex warnings, automatic
@@ -31255,7 +31265,7 @@ the tools.} create a GNU/Linux shared library:
 
 @example
 $ @kbd{gcc -fPIC -shared -DHAVE_CONFIG_H -c -O -g -I@var{idir} filefuncs.c}
-$ @kbd{ld -o filefuncs.so -shared filefuncs.o -lc}
+$ @kbd{gcc -o filefuncs.so -shared filefuncs.o}
 @end example
 
 Once the library exists, it is loaded by using the @code{@@load} keyword.