Gostaria de saber se existem boas técnicas para construir / manter documentação na interface.

Eu estou construindo uma interface de código c + + para python usando swig; na maior parte eu sou apenas% incluindo os arquivos de cabeçalho c + +. Estou lidando com pelo menos dezenas de classes e centenas de funções, então ferramentas automatizadas são preferidas.

Idealmente, gostaria de usar os comentários formatados do doxygen nos cabeçalhos do c ++ para preencher as docstrings nas classes / métodos do python.

Alternativamente, gerar documentação separada (em ascii, html ...) também seria útil. Parece que esse tipo de funcionalidade foi suportado em versões anteriores do swig (1.3 e anteriores), mas não vejo uma maneira de fazer isso com o 2.0.

Existem técnicas úteis (automatizadas) para documentar a interface?