¿Por qué Javadoc genera XHTML no compatible?
Pregunta
Acabo de pegar algunos javadoc generados en un proyecto de eclipse, para descubrir que ninguno de los HTML es compatible.
Incluso hay casos de etiquetas de cierre que nunca se abrieron.
¿Hay alguna forma de arreglar esto? Tal vez un '' cumpla con '' opción ...
Solución
Después de buscar en Google, descubrí XHTML Doclet 0.4 .
XHTML Doclet es un estándar compatible alternativa al estándar Javadoc HTML doclet. El proyecto revisa el estructura del documento para excluir obsoletos etiquetas y estilos en línea, crea válidos Marcado XHTML, y proporciona mejores ganchos para CSS más flexible manipulación.
Parece que alguien hizo un complemento.
¿Alguna opción mejor?
Editar: Aquí está la Página oficial del complemento del complemento enlazado por Preguntas frecuentes de Sun Javadoc .
Otros consejos
La respuesta corta es que JavaDocs es anterior a XHTML.
Recientemente hubo un hilo interesante en el grupo de Java Posse sobre esto que podría encontrar interesante: ¿por qué se bloqueó javadoc en 1997?