Change 19631 by [EMAIL PROTECTED] on 2003/05/29 08:11:42
Document that setvbuf() is not probably any more available.
Many reports, most recently by mjd in
[perl #22339] IO::Handle::setvbuf not defined properly
Affected files ...
... //depot/perl/ext/IO/lib/IO/Handle.pm#28 edit
Differences ...
==== //depot/perl/ext/IO/lib/IO/Handle.pm#28 (text) ====
Index: perl/ext/IO/lib/IO/Handle.pm
--- perl/ext/IO/lib/IO/Handle.pm#27~16822~ Mon May 27 13:42:47 2002
+++ perl/ext/IO/lib/IO/Handle.pm Thu May 29 01:11:42 2003
@@ -20,6 +20,7 @@
$io->print("Some text\n");
}
+ # setvbuf is not available by default on Perls 5.8.0 and later.
use IO::Handle '_IOLBF';
$io->setvbuf($buffer_var, _IOLBF, 1024);
@@ -192,6 +193,10 @@
C<_IOLBF>, and C<_IONBF> for setvbuf()--except that the buffer parameter
specifies a scalar variable to use as a buffer. You should only
change the buffer before any I/O, or immediately after calling flush.
+
+WARNING: The IO::Handle::setvbuf() is not available by default on
+Perls 5.8.0 and later because setvbuf() is rather specific to using
+the stdio library, while Perl prefers the new perlio subsystem instead.
WARNING: A variable used as a buffer by C<setbuf> or C<setvbuf> B<must not
be modified> in any way until the IO::Handle is closed or C<setbuf> or
End of Patch.
