manlifter - En ligne dans le Cloud

PROGRAMME:

Nom

manlifter - script de conversion de masse et harnais de test pour doclifter

SYNOPSIS

homme de levage [-ré option] [-e] [-f fichier de liste] [-salut Mandir] [-m] [-M] [-o extérieur]
[-p répertoire-patch] [-P] [-q] [-v] [-s ] [-X exclure] prénom

homme de levage [-S]

DESCRIPTION

homme de levage est un script qui séquence doclifteur(1) pour convertir une arborescence de pages de manuel entière en
XML-Docbook, générant éventuellement également du HTML à partir du XML. Une autre utilisation est comme un
outil de test de torture pour doclifter; il enregistre les erreurs sur la sortie standard et collecte les minutages.

Appelé sans aucun argument de fichier, manlifter essaie de convertir toutes les pages de manuel éligibles
installé sur le système, en plaçant les fichiers XML résultants sous xmlman dans le
annuaire. Chaque page foo.N traduite avec succès est copiée dans manN/foo.xml sous le
répertoire de sortie, quel que soit le répertoire source d'où il provient.

Une page de manuel est considérée comme inéligible pour la conversion par lots si elle contient du texte indiquant
il a été généré à partir des maîtres DocBook de Doxygen.

Pour chaque fichier source examiné, si le fichier de destination existe et est plus récent que le
source, la conversion est ignorée ; ainsi, des exécutions incrémentielles de homme de levage faire le moins de travail
nécessaire pour maintenir à jour l'arborescence XML cible. De même, en mode -h, les fichiers HTML dérivés sont
fait uniquement lorsque cela est nécessaire.

Les pages de talon qui sont juste .so les redirections sont traduites en liens symboliques correspondants de XML
(et, avec -h, les fichiers HTML).

homme de levage peut également être appelé avec un seul argument de fichier, qui est interprété comme la racine
nom d'une page de manuel potentielle. homme de levage recherche ensuite toutes les sections du manuel sélectionnées pour
une page correspondante et tente de la convertir. Dans ce cas, une copie de la page de manuel et du
la version convertie est supprimée immédiatement dans le répertoire de sortie, avec les noms
foobar.man et foobar.man.xml, respectivement. Ce mode n'a normalement d'intérêt que
à doclifteur développeurs pour le débogage de ce programme.

Dans l'un ou l'autre des cas ci-dessus, homme de levage décompressera le fichier s'il a un .gz, .bz2 ou
Suffixe .Z sur le nom.

Les options sont les suivantes:

-d
Passez l'argument de chaîne à chaque appel doclifter en tant qu'options. Chaque jeton séparé par un espace
dans la chaîne devient un argument distinct dans l'appel.

-e
Exécuter en mode filtre de journal (principalement d'intérêt pour doclifteur développeurs). Dans ce mode,
homme de levage lit un journal de test à partir de l'entrée standard et le filtre d'une manière dépendant de
les options -f et -q. Si aucun de ces éléments n'est donné, les messages des exécutions réussies sont
supprimé et seules les erreurs sont transmises à la sortie standard.

-f
Normalement, exécutez doclifter sur les fichiers nommés par chaque ligne du fichier d'arguments. Dans
mode filtre d'erreur, l'argument est plutôt interprété comme un filtre régulier
expression.

-h
Générez également des traductions HTML dans le répertoire de sortie. Balise DocBook citerefentry
est transformé en hyperliens dans le répertoire, et une liste de contenu est générée pour
index.html.

-I
Spécifiez la racine de l'arborescence des pages de manuel. Par défaut, il s'agit de /usr/share/man.

-m
Faites un patch pour corriger la dernière page récupérée. Il est copié, un éditeur est appelé
la copie (en utilisant la variable d'environnement $ EDITEUR), et alors diff(1) est appelé à abandonner
le patch dans le répertoire prepatch. Échoue avec une erreur si un tel correctif est déjà
présent.

-M
Soulevez les fichiers spécifiés, puis effectuez l'équivalent de l'option -m.

-o
Définissez le répertoire de sortie dans lequel les traductions XML-DocBook seront déposées. Par
par défaut, il s'agit de xmlman sous le répertoire actuel en mode batch, ou le
répertoire sinon.

-p
Interprétez l'argument comme le nom d'un répertoire de correctifs (le nom par défaut est prepatch
sous le répertoire courant). Chaque fichier nommé foo.N.patch est interprété comme un patch à
être appliqué à la page de manuel foo(N) avant que doclifter ne la traduise.

-P
Activer le profilage à l'aide du module Python hotshot ; ce n'est utile que pour le réglage
doclifter pour qu'il aille plus vite. Les données brutes sont écrites dans manlifter.prof, et un résumé
rapport est ajouté au journal sur la sortie standard. Attention : les fichiers de données brutes peuvent
deviennent énormes, et le post-traitement pour la génération de rapports peut prendre autant de temps que le
traitement réel (ou plus !).

-q
Normalement, transmettez l'option -q (quiet) à chaque appel doclifter. En mode filtre d'erreur,
renvoie une liste de fichiers sur lesquels la traduction a échoué.

-v
Transmettez l'option -v (verbose) à chaque appel doclifter. Cette option peut être répétée pour
augmenter le niveau de verbosité.

-s
Spécifiez une section à analyser. Utilisez ceci avec un argument ; cela ne devrait pas être nécessaire lorsque
faire une conversion de l'arbre entier.

-S
Compiler des statistiques d'erreurs à partir d'un homme de levage logfile présenté sur l'entrée standard. Cette
option intéressera principalement doclifteur les développeurs.

-X
En mode batch, excluez les pages répertoriées dans le fichier d'arguments. Destiné à être utilisé pour les pages
qui sont bien connus et prennent un temps extrêmement long à lever, afin de réduire le
temps pour un essai. (La plupart des pages se lèvent en moins d'une demi-seconde, mais quelques-unes peuvent prendre
15 minutes ou plus.)

homme de levage émet un fichier journal sur la sortie standard. Le fichier commence par une ligne d'horodatage et un
ligne vierge, et se termine par une ligne donnant le temps d'exécution et diverses statistiques intéressantes.
Entre celles-ci se trouvent des strophes, séparées par des lignes vierges, une pour chaque fichier sur lequel doclifteur
Était dirigé.

La première ligne de chaque strophe commence par "!", suivi du chemin d'accès de la source
pager manuel, suivi de "=" et de l'état de retour de doclifter exécuté sur ce fichier.
Après cela est un espace et doclifteur's runtime en secondes.

Cette première ligne peut être suivie de messages d'information et de la sortie d'erreur du
course doclifter.

homme de levage doit trouver une copie de doclifteur dans le répertoire courant ou dans l'un des
répertoires de commandes dans votre PATH pour courir.

Utiliser manlifter en ligne en utilisant les services onworks.net