On Wed, Mar 5, 2008 at 1:06 PM, Ian Malpass <[EMAIL PROTECTED]> wrote:
> How about:
>
> =for method
>
> =head2 C<foo>
>
> Bit ugly, but it should work. Additional stuff after "method" could
> provide more metadata, etc.
A simpler option might be to use the X<> indexing mark:
=head2 X<C<foo>>
That doesn't help with semantics, but does make it easier to identify
sections of interest.
Potentially, the Z<> (null) tag could be used for metadata -- though
some parsers might warn if it contains something. That seems silly to
me -- why have a tag for ignoring its contents and then warn if it has
contents?
Also, more generally, consider that formats that begin with a colon
are treated as POD and parsed as normal (c.f. perlpodspec and the "=
:biblio" example). So consider this in combination with the X<> tag
mentioned above :
=begin :method
=head2 X<C<foo>>
Documentation of foo() here...
=end :method
That's all legal POD that shouldn't mess up existing parsers.
David
