Doble código de prevención de inclusión en PHP evita que Doxygen genere documentación
Estoy escribiendo aplicaciones PHP relativamente complejas y tengo varios archivos para definiciones de clase formateadas de la siguiente manera:
<?php
if(!class_exists("FooBar"))
{
/**
* This is documentation for the class FooBar
*/
class FooBar
{
/**
* Documentation for FooBar's constructor
*/
public function __construct() {
;
}
}
} // class_exists
Esto es para evitar errores de definición múltiple con jerarquías de clase complejas y aplicaciones.
Sin embargo, Doxygen no documenta ninguna clase que se especifique de esta manera. Comentando o eliminando elif(!class_exists())
La declaración hace que Doxygen documente correctamente esta clase, pero introduce errores con las aplicaciones.
¿Hay alguna manera de forzar a Doxygen a generar documentación para estas clases?