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

[email protected] (Karl Williamson) Tue, 29 Jan 2013 11:52:43 -0700
Newsgroups perl.pod-people
Message-ID <[email protected]>
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.
>>
>>>> Did you flush $out_fh?  Pod::Parser did that but Pod::Simple
>>>> doesn't, so
>>>> it's possible if you're doing something short that the entire output
>>>> was
>>>> still buffered.
>>
>>>> Pod::Man and Pod::Text use this Pod::Simple method and do have test
>>>> suites
>>>> for it and it seems to work.
>>
>>> See the attached program.  The resultant file is 0 length.
>>
>> 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)?