Page de garde Doc++ Maîtrise dinformatique Février 2002
Doc++ Un extracteur de documentation pour programmes et bibliothèques en C, C++, IDL et Java, générant de lHTML ou du TeX, assez similaire à JavaDoc. Pour consommer : Pour produire :
Format des commentaires Doc++ utilise les commentaires précédant les déclarations de classes, de méthodes, de fonctions, de typedef s, de macro, … de la forme : /** * Description de ce qui suit. */ ou (sur une seule ligne) : /// Description de ce qui suit. Par défaut, la première phrase est utilisée pour la documentation courte et la totalité du commentaire pour la version longue, mais il est possible de préciser : /** * Description courte de ce qui suit. * * Description longue de ce qui suit. */
Les tags Doc++ Doc++ utilise des tags pour typer les informations contenues dans les : pour indiquer le ou les : pour les déclarations : documentation : documentation des exceptions : spécification dinvariant de : documentation : documentation des : spécification de postcondition de : spécification de précondition de : documentation du résultat renvoyé (ou des différentes valeurs : références : version du programme à laquelle est apparue la : version courante du programme Les principaux tags sont :
Groupement des déclarations Les déclarations peuvent être groupées en les précédant de : /** Nom du groupe * Description du groupe */ et en les faisant suivre de : Les groupes de mêmes noms répartis sur plusieurs fichiers sont automatiquement assemblés. Les groupes peuvent à leur tour contenir dautres groupe.
Utilisation de tags HTML ou de commandes LaTeX Doc++ permet lutilisation de tags HTML ou de commandes/environnements LaTeX courants :,,,,,,,,,,,,, … $…$, \[…\], \#, \-, \, \em, \emph, \bf, \textbf, \it, \textit, \tt, \texttt, verbatim, tabular, array, itemize, enumerate, description, item, …
Le fichier de configuration Les options de Doc++ peuvent être spécifiées sur la ligne de commande, mais il est plus lisible de faire cela via un fichier de configuration. Doc++ se lance alors par : doc++ --config projet.conf fichiers Le format du fichier de configuration est très simple. Par exemple : documentAll false documentPrivateMembers false HTMLSyntax true internalDoc false upwardsArrows true useTables false outputDir M:\Esterel\Docs\libv7 showMembersInTOC true