phpDocumentorが余りにも使いづらいので、代わりにApiGenを使ってAPIドキュメントを作っています。
ApiGen | API documentation generator for PHP 5.3+
しかしApiGenはApiGenで、一時期メンテナンスが止まっていたせいもあって、パッケージのインストールに難があります。
この記事を書いている時点で、Composerを使って以下のようにインストールしようとすると、失敗します(!) どうも依存関係が壊れているようで。
$ composer require --dev 'apigen/apigen:*'
PHP - ApiGenを利用し続けるためのバッドノウハウ - Qiita
こちらの記事を参考に使い続けていたのですが、いい加減面倒くさくなってきたので、バージョンを固定したメタパッケージを作ってみました。
apigen/apigenの代わりにこっちをrequireすると、すんなりインストールできるはず。
$ composer require --dev 'hirak/apigen2.8.0:*'
中身は単にバージョンを固定しているだけなので、vendor/bin/apigen.phpとしてapigenコマンドがインストールされます。
apigen本家の方は、4系を今開発しているようなので、そのうちこんなバッドノウハウは必要なくなるかもしれません。