nroff(1)

Nom
nroff – Formatage de documents avec groff pour des périphériques TTY (terminaux)

Synopsis
nroff [-bcCEhikpRStUVz] [-d texte_chaine] [-d chaine=texte] [-K encodage_rechange] [-m paquet_macro] [-M répertoire_macro] [-n numéro_page] [-o liste_pages] [-P argument_postprocesseur] [-r expression_c_numérique] [-r registre=expression_numérique] [-T dispositif_sortie] [-w catégorie_avertissement] [-W catégorie_avertissement] [fichier ...]
nroff --help
nroff -v
nroff --version

Description
nroff formate les documents écrits avec le langage groff(7) pour des périphériques de type ligne après ligne tels que les émulateurs de terminal. GNU nroff émule la commande nroff d’AT&T en utilisant groff(1). nroff produit une sortie à l’aide de grotty(1), le pilote de sortie de groff pour le terminal, qui a besoin de connaitre le schéma d’encodage de caractères utilisé par le périphérique. Par conséquent, les arguments autorisés pour l’option -T sont ascii, latin1, utf8 et cp1047 ; tous les autres sont ignorés. Si ni la variable d’environnement GROFF_TYPESETTER, ni l’option -T de ligne de commande (qui outrepasse la variable d’environnement) ne spécifient un périphérique (valable), nroff consulte la « locale » pour sélectionner un périphérique de sortie approprié. Il essaie d’abord le programme locale(1), puis teste plusieurs variables d’environnement relatives à la « locale » ; consulter la section « ENVIRONNEMENT » ci-dessous. Si tout ce qui précède échoue, -Tascii est implicite.

Les options -b, -c, -C, -d, -E, -i, -m, -M, -n, -o, -r, -U, -w, -W et -z produisent les effets décrits dans troff(1). Les options -c et -h signifient « -P-c » et « -P-h », respectivement ; l’option -c est aussi interprétée directement par troff. De plus, cette implémentation ignore les options de nroff d’AT&T -e, -q et -s (qui ne sont pas implémentées dans groff). Les options -k, -K, -p, -P, -R, -t et -S sont documentées dans groff(1). L’option -V fait que nroff affiche la commande construite pour groff sur la sortie standard, mais ne l’exécute pas. Les options -v et --version affichent les informations de version à propos de nroff et le programme exécuté, tandis que l’option --help affiche un message d’utilisation, puis le programme se termine.

Code de retour
nroff quitte avec le code de retour 2 si un problème est rencontré lors de l’analyse des arguments, avec le code 0 si une des options -V, -v, --version ou --help est indiquée, et avec celui de groff autrement.

ENVIRONNEMENT
Normalement, le séparateur de chemin dans les variables d’environnement se terminant par PATH est le deux-points ; cela peut être différent selon le système d’exploitation. Par exemple, Windows utilise le point-virgule.

GROFF_BIN_PATH
    est une liste de répertoires séparés par des deux-points dans lesquels chercher l’exécutable groff avant de chercher dans la variable d’environnement PATH. S’il n’est pas défini, /usr/bin est utilisé.

GROFF_TYPESETTER
    indique le dispositif de sortie pour groff.

LC_ALL
LC_CTYPE
LANG
LESSCHARSET
    sont des variables d’environnement dans lesquelles est recherché, selon des motifs et dans cet ordre, du contenu correspondant aux encodages de caractère standards pris en charge par groff si aucune option -T n’est indiquée et si GROFF_TYPESETTER n’est pas définie, ou si les valeurs spécifiées ne sont pas autorisées.

FICHIERS

/usr/share/groff/1.23.0/tmac/tty-char.tmac
    contient les définitions de rechange des caractères spéciaux de roff. Ces définitions produisent une sortie typographique de qualité visuelle moindre que celles de tty.tmac, mais privilégient la communication d'informations sémantiques. Ce fichier est chargé par nroff automatiquement.

NOTES
Des programmes de pageur tels que more(1) et less(1) peuvent nécessiter des options de ligne de commande pour gérer correctement certaines séquences produites ; consulter grotty(1).

Voir aussi
groff(1), troff(1), grotty(1), locale(1), roff(7)

TRADUCTION
La traduction française de cette page de manuel a été créée par Jean-Paul Guillonneau <guillonneau.jeanpaul@free.fr>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 (https://www.gnu.org/licenses/gpl-3.0.html) concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.