On Wed, Mar 5, 2008 at 1:52 PM, Andy Armstrong <[EMAIL PROTECTED]> wrote: > I wonder how you'd tag a subroutine that can be called as a method or > a regular subroutine. Is > > =begin :method|sub > > legal? > > I can't see a definition of what characters are allowed in an > identifier in perlpodspec or whether garbage is allowed a the end of a > =begin line.
It's been a while since I really knew the podspec well (back when I wrote Pod::WikiDoc so I could write Pod as wiki text instead of Pod). I don't think garbage is allowed -- but I think you can nest: =begin :method =begin :sub =head2 X<foo> =end :sub =end :method Unfortunately, I just tested this and it isn't passed through to a parser automatically -- so this will only work for metadata, not actual documentation David
