Я просто вставил сгенерированный javadoc в проект eclipse, чтобы обнаружить, что ни один из HTML не соответствует требованиям.
Бывают даже случаи закрытия тегов, которые никогда не открывались.
Есть ли способ исправить это? Может быть, вариант «быть послушным» ...
После некоторого поиска в Google я обнаружил XHTML Doclet 0.4.
XHTML Doclet - это соответствующая стандартам альтернатива стандартному HTML-документу Javadoc. Проект изменяет структуру документа, чтобы исключить устаревшие теги и встроенные стили, создает допустимую разметку XHTML и предоставляет более совершенные хуки для более гибких манипуляций с CSS.
Похоже, кто-то сделал плагин.
Есть варианты лучше?
Изменить: Вот официальная страница плагина, на которую ссылается Часто задаваемые вопросы по документации Sun по Javadoc.
Короткий ответ заключается в том, что JavaDocs предшествуют XHTML.
Недавно в группе Java Posse была интересная тема, которая может вас заинтересовать: почему javadoc застрял в 1997 году?
