Este es el comando manlifter que se puede ejecutar en el proveedor de alojamiento gratuito de OnWorks utilizando una de nuestras múltiples estaciones de trabajo en línea gratuitas, como Ubuntu Online, Fedora Online, emulador en línea de Windows o emulador en línea de MAC OS.
PROGRAMA:
NOMBRE
manlifter: secuencia de comandos de conversión masiva y arnés de prueba para doclifter
SINOPSIS
levantador de hombres [-D opción] [-e] [-f archivo de lista] [-Hola mandir] [-m] [-M] [-o exterior]
[-pag directorio-parche] [-P] [-q] [-v] [-s .] [-X excluir] nombre ...
levantador de hombres [-S]
DESCRIPCIÓN
levantador de hombres es un guión que secuencia levantador de documentos(1) para convertir un árbol completo de páginas de manual a
XML-Docbook, opcionalmente también genera HTML a partir del XML. Otro uso es como
herramienta de prueba de tortura para doclifter; registra errores en la salida estándar y recopila tiempos.
Llamado sin ningún argumento de archivo, manlifter intenta convertir todas las páginas de manual elegibles
instalado en el sistema, colocando los archivos xml resultantes en xmlman en el actual
directorio. Cada página traducida correctamente foo.N se copia en manN / foo.xml debajo del
directorio de salida, independientemente del directorio de origen del que provenga.
Una página de manual no se considera elegible para la conversión por lotes si contiene texto que indica
se ha generado a partir de maestros de DocBook o de Doxygen.
Para cada archivo de origen examinado, si el archivo de destino existe y es más nuevo que el
fuente, se omite la conversión; por lo tanto, ejecuciones incrementales de levantador de hombres hacer el menor trabajo
necesario para mantener actualizado el árbol XML de destino. Asimismo, los archivos HTML derivados en modo -h son
solo se hace cuando es necesario.
Páginas de resguardo que son solo .asi que las redirecciones se traducen a los correspondientes enlaces simbólicos de XML
archivos (y, con -h, archivos HTML).
levantador de hombres también se puede llamar con un único argumento de archivo, que se interpreta como la raíz
nombre de una página de manual potencial. levantador de hombres luego busca en todas las secciones del manual seleccionadas
una página coincidente e intenta convertirla. En este caso, una copia de la página de manual y la
La versión convertida se coloca inmediatamente debajo del directorio de salida, con los nombres
foobar.man y foobar.man.xml, respectivamente. Este modo normalmente solo es de interés
a levantador de documentos desarrolladores para depurar ese programa.
En cualquiera de los casos anteriores, levantador de hombres descomprimirá el archivo si tiene un .gz, .bz2 o
.Z sufijo en el nombre.
Las opciones son las siguientes:
-d
Pase el argumento de cadena a cada llamada de doclifter como opciones. Cada ficha separada por espacios
en la cadena se convierte en un argumento separado en la llamada.
-e
Ejecutar en modo de filtro de registro (principalmente de interés para levantador de documentos desarrolladores). En este modo,
levantador de hombres lee un registro de prueba de la entrada estándar y lo filtra de una manera que depende de
las opciones -f y -q. Si no se proporciona ninguno de estos, los mensajes de ejecuciones exitosas se
eliminado y solo los errores pasaron a la salida estándar.
-f
Normalmente, ejecute doclifter en los archivos nombrados por cada línea en el archivo de argumentos. En
modo de filtro de errores, el argumento se interpreta en cambio como un filtro regular
expresión.
-h
También genere traducciones HTML en el directorio de salida. Marcado de citerefentry de DocBook
se transforma en hipervínculos en el directorio y se genera una lista de contenido para
índice.html.
-I
Especifique la raíz del árbol de la página del manual. De forma predeterminada, es / usr / share / man.
-m
Haga un parche para corregir la última página recuperada. Se copia, se llama a un editor
la copia (usando la variable de entorno $ EDITOR), y entonces diff(1) está llamado a abandonar
el parche en el directorio de prepatch. Falla con un error si dicho parche ya está
presente.
-M
Levante los archivos especificados, luego haga el equivalente a la opción -m.
-o
Establezca el directorio de salida en el que se colocarán las traducciones de XML-DocBook. Por
predeterminado es xmlman en el directorio actual en modo por lotes, o el actual
directorio de lo contrario.
-p
Interprete el argumento como el nombre de un directorio de parches (el nombre predeterminado es prepatch
bajo el directorio actual). Cada archivo llamado foo.N.patch se interpreta como un parche para
aplicarse a la página del manual foo (N) antes de que doclifter la traduzca.
-P
Habilite la creación de perfiles utilizando el módulo de referencia de Python; esto solo es útil para afinar
doclifter para que se ejecute más rápido. Los datos brutos se escriben en manlifter.prof, y un digerido
El informe se adjunta al registro en la salida estándar. Advertencia: los archivos de datos sin procesar pueden
llegar a ser enorme, y el posprocesamiento para la generación de informes puede llevar tanto tiempo como el
procesamiento real (¡o más!).
-q
Normalmente, pase la opción -q (silencioso) a cada llamada de doclifter. En modo de filtro de errores,
devuelve una lista de archivos en los que falló la traducción.
-v
Pase la opción -v (detallado) a cada llamada de doclifter. Esta opción se puede repetir para
aumentar el nivel de verbosidad.
-s
Especifique una sección para escanear. Use esto con un argumento; no debería ser necesario cuando
haciendo una conversión de todo el árbol.
-S
Compile estadísticas de error de un levantador de hombres archivo de registro presentado en la entrada estándar. Esta
La opción será de interés principalmente para levantador de documentos desarrolladores.
-X
En el modo por lotes, excluya las páginas enumeradas en el archivo de argumentos. Diseñado para usarse en páginas
que se conocen bien y que toman un tiempo extremadamente largo para levantar, con el fin de reducir el
tiempo para una prueba de funcionamiento. (La mayoría de las páginas se levantan en menos de medio segundo, pero algunas pueden tardar
15 minutos o más.)
levantador de hombres emite un archivo de registro a la salida estándar. El archivo comienza con una línea de marca de tiempo y una
línea en blanco y termina con una línea que indica el tiempo de ejecución y varias estadísticas interesantes.
Entre estas hay estrofas, separadas por líneas en blanco, una para cada archivo en el que levantador de documentos
fue corrido.
La primera línea de cada estrofa comienza con "!", Seguida del nombre de la ruta de la fuente
pager manual, seguido de "=" y el estado de retorno de doclifter ejecutado en ese archivo.
Después de eso hay un espacio y levantador de documentosTiempo de ejecución en segundos.
Esta línea inicial puede ir seguida de mensajes de información y la salida de error del
Doclifter Run.
levantador de hombres debe encontrar una copia de levantador de documentos en el directorio actual o en uno de los
directorios de comandos en tu TRAYECTORIA para poder correr.
Use manlifter en línea usando los servicios de onworks.net
