Discussion :

[Yoshio]

Bonjour,

J'aimerais savoir s'il existe le même style de "programme" qu'en PHP qui permet de commenter son code assez proprement.
ex en php => http://www.phpdoc.org/

[Franck.H]

Doxygen, c'est dans le même style que Javadoc, ca fonctionne super !

[Yoshio]

Yep merci bien c'est ce que je cherchais.

Mais il n'y a pas moyen d'avoir un du style PHP genre :

Code :

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

1
2
3
4
5
6
7
 
/**
 * Add x to y
 * @param int x
 * @param int y
 * @return int x + y
 */

J'ai vaguement regardé mais je ne pense pas que ca soit pareille (previent moi si ce n'est pas le cas).

Existe t-il un comparateur de ce genre d'outil sur developpez.com ? (je pense pas pour le C en tout cas).

[Franck.H]

Version Doxygen:

Code :

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

1
2
3
4
5
6
7
/**
 * /param int x
 * /param int y
 * /return int x + y
 *
 * /brief Add x to y
 */

/brief c'est pour une courte description, regarde dans la doc du programme sur le site officiel, y'a tout !

[Yoshio]

c'est pas beau !!!

[Gruik]

Si, Doxygen est pareil. Pour les commandes speciales, on a le choix entre l'ecriture Doxygen et l'ecriture Javadoc (\command ou @command)

Donc oui, on peut commenter comme ceci

Code :

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

1
2
3
4
5
6
7
8
/**
 * Blabla lbalblalbl blabla.
 * Blabl albalb la lbl lalblalblalblablalbla
 *
 * @param abc  Blablablablabl
 * @param def   Blab aueb yiuy. baiyiubya ibeubeaebhkjh 
 * @return        Blabab lablalblalbalblalbalb
 */

Il ya tout plein de trucs pour "compatibilité avec javadoc", donc si tu connais javadoc, tu connais Doxygen

[Yoshio]

ah oki merci! Ca me va alors