¿Alguien ha intentado incrustar comentarios de Doxygen dentro de los archivos fuente Lazy C++? Cualquier problema? ¿A dónde van los comentarios de Doxygen después de generar los archivos de cabecera/fuente?¿Funciona Lazy C++ (lzz) bien con Doxygen?
Seguí adelante y descargué Lazy C++ para probarlo, y parece que no funciona bien con Doxygen. Mis comentarios de Doxygen no aparecieron en absoluto en los archivos de encabezado/fuente generados.
Luego intenté hacer Doxygen analizar mi archivo lzz, que tenía un comando especial de preprocesador #hdr. Doxygen simplemente ignoró ese comando especial del preprocesador y la documentación generada parece estar bien.
Así que la moraleja de la historia es simplemente hacer que Doxygen analice los archivos * .lzz y no los archivos * .h/* .cpp generados. :-)
Queda otra pregunta: ¿recordaré hacer cambios en los archivos * .lzz (y no en los archivos generados) al corregir errores/errores? :-P –
"¿Recuerdo hacer cambios en los archivos * .lzz"? Este es el problema general con el código generado. Si va a editar los archivos generados, ponga los comentarios ahí y simplemente deje de usar el preprocesador. De lo contrario, solo edite los archivos .lzz y tenga sus propios archivos .cpp y .h no generados para las cosas que no desea autogenerar. –
Lo que generalmente hago es eliminar los archivos generados y luego volver a generarlos, parte del proceso de compilación; esto hace que la edición del archivo generado sea inútil. –