Community
Participate
Working Groups
Since JDK 1.4, javadoc supports the -tag:cm:description argument which provides a nice and simple way of specifying new javadoc tags. http://java.sun.com/j2se/1.4.2/docs/tooldocs/windows/javadoc.html#tag The use of this cmd line argument is not supported in Eclipse (while the use of doclets seems to be) and could be easily integrated in the IDE, e.g. as a project preference. This request is fueled by a university course where we teach programming using the contract model - and while the @require and @ensure tags are still being kept as "future" tags, we would like to have a simple configuration option that allows us to generate documentation for the contract model _now_. http://forum.java.sun.com/thread.jsp?forum=41&thread=72830
Martin, can you please comment.
Thanks for the pointer. I think we currently have no UI at all for the javadoc 1.4 options. Note that you can always use the 'Additional options' field to enter the 1.4 command line arguments. I don't know if we find time to add more UI to the wizard, maybe somebody from the community would be interesseed to bring the Javadoc wizard up to date?
If we introduce taglets, JCore should store them. Problems in Javadoc comments could then include the taglet rules.
Will reconsider post 3.0
In addition to the taghead (to be used for Javadoc export via '-tag tagname:Xaoptcmf:"taghead"' and for rendering in the Javadoc hover), the preferences should also contain an option that tells whether the tag needs a tag description (see bug 222902).
As of now 'LATER' and 'REMIND' resolutions are no longer supported. Please reopen this bug if it is still valid for you.
Reopening, this is still a valid request.