Discussion :

[Pierpolay]

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 !

[FR119492]

Salut!

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

[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 !

[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...

[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).

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

[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 » ...