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