Warum Javadoc erzeugen nicht-konforme XHTML?
Frage
Ich habe gerade etwas erzeugt javadoc in ein Eclipse-Projekt eingefügt, keiner des HTML zu entdecken entspricht.
Es gibt sogar Fälle von schließenden Tags, die nie geöffnet wurde.
Gibt es eine Möglichkeit, dies zu beheben? Vielleicht ein "kompatibel sein" Option ...
Lösung
Nach einigen googeln, entdeckte ich XHTML Doclet 0,4 .
XHTML Doclet ist ein standardkonformer Alternative zum Javadoc Standard HTML doclet. Das Projekt revidiert die Dokumentstruktur auszuschließen veraltet Tags und Inline-Styles, erstellt gültig XHTML Markup und bietet eine bessere Haken für flexiblere CSS Manipulation.
Sieht aus wie jemand ein Plugin aus.
Sie noch bessere Möglichkeiten?
Bearbeiten: Hier ist die als verknüpft mit Sun Javadoc FAQ .
Andere Tipps
Die kurze Antwort ist, dass JavaDocs XHTML predate.
Es war ein interessanter Thread auf der Java-Posse Gruppe darüber vor kurzem, dass Sie interessant finden könnte: warum javadoc 1997 stecken?