SYNOPSIS

groff -m doc fichiers ...

DESCRIPTION

-mdoc est un ensemble de macros utilisées pour formater les pages de manuel BSD et basées sur le contenu et sur le domaine. Les noms des macros et leur signification sont listés ci-dessous pour une référence rapide ; pour une explication détaillée de l'utilisation du paquet, voir la page groff_mdoc7.

Notez que cela n'est pas l'ensemble de macros usuel pour la documentation sous Linux, bien qu'il soit utilisé pour la documentation de nombreux programmes largement utilisés ; voir man(7).

Les macros sont décrites en deux groupes. Le premier inclut les macros de mise en page structurelle et physique. Le second contient les macros de domaine manuel et texte qui différencient le paquet -mdoc d'autre systèmes de formatage troff.

DOMAINE DE STRUCTURE DE PAGES

Macros de titre

Pour créer une page de manuel valide, les trois macros suivantes sont nécessaires, dans cet ordre :

. mois jour, année

Date du document.

.

Titre, en majuscules.

. SYSTÈME_D_EXPLOITATION [version/release]

Système d'exploitation (BSD )

Macros de mise en page

En-têtes de section, changements de paragraphe, listes, affichage.

.

En-têtes de section. En-têtes valides, par ordre de présentation:

NAME

Section de nom, doit en général inclure les macros `.groff ' ou `.Fn ainsi ' que `. - (N.d.T.: à ce jour, le titre de cette ' section ne doit pas être traduit, sinon les en-têtes et pieds de page ne seront pas affichés).

SYNOPSIS

Utilisation.

DESCRIPTION

Description générale, devrait inclure les options et paramètres.

RETURN VALUE (VALEUR DE RETOUR)

Sections 2 et 3, appels de fonctions.

ENVIRONMENT (ENVIRONNEMENT)

Décrit les variables d'environnement.

FILES (FICHIERS)

Les fichiers associés au thème de la page.

EXAMPLES (EXEMPLES)

Exemples et suggestions.

DIAGNOSTICS (DIAGNOSTIQUE)

Utilisé en général pour la section 4, interface avec les périphérique.

ERRORS (ERREURS)

Sections 2 et 3, gestion des erreurs et signaux.

SEE ALSO (VOIR AUSSI)

Références croisées et citations.

CONFORMING TO (CONFORMITÉ)

Conformité aux normes, quand c'est le cas.

HISTORY (HISTORIQUE)

Si une norme n'est pas applicable, un historique du sujet devrait être donné.

BUGS (BOGUES)

Bogues et difficultés d'utilisation.

autres

Des en-têtes personnalisés peuvent être ajoutés, au choix des auteurs.

Li .Ss En-têtes de sous-section. Li .Pp Coupure de paragraphe. Espace vertical d'une ligne. Li .D1 (D-un) « Display-one ». Indenter et afficher une ligne de texte. Li .Dl (D-ell) « Display-one literal ». Indenter et afficher une ligne de texte verbatim. Li .Bd Début de bloc d'affichage. Options d'affichage :

-ragged

Non justifié.

-filled

Justifié.

-literal

Texte ou code verbatim.

-file nom

Lire dans le fichier indiqué, et afficher le contenu.

-offset chaîne

Afficher avec un décalage. Valeurs de chaîne autorisées :

left

Aligner le bloc à gauche (par défaut)

center

Marge centrale.

indent

Indentation de six espaces (une tabulation).

indent-two

Deux tabulations.

right

Bloc aligné à gauche, à deux pouces de la limite droite.

xx n

Où xx est un nombre entre 4 n à 99 n

Aa Où

Aa est le nom d'une macro appelable.

chaîne

La largeur de la string est utilisée.

Li .Ed Fin de bloc d'affichage (correspond à .Bd). Li .Bl Début de liste. Crée des listes ou des colonnes. Options :

Types de liste

-bullet Ta Liste Énumération par puces

-item Ta Liste sans étiquette

-enum Ta Énumération

-tag Ta Liste avec étiquette

-diag Ta Liste pour le diagnostique

-hang Ta Liste avec étiquette suspendue

-ohang Ta Liste avec étiquette surplombante

-inset Ta Liste avec étiquette incrustée

Paramètres de liste

-offset

(Toutes les listes.) Consultez `. ' ci-dessus.

-width

(Listes -tag et -hang seulement.) Consultez `. '

-compact

(Toutes les listes.) Supprimer les lignes blanches.

Li .El Fin de liste. Li .It Élément de liste.

MACROS DES DOMAINES MANUEL ET TEXTE GÉNÉRIQUE

Les macros de manuel et de texte générique sont spéciales, dans le sens où la plupart d'entre elles sont analysée à la recherche d'autres macros « appelables », par exemple :

.[-s fichier ]

Produit [-s fichier ]

Dans cet exemple, la macro d'option `.[est] ' parsée, et appelle la macro de contenu appelable `- ' qui s'applique à l'argument `s' , puis appelle la macro de contenu appelable `file ... ' qui s'applique à l'argument `fichier' Certaines macros sont appelables mais ne sont pas analysée, et vice-versa. Ces macros sont indiquées dans les colonnes analysée et appelable ci-dessous.

Sauf exception notée, les macros de manuels ont toutes la même syntaxe :

.argument [ . , ; : ( ) [ ] argument ...]

Note  : Les caractères de ponctuation ouvrants et fermants ne sont reconnus que s'ils sont présents un à la fois. La chaîne `),' n'est pas reconnue comme un signe de ponctuation, et est donc affichée précédée d'un espace, et dans la police utilisée par la macro appelante. La liste d'arguments `]' ) , est reconnue comme trois caractères de ponctuation fermants, et n'est donc pas précédée d'un espace. La signification particulière d'un signe de ponctuation peut être supprimée en le précédant par `\&' Par exemple, la chaîne suivante

.fichier1 , fichier2 , fichier3 ) .

Donne fichier1 , fichier2 , fichier3 )

Macros du domaine manuel

Nom   Analysée       Appelable       Description

Ta Oui Ta Oui Ta Adresse (cette macro peut être obsolète).

An Ta Oui Ta Oui Ta Nom de l'auteur.

Ta Oui Ta Oui Ta Argument de ligne de commande.

Ta Non Ta Non Ta Déclaration de configuration (uniquement section 4).

Ta Oui Ta Oui Ta Modificateur d'argument de ligne de commande.

Ta Oui Ta Oui Ta Variable définie (code source).

Er Ta Oui Ta Oui Ta Code d'erreur (code source).

Ta Oui Ta Oui Ta Variable d'environnement.

Fa Ta Oui Ta Oui Ta Argument d'une fonction.

Fd Ta Oui Ta Oui Ta Déclaration de fonction.

Fn Ta Oui Ta Oui Ta Appel de fonction (également .Fo et .Fc).

Ta Oui Ta Oui Ta Commande interactive.

Ta Oui Ta Oui Ta Texte verbatim.

Ta Oui Ta Oui Ta Nom de commande.

[Ta Oui Ta Oui Ta Option (également .[et .Oc). ]

Ot Ta Oui Ta Oui Ta Type de fonction, ancien style (Fortran uniquement).

Ta Oui Ta Oui Ta Nom de fichier ou chemin.

St Ta Oui Ta Oui Ta Normes (-p1003.2, -p1003.1 ou -ansiC)

Ta Oui Ta Oui Ta Nom de variable.

Vt Ta Oui Ta Oui Ta Type de variable (Fortran).

TaOuiTaOuiTaRéférenceàunepagedemanuel.

Macros de texte génériques

Nom   Analysée       Appelable       Description

%A Ta Oui Ta Non Ta Auteur de la référence.

%B Ta Oui Ta Oui Ta Titre du livre référencé.

%C Ta Non Ta Non Ta Lieu (ville) de publication de la référence.

%D Ta Non Ta Non Ta Date de la référence.

%J Ta Oui Ta Oui Ta Titre du journal de la référence.

%N Ta Non Ta Non Ta Numéro de la référence.

%O Ta Non Ta Non Ta Information optionnelle sur la référence.

%P Ta Non Ta Non Ta Numéro(s) de page de la référence.

%R Ta Non Ta Non Ta Nom du rapport référencé.

%T Ta Oui Ta Oui Ta Titre de l'article référencé.

%V Ta Non Ta Non Ta Volume de la référence.

Ac Ta Oui Ta Oui Ta Angle fermant.

Ao Ta Oui Ta Oui Ta Angle ouvrant.

Ap Ta Oui Ta Oui Ta Apostrophe.

Aq Ta Oui Ta Oui Ta Met ses arguments entre deux angles.

AT&T System Ta Non Ta Non Ta UNIX AT&T

Bc Ta Oui Ta Oui Ta Crochet fermant.

Bf Ta Non Ta Non Ta Début de mode de police.

Bo Ta Oui Ta Oui Ta Crochet ouvrant.

Bq Ta Oui Ta Oui Ta Met ses arguments entre crochets.

BSD Ta Oui Ta Oui Ta BSD

Db Ta Non Ta Non Ta Débogage (par défaut, "off")

Dc Ta Oui Ta Oui Ta Guillemet double fermant.

Do Ta Oui Ta Oui Ta Guillemet double ouvrant.

``Ta Oui Ta Oui Ta Guillemet double. ''

Ec Ta Oui Ta Oui Ta Fin d'entourage de chaîne.

Ef Ta Non Ta Non Ta Fin du mode police.

Ta Oui Ta Oui Ta Emphase (anglais traditionnel).

Eo Ta Oui Ta Oui Ta Début d'entourage de chaîne.

Fx Ta Non Ta Non Ta Système d'exploitation FreeBSD

Ta Oui Ta Oui Ta Texte normal (no-op).

Ta Oui Ta Oui Ta Pas d'espace.

Pc Ta Oui Ta Oui Ta Fermeture de parenthèse.

Ta Oui Ta Non Ta Chaîne préfixe.

Po Ta Oui Ta Oui Ta Ouverture de parenthèse.

(Ta Oui Ta Oui Ta Parenthèses. )

Qc Ta Oui Ta Oui Ta Guillemet double droit fermant.

`Ta Oui '

Ta Oui Ta Texte verbatim entre guillemets.

Qo Ta Oui Ta Oui Ta Guillemet double droit ouvrant.

Qq Ta Oui Ta Oui Ta Guillemets doubles droits.

Li Rs Ta Non Ta Non Ta "Début de référence." Li Rv Ta Non Ta Non Ta "Valeurs renvoyées (sections 2 et 3)." Li Sc Ta Oui Ta Oui Ta "Guillemet simple fermant." Li So Ta Oui Ta Oui Ta "Guillemet simple ouvrant." Li Sq Ta Oui Ta Oui Ta "Guillemet simple." Li Sm Ta Non Ta Non Ta "Mode espace (par défaut, "on")" Li Sx Ta Oui Ta Oui Ta "Référence de section." Li Sy Ta Oui Ta Oui Ta "Symbolique (anglais traditionnel)." Li Tn Ta Oui Ta Oui Ta "Nom de marque ou de type (petites majuscules)." Li Ux Ta Oui Ta Oui Ta Ux Li Xc Ta Oui Ta Oui Ta "Fin de liste d'arguments." Li Xo Ta Oui Ta Oui Ta "Début de liste d'arguments."

Les macros dont le nom finit par `q' entourent les éléments restants dans la liste d'arguments. Les macros dont le nom finit par `o' commencent une citation qui peut prendre plusieurs lignes, et qui est terminée par la macro correspondante dont le nom finit par `c' Les macros de ce type peuvent être imbriquées et sont limitées à huit arguments.

Note : les macros de liste d'arguments étendues ( `. ' `. ' et les macros de fonction ( `.Fo , ' `.Fc ) ' sont spéciales. Les macros de liste d'arguments étendues servent à dépasser la limite à neuf arguments imposée par troff.

Les macros UR (qui ouvre une référence hypertexte vers un URI ou URL), UE (qui la ferme) et UN (qui identifie la cible d'une référence) sont également disponibles. Consultez man(7) pour plus d'informations sur ces macros.

FICHIERS

doc.tmac

Macros des domaines manuel et texte générique.

tmac/doc-common

Macros et définitions structurelles communes.

tmac/doc-nroff

Fichier de style nroff local.

tmac/doc-ditroff

Fichier de style troff local.

tmac/doc-syms

Définitions spéciales (comme les macros courantes).

COLOPHON

Cette page fait partie de la publication 3.65 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

Cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Julien Cristau et l'équipe francophone de traduction de Debian (2006-2009).

Veuillez signaler toute erreur de traduction en écrivant à <[email protected]> ou par un rapport de bogue sur le paquet manpages-fr.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « man -L C <section> <page_de_man> ».