Я хотел бы знать, есть ли какие-либо хорошие методы для построения / поддержания документация по интерфейсу.

Я строю интерфейс из кода C ++ в Python, используя swig; в основном я просто %, включая заголовочные файлы c ++. Я имею дело, по крайней мере, с десятками классов и 100 функций, поэтому предпочтительнее использовать автоматизированные инструменты.

В идеале я хотел бы использовать комментарии в формате doxygen в заголовках c ++ для заполнить строки документации в классах / методах python.

Альтернативно, создание отдельной документации (в ascii, html ...) также было бы полезно. Похоже, такая функциональность была поддержана в более ранних версиях Swig (1.3 и более ранних), но я не вижу способа сделать это с 2.0.

Есть ли полезные (автоматизированные) методы для документирования интерфейса?