Ich würde gerne wissen, ob es gute Techniken zum Erstellen / Verwalten der Dokumentation auf der Benutzeroberfläche gibt.

Ich erstelle eine Schnittstelle von C ++ - Code zu Python mit Swig; Meistens bin ich nur% einschließlich der C ++ - Header-Dateien. Ich habe es mit mindestens Dutzenden von Klassen und Hunderten von Funktionen zu tun, daher werden automatisierte Tools bevorzugt.

Im Idealfall möchte ich die doxygen-formatierten Kommentare in den c ++ - Headern verwenden, um die Dokumentzeichenfolgen in den Python-Klassen / Methoden aufzufüllen.

Alternativ wäre es auch nützlich, eine separate Dokumentation (in ASCII, HTML ...) zu erstellen. Es sieht so aus, als ob diese Art von Funktionalität in früheren Versionen von swig (1.3 und früher) unterstützt wurde, aber ich sehe keine Möglichkeit, dies mit 2.0 zu tun.

Gibt es nützliche (automatisierte) Techniken zur Dokumentation der Schnittstelle?