Cualquier forma de incrustar javadoc en un tarro

¿Hay una manera de incrustar javadoc (carpeta / doc producida por JavaDoc Ant Task) en mi jar biblioteca que contiene mis archivos .class?

Preferiría no enviar la fuente y quisiera que los usuarios pudieran ver los comentarios del javadoc en eclipse sin tener que ir a través de la lengüeta de las bibliotecas referenciadas y agregar la cremallera de JavaDoc a mi lib de tercera persona.

Seguro que puede poner javadoc en su archivo binario JAR … pero ¿realmente tiene sentido?

Para leer los javadocs, un usuario va a tener que desempaquetar los archivos HTML del archivo JAR en el sistema de archivos de Android, y luego apuntar el navegador de Android en el archivo index.html (o lo que sea). Pero el mejor modelo para usar el archivo JAR para ejecutar su código NO es descomprimirlo. Y si no esperas que tus usuarios intenten ver el javadoc en sus teléfonos (!?!) … entonces poner los javadocs en el archivo JAR es "peso muerto".

Tiene mucho más sentido distribuir el árbol javadoc en un archivo ZIP o tar separado.

Por último, si espera que los usuarios desarrollen código en contra de las API de su producto, será mucho más fácil para ellos si les proporciona código fuente. Obtendrá una mejor satisfacción del cliente, menos solicitudes de asistencia para ayudarles a depurar su código y menos quejas injustificadas sobre el funcionamiento del código.

Seguro que puede actualizar un archivo jar de esta manera.

jar uf <your_jar> doc/<your doc file>