On Fri, Nov 02, 2001 at 06:13:04PM -0700, Sean M. Burke wrote:
> Today, in a fit of apparently boundless masochism, I started reading some
> of Pod/Parser.pm. I came across these two lines in parse_from_filehandle:
>
> if ((! length $paragraph) && ($textline =~ /^==/)) {
> ## '==' denotes a one-line command paragraph
>
> That's news to me.
>
> Does anything other than Pod::Parser observe this "==foo" syntax?
It shouldn't. It's never been part of perlpod. I have some of my
own stuff that used to use it, but it wasn't using Pod::Parser
to put docs inside Perl code, it was creatings its own pod-like
language inside of another tool's text configuration files. I
posted it to p5p, and it seemed to be well received. Then a
year or so later, it came up again on p5p and Larry said "no
way in h---" and that was the end of it. So I said "fine" and
its not part of perlpod, but I'm leaving the code in Pod::Parser
because its useful to me and stuff that I do and Pod::Parser
is intended for more than just pod2xxx translation, and no
one has to use it if they dopnt want to.
If you don't want it in perlpod or perlpodspec, then don't
use it. If you want podchecker to be sure to complain about
==\w+ then feel free. But leave the code in Pod::Parser please
- since its not like it would otherwise somehow be valid-pod
and podchecker would still complain.
--
Brad Appleton <[EMAIL PROTECTED]> http://www.bradapp.net/
"And miles to go before I sleep." -- Robert Frost
