Re: POD doesn't capture code semantics

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