Enlazar una librería con su documentación

Hay veces en las que tenemos por separado el fichero jar de una librería y otro fichero con la documentación de dicha librería.

Eclipse nos permite asociar la documentación de un jar con el mismo de una forma fácil.

Hay que ir a: Project -> Properties -> Jaba Build Path -> Libraries. Si desplegamos el jar al que queramos añadir la documentación, nos encontraremos con algo como lo que aparece en la figura.

Al seleccionar Javadoc location y hacer click en Edit... nos aparece un formulario en el que podemos elegir la localización de la documentación del jar, ya sea en una URL o en un archivo del ordenador o del workspace.

Al seleccionar una opción u otra, tenemos la opción de validar si la selección ha sido correcta con el botón Validate....

Una vez asociada la documentación con el jar, podemos beneficiarnos de tener la documentación del mismo integrada dentro del Eclipse.

De la misma manera, también podemos asociar el código fuente de un jar a un jar en concreto. ¿Para qué creéis que puede valer esto?