8. Fontes disponibles et conventions typographiques

Contenu de cette section

N'utilisez jamais des opérateurs directs comme \fB \fP, etc. Employez des macros qui prennent des arguments, vous éviterez ainsi l'erreur classique : l'oubli du changement de fonte à la fin d'un mot, qui provoque la continuation du gras ou de l'italique jusqu'au changement suivant. Croyez-nous, c'est une erreur bien plus fréquente que vous ne pouvez l'imaginez !

Les macros tmac.an offrent les possibilités suivantes :

        .B    caracteres gras 
        .BI   gras et italiques en alternance
        .BR   gras et romain en alternance
        .I    italiques
        .IB   italiques et gras en alternance
        .IR   italiques et romain en alternance
        .RB   romain et gras en alternance
        .RI   romain et italiques en alternance
        .SM   taille reduite (9/10 du corps normal)
        .SB   gras, taille reduite (tout le texte, pas d'alternance)

X en alternance avec Y signifie que les arguments impairs seront imprimés en X et les pairs en Y. Par exemple :

        .BI "Arg 1 est gras, " "arg2 est en italiques, " "arg3 est en gras."

Voilà donc pour ce qui est disponible. Voyons maintenant comment il faut utiliser ces possibilités (nous avons honteusement copié ce qui est décrit dans man(7)) :

Bien qu'il existe dans le monde UNIX de nombreuses conventions typographiques arbitraires pour la réalisation de pages de manuel, plusieurs centaines de pages spécifiques à Linux se conforment au standard suivant :

Les fonctions et les arguments sont toujours indiqués en italiques, même dans la section SYNOPSYS, le reste de la fonction étant imprimé en corps gras :

        .BI "mafonction(int " argc ", char **" argv );

Les noms de fichiers sont toujours en italiques, sauf dans la section SYNOPSYS, où les fichiers à inclure sont en gras. Vous écrirez donc :

        .I /usr/include/stdio.h
        .B #include <stdio.h>

Les noms de macros, qui sont la plupart du temps en majuscules, sont typographiés en gras :

        .B MAXINT

Dans les énumérations de codes d'erreur, les codes sont en gras. Cette liste fait généralement appel à la macro .TP (paragraphe avec titre) comme ci-dessous :

        .TP
        .B EBADF
        .I fd
        n'est pas un descripteur de fichier valide.
        .TP
        .B EINVAL
        .I fd
        a une valeur incorrecte. 

Toute référence à une autre page de manuel (ou au sujet de la page courante) est en gras. Si la section correspondante du manuel est indiquée, elle s'écrit en roman, sans espace :

        .BR man (7)

Les acronymes sont plus élégants lorsqu'ils apparaissent dans un corps plus petit, nous vous recommandons par conséquent d'employer :

        .SM UNIX     .SM ASCII     .SM TAB      .SM NFS      .SM LALR(1)

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