star-style

Writing conventions for co-authors
Log | Files | Refs | README | LICENSE

commit dc006978cd07c7d107cb72d4c4706822fcec4ada
parent 8db64be3270e96124c728519309986adddaec756
Author: Vincent Forest <vincent.forest@meso-star.com>
Date:   Thu, 16 Jul 2026 18:12:46 +0200

Relecture

Diffstat:
Mdoc/fr/star-c.7 | 20++++++++++----------
1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/doc/fr/star-c.7 b/doc/fr/star-c.7 @@ -1327,13 +1327,20 @@ static const struct qux QUX_DEFAULT = QUX_DEFAULT__; .Pp Éviter d'utiliser une déclaration typedef des structures afin d'autoriser leur déclaration anticipée. -Et l'utilisation de pointeur vers une donnée structurée sans avoir en à -connaitre la représentation mémoire. +Et l'utilisation de pointeur vers une donnée structurée sans avoir sa +définition. Si un déclaration typedef est néanmoins souhaitée, nommer le type structuré en suivant la convention de nommage des déclarations typedef .Pq section Sx Les déclarations de types . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .Sh LES MACROS +Pour définir une séquence d'instructions, +préférer l'utilisation de fonctions aux macros. +Déclarer la fonction avec la directive +.Sy INLINE +si son coût d'appel est un enjeu +.Pq section Sx Les symboles internes à une unité de compilation . +.Pp Regrouper la séquence d'instructions d'une macro dans un bloc terminé par l'instruction .Ql (void)0 . @@ -1368,7 +1375,7 @@ d'instructions développée par la macro : sont alignés en suivant des contraintes d'édition propres à ce manuel. Dans un fichier source, positioner l'anti-slash en tant que dernier caractère de lignes qui occupent la longueur maximale autorisée -.Pq section Sx LA LONGUER DES LIGNES . +.Pq section Sx LA LONGUEUR DES LIGNES . .Pp Pour une macro dont la portée est l'unité de compilation, ne pas changer le déroulé des instructions de son contexte d'appel, par exemple en @@ -1428,13 +1435,6 @@ error: goto exit; } .Ed -.Pp -Pour définir une séquence d'instructions, -préférer l'utilisation de fonctions aux macros. -Déclarer la fonction avec la directive -.Sy INLINE -si son coût d'appel est un enjeu -.Pq section Sx Les symboles internes à une unité de compilation . .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .Sh LES ALLOCATIONS DYNAMIQUES .Sh LA GESTION DES ERREURS