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，因为它们更容易自定义。