Discussion :

[Mercusyo]

Bonjour à toutes et à tous,

Je remonte un peu ce post, car je suis également débutant avec doxygen.
J'aimerais savoir la procédure exacte à suivre pour le nommage des commentaires doxygen. En effet, j'ai essayé, et je n'ai pas le résultat espéré.

Par exemple, j'ai un fichier d'en-tête par exemple "toto.h", pour plusieurs unités CPP (pomme.cpp, poire.cpp ...). J'ai documenté principalement dans les sources mais aussi dans le header. J'aimerais savoir comment fait doxygen pour se retrouver entre mon unique header et mes différents CPP ? Est-ce possible tout simplement ? si non, je suis désespéré ...

J'ai suivi le tutoriel suivant :http://franckh.developpez.com/tutoriels/outils/doxygen/

Dans la partie "Classe" de la doc HTML générée, j'ai la description brève, mais je n'ai pas les descriptions pour les constructeurs/destructeurs/méthodes ...

J'ai dû oublier quelque chose, mais je ne vois pas ... ou alors, est-ce un paramètre de doxygen dans le wizard ?

Merci pour votre aide,

[Mercusyo]

Bonjour,

Je viens de trouver mon problème.

Je développe sous C++ Builder XE2 et dans mes projets, j'ai beaucoup de "DLL" et pour exporter correctement ces DLL, il faut placer __declspec(dllexport) entre le mot clé "class" et le nom de la classe (MaClasse)

En version précédente, C++ Builder autorisait : __declspec(dllexport) class MaClasse

Est-ce qu'il y a moyen avec doxygen d'ignorer des mots clés ?
Ou si quelqu'un d'autre à une idée, je suis preneur, merci

Merci

[Mercusyo]

Bonjour,

J'ai trouvé le moyen sous doxygen "d'ignorer" des mots clés et notamment "__declspec(dllexport)".

La réponse est ici en fait : http://www.stack.nl/~dimitri/doxygen/preprocessing.html

Dans la partie "preprocessing", il faut donc modifier les paramètres suivants :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
10
11
12
#---------------------------------------------------------------------------
# Configuration options related to the preprocessor
#---------------------------------------------------------------------------
ENABLE_PREPROCESSING   = YES
MACRO_EXPANSION        = YES
EXPAND_ONLY_PREDEF     = YES
SEARCH_INCLUDES        = YES
INCLUDE_PATH           = 
INCLUDE_FILE_PATTERNS  = 
PREDEFINED             = __declspec(x)=
EXPAND_AS_DEFINED      = 
SKIP_FUNCTION_MACROS   = YES

Et là, cela fonctionne impeccable

Si cela peut aider quelqu'un d'autre