2014-03-26 29 views
1

我一直在使用Java多年,我非常喜歡javadoc以外的語言。 javadoc生成的文檔讓我覺得自己在20世紀90年代正在瀏覽網頁。要製作一些美容文檔,您必須插入不明顯的html標籤,這會在生成html文件之前使您的評論幾乎不可讀。替代Javadoc?

我正在尋找一些替代javadoc,reStructuredText是我的第一選擇,但沒有它的doclet。另一種選擇是降價,但主要針對html,因此如果我無法找出其他方法,我會將其視爲我的最後手段。

我也在考慮從java文件中分離評論,但是它妨礙了在IDE中瀏覽代碼的開發人員。

任何好主意?

+0

看看[Doxygen的(http://www.stack.nl/~dimitri/doxygen/)我用了幾個項目,很找到它功能強大並且非常適合尋找文檔。 – Gladhus

回答

2

您可能不需要使用Javadoc的替代方案。 如果您使用的是Java 7,則新版本的Javadoc已重新設計。

下面是輸出的一個例子:Java 7 Reference

+0

我必須同意javadoc 6很無聊,但javadoc 7很好。 javadoc 8(http://docs.oracle.com/javase/8/docs/api/)更好。 – nimsson

+0

謝謝,重新設計使它好多了 –