This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Avoid installman warning about "no documentation in pod/perldoc.pod"
authorNicholas Clark <nick@ccl4.org>
Thu, 22 Dec 2011 16:02:01 +0000 (17:02 +0100)
committerNicholas Clark <nick@ccl4.org>
Sat, 24 Dec 2011 09:27:36 +0000 (10:27 +0100)
commit1cb2462dfbfd850261a04986dde33d544c98a935
tree9d4a2445a0190272947a09dd62bfafff8d04927b
parent65e5b0167e9699a603db53d07657ab54bfacfa34
Avoid installman warning about "no documentation in pod/perldoc.pod"

Since commit a2afbef4476f724a in July 2011 moved perldoc.pod from pod/ to
dist/Pod-Perldoc/lib/ installman will have been warning
"no documentation in pod/perldoc.pod", having already installed the perldoc
man page earlier in the process.

However, the reference in utils.lst has actually been arguably erroneous
since it was added in commit cd0cddc9814dd65e (July 2003) to stop installman
installing an empty perldoc.1 manpage. (Which it had been doing since commit
1a67fee7d910c677 (December 2002), as a side effect of overwriting the
correct file (sourced from pod/perldoc.pod) with an incorrect file (sourced
from scanning utils/perldoc for Pod). The fix "worked" by causing perldoc.1
to be written correctly twice, both times sourced from pod/perldoc.pod :-)

The best fix seems to be to remember the names of the manpages we install
in man1, and automatically skip processing for any utility whose manpage
has already been installed.
installman
utils.lst