On Sat, Jan 30, 2016 at 3:29 PM, Russ Allbery <r...@cpan.org> wrote:
> Just so that I can add a comment to explain why this is here, to keep
> myself from deleting it five years later because it seems unnecessary,
> could you provide a bit of background on:
>
>> +delete $metadata{MAN1PODS} if $ENV{PERL_CORE};
>
> Is there some other method used to generate the man pages for core that
> doesn't want to do this from Makefile.PL?
The background is that the core build blows up like so with that entry in place:
Generating a Unix-style Makefile
Writing Makefile for Pod
"../../miniperl" "-I../../lib" "-I../../lib" "-I../../lib"
"-I../../lib" scripts/pod2text.PL scripts/pod2text
Extracting pod2text (with variable substitutions)
cp scripts/pod2text blib/script/pod2text
/Users/craig/perlrep/perl/cpan/podlators/../../miniperl "-I../../lib"
"-I../../lib" -MExtUtils::MY -e 'MY->fixin(shift)' --
blib/script/pod2text
"../../miniperl" "-I../../lib" "-I../../lib" "-I../../lib"
"-I../../lib" scripts/pod2man.PL scripts/pod2man
Extracting pod2man (with variable substitutions)
cp scripts/pod2man blib/script/pod2man
/Users/craig/perlrep/perl/cpan/podlators/../../miniperl "-I../../lib"
"-I../../lib" -MExtUtils::MY -e 'MY->fixin(shift)' --
blib/script/pod2man
make[1]: *** No rule to make target `pod/perlpodstyle', needed by
`manifypods'. Stop.
make[1]: *** No rule to make target `pod/perlpodstyle', needed by
`manifypods'. Stop.
Unsuccessful make(cpan/podlators): code=512 at make_ext.pl line 569.
make: *** [cpan/podlators/pm_to_blib] Error 25
so I copied what Pod::Perldoc does, the only other module in core that
passes MAN1PODS to MakeMaker.
But it looks like I entirely missed the pod/ directory in your
distribution, and I now note that we have a (presumably out-of-date)
perlpodstyle.pod in the top-level pod/ directory. Don't know why, but
core--cpan-diff (the tool we use to compare dual-life modules with
upstream) didn't add cpan/podlators/pod when I used it to generate a
patch. Probably pilot error of some sort.
So bear with me a bit longer while I get this sorted out.
