Author: wayland
Date: 2009-02-27 13:06:57 +0100 (Fri, 27 Feb 2009)
New Revision: 25621
Modified:
docs/Perl6/Spec/S16-io.pod
docs/Perl6/Spec/S29-functions.pod
Log:
Created UserIterator and GroupIterator, and grouped some S29 functions
together.
Modified: docs/Perl6/Spec/S16-io.pod
===================================================================
--- docs/Perl6/Spec/S16-io.pod 2009-02-27 11:57:30 UTC (rev 25620)
+++ docs/Perl6/Spec/S16-io.pod 2009-02-27 12:06:57 UTC (rev 25621)
@@ -115,6 +115,13 @@
All the information is naturally fetched from the system via getpwuid,
getpwnam, or the
like.
+=head2 UserIterator role
+
+role UserIterator does Iterator {...}
+
+In the Unix implementation, this deals with getpwent, setpwent, and endpwent.
Basically,
+it returns a User object with each iteration.
+
=head2 Group role
role Group {
@@ -133,6 +140,13 @@
Tries to write the group entry into the system group database.
+=head2 GroupIterator role
+
+role GroupIterator does Iterator {...}
+
+In the Unix implementation, this deals with getgrent, setgrent, and endgrent.
Basically,
+it returns a Group object with each iteration.
+
=head1 Additions
Please post errors and feedback to perl6-language. If you are making
Modified: docs/Perl6/Spec/S29-functions.pod
===================================================================
--- docs/Perl6/Spec/S29-functions.pod 2009-02-27 11:57:30 UTC (rev 25620)
+++ docs/Perl6/Spec/S29-functions.pod 2009-02-27 12:06:57 UTC (rev 25621)
@@ -777,6 +777,10 @@
See .pairs() method, above.
+=item endpwent, endgrent
+
+The UserIterator and GroupIterator roles in S16 cover most of these.
+
=item format, formline
See Exegesis 7.
@@ -785,6 +789,10 @@
The User and Group roles in S16 cover most of these.
+=item getpwent, getgrent
+
+The UserIterator and GroupIterator roles in S16 cover most of these.
+
=item length()
This word is banned in Perl 6. You must specify units. In practise, this
probably means
@@ -833,6 +841,10 @@
See IPC::SysV;
+=item setpwent, setgrent
+
+The UserIterator and GroupIterator roles in S16 cover most of these.
+
=item shmctl, shmget, shmread, shmwrite
See IPC::SysV;
@@ -896,42 +908,52 @@
=item OS or library related
-chroot
-crypt
-endgrent
-endhostent
-endnetent
-endprotoent
-endpwent
-endservent
-getgrent
-gethostbyaddr
-gethostbyname
-gethostent
-getlogin
-getnetbyaddr
-getnetbyname
-getnetent
-getpeername
-getpgrp
-getppid
-getpriority
-getprotobyname
-getprotobynumber
-getprotoent
-getpwent
-getservbyname
-getservbyport
-getservent
-setgrent
-sethostent
-setnetent
-setpgrp
-setpriority
-setprotoent
-setpwent
-setservent
+ chroot
+ crypt
+ getlogin
+ getpeername -- should this go on Pipe?
+OS objects:
+
+ --Process
+ getpgrp
+ getppid
+ getpriority
+ setpgrp
+ setpriority
+
+ --Service
+ getservbyname
+ getservbyport
+
+ getservent
+ setservent
+ endservent
+
+ --Protocol
+ getprotobyname
+ getprotobynumber
+
+ getprotoent
+ setprotoent
+ endprotoent
+
+ --Network
+ getnetbyaddr
+ getnetbyname
+
+ getnetent
+ setnetent
+ endnetent
+
+ --Host
+ gethostbyaddr
+ gethostbyname
+
+ gethostent
+ sethostent
+ endhostent
+
=item Flow control
break
