5
Qualcuno ha provato a incorporare commenti Doxygen nei file di origine Lazy C++? Alcun problema? Dove vanno i commenti Doxygen dopo aver generato i file header/sorgente?Lazy C++ (lzz) funziona bene con Doxygen?
A
risposta
2
sono andato avanti e scaricato Pigro C++ per provarlo, e sembra che non gioca sempre pulito con Doxygen. I miei commenti su Doxygen non apparivano affatto nei file header/sorgente generati.
Allora ho provato a fare Doxygen analizzare il mio file LZZ, che ha avuto uno speciale comando di #hdr preprocessore. Doxygen ha semplicemente ignorato il comando speciale del preprocessore e la documentazione generata sembra soddisfacente.
Quindi la morale della storia è di fare semplicemente Doxygen analizzare i file * .lzz e non i * .h/* cpp file generati. :-)
Un'altra domanda rimane: Dovrò ricordarsi di apportare modifiche ai file * .lzz (e non i file generati) nel fissare errori/bug? :-P –
"Mi ricorderò di apportare modifiche ai file * .lzz" - questo è il problema generale con il codice generato. Se hai intenzione di modificare i file generati, inserisci i commenti e smetti di usare il preprocessore. Altrimenti, modifica solo i file .lzz e disponi di file .cpp e .h non generati per le cose che non vuoi generare automaticamente. –
Quello che faccio in genere è eliminare i file generati e quindi rigenerarli, parte del processo di compilazione - questo rende inutile la modifica del file generato. –