Linux
MAN(1) Utilidades del localizador manual MAN(1)
NOMBRE
Man - una interfaz para los manuales de referencia en línea
SINOPSIS
hombre [-C archivo] [-d] [-D] [--warnings[=advertencias]] [-R codificación] [-L
[configuración regional] [-m sistema[,...]] [-M ruta] [-S lista] [-e extensión] [-i|-I]
[--regex|--wildcard] [--names-only] [-a] [-u] [--no-subpages] [-P
[buscador] [-r mensaje] [-7] [-E codificación] [--sin guiones] [--sin justificación
catión] [-p cadena] [-t] [-T[dispositivo]] [-H[navegador]] [-X[dpi]] [-Z]
[[sección] página ...] ...
man -k [opciones apropiadas] regexp ...
hombre -K [-w|-W] [-S lista] [-i|-I] [--regex] [sección] término ...
man -f [cuales son las opciones] página ...
man -l [-C archivo] [-d] [-D] [--warnings[=advertencias]] [-R codificación] [-L
[configuración regional] [-P localizador] [-r indicador] [-7] [-E codificación] [-p cadena] [-t]
[-T[dispositivo]] [-H[navegador]] [-X[dpi]] [-Z] archivo ...
man -w|-W [-C archivo] [-d] [-D] página ...
man -c [-C archivo] [-d] [-D] página ...
hombre [-hV]
DESCRIPCIÓN
man es el buscapersonas manual del sistema. Cada argumento de página que se le da a man es
Normalmente el nombre de un programa, utilidad o función. La página del manual
A continuación, se encuentra y se muestra el asociado con cada uno de estos argumentos.
La sección, si se proporciona, indicará al hombre que busque sólo en esa sección de
El manual. La acción predeterminada es buscar en todos los recursos disponibles.
secciones, siguiendo un orden predefinido y mostrando solo la primera página
encontrado, incluso si la página existe en varias secciones.
La siguiente tabla muestra los números de sección del manual seguidos de la
tipos de páginas que contienen.
1 Programas ejecutables o comandos de shell
2 Llamadas al sistema (funciones proporcionadas por el núcleo)
3 Llamadas a bibliotecas (funciones dentro de bibliotecas de programas)
4 archivos especiales (normalmente se encuentran en /dev)
5 formatos de archivo y convenciones, por ejemplo, /etc/passwd
6 juegos
7 Varios (incluidos paquetes macro y convenciones)
ciones), p. ej. hombre(7), groff(7)
8 Comandos de administración del sistema (generalmente solo para root)
9 Rutinas del kernel [No estándar]
Una página de manual consta de varias secciones.
Los nombres de sección convencionales incluyen NOMBRE, SINOPSIS, CONFIGURACIÓN,
DESCRIPCIÓN, OPCIONES, ESTADO DE SALIDA, VALOR DE RETORNO, ERRORES, ENTORNO,
ARCHIVOS, VERSIONES, CONFORMIDAD CON, NOTAS, ERRORES, EJEMPLO, AUTORES y
VER TAMBIÉN.
Las siguientes convenciones se aplican a la sección SINOPSIS y pueden utilizarse
como guía en otras secciones.
Escriba el texto en negrita exactamente como se muestra.
Texto en cursiva reemplazar con argumento apropiado.
[-abc] cualquiera o todos los argumentos dentro de [ ] son opcionales.
Las opciones -a|-b delimitadas por | no se pueden utilizar juntas.
argumento...el argumento es repetible.
[expresión] ... toda la expresión dentro de [ ] es repetible.
La reproducción exacta puede variar según el dispositivo de salida. Por ejemplo,
Por lo general, el hombre no podrá reproducir cursiva cuando se ejecuta en un terminal.
nal y, normalmente, utilizará texto subrayado o coloreado.
La ilustración del comando o función es un patrón que debe coincidir con todos
posibles invocaciones. En algunos casos es recomendable ilustrar varias
invocaciones exclusivas generales como se muestra en la sección SINOPSIS de este
Página del manual.
EJEMPLOS
El hombre es
Muestra la página del manual del elemento (programa) ls.
hombre -una intro
Mostrar, en sucesión, todas las páginas del manual de introducción disponibles
contenida en el manual. Es posible salir entre éxitos.
pantallas sucesivas o saltarse alguna de ellas.
hombre -t alias | lpr -Pps
Formatear la página del manual a la que hace referencia 'alias', normalmente un comando man‐ de shell.
página ual, en el formato predeterminado troff o groff y canalizarlo a la
impresora denominada ps. La salida predeterminada para groff suele ser Post-
El script man --help debería informar sobre qué procesador está vinculado a
la opción -t.
hombre -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
Este comando descomprimirá y formateará el manual fuente de nroff
página ./foo.1x.gz en un archivo independiente del dispositivo (dvi). La redi‐
La corrección es necesaria ya que el indicador -T hace que la salida se dirija a
stdout sin paginador. La salida se puede ver con un programa
como xdvi o procesado posteriormente en PostScript mediante un programa
como por ejemplo dvips.
hombre -k printf
Busque las descripciones breves y los nombres de las páginas del manual por la palabra clave
printf como expresión regular. Imprime las coincidencias. Equivalente
a propósito -r printf.
hombre -f smail
Busque las páginas del manual a las que hace referencia smail e imprima la versión corta.
Descripciones de cualquier cosa encontrada. Equivalente a whatis -r smail.
DESCRIPCIÓN GENERAL
Hay muchas opciones disponibles para el hombre con el fin de brindarle la mayor flexibilidad posible.
lo más posible al usuario. Se pueden realizar cambios en la ruta de búsqueda,
Orden de procesamiento, procesador de salida y otros comportamientos y operaciones.
detallado a continuación.
Si se configura, se interrogan varias variables de entorno para determinar la
Operación del hombre. Es posible configurar la variable "catch all"
$MANOPT a cualquier cadena en formato de línea de comando con la excepción de que
cualquier espacio utilizado como parte del argumento de una opción debe ser escapado (pre‐
cedido por una barra invertida). man analizará $MANOPT antes de analizar su propio
Línea de comandos. Las opciones que requieran un argumento serán anuladas.
con las mismas opciones que se encuentran en la línea de comandos. Para restablecer todos los
opciones establecidas en $MANOPT, -D se puede especificar como la línea de comando inicial
opción. Esto permitirá al hombre "olvidarse" de las opciones especificadas en
$MANOPT aunque todavía debieron ser válidos.
Las utilidades de paginación manuales empaquetadas como man-db hacen un uso extensivo de
cachés de bases de datos de índice. Estos cachés contienen información como dónde
En cada página del manual se puede encontrar el sistema de archivos y su significado.
(breve descripción de una línea de la página del manual) contiene y permite al hombre
corre más rápido que si tuviera que buscar en el sistema de archivos cada vez para encontrarlo
la página del manual correspondiente. Si se solicita mediante la opción -u, man
garantizará que los cachés permanezcan consistentes, lo que puede evitar la
Es necesario ejecutar manualmente el software para actualizar los datos de texto tradicionales de Whatis.
bases.
Si man no puede encontrar una base de datos de índice iniciada por mandb para un determinado
jerarquía de páginas del manual, seguirá buscando el manual solicitado
páginas, aunque será necesario agrupar archivos para buscar dentro de ellas
jerarquía. Si whatis o apropos no encuentran un índice, intentarán
Extraer información de una base de datos tradicional whatis.
Estas utilidades admiten archivos nroff de origen comprimido que tienen, por
Por defecto, las extensiones son .Z, .z y .gz. Es posible tratar con
cualquier extensión de compresión, pero esta información debe ser conocida en com‐
tiempo de apilamiento. Además, de forma predeterminada, todas las páginas cat producidas se comprimen
utilizando gzip. Cada jerarquía de páginas del manual "global", como /usr/share/man
o /usr/X11R6/man puede tener cualquier directorio como su jerarquía de páginas cat.
Tradicionalmente, las páginas de gatos se almacenan bajo la misma jerarquía que las
páginas man, pero por razones como las especificadas en la Jerarquía de Archivos
Estándar de calidad alimentaria (FHS), puede ser mejor almacenarlos en otro lugar.
Para obtener más detalles sobre cómo hacerlo, lea manpath(5). Para obtener más detalles sobre por qué
Para ello, lea la norma.
Este paquete cuenta con soporte internacional. Idioma nativo
Las páginas del manual son accesibles (si están disponibles en su sistema) mediante el uso de
funciones locales. Para activar dicho soporte, es necesario configurar
ya sea $LC_MESSAGES, $LANG u otro entorno dependiente del sistema
variable según la configuración regional de su idioma, generalmente especificada en POSIX 1003.1
Formato basado:
<idioma>[_<territorio>[.<conjunto de caracteres>[,<versión>]]]
Si la página deseada está disponible en su localidad, se mostrará
en lugar de la página estándar (generalmente en inglés americano).
Este soporte también incluye catálogos de mensajes internacionales.
paquete y se puede activar de la misma manera, nuevamente si está disponible. Si
encuentra que las páginas del manual y los catálogos de mensajes suministrados con
Este paquete no está disponible en su idioma nativo y le gustaría
Si desea suministrarlos, comuníquese con el encargado de mantenimiento, quien se encargará de coordinarlos.
alentando dicha actividad.
Para obtener información sobre otras funciones y extensiones disponibles con
Para este manual del buscapersonas, lea los documentos suministrados con el paquete.
VALORES PREDETERMINADOS
man buscará las páginas del manual deseadas dentro de la base de datos de índice
cachés. Si se proporciona la opción -u, se realiza una comprobación de consistencia de caché.
formado para garantizar que las bases de datos reflejen con precisión el sistema de archivos. Si
Esta opción siempre está disponible, generalmente no es necesario ejecutar mandb
después de que se crean inicialmente los cachés, a menos que un caché se corrompa.
Sin embargo, la comprobación de la consistencia de la caché puede ser lenta en sistemas con muchos
páginas manuales instaladas, por lo que no se realiza de forma predeterminada y el sistema
Es posible que los administradores deseen ejecutar mandb aproximadamente cada semana para mantener los datos.
Los cachés base están actualizados. Para evitar problemas causados por cachés obsoletos,
El hombre recurrirá al uso de archivos comodín si falla una búsqueda en caché, tal como lo hace
Lo haría si no hubiera caché presente.
Una vez que se ha localizado una página del manual, se realiza una comprobación para averiguarlo.
si ya existe un archivo 'cat' preformateado relativo y es más nuevo que
el archivo nroff. Si lo hace y lo es, este archivo preformateado es (normalmente)
descomprimido y luego mostrado, mediante el uso de un buscapersonas. El buscapersonas puede ser
especificado de varias maneras, o bien se recurrirá a un valor predeterminado.
usado (ver opción -P para detalles). Si no se encuentra ningún gato o es mayor de
El archivo nroff, el nroff se filtra a través de varios programas y es
se muestra inmediatamente.
Si se puede generar un archivo cat (existe un directorio cat relativo y tiene
permisos apropiados), man comprimirá y almacenará el archivo cat en
El fondo.
Los filtros se descifran por varios medios. En primer lugar, el comando
opción de línea -p o se interroga la variable de entorno $MANROFFSEQ.
Si no se utilizó -p y no se configuró la variable de entorno, el inicio
La primera línea del archivo nroff se analiza en busca de una cadena de preprocesador.
contener una cadena de preprocesador válida, la primera línea debe parecerse a
'\" <cadena>
donde la cadena puede ser cualquier combinación de letras descrita por la opción -p
abajo.
Si ninguno de los métodos anteriores proporciona información de filtro, se utilizará un filtro predeterminado.
Se utiliza el conjunto.
Se forma una tubería de formato a partir de los filtros y el foro primario.
asunto (nroff o [tg]roff con -t) y ejecutado. Alternativamente, si un
El programa ejecutable mandb_nfmt (o mandb_tfmt con -t) existe en el manual
raíz del árbol, se ejecuta en su lugar. Se pasa el código fuente manual
archivo, la cadena del preprocesador y, opcionalmente, el dispositivo especificado con
-T o -E como argumentos.
OPCIONES
Opciones sin argumentos que se duplican en la línea de comandos, en
$MANOPT, o ambos, no son dañinos. Para las opciones que requieren un argumento,
En este caso, cada duplicación anulará el valor del argumento anterior.
Opciones generales
-C archivo, --config-file=archivo
Utilice este archivo de configuración de usuario en lugar del predeterminado
~/.manpath.
-d, --depuración
Imprimir información de depuración.
-D, --predeterminado
Esta opción normalmente se emite como la primera opción y
Restablece el comportamiento del hombre a su estado predeterminado. Su uso es restablecer
aquellas opciones que se hayan podido configurar en $MANOPT. Cualquier opción
que siguen a -D tendrán su efecto habitual.
--advertencias[=advertencias]
Habilitar advertencias de groff. Esto puede usarse para realizar operaciones de cordura.
Comprueba el texto fuente de las páginas del manual. advertencias es una coma.
lista separada de nombres de advertencia; si no se proporciona, el
El valor predeterminado es "mac". Consulte el nodo "Advertencias" en info groff para obtener más información.
Lista de nombres de advertencia disponibles.
Principales modos de funcionamiento
-f, --quees
Equivalente a whatis. Muestra una breve descripción del man‐
Página dual, si está disponible. Ver whatis(1) para más detalles.
-k, --a propósito
Equivalente a a propósito. Busque la descripción de la página del manual breve
ciones de palabras clave y mostrar las coincidencias. Ver apropos(1) para
detalles.
-K, --global-apropiado
Busque texto en todas las páginas del manual. Esta es una búsqueda de fuerza bruta.
búsqueda, y es probable que tome algún tiempo; si puede, debe hacerlo.
Especifique una sección para reducir la cantidad de páginas que se deben incluir.
buscado. Los términos de búsqueda pueden ser cadenas simples (predeterminadas) o
expresiones regulares si se utiliza la opción --regex.
-l, --archivo-local
Activar el modo "local". Formatear y visualizar archivos manuales locales
en lugar de buscar en la colección manual del sistema.
Cada argumento de la página del manual se interpretará como una fuente nroff
archivo en el formato correcto. No se genera ningún archivo cat. Si '-' es
Si se incluye como uno de los argumentos, la entrada se tomará desde la entrada estándar.
Cuando no se utiliza esta opción y el hombre no puede encontrar la página
requerido, antes de mostrar el mensaje de error, intenta
Actúa como si se hubiera suministrado esta opción, utilizando el nombre como nombre de archivo
y buscando una coincidencia exacta.
-w, --donde, --ubicación
En realidad, no muestra las páginas del manual, pero sí imprime la ubicación.
ciones de los archivos nroff de origen que se formatearían.
-W, --donde-gato, --ubicacion-gato
En realidad, no muestra las páginas del manual, pero sí imprime la ubicación.
ciones de los archivos cat que se mostrarán. Si -w y -W
Ambos están especificados, imprímalos separados por un espacio.
-c, --catman
Esta opción no es para uso general y solo debe ser utilizada por
El programa Catman.
-R codificación, --recode=codificación
En lugar de formatear la página del manual de la forma habitual, la salida
Su fuente convertida a la codificación especificada. Si ya
conoce la codificación del archivo fuente, también puedes usar man‐
conv(1) directamente. Sin embargo, esta opción le permite convertir
varias páginas del manual en una única codificación sin necesidad de
indicar explícitamente la codificación de cada uno, siempre que se indique lo contrario.
Ya está instalado en una estructura similar a una página manual aquí.
arquía.
Cómo encontrar páginas del manual
-L configuración regional, --locale=configuración regional
Normalmente, el hombre determinará su configuración regional actual mediante una llamada al
Función C setlocale(3) que interroga a varios entornos
variables, posiblemente incluyendo $LC_MESSAGES y $LANG. Para tempo‐
raramente anule el valor determinado, use esta opción para proporcionar
una cadena de configuración regional directamente a man. Tenga en cuenta que no se tomará
efecto hasta que la búsqueda de páginas realmente comience. Salida como
ya que el mensaje de ayuda siempre se mostrará inicialmente
lugar determinado
-m sistema[,...], --systems=sistema[,...]
Si este sistema tiene acceso al manual de otros sistemas operativos
páginas, se puede acceder a ellas mediante esta opción. Para buscar una
página del manual de la colección de páginas del manual de NewOS, utilice la opción
-m Nuevo SO.
El sistema especificado puede ser una combinación de delimitados por comas.
nombres de sistemas operativos. Para incluir una búsqueda de los nombres de sistemas operativos nativos
En las páginas del manual del sistema, incluya el nombre del sistema man en el
cadena de argumento. Esta opción anulará el entorno $SYSTEM.
variable de ment.
-M ruta, --manpath=ruta
Especifique una ruta de acceso alternativa para utilizar. De forma predeterminada, man utiliza man‐
Código derivado de la ruta para determinar la ruta de búsqueda. Esta opción
anula la variable de entorno $MANPATH y hace que la opción -m
ser ignorado
Una ruta especificada como manpath debe ser la raíz de una página del manual
jerarquía estructurada en secciones como se describe en man-db
manual (en "El sistema de páginas del manual"). Para ver las páginas del manual
fuera de dichas jerarquías, consulte la opción -l.
-S lista, -s lista, --sections=lista
La lista es una lista separada por dos puntos o comas de 'orden específico'
Secciones del manual para buscar. Esta opción anula la opción $MANSECT
variable de entorno. (La ortografía -s es por compatibilidad)
con Sistema V.)
-e sub-extensión, --extension=sub-extensión
Algunos sistemas incorporan grandes paquetes de páginas manuales, como
los que acompañan al paquete Tcl, en la página principal del manual
jerarquía. Para evitar el problema de tener dos páginas de manual
con el mismo nombre como exit(3), las páginas Tcl eran usualmente
Todos asignados a la sección l. Como esto es lamentable, ahora es
posible colocar las páginas en la sección correcta y asignarlas
una "extensión" específica para ellos, en este caso, exit(3tcl).
operación normal, el hombre mostrará exit(3) en lugar de
exit(3tcl). Para negociar esta situación y evitar tener que
Sepa en qué sección se encuentra la página que necesita, ahora es
Es posible darle al hombre una cadena de subextensión que indique cuál
paquete al que debe pertenecer la página. Usando el ejemplo anterior, sup‐
Al utilizar la opción -e tcl en man, se restringirá la búsqueda a
páginas que tienen una extensión *tcl.
-i, --ignorar mayúsculas y minúsculas
Ignore las mayúsculas y minúsculas al buscar páginas del manual. Esta es la
por defecto.
-Yo, --coincidencia-de-casos
Busque páginas del manual teniendo en cuenta mayúsculas y minúsculas.
--expresión regular
Mostrar todas las páginas con cualquier parte de sus nombres o sus
descripciones que coinciden con cada argumento de página como una expresión regular
sión, como con apropos(1). Dado que normalmente no hay una razón
Manera de elegir una "mejor" página al buscar un expreso regular
sión, esta opción implica -a.
--comodín
Mostrar todas las páginas con cualquier parte de sus nombres o sus
descripciones que coinciden con cada argumento de la página usando comodines de estilo shell
tarjetas, como con apropos(1) --wildcard. El argumento de la página debe
Coincidir con el nombre completo o la descripción, o coincidir con el límite de palabras.
aries en la descripción. Dado que normalmente no hay ninguna razón
Una forma de elegir una "mejor" página al buscar un comodín es esta
La opción implica -a.
--solo nombres
Si se utiliza la opción --regex o --wildcard, coincida solo con la página
nombres, no descripciones de páginas, como en whatis(1). De lo contrario, no
efecto.
-a, --todos
De forma predeterminada, el hombre saldrá después de mostrar la opción más adecuada.
página del manual que encuentra. El uso de esta opción obliga a man a mostrar
todas las páginas del manual con nombres que coinciden con los criterios de búsqueda.
-u, --actualizar
Esta opción hace que man realice una verificación de consistencia a "nivel de inodo".
Verifique sus cachés de bases de datos para asegurarse de que sean precisos.
representación del sistema de archivos. Solo tendrá una utilidad
efecto si man se instala con el bit setuid establecido.
--sin subpáginas
De forma predeterminada, man intentará interpretar pares de nombres de páginas del manual.
dado en la línea de comandos como equivalente a una sola página del manual
nombre que contiene un guion o un guión bajo. Esto respalda la
Patrón común de programas que implementan una serie de subcomandos.
comandos, lo que les permite proporcionar páginas manuales para cada uno que puedan
se puede acceder utilizando una sintaxis similar a la que se usaría para invocar el
subcomandos en sí mismos. Por ejemplo:
$ hombre -aw git diff
/usr/share/man/man1/git-diff.1.gz
Para deshabilitar este comportamiento, utilice la opción --no-subpages.
$ man -aw --no-subpages git diff
/usr/share/man/man1/git.1.gz
/usr/share/man/man3/Git.3pm.gz
/usr/share/man/man1/diff.1.gz
Control de salida formateada
-P buscapersonas, --pager=buscapersonas
Especifique qué paginador de salida utilizar. De forma predeterminada, man utiliza pager
-s. Esta opción anula la variable de entorno $MANPAGER,
que a su vez anula la variable de entorno $PAGER.
no se utiliza junto con -f o -k.
El valor puede ser un nombre de comando simple o un comando con argumentos.
mentos y pueden usar comillas de shell (barras invertidas, comillas simples o
comillas dobles). No puede utilizar tuberías para conectar varias comunicaciones.
comandos; si lo necesitas, usa un script contenedor, que puede tomar
el archivo que se mostrará como argumento o en la entrada estándar.
-r aviso, --prompt=aviso
Si se utiliza una versión reciente de less como buscapersonas, man
Intente configurar su mensaje y algunas opciones sensatas.
El mensaje predeterminado se ve así
Nombre de la página del manual (seg.) línea x
donde nombre denota el nombre de la página del manual, sec denota la sección
Se encontró debajo de y x el número de línea actual. Esto es
Se logra utilizando la variable de entorno $LESS.
Si se proporciona -r con una cadena, se anulará este valor predeterminado.
La cadena puede contener el texto $MAN_PN que se expandirá a
el nombre de la página del manual actual y el nombre de su sección sobre‐
redondeado por '(' y ')'. La cadena utilizada para generar el valor predeterminado
Podría expresarse como
\ Página\ manual\ \$MAN_PN\ ?ltline\ %lt?L/%L.:
byte\ %bB?s/%s..?\ (FIN):?pB\ %pB\\%..
Aquí se divide en dos líneas para facilitar la lectura.
solamente. Para conocer su significado, consulte la página del manual less(1). El mensaje
La cadena es evaluada primero por el shell. Todas las comillas dobles,
Las comillas invertidas y las barras invertidas en el mensaje de solicitud deben estar separadas por una
barra invertida anterior. La cadena de solicitud puede terminar con un $ escapado
que puede ir seguida de otras opciones por menos. Por defecto
man establece las opciones -ix8.
Si desea anular el procesamiento de cadena de comandos del comando man,
completamente, utilice la variable de entorno $MANLESS que se describe a continuación.
-7, --ascii
Al visualizar una página de manual ascii(7) pura en una terminal de 7 bits o
emulador de terminal, es posible que algunos caracteres no se muestren correctamente
al utilizar la descripción del dispositivo latin1(7) con GNU nroff.
Esta opción permite que las páginas del manual en formato ASCII puro se muestren en
ascii con el dispositivo latin1. No traducirá ningún latin1
Texto. La siguiente tabla muestra las traducciones realizadas:
Algunas partes solo se pueden mostrar correctamente al usar GNU
dispositivo latin1(7) de nroff.
Descripción Octal latin1 ascii
──────────────────────────────────────── ─────
guión de continuación 255 ‐ -
bala (punto central) 267 · o
acento agudo 264 ´ '
signo de multiplicación 327 × x
Si la columna latin1 se muestra correctamente, es posible que su terminal esté
configurado para caracteres latin1 y esta opción no es necesaria.
Si las columnas latin1 y ascii son idénticas, estás leyendo
Esta página usa esta opción o man no formateó esta página
utilizando la descripción del dispositivo latin1. Si la columna latin1 es
Falta o está dañado, es posible que necesite ver las páginas del manual con este
opción.
Esta opción se ignora cuando se utilizan las opciones -t, -H, -T o -Z y
Puede ser inútil para nroff que no sea GNU.
-E codificación, --encoding=codificación
Generar salida para una codificación de caracteres distinta a la predeterminada.
Para compatibilidad con versiones anteriores, la codificación puede ser un dispositivo nroff como
como ascii, latin1 o utf8, así como una codificación de caracteres real
como UTF-8.
--sin separación de palabras, --nh
Normalmente, nroff separará automáticamente el texto en los saltos de línea.
Incluso en palabras que no contienen guiones, si es necesario
hazlo para disponer palabras en una línea sin espaciado excesivo.
Esta opción desactiva la separación automática de palabras, por lo que las palabras solo se escribirán
se separarán con guiones si ya contienen guiones.
Si está escribiendo una página de manual y simplemente desea evitar
nroff de separar una palabra con un guión en un punto inapropiado, no lo hagas
Utilice esta opción, pero consulte la documentación de nroff;
Por ejemplo, puedes poner "\%" dentro de una palabra para indicar que
Se puede separar con guion en ese punto o poner "\%" al comienzo de una
palabra para evitar que se separe con guión.
--sin-justificación, --nj
Normalmente, nroff justificará automáticamente el texto en ambos márgenes.
Esta opción deshabilita la justificación completa, dejando solo la justificada.
al margen izquierdo, a veces llamado texto "irregular a la derecha".
Si está escribiendo una página de manual y simplemente desea evitar
nroff de justificar ciertos párrafos, no utilice esto
opción, pero consulte la documentación de nroff en su lugar;
Por ejemplo, puede utilizar ".na", ".nf", ".fi" y ".ad".
solicitudes para deshabilitar temporalmente el ajuste y el llenado.
-p cadena, --preprocessor=cadena
Especifique la secuencia de preprocesadores que se ejecutarán antes de nroff o
troff/groff. No todas las instalaciones tendrán un conjunto completo de preinstalaciones.
procesadores. Algunos de los preprocesadores y las letras utilizadas para
Las designaciones son: eqn (e), grap (g), pic (p), tbl (t), vgrind
(v), consulte (r). Esta opción anula el entorno $MANROFFSEQ
variable de ment. zsoelim siempre se ejecuta como la primera variable predefinida.
procesador.
-t, --troff
Utilice groff -mandoc para formatear la página del manual en stdout.
Esta opción no es necesaria junto con -H, -T o -Z.
-T[dispositivo], --troff-device[=dispositivo]
Esta opción se utiliza para cambiar la salida de groff (o posiblemente de troff)
ser apto para un dispositivo distinto del predeterminado. Implica
-t. Los ejemplos (proporcionados con Groff-1.17) incluyen dvi, latin1,
ps, utf8, X75 y X100.
-H[navegador], --html[=navegador]
Esta opción hará que groff produzca una salida HTML y
mostrar esa salida en un navegador web. La elección del navegador es
determinado por el argumento del navegador opcional si se proporciona uno,
por la variable de entorno $BROWSER o por un tiempo de compilación
predeterminado si no está configurado (normalmente Lynx). Esta opción implica
-t, y sólo funcionará con GNU troff.
-X[ppp], --gxditview[=ppp]
Esta opción muestra la salida de groff en una ventana gráfica
utilizando el programa gxditview. Los dpi (puntos por pulgada) pueden ser 75,
75-12, 100 o 100-12, el valor predeterminado es 75; las variantes -12 utilizan un
Fuente base de 12 puntos. Esta opción implica -T con X75,
Dispositivo X75-12, X100 o X100-12 respectivamente.
-Z, --ditroff
groff ejecutará troff y luego utilizará un postprocesador apropiado
para producir una salida adecuada para el dispositivo elegido. Si groff
-mandoc es groff, esta opción se pasa a groff y apoyará
Presione el uso de un postprocesador. Implica -t.
Obtener ayuda
-h, --ayuda
Imprima un mensaje de ayuda y salga.
-V, --versión
Mostrar información de la versión.
ESTADO DE SALIDA
0 Ejecución exitosa del programa.
1 Error de uso, sintaxis o archivo de configuración.
2 Error operacional.
3 Un proceso secundario devolvió un estado de salida distinto de cero.
16 Al menos una de las páginas/archivos/palabras clave no existía o no estaba
emparejado.
AMBIENTE
CAMINO DEL HOMBRE
Si se establece $MANPATH, su valor se utiliza como ruta para buscar
páginas del manual.
Opción de MANROFF
El contenido de $MANROFFOPT se agrega a la línea de comando cada
cada vez que el hombre invoca el formateador (nroff, troff o groff).
SECCION MANROFF
Si se establece $MANROFFSEQ, su valor se utiliza para determinar el conjunto de
preprocesadores para pasar cada página del manual. El valor predeterminado
La lista de preprocesadores depende del sistema.
MANSECT
Si se establece $MANSECT, su valor es una lista de caracteres separados por dos puntos.
ciones y se utiliza para determinar qué secciones del manual
buscar y en qué orden.
MANAGER, BUSCADOR
Si se establece $MANPAGER o $PAGER (se utiliza $MANPAGER con preferencia),
Su valor se utiliza como el nombre del programa utilizado para mostrar el
Página del manual. De forma predeterminada, se utiliza pager -s.
El valor puede ser un nombre de comando simple o un comando con argumentos.
mentos y pueden usar comillas de shell (barras invertidas, comillas simples o
comillas dobles). No puede utilizar tuberías para conectar varias comunicaciones.
comandos; si lo necesitas, usa un script contenedor, que puede tomar
el archivo que se mostrará como argumento o en la entrada estándar.
SIN HOMBRE
Si se establece $MANLESS, man no realizará ninguno de sus procesos habituales.
proceso para configurar una cadena de aviso para el buscapersonas menor. En cambio,
El valor de $MANLESS se copiará textualmente en $LESS.
Por ejemplo, si desea establecer la cadena de solicitud de forma incondicional en
“mi cadena de mensaje”, establece $MANLESS en '-Psmi cadena de mensaje'.
NAVEGADOR
Si se establece $BROWSER, su valor es una lista de comandos delimitada por dos puntos.
comandos, cada uno de los cuales a su vez se utiliza para intentar iniciar una red
Navegador para man --html. En cada comando, %s se reemplaza por un
nombre de archivo que contiene la salida HTML de groff, se reemplaza %%
por un solo signo de porcentaje (%), y %c se reemplaza por dos puntos (:).
SISTEMA Si se establece $SYSTEM, tendrá el mismo efecto que si tuviera
se ha especificado como argumento de la opción -m.
MANOPT Si se establece $MANOPT, se analizará antes de la línea de comando de man
y se espera que tenga un formato similar. Como todos los demás
Las variables de entorno específicas del hombre se pueden expresar como comandos
opciones de línea y, por lo tanto, son candidatas para ser incluidas en
$MANOPT se espera que queden obsoletos. NB Todos
espacios que deben interpretarse como parte del argumento de una opción
Hay que escapar del peligro.
ANCHO DEL HOMBRE
Si se establece $MANWIDTH, su valor se utiliza como longitud de línea para
qué páginas del manual deben formatearse. Si no está configurado, man‐
Las páginas individuales se formatearán con una longitud de línea apropiada para
la terminal actual (usando un ioctl(2) si está disponible, el valor
de $COLUMNS, o retroceder a 80 caracteres si ninguno de ellos es
disponible). Las páginas de gatos solo se guardarán cuando se cumpla el valor predeterminado para
Se puede utilizar estera, es decir, cuando la longitud de la línea terminal es
Entre 66 y 80 caracteres.
MAN_KEEP_FORMATTING
Normalmente, cuando la salida no se dirige a un terminal (como
como en el caso de un archivo o una tubería), los caracteres de formato se descartan.
Facilitar la lectura del resultado sin necesidad de herramientas especiales. Cómo‐
siempre, si $MAN_KEEP_FORMATTING se establece en cualquier valor no vacío,
Estos caracteres de formato se conservan. Esto puede resultar útil.
para envoltorios alrededor de man que puedan interpretar caracteres de formato
ters.
MAN_KEEP_STDERR
Normalmente, cuando la salida se dirige a un terminal (normalmente
a un buscapersonas), cualquier salida de error del comando utilizado para producir
Las versiones formateadas de las páginas del manual se descartan para evitar interferencias.
con la pantalla del buscapersonas. Programas como groff suelen
producir mensajes de error relativamente menores sobre tipografía
Problemas como una mala alineación, que son antiestéticos y generalmente
Resulta muy confuso cuando se muestra junto con la página del manual.
Sin embargo, algunos usuarios quieren verlos de todos modos, así que, si
$MAN_KEEP_STDERR se establece en cualquier valor no vacío, salida de error
Se mostrará como de costumbre.
LANG, MENSAJES LC
Dependiendo del sistema y la implementación, uno o ambos $LANG
y se interrogará a $LC_MESSAGES para el mensaje actual
locale.man mostrará sus mensajes en esa configuración regional (si está disponible).
(capaz). Consulte setlocale(3) para obtener detalles precisos.
ARCHIVOS
/etc/manpath.config
archivo de configuración man-db.
/usr/compartir/hombre
Una jerarquía de páginas de manual global.
/usr/share/man/index.(bt|db|dir|pag)
Un caché de base de datos de índice global tradicional.
/var/cache/man/index.(bt|db|dir|pag)
Un caché de base de datos de índice global compatible con FHS.
VER TAMBIÉN
mandb(8), manpath(1), manpath(5), apropos(1), whatis(1), catman(8),
menos(1), nroff(1), troff(1), groff(1), zsoelim(1), setlocale(3),
man(7), ascii(7), latin1(7), el manual del paquete man-db, FSSTND.
HISTORIA
1990, 1991 - Escrito originalmente por John W. Eaton (jwe@che.utexas.edu).
23 de diciembre de 1992: Rik Faith (faith@cs.unc.edu) aplicó las correcciones de errores proporcionadas por
Willem Kasdorp (wkasdo@nikhefk.nikef.nl).
30 de abril de 1994 - 23 de febrero de 2000: Wilf. (G.Wilford@ee.surrey.ac.uk)
Ha estado desarrollando y manteniendo este paquete con la ayuda de unos pocos
Gente dedicada.
30 de octubre de 1996 - 30 de marzo de 2001: Fabrizio Polacco <fpo‐
lacco@debian.org> mantuvo y mejoró este paquete para Debian
Proyecto, con la ayuda de toda la comunidad.
31 de marzo de 2001 - actualidad: Colin Watson <cjwatson@debian.org> es
Ahora estamos desarrollando y manteniendo man-db.
2.5.9 17-11-2010 HOMBRE(1)
0
|
|