Author: wayland
Date: 2009-02-18 07:14:51 +0100 (Wed, 18 Feb 2009)
New Revision: 25374
Modified:
docs/Perl6/Spec/S16-io.pod
Log:
Bits and pieces, but mostly trying to clean up the list of unfiled functions.
Modified: docs/Perl6/Spec/S16-io.pod
===================================================================
--- docs/Perl6/Spec/S16-io.pod 2009-02-18 05:09:25 UTC (rev 25373)
+++ docs/Perl6/Spec/S16-io.pod 2009-02-18 06:14:51 UTC (rev 25374)
@@ -430,7 +430,7 @@
You probably want to use the DateTime object instead.
role Date {
- has Calendar $.calendar;
+ has Calendar $.calendar; # Gregorian, Secular, Julian, etc
has NumberName $.year;
has NumberName $.month;
has NumberName $.dayofmonth;
@@ -694,9 +694,15 @@
class IO::FSNode does Tree::Node {
has Array of IO::FSNodeACL @.ACLs;
+ has Hash of %.times;
...
}
+The %times has keys that can be eg. ctime, Modification, and Access (and maybe
others on
+other operating systems), and the values are all DateTime objects.
+
+When .path() is implemented, it should return the path that this was opened
with.
+
=over 4
=item IO ~~ :X
@@ -805,6 +811,16 @@
Test whether the specified filename is the same file as this file. On a Unix
system,
this would presumably be done by comparing inode numbers or something.
+=item init
+
+This is called automatically on object creation; I'm unsure if init is the
right name.
+
+multi method init(@pathelements); # new IO::FSNode('home', 'wayland')
+multi method init(String $type, String $path) # new IO::FSNode('Unix',
'/home/wayland');
+multi method init(String $path) # new IO::FSNode('/home/wayland');
+
+This last throws an error if "use portable" is used.
+
=back
=head2 IO::FSNodeACL
@@ -1102,20 +1118,6 @@
=over 4
-=item IO.name
-
-The C<.name> method returns the name of the file/socket/uri the handle
-was opened with, if known. Returns undef otherwise. There is no
-corresponding C<name()> function.
-
-=item sysopen
-
-=item umask
-
-=item utime
-
-=item IO.fileno
-
=item IO.ioctl
Available only as a handle method.
@@ -1126,10 +1128,16 @@
our Str prompt (Str $prompt)
+ Should there be an IO::Interactive role?
+
=item Str.readpipe
+=item sysopen
+
=item IO.sysseek
+=item umask
+
=back
=head1 Removed functions
@@ -1140,6 +1148,18 @@
Gone, see IO::Endable
+=item IO.fileno
+
+See IO::FileDescriptor
+
+=item IO.name
+
+Changed to .path(), but we haven't gotten around to specifying this on all of
them.
+
+The C<.name> method returns the name of the file/socket/uri the handle
+was opened with, if known. Returns undef otherwise. There is no
+corresponding C<name()> function.
+
=item pipe
Gone, see Pipe.pair
@@ -1164,6 +1184,10 @@
Gone, see IO::Writeable.read()
+=item utime
+
+Gone, see %IO::FSNode.times.
+
=back
=head1 Additions
