Fortran et Doxygene

Version imprimable

29/09/2009, 12h10
Pierpolay

Fortran et Doxygene

Bonjour à tous!
Je suis en ce moment étudiant et je travaille avec un collègue sur un projet en Fortran pour une entreprise.

Nous travaillons sur un logiciel de calcul qu'il faut remettre au gout du jour, et nous avons pour cela pensé réaliser une documentation avec l'aide du logiciel Doxygene. Le problème est que bien que ce logiciel supporte le fortran, nous n'arrivons pas à obtenir de documentation. Nous avons pourtant la dernière version du logiciel 1.6.1...

Diverses réglages glanés ça et là sur les forums dédiés à ce logiciel n'ont pas permis de résoudre le problème, d'autant qu'ils concernent essentiellement des indications sur les versions antérieures. Nous n'avons pas trouvé non plus de tutoriel pour ce logiciel en fortran...

Est-ce que quelqu'un aurait déjà utilisé ce logiciel associé au fortran ? Peut-être savez vous où trouver une description claire des réglages à effectuer pour réaliser une documentation dans ce langage (options, balises utilisées...) ?

Merci d'avance !
30/09/2009, 11h11
FR119492

Salut!

Citation:

nous avons pour cela pensé réaliser une documentation avec l'aide du logiciel Doxygene. Le problème est que bien que ce logiciel supporte le fortran, nous n'arrivons pas à obtenir de documentation.

Est-il bien raisonnable de choisir un logiciel non documenté?
Jean-Marc Blanc
01/10/2009, 09h16
Pierpolay

Bonjour,

j'ai du mal m'exprimer quant à la documentation. La documentation pour doxygen existe pour le langage C et d'autres, mais il n'y a pas d'explications précises pour le fortran...
Nous avons finalement réussi à obtenir quelques indications en utilisant les balises C, mais impossible d'obtenir des commentaires internes avec le même procédé...Doxygen ne semble pas comprendre les balises \var, \def notamment, alors qu'elle fonctionnent pour le C...
Si quelqu'un a déjà fait face à ce genre de problème, son expérience sera la bienvenue.

Merci encore !
12/10/2009, 11h43
Pierpolay

Bonjour,

bon, après moult essais, j'arrive à obtenir pas mal de documentation finalement (mais ça a pris le temps...).
Par contre j'ai un gros problème avec mes fichiers ".h". En effet, les balises fortran qui fonctionnaient pour les fichiers fortran ne sont pas reconnues. A la place, doxygen semble reconnaitre certaines balises C (\file, \brief...). Seulement si je ne m'abuse, inclure du code C dans du code fortran lors de l'appel des includes risque d'être problématique (sans parler de la compilation)...

Quelqu'un a-t-il déjà été confronté à ce genre de problème? J'avoue être complètement perplexe sur ce point...
13/10/2009, 08h36
Ehouarn

Bonjour,

J'avais, il y a un certain temps, regardé du côté de Doxygen... mais (de mémoire) le Fortran n'est pas pris en charge par défaut, et il faut bidouiller/créer cette prise en charge soi-même. Et c'est pourquoi j'en était resté là.

J'imagine donc assez facilement que ça ne marche qu'approximativement; en particulier pour les fichiers ".h" (si quelque part Doxygen essaye de reconnaitre automatiquement le type de langage d'après l'extention du fichier; il est très probable qu'il en déduise que c'est du C).

Citation:

si je ne m'abuse, inclure du code C dans du code fortran lors de l'appel des includes risque d'être problématique (sans parler de la compilation)...

C'est clair; on ne mélange pas les langages comme ça...

Bonne continuation
13/10/2009, 15h45
Sylvain Bergeron

L'extension « .i » est souvent utilisée à la place de « .h » en Fortran, entre autre pour éviter le conflit avec le C. Peut-être Doxygene comprend t-il le « .i » ...
13/10/2009, 17h13
Pierpolay

Bonjour,

Merci pour vos réponses. Je vais de ce pas essayer de passer mes ".h" en ".i" et voir si la documentation et le programme fonctionnent bien. Je vous tiens au courant !
Merci encore!

PS : la dernière version de Doxygen est sensée gérer le Fortran (j'ai d'ailleurs réussi à documenter un peu le programme sans bidouiller outre mesure), c'est d'ailleurs précisé sur le site...par contre aucune mention des headers, d'où le problème:?
14/10/2009, 10h09
Pierpolay

Re-bonjour,

mauvaise nouvelle, ça ne fonctionne toujours pas...

J'ai essayé de faire reconnaitre les fichiers ".i" à Doxygen, via l'option "Extension Mapping", mais cela ne change rien. J'ai eut beau essayer plusieurs combinaisons dans cette option (du genre .i=.h, .i=fortran, C=fortran, .h=fortran...), Doxygen ne génère pas de documentation.
Pourtant dans certains cas, lorsque j'utilise le lien vers le code source, les instructions en fortran (avec balises doxygen) n'apparaissent pas, signe qu'elles sont bien reconnues par doxygen...mais mystère, aucun commentaire n'apparait!
:calim2:Je n'y comprends plus rien...

Merci pour l'idée en tout cas, je vais continuer à fouiller les options de Doxygen au cas où...et si vous avez d'autres idées n'hésitez pas, je suis preneur !