使用MakeMaker的手册页

Question

我写了一些手册页，我想从MakeMaker安装它们。

我想使用像INSTALLSITEMAN1DIR*环境变量这样的环境变量来控制它们的安装位置。

我应该把man文件放在源代码树中的什么位置，或者我需要对Makefile.PL做什么才能告诉它关于它们的信息？

Answer 1

您的手册页是什么格式？您不应该发布完全编译的手册页，因为每个目的地主机都需要根据需要使用自己的groff或troff版本或其他版本对它们进行格式化。

如果您以POD格式编写手册页，MakeMaker将自动选取它们并将它们放在正确的位置。

1. 只需以.pod结尾命名文件，
2. 将它们放在您的lib目录中，然后
3. 将它们格式化为Perl的Plain Old Documentation (POD)格式。

如果您需要以其他格式发布您的手册页，我不知道协议是什么。您可能需要定制ExtUtils::MakeMaker生成的Makefile。在这一点上，您可能希望研究一下Module::Build、Module::Install或Dist::Zilla，因为它们更容易定制。