Il s'agit de la commande lexgrog qui peut être exécutée dans le fournisseur d'hébergement gratuit OnWorks en utilisant l'un de nos multiples postes de travail en ligne gratuits tels que Ubuntu Online, Fedora Online, l'émulateur en ligne Windows ou l'émulateur en ligne MAC OS
PROGRAMME:
Nom
lexgrog - analyse les informations d'en-tête dans les pages de manuel
SYNOPSIS
lexgrog [-m|-c] [-dfw?V] [-E codage] filet
DESCRIPTION
lexgrog est une implémentation de l'utilitaire traditionnel « groff deviner » dans lex. Ça lit
la liste des fichiers sur sa ligne de commande en tant que fichiers source de la page de manuel ou préformatés
pages « chat » et affiche leur nom et leur description tels qu'utilisés par à propos ainsi que quel est,
liste des filtres de prétraitement requis par la page de manuel avant qu'elle ne soit transmise à nroff or
trof, ou les deux.
Si son entrée est mal formatée, lexgrog affichera « parse failed » ; cela peut être utile pour
programmes externes qui doivent vérifier l'exactitude des pages de manuel. Si l'un des lexgrogentrée de
files est « - », il sera lu à partir de l'entrée standard ; si un fichier d'entrée est compressé, un
la version décompressée sera lue automatiquement.
OPTIONS
-d, --déboguer
Imprimer les informations de débogage.
-m, --homme
Analyser l'entrée en tant que fichiers source de la page de manuel. C'est la valeur par défaut si ni l'un ni l'autre --homme ni
--chat est donné.
-c, --chat
Analysez l'entrée en tant que pages de manuel préformatées (« pages de chat »). --homme ainsi que --chat n'est peut être pas
donné simultanément.
-w, --quel est
Afficher le nom et la description de l'en-tête de la page de manuel, tels qu'utilisés par à propos ainsi que
quel est. C'est la valeur par défaut si ni l'un ni l'autre --quel est ni --filtres est donné.
-f, --filtres
Afficher la liste des filtres nécessaires pour prétraiter la page de manuel avant le formatage
avec nroff or trof.
-E codage, --codage codage
Remplacer le jeu de caractères deviné pour la page à codage.
-?, --Aidez-moi
Imprimez un message d'aide et quittez.
--usage
Imprimez un court message d'utilisation et quittez.
-V, --version
Afficher les informations de version.
EXIT STATUT
0 Exécution réussie du programme.
1 Erreur d'utilisation.
2 lexgrog n'a pas réussi à analyser un ou plusieurs de ses fichiers d'entrée.
EXEMPLES
$ lexgrog homme.1
man.1 : "man - une interface vers les manuels de référence en ligne"
$ lexgrog -fw homme.1
man.1 (t): "man - une interface vers les manuels de référence en ligne"
$ lexgrog -c quoi.cat1
whatis.cat1: "whatis - afficher les descriptions des pages de manuel"
$ lexgrog cassé.1
Broken.1 : l'analyse a échoué
QUEL EST PARSAGE
mandb (qui utilise le même code que lexgrog) analyse le Nom section en haut de chaque
page de manuel recherchant les noms et les descriptions des fonctionnalités documentées dans chacun. Tandis que
l'analyseur est assez tolérant, car il doit faire face à un certain nombre de formes différentes qui ont
historiquement été utilisé, il peut parfois échouer à extraire les informations requises.
Lors de l'utilisation du traditionnel man ensemble de macros, un correct Nom la section ressemble à quelque chose comme
ce:
.SH NOM
foo \- programme pour faire quelque chose
Certains téléavertisseurs manuels nécessitent que le « \- » soit exactement comme indiqué ; mandb est plus tolérant, mais
pour la compatibilité avec d'autres systèmes, il est néanmoins judicieux de conserver le
barre oblique inverse.
Sur le côté gauche, il peut y avoir plusieurs noms, séparés par des virgules. Noms contenant
les espaces seront ignorés pour éviter un comportement pathologique sur certains mal formés Nom
sections. Le texte de droite est de forme libre et peut s'étendre sur plusieurs
lignes. Si plusieurs fonctionnalités avec des descriptions différentes sont documentées dans le même
page de manuel, la forme suivante est donc utilisée :
.SH NOM
foo, bar \- programmes pour faire quelque chose
.br
baz \- programme pour ne rien faire
(Une macro qui commence un nouveau paragraphe, comme .PP, peut être utilisée à la place de la macro break
.br.)
Lors de l'utilisation de la version dérivée de BSD mdoc ensemble de macros, un correct Nom la section ressemble à quelque chose comme
ce:
.Sh NOM
.Nm foo
.Nd programme pour faire quelque chose
Il existe plusieurs raisons courantes pour lesquelles l'analyse de whatis échoue. Parfois auteurs de manuels
pages remplacent '.SH NAME' par '.SH MYPROGRAM', puis mandb impossible de trouver la section de
pour extraire les informations dont il a besoin. Parfois, les auteurs incluent une section NAME, mais
placez-y du texte de forme libre plutôt que 'nom \- description'. Cependant, toute syntaxe
ressemblant à ce qui précède doit être accepté.
Utiliser lexgrog en ligne en utilisant les services onworks.net
