star-style

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

commit 0f3e050a4b1a5766f39b8ae01bf3a0b4ab786ac4
parent 53caee6296c5e42368403dba57ce7a3a4c07dd8f
Author: Vincent Forest <vincent.forest@meso-star.com>
Date:   Thu, 15 Oct 2026 15:01:11 +0200

Relecture

Diffstat:
Mdoc/fr/star-c.7.in | 27+++++++++++++--------------
1 file changed, 13 insertions(+), 14 deletions(-)

diff --git a/doc/fr/star-c.7.in b/doc/fr/star-c.7.in @@ -118,11 +118,10 @@ pour une description exhaustive des macros utilisées pour activer le jeu de fonctionnalités d'un standard donné. .Pp L'utilisation d'un C enrichi du standard POSIX n'est ainsi utilisé que -sur les seuls fichiers qui en explicite le besoin ; le C89 restant le +sur les seuls fichiers qui en explicitent le besoin ; le C89 restant le langage utilisé partout ailleurs. Dans un même souci de portabilité, retenir la première version du -standard POSIX à partir de laquelle la fonctionnalité recherchée est -apparue. +standard POSIX qui propose la fonctionnalité recherchée. .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .Sh LA STRUCTURE D'UN FICHIER SOURCE Suivre une seule et même structure pour tous les fichiers @@ -171,7 +170,7 @@ macro .Pq section Sx LE NOMMAGE . .\"""""""""""""""""""""""""""""""""" .It -L'inclusion des fichiers d'en-tête requis par le fichier source ; +L'inclusion des fichiers d'en-tête requis par le fichier source .Pq section Sx LES FICHIERS D'EN-TÊTE Ns  ; .\"""""""""""""""""""""""""""""""""" @@ -806,7 +805,7 @@ switch (i) { case FOO: foo(); break; case BAR: bar(); break; case QUX: qux = 1; break; - default: FATAL("Unreachable code\en"); break; + default: FATAL("Code inaténiable\en"); break; } .Ed .Pp @@ -905,7 +904,7 @@ pour notamment expliciter le type .Vt struct bar des variables comparées. Jusqu'à préfixer le nom de la fonction par l'acronyme de la bibliothèque -quand elle est une fonction d'interface de ladite bibliothèque. +quand elle en est une fonction d'interface. Pour la bibliothèque .Ql Foo , une fonction d'interface sera alors nommée @@ -941,7 +940,7 @@ typedef int foo_T; typedef char foo_bar_T[256]; .Ed .Pp -Ne pas utiliser de déclaration typedef sur les structures, unions et +Ne pas utiliser de déclarations typedef sur les structures, unions et énumérations de sorte à permettre leur déclaration anticipée. .Pp Préfixer le nom d'un type par l'acronyme de la bibliothèque dès lors @@ -1220,7 +1219,7 @@ if(foo) { if (i < min_i) min_val = i; } else { int i = 0; - for(i = 0; i < N; ++i) qux(i); + for (i = 0; i < N; ++i) qux(i); } .Ed .Pp @@ -1585,7 +1584,7 @@ la bibliothèque .Ql RSys définit en plus une interface d'allocateur mémoire. Au contraire de son interface d'allocation qui enregistre la mémoire -alloué globalement par la bibliothèque, +allouée globalement par la bibliothèque, chaque allocateur enregistre ses seules allocations. .Pp Plusieurs types d'allocateurs sont proposés par la bibliothèque @@ -1601,7 +1600,7 @@ Le lecteur est invité à se référer à son fichier d'en-tête .In rsys/mem_allocator.h pour plus d'informations. .Pp -Les convention listées précédemment quant aux allocation dynamiques +Les conventions listées précédemment quant aux allocations dynamiques s'appliquent à l'identique à l'utilisation des allocateurs. .Pp Utiliser un allocateur consiste à appeler des macros, dont le nom est @@ -1663,8 +1662,8 @@ Soit après la détection d'une erreur dont la gestion explicite via la directive .Ql goto error précède la sortie de la fonction et ses traitements associés ; auxquels -renvoit finalement la gestion des erreurs centralisée sous le label -.Ql error . +renvoit finalement la gestion des erreurs via la directive +.Ql goto exit . .Bd -literal -offset Ds static res_T foo(const int bar, int** out_list) @@ -1708,7 +1707,7 @@ Analyser les arguments du programme en utilisant la fonction définie par le standard POSIX.1-2001 dans l'en-tête .In unistd.h de la bibliohtèque C. -Cette fonction assure la consistante de l'analyse des arguments et +Cette fonction assure la consistance de l'analyse des arguments et participe au respect des conventions énoncées par le standard POSIX pour les utilitaires en ligne de commandes. .Pp @@ -1768,7 +1767,7 @@ standard pour qu'un autre utilitaire puisse en post-traiter le résultat. Si plusieurs fichiers d'entrée/de sortie sont lus/écrits par le programme, définir les données les plus à même d'être pré/post-traitées -pour choisir lesquelles seront lues/écriture sur l'entrée/la sortie +pour choisir lesquelles seront lues/écrites sur l'entrée/la sortie standard. .\"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .Sh FICHIERS