我一直在使用Java多年,我非常喜歡javadoc以外的語言。 javadoc生成的文檔讓我覺得自己在20世紀90年代正在瀏覽網頁。要製作一些美容文檔,您必須插入不明顯的html標籤,這會在生成html文件之前使您的評論幾乎不可讀。替代Javadoc?
我正在尋找一些替代javadoc,reStructuredText是我的第一選擇,但沒有它的doclet。另一種選擇是降價,但主要針對html,因此如果我無法找出其他方法,我會將其視爲我的最後手段。
我也在考慮從java文件中分離評論,但是它妨礙了在IDE中瀏覽代碼的開發人員。
任何好主意?
看看[Doxygen的(http://www.stack.nl/~dimitri/doxygen/)我用了幾個項目,很找到它功能強大並且非常適合尋找文檔。 – Gladhus