Commentaires » Historique » Version 9
Patrice Nadeau, 2025-03-23 10:38
| 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 | 1. C (/*... */) : Commentaires du code |
||
| 9 | 2 | Patrice Nadeau | 1. Javadoc (/** */, @) : Commentaires devant apparaître dans la documentation (Doxygen) |
| 10 | 5 | Patrice Nadeau | 1. Les « décorations » (gras, italique, etc.) sont faites avec la syntaxe Markdown |
| 11 | * Italique : `∗` ou `_` |
||
| 12 | * Gras : `∗∗` ou `__` |
||
| 13 | 7 | Patrice Nadeau | 1. Les commentaires suivants peuvent aussi être utilisés |
| 14 | * `@todo` |
||
| 15 | * `@bug` |
||
| 16 | 1 | Patrice Nadeau | |
| 17 | ## Exemple |
||
| 18 | |||
| 19 | ```c |
||
| 20 | ... |
||
| 21 | /* Il n'est pas nécessaire de documenter chaque ligne */ |
||
| 22 | 8 | Patrice Nadeau | /** @todo Enlever ce commentaire inutile de la documentation Doxygen */ |
| 23 | 1 | Patrice Nadeau | x++; |
| 24 | ... |
||
| 25 | ``` |
||
| 26 | |||
| 27 | ## Justifications |
||
| 28 | * [Loi sur la langue officielle et commune du Québec, le français](https://www.publicationsduquebec.gouv.qc.ca/fileadmin/Fichiers_client/lois_et_reglements/LoisAnnuelles/fr/2022/2022C14F.PDF) |
||
| 29 | 3 | Patrice Nadeau | * La documentation est partie intégrante du code |