rman - Online en la nube

PROGRAMA:

NOMBRE

PolyglotMan, rman - compilación inversa de páginas de manual desde un formato formateado a una serie de fuentes
formatos: ASCII, roff, TkMan, Tk, Sections, HTML, SGML, MIME, LaTeX, LaTeX2e, RTF, POD.

SINOPSIS

hombre [ opciones ] [ presentar ]

DESCRIPCIÓN

Se pueden encontrar instrucciones actualizadas en http://polyglotman.sourceforge.net/rman.html

Hombre políglota toma las páginas de manual de la mayoría de las versiones populares de UNIX y las transforma
en cualquiera de varios formatos de fuente de texto. PolyglotMan se conocía anteriormente como RosettaMan.
El nombre del binario todavía se llama hombre, para scripts que dependen de ese nombre;
mnemotécnicamente, sólo piensa en "hombre inverso". Previamente Hombre políglota páginas requeridas para ser
formateado por nroff(1) antes de su procesamiento. Con la versión 3.0, prefiere [tn] roff
fuente y generalmente produce resultados que son aún mejores. Y el procesamiento de origen es el único
forma de traducir tablas. Sin embargo, la traducción del formato de origen no es tan madura como formateada,
así que pruebe la traducción formateada como copia de seguridad.

Al analizar la fuente [tn] roff, se podría implementar un subconjunto arbitrariamente grande de [tn] roff,
lo cual no hice ni haré, por lo que los resultados pueden ser erróneos. Implementé un significativo
subconjunto de los que se utilizan en las páginas de manual, sin embargo, incluyendo tbl (pero no eqn), if tests y
definiciones de macros generales, por lo que, por lo general, los resultados se ven geniales. Si no es así, formatee el
página con nroff antes de enviarlo a PolyglotMan. Si PolyglotMan no reconoce una clave
macro utilizada por una gran clase de páginas, sin embargo, envíeme un correo electrónico con la fuente y un nroff-
página formateada y veré qué puedo hacer. Al ejecutar PolyglotMan con el código fuente de la página de manual
que incluye o redirige a otra fuente [tn] roff usando el .so (fuente o inclusión)
macro, debe estar en el directorio principal de la página, ya que las páginas están escritas con
esta suposición. Por ejemplo, si está traduciendo /usr/share/man/man1/ls.1, primer cd
en / usr / share / man.

Hombre políglota acepta páginas de manual de: SunOS, Sun Solaris, Hewlett-Packard HP-UX, AT&T
System V, OSF / 1 también conocido como Digital UNIX, DEC Ultrix, SGI IRIX, Linux, FreeBSD, SCO. Fuente
trabajos de procesamiento para: SunOS, Sun Solaris, Hewlett-Packard HP-UX, AT&T System V, OSF / 1 también conocido como
UNIX digital, DEC Ultrix. Puede producir solo ASCII imprimible (caracteres de control
stripped), solo encabezados de sección, Tk, TkMan, [tn] roff (fuente de página de manual tradicional), XML,
HTML, MIME, LaTeX, LaTeX2e, RTF, Perl 5 POD. Una arquitectura modular permite una fácil adición
de formatos de salida adicionales.

La última versión de PolyglotMan está disponible en http://polyglotman.sourceforge.net/ .

OPCIONES

Las siguientes opciones no deben usarse con ninguna otra y salir de PolyglotMan sin
procesando cualquier entrada.

-h | --help Muestra la lista de opciones de la línea de comandos y sale.

-v | --version Muestra el número de versión y sale.

Usted debo especificar la filtrar primero, as este vídeo conjuntos a número of parámetros, y y luego especificar
Otros .

-f | --filtro
Configure el filtro de salida. Por defecto es ASCII.

-S | --source PolyglotMan intenta determinar automáticamente si su entrada es fuente o
formateado use esta opción para declarar la entrada de origen.

-F | --format | --formatted
PolyglotMan intenta determinar automáticamente si su entrada es fuente o
formateado use esta opción para declarar una entrada formateada.

-l | --titulo printf-cadena
En el modo HTML, esto establece el de las páginas de manual, dado el mismo
parámetros como -r .

-r | --referencia | --manref printf-cadena
En los modos HTML y XML, esto establece el formulario de URL mediante el cual se recuperan otros archivos man
páginas. La cadena puede utilizar dos parámetros proporcionados: el nombre de la página de manual y
su sección. (Consulte la sección de Ejemplos). Si la cadena es nula (como si se
desde un shell por "-r ''"), `- 'u` off', las referencias de la página de manual no
ser HREF, solo ponerlo en cursiva. Si su printf admite posiciones XPG3
especificador, esto puede ser bastante flexible.

-V | --volúmenes <separados por dos puntos lista>
Establezca la lista de volúmenes válidos para verificar cuando se busquen referencias cruzadas.
referencias a otras páginas de manual. Predeterminado a 1:2:3:4:5:6:7:8:9:o:l:n:p
(los nombres de los volúmenes pueden tener varios caracteres). Si una cadena que no es un espacio en blanco en el
La página es seguida inmediatamente por un paréntesis izquierdo, luego uno de los
volúmenes, y termina con otros caracteres opcionales y luego un derecho
paréntesis - entonces esa cadena se informa como una referencia a otro manual
página. Si esta cadena -V comienza con un signo igual, entonces no es opcional
Se permiten caracteres entre la coincidencia con la lista de válidos y la
paréntesis derecho. (Esta opción es necesaria para SCO UNIX).

Las siguientes opciones se aplican solo cuando se proporcionan páginas formateadas como entrada. Ellos no
se aplican o siempre se manejan correctamente con la fuente.

-b | --subsecciones
Intente reconocer los títulos de las subsecciones además de los títulos de las secciones. Esto puede
causar problemas en algunas versiones de UNIX.

-K | --nobreak Indica que las páginas del manual no tienen saltos de página, así que no busque pies de página y
encabezados a su alrededor. (Las macros nroff -man más antiguas siempre se colocan en saltos de página,
pero últimamente algunos proveedores se han dado cuenta de que las impresiones se realizan a través de
troff(1), mientras que nroff -man se usa para formatear páginas para leer en la pantalla,
y así han eliminado los saltos de página). Hombre políglota generalmente hace esto bien
incluso sin esta bandera.

-k | --keep Conserva los encabezados y pies de página, como un informe canónico al final de la página.
changeleft Mover barras de cambio, como las que se encuentran en las páginas del manual de Tcl / Tk,
A la izquierda. -> no agresivo Deshabilitar análisis agresivo de la página de manual.
Manual agresivo, que está activado de forma predeterminada, la página analiza los encabezados elides y
pies de página, identifica secciones y más. ->

-n | --nombre nombre Establecer el nombre de la página de manual (utilizado en formato roff). Si el nombre del archivo se da en el
formulario " nombre . . ", el nombre y la sección se determinan automáticamente.
Si la página se analiza desde la fuente [tn] roff y tiene una línea .TH,
esta información se extrae de esa línea.

-p | --para cambiar el modo de párrafo. El filtro determina si las líneas deben
línea rota como estaban por nroff, o si las líneas deben fluir
juntos en párrafos. Principalmente para uso interno.

-s | sección # Establezca el número de volumen (sección también conocida como sección) de la página de manual (utilizado en formato roff). mesas
Active el análisis de tablas agresivo. ->

-t | --tabstops #
Para aquellos conjuntos de macros que utilizan tabulaciones en lugar de espacios cuando sea posible en
Para reducir el número de caracteres utilizados, establezca tabstops cada #
columnas. El valor predeterminado es 8.

NOTAS ON FILTRO TIPOS

ROFF
Algunas versiones de la página de manual de UNIX se envían sin [tn] fuente roff, lo que hace que una impresora láser
poco más que una margarita impulsada por láser. Este filtro intenta intuir el original
Directivas [tn] roff, que luego pueden ser recompiladas por [tn] roff.

TkMan
TkMan(1), un navegador de página de manual de hipertexto, utiliza Hombre políglota para mostrar páginas de manual sin el
(generalmente) encabezados y pies de página inútiles en cada página. También recopila sección y
(opcionalmente) encabezados de subsección para acceso directo desde un menú desplegable. TkMan y Tcl / Tk,
el kit de herramientas en el que está escrito, están disponibles a través de ftp anónimo desde
ftp://ftp.smli.com/pub/tcl/

Tk
Esta opción genera el texto en una serie de listas Tcl que constan de pares de etiquetas de texto, donde
los nombres de las etiquetas corresponden aproximadamente a HTML. Esta salida se puede insertar en un widget de texto Tk
haciendo un eval insertar final . Este formato debería ser relativamente fácil
analizable por otros programas que quieren tanto el texto como las etiquetas. Consulte también ASCII.

ASCII
Cuando se imprimen en una impresora de línea, las páginas man intentan producir efectos de texto especiales
caracteres sobresalientes consigo mismos (para producir negrita) y guiones bajos (subrayado).
Otro software de procesamiento de texto, como editores de texto, buscadores e indexadores, debe
contrarrestar esto. El filtro ASCII elimina este formato. Tubería de salida nroff a través de
columna -b también elimina este formato, pero deja encabezados de página antiestéticos y
pies de página. También vea Tk.

Secciones
Vuelca títulos de sección y (opcionalmente) subsección. Esto puede ser útil para otro programa.
que procesa páginas de manual.

HTML
Con una simple extensión a un servidor HTTP para Mosaico(1) u otro navegador de la World Wide Web,
Hombre políglota puede producir HTML de alta calidad sobre la marcha. Varias de estas extensiones y
los indicadores a varios otros se incluyen en Hombre políglota 's Contrib directorio.

XML
Esto se está acercando a la DTD de Docbook, pero espero que alguien con un interés real en
esto pulirá las etiquetas generadas. Pruébelo para ver qué tan cerca están las etiquetas ahora.

MÍMICA
MIME (Extensiones multipropósito de correo de Internet) según lo define RFC 1563, bueno para el consumo
por correos electrónicos compatibles con MIME o como documentos enriquecidos de Emacs (> = 19.29).

Látex y LaTeX2e
¿Por qué no?

RTF
Utilice la salida en Mac o NeXT o lo que sea. Tal vez tomar páginas de manual al azar e integrarlas
mejor con el sistema de documentación de NeXT. Tal vez NeXT tenga sus propias macros de página de manual que
esta.

PostScript y FrameMaker
Para producir PostScript, utilice grof or psroff . Para producir FrameMaker MIF, utilice FrameMaker
filtro incorporado. En ambos casos necesitas [tn] roff fuente, por lo que si solo tiene un formato
versión de la página del manual, utilice Hombre políglota primero el filtro roff.

EJEMPLOS

Para convertir el formateado página de manual nombrada ls.1 de nuevo al formato fuente [tn] roff:

hombre -f roff /usr/local/man/cat1/ls.1 > /usr/local/hombre/hombre1/ls.1

Las páginas de manual largas a menudo se comprimen para ahorrar espacio (la compresión es especialmente efectiva
en páginas de manual formateadas, ya que muchos de los caracteres son espacios). Como es una página de manual larga,
probablemente tiene subsecciones, que intentamos separar (algunos conjuntos de macros no distinguen
subsecciones lo suficientemente bien para Hombre políglota para detectarlos). Convirtamos esto a LaTeX
formato:

gato /usr/catman/a_man/cat1/automount.z | hombre -b -n automount -s 1 -f látex >
automount.man

Alternativamente, hombre 1 automount | hombre -b -n automount -s 1 -f látex > automount.man

Para usuarios de HTML / Mosaic, Hombre políglota puede, sin modificar el código fuente, producir
Enlaces HTML que apuntan a otras páginas de manual HTML ya sea pregeneradas o generadas sobre la marcha.
Primero asumamos versiones HTML pregeneradas de páginas de manual almacenadas en / usr / share / man / html .
Genere estos uno por uno con el siguiente formulario:
hombre -f html -r 'http: /usr/share/man/html/%s.%s.html' /usr/share/man/cat1/ls.1 >
/usr/share/man/html/ls.1.html

Si ha ampliado su cliente HTML para generar HTML sobre la marcha, debería utilizar algo
como:
hombre -f html -r 'http:~ / bin / man2html?% s:% s ' /usr/share/man/cat1/ls.1
al generar HTML.

Use rman en línea usando los servicios de onworks.net