Re: Pod::Simple output as POD

[Karl Williamson]

On 05/13/2016 12:24 PM, David E. Wheeler wrote:

On May 13, 2016, at 11:03 AM, Karl Williamson  wrote:


If we wanted to be cute, we could call it Pod::Simple::SimplyPod, with you 
know, only one, natural, ingredient, and no harmful additives.


But is it organic? Or Biodynamic?

D



The marketing term Biodynamic doesn't seem to have survived the test of 
time, at least in my corner of Trumpistan.


So, I converted the name to JustPod, and am trying to finish that up.
I had to suspend work on it a couple of years ago, and am just now able 
to get back to it.


Changes to BlackBox were needed.

I left it mostly working, and foolishly didn't leave notes to myself 
about what else was needed, so now I'm working on test files in the 
distribution to make sure that the pod extraction is working.  We have a 
bunch of files in the t/corpus directory, and I can see how well this 
works on each of them.


One thing that might not ever be precise is retaining the file's white 
space, as opposed to squeezing out unnecessary strings of multiple ones 
to just one blank.


And I'm running into something that I know I had not previously gotten 
as far as (which is encouraging), and I'm writing now for counsel.


What to do about input files that are encoded in some alien encoding, 
like Japanese 2202?  The Pod::Simple docs say it translates the pod into 
perl's internal representation.  But should the extracted pod also be in 
perl's representation, or should it be translated back to the original 
encoding?  The second way would be a way to really extract the pod 
portions of the original.


But I'm thinking it should be perl's, so that downstream modules can use 
it as-is.  But I'm open to other reasoned opinions

podlators 4.11 released

[Russ Allbery]

The URL

https://archives.eyrie.org/software/perl/podlators-4.11.tar.gz

has entered CPAN as

  file: $CPAN/authors/id/R/RR/RRA/podlators-4.11.tar.gz
  size: 131907 bytes
   md5: 7211c6d7cb77c291d513499386c26731
  sha1: 18f7e1ab059909cd0b90fa380da70f720a65ec6f

Changes since the previous release:

[Pod::Text] The default value of the sentence option is false, not
true, and has been since at least 2.0.0.  Fix the documentation to
match.  Thanks, eponymous alias.  (#124461)

[Pod::Text::Termcap] Correctly honor the width option, which was being
ignored due to a bug in interpreting user-supplied options.  Thanks,
eponymous alias.  (#124447)

[Pod::Text::Color, Pod::Text::Termcap] Fix a subtle wrapping bug with
long =item text that would cause lines to be wrapped when they didn't
need to be.  Thanks, eponymous alias.

[Pod::Text::Color, Pod::Text::Termcap] Clear any text attributes at
the end of each line and reinstate them at the start of the next line,
since some pagers (less -R in particular) clear all text attributes at
the end of each line and were therefore not correctly showing
attributes in wrapped text.  Thanks, eponymous alias.

[Pod::Text::Termcap] Correctly get the terminal width from Term::Cap
information when COLUMNS isn't set, instead of getting a string value
that later cannot be used numerically.

Specifying "none" for the errors option of Pod::Man and Pod::Text no
longer results in an errata section in the generated documentation,
matching the documented behavior.  Thanks, Olly Betts.

Fix order of SEE ALSO section in manual pages to match the
recommendation of perlpodstyle.

Use https for all eyrie.org URLs.

Add SPDX-License-Identifier headers to all substantial source files.

-- 
#!/usr/bin/perl -- Russ Allbery, Just Another Perl Hacker
$^=q;@!>~|{>krw>yn{u<$$<[~|| 0gFzD gD,
 00Fz, 0,,( 0hF 0g)F/=, 0> "L$/GEIFewe{,$/ 0C$~> "@=,m,|,(e 0.), 01,pnn,y{
rw} >;,$0=q,$,,($_=$^)=~y,$/ C-~><@=\n\r,-~$:-u/ #y,d,s,(\$.),$1,gee,print