Précédent   Forum des professionnels en informatique > PHP > Outils
Outils Forum d'entraide sur les outils pour développeurs PHP : EDI, installation, administration... Avant de poster : FAQ outils, toutes les FAQ PHP et les comparatifs
Partagez cette discussion sur d'autres réseaux sociaux : Viadeo Twitter Google Facebook Digg Delicious MySpace Yahoo
Réponse Proposer ce sujet en actualité
 
Outils de la discussion
Publicité
'
Vieux 17/01/2007, 07h49   #1
Membre émérite
 
Inscription : octobre 2003
Messages : 1 160
Détails du profil
Informations personnelles :
Âge : 27

Informations forums :
Inscription : octobre 2003
Messages : 1 160
Points : 882
Points : 882
Par défaut [Doxygen] Un if avant une classe empêche la documentation de celle-ci ?

Bonjour à tous,

je travaille actuellement sur un "gros" projet en PHP/JS/CSS...normal quoi.
J'ai choisi de documenter mon code avec Doxygen, notemment parce que je l'avais déjà beaucoup utilisé pour le C++.

Toutes mes classes étaient magnifiquement bien documentée, du moins elles apparaissaient dans la documentation générée jusqu'à ce que j'ajoute avant chaque class un petit if pour gérer les inclusions de fichier....
Et là ...toutes les classes pour lesquelles j'ai ajouté un if avant le mot clef class ne sont plus documentée...

Si dessous un exemple d'un fichier dont la classe n'apparaitra pas dans ma documentation Doxygen. J'ai beau cherché une option permettant de résoudre le problème dans mon Doxyfile, je ne trouve pas.

Avez vous déjà rencontré ce problème ? Trouvé une solution ?
Toute aide sera grandement appréciée. Merci d'avance.

Code :
1
2
3
4
5
6
7
8
9
10
11
12
13
 
<?php
include 'errors.php';
if ( CST_JE_SUIS_IMPORTANT == true )
{
    echo 'Message à la ***';
} else { /* Rien */ }
 
class Bidule
{
 
}
?>
__________________
Neilos
Neilos est déconnecté   Envoyer un message privé Réponse avec citation 00
Vieux 18/01/2007, 16h08   #2
Membre éclairé
 
Homme Michael Chusseau
Coordinateur développement web
Inscription : août 2004
Messages : 475
Détails du profil
Informations personnelles :
Nom : Homme Michael Chusseau
Âge : 29
Localisation : France

Informations professionnelles :
Activité : Coordinateur développement web
Secteur : High Tech - Multimédia et Internet

Informations forums :
Inscription : août 2004
Messages : 475
Points : 392
Points : 392
Salut,

Moi aussi j'utilise doxygen pour mes projets et je n'est jamais rencontré se problème.

devant mes class j'ai généralement une fonction et je me suis jamais fait jeter par doxygen

tu as essayer de mettre un commentaire devant ton if ?

et essaye un truc comme cela
Code :
1
2
3
4
5
6
 
/// Classe permettant la gestion de bidule
class Bidule
{
 
}
Moi en php je commente avec 3 / pour que doxygen me le prenne

Voila

Mic
mic79 est déconnecté   Envoyer un message privé Réponse avec citation 00
Vieux 21/01/2007, 15h31   #3
Membre émérite
 
Inscription : octobre 2003
Messages : 1 160
Détails du profil
Informations personnelles :
Âge : 27

Informations forums :
Inscription : octobre 2003
Messages : 1 160
Points : 882
Points : 882
Salut,

et merci pour ta réponse.
Moi j'utilise /** */ pour les commentaires doxygen.

Je n'ai pas encore trouvé le moyen de lui faire documenter mes classes qui ont un if devant...

Si je trouve je vous préviens...
__________________
Neilos
Neilos est déconnecté   Envoyer un message privé Réponse avec citation 00
Réponse Proposer ce sujet en actualité
Outils de la discussion



Fuseau horaire GMT +2. Il est actuellement 20h00.


 
 
 
 
Partenaires

Hébergement Web