Subject: | broken manpages due to incomplete POD |
A bunch of modules contain incomplete boilerplate POD which lead to broken and useless manpages after running them through pod2man. Here's the list (of the manpages)
Module::Install::Admin::Bundle.3pm \
Module::Install::Admin::Compiler.3pm \
Module::Install::Admin::Find.3pm \
Module::Install::Admin::Makefile.3pm \
Module::Install::Admin::Manifest.3pm \
Module::Install::Admin::Metadata.3pm \
Module::Install::Admin::ScanDeps.3pm \
Module::Install::Admin::WriteAll.3pm \
Module::Install::AutoInstall.3pm \
Module::Install::DSL.3pm \
Module::Install::Fetch.3pm \
Module::Install::Include.3pm \
Module::Install::Inline.3pm \
Module::Install::MakeMaker.3pm \
Module::Install::Metadata.3pm \
Module::Install::Run.3pm \
Module::Install::Scripts.3pm \
Module::Install::Win32.3pm \
Module::Install::WriteAll.3pm \
Please either remove the POD fragments or complete them.
Additionally we have lib/Module/Install.pod (nice) and lib/Module/Install.pm (with incomplete POD), and pod2man creates a manpage from the .pm. Again, please remove the POD fragment from the .pm file.
Cheers,
gregor, Debian Perl Group