c++ - IDL/ODL を使用した doxygen

Question

多数の .ODL ファイルとODL コンパイラから生成された .h ファイルを含む C++ プロジェクトがある場合、.odl と .h の両方を解析するように doxygen に指示する必要がありますか? 一般に、生成されたコードを文書化するのは好きではありませんが、IDL は一種の特殊なケースです。

いずれにしても、私のテストでは ODL ファイルのメンバー リストが正しく機能していないようです。ODL ファイルは正しく解析されていますか?

Answer 1

このページから、Doxygen は解析*idlと*.odlファイルを完全にサポートしているようです。コメントのフォーマットに関して問題があるのではないでしょうか?

*.idl/*.odlとにかく、ファイルと生成されたファイルの両方を解析しないことをお勧めし.hます。後者は、定義により、生成され、ファイルで定義されているものと同じクラスを表し*.idl/*.oldます。

両方を解析することは、同じクラスのセットを 2 回文書化するようなものであり、明らかに良い考えではありません。