Objets¶

Règles¶

1. Écris en anglais avec au maximum 31 caractères :
   1. Lettres minuscules
   2. Nombres
   3. Trait de soulignement
2. Commence par une lettre
3. Si plusieurs mots sont utilisés, ils sont séparées par des traits de soulignement
4. Les commentaires Doxygen suivants sont ajoutés
   1. @brief : Description obligatoire
   2. @sa : Lien vers une autre item (see also), facultatif
   3. @todo : Notes sur les tachés à faire, facultatif
   4. @bug : Notes sur les bogues présents, facultatif
   5. La gradations des notes et remarques se fait selon :
      • @remark : Non importante
      • @note : Général
      • @attention : Important
      • @warning : Conséquence négative
5. Le modificateur static pour les objets ayant une visibilité locale
6. Les objets ne devant plus être utilisés, DOIVENT générer un message lors de la compilation (-Wall) si un appel est effectué.
   1. Les attributsdeprecated ou unavailable DOIVENT être ajoutés à la déclaration.
   2. Les commentaires Doxygen suivants doivent être ajoutés :
      1. @deprecated : Indications sur le remplacement à utiliser
      2. @since : Depuis quel version le changement est apparue

Exemple¶

/**
 * @brief old_function
 * @deprecated Cette fonction seras retirée dans une prochaine version, utiliser new_function à la place
 * @since Version x.x.xx
 */
int old_function(void) __attribute__((deprecated));

/**
 * @brief old_function
 * @deprecated Cette fonction est retirée, utiliser new_function à la place
 * @since Version x.x.xx
 */
int old_function(void) __attribute__((unavailable));

Justification¶

• Linux kernel coding style : https://www.kernel.org/doc/html/v4.10/process/coding-style.html#naming
• GNU Coding Standards https://www.gnu.org/prep/standards/html_node/Writing-C.html#Writing-C
• Embedded C Coding Standard : https://barrgroup.com/embedded-systems/books/embedded-c-coding-standard