Construyendo documentación de Ruby para clases/fuente Java

Question

Como recientemente comencé a usar Jruby, más específicamente construyendo aplicaciones Java con código Ruby, comencé a usar bibliotecas Java como LWJGL y Slick.

Sé que Jruby cambia los nombres del método Java a una estructura más rubí, mi pregunta es, ¿hay alguna forma actual de generar documentación de Ruby, ya sea desde la fuente o mediante la conversión de la documentación actual o incluso en base a lo que Jruby expone los métodos ellos mismos?

Answer 1

En algún momento cuando Jruby 1.6.7 está fuera, planeo limpiar este proyecto realmente difícil para tal cosa:

https://github.com/enebo/noridoc

La intención es que tejerá la sintaxis de Java y Ruby juntas y dará documentación razonable para un rubyista que desea conocer todos los métodos de Ruby. En su forma actual, debería poder generar un conjunto razonable de documentos HTML de código Java que muestren todos los métodos alias de rubí. Tendrá que joder con el comentario de Javadoc.

Ah, y planeamos hacer que esta herramienta esté disponible fuera de la caja en Jruby una vez que sea lo suficientemente bueno para fusionarse.