groffer - En ligne dans le Cloud

PROGRAMME:

Nom

groffer - affiche les fichiers groff et les pages de manuel sur X et tty

SYNOPSIS

greffier [--] [spécif_fichier ....]

greffier [option-mode ....] [options-groff ....] [homme-options ....] [Options X ....]
[--] [spécif_fichier ....]

greffier -h | --Aidez-moi

greffier -v | --version

DESCRIPTION

Le manuel de formation greffier programme est le moyen le plus simple d'utiliser groff(1). Il peut afficher arbitrairement
documents rédigés dans le groff langue, voir groff(7), ou autre roff langues, voir
roff(7), qui sont compatibles avec l'original trof Langue. Il trouve et exécute tout
nécessaire groff préprocesseurs, tels que chem.

Le manuel de formation greffier programme comprend également de nombreuses fonctionnalités pour trouver et afficher l'Unix
pages de manuel (man pages), de sorte qu'il puisse être utilisé en remplacement d'un man(1) programme.
De plus, les fichiers compressés pouvant être traités par gzip(1) ou bzip2(1) sont décompressés sur-
la mouche.

L'utilisation normale est assez simple en fournissant un nom de fichier ou le nom d'un man page sans
d'autres options. Mais la gestion des options offre de nombreuses possibilités pour créer des
comportements. Cela peut être fait soit dans les fichiers de configuration, avec l'environnement shell
variable $GROFFER_OPT, ou sur la ligne de commande.

La sortie peut être générée et visualisée de plusieurs manières différentes disponibles pour groff.
Cela inclut le groff visualiseur natif X Window gxditview(1 chacun Post-scriptum, pdf, ou Dvi
programme d'affichage, un navigateur Web en générant html in www mode, ou plusieurs texte modes in
terminaux de texte.

La plupart des options qui doivent être nommées lors de l'exécution groff sont déterminés directement
automatiquement pour greffier, en raison de l'utilisation interne du grog(1) programme. Mais tout
les parties peuvent également être contrôlées manuellement par des arguments.

Plusieurs noms de fichiers peuvent être spécifiés dans les arguments de la ligne de commande. ils sont transformés
en un seul document de la manière habituelle groff.

La gestion des options est effectuée dans le style GNU. Les options et les noms de fichiers peuvent être mélangés librement. Les
choix `--' ferme la gestion des options, tous les arguments suivants sont traités comme des noms de fichiers.
Les options longues peuvent être abrégées de plusieurs manières.

OPTION APERÇU

rupture Options

[-h | --Aidez-moi] [-v | --version]

greffier mode Options

[--auto] [--défaut] [--modes par défaut mod1, mod2,....] [--dvi] [--groff]
[--html] [--latin1] [--mode mode d'affichage] [--pdf] [--pdf2] [--PS] [--la source]
[--texte] [--vers la sortie standard] [--tty] [--utf8] [--téléspectateur prog] [--www] [--X | --X]

Options en relation à groff

[-T | --dispositif dispositif] [-Z | --intermédiaire-sortie | --ditroff]

Tout plus loin groff les options courtes sont acceptées.

Options pour man pages

[--à propos] [--apropos-données] [--à propos-devel] [--propos-progs] [--homme]
[--personne] [--pas de SPÉCIAL] [--quel est]

Long Options utilisée plus de grâce au GNU man

[--tout] [--ascii] [--ditroff] [--extension suffixe] [--lieu langue]
[--fichier-local] [--emplacement | --où] [--manpath rep1:rep2:....] [--pas d'emplacement]
[--pageur Programme] [--sections sec1:sec2:....] [--systèmes sys1, sys2,....]
[--troff-dispositif dispositif]

Autres options longues de GNU man sont également acceptés.

X Vitrine Boîte à outils Options

[--bd | --couleur de la bordure Pixel] [--bg | --Contexte couleur]
[--bw | --largeur de la bordure Pixel] [--affichage X-affichage] [--fg | --premier plan couleur]
[--fn | --pi | --Police de caractère nom_fonte] [--géométrie taille_pos] [--résolution Plus-value] [--rv]
[--Titre un magnifique] [--xrm X-ressource]

Options pour développant

[--déboguer] [--debug-noms de fichiers] [--debug-grog] [--debug-garder] [--debug-paramètres]
[--debug-tmpdir] [--ne fais rien] [--imprimer texte] [-V]

spécif_fichier arguments

Le manuel de formation spécif_fichier les paramètres sont tous des arguments qui ne sont ni une option ni une option
argument. Ils signifient généralement un nom de fichier ou un man page schéma de recherche.

Dans ce qui suit, le terme section_extension est utilisé. Cela signifie un mot qui
est constitué d'un man qui est éventuellement suivi d'un l'extension de. Le nom de
a man est un caractère unique de [1–9 sur], la l'extension de est un mot. Les
l'extension de fait surtout défaut.

Non spécif_fichier paramètres signifie entrée standard.

- signifie entrée standard (peut se produire plusieurs fois).

nom de fichier le chemin d'accès d'un fichier existant.

homme:prénom(section_extension)
homme:prénom.section_extension
prénom(section_extension)
prénom.section_extension
section_extension prénom
rechercher la page de manuel prénom dans la section avec extension optionnelle
section_extension.

homme:prénom page de manuel dans le plus bas man qui possède prénom.

prénom if prénom n'est pas une recherche de fichier existante pour la page de manuel prénom dans le
section d'homme la plus basse.

OPTION DÉTAILS

Le manuel de formation greffier Le programme peut généralement être exécuté avec très peu d'options. Mais à des fins spéciales,
il prend en charge de nombreuses options. Ceux-ci peuvent être classés en 5 classes d'options.

Toutes les options courtes de greffier sont compatibles avec les options courtes de groff(1). Tout le long
options de greffier sont compatibles avec les options longues de man (1).

Les arguments pour les noms d'options longs peuvent être abrégés de plusieurs manières. Premièrement, l'argument
est vérifié s'il peut être prolongé tel quel. De plus, chaque signe moins - is
considéré comme le point de départ d'une nouvelle abréviation. Cela conduit à un ensemble de plusieurs
abréviations pour un seul argument. Par exemple, --de-nf peut être utilisé comme abréviation
pour --debug-not-func, mais --tanière fonctionne aussi. Si l'abréviation de l'argument conduit
à plusieurs options résultantes, une erreur est générée.

Ces abréviations ne sont autorisées que dans la variable d'environnement $GROFFER_OPT, Mais pas en
les fichiers de configuration. En configuration, toutes les options longues doivent être exactes.

greffier rupture Options
Dès qu'une de ces options est trouvée sur la ligne de commande, elle est exécutée, imprimée sur
sortie standard, et la course greffier est résilié par la suite. Tous les autres arguments
sont ignorés.

-h | --Aidez-moi
Imprimez des informations d'aide avec une brève explication des options sur la sortie standard.

-v | --version
Imprimer les informations de version sur la sortie standard.

greffier Mode Options
Le mode d'affichage et les programmes de visualisation sont déterminés par ces options. Si aucun de
ces options de mode et de visionneuse sont spécifiées greffier essaie de trouver un mode d'affichage approprié
automatiquement. Les modes par défaut sont mode pdf, mode ps, mode html, mode xet mode Dvi
dans X Window avec différentes visionneuses et mode tty avec appareil utf8 sous moins sur une borne ;
d'autres modes sont testés si les programmes pour le mode principal par défaut n'existent pas.

Dans X Window, de nombreux programmes créent leur propre fenêtre lorsqu'ils sont appelés. greffier peut exécuter ces
téléspectateurs comme un programme indépendant en arrière-plan. Comme cela ne fonctionne pas en mode texte
sur un terminal (tty) il doit y avoir un moyen de savoir quels visualiseurs sont graphiques X Window
programmes. le greffier script a un petit ensemble d'informations sur certains noms de spectateurs. Si un
L'argument viewer de la ligne de commande choisit un élément qui est conservé en tant que programme X Window dans
cette liste est traitée comme une visionneuse pouvant s'exécuter en arrière-plan. Tous les autres, inconnus
les appels des téléspectateurs ne sont pas exécutés en arrière-plan.

Pour chaque mode, vous êtes libre de choisir la visionneuse que vous voulez. Cela n'a pas besoin d'être quelque
visualiseur graphique adapté à ce mode. Il y a une chance de voir la source de sortie; pour
exemple, la combinaison des options --mode=ps et --viewer=moins montre le contenu de
le Post-scriptum sortie, le code source, avec le pager moins.

--auto Équivalent à --mode=auto.

--défaut
Réinitialiser toute la configuration des options de ligne de commande précédemment traitées sur le
les valeurs par défaut. Ceci est utile pour effacer toutes les anciennes options du
configuration, dans $GROFFER_OPT, et redémarrez le traitement des options en utilisant uniquement le reste
de la ligne de commande.

--modes par défaut mod1, mod2,....
Définir la séquence de modes pour auto mode à la liste séparée par des virgules donnée dans le
argument. Voir --mode pour plus de détails sur les modes. Afficher de la manière par défaut ;
en fait, cela signifie essayer les modes x, pset tty dans cette séquence.

--dvi Équivalent à --mode=dvi.
--téléspectateur prog
Choisissez un programme de visionneuse pour Dvi mode. Il peut s'agir d'un nom de fichier ou d'un programme à
recherché dans $ CHEMIN. Fenêtre X connue Dvi les téléspectateurs comprennent xdvide Géographie (1) et avec la dvilx(1). Dans
dans chaque cas, des arguments peuvent être fournis en plus.

--groff
Équivalent à --mode=groff.

--html Équivalent à --mode=html.
--téléspectateur
Choisissez un programme de navigateur Web pour l'affichage dans html mode. Il peut s'agir du nom de chemin de
un fichier exécutable ou un programme dans $ CHEMIN. Dans chaque cas, des arguments peuvent être fournis
aditionellement.

--mode Plus-value
Réglez le mode d'affichage. Les valeurs de mode suivantes sont reconnues :

auto Sélectionnez la détermination automatique du mode d'affichage. La séquence de
les modes qui sont essayés peuvent être réglés avec le --modes par défaut option. Utile pour
restaurer le défaut mode lorsqu'un mode différent a été spécifié auparavant.

Dvi Afficher l'entrée formatée dans un Dvi programme de visionneuse. Par défaut, le formaté
l'entrée s'affiche avec le xdvi(1) programme.

groff Après la détermination du fichier, passez greffier pour traiter l'entrée comme
groff(1) ferait l'affaire. Cela désactive le greffier fonctions de visualisation.

html Traduire l'entrée au format html et afficher le résultat dans un navigateur Web
programme. Par défaut, l'existence d'une séquence de navigateurs web standards
est testé, en commençant par Konquerorde Géographie (1) et avec la mozilla(1). La visionneuse de texte html
is lynx (1).

pdf Transformez roff contribution fichiers en PDF filet En utilisant le groff (1) dispositif
-Tpdf. C'est la valeur par défaut PDF Générateur. Le généré PDF filet is
affiché avec des programmes de visionnage appropriés, tels que okulé (1).

pdf2 C'est le traditionnel pdf mode. Parfois, ce mode produit des résultats plus corrects
sortie que la valeur par défaut PDF mode. Par défaut, l'entrée est formatée par
groff à l'aide du périphérique Postscript, puis il est transformé en fichier PDF
format en utilisant gs(1), ou ps2pdf(1). Si ce n'est pas possible, le Post-scriptum
mode (pss) est utilisé à la place. Enfin, il est affiché à l'aide de différentes visionneuses
programmes.

ps Affichez l'entrée formatée dans un programme de visualisation Postscript. Par défaut, le
l'entrée formatée est affichée dans l'un des nombreux programmes de visualisation.

texte Formater dans un groff texte mode et écrire le résultat sur la sortie standard sans
un programme de téléavertisseur ou de visionneuse. Le dispositif de texte, latin1 par défaut, peut être
choisi avec option -T.

tty Formater dans un groff texte mode et écrivez le résultat sur la sortie standard à l'aide d'un
programme de téléavertisseur de texte, même dans X Window.

www Équivalent à --mode=html.

x Afficher l'entrée formatée dans un natif roff téléspectateur. Par défaut, le
l'entrée formatée s'affiche avec le gxditview(1) programme en cours de distribution
avec groff. Mais l'outil standard X Window xditview(1) peut aussi être
choisi avec l'option --téléspectateur. La résolution par défaut est 75dpi, mais
100dpi sont également possibles. Le défaut groff dispositif pour la résolution de
75dpi is X75-12, Pour 100dpi c'est X100. Le correspondant groff
intermédiaire sortie pour l'appareil réel est généré et le résultat est
affiché. Pour une résolution de 100dpi, la largeur par défaut de la géométrie de
le programme d'affichage est choisi pour 850dpi.

X Équivalent à --mode=x.

Les modes suivants n'utilisent pas le greffier fonctions de visualisation. Ils ne sont que
intéressant pour les applications avancées.

groff Générer une sortie de périphérique avec plain groff sans utiliser la visualisation spéciale
caractéristiques d' greffier. Si aucun périphérique n'a été spécifié par option -T le groff
défaut ps est assumé.

source Sortez le code source roff des fichiers d'entrée sans autre traitement.

--pdf Équivalent à --mode=pdf.
--pdf2 Équivalent à --mode=pdf2.
--téléspectateur prog
Choisissez un programme de visionneuse pour pdf mode. Il peut s'agir d'un nom de fichier ou d'un programme à
recherché dans $ CHEMIN; des arguments peuvent être fournis en plus.

--PS Équivalent à --mode=ps.
--téléspectateur prog
Choisissez un programme de visionneuse pour ps mode. Il peut s'agir d'un nom de fichier ou d'un programme à
recherché dans $ CHEMIN. Les visionneuses Postscript courantes incluent okulé(1), montrer(1), gv(1),
vue fantôme(1), et gs(1), Dans chaque cas, des arguments peuvent être fournis en plus.

--la source
Équivalent à --mode=source.

--texte Équivalent à --mode=texte.

--vers la sortie standard
Le fichier pour le mode choisi est généré et son contenu est imprimé au standard
sortir. Il ne sera pas affiché en mode graphique.

--tty Équivalent à --mode=tty.
--téléspectateur prog
Choisissez un pager de texte pour le mode tty. Le téléavertisseur standard est moins(1). Cette option est
équivalente à man option --pager=prog. L'argument option peut être un nom de fichier ou un
programme à rechercher dans $ CHEMIN; des arguments peuvent être fournis en plus.

--www Équivalent à --mode=html.
--téléspectateur
prog.

--X | --X
Équivalent à --mode=x.
--téléspectateur prog
Choisissez un programme de visionneuse pour x mode. Les programmes de visionnage appropriés sont gxditview(1)
qui est la valeur par défaut et xditview(1). L'argument peut être n'importe quel fichier exécutable ou un
programme en $ CHEMIN; des arguments peuvent être fournis en plus.

-- Signale la fin du traitement des options ; tous les arguments restants sont interprétés comme
spécif_fichier paramètres.

Outre ces, greffier accepte toutes les options courtes valables pour le groff(1) programme.
Tous les nongreffier les options sont envoyées sans modification via grog à groff. Donc postprocesseurs, macro
packages, compatibilité avec classique trof, et bien plus encore peuvent être spécifiés manuellement.

Options en relation à groff
Toutes les options courtes de greffier sont compatibles avec les options courtes de groff(1). le
suite de groff les options ont soit une signification spéciale supplémentaire dans greffier or
logique pour une utilisation normale.

En raison du comportement de sortie spécial du groff option -Z greffier a été conçu pour
être basculé dans groff mode; la greffier les fonctions d'affichage y sont désactivées. L'autre
groff les options ne changent pas de mode, mais permettent de personnaliser le processus de formatage.

--une Cela génère une approximation ascii de la sortie dans le texte modes. Cela pourrait être
important lorsque le téléavertisseur a des problèmes avec les séquences de contrôle dans tty mode.

--m filet
Ajoutez des effets de filet en tant que groff fichier de macros. Ceci est utile au cas où il ne peut pas être reconnu
automatiquement.

--P opt_or_arg
Envoyer l'argument opt_or_arg en tant qu'option ou argument d'option au réel groff
Post-processeur.

--T nom dev | --dispositif nom dev
Cette option détermine groffpériphérique de sortie de. Les appareils les plus importants sont les
périphériques de sortie de texte pour faire référence aux différents jeux de caractères, tels que ascii,
utf8, latin1, utf8, et d'autres. Chacun de ces arguments change greffier en
texte mode à l'aide de cet appareil, pour mode tty si le mode réel n'est pas un texte mode.
nom dev les arguments sont mappés sur le correspondant greffier
--mode=nom dev option: Dvi, htmlet ps. Tous X* les arguments sont mappés sur mode x.
L'un et l'autre nom dev l'argument passe à mode groff à l'aide de cet appareil.

--X équivaut à groff -X. Il affiche le groff intermédiaire sortie avec
gxditview. Comme la qualité est relativement mauvaise, cette option est dépréciée ; utilisation --X
au lieu de cela parce que le x mode utilise un X* appareil pour un meilleur affichage.

-Z | --intermédiaire-sortie | --ditroff
Passer en groff mode et formatez l'entrée avec le groff intermédiaire sortie
sans post-traitement ; voir groff_out(5). C'est l'équivalent de l'option --ditroff
of man, qui peut aussi être utilisé.

Tous les autres groff les options sont prises en charge par greffier, mais ils sont simplement transparents
transféré à groff sans aucune intervention. Les options qui ne sont pas explicitement
manipulé par greffier sont transmis de manière transparente à groff. Par conséquent, ces options transparentes
ne sont pas documentés ici, mais dans groff(1). En raison de l'automatisme dans greffier, aucun d'eux
groff des options devraient être nécessaires, sauf pour une utilisation avancée.

Options pour man pages
--à propos
Commencer le à propos(1) commandement ou installation de man(1) pour rechercher le spécif_fichier
arguments au sein de tous man page descriptifs. Chaque spécif_fichier l'argument est pris pour
rechercher tel quel ; des pièces spécifiques ne sont pas manipulées, de sorte que 7 groff recherches
pour les deux arguments 7 et groff, avec un grand résultat ; pour le spécif_fichier groff.7
rien ne sera trouvé. Les langue locale est gérée uniquement lorsque l'appelé
les programmes soutiennent cela; le GNU à propos et man -k ne pas. L'affichage diffère
du à propos programme par les concepts suivants :

* Construire un groff cadre semblable à un man page à la sortie de à propos,

* chaque spécif_fichier l'argument est recherché seul.

* La restriction par --sections est également traité,

* les caractères génériques sont autorisés et gérés sans autre option.

--apropos-données
Afficher uniquement le à propos descriptions pour les documents de données, ce sont les man(7)
les sections 4, 5et 7. Direct les déclarations sont ignorées, les caractères génériques sont
accepté.

--à propos-devel
Afficher uniquement le à propos descriptions pour les documents de développement, ce sont les man(7)
les sections 2, 3et 9. Direct les déclarations sont ignorées, les caractères génériques sont
accepté.

--propos-progs
Afficher uniquement le à propos descriptions des documents sur les programmes, ce sont les man(7)
les sections 1, 6et 8. Direct les déclarations sont ignorées, les caractères génériques sont
accepté.

--quel est
Pour chaque spécif_fichier recherche d'arguments tout man pages et afficher leur description — ou
dire que ce n'est pas un man page. Ceci est écrit de nouveau, donc il diffère de man's
quel est sortie par les concepts suivants

* chaque nom de fichier récupéré est ajouté,

* les fichiers locaux sont également traités,

* le langue et Système les paramètres régionaux sont pris en charge,

* l'affichage est encadré par un groff format de sortie similaire à un man page,

* les caractères génériques sont autorisés sans autre option.

Les options suivantes ont été ajoutées à greffier pour choisir si les arguments du nom de fichier
sont interprétés comme des noms de fichiers locaux ou comme un modèle de recherche pour man pagesL’
par défaut, la recherche de fichiers locaux.

--homme Vérifiez les arguments de ligne de commande non optionnels (spécifications de fichier) d'abord en étant man pages,
puis s'ils représentent un fichier existant. Par défaut, un spécif_fichier est le premier
testé s'il s'agit d'un fichier existant.

--personne | --fichier-local
Ne pas vérifier man pages. --fichier-local est le correspondant man option.

--pas de SPÉCIAL
Désactiver les anciens appels de --tout, --à propos*et --quel est.

Long Options utilisée plus de grâce au GNU man
Les longues options de greffier ont été synchronisés avec les options longues de GNU man. Tout le long
options de GNU man sont reconnues, mais toutes ces options ne sont pas importantes pour greffier,
donc la plupart d'entre eux sont simplement ignorés. Ces ignorés man les options sont --homme chat, --troffet
--mettre à jour.

Dans ce qui suit, le man options qui ont une signification particulière pour greffier sont documentés.

Si votre système a GNU man installé l'ensemble complet des options longues et courtes du GNU man
le programme peut être passé via la variable d'environnement $MANOPTER; voir man (1).

--tout En cherchant man pages, récupérez tous les documents appropriés au lieu d'un seul.

-7 | --ascii
In texte modes, afficher la traduction ASCII des caractères spéciaux pour les
environnement. Ceci équivaut à groff -mtty_char; voir groff_tmac (5).

--ditroff
Produit groff intermédiaire sortie. Cela équivaut à greffier -Z.

--extension suffixe
Limiter man page rechercher des noms de fichiers qui ont suffixe annexé à leur rubrique
élément. Par exemple, dans le nom de fichier /usr/share/man/man3/terminfo.3ncurses.gz
le man page l'extension est ncurses.

--lieu langue
Réglez la langue pour man pages. Cela a le même effet, mais écrase $LANG.

--emplacement
Imprimer l'emplacement des fichiers récupérés à l'erreur standard.

--pas d'emplacement
Ne pas afficher l'emplacement des fichiers récupérés ; cela réinitialise un ancien appel à
--emplacement. Ceci a été ajouté par greffier.

--manpath 'dir1:dir2:....'
Utilisez le chemin de recherche spécifié pour récupérer man pages au lieu du programme
par défaut. Si l'argument est défini sur la chaîne vide "" la recherche de man page is
désactivée.

--pageur
Réglez le programme de téléavertisseur dans tty mode; la valeur par défaut est moins. Cela peut être réglé avec --téléspectateur.

--sections sec1:sec2:....
Restreindre la recherche de man pages au donné les sections, une liste séparée par des deux-points.

--systèmes sys1, sys2,....
Rechercher man pages pour les systèmes d'exploitation donnés ; l'argument les systèmes est une
liste séparée par des virgules.

--où
Équivalent à --emplacement.

X Vitrine Boîte à outils Options
Les options longues suivantes ont été adaptées à partir des options correspondantes de la boîte à outils X Window.
greffier les transmettra au programme de visualisation réel s'il s'agit d'un programme X Window.
Sinon, ces options sont ignorées.

Malheureusement, ces options utilisent l'ancien style d'un seul moins pour les options longues. Pour
greffier qui a été changé en standard avec l'utilisation d'un double moins pour les options longues, pour
Par exemple, greffier utilise l'option --Police de caractère pour l'option X Window -Police de caractère.

See X(7) et la documentation sur les options de X Window Toolkit pour plus de détails sur ces
options et leurs arguments.

--Contexte couleur
Définissez la couleur d'arrière-plan de la fenêtre de la visionneuse.

--bd Pixel
Cela équivaut à --couleur de la bordure.

--bg couleur
Cela équivaut à --Contexte.

--bw Pixel
Cela équivaut à --largeur de la bordure.

--couleur de la bordure Pixel
Spécifie la couleur de la bordure entourant la fenêtre de la visionneuse.

--largeur de la bordure Pixel
Spécifie la largeur en pixels de la bordure entourant la fenêtre de la visionneuse.

--affichage X-affichage
Réglez l'affichage X Window sur lequel le programme de visionneuse doit être démarré, voir le
Documentation X Window pour la syntaxe de l'argument.

--premier plan couleur
Définissez la couleur de premier plan de la fenêtre de la visionneuse.

--fg couleur
Cela équivaut à --premier plan.

--fn nom_fonte
Cela équivaut à --Police de caractère.

--Police de caractère nom_fonte
Définissez la police utilisée par la fenêtre de visualisation. L'argument est un nom de police X Window.

--pi nom_fonte
Cela équivaut à --Police de caractère.

--géométrie taille_pos
Définir la géométrie de la fenêtre d'affichage, c'est-à-dire sa taille et son départ
position. Voir X(7) pour la syntaxe de l'argument.

--résolution Plus-value
Définissez la résolution de la fenêtre X en dpi (points par pouce) dans certains programmes de visualisation. Le seul
les valeurs dpi prises en charge sont 75 et 100. En fait, la résolution par défaut pour greffier
est fixé à 75dpi. La résolution définit également le périphérique par défaut dans mode x.

--rv Inverser la couleur de premier plan et d'arrière-plan de la fenêtre de la visionneuse.

--Titre 'certains texte'
Définissez le titre de la fenêtre de visualisation.

--xrm 'Ressource'
Définir la ressource X Window.

Options pour Développement
--déboguer
Activer toutes les options de débogage --déboguer-type. Les fichiers temporaires sont conservés et non
supprimé, le grog la sortie est imprimée, le nom du répertoire temporaire est
imprimés, les noms de fichiers affichés sont imprimés et les paramètres sont imprimés.

--debug-noms de fichiers
Imprimez les noms des fichiers et man pages qui sont affichés par greffier.

--debug-grog
Imprimer la sortie de tous grog les commandes.

--debug-garder
Activez deux informations de débogage. Imprimez le nom du répertoire temporaire et
conserver les fichiers temporaires, ne pas les supprimer pendant l'exécution de greffier.

--debug-paramètres
Imprimez les paramètres, tels qu'obtenus à partir des fichiers de configuration, à partir de GROFFER_OPT,
et les arguments de la ligne de commande.

--debug-tmpdir
Imprimez le nom du répertoire temporaire.

--ne fais rien
C'est comme --version, mais sans la sortie ; aucune visionneuse n'est démarrée. Cela fait
seul sens dans le développement.

--imprimer=texte
Il suffit d'imprimer l'argument à l'erreur standard. C'est bon pour la vérification des paramètres.

-V Il s'agit d'une option avancée pour le débogage uniquement. Au lieu d'afficher le formaté
entrée, beaucoup de greffier des informations spécifiques sont imprimées sur la sortie standard :

* le nom du fichier de sortie dans le répertoire temporaire,

* le mode d'affichage du réel greffier courir,

* le programme d'affichage pour visualiser la sortie avec ses arguments,

* les paramètres actifs des fichiers de configuration, les arguments dans $GROFFER_OPTet
les arguments de la ligne de commande,

* le pipeline qui serait exploité par le groff programme, mais sans l'exécuter.

D'autres options de débogage utiles sont les groff option -Z et --mode=groff.

Spécification de fichier Arguments
A spécif_fichier paramètre est un argument qui n'est pas une option ou un argument d'option. Dans greffier,
spécif_fichier les paramètres sont un nom de fichier ou un modèle de recherche man pages. Ces entrées
les sources sont collectées et composées dans un seul fichier de sortie tel que groff t.

L'étrange comportement de POSIX pour considérer tous les arguments derrière le premier argument non optionnel comme
spécif_fichier les arguments sont ignorés. Le comportement de GNU pour reconnaître les options même lorsqu'elles sont mélangées avec
spécif_fichier arguments est utilisé tout au long. Mais, comme d'habitude, l'argument du double moins -- se termine
la gestion des options et interprète tous les arguments suivants comme spécif_fichier arguments; alors le
Le comportement POSIX peut être facilement adopté.

Les options --à propos* avoir un traitement spécial de spécif_fichier arguments. Chaque argument est
considéré comme un système de recherche à part entière. Une regexp (expression régulière) peut également être utilisée dans
la spécification de fichier. Par exemple, greffier --à propos '^gro.f$' recherches groff dans le man page
nom, tandis que greffier --à propos groff recherches groff quelque part dans le nom ou la description de
le man pages.

Toutes les autres parties de greffier, comme l'affichage normal ou la sortie avec --quel est avoir un
régime différent pour spécifications de fichier. Aucune expression régulière n'est utilisée pour les arguments. Les
spécif_fichier les arguments sont traités par le schéma suivant.

Il faut savoir que sur chaque système le man pages sont triés selon leur
contenu en plusieurs sections. Les classique man les sections avoir un nom à un caractère,
soit un chiffre de 1 à 9 ou l'un des personnages n or o.

Cela peut éventuellement être suivi d'une chaîne, ce que l'on appelle l'extension deL’ l'extension de
permet de stocker plusieurs man pages avec le même nom dans le même . Mais le
l'extension de n'est que rarement utilisé, il est généralement omis. Puis le extensions sont recherchés
automatiquement par alphabet.

Dans ce qui suit, nous utilisons le nom section_extension pour un mot composé d'un seul
caractère nom ou un caractère suivi d'un l'extension de. Chaque
spécif_fichier paramètre peut avoir l'une des formes suivantes dans l'ordre décroissant.

* Non spécif_fichier paramètres signifie que greffier attend l'entrée standard. L'option moins -
représente toujours l'entrée standard ; cela peut se produire plusieurs fois. Si vous voulez rechercher un
man page appelé - utiliser l'argument homme:-.

* Suivant un spécif_fichier est testé s'il s'agit du chemin d'accès d'un fichier existant. Sinon il
est supposé être un modèle de recherche d'un man page.

* homme:prénom(section_extension), homme:prénom.section_extension, prénom(section_extension), or
prénom.section_extension rechercher la page de manuel prénom en section homme et éventuellement extension de
section_extension.

* Maintenant homme:prénom recherche un man page au plus bas man qui a un document
appelé prénom.

* section_extension prénom est un modèle de 2 arguments qui provient d'un étrange
analyse des arguments de la man programme. Encore une fois, cela recherche la page de manuel prénom avec
section_extension, une combinaison d'un caractère éventuellement suivi d'un
l'extension de.

* Il nous reste l'argument prénom qui n'est pas un fichier existant. Donc ceci recherche
le man page appelé prénom au plus bas man qui a un document pour ce nom.

Plusieurs arguments de nom de fichier peuvent être fournis. Ils sont mélangés par groff en un seul
document. Notez que l'ensemble d'arguments d'option doit correspondre à tous ces arguments de fichier.
Donc, ils devraient avoir au moins le même style de la groff la langue.

SORTIE MODES

Par défaut, le greffier programme rassemble toutes les entrées dans un seul fichier, les formate avec le
groff programme pour un certain appareil, puis choisit un programme de visionneuse approprié. Les
processus de l'appareil et de la visionneuse dans greffier est appelé un mode. Le mode et le spectateur d'une course
greffier programme est sélectionné automatiquement, mais l'utilisateur peut également le choisir avec des options.
Les modes sont choisis par option les arguments de --mode=n'importe quel mode. De plus, chacun de
cet argument peut être spécifié en tant qu'option propre, telle que n'importe quel mode. La plupart de ces
modes ont un programme de visionneuse, qui peut être choisi par l'option --téléspectateur.

Plusieurs modes différents sont proposés, des modes graphiques pour X Window, texte modes, Et certains
groff modes pour le débogage et le développement.

Par défaut, greffier essaie d'abord si x mode est possible, alors ps mode, et enfin
tty mode. Cette séquence de test de mode pour auto mode peut être modifié en spécifiant une virgule
liste séparée des modes avec l'option --modes-par-défaut.

La recherche de man pages et la décompression de l'entrée sont actives dans tous les modes.

Graphique Écran Modes
Les modes d'affichage graphique fonctionnent principalement dans l'environnement X Window (ou similaire
implémentations dans d'autres environnements de fenêtrage). La variable d'environnement $AFFICHAGE
et l'option --affichage sont utilisés pour spécifier l'affichage X Window à utiliser. Si ce
la variable d'environnement est vide greffier suppose qu'aucune fenêtre X n'est en cours d'exécution et passe à un
texte mode. Vous pouvez modifier ce comportement automatique par l'option --modes par défaut.

Visionneuses connues pour les modes d'affichage graphique et leurs programmes de visionneuse X Window standard
sommes-nous

* dans une visionneuse PDF (pdf mode)

* dans un navigateur Web (html or www mode)

* dans une visionneuse Postscript (ps mode)

* Fenêtre X roff téléspectateurs tels que gxditview(1) ou xditview(1) (dans x mode)

* dans un programme de visionneuse dvi (Dvi mode)

Le manuel de formation pdf mode a un avantage majeur - c'est le seul mode d'affichage graphique qui permet de
rechercher du texte dans la visionneuse ; cela peut être une caractéristique très importante. Malheureusement,
il faut un certain temps pour transformer l'entrée au format PDF, il n'a donc pas été choisi comme
mode majeur.

Ces visionneuses graphiques peuvent être personnalisées à l'aide des options de la boîte à outils X Window. Mais le
greffier les options utilisent un double moins au début au lieu du seul moins utilisé par le
Boîte à outils X Window.

Texte modes
Il existe deux modes de sortie de texte, mode texte pour une sortie simple sans pager et
mode tty pour une sortie de texte sur un terminal de texte à l'aide d'un programme de pager.

Si la variable $AFFICHAGE n'est pas défini ou vide, greffier suppose qu'il doit utiliser tty mode.

Dans la mise en œuvre réelle, le groff dispositif de sortie latin1 est choisi pour texte modes.
Cela peut être modifié en spécifiant l'option -T or --dispositif.

Le pager à utiliser peut être spécifié par l'une des options --pageur et --téléspectateur, Ou par
la variable d'environnement $PAGER. Si tout cela n'est pas utilisé, le moins(1) programme avec le
option -r pour afficher correctement les séquences de contrôle est utilisé comme pager par défaut.

Spécial Modes pour Débogage et Développement
Ces modes utilisent le greffier détermination et décompression de fichiers. Ceci est combiné dans un
fichier d'entrée unique qui est alimenté directement dans groff avec une stratégie différente sans le
greffier installations de visualisation. Ces modes sont considérés comme avancés, ils sont utiles pour
à des fins de débogage et de développement.

Le manuel de formation source mode avec option --la source affiche simplement l'entrée décompressée.

Option --vers la sortie standard ne s'affiche pas en mode graphique. Il génère juste le fichier pour
le mode choisi, puis imprime son contenu sur la sortie standard.

Le manuel de formation groff mode passe l'entrée à groff en utilisant uniquement certaines options appropriées fournies à
greffier. Cela permet à l'utilisateur d'enregistrer la sortie générée dans un fichier ou de la rediriger vers
un autre programme.

In groff mode, l'option -Z désactive le post-traitement, produisant ainsi le groff
intermédiaire sortie. Dans ce mode, l'entrée est formatée, mais pas post-traitée ; voir
groff_out(5) pour plus de détails.

Tous groff les options courtes sont prises en charge par greffier.

MAN PAGE RECHERCHE

Le comportement par défaut de greffier est de d'abord tester si un paramètre de fichier représente un
fichier local ; s'il ne s'agit pas d'un nom de fichier existant, il est supposé représenter le nom d'un
man page. Les options suivantes peuvent être utilisées pour déterminer si les arguments doivent être
géré comme nom de fichier ou man page arguments.

--homme force à interpréter tous les paramètres du fichier comme spécifications de fichier pour chercher man pages.

--personne
--fichier-local
désactiver le man recherche; donc seuls les fichiers locaux sont affichés.

Si ni un fichier local ni un man page a été récupéré pour certains paramètres de fichier, un avertissement est
émis sur erreur standard, mais le traitement se poursuit.

Rechercher Algorithme
Supposons maintenant qu'un man page doit être recherché. Les greffier programme fournit un
fonction de recherche de man pages. Toutes les options longues, toutes les variables d'environnement et la plupart des
la fonctionnalité du GNU man(1) programme ont été mis en œuvre. L'algorithme de recherche doit
déterminer quel fichier est affiché pour un man page. Le processus peut être modifié par
options et variables d'environnement.

La seule inspection man action qui est omise dans greffier sont les préformatés man pages, Également appelé
cat pages. Avec les excellentes performances des ordinateurs actuels, le préformaté
man pages ne sont plus nécessaires. En outre, greffier est une roff programme; ça veut
lire roff sources et formatez-les lui-même.

L'algorithme de récupération du fichier pour un man page a besoin d'abord d'un ensemble de répertoires.
Cet ensemble commence par ce qu'on appelle man chemin qui est modifié plus tard en ajoutant des noms de
d'exploitation Système et langue. Cet ensemble résultant est utilisé pour ajouter la section
répertoires contenant les man page fichiers.

Le manuel de formation man chemin est une liste de répertoires séparés par deux points. Il est généré par le
méthodes suivantes.

* La variable d'environnement $ CHEMIN MANUEL peut être mis en place.

* Il peut être lu à partir des arguments de la variable d'environnement $MANOPTER.

* Le man chemin peut être spécifié manuellement en utilisant l'option --manpath. Un argument vide
désactive le man page recherche.

* Quand non man chemin a été fixé le chemin de l'homme(1) programme est tenté d'en déterminer un.

* Si cela ne fonctionne pas, un chemin par défaut raisonnable à partir de $ CHEMIN est déterminé.

Nous avons maintenant un ensemble de répertoires de départ. La première façon de changer cet ensemble est d'ajouter
noms de d'exploitation les systèmes. Cela suppose que man pages pour plusieurs d'exploitation les systèmes sommes-nous
installée. Ce n'est pas toujours vrai. Les noms de tels d'exploitation les systèmes peut être fourni
par 3 méthodes.

* La variable d'environnement SYSTÈME $ a la priorité la plus basse.

* Ceci peut être remplacé par une option dans $MANOPTER.

* Ceci est à nouveau remplacé par l'option de ligne de commande --systèmes.

Plusieurs noms de d'exploitation les systèmes peuvent être donnés en ajoutant leurs noms, séparés par un
virgule.

Le manuel de formation man chemin est modifié en ajoutant chaque Système nom comme sous-répertoire à la fin de chaque
répertoire de l'ensemble. Pas d'annuaire du man chemin l'ensemble est conservé. Mais si non Système nom est
a précisé le man chemin reste inchangé.

Après cela, l'ensemble réel de répertoires peut être modifié en langue informations. Cette
suppose qu'il existe man pages dans différentes langues. The Wanted langue peuvent être
choisi par plusieurs méthodes.

* Variable d'environnement $LANG.

* Ceci est remplacé par $LC_MESSAGES.

* Ceci est remplacé par $LC_ALL.

* Ceci peut être annulé en fournissant une option dans $MANOPTER.

* Toutes ces variables d'environnement sont remplacées par l'option de ligne de commande --lieu.

Le manuel de formation défaut langue peut être spécifié en spécifiant l'un des paramètres de pseudo-langage
C ou POSIX. C'est comme supprimer un ancien langue information. le man pages
dans le défaut langue sont généralement en anglais.

Bien sûr, la langue le nom est déterminé par man. Dans GNU man, il est précisé dans le
Format basé sur POSIX 1003.1 :

[_[.[,]]],

mais le code à deux lettres dans est suffisant dans la plupart des cas. Si pour un
compliqué langue formulation non man pages sont trouvés greffier recherche la partie pays
composé également de ces deux premiers personnages.

L'ensemble de répertoires réel est copié trois fois. Les langue le nom est ajouté comme sous-répertoire
à chaque répertoire dans la première copie de l'ensemble de répertoires réel (cela n'est fait que lorsqu'un
des informations sur la langue sont fournies). Ensuite, l'abréviation à 2 lettres du langue nom est
ajouté en tant que sous-répertoires à la deuxième copie de l'ensemble de répertoires (cela n'est fait que lorsque
le nom de la langue donnée a plus de 2 lettres). La troisième copie de l'ensemble de répertoires est
maintenu inchangé (si non langue l'information est donnée, il s'agit de l'ensemble de répertoires conservé).
Ces 3 copies au maximum sont ajoutées pour obtenir le nouvel ensemble de répertoires.

Nous avons maintenant un ensemble complet de répertoires avec lesquels travailler. Dans chacun de ces répertoires, le
man les fichiers sont séparés dans les sections. Le nom d'un est représenté par un seul
caractère, un chiffre entre 1 et 9, ou le personnage o or n, dans cet ordre.

Pour chaque disponible , un sous-répertoire man existe contenant tous man fichiers
pour ça , Où est un caractère unique comme décrit précédemment. Chaque man
déposer dans un répertoire a la forme
man/.[ ][.], Où et
sont optionnels. est le nom de la man page qui est également spécifié comme
argument filespec sur la ligne de commande.

Le manuel de formation l'extension de est un ajout à la section. Ce suffixe agit comme une sous-section. Un
l'extension de apparaît uniquement dans le nom du fichier, pas dans le nom du sous-répertoire. Ça peut
être spécifié sur la ligne de commande.

D'autre part, l' compression est juste une information sur la façon dont le fichier est compressé.
Ceci n'est pas important pour l'utilisateur, de sorte qu'il ne peut pas être spécifié sur la ligne de commande.

Il existe 4 méthodes pour spécifier un sur la ligne de commande :

* Variable d'environnement $MANSECTE

* Option de ligne de commande --sections

* Annexe au prénom argument sous la forme .

* Préargumentation devant le prénom argument sous la forme

Il est également possible de spécifier plusieurs les sections en ajoutant les caractères simples
séparés par des deux points. On peut imaginer que cela signifie restreindre la man page rechercher
seulement quelques les sections. Le multiple les sections ne sont possibles que pour $MANSECTE et --sections.

Sinon est spécifié tout les sections sont recherchés les uns après les autres dans le
commande, en commençant par 1, jusqu'à ce qu'un fichier approprié soit trouvé.

Il existe 4 méthodes pour spécifier un l'extension de sur la ligne de commande. Mais ce n'est pas nécessaire
pour fournir le nom complet de l'extension, une abréviation suffit dans la plupart des cas.

* Variable d'environnement $PROLONGATION

* Option de ligne de commande --extension

* Annexe au . argument sous la forme .

* Préargumentation devant le prénom argument sous la forme

Pour plus de détails sur man page chercher, voir man (1).

Exemples of man fichiers
/usr/share/man/man1/groff.1
Il s'agit d'un fichier non compressé pour le man page groff dans 1. Il peut être appelé
by
merde # groffeur groff
Non est spécifié ici, donc tout les sections doit être recherché, mais comme 1
est recherché en premier, ce fichier sera trouvé en premier. Le nom du fichier est composé du
composants suivants. / usr / share / man / doit faire partie du man chemin; la
sous-répertoire homme1/ et la partie .1 représenter le ; groff est le nom de la
man page.

/usr/local/share/man/man7/groff.7.gz
Le nom de fichier est composé des éléments suivants. /usr/local/share/man doit
faire partie de la man chemin; le sous-répertoire homme7/ et la partie .7 représenter le
; groff est le nom de la man page; la partie finale .gz représente un
compression avec gzip(1). Comme le n'est pas le premier il faut le préciser
également. Cela peut être fait par l'une des commandes suivantes.
merde # groff groff.7
merde # groffer 7 groffer
merde # groffer --sections=7 groffer

/usr/local/man/man1/ctags.1emacs21.bz2
Ici / usr / local / man doit être dans man chemin; le sous-répertoire homme1/ et le nom du fichier
partie .1 représenter 1; le nom du man page is balises c; la section a un
l'extension de emacs21; et le fichier est compressé comme . Bz2 avec bzip2(1). Le fichier peut
être visualisé avec l'une des commandes suivantes
merde # groffer ctags.1e
merde # groffer 1e ctags
merde # groffer --extension=e --sections=1 balises ctags
où e sert d'abréviation pour l'extension emacs21.

/usr/man/linux/de/man7/man.7.Z
Le répertoire / usr / man fait désormais partie de la man chemin; alors il y a un sous-répertoire
pour un d'exploitation Système prénom Linux/; vient ensuite un sous-répertoire de / pour l'allemand
langue; la noms man7 et .7 sont connus à ce jour ; man est le nom de la
man pageEt .Z signifie la compression qui peut être gérée par gzip(1). Nous voulons
montrez maintenant comment fournir plusieurs valeurs pour certaines options. C'est possible pour
les sections et d'exploitation Système noms. Nous utilisons donc comme les sections 5 et 7 et que Système
noms linux et aix. La commande est alors

merde # groffer --locale=de --sections=5:7 --systems=linux,aix man
merde # LANG=de MANSECT=5:7 SYSTEM=linux,aix groffer man

DÉCOMPRESSION

Le programme dispose d'une installation de décompression. Si entrée standard ou fichier récupéré
à partir des paramètres de la ligne de commande est compressé avec un format pris en charge par
gzip(1) ou bzip2(1) il est décompressé à la volée. Cela inclut le GNU .gz, . Bz2et
le traditionnel .Z compression. Le programme affiche la concaténation de tous
entrée décompressée dans l'ordre qui a été spécifié sur la ligne de commande.

ENVIRONNEMENT

Le manuel de formation greffier programme prend en charge de nombreuses variables système, la plupart grâce à d'autres
programmes. Toutes les variables d'environnement de groff(1) et GNU man(1) et un système standard
les variables sont respectées.

Originaire greffier Variables
$GROFFER_OPT
Options de stockage pour une série de greffier. Les options spécifiées dans cette variable sont
remplacé par les options données sur la ligne de commande. Le contenu de cette variable
est exécuté via le shell intégré `eval' ; donc les arguments contenant un espace ou
les caractères spéciaux du shell doivent être entre guillemets. N'oubliez pas d'exporter cette variable,
sinon il n'existe pas pendant l'exécution de greffier.

Système Variables
Les variables suivantes ont une signification particulière pour greffier.

$AFFICHAGE
Si cette variable est définie, cela indique que le système X Window est en cours d'exécution.
Le test de cette variable détermine si une sortie graphique ou textuelle est générée.
Cette variable ne doit pas être modifiée par l'utilisateur avec négligence, mais elle peut être utilisée pour
lancer le graphique greffier sur un terminal X Window distant. Par exemple, selon
sur votre système, greffier peut être démarré sur le deuxième moniteur par la commande

merde # DISPLAY=:0.1 groffer what.ever &

$LC_ALL
$LC_MESSAGES
$LANG Si l'une de ces variables est définie (dans la séquence ci-dessus), son contenu est
interprété comme la locale, la langue à utiliser, en particulier lors de la récupération
man pages. Un nom de paramètre régional est généralement de la forme
langue[_territoire[.jeu de codes[@modificateur]]], où langue est un langage ISO 639
code, territoire est un code de pays ISO 3166, et jeu de codes est un jeu de caractères ou
identifiant de codage comme ISO-8859-1 ou UTF-8 ; voir définirlocale(3). Les valeurs locales
C et POSIX représentent la valeur par défaut, c'est-à-dire le man page répertoires sans langue
préfixe. C'est le même comportement que lorsque les 3 variables sont désactivées.

$PAGER Cette variable peut être utilisée pour définir le pager pour la sortie tty. Par exemple, pour
désactiver complètement l'utilisation d'un pager mettre cette variable à la valeur cat(1) programme

merde # PAGER=chat groffer n'importe quoi

$ CHEMIN Tous les programmes au sein de la greffier script sont appelés sans chemin fixe. Ainsi ce
La variable d'environnement détermine l'ensemble des programmes utilisés dans l'exécution de greffier.

Groff Variables
Le manuel de formation greffier programmer les appels internes groff, donc toutes les variables d'environnement documentées dans
groff(1) sont utilisés en interne dans greffier également. La variable suivante a une relation directe
sens pour le greffier .

$GROFF_TMPDIR
Si la valeur de cette variable est un répertoire existant accessible en écriture, greffier l'utilise
pour stocker ses fichiers temporaires, tout comme groff Est-ce que. Voir le groff(1) page de manuel pour
plus de détails sur l'emplacement des fichiers temporaires.

Homme Variables
Une partie de la fonctionnalité du man programme ont été mis en œuvre dans greffier; soutien à tous
variables d'environnement documentées dans man(1) a été ajouté à greffier, mais le sens était
légèrement modifié en raison de l'approche différente dans greffier; mais l'interface utilisateur est le
même. Les man les variables d'environnement peuvent être écrasées par les options fournies avec $MANOPTER,
qui à son tour est écrasé par la ligne de commande.

$PROLONGATION
Restreindre la recherche de man pages aux fichiers ayant cette extension. C'est
outrepassé par l'option --extension; voir là pour plus de détails.

$MANOPTER
Cette variable contient des options en tant que préréglage pour man(1). Comme tous ne sont pas
pertinente pour greffier seules les parties essentielles de sa valeur sont extraites. Les
les options spécifiées dans cette variable écrasent les valeurs de l'autre environnement
des variables spécifiques à man. Toutes les options spécifiées dans cette variable sont
remplacé par les options données sur la ligne de commande.

$ CHEMIN MANUEL
Si elle est définie, cette variable contient les répertoires dans lesquels le man page les arbres sont
stocké. Ceci est remplacé par l'option --manpath.

$MANSECTE
S'il s'agit d'une liste de noms de sections séparés par deux points, la recherche de man pages is
limité à ces sections du manuel dans cet ordre. Ceci est remplacé par l'option
--sections.

SYSTÈME $
Si cela est défini sur une liste de noms séparés par des virgules, ceux-ci sont interprétés comme man page
arborescences pour différents systèmes d'exploitation. Cette variable peut être écrasée par l'option
--systèmes; voir là pour plus de détails.

La variable d'environnement $MANROFFSEQ est ignoré par greffier parce que le nécessaire
les préprocesseurs sont déterminés automatiquement.

CONFIGURATION DES DOSSIERS

Le manuel de formation greffier programme peut être préconfiguré par deux fichiers de configuration.

/etc/groff/groffer.conf
Fichier de configuration à l'échelle du système pour greffier.

$HOME/.groff/groffer.conf
Fichier de configuration spécifique à l'utilisateur pour greffier, Où $ ACCUEIL désigne le domicile de l'utilisateur
annuaire. Ce fichier est appelé après le fichier de configuration à l'échelle du système pour activer
contournement par l'utilisateur.

Les deux fichiers sont gérés pour la configuration, mais le fichier de configuration dans / Etc vient
premier; il est écrasé par le fichier de configuration dans le répertoire home ; les deux
les fichiers de configuration sont écrasés par la variable d'environnement $GROFFER_OPT; tout
est écrasé par les arguments de la ligne de commande.

Les fichiers de configuration contiennent des options qui doivent être appelées par défaut pour chaque greffier
Cours. Ces options sont écrites en lignes telles que chacune contient soit une option longue, une
option courte, ou un cluster d'options courtes ; chacun avec ou sans argument. Donc chaque ligne
avec les informations de configuration commence par un caractère moins `-'; une ligne avec un long
l'option commence par deux caractères moins `--', une ligne avec une option courte ou une option courte
le cluster commence par un seul moins `-'.

Les noms d'options dans les fichiers de configuration ne peuvent pas être abrégés, ils doivent être exacts.

L'argument d'une option longue peut être séparé du nom de l'option soit par une valeur égale
signe `=' ou par un espace, c'est-à-dire un ou plusieurs caractères espace ou tabulation. Un argument pour un
l'option courte ou le groupe d'options courtes peuvent être directement ajoutés au nom de l'option ou
séparés par des espaces. La fin d'un argument est la fin de la ligne. Ce n'est pas
autorisé à utiliser une variable d'environnement shell dans un nom d'option ou un argument.

Il n'est pas nécessaire d'utiliser des guillemets dans une option ou un argument, sauf pour les arguments vides.
Un argument vide peut être fourni en ajoutant une paire de guillemets à l'égal de séparation
signe ou espace ; avec une option courte, le séparateur peut également être omis. Pour un long
option avec un signe égal séparateur `=', la paire de guillemets peut être omise, se terminant ainsi
la ligne avec le signe égal de séparation. Tous les autres caractères de citation sont annulés
intérieurement.

Dans les fichiers de configuration, des espaces arbitraires sont autorisés au début de chaque ligne,
il est simplement ignoré. Chaque espace dans une ligne est remplacé par un seul caractère d'espacement
` ' en interne.

Toutes les lignes des lignes de configuration qui ne commencent pas par un caractère moins sont ignorées,
tels que les commentaires commençant par `#' sont possibles. Il n'y a donc pas de commandes shell dans le
fichiers de configuration.

A titre d'exemple, considérons le fichier de configuration suivant qui peut être utilisé soit dans
/etc/groff/groffer.conf or ~/.groff/groffer.conf .

# fichier de configuration de Groffer
#
# options de groffer utilisées dans chaque appel de groffer
--foreground=Bleu Foncé
--résolution=100
--viewer=gxditview -géométrie 900x1200
--viewer xpdf -Z 150

Les lignes commençant par # sont simplement ignorés, ils agissent donc comme des lignes de commande. Cette
ensembles de configuration quatre greffier options (les lignes commençant par `-'). Cela a le
effets suivants :

* Utilisez une couleur de texte de Bleu foncé chez tous les téléspectateurs qui soutiennent cela, comme gxditview.

* Utilisez une résolution de 100dpi chez tous les téléspectateurs qui soutiennent cela, comme gxditview. par
ceci, le périphérique par défaut dans x mode est fixé à X100.

* Obliger gxditview(1) comme mode x visionneuse utilisant l'option de géométrie pour définir la largeur
à 900px et la hauteur à 1200px. Cette géométrie convient pour une résolution de
100dpi.

* Utilisation xpdf(1) comme mode pdf spectateur avec l'argument -Z 150.

EXEMPLES

L'utilisation de greffier C'est très facile. Habituellement, il est simplement appelé avec un nom de fichier ou
man page. Les exemples suivants montrent cependant que greffier a beaucoup plus de fantaisie
capacités.

merde # groffer /usr/local/share/doc/groff/meintro.ms.gz

Décompresser, formater et afficher le fichier compressé meintro.ms.gz dans l'annuaire
/usr/local/share/doc/groff, à l'aide de la visionneuse standard gxditview comme visualiseur graphique lorsque
dans X Window, ou le moins(1) programme de pager lorsqu'il n'est pas dans X Window.

merde # groffeur groff

Si le fichier ./groff existe l'utiliser comme entrée. Sinon interpréter l'argument comme une recherche
pour man page nommé groff dans le plus petit possible man , étant la section 1 dans ce
Cas.

merde # homme groffer:groff

rechercher le man page of groff même lorsque le fichier ./groff existe.

merde # groff groff.7
merde # groffer 7 groffer

cherche le man page of groff in man 7. Cette recherche de section ne fonctionne que pour un chiffre
ou un seul personnage d'un petit ensemble.

merde # groffer fb.modes

Si le fichier ./fb.modes n'existe pas interpréter cela comme une recherche du man page of
fb.modes. Comme le prolongement modes n'est pas un seul personnage dans le style de section classique le
l'argument n'est pas divisé en une recherche de fb.

merde # groffer groff'trof(1)' homme:roff

Les arguments qui ne sont pas des fichiers existants sont recherchés comme suit man pages: groff
(recherche automatique, doit être trouvée dans man rubrique 1), trof (dans la section 1), et roff (en
la section avec le numéro le plus bas, étant 7 dans ce cas). Les citations autour »trof(dix)'
sont nécessaires car les parenthèses sont des caractères shell spéciaux ; leur échapper avec un
caractère barre oblique inverse \( et \) serait possible aussi. Les fichiers formatés sont
concaténés et affichés en un seul morceau.

merde # LANG=de groffer --man --viewer=galeon ls

Récupérer l'allemand man page (Langue de) pour le ls programme, décompressez-le, formatez-le en
html format (www mode) et afficher le résultat dans le navigateur Web galeon. L'option --homme
garantit que le man page est récupéré, même lorsqu'un fichier local ls existe dans le réel
répertoire.

merde # groffer --source 'man :roff(7)'

Obtenez les man page appelé roff in man section 7, décompressez-le et imprimez-le non formaté
contenu, son code source.

merde # groffer --de-p --in --ap

C'est un ensemble d'arguments abrégés, il est déterminé comme

merde # groffer --debug-params --sortie-intermédiaire --apropos

merde # fichier de chat.gz | groffer -Z -mfoo

Le fichier fichier.gz est envoyé à l'entrée standard, c'est décompressé, puis c'est
transporté vers le groff intermédiaire sortie mode sans post-traitement (groff option
-Z), en utilisant le package de macros foo (groff option -m).

merde # echo '\f[CB]WOW !' |
> groffer --x --bg rouge --fg jaune --géométrie 200x100 -

Afficher le mot WOW! dans une petite fenêtre en caractères gras à largeur constante, en utilisant la couleur jaune sur
fond rouge.

COMPATIBILITÉ

Le manuel de formation greffier programme est écrit en Perl, la version Perl lors de l'écriture était la v5.8.8.

greffier fournit son propre analyseur pour les arguments de ligne de commande qui est compatible à la fois
POSIX getops(1) et GNU obtenir(1). Il peut gérer les arguments d'option et les noms de fichiers
contenant des espaces et un grand nombre de caractères spéciaux. La norme suivante
types d'options sont pris en charge.

* L'option consistant en un seul moins - fait référence à l'entrée standard.

* Un seul moins suivi de caractères fait référence à une option à un seul caractère ou à un
combinaison de ceux-ci; par exemple, le greffier combinaison d'options courte -Qmfoo is
équivalente à -Q -m foo.

* Les options longues sont des options avec des noms plus longs qu'un caractère ; ils sont toujours précédés
par un double moins. Un argument d'option peut soit aller à l'argument de ligne de commande suivant
ou être ajouté avec un signe égal à l'argument ; par exemple, --long=argument est équivalent
à --longue arg.

* Un argument de -- termine l'analyse des options ; tous les autres arguments de ligne de commande sont
interprété comme spécif_fichier paramètres, c'est-à-dire noms de fichiers ou constructions pour la recherche
man pages).

* Tous les arguments de ligne de commande qui ne sont ni des options ni des arguments d'option sont interprétés
as spécif_fichier paramètres et stockés jusqu'à la fin de l'analyse des options. Par exemple, le
ligne de commande

merde # groffer fichier1 -a -o arg fichier2

équivaut à

merde # groffer -a -o arg -- fichier1 fichier2

Le mélange libre d'options et spécif_fichier paramètres suit le principe GNU. ça fait
ne remplit pas le comportement étrange des options de POSIX qui met fin au traitement des options dès que
le premier argument non optionnel a été atteint. La fin du traitement des options peut être
forcé par l'option `--' De toute façon.

Utilisez groffer en ligne en utilisant les services onworks.net