aplat

Documents structurés pour Unix
git clone git://git.asteride.xyz/~ldp/aplat.git
Journaux | Fichiers | Références | LISEZ-MOI | LICENCE

commit 118b421c1fb40d7a79bd397dec972c63324e76b9
parent a28ab003978515843623aada7996f4e198ce7b5c
Auteur: Selve <selve@asteride.xyz>
Date:   Thu, 25 Jan 2024 15:41:37 -0500

modification des pages du manuel

Diffstat:
Mman/fr/aplat.1 | 10+++++-----
Mman/fr/aplat.5 | 62+++++++++++++++++++++++++++++++-------------------------------
Mman/fr/plat.5 | 28++++++++++++++--------------
3 files changed, 50 insertions(+), 50 deletions(-)

diff --git a/man/fr/aplat.1 b/man/fr/aplat.1 @@ -1,4 +1,4 @@ -.Dd 23 janvier 2024 +.Dd 25 janvier 2024 .Dt APLAT 1 .Os .Sh NOM @@ -9,9 +9,9 @@ <\c .Ar fichier .Sh DESCRIPTION -L'utilitaire +L’utilitaire .Nm aplat -lit en entrée standard et écrit en sortie standard\|; il n'accepte ni option ni +lit en entrée standard et écrit en sortie standard\|; il n’accepte ni option ni argument. Il convertit le format .Xr aplat 5 @@ -41,9 +41,9 @@ $ aplat <exemple.aplat :doc: ) .Ed .Sh ÉTATS DE SORTIE -L'utilitaire +L’utilitaire .Nm aplat -quitte avec 0 si tout s'est bien passé et avec >0 si une erreur est survenue. +quitte avec 0 si tout s’est bien passé et avec >0 si une erreur est survenue. .Sh VOIR AUSSI .Xr aplat 5 , .Xr plat 5 diff --git a/man/fr/aplat.5 b/man/fr/aplat.5 @@ -1,4 +1,4 @@ -.Dd 23 janvier 2024 +.Dd 25 janvier 2024 .Dt APLAT 5 .Os .Sh NOM @@ -9,13 +9,13 @@ est un format de document structuré hiérarchiquement conçu pour être facile à manipuler, aussi bien par un humain que par une machine. .Pp -C'est le format qu'\c +C’est le format qu’\c .Xr aplat 1 prend en entrée. .Pp Le format .Nm aplat -est constitué de quatre types d'objet\~: +est constitué de quatre types d’objet\~: .Em domaine , .Em atome , .Em étiquette @@ -33,17 +33,17 @@ et fermante en marquent le début et la fin, respectivement. Les limites de tout domaine (et plus généralement, de tout object) -doivent être contenues à l'intérieur du +doivent être contenues à l’intérieur du .Em "domaine parent" immédiat. 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. +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 raccourcis syntaxique noté par un deux-points +Lorsque l’étendue d’un domaine est la même que celle de son parent immédiat, +il est possible d’utiliser le raccourcis syntaxique noté par un deux-points .Pq Sq :\& . Dans cette notation, à gauche du deux-points se trouve le @@ -51,7 +51,7 @@ Dans cette notation, et à droite, le .Em "domaine enfant" . -Il est possible d'ajouter de la sorte autant de domaines qu'on le souhaite, +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\~: @@ -78,7 +78,7 @@ contient une .Em étiquette de plus que de deux-points. -Ainsi, dans l'exemple ci-dessus, +Ainsi, dans l’exemple ci-dessus, .Em parent , .Em intermédiaire et @@ -87,59 +87,59 @@ sont des étiquettes. .Pp Le .Em contenu -d'un domaine correspond la concaténation de tous les atomes qu'il contient, -excepté le premier, qui est l'\c +d’un domaine correspond la concaténation de tous les atomes qu’il contient, +excepté le premier, qui est l’\c .Em étiquette . .Pp Finalement, un .Em atome est une suite de caractères séparées par des parenthèses ou par des blancs. Sont traités comme des blancs les caractères suivants\~: -l'espace normale +l’espace normale .Pq Sq \ , le saut de ligne .Pq Sq \en et le caractère de tabulation .Pq Sq \et . .Pp -Il existe trois moyens d'échapper des caractères\~: l'utilisation de la barre +Il existe trois moyens d’échapper des caractères\~: l’utilisation de la barre oblique inversée .Pq Sq \e\e , -l'encadrement avec des guillemets droits doubles +l’encadrement avec des guillemets droits doubles .Pq Sq \(dq -et l'encadrement avec une suite de trois de ces guillemets +et l’encadrement avec une suite de trois de ces guillemets .Pq Sq \(dq\(dq\(dq . .Pp -Le caractère d'échappement +Le caractère d’échappement .Pq Sq \e -change l'interprétation des caractères spéciaux. +change l’interprétation des caractères spéciaux. Son effet varie selon le caractère échappé. Les parenthèses, les espaces normaux, les caractères de tabulation, les guillemets -et le caractère d'échappement lui-même +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 +et l’échappement de tout autre caractère est équivalent à ce même caractère sans échappement. .Pp -Lorsqu'une chaîne de caractères est placée entre guillemets droits doubles +Lorsqu’une chaîne de caractères est placée entre guillemets droits doubles .Pq Sq \(dq , les blancs et les parenthèses recoivent leur interprétation littérale. -Le comportement du caractère d'échappement est le même à l'intérieur de -guillemets qu'à l'extérieur. -Les guillemets n'ont pas à se trouver aux extrémités des atomes +Le comportement du caractère d’échappement est le même à l’intérieur de +guillemets qu’à l’extérieur. +Les guillemets n’ont pas à se trouver aux extrémités des atomes mais fonctionnent plutôt comme des commutateurs -réglant le mode d'interprétation. +réglant le mode d’interprétation. Ils fonctionnent en cela comme les guillemets des interpréteurs de commandes Unix. .Pp -La dernière stratégie d'échappement a recourt à un +La dernière stratégie d’échappement a recourt à un .Em bloc . Un bloc est délimité par une paire de triples guillemets droits doubles .Pq Sq \(dq\(dq\(dq . @@ -152,11 +152,11 @@ et le triplet fermant, inclusivement, sont ignorés. Ces caractères ignorés peuvent servir à donner certaines informations à -d'éventuels préprocesseurs. -Le texte qui se trouve à l'intérieur d'un bloc est interprété +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 +Une construction spéciale permet d’y inclure une suite de trois guillemets. +Il suffit de les faire suivre d’un point d’exclamation .Pq Sq !\& .Pp Ainsi, les trois constructions suivantes sont équivalentes\~: @@ -166,7 +166,7 @@ Ainsi, les trois constructions suivantes sont équivalentes\~: .Ed .Bd -literal -offset indent (doc - (par "Un bloc est limité par la suite\e"\e"\e".")) + (par "Un bloc est limité par la suite \e"\e"\e".")) .Ed .Bd -literal -offset indent (doc diff --git a/man/fr/plat.5 b/man/fr/plat.5 @@ -1,4 +1,4 @@ -.Dd 23 janvier 2024 +.Dd 25 janvier 2024 .Dt PLAT 5 .Os .Sh NOM @@ -26,39 +26,39 @@ Un sectionne un document .Nm . Les limites de tout domaine sont -contenues à l'intérieur du +contenues à l’intérieur du .Em "domaine parent" immédiat. 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, +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. Le .Em "domaine cadet" est le domaine le plus imbriqué à un endroit donné du document. Tout domaine apparaît au moins une fois en position de domaine cadet, -et ce même s'il est vide. +et ce même s’il est vide. .Pp Une .Em étiquette nomme un domaine. Le champ des étiquettes -contient l'étiquette du domaine cadet courant +contient l’étiquette du domaine cadet courant de même que, le cas échéant, les étiquettes de tous ses domaines parents. -Ce champ a la forme d'une liste d'étiquettes -ordonnée de telle sorte qu'un +Ce champ a la forme d’une liste d’étiquettes +ordonnée de telle sorte qu’un parent se trouve toujours à la gauche de son enfant. -Chaque étiquette de cette liste est précédée d'un deux-points +Chaque étiquette de cette liste est précédée d’un deux-points .Pq Sq :\& . -La dernière étiquette est aussi suivie d'un deux-points. -Il est impossible d'échapper les deux-points dans ce champ. +La dernière étiquette est aussi suivie d’un deux-points. +Il est impossible d’échapper les deux-points dans ce champ. .Pp Un .Em drapeau -permet d'identifier les limites d'un domaine. +permet d’identifier les limites d’un domaine. La parenthèse ouvrante .Pq Sq \( indique que la ligne est la première à être incluse dans un domaine donné\|; @@ -82,10 +82,10 @@ ces caractères sont échappés par et .Sq \et , respectivement. -Le caractère d'échappement lui-même peut être échappé par +Le caractère d’échappement lui-même peut être échappé par .Sq \e\e . .Sh EXEMPLES -L'exemple suivant +L’exemple suivant (où un signe de dollar a été ajouté pour marquer la fin de la ligne)\~: .Bd -literal -offset indent