Commentaires » Historique » Version 11
Patrice Nadeau, 2025-08-09 21:07
| 1 | 1 | Patrice Nadeau | # Commentaires |
|---|---|---|---|
| 2 | |||
| 3 | 1. Précède l’élément à documenté, avec la même indentation |
||
| 4 | 1. En minuscules et commence par une majuscule |
||
| 5 | 1. Phrase complète en français |
||
| 6 | 1. Sur une ou plusieurs lignes |
||
| 7 | 1. De style |
||
| 8 | 11 | Patrice Nadeau | * C (/*... */) : Commentaires du code |
| 9 | * Javadoc (/** */, @) : Commentaires devant apparaître dans la documentation (Doxygen) |
||
| 10 | 10 | Patrice Nadeau | > La documentation est partie intégrante du code |
| 11 | 5 | Patrice Nadeau | 1. Les « décorations » (gras, italique, etc.) sont faites avec la syntaxe Markdown |
| 12 | * Italique : `∗` ou `_` |
||
| 13 | * Gras : `∗∗` ou `__` |
||
| 14 | 7 | Patrice Nadeau | 1. Les commentaires suivants peuvent aussi être utilisés |
| 15 | * `@todo` |
||
| 16 | * `@bug` |
||
| 17 | 1 | Patrice Nadeau | |
| 18 | ## Exemple |
||
| 19 | |||
| 20 | ```c |
||
| 21 | ... |
||
| 22 | /* Il n'est pas nécessaire de documenter chaque ligne */ |
||
| 23 | 8 | Patrice Nadeau | /** @todo Enlever ce commentaire inutile de la documentation Doxygen */ |
| 24 | 1 | Patrice Nadeau | x++; |
| 25 | ... |
||
| 26 | 3 | Patrice Nadeau | ``` |