2010-06-17 39 views
0

如果您有一個C++項目,其中包含一堆.ODL文件,則從ODL編譯器生成的.h文件應告訴doxygen解析.odl和.h,或者僅解析.odl和.h非此即彼?一般來說,我不喜歡記錄生成的代碼,但IDL是一種特殊情況。doxygen with IDL/ODL

在任何情況下,似乎ODL文件的成員列表在我的測試中工作不正常,ODL文件是否被正確解析?

回答

3

this page看來Doxygen完全支持解析*idl*.odl文件。也許你對評論格式有一些問題?

無論如何,我建議你不要解析文件*.idl/*.odl和生成的.h文件。根據定義,後者是根據*.idl/*.old文件中定義的類生成和表示的類。

對兩者進行解析就像記錄同一類的兩次,這顯然不是一個好主意。

+0

這是我最初的想法......但使用這些接口的類會發生什麼......它們包含.h文件,因此這不代表鏈中的「缺口」? – 2010-06-17 09:50:05

+0

我不確定評論格式,即使沒有源註釋(我們正在對現有項目進行填充),我也會將其設置爲生成所有內容。我得到一個「xxx.odl」的鏈接,但點擊它並沒有顯示出像.h文件那樣的文件來源。 – 2010-06-17 09:50:58

+0

@John:我懷疑Doxygen可以生成鏈接到生成的文件(也就是它所做的**而不是**解析自己)。關於鏈中的「缺口」:我想這只是一種看待事物的方式;)Imo,認爲一些未生成的類使用生成的文件是完全正確的。這裏沒有真正的「差距」:只是一個額外的「鏈接」(「一代」)。 – ereOn 2010-06-17 10:34:48