Ist es möglich, GNU M4 Makros mit Doxygen oder ähnlichem zu dokumentieren?
Wir haben eine große Sammlung von Makros und möchten diese in Kommentaren dokumentieren und daraus Dokumentationen erzeugen (ähnlich wie Doxygen, JavaDoc, etc.)
Vielen Dank!
Antworten:
1 für die Antwort № 1Nein, das ist unmöglich, der Grund dafür istDoxygen muss das Dokument gemäß einiger Grammatik analysieren. Da m4 ein Allzweck-Makroprozessor ist, kann er jede Art von Textdatei verarbeiten und ist nicht auf eine bestimmte Grammatik beschränkt. Selbst wenn alle Ihre m4-Dateien tatsächlich C wären, müsste doxygen einen Hybrid aus m4 und C parsen, was er nicht kann. Doxygen ist auf die unterstützten Sprachen beschränkt, wie in der doxygen-Dokumentation beschrieben.