2010-08-05 108 views
5

當我想要發佈版本時,是否有工具可以自動將@since標記添加到所有元素?自動@since javadoc標籤版本

所以我們可以說我有一大堆的方法,現在我的基本系統工作,所以我決定將它發佈爲版本0.1.0

我現在想要的是一種工具,搜索失蹤每@Since標記並相應地添加它。

我使用Eclipse,我發現JAutodoc,但據我所見,它只允許搜索缺少的標籤,我不得不手動添加它們。

編輯: 可能對某人感興趣的一種解決方法:從一開始就使用帶有右標記的Eclipse模板,並在每個發佈之後更改模板。

+0

偉大的問題。 – whiskeysierra 2010-08-05 19:18:39

回答

3

這聽起來像你的構建工具應該爲你提供的東西。如果你使用的是maven,你應該看看javadoc:fix。它看起來像它正是你想要的:

http://maven.apache.org/plugins/maven-javadoc-plugin/fix-mojo.html

+0

前段時間我確實嘗試瞭解maven。起初它看起來非常有前途,它仍然如此。但直到現在,我還沒有設法讓它起作用。無論如何,從下個月起,我希望有更多的時間,並再次看看。因此非常感謝! – Mene 2010-08-16 17:27:55

0

我可以只添加一個教訓我大約27年前教訓:不要試圖讓你的版本控制號碼與您的產品的版本號一致。這樣瘋狂的謊言。

+0

問題是:如果你的API是公開的,而其他人正在使用它,你有不同的版本,而不是每個人都有最新的版本,那麼讓人們知道他們是否可以使用特定方法是一件好事。 或者你有更好的選擇?我總是打開; D – Mene 2010-08-16 17:25:47