Me gustaría saber si existen buenas técnicas para construir / mantener documentación en la interfaz.

Estoy creando una interfaz de código c ++ a python usando swig; en su mayoría solo estoy% incluyendo los archivos de cabecera c ++. Estoy tratando con al menos docenas de clases y cientos de funciones, por lo que se prefieren las herramientas automatizadas.

Idealmente, me gustaría usar los comentarios con formato de doxygen en los encabezados de c ++ para completar las cadenas de documentos en las clases / métodos de python.

Alternativamente, también sería útil generar documentación separada (en ascii, html ...). Parece que este tipo de funcionalidad fue compatible con versiones anteriores de swig (1.3 y anteriores) pero no veo una forma de hacerlo con 2.0.

¿Existen técnicas útiles (automatizadas) para documentar la interfaz?