Este es el comando lexgrog 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
lexgrog: analiza la información del encabezado en las páginas de manual
SINOPSIS
Lexgrog [-m|-c] [-dfw? V] [-E codificación] presentar ...
DESCRIPCIÓN
Lexgrog es una implementación de la utilidad tradicional "adivinar groff" en lex. Se lee
la lista de archivos en su línea de comando como archivos fuente de la página de manual o preformateados
Páginas de "gato", y muestra su nombre y descripción tal como lo utilizan a propósito y que es, la
lista de filtros de preprocesamiento requeridos por la página de manual antes de que se pase a nroff or
troff, o ambos.
Si su entrada está mal formateada, Lexgrog imprimirá "error de análisis"; esto puede ser útil para
programas externos que necesitan comprobar la corrección de las páginas de manual. Si uno de Lexgrogentrada de
archivos es "-", se leerá desde la entrada estándar; si algún archivo de entrada está comprimido,
La versión descomprimida se leerá automáticamente.
CAMPUS
-d, --depurar
Imprime información de depuración.
-m, --hombre
Analizar la entrada como archivos fuente de la página de manual. Este es el valor predeterminado si ninguno --hombre ni
--gato es dado.
-c, --gato
Analizar la entrada como páginas de manual preformateadas ("páginas cat"). --hombre y --gato puede no ser
dado simultáneamente.
-w, --que es
Muestra el nombre y la descripción del encabezado de la página de manual, tal como lo usa a propósito y
que es. Este es el valor predeterminado si ninguno --que es ni --filtros es dado.
-f, --filtros
Muestra la lista de filtros necesarios para preprocesar la página de manual antes de formatear
nroff or troff.
-E codificación, - codificación codificación
Anule el juego de caracteres adivinado para que la página codificación.
-?, --ayuda
Imprima un mensaje de ayuda y salga.
--uso
Imprima un mensaje de uso breve y salga.
-V, --versión
Muestra información sobre la versión.
SALIR ESTADO
0 Ejecución exitosa del programa.
1 Error de uso.
2 Lexgrog no pudo analizar uno o más de sus archivos de entrada.
EJEMPLOS
$ lexgrog hombre.1
man.1: "man - una interfaz para los manuales de referencia en línea"
$ lexgrog -fw hombre.1
man.1 (t): "man - una interfaz para los manuales de referencia en línea"
$ lexgrog -c whatis.cat1
whatis.cat1: "whatis - mostrar descripciones de la página del manual"
$ lexgrog roto.1
broken.1: error de análisis
QUE ES ANÁLISIS
mandb (que usa el mismo código que Lexgrog) analiza el NOMBRE sección en la parte superior de cada
página de manual en busca de nombres y descripciones de las características documentadas en cada uno. Tiempo
el analizador es bastante tolerante, ya que tiene que hacer frente a una serie de formas diferentes que tienen
históricamente utilizado, a veces puede fallar al extraer la información requerida.
Cuando se usa el tradicional hombre conjunto de macros, un correcto NOMBRE la sección se parece a
modo:
.SH NOMBRE
foo \ - programa para hacer algo
Algunos buscapersonas manuales requieren que '\ -' sea exactamente como se muestra; mandb es más tolerante, pero
No obstante, para compatibilidad con otros sistemas, es una buena idea conservar la
barra invertida.
En el lado izquierdo, puede haber varios nombres, separados por comas. Nombres que contienen
Se ignorarán los espacios en blanco para evitar un comportamiento patológico en ciertos NOMBRE
secciones. El texto del lado derecho es de forma libre y se puede distribuir en varios
líneas. Si se documentan varias funciones con descripciones diferentes en el mismo
página de manual, por lo tanto, se utiliza el siguiente formulario:
.SH NOMBRE
foo, bar \ - programas para hacer algo
. H.
baz \ - programa para no hacer nada
(Se puede usar una macro que comienza un nuevo párrafo, como .PP, en lugar de la macro de ruptura
.br.)
Cuando se utiliza el derivado de BSD mdoc conjunto de macros, un correcto NOMBRE la sección se parece a
modo:
.Sh NOMBRE
.Nm foo
.Nd programa para hacer algo
Hay varias razones comunes por las que falla el análisis. A veces, los autores del manual
las páginas reemplazan '.SH NAME' con '.SH MYPROGRAM', y luego mandb no puedo encontrar la sección de
que extraer la información que necesita. A veces, los autores incluyen una sección de NOMBRE, pero
coloque el texto de forma libre allí en lugar de 'nombre \ - descripción'. Sin embargo, cualquier sintaxis
similares a los anteriores deben ser aceptados.
Utilice lexgrog en línea utilizando los servicios de onworks.net
