perl - MakeMaker の man ページ

Question

MakeMaker からインストールしたい man ページをいくつか書きました。

環境変数のような環境変数を使用して、それらがインストールされる場所を制御したいと思いINSTALLSITEMAN1DIR*ます。

ソース ツリーのどこに man ファイルを配置する必要がありますか、それとも Makefile.PL にそれらについて伝えるために何をする必要がありますか?

Answer 1

あなたのマンページはどのような形式ですか？各宛先ホストは必要に応じて独自のバージョンの groff や troff などでフォーマットする必要があるため、完全にコンパイルされたマンページを出荷するべきではありません。

マンページを POD 形式で記述した場合、MakeMaker はそれらを選択して正しい場所に自動的に配置します。

1. .pod末尾にを付けてファイルに名前を付けるだけで、
2. それらをlibディレクトリに配置し、
3. Perl のPlain Old Documentation (POD)形式でフォーマットします。

マンページを他の形式で出荷する必要がある場合、プロトコルがどうなるかわかりません。Makefileおそらく、ExtUtils::MakeMakerが生成するをカスタマイズする必要があります。その時点で、カスタマイズがはるかに簡単なModule::Build、Module::Install、またはDist::Zillaを調べることをお勧めします。