Otra de las asignaturas que tenía pendiente con java es JavaHelp. Una librería adicional de java que facilita el crear las ventanas de ayuda de nuestras aplicaciones, haciendolas similares a las de cualquier aplicación que usemos habitualmente. Una ventana de ayuda con una tabla de contenidos en forma de árbol, un texto en lado derecho por el que podemos navegar, ayuda contextual pulsando F1 en cualquier ventana, etc.
Los primeros ejemplos que vi buscando tutoriales me dejaron totalmente perplejo. La cantidad de ficheros xml que había que configurar para que la ayuda funcionara y lo complejos que parecían me dejaron totalmente fuera de juego.
Así que si debía ser por las malas, pues por las malas. Cogí el tutorial oficial de sun -si el enlace no funciona quizás es porque tengas que aceptar los términos de la licencia-, lo imprimí y me he puesto a leerlo desde el principo.
El tema de los ficheros de configuración ya me ha quedado claro y no era para tanto. De hecho, he escrito un pequeño resumen de los ficheros de configuración de JavaHelp en la Chuwiki.
En cuanto al código, haciendo copy-paste ya tengo un pequeño ejemplo funcionando, pero aunque intuyo el significado de las líneas que he copiado, prefiero terminar de leer el manual de sun, para enterarme bien enterado. Supongo que mañana en la cafetería en la que suelo desyunar lo liquide -nuevamente el nerd que lee cosas raras en las cafeterías- 
Una cosa que no me ha hecho gracia de JavaHelp es que parece que es difícil de depurar. Salvo el primer fichero .xml que se lee en la configuración, del resto no avisa si encuentra errores de sinaxis. Simplemente lo ignora y la parte de ayuda relativa a ese fichero .xml no funciona. Por otro lado, cuando no encuentra uno de los items que le indicamos, directamente saca una excepción por pantalla, por lo que puede estropearnos nuestro log de salida.
