Czy można dokumentować makra GNU M4 za pomocą Doxygen lub czegoś podobnego?
Mamy duży zbiór makr i chcielibyśmy je dokumentować w komentarzach i generować z nich dokumentację (podobną do Doxygen, JavaDoc itp.)
Dzięki!
Odpowiedzi:
1 dla odpowiedzi № 1Nie, jest to niemożliwe, z tego powodudoxygen musi parsować dokument zgodnie z pewną gramatyką. Ponieważ m4 jest makroprocesorem ogólnego zastosowania, może przetwarzać dowolny plik tekstowy i nie jest w ogóle ograniczony do określonej gramatyki. Nawet jeśli wszystkie twoje pliki m4 byłyby w rzeczywistości C, doxygen musiałby parsować hybrydę m4 i C, co może „t. Doxygen jest ograniczony do obsługiwanych języków, jak opisano w dokumentacji doxygen.