commit 0e461a59cc517c515cd7e0c7ab24f5caac566445
parent 90bb7504bc733d89a889faf49913045436f47b9c
Author: Vincent Forest <vincent.forest@meso-star.com>
Date: Tue, 23 Jun 2026 10:37:43 +0200
Relecture et termine la section sur le langage C
Diffstat:
1 file changed, 25 insertions(+), 22 deletions(-)
diff --git a/doc/fr/star-c.7 b/doc/fr/star-c.7
@@ -15,7 +15,7 @@
.\" Vous devez avoir reçu une copie de la GNU General Public License en
.\" même temps que Star-Style ; si ce n'est pas le cas, consultez
.\" <http://www.gnu.org/licenses>.
-.Dd June 16, 2026
+.Dd June 23, 2026
.Dt STAR-C 7
.Os
.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
@@ -33,20 +33,21 @@ Si bien que s'il appartient aux co-auteurs d'un projet de prendre
certaines libertés quant à ce guide de style, toute participation à son
développement devra alors s'efforcer de respecter le style d'écriture du
projet, avant les préférences listées ici.
-.\""""""""""""""""""""""""""""""""""
-.Ss Le contenu d'un projet
-En suivant le philosophie UNIX, les fonctionnalités d'un programme se
-doivent d'être aussi rammassées que possible de sorte à ce que sa mise en
-oeuvre reste simple et son interface ciselée.
-L'objet étant d'en assurer la robustesse, l'efficacité et la modularité
-qui dépendent d'abord de sa
+.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.Sh LE CONTENU D'UN PROJET
+En suivant le philosophie UNIX, assurer un jeu de
+fonctionnalités par programme aussi rammassé que possible de
+sorte à ce que sa mise en oeuvre et son interface restent
+simples et ciselées.
+L'objet étant d'assurer sa robustesse, son efficacité et sa
+modularité qui dépendent d'abord de sa
.Em relation
à un écosystème logiciel qui le dépasse, bien avant son catalogue de
fonctionnalités ou ses prouesses de mise en oeuvre.
.Pp
Le périmètre étroit de chaque programme se retrouve dès lors dans la
-structure du projet auquel il appartient, dont le contenu est simple et
-peu hiérarchisé car comptant en définitive peu de fichiers.
+structure du projet auquel il appartient, dont le contenu est alors
+simple et peu hiérarchisé car comptant en définitive peu de fichiers.
.Pp
La structure type du répertoire d'un projet est :
.Bd -literal -offset Ds
@@ -65,7 +66,7 @@ Avec :
.Bl -dash -compact
.It
.Pa README.md
-le fichier qui donne le premier niveau d'information sur le projet ;
+le fichier qui donne le premier niveau d'informations sur le projet ;
.It
.Pa COPYING
la license du projet qui liste ses conditions légales d'utilisation ;
@@ -76,13 +77,13 @@ et
les fichiers du système de génération automatique ;
.It
.Pa src/
-le répertoire qui contient les codes source du projet ;
+le répertoire qui contient les codes source du projet ;
.It
.Pa doc/
le répertoire qui stocke sa documentation.
.El
-.\""""""""""""""""""""""""""""""""""
-.Ss Le langage C
+.\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""
+.Sh LE LANGAGE C
Utiliser le langage
.Em C89
.Pq ANSI X3.159-1989
@@ -99,8 +100,8 @@ et en interdisant de mélanger du code avec la définition de variables.
.\""""""""""""""""""""""""""""""""""
.Ss Le standard POSIX
Ajouter le support du standard POSIX pour les seuls fichiers qui en ont
-besoin pour, par exemple, pouvoir utiliser des fonctions de la bibliothèque
-C standard sinon indisponibles via la seule norme du langage.
+besoin, pour notamment pouvoir utiliser des fonctions de la bibliothèque
+C standard sinon indisponibles via la seule norme du langage retenue.
.Pp
Pour ce faire, définir la macro
.Ql _POSIX_C_SOURCE
@@ -113,13 +114,15 @@ Par exemple, pour utiliser le standard POSIX.1-2001 :
.Pp
Sous GNU/Linux, se référer à
.Xr feature_test_macros 7
-pour une description exhaustive des macros utilisées
-pour activer le jeu de fonctionnalités d'un standard donné.
+pour une description exhaustive des macros utilisées pour activer le jeu
+de fonctionnalités d'un standard donné.
.Pp
-Chaque fichier peut donc utiliser un standard POSIX différent.
-Mais pour oeuvrer à ce que le code soit le plus portable possible,
-retenir la première version du standard a partir de laquelle la
-fonctionnalité recherchée est apparue.
+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
+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.
.\""""""""""""""""""""""""""""""""""
.Ss La structure des fichiers
.Ss La longueur des lignes
