¿Hay alguna forma de optimizar doxygen para C++?

Question

Para un proyecto de Qt/C++ usaremos doxygen para generar cierta documentación, , por lo tanto, estoy buscando un archivo de configuración "óptimo".

Una cosa que yo estaba pensando es que tiene cosas por el estilo

OPTIMIZE_OUTPUT_FOR_C = NO 
OPTIMIZE_OUTPUT_JAVA = NO 
OPTIMIZE_FOR_FORTRAN = NO 
OPTIMIZE_OUTPUT_VHDL = NO 

Pero no puede encontrar algo por el estilo para C++, y no estoy seguro de si necesito algo así para C++.

¿Existe una opción como "OPTIMIZE_OUTPUT_FOR_C++"?

Gracias Johan

Answer 1

Me parece que Doxygen es por defecto optimizado para C++. Por lo que puedo decir, C++ fue el primer idioma con el que Doxygen fue diseñado para ser utilizado; fue soportado desde el "Registro de cambios". El soporte de Java, por otro lado, no se agregó hasta la versión 1.2.5. La opción OPTIMIZE_OUTPUT_FOR_C también no se agregó hasta 1.2.5, indicando que antes de 1.2.5, Doxygen estaba destinado a ser utilizado más para C++, y menos para C.

Sin permitiendo cualquiera de los otros OPTIMIZE_FOR_<X> opciones, la salida del Doxygen usa la denominación de estilo C++ en la salida. Por ejemplo, creará un encabezado de grupo llamado "Clases" para enumerar todas las clases y estructuras. Por otro lado, si OPTIMIZE_OUTPUT_FOR_C está activado, el nombre de ese encabezado de grupo se cambia a "Estructuras de datos" (esto tiene sentido ya que C no tiene "clases").

Por lo tanto, si desea optimizar la salida para C++, creo que la respuesta es simplemente utilizar la configuración de optimización predeterminada (es decir, no activar OPTIMIZE_OUTPUT_FOR_C o cualquiera de las demás opciones).