develooper Front page | perl.cvs.parrot | Postings from December 2008

[svn:parrot] r33918 - trunk/docs/book

From:
Whiteknight
Date:
December 15, 2008 08:10
Subject:
[svn:parrot] r33918 - trunk/docs/book
Message ID:
20081215161001.E241FCBA12@x12.develooper.com
Author: Whiteknight
Date: Mon Dec 15 08:10:01 2008
New Revision: 33918

Modified:
   trunk/docs/book/ch11_pmcs.pod

Log:
[Book] Add more information about some of the pmclass flags "abstract", "has_ro", "is_ro", and "is_shared". Many of these are almost completely undocumented elsewhere, so my descriptions here might not be completely accurate.

Modified: trunk/docs/book/ch11_pmcs.pod
==============================================================================
--- trunk/docs/book/ch11_pmcs.pod	(original)
+++ trunk/docs/book/ch11_pmcs.pod	Mon Dec 15 08:10:01 2008
@@ -93,7 +93,13 @@
 internally. C<PMC_EXT> is necessary to handle data sharing between threads
 or interpreters, storing attributes in the PMC, and a few other uses as
 well. The C<singleton> flag means that there can only be one instantiated
-object of this class.
+object of this class. The C<is_ro> and C<has_ro> flags indicate that the
+PMC class is read-only or that it contains read-only data, respectively.
+The C<is_shared> flag indicates that the PMC is intended to be shared
+between multiple interpreters, and therefore special synchronization
+logic should be applied. The C<abstract> flag indicates that the PMC
+class cannot be instantiated directly, but can be inherited from by a
+non-abstract PMC class.
 
 The C<provides> keyword is used to show that the PMC provides certain
 standard interfaces. For instance, you can specify C<provides array>



nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About