2010-08-05 7 views
5

Gibt es ein Tool zum automatischen Hinzufügen des Tags @since zu allen Elementen, wenn ich eine Release-Version haben möchte?Automatisches @since javadoc-Tag für Releases

Also lassen Sie sich sagen, ich habe eine Reihe von Methoden und mein Banksystem jetzt funktioniert, so dass ich entscheiden, es als Version veröffentlichen 0.1.0

Was ich will jetzt ein Werkzeug, das für jeden fehlenden @since sucht tag und fügt es entsprechend hinzu.

Ich benutze Eclipse und ich habe JAutodoc gefunden, aber soweit ich sehen kann es nur nach den fehlenden Tags suchen und ich müsste sie manuell hinzufügen.

EDIT: Eine Workaround, die für jemanden interessant sein könnte: Von Anfang an verwenden Sie eine Eclipse-Vorlage mit dem Recht seit Tag und nach jeder Veröffentlichung ändern Sie die Vorlage.

+0

Große Frage. – whiskeysierra

Antwort

3

Das klingt nach etwas, das Ihr Build-Tool Ihnen bieten sollte. Wenn Sie maven verwenden, sollten Sie sich Javadoc ansehen: fix. Es sieht aus wie es tut genau das, was Sie wollen:

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

+0

Ich habe vor einiger Zeit versucht, in Maven zu suchen. Zuerst sah es sehr vielversprechend aus und es tut es immer noch. Aber bis jetzt habe ich es nie geschafft, es zur Arbeit zu bringen. Jedenfalls hoffe ich ab dem nächsten Monat noch etwas Zeit zu haben und werde es mir nochmal anschauen. Also danke bis jetzt! – Mene

0

Kann ich nur eine Lektion füge ich vor etwa 27 Jahren gelernt: versuchen Sie nicht, Ihre Versionskontrollnummern ausrichten mit Ihrem Produkt-Release-Nummern zu machen. So liegt der Wahnsinn.

+0

Nun, das Problem ist: Wenn Ihre API öffentlich ist und andere sie verwenden und Sie verschiedene Versionen haben und nicht jeder über die neueste Version verfügt, dann ist es eine gute Sache, die Leute wissen zu lassen, ob sie eine bestimmte Methode verwenden können oder nicht. Oder haben Sie eine bessere Lösung? Ich bin immer offen, D – Mene

Verwandte Themen