Author: wayland
Date: 2009-02-24 05:57:59 +0100 (Tue, 24 Feb 2009)
New Revision: 25515

Added some things taken from the S28 sources.  

Modified: docs/Perl6/Spec/S32-setting-library/IO.pod
--- docs/Perl6/Spec/S32-setting-library/IO.pod  2009-02-24 04:56:48 UTC (rev 
+++ docs/Perl6/Spec/S32-setting-library/IO.pod  2009-02-24 04:57:59 UTC (rev 
@@ -190,6 +190,21 @@
 Forces this object to keep its buffers empty
+If set to nonzero, forces a flush right away and after every write
+or print on the currently selected output channel.
+Default is 0 (regardless of whether the channel is really buffered
+by the system or not;
+$OUT_FH.autoflush tells you only whether you've asked Perl
+explicitly to flush after each write).
+$*OUT will typically be line buffered if output is to the
+terminal and block buffered otherwise.
+Setting this variable is useful primarily when you are
+outputting to a pipe or socket,
+such as when you are running a Perl program under rsh
+and want to see the output as it's happening.
+This has no effect on input buffering.
 =head2 IO::Streamable
@@ -246,10 +261,32 @@
+=item method Int input_record_count()
+Returns a count of the number of records (lines?) that have been input.  
+Now with cleaned-up localization usage.
 =item method Str input_record_separator() is rw
 This regulates how "readline" behaves.
+The input record separator, newline by default.
+This influences Perl's idea of what a ``line'' is.
+Works like awk's RS variable, including treating empty lines
+as a terminator if set to the null string.
+(An empty line cannot contain any spaces or tabs.)
+You may set it to a multi-character string to match a multi-character
+terminator, or to undef to read through the end of file.
+Setting it to "\n\n" means something slightly different
+than setting to "", if the file contains consecutive empty lines.
+Setting to "" will treat two or more consecutive empty lines
+as a single empty line. Setting to "\n\n" will blindly assume
+that the next input character belongs to the next paragraph,
+even if it's a newline.
+Remember: the value of input_record_separator is a string, not a regex.
+awk has to be better for something. :-)
 =item method Str input_field_separator() is rw
 This regulates how "readfield" behaves.
@@ -291,6 +328,10 @@
+=item method Int output_record_count()
+Returns a count of the number of records (lines?) that have been output.  
 =item method Str output_record_separator() is rw
 This regulates how say and print(%hash) behaves.

Reply via email to