On Wed, Mar 5, 2008 at 4:28 PM, Andy Armstrong <[EMAIL PROTECTED]> wrote: > 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.
The S26 (Synopsis 26) is the official document: latest version here http://feather.perl6.nl/syn/S26.html It is also included in the Perl6-Perldoc distribution: http://search.cpan.org./dist/Perl6-Perldoc
