http://svn.openfoundry.org/pugs/docs/Perl6/Spec/Documentation.pod
...is *way* out of date. It predates the meeting Ingy, Larry, Audrey, and I had in Tokyo, in which most of the kinks were ironed out. I have a new draft of S26 with the design team at the moment, and am close to having a first cut at a parser for that mark-up notation. The new Pod looks very much like the old POD, only cleaned up and simplified. Kinda like Perl 6 itself. Stay tuned. If I hear nothing more from the design team, and if I can get the parser stable in the next week or so, I'll post a new S26 here RSN. Damian