Bienvenue, Invité. Merci de vous connecter ou de vous inscrire.
Avez-vous perdu votre e-mail d'activation ?

Auteur Sujet: Laurent comment on fait les doc ;D ?  (Lu 3289 fois)

0 Membres et 1 Invité sur ce sujet

kamui

  • Sr. Member
  • ****
  • Messages: 291
    • Voir le profil
Laurent comment on fait les doc ;D ?
« le: Juillet 06, 2012, 09:01:45 am »
Bonjour à tous !

Bon c'est vrai je m'adresse surtout à Laurent, mais vous pouvez répondre aussi vous vous y connaissez surement.

En fait j'ai généré une doc pour une librairie que je suis en train de faire, et ça s'organise pas vraiment comme je voudrais. Donc j'aimerais avoir le maximum d'infos sur comment tu as généré la doc de sfml : doxygen ou autre ? Par exemple, comment as-tu fait pour avoir une section modules plutôt qu'un section namespaces ? Inclure du code dans la main page ? Quel degré de transparence as-tu choisi pour la documentation vis-à vis de ton code ? etc..

Merci d'avance si tu as l'amabilité de me parler de ta recette, sinon, bah merci quand même en fait ^^

++

Laurent

  • Administrator
  • Hero Member
  • *****
  • Messages: 32498
    • Voir le profil
    • SFML's website
    • E-mail
Re : Laurent comment on fait les doc ;D ?
« Réponse #1 le: Juillet 06, 2012, 09:25:53 am »
Salut

J'utilise en effet doxygen (c'est comme le Port Salut, c'est marqué dessus :P).

Citer
comment as-tu fait pour avoir une section modules plutôt qu'un section namespaces ?
Tout d'abord il faut définir les "groupes" :
\defgroup audio Audio module
puis dire à quel groupe chaque classe appartient
\class sf::Sound
\ingroup audio

Citer
Inclure du code dans la main page ?
J'ajoute un fichier pipeau (mainpage.hpp) dans les sources que doxygen traite, et ce fichier démarre avec une directive spéciale :
\mainpage
Pour le contenu, c'est du doxygen classique (\section, \code, ...).

Citer
Quel degré de transparence as-tu choisi pour la documentation vis-à vis de ton code ?
J'ai pas compris la question là ;D

Mais n'hésite pas à regarder directement dans les en-têtes, et à fouiller mon fichier doxyfile, ça ira probablement plus vite que de me demander :)
Laurent Gomila - SFML developer

kamui

  • Sr. Member
  • ****
  • Messages: 291
    • Voir le profil
Re : Laurent comment on fait les doc ;D ?
« Réponse #2 le: Juillet 06, 2012, 09:34:31 am »
ah je savais pas que tu partageais le doxyfile.

Pour l'histoire de la transparence, c'est au niveau du code (on peut faire apparaitre ou pas les données privées, les trucs non documentés etc, mais bon t'as raison je vais fouiller directement les fichiers source)

Merci @+
« Modifié: Juillet 06, 2012, 09:42:47 am par kamui »

Laurent

  • Administrator
  • Hero Member
  • *****
  • Messages: 32498
    • Voir le profil
    • SFML's website
    • E-mail
Re : Laurent comment on fait les doc ;D ?
« Réponse #3 le: Juillet 06, 2012, 09:36:42 am »
Je ne fais apparaître ni les sources, ni les membres privés. Uniquement ce qui sert aux utilisateurs.
Laurent Gomila - SFML developer

kamui

  • Sr. Member
  • ****
  • Messages: 291
    • Voir le profil
Re : Laurent comment on fait les doc ;D ?
« Réponse #4 le: Juillet 06, 2012, 09:43:29 am »
Ok merci^^

Bonne journée (à tous aussi)