Re: POD doesn't capture code semantics

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