javadoc是否支持其他評論風格？

Question

我一直在使用doxygen生成文檔輸出的C++項目中工作。文檔我們使用的方法是這樣的：

//! This is an awesome method. You should totally use this method for all sorts 
//! of cool stuff that you might want to do. 
//! @returns something useful 
string my_awesome_method() {...} 

正如你所看到的，我們使用了//!評論前綴來表示的doxygen註釋塊。我們發現這對我們的需求非常有效。

現在我們添加一個Java組件，並希望保持與我們在C++中使用的評論風格的一致性，而不是移動到我們認爲是尷尬的/** */風格，由javadocs使用。有沒有辦法讓javadocs識別像doxygen這樣的其他前綴？或者javadocs是否需要使用/** */？我們可以只使用doxygen，但是圍繞javadocs構建的各種各樣的細節讓我們希望保持與這個生態系統的接口。

這可能嗎？恐怕答案可能不是。 :(

Answer 1

是，/** */ javadoc所認可的唯一註釋格式見http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html#format。