commit c1757aa49d1e6269451a717787aafec8a11a76df
parent c6d0cbdb52580af8f44f2e6a02e1aafc4cf0235b
Auteur: Loïc Daignault-Pichette <loic@asteride.xyz>
Date: Sat, 8 Jun 2024 14:46:53 -0400
mise à jour des pages du manuel
Diffstat:
3 files changed, 39 insertions(+), 24 deletions(-)
diff --git a/man/fr/aplat.1 b/man/fr/aplat.1
@@ -1,9 +1,9 @@
-.Dd 7 juin 2024
+.Dd 8 juin 2024
.Dt APLAT 1
.Os
.Sh NOM
.Nm aplat
-.Nd Convertir le format aplat au format plat
+.Nd Convertir le format aplat(5) au format plat(5)
.Sh SYNOPSIS
.Nm aplat
<\c
diff --git a/man/fr/aplat.5 b/man/fr/aplat.5
@@ -1,4 +1,4 @@
-.Dd 7 juin 2024
+.Dd 8 juin 2024
.Dt APLAT 5
.Os
.Sh NOM
@@ -6,8 +6,13 @@
.Nd Format de document structuré hiérarchiquement
.Sh DESCRIPTION
.Nm aplat
-est un format de document structuré hiérarchiquement conçu pour être facile à
-écrire et manipuler, aussi bien par un humain que par une machine.
+est un format de document structuré hiérarchiquement
+conçu pour être facile à
+écrire et manipuler
+par un humain.
+Et est équivalent
+au format
+.Xr plat 5 .
.Pp
C’est le format qu’\c
.Xr aplat 1
@@ -48,13 +53,13 @@ nomme un domaine.
Ce nom correspond au premier
.Em atome
du domaine.
-La longueur d'une étiquette ne peut excéder les 128 octets.
+La longueur d’une étiquette ne peut excéder les 128 octets.
.Pp
Le
.Em contenu
d’un domaine correspond la concaténation de tous les atomes qu’il contient,
excepté le premier, qui contient l’\c
-.Em étiquettes .
+.Em étiquette .
.Pp
Finalement, un
.Em atome
@@ -79,17 +84,17 @@ Le caractère d’échappement
.Pq Sq \e
change l’interprétation des caractères spéciaux.
Son effet varie selon le caractère échappé.
-Les parenthèses,
-les espaces normaux,
+Un nouvelle ligne échappée
+est ignorée.
+Les autres caractères échappés,
+dont
+les parenthèses,
+les espaces normales,
les caractères de tabulation,
les guillemets
-et le caractère d’échappement lui-même
-sont interprétés dans leur sens littéral lorsque ce
-caractère les précède.
-Cependant,
-une nouvelle ligne échappée est ignorée,
-et l’échappement de tout autre caractère est équivalent
-à ce même caractère sans échappement.
+et les caractères d’échappement eux-mêmes,
+sont interprétés
+dans leur sens littéral.
.Pp
Lorsqu’une chaîne de caractères est placée entre guillemets droits doubles
.Pq Sq \(dq ,
@@ -117,14 +122,19 @@ d’éventuels préprocesseurs.
Le texte qui se trouve à l’intérieur d’un bloc est interprété
.Em verbatim .
Les séparateurs de blocs sont interprétés comme tels
-en tout temps.
+en tout temps
+et les mécanismes d'échappement normaux
+n'ont aucun effet sur lui.
Une construction spéciale
-permet d'échapper
+permet d’échapper
les singes d’égalité
en début de ligne.
Il suffit de les faire suivre
d’un point d’exclamation
-.Pq Sq !\&
+.Pq Sq !\& .
+Un bloc
+peut être enchâssé
+entre une paire de guillemets.
.Pp
Les deux constructions suivantes sont équivalentes\~:
.Bd -literal -offset indent
diff --git a/man/fr/plat.5 b/man/fr/plat.5
@@ -1,4 +1,4 @@
-.Dd 7 juin 2024
+.Dd 8 juin 2024
.Dt PLAT 5
.Os
.Sh NOM
@@ -81,12 +81,17 @@ ces caractères sont échappés par
et
.Sq \et ,
respectivement.
-Le caractère d’échappement lui-même peut être échappé par
-.Sq \ee .
+Le deux-points
+et le caractère d’échappement lui-même
+doivent être échappés par
+.Sq \ed
+et
+.Sq \ee ,
+respectivement.
Il est interdit d’échapper tout autre caractère.
.Sh EXEMPLES
L’exemple suivant
-(où un signe de dollar a été ajouté
+(où des signes de dollar a été ajouté
pour marquer la fin de la ligne)\~:
.Bd -literal -offset indent
( doc $
@@ -118,4 +123,4 @@ le champ des drapeaux suivait celui de l’étiquette,
et ce dernier contenait toute la hiérarchie des étiquettes,
du domaine racine au domaine cadet.
.Sh AUTEURS
-.An Selve <selve@asteride.xyz>
+.An Loïc Daignalut-Pichette <loic@asteride.xyz>
