Estas últimas semanas he estado programando un poco en C++, por aquello de recordar todo lo que subconscientemente he ido olvidando (o quizá no tan subconscientemente). Esta vez estoy usando librerías para todo, se acabó eso de sudar la gota gorda, que tampoco tengo mucho tiempo que gastar.

El caso es que, de cara a utilizarlo, voy a utilizar un lenguaje de script (de hecho, ya he empezado a hacer algunos bindings) y me entra una duda, ¿cómo voy a documentarlo?. Doxygen está muy bien cuando documentas un código de un lenguaje que conoce y cuando documentas funciones que existen en el código. Pero ahora yo tengo funciones todas del mismo tipo (solo cambian en el nombre) pero que en el sistema de script tendrán un número de parámetros determinado y un valor de retorno. Pero eso en el código de C++ no aparece reflejado a simple vista pues, como muchos ya sabréis, el sistema de script se comunica con la parte de C++ a través de una pila, por lo que doxygen no se entera de nada de esto.

¿Qué debería utilizar para documentar la API que estoy creando en el script? Lo más decente que se me ocurre es hacerla a mano, o quizás intentar seguir apañando el doxygen a ver si consigo algo más decente. ¿Alguien me puede iluminar el camino?