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>
