Comment exclure une fonction d'un graphe d'appel dans Doxygen?

Question

J'ai des fonctions de débogage qui sont appelées dans à peu près toutes les fonctions d'un grand programme. Ils sont conditionnellement activés par une variable macro définie. Je ne veux pas que cela apparaisse dans les graphiques d'appel, car je peux être à peu près sûr que chaque fonction les a. Est-il possible d'exclure la fonction du graphe

/*! Step 3: 
* @callgraph 
*/ 
void step3(double * phi, //... 
{ // CODE: 
/// inner_quadratic_form: 
/// \f$ s = (\phi_j^{\mathrm{(old)}})^T \Sigma_{\alpha\alpha} \phi_j^{\mathrm{(old)}}+1 \f$ 
double s = 1.0;debug_arg(s); 
inner_quadratic_form(&s, old_phi_row, &one, ka, Saa, ka, dl, dp); 
s+=1.0;debug_arg(s); 
} 

par exemple, la forme inner_quadratic doit être dans le graphe d'appel mais le debug_arg (s) ne fonctionne pas. Je pense que c'est différent de ce qui est déjà là parce que j'ai besoin de debug_arg documenté mais n'apparaissant pas dans les graphiques d'appel.

Answer 1

Comment désactiver conditionnellement debug_arg()? Si debug_arg() est une macro définie ainsi:

#if defined INCLUDE_DEBUG 
#define debug_arg(s) debug_arg_function(s) 
#else 
#define debug_arg(s) 
#endif 

alors tant que vous ne spécifiez pas INCLUDE_DEBUG dans le code ou la configuration Doxygen, alors il n'y aura pas d'appel de fonction à documenter.

Il est préférable de spécifier INCLUDE_DEBUG sur la ligne de commande plutôt que dans le code afin de ne pas avoir à modifier le code pour générer la documentation.