On 5 Mar 2008, at 19:23, Adriano Ferreira wrote:
=for method
has the least impact (if the next paragraph is left blank). According
to the specs, it should be understood as leave the paragraph alone if
you (POD processor) does not know about 'method'.
Ah, OK. Thanks.
That's all legal POD that shouldn't mess up existing parsers.
POD is a little verbose and mixes content with markup as noticed by
Andy with
=item * C<foo>
POD6 would provide exactly what Andy was looking for. But
compatibility would be broken.
The remedy would be writing documentation in POD6 and have a plugin as
David Golden himself uses to extract WikiText and convert it to actual
POD. Unfortunately, the POD6 to POD5 translator was not written yet.
I missed the POD6 thing. Is there are public grammar anywhere? I only
see it mentioned in Perl 6 Design Minutes.
--
Andy Armstrong, Hexten
