develooper Front page | perl.perl5.porters | Postings from May 2016

Re: [perl #119439] remove Pod::Parser from the core distribution

Thread Previous | Thread Next
From:
Smylers
Date:
May 31, 2016 13:30
Subject:
Re: [perl #119439] remove Pod::Parser from the core distribution
Message ID:
20160531133027.GD2036@stripey.com
Ricardo SIGNES writes:

> We have been working (slowwwly) for years to remove Pod::Parser from
> the core perl distribution.  At this point, I believe the only blocker
> is Pod::Checker.

Karl Williamson has heroically achieved this (in RT #116467).

However, perlpodspec is still promoting Pod::Parser in a couple of
places. Would readers be better served by being pointed at Pod::Simple
instead?

This one can be addressed by simply changing the module name:

  Authors of Pod formatters/processors should make every effort to avoid
  writing their own Pod parser.  There are already several in CPAN, with
  a wide range of interface styles -- and one of them, Pod::Parser,
  comes with modern versions of Perl.

But this one is trickier:

  In parsing Pod, a notably tricky part is the correct parsing of
  (potentially nested!) formatting codes.  Implementors should consult
  the code in the "parse_text" routine in Pod::Parser as an example of a
  correct implementation.

What's the equivalent place in Pod::Simple that would serve as an
example of how to get this right?

Smylers
-- 
http://twitter.com/Smylers2

Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About