ソースコードからマニュアルページを生成する方法を探し始めました。これで Doxygen のセットアップが完了し、整理された、役立つなどのすばらしい HTML ページが生成されます。
しかし... Doxygenはまともな、または使いやすいmanページを作成するのが苦手なようです。多くの Google 検索から、Doxygen を使用してマニュアル ページを生成することに関しては、それが一般的なコンセンサスであるように思われます。これは本当ですか、それとも Doxygen が man ページでより良い仕事をする方法を説明するページ/ヒントはありますか?
GitHub で doxy2man という 1 つのプロジェクトを見つけました。このプロジェクトは、Doxygen xml 出力ファイルを man ページに再処理するように特別に設計されているようですが、Doxygen 自体を強制的に改善できるかどうか知りたいです。
マニュアルページに使用している Doxygen オプション (あまり多くはありません) は次のとおりです。
$ grep MAN Doxyfile | grep -v "#"
GENERATE_MAN = YES
MAN_OUTPUT = man
MAN_EXTENSION = .3
MAN_LINKS = YES