c++ - SphinxはすでにC++ドキュメントに適していますか？

Question

C++の新しいプロジェクトのドキュメントジェネレータを試してみたいです。私の選択肢はDoxygenかSphinxのどちらかだと思います。私はPythonでSphinxを使用したいプロジェクトを持っているので、SphinxがC++にも正しい選択であるかどうか疑問に思います。SphinxのWebサイトには、C ++がサポートされていると記載されていますが、C++ドキュメントを使い始めるためのドキュメントが見つかりませんでした。

同様の質問はStackoverflowですでに議論されており、主な答えは次のように結論付けています。

まだ完全には使用できません
が、見続けてください

議論は1年以上前のものなので、この結論はまだ有効かどうか疑問に思います。C ++ドキュメントには、SphinxではなくDoxygenを選択する必要がありますか？

Answer 1

Sphinx は、C++ ソースからドキュメントを単独で抽出することはできません。ただし、 Doxygen を使用して C++ からドキュメントを抽出する拡張機能があり、最も顕著なのはBreatheです。私はこれらのどれもテストしていません。

Answer 2

C++ の場合、Doxygen は非常に優れています。C++ の Sphinx サポートは、Doxygen を介して行われます ( Breatheを使用)。

保守性を向上させるために、2 つの言語に対して 1 つのツールのみを使用する必要があります。Doxygen は Python コードからドキュメントを生成できるため、可能であれば両方のソースに Doxygen を使用することをお勧めします。これは Doxygen と Python のチュートリアルです。