Author: ruoso
Date: 2009-02-16 12:13:03 +0100 (Mon, 16 Feb 2009)
New Revision: 25356
Modified:
docs/Perl6/Spec/S16-io.pod
Log:
[spec/S16] move IFS/OFS/IRS/ORS to the more specific roles.
[spec/S16] async should not be an argument to a method, but it is an attribute
of the IO object.
(there need to be more work in S16 to sanitize all the roles. Some references
to IO::POSIX are reversed. It is IO::POSIX that should do some generic roles
(like IO::Streamable) not the other way around.)
Modified: docs/Perl6/Spec/S16-io.pod
===================================================================
--- docs/Perl6/Spec/S16-io.pod 2009-02-16 10:46:30 UTC (rev 25355)
+++ docs/Perl6/Spec/S16-io.pod 2009-02-16 11:13:03 UTC (rev 25356)
@@ -11,6 +11,7 @@
Maintainer: Larry Wall <la...@wall.org>
Contributions: Mark Stosberg <m...@summersault.com>
Tim Nelson <wayl...@wayland.id.au>
+ Daniel Ruoso <dan...@ruoso.com>
Date: 12 Sep 2006
Last Modified: 14 Feb 2009
Version: 19
@@ -170,42 +171,28 @@
Encoding and locale are required for sane conversions.
-=item has $.input_record_separator is rw
+=back
-This regulates how "readline" behaves.
+=head2 IO::Readable::Encoded
-=item has $.output_record_separator is rw
+This role provides encoded access to a readable data stream, implies
+IO::Encoded. Might imply IO::Buffered, but that's not a requirement.
-This regulates how say and print(%hash) behaves.
+=over
+=item has $.input_record_separator is rw
+
+This regulates how "readline" behaves.
+
=item has $.input_field_separator is rw
This regulates how "readfield" behaves.
-=item has $.output_field_separator is rw
-
-This regulates how print(@arr), say(@arr), print(%hash) and
-say(%hash) behave.
-
=item has $.input_escape is rw
This allows the definition of a escape character, which should be used
by readline and readfield.
-=item has $.output_escape is rw
-
-This allows the definition of a escape character, which should be used
-by say and print to preserve the record/field semantics.
-
-=back
-
-=head2 IO::Readable::Encoded
-
-This role provides encoded access to a readable data stream, implies
-IO::Encoded. Might imply IO::Buffered, but that's not a requirement.
-
-=over
-
=item method Str readline
Reads the stream before it finds a $.input_record_separator and
@@ -224,14 +211,9 @@
Reads the next character in the set $.encoding according to the
$.locale.
-=item getc
-
- our Bool method getc (IO $self: Bool :async)
-
Returns the next character from the input stream attached to IO,
or the undefined value at end of file, or if there was an error (in
-the latter case C<$!> is set). The C<:async> flag lets the call
-return an undefined value if no character is immediately available.
+the latter case C<$!> is set).
=item IO.lines
@@ -263,6 +245,20 @@
=over
+=item has $.output_record_separator is rw
+
+This regulates how say and print(%hash) behaves.
+
+=item has $.output_field_separator is rw
+
+This regulates how print(@arr), say(@arr), print(%hash) and
+say(%hash) behave.
+
+=item has $.output_escape is rw
+
+This allows the definition of a escape character, which should be used
+by say and print to preserve the record/field semantics.
+
=item method Bool print(Str $str)
=item method Bool say(Str $str)
