有沒有一種工具取代javadoc的東西,而不是正常的JavaDoc的HTMLish語法更多的Wiki風格的語法?是否有一個使用維基語法的javadoc替換?
我的一個問題是我大部分都是以源代碼的形式讀取JavaDoc。即使對於外部庫,我也嘗試添加源代碼,以便從我的IDE中導航到源代碼,檢查入口點上方的文檔以及下面的代碼。
另一個問題是,像列表和代碼示例這樣的東西很難寫,特別是如果你的IDE堅持要在每一行放上星星。我想看到的東西,用一種wiki語法與至少以下特點:
- 名單
- 代碼塊
- 交聯方法/類
有還有很多更好的東西,但我相信這些都是必需品。
有誰知道這樣的工具?
代碼塊都差不太多與'{@code}'。我認爲'{@link}'很適合鏈接到會員和類型。 – 2009-09-22 00:06:19
當你在考慮維基風格的顯示時,如果你可以編輯維基風格,並且將它推回到評論中,那將是非常不錯的。我懷疑這是多少要求。 – Carl 2009-09-22 02:28:52