はじめに Perl プロジェクトのソースコードに記された POD から、GNU make を使ってドキュメントを一括生成する方法を紹介します。 比較的シンプルな Makefile で実現できました。 プロジェクト構成例 プロジェクトの構成が、以下のようになっているとします。 . ├── bin │ ├── bar.pl │ └── foo.pl └── lib ├── Foo │ └── Bar.pm └── Foo.pm ドキュメント生成要件 ドキュメントは以下のルールで生成するとします。 doc/ ディレクトリ以下に、ソースコードのパスを元に1ファイルずつ生成する pod2html コマンドを使って HTML 形式で出力 Makefile Makefile をプロジェクトのルートディレクトリに配置します。 内容は以下のようにします。 .PHONY: html GENHTML = pod