Re: How do I get Pod::Simple to extract pod from its containing file?

[email protected] (Nicholas Clark) Wed, 6 Mar 2013 13:15:10 +0000
Newsgroups perl.pod-people
Message-ID <[email protected]>
On Tue, Jan 29, 2013 at 11:52:43AM -0700, Karl Williamson wrote:
> On 01/26/2013 08:37 PM, Karl Williamson wrote:
> > On 01/26/2013 07:44 PM, Russ Allbery wrote:
> >> Karl Williamson <[email protected]> writes:
> >>> On 01/26/2013 02:23 PM, Russ Allbery wrote:
> >>>> Karl Williamson <[email protected]> writes:
> >>
> >>>>> With Pod::Parser, you just do
> >>>>>     parse_from_file($in_fh, $out_fh)
> >>
> >>>>> and it outputs the pod to $out_fh.  Pod::Simple has a method of the
> >>>>> same
> >>>>> name which is supposed to emulate the Pod::Parser method, but when
> >>>>> I run
> >>>>> it, nothing is output.

> >> Oh!  I misunderstood, sorry.  parse_from_file() does indeed invoke the
> >> parser with the appropriate actions, but what you meant was that
> >> Pod::Parser's "null" parser, when not subclassed, just printed the POD
> >> back out again, so you could use it as a way to extract the POD from a
> >> file.  I believe Pod::Simple's "null" parser does nothing at all, so you
> >> get an empty file.
> >>
> >> Yes.  I think that's an incompatibility.
> >>
> >
> > If I turn on DEBUGing, it's doing a lot.  Is there some trivial way to
> > extract the pod?
> >
> 
> So no one thinks there is a trivial way to get this extraction.  Would 
> someone make a suggestion as to the easiest way to do so using modules 
> that will continue to ship with the Perl 5 core (unlike Pod::Parser)?

No-one answered this, did they?

Is it possible to extract the pod by subclassing Pod::Simple, and the
subclass being a null parser that prints out the Pod that it was given?

Nicholas Clark