aplat

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

commit a28ab003978515843623aada7996f4e198ce7b5c
parent d9e3de86a723bdc91411b50e3053a9876ec603e4
Auteur: Selve <selve@asteride.xyz>
Date:   Thu, 25 Jan 2024 09:28:35 -0500

restauration du dernier deux-points

Le deux-points final avait été supprimé au commit
b7503e1217ddb375a95d491ac08c4b157d151e55. Il est réintroduit pour faciliter
l'écriture de post-processeurs. On peut ainsi trouver la fin du domaine suivant
en testant seulement pour ':' et non, par exemple, pour ':', '\t' ou '\n' ou
encore pour ':' et '\0', selon l'implémentation.

Les pages du manuel et le LISEZ-MOI.txt ont été modifiés en conséquence.

Diffstat:
MLISEZ-MOI.txt | 28++++++++++++++--------------
MMakefile | 1-
Maplat.c | 2+-
Mman/fr/aplat.1 | 14+++++++-------
Mman/fr/plat.5 | 13+++++++------
5 files changed, 29 insertions(+), 29 deletions(-)

diff --git a/LISEZ-MOI.txt b/LISEZ-MOI.txt @@ -85,30 +85,30 @@ $ cat lisez-moi.aplat $ aplat <lisez-moi.aplat >lisez-moi.plat $ cat lisez-moi.plat -:doc ( -:doc:@ ( -:doc:@:titre () Lisez-moi! -:doc:@:nom du programme () aplat -:doc:@:description () Convertir le format aplat au format plat -:doc:@ ) -:doc:par () Les formats aplat et plats… -:doc:sous-titre () dépendances -:doc:par () … -:doc ) +:doc: ( +:doc:@: ( +:doc:@:titre: () Lisez-moi! +:doc:@:nom du programme: () aplat +:doc:@:description: () Convertir le format aplat au format plat +:doc:@: ) +:doc:par: () Les formats aplat et plats… +:doc:sous-titre: () dépendances +:doc:par: () … +:doc: ) On peut alors extraire le titre du document avec la suite de commandes : -$ <lisez-moi.plat grep '^:doc:@:titre ' | cut -f3 | { tr -d '\n' ; echo ; } +$ <lisez-moi.plat grep '^:doc:@:titre: ' | cut -f3 | { tr -d '\n' ; echo ; } Lisez-moi! Le dernier segment de la séquence {tr -d ’\n’ ; echo ;} est nécessaire parce que le troisième champ peut s’étendre sur plusieurs lignes. Ainsi, dans le format plat, - :doc:@:titre () Lisez-moi! + :doc:@:titre: () Lisez-moi! et - :doc:@:titre ( Lise - :doc:@:titre ) z-moi! + :doc:@:titre: ( Lise + :doc:@:titre: ) z-moi! sont équivalents. diff --git a/Makefile b/Makefile @@ -29,7 +29,6 @@ FCH_MO != find ${DOS_PO} -name '*.po' | sed 's/\.po$$/\.mo/' all: aplat traductions aplat: aplat.o tampon.o - #${CC} ${COPT} -L${LIB_DOS} -o "$@" aplat.o tampon.o ${LIBS} ${CC} ${COPT} ${LDOPTS} -o "$@" aplat.o tampon.o ${LIBS} traductions: ${FCH_MO} diff --git a/aplat.c b/aplat.c @@ -285,7 +285,7 @@ afficher_ligne(struct tampon *etq, struct tampon *ctn, int *draps) if (putc(*c, stdout) < 0) return -1; } - + putc(':', stdout); /* ajouter le point final */ putc('\t', stdout); /* drapeaux */ diff --git a/man/fr/aplat.1 b/man/fr/aplat.1 @@ -32,13 +32,13 @@ La commande suivante affiche le texte suivant\~: .Pp .Bd -literal -offset indent $ aplat <exemple.aplat -:doc ( -:doc:@ ( -:doc:@:titre () Exemple -:doc:@:date () 2024-01-21 -:doc:@ ) -:doc:par () Voici un exemple. -:doc ) +:doc: ( +:doc:@: ( +:doc:@:titre: () Exemple +:doc:@:date: () 2024-01-21 +:doc:@: ) +:doc:par: () Voici un exemple. +:doc: ) .Ed .Sh ÉTATS DE SORTIE L'utilitaire diff --git a/man/fr/plat.5 b/man/fr/plat.5 @@ -53,6 +53,7 @@ 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 .Pq Sq :\& . +La dernière étiquette est aussi suivie d'un deux-points. Il est impossible d'échapper les deux-points dans ce champ. .Pp Un @@ -88,12 +89,12 @@ L'exemple suivant (où un signe de dollar a été ajouté pour marquer la fin de la ligne)\~: .Bd -literal -offset indent -:doc ( $ -:doc:par ( Que veut $ -:doc:par dire $ -:doc:par:it () placoter$ -:doc:par )  ?$ -:doc ) $ +:doc: ( $ +:doc:par: ( Que veut $ +:doc:par: dire $ +:doc:par:it: () placoter$ +:doc:par: )  ?$ +:doc: ) $ .Ed .Pp est tout à fait équivalent au document