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

"no documentation in" install warnings

Thread Next
Dave Mitchell
February 16, 2016 10:19
"no documentation in" install warnings
Message ID:
currently blead's 'make install' sends about 80 of the following to

    no documentation in lib/Archive/Tar/
    no documentation in lib/CPAN/
    no documentation in lib/CPAN/

Since my goal is to make stderr empty during a blead build run, this makes
me unhappy.

This warning is generated by ./installman, which AFAKT is only used to
install man pages when installing blead, not when later installing CPAN
modules, so they don't get this warning.

So, is this a real warning: i.e. is it in some way bad that we're
installing modules that don't have any pod in them - if so then presumably
we should raise tickets with all affected modules asking that they add

Personally I think it's perfectly legal for a .pm file not to contain pod,
and that we shouldn't be checking for this. I.e. we should simply delete
this line from installman:

	    warn "no documentation in $mod\n" unless $opts{silent};

Other options might be to send the warning to stdout rather than stderr,
or maintain a whitelist of module filenames which we know are ok not to
contain pod. I don't like either of these options very much.

Diplomacy is telling someone to go to hell in such a way that they'll
look forward to the trip

Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About