Discussion :

[ssssa1983]

Bonjour,

Je viens de decouverir doxygen et j'aimerais bien l'utiliser pour faire la documentation de mes programmes.
Est ce qu'il ya quelqu'un pour m'expliquer l'utilisation de doxygen en utilisant un exemple facile?
Je vous remercie en avance.

[gbdivers]

Bonjour

C'est une question très généraliste que tu poses là. La documentation de dixygen ne te semble pas claire et abordable ? http://www.stack.nl/~dimitri/doxygen/manual.html

[mala92]

Bonjour

C'est une question très généraliste que tu poses là. La documentation de dixygen ne te semble pas claire et abordable ? http://www.stack.nl/~dimitri/doxygen/manual.html

Salut,

Si un modérateur passait par là, il te dirait d'utiliser en priorité les liens "locaux". (à prendre au 2nd degré, hein ?)
http://franckh.developpez.com/tutoriels/outils/doxygen/

[gbdivers]

Salut,

Si un modérateur passait par là, il te dirait d'utiliser en priorité les liens "locaux". (à prendre au 2nd degré, hein ?)
http://franckh.developpez.com/tutoriels/outils/doxygen/

Merci, je savais qu'il y avait un tutoriel mais je ne l'ai pas retrouvé
Pour les liens, on n'a jamais interdit tous les liens externe En particulier, les liens vers la doc d'une libs ne posent pas de problème

[ssssa1983]

Oui, je suis d'accord avec vous.
la premiere chose, je suis null en anglais, je ne comprends pas grande chose.....
J'ai déjà essayé de suivre quelques tutoriels, mais j'arrive pas à comprendre.

pour être précise: Est ce que c'est obligé d'utiliser les balises dans notre programme ou le logiciel sait tout faire?

[mala92]

Pour les liens, on n'a jamais interdit tous les liens externe

C'est pour ça que j'ai dit "en priorité" et pas "interdit".

pour être précise: Est ce que c'est obligé d'utiliser les balises dans notre programme ou le logiciel sait tout faire?

Les logiciels ne sont pas devin. Il faut les guider. Dans le cas de doxygen et tous ses "concurrents", il faut mettre des balises, mais pas dans le code, juste dans les commentaires décrivant les fonctions.
Doxygen sait comment est structurée une classe C++, il peut donc générer une doc sans la moindre balise, mais ta doc ne sera pas "propre".

[ssssa1983]

Merci pour vos réponses,

voilà un exemple simple que j'ai fait, mais malheureusement il me donne rien du tout.

Code :

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
 
/**
 * \file Prise_Origine.cpp
 * \brief .
 * \author toto
 * \version 0.1
 * \date 16 juin 2012
 *
 * Programme determine l'orine du repere.
 *
 */
 
 
#include <stdio.h>
#include <unistd.h>
#include <fcntl.h>
#include <string.h>
 
 
#define MAX 4
 
/**
 * \fn int main()
 * \brief Entrée du programme.
 *
 * \return 0 - Arrêt normal du programme.
 */
 
int main()
{
int  fd[MAX], i;
 
fd[0] = open("/dev/ttyS0", O_WRONLY | O_NDELAY);
if (fd[0] == -1)
     printf("Une erreur est survenue lors de la connexion avec le port serie 1.Les informations ne lui seront donc pas transmises fd0.");
 
fd[1] = open("/dev/ttyS1", O_WRONLY | O_NDELAY);
if (fd[1] == -1)
     printf("Une erreur est survenue lors de la connexion avec le port serie 1.Les informations ne lui seront donc pas transmises.fd1");
 
fd[2] = open("/dev/ttyS2", O_WRONLY | O_NDELAY);
if (fd[2] == -1)
     printf("Une erreur est survenue lors de la connexion avec le port serie 1.Les informations ne lui seront donc pas transmises.fd2");
 
fd[3] = open("/dev/ttyS3", O_WRONLY | O_NDELAY);
if (fd[3] == -1)
     printf("Une erreur est survenue lors de la connexion avec le port serie 1.Les informations ne lui seront donc pas transmises.fd3");
 
else
        for (int i = 0; i < MAX; i++)
 
        {
          if (fd[i])
          {
             write(fd[i], "OPMODE 8\r",9);
             write(fd[i], "EN\r",3);
             write(fd[i], "MH\r",3);
             write(fd[i], "PFB\r",4);
             write(fd[i], "DIS\r",4);
 
          }
        }
 
 
return 0;
 
}