Groff est fourni avec au moins trois préprocesseurs : tbl,
eqn et pic (sur certains systèmes ils se nomment
gtbl, geqn et gpic). Ils sont destinés à traduire des
macro-instructions de pré-traitement et leurs arguments en code source
troff standard. Le programme tbl est un préprocesseur de
tableaux, eqn gère les équations et les mathématiques en général,
et enfin pic est un préprocesseur d'images. Consultez leurs pages
de manuel respectives pour découvrir les fonctionnalités qu'ils
proposent.
Mais autant être clair : n'écrivez jamais de pages de manuel nécessitant quelque préprocesseur que ce soit.
Eqn produira généralement une sortie catastrophique pour
les périphériques du genre télétype ; malheureusement 99% des
terminaux sur lesquels sont lues les pages de manuel en font
partie. Par exemple, XAllocColor.3x contient quelques expressions
mathématiques avec des exposants. En raison de la nature des
périphériques d'affichage, ces exposants se retrouveront sur la même
ligne que le texte de base : "N puissance deux"
s'affichera "N2".
Il faut éviter tbl car tous les programmes xman que nous
avons rencontrés ne fonctionnent pas avec lui. Xman 3.1.6 utilise
la ligne de commande suivante pour formater les pages de manuel,
par exemple signal(7) :
gtbl /usr/man/man7/signal.7 | geqn | gtbl | groff -Tascii -man \
> /tmp/xmana01760 2> /dev/null
Elle coince sur toutes les sources utilisant gtbl, car sa sortie
est renvoyée une fois de plus dans son entrée. Le résultat donne une
page de manuel sans le tableau voulu. Nous ne savons pas s'il s'agit
d'un bogue ou d'une particularité de gtbl, qui n'aime pas sa
propre sortie, ou si xman devrait être un peu plus gentil et ne
pas l'appeler deux fois... Quoi qu'il en soit, si vous voulez
un tableau, formatez-le vous-même et insérez-le entre deux lignes
.nf et .ni de sorte qu'il ne soit pas traité plus
tard. Vous ne pourrez pas obtenir de gras ou d'italiques par cette
méthode, mais cela vous évitera de voir votre beau tableau disparaître
au hasard des systèmes d'exploitation employés.
Nous n'avons encore jamais rencontré de page de manuel nécessitant un
traitement par pic. Mais nous n'aimerions pas ça ! Comme vous
pouvez le voir dans l'exemple ci-dessus, xman ne l'appelle jamais
et les données lui étant destinées donneraient sans doute le vertige à
ce pauvre groff.
Chapitre suivant, Chapitre Précédent
Table des matières de ce chapitre, Table des matières générale
Début du document, Début de ce chapitre