commit 45f27a52489dc99b30274d105458fd0a5ff92760
parent 01eb104228e89e63e769b5287fe5d0831b09e576
Auteur: Loïc Daignault-Pichette <loic@asteride.xyz>
Date: Fri, 7 Jun 2024 20:39:57 -0400
mise à jour des pages aplat(1) et aplat(5)
Diffstat:
3 files changed, 39 insertions(+), 70 deletions(-)
diff --git a/aplat.c b/aplat.c
@@ -13,7 +13,7 @@
#define _(c) gettext(c)
#define TP_ETQ_TLL 128
-#define TP_CTN_TLL 1
+#define TP_CTN_TLL 256
#define JT_RIEN (-1)
#define JT_OUV 0
diff --git a/man/fr/aplat.1 b/man/fr/aplat.1
@@ -1,4 +1,4 @@
-.Dd 4 avril 2024
+.Dd 7 juin 2024
.Dt APLAT 1
.Os
.Sh NOM
@@ -9,7 +9,7 @@
<\c
.Ar fichier
.Nm aplat
-.Fl V
+.Fl V | h
.Sh DESCRIPTION
L’utilitaire
.Nm aplat
@@ -24,6 +24,9 @@ Lorsque
est exécuté avec l’option
.Fl V ,
la version du programme est affichée en sortie standard.
+Avec l'option
+.Fl h ,
+son synopsis est affiché.
.Sh EXEMPLES
En supposant que le fichier
.Pa exemple.aplat
@@ -55,4 +58,4 @@ quitte avec 0 si tout s’est bien passé et avec >0 si une erreur est survenue.
.Xr aplat 5 ,
.Xr plat 5
.Sh AUTEURS
-.An Selve <selve@asteride.xyz>
+.An Loïc Daignault-Pichette <loic@asteride.xyz>
diff --git a/man/fr/aplat.5 b/man/fr/aplat.5
@@ -1,4 +1,4 @@
-.Dd 4 avril 2024
+.Dd 7 juin 2024
.Dt APLAT 5
.Os
.Sh NOM
@@ -40,60 +40,25 @@ Le
.Em "domaine racine" ,
domaine absolument supérieur en ce qu’il n’a pas de parent
et qu’il contient tous les autres domaines, fait exception à la règle.
-Il va de soi que les parenthèses de tout domaine doivent être équilibrées.
-.Pp
-Lorsque l’étendue d’un domaine est la même que celle de son parent immédiat,
-il est possible d’utiliser le raccourci syntaxique noté par un deux-points
-.Pq Sq :\& .
-Dans cette notation,
-à gauche du deux-points se trouve le
-.Em "domaine parent"
-et à droite,
-le
-.Em "domaine enfant" .
-Il est possible d’ajouter de la sorte autant de domaines qu’on le souhaite,
-et que le permet la quantité mémoire disponible sur le système.
-.Pp
-Ces deux constructions sont donc équivalentes\~:
-.Bd -literal -offset indent
-(parent
- (intermédiaire
- (enfant "Contenu du domaine")))
-.Ed
-.Bd -literal -offset indent
-(parent:intermédiaire:enfant "Contenu du domaine")
-.Ed
+Les parenthèses de tout domaine doivent être équilibrées.
.Pp
Une
.Em étiquette
nomme un domaine.
Ce nom correspond au premier
.Em atome
-du domaine,
-à moins que le raccourcit syntaxique des deux-points ne soit utilisé.
-En fait,
-on peut dire que le premier
-.Em atome
-contient une
-.Em étiquette
-de plus
-que de deux-points.
-Ainsi, dans les deux exemple ci-dessus,
-.Em parent ,
-.Em intermédiaire
-et
-.Em enfant
-sont des étiquettes.
+du domaine.
+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 la ou les
+excepté le premier, qui contient l’\c
.Em étiquettes .
.Pp
Finalement, un
.Em atome
-est une suite de caractères séparées par des parenthèses ou par des blancs.
+est une suite de caractères limitée par des parenthèses ou par des blancs.
Sont traités comme des blancs les caractères suivants\~:
l’espace normale
.Pq Sq \ ,
@@ -104,11 +69,11 @@ et le caractère de tabulation
.Pp
Il existe trois moyens d’échapper des caractères\~: l’utilisation de la barre
oblique inversée
-.Pq Sq \e\e ,
+.Pq Sq \e ,
l’encadrement avec des guillemets droits doubles
.Pq Sq \(dq
-et l’encadrement avec une suite de trois de ces guillemets
-.Pq Sq \(dq\(dq\(dq .
+et l’encadrement avec des signes d’égalité en début de ligne.
+.Pq Sq \en= .
.Pp
Le caractère d’échappement
.Pq Sq \e
@@ -141,42 +106,43 @@ aux guillemets des interpréteurs de commandes Unix.
.Pp
La dernière stratégie d’échappement a recours à un
.Em bloc .
-Un bloc est délimité par une paire de triples guillemets droits doubles
-.Pq Sq \(dq\(dq\(dq .
-Les caractères qui se trouvent entre le triplet ouvrant
-et la première nouvelle ligne
-.Pq Sq \en ,
-inclusivement,
-et ceux qui se trouvent entre la dernière nouvelle ligne
-et le triplet fermant,
-inclusivement,
+Un bloc est délimité par une paire de signes d’égalité
+placés en début de ligne
+.Pq Sq \en= .
+Les caractères qui se trouvent
+sur la même ligne que ces signes d’égalité
sont ignorés.
-Ces caractères ignorés peuvent servir à donner certaines informations à
+Ils peuvent ainsi servir à donner certaines informations à
d’éventuels préprocesseurs.
Le texte qui se trouve à l’intérieur d’un bloc est interprété
.Em verbatim .
-Une construction spéciale permet d’y inclure une suite de trois guillemets.
-Il suffit de les faire suivre d’un point d’exclamation
+Les séparateurs de blocs sont interprétés comme tels
+en tout temps.
+Une construction spéciale
+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 !\&
.Pp
-Ainsi, les trois constructions suivantes sont équivalentes\~:
-.Bd -literal -offset indent
-(doc
- (par Un\e bloc\e est\e limité\e par\e la\e suite\e \e"\e"\e"\e.))
-.Ed
+Les deux constructions suivantes sont équivalentes\~:
.Bd -literal -offset indent
(doc
- (par "Un bloc est limité par la suite \e"\e"\e"."))
+ (par "La ligne qui suit commence par un signe d’égalité\~:
+=!"))
.Ed
.Bd -literal -offset indent
(doc
(par
-""" type=texte
-Un bloc est limité par la suite """!.
-"""))
+= type:texte
+La ligne qui suit commence par un signe d’égalité\~:
+=!
+=
+))
.Ed
.Sh VOIR AUSSI
.Xr aplat 1 ,
.Xr plat 5
.Sh AUTEURS
-.An Selve <selve@asteride.xyz>
+.An Loïc Daignault-Pichette <loic@asteride.xyz>
