.\" Man page for lexgrog .\" .\" Copyright (c) 2001 Colin Watson .\" .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file COPYING that comes with the .\" man-db distribution. .pc "" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH LEXGROG 1 2019-01-05 2.8.5 "Utilidades del paginador manual" .SH NOMBRE lexgrog \- interpreta información de cabecera en páginas man .SH SINOPSIS \fBlexgrog\fP [\|\fB\-m\fP\||\|\fB\-c\fP\|] [\|\fB\-dfw?V\fP\|] [\|\fB\-E\fP \fIcodificando\fP\|] \fIfichero\fP \&.\|.\|. .SH DESCRIPCIÓN \fBlexgrog\fP es una interpretación de la tradicional \(lqgroff guess\(rq utilidad en \fBlex\fP. Lee la lista de ficheros en su línea de órdenes o como fichero de origen de una página man o como \(lqcat\(rq páginas preformateadas, y enseña su nombre y descripción como se utilizó por \fBapropos\fP y \fBwhatis\fP, la lista de filtros preprocesados requeridos por la página man antes que sea pasada por \fBnroff\fP o \fBtroff\fP, o ambos. .PP Si esta entrada está formateado equivocadamente, \fBlexgrog\fP escribirá \(lqparse fallado\(rq; esta quizá sea útil para programas externos que requeirean comprobar páginas man para correcciones. Si uno de los ficheros de entrada de \fBlexgrog\fP es \(lq\-\(rq, leerá desde entrada comúnM si cualquier fichero entrante está comprimido, una versión descomprimida será se leerá automáticamente. .SH OPCIONES .TP .if !'po4a'hide' .BR \-d ", " \-\-debug Muestra información depurativa. .TP .if !'po4a'hide' .BR \-m ", " \-\-man Interreta entrada como fichero origen de página man. Esto es lo predefinido si ni \fB\-\-man\fP ni \fB\-\-cat\fP es dado. .TP .if !'po4a'hide' .BR \-c ", " \-\-cat Entrada interpretada como páginas (\(lqcat\(rq) man preformateada. \fB\-\-man\fP y \fB\-\-cat\fP quizá no son dadas simultáneamente. .TP .if !'po4a'hide' .BR \-w ", " \-\-whatis Enseña el nombre y descripción desde la cabecera de la página del man, tal emplado por \fBapropósito\fP y \fBqué es\fP. Esto es lo predeterminado si ni \fB\-\-watis\fP ni \fB\-\-filters\fP está dado. .TP .if !'po4a'hide' .BR \-f ", " \-\-filters Enseña la lista de filtros necesarios para preprocesar la página man antes de formatear con \fBnroff\fP o \fBtroff\fP. .TP \fB\-E\fP \fIcodificación\fP, \fB\-\-encoding\fP \fIcodificación\fP Sobrescribe el conjunto de caracteres deseado para la página a \fIcodificación\fP. .TP .if !'po4a'hide' .BR \-? ", " \-\-help Escribe un mensaje de ayuda y termina. .TP .if !'po4a'hide' .BR \-\-usage Escribe mensaje breve sobre uso del programa y termina. .TP .if !'po4a'hide' .BR \-V ", " \-\-version Enseña la versión de información. .SH "ESTADO DE SALIDA" .TP .if !'po4a'hide' .B 0 Ejecución del programa correcta. .TP .if !'po4a'hide' .B 1 Error de uso. .TP .if !'po4a'hide' .B 2 \fBlexgrog\fP falló al interpretar uno o más de ficheros entrantes. .SH EJEMPLOS .nf $ lexgrog man.1 man.1: «man \- un interfaz para manuales referenciados por conexión» $ lexgrog \-fw man.1 man.1 (t): «man \- un interfaz para manuales referenciados por conexión» $ lexgrog \-c whatis.cat1 whatis.cat1: «whatis \- enseña páginas descritas del manual» $ lexgrog broken.1 broken.1: interpretador fallado .fi .SH "INTERPRETACIÓN “WHATIS”" \fBmandb\fP (el cual emplea el mismo código que \fBlexgrog\fP interpreta la sección \fBNOMBRE\fP al techo de cada página del manual buscando nombres y descripciones de las características documentadas en cada una. Mientras el interprete está muy toletante, como tiene ocuparse con un número de formatos diferentes que tiene históricamente sido empleada, quizá algunas veces fallan al extraer la información requerida. .PP Cuando utilice la macro tradicional \fIman\fP, una sección correcta \fBNOMBRE\fP aparecerá algo como esto: .PP .RS .nf \f(CW\&.SH NOMBRE rellena \e\- programa para hacer algo\fP .fi .RE .PP Algunos paginadores manuales requieren la \(oq\e\-\(cq esté exactamente como muestran; \fBmandb\fP es más tolerante, pero para compatibilidad con otros sistemas no es una buena idea para retener la barra invertida. .PP En el lado izquierdo, quizá hay varios nombres, separados por comas. Los nombres conteniendo espacios en blanco serán ignorados para evitar comportamiento patológico en ciertos formatos de secciones \fBNOMBRE\fP. El texto en el lado derecho tiene formato libre, y quizá está desplegado por múltiples líneas. Si varias características con descripciones diferentes están siendo documentadas en la misma página del manual, el siguiente formato está ya utilizado: .PP .RS .nf \f(CW\&.SH NAME esto, aquello \e\- programas para hacer algo \&.br baz \e\- programa para no hacer nada\fP .fi .RE .PP (Una macro la cual inicia un parágrafo nuevo, como \f(CW.PP\fP, quizá está utilizado en lugar de ruptura de macro \f(CW.br\fP.) .PP Cuando utilice las derivaciones BSD el conjunto de macro \fImdoc\fP, un \fBNOMBRE\fP de sección correcto parece algo como esto: .PP .RS .nf \f(CW\&.Sh NOMBRE \&.Nm lo que sea \&.Nd programa para hacer algo\fP .fi .RE Hay distintas razones comunes por las que interpretaciones fallan. Algunas veces los autores de las páginas del manual sustituyen \(oq.SH NOMBRE\(cq por \(oq.SH MIPROGRAMA\(cq, y entonces \fBmandb\fP no puede encontrar la sección desde la cual extraer la información que necesita. Algunas veces los autores inclyen una sección NOMBRE, pero colocan texto de formato\-libre en lugar de \(oqname \e\- description\(cq. Sin embargo, cualquier sintaxis analizada encima debería ser aceptada. .SH "VEA ADEMÁS" .if !'po4a'hide' .IR apropos (1), .if !'po4a'hide' .IR man (1), .if !'po4a'hide' .IR whatis (1), .if !'po4a'hide' .IR mandb (8) .SH ANOTACIONES \fBlexgrog\fP intenta entender ficheros conteniendo peticiones .so, perot no serán capaces de hacer tan correctamente si los ficheros son propiamente instalados dentro de una jerarquía de página del manual. .SH AUTOR El código utilizado por \fBlexgrog\fP para analizar páginas man fue escrito por: .PP .nf .if !'po4a'hide' Wilf. (G.Wilford@ee.surrey.ac.uk). .if !'po4a'hide' Fabrizio Polacco (fpolacco@debian.org). .if !'po4a'hide' Colin Watson (cjwatson@debian.org). .fi .PP Colin Watson escribió la actual encarnación dela línea de órdenes frontal, así como esta página del man.