The method detail is missing.
Status: Alpha
Brought to you by:
quinntaylor
The method detail - i.e. _the_ essential part of the API documentation - is missing.
Compare the sample page
http://xhtmldoclet.sourceforge.net/newdocs/com/sun/javadoc/AnnotationDesc.html
with the javadoc page
http://java.sun.com/j2se/1.5.0/docs/guide/javadoc/doclet/spec/com/sun/javadoc/AnnotationDesc.html
Logged In: YES
user_id=1014310
Originator: NO
I'm certainly well aware that the *every* detail section is missing. This isn't a Java parse error, since Javadoc takes care of that part and produces the correct structure. Rather, it is a lack of code which properly processes the resulting structure. The part of the standard doclet code that produces those descriptions is particularly tangled and heinous. The refactoring is a real headache.
Since I'm finishing my MS in Computer Science, XHTML Doclet is currently on the back burner. Once I'm done (around December) I will be able to direct more attention at this project. I have tried to indicate that the doclet is not production-ready, since it isn't even close to 1.0 yet. (Of course, some apps never make it to 1.0, just depends on the author's numbering.)
This will definitely be addressed in a future fix.
Is there a possibility that this gets fixed? I try to avoid having to code Java, but when I am forced to, i’d at least comfort my inner web developer by creating proper html doc.