Ubuntu Manpage: man - interfaz de los manuales de referencia del sistema

NOMBRE

       man - interfaz de los manuales de referencia del sistema

SINOPSIS

       man [opciones de man] [[sección] página ...] ...
       man -k [opciones de apropos] regexp ...
       man -K [opciones de man] [sección] term ...
       man -f [whatis opciones] página ...
       man -l [opciones de man] archivo ...
       man -w|-W [opciones de man] página ...

DESCRIPCIÓN

man es el paginador de manuales del sistema. Cada argumento de página dado a man normalmente es el
nombre de un programa, utilidad o función. La página de manual asociada con cada uno de estos argumentos
es, pues, encontrada y mostrada. Si se proporciona una sección, man mirará solo en esa sección del
manual. La acción predeterminada es buscar en todas las secciones disponibles siguiendo un orden
predefinido (véase DEFAULTS), y mostrar solo la primera página encontrada, incluso si la página existe en
varias secciones.

La tabla de abajo muestra los números de sección del manual seguidos por los tipos de página que
contienen.

1 Programas ejecutables u órdenes de la shell
2 Llamadas al sistema (funciones proporcionadas por el núcleo)
3 Llamadas a biblioteca (funciones dentro de bibliotecas de programa)
4 Archivos especiales (normalmente se encuentran en /dev)
5 Formatos de archivo y convenios, p.e. /etc/passwd
6 Juegos
7 Miscelánea (incluidos paquetes de macros y convenios), p.e. man(7), groff(7), man-pages(7)
8 Órdenes de administración del sistema (normalmente solo para root)
9 Rutinas del núcleo [No estándar]

Una página de manual contiene varias secciones.

Conventional section names include NAME, SYNOPSIS, CONFIGURATION, DESCRIPTION, OPTIONS, EXIT STATUS,
RETURN VALUE, ERRORS, ENVIRONMENT, FILES, VERSIONS, STANDARDS, NOTES, BUGS, EXAMPLE, AUTHORS, and
SEE ALSO.

Los siguientes convenios se aplican a la sección SINOPSIS y pueden utilizarase como guía en otras
secciones.

escritura resaltada teclea exactamente como se muestra.
texto en cursiva sustituye con argumento apropiado.
[-abc] todos o cualquiera de los argumentos dentro de [ ] son opcionales.
-a|-b las opciones delimitadas por | no pueden usarse a la vez.
argumento ... argumento es repetible.
[expresión] ... la expresión entera entre [] es repetible.

La representación exacta puede variar con el dispositivo de salida. Por ejemplo, normalmente man no sabe
representar letra cursiva cuando se ejecuta en un terminal, y típicamente utilizará subrayado o texto
coloreado en su lugar.

La orden o función de ilustración es un patrón que debería coincidir con todas las posibles invocaciones.
En algunos casos es aconsejable ilustrar varias invocaciones exclusivas como se muestra en la sección
SINOPSIS de esta página de manual.

EJEMPLOS

man ls
Enseña la página de manual para el ítem (programa) ls.

man man.7
Muestra la página de manual del paquete de macros man desde la sección 7. (Esta es una ortografía
alternativa de "man 7 man".)

man 'man(7)'
Muestra la página de manual del paquete de macros man desde la sección 7. (Esta es otra ortografía
alternativa de "man 7 man". Puede ser más cómodo cuando se copian y pegan referencias cruzadas en
las páginas del manual. Nótese que los paréntesis normalmente deben entrecomillarse para protegerlos
de la shell.)

man -a intro
Muestra, sucesivamente, todas las páginas de introducción del manual disponibles contenidas en el
manual. Se puede salir durante la visualización de las páginas sucesivas o saltarse cualquiera de
ellas.

man -t bash | lpr -Pps
Da formato a la página de manual para bash siguiendo el formato predeterminado de troff o groff y la
manda a la impresora con nombre ps. La salida predeterminada para groff normalmente es PostScript.
man --help debería informar de qué procesador está ligado a la opción -t.

man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
Esta orden descomprimirá y formateará la página ./foo.1x.gz de manual fuente nroff, con destino a un
archivo independiente de dispositivo (dvi). La redirección es necesaria porque la opción -T provoca
que la salida se dirija a stdout sin ningún paginador. La salida puede visualizarse con un programa
como xdvi o procesarse a PostScript utilizando un programa como dvips.

man -k printf
Busca en las descripciones cortas y en los nombres de página de manual la palabra clave printf como
expresión regular. Imprime cualquier coincidencia. Equivalente a apropos printf.

man -f smail
Busca las páginas de manual referenciadas por smail e imprime las descripciones cortas de las que
encuentra. Equivalente a whatis smail.

VISIÓN GENERAL

man dispone de múltiples opciones para que el usuario disfrute de la máxima flexibilidad posible. Se
pueden hacer cambios en la ruta de búsqueda, el orden de las secciones, el procesador de salida y otros
mecanismos y operaciones que se detallan más abajo.

Hay varias variables de entorno que, si están asignadas, se consultan para determinar el comportamiento
de man. A la variable "atrápalo todo" $MANOPT se le puede asignar una cadena cualquiera en formato de
línea de órdenes, con la excepción de que cualquier espacio utilizado como parte del argumento de una
opción debe estar escapado (precedido de diagonal hacia atrás). man analiza $MANOPT antes de analizar su
propia línea de órdenes. Las opciones que requieren argumento se anulan en favor de las mismas opciones
halladas en la línea de órdenes. Para restablecer todas las opciones establecidas en $MANOPT, se puede
especificar -D como primera opción en la línea de órdenes. Esto permite a man "olvidar" las opciones
especificadas en $MANOPT, aunque aun así deben ser válidas.

Las páginas de manual normalmente se almacenan con el formato de nroff(1) en un directorio tal como
/usr/share/man. En algunas instalaciones también puede haber páginas cat preformateadas para obtener un
mejor rendimiento. Véase manpath(5) para los detalles acerca de dónde se almacenan estos archivos.

Este paquete admite páginas de manual en varios idiomas, lo cual se controla por medio de su
localización. Si esto no lo configura automáticamente su sistema, posiblemente tenga usted que
establecer $LC_MESSAGES, $LANG u otras variables de entorno que dependen del sistema, para indicar su
localización preferida, generalmente especificada en formato POSIX:

<idioma>[_<territorio>[.<conjunto de caracteres>[,<versión>]]]

Si la página deseada está disponible en su localización, se mostrará esta en lugar de la página estándar
(normalmenete inglés americano).

Si observa que las traducciones proporcionadas con este paquete no están disponibles en su idioma nativo
y estaría usted dispuesto a suministrarlas, puede ponerse en contacto con la persona responsable del
mantenimiento para coordinar dicha actividad.

Las páginas de manual individuales normalmente las escriben y mantienen los encargados del mantenimiento
del programa, función o tema que documentan, y no forman parte de este paquete. Si nota que falta alguna
página de manual o que no es adecuada, informe, por favor, a los encargados del paquete en cuestión.

Para información relacionada con otras características y extensiones disponibles con este paginador del
manual, lea los documentos suministrados con el paquete.

PREDETERMINACIONES

       El  orden  en que se busca en las secciones puede alterarse mediante la variable de entorno $MANSECT o la
       directiva SECTION en /etc/manpath.config.  Está predefinida así:

              1 n l 8 3 0 2 3type 3posix 3pm 3perl 3am 5 4 9 6 7

       La página de manual formateada se visualiza utilizando un  paginador,  el  cual  puede  especificarse  de
       diversas  maneras  o,  en  último  caso,  se  hará  de  un  modo predefinido (véase la opción -P para más
       detalles).

       Los filtros se descifran de diversos modos.  En primer lugar, se consulta la opción de línea  de  órdenes
       -p  o  la  variable de entorno $MANROFFSEQ.  Si no se ha utilizado -p ni se ha establecido la variable de
       entorno, se analiza la primera línea del archivo nroff en busca de una  cadena  de  preprocesador.   Para
       contener una cadena de preprocesador válida, la primera línea debe parecerse a

       '\" <cadena>

       donde cadena puede ser cualquier combinación de letras descrita por la opción -p más abajo.

       Si ninguno de los métodos anteriores proporiciona información sobre filtros, se utiliza una configuración
       predefinida.

       Una  cadena  de  formateo  es constituida por los filtros y el formateador primario (nroof o [tg]roff con
       -t) y ejecutada.  Alternativamente, si un programa ejecutable mandb_nfmt (o mandb_nfmt  con  -t)   existe
       dentro  de la raíz del árbol man, se ejecuta este en cambio.  Se le pasa al archivo fuente del manual, la
       cadena de preprocesador y opcionalmente el dispositivo especificado con -T or -E como argumentos.

OPCIONES

Las opciones sin argumento que estén duplicadas en la línea de órdenes, en $MANOPT o en ambas son
inocuas. Para opciones que requieran argumento, cada duplicado anulará el valor del argumento anterior.

Opciones generales
-C archivo, --config-file=archivo
Use this user configuration file rather than the default of ~/.manpath.

-d, --debug
Escribe información de depuración.

-D, --default
Esta opción, generalmente la primera de todas, restablece el comportamiento predefinido de man.
Se utiliza para restablecer aquellas opciones que pueden haber sido establecidas en $MANOPT.
Cualquier opción que siga a -D producirá su efecto habitual.

--warnings[=advertencias]
Enable warnings from groff. This may be used to perform sanity checks on the source text of
manual pages. warnings is a comma-separated list of warning names; if it is not supplied, the
default is "mac". To disable a groff warning, prefix it with "!": for example,
--warnings=mac,!break enables warnings in the "mac" category and disables warnings in the "break"
category. See the “Warnings” node in info groff for a list of available warning names.

Modos principales de operación
-f, --whatis
Approximately equivalent to whatis. Display a short description from the manual page, if
available. See whatis(1) for details.

-k, --apropos
Approximately equivalent to apropos. Search the short manual page descriptions for keywords and
display any matches. See apropos(1) for details.

-K, --global-apropos
Buscar texto en todas las páginas de manual. Esta es una búsqueda de fuerza bruta, y es probable
que tarde un poco; si puede, debería especificar una sección para reducir el número de páginas en
las cuales buscar. Los términos buscados pueden ser cadenas simples (lo predeterminado) o
expresiones regulares si se utiliza la opción --regex.

Note that this searches the sources of the manual pages, not the rendered text, and so may include
false positives due to things like comments in source files, or false negatives due to things like
hyphens being written as "\-" in source files. Searching the rendered text would be much slower.

-l, --local-file
Activate "local" mode. Format and display local manual files instead of searching through the
system's manual collection. Each manual page argument will be interpreted as an nroff source file
in the correct format. No cat file is produced. If '-' is listed as one of the arguments, input
will be taken from stdin.

If this option is not used, then man will also fall back to interpreting manual page arguments as
local file names if the argument contains a "/" character, since that is a good indication that
the argument refers to a path on the file system.

-w, --where, --path, --location
No muestra realmente la página de manual, sino que imprime la ubicación del archivo fuente nroff
que se formatearía. Si también se utiliza la opción -a, entonces imprime las ubicaciones de todos
los archivos fuente que coinciden con los criterios de búsqueda.

-W, --where-cat, --location-cat
No muestra realmente la página de manual, sino que imprime la ubicación del archivo cat
preformateado que se mostraría. Si también se utiliza la opción -a, entonces imprime las
ubicaciones de todos los archivos cat preformateados que coinciden con los criterios de búsqueda.

Si se utilizan tanto -w como -W, entonces imprime tanto el archivo fuente como el archivo cat
separados por un espacio. Si se utilizan todas las opciones -w, -W y -a, entonces hace esto para
cada posible coincidencia.

-c, --catman
Esta opción no es para utilización general y solo debería utilizarla el programa catman.

-R codificación, --recode=codificación
En vez de formatear la página de manual del modo habitual, saca su fuente convertida a la
codificación especificada. Si ya sabe la codificación del archivo fuente, también puede utilizar
manconv(1) directamente. Sin embargo, esta opción permite convertir varias páginas de manual a
una codificación única sin necesidad de explicitar la codificación de cada una, siempre que
estuvieran ya instaladas en una estructura similar a la jerarquía de página del manual.

Valore la alternativa de utilizar man-recode(1) para convertir varias páginas de manual, ya que
dispone de una interfaz para conversión en masa que puede ser mucho más rápida.

Encontrando páginas de manual
-L local, --locale=local
man normalmente determinará su localización actual mediante una llamada a la función C
setlocale(3), la cual examina varias variables de entorno, posiblemente incluyendo $LC_MESSAGES y
$LANG. Para anular temporalmente el valor determinado, utilice esta opción para suministrar una
cadena local directamente a man. Nótese que no tendrá efecto hasta que la búsqueda de páginas
realmente comience. Mensajes de salida como el de ayuda siempre se mostrarán en la localización
determinada inicialmente.

-m sistema[,...], --systems=sistema[,...]
Si este sistema tiene acceso a las páginas de manual de otro sistema operativo, pueden consultarse
utilizando esta opción. Para buscar una página de manual desde la colección de páginas de manual
del SOnuevo, utilice la opción -m SOnuevo.

El sistema especificado puede ser una combinación de nombres de sistemas operativos delimitados
por comas. Para incluir una búsqueda de las páginas de manual del sistema operativo nativo,
incluya el nombre del sistema man en la cadena de argumentos. Esta opción anulará la variable de
entorno $SYSTEM.

-M ruta, --manpath=ruta
Especifica una ruta de man alternativa. Por defecto, man utiliza código derivado de %manpath para
determinar la ruta a buscar. Esta opción anula la variable de entorno $MANPATH y provoca que se
descarte la opción -m.

Una ruta especificada como un manpath debe ser la raíz de una jerarquía de página man estructurada
en secciones como se describe en el manual de man-db (en «El sistema de páginas de manual»). Para
ver páginas del manual fuera de tales jerarquías, véase la opción -l.

-S listado, -s listado, --sections=listado
La lista dada es una lista de secciones separadas por dos puntos o por comas, que se utiliza para
determinar qué secciones del manual buscar y en qué orden. Esta opción anula la variable de
entorno $MANSECT. (La ortografía -s está para compatibilidad con System V.)

-e sub-extensión, --extension=sub-extensión
Algunos sistemas incorporan paquetes grandes de páginas de manual, como aquellas que acompañan al
paquete Tcl, dentro de la jerarquía de páginas del manual principal. Para solucionar el problema
de tener dos páginas del manual con el mismo nombre, como exit(3), las páginas de Tcl
habitualmente se asignaban a la sección I. Como esa era una idea poco afortunada, ahora pueden
ponerse las páginas en la sección correcta y asignarles una «extensión» propia, en este caso,
exit(3tcl). Normalmente, man mostrará exit(3) preferentemente, no exit(3tcl). Para negociar
esta situación y evitar tener que saber en qué sección reside la página requerida, ahora se le
puede dar a man una cadena de sub-extensión que indique a qué paquete debe pertenecer la página.
Utilizando el ejemplo anterior, suministrar la opción -e tcl a man restringirá la búsqueda a
páginas que tengan una extensión *tcl.

-i, --ignore-case
No distingue mayúsculas y minúsculas cuando busque páginas de manual. Esto es lo predeterminado.

-I, --match-case
Busca páginas de manual distinguiendo mayúsculas y minúsculas.

--regex
Muestra todas las páginas en las que alguna parte de los nombres o las descripciones coincida con
cada argumento de página como expresión regular, tal como apropos(1). Como no suele haber ninguna
forma razonable de tomar la «mejor» página cuando se busca una expresión regular, esta opción
implica -a.

--wildcard
Muestra todas las páginas en las que alguna parte de los nombres o las descripciones coincida con
cada argumento de página con comodines como los de la shell, tal como apropos(1) --wildcard. El
argumento de página debe coincidir con el nombre o la descripción en su totalidad o coincidir con
los límites de palabra en la descripción. Como no suele haber ninguna forma razonable de tomar la
«mejor» página cuando se busca un comodín, esta opción implica -a.

--names-only
Si se utiliza la opción --regex o --wildcard, solo intenta conicidencias con los nombres de
página, no con las descripciones de página, tal como con whatis(1). En caso contrario, no tiene
efecto.

-a, --all
El comportamiento predeterminado es que man termine tras mostrar la página de manual más adecuada
que encuentra. Esta opción provoca que man muestre todas las páginas del manual con nombres que
coincidan con los criterios de búsqueda.

-u, --update
Esta opción provoca que man actualice sus cachés de base de datos de las páginas de manual
instaladas. Rara vez es necesario hacer eso, por lo que normalmente es preferible ejecutar
mandb(8).

--no-subpages
Por omisión, man intenta interpretar los pares de nombres de páginas de manual dados en la línea
de órdenes como equivalentes a una página de manual simple que contenga un guión o un subrayado.
Se admiten los patrones habituales de programas que implementan varias subórdenes, permitiéndoles
proporcionar páginas de manual para cada una a la que se pueda acceder utilizando una sintaxis
similar a la que se utilizaría para invocar a las propias subórdenes. Por ejemplo:

$ man -aw git diff
/usr/share/man/man1/git-diff.1.gz

Para desactivar 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

Controlando salida formateada
-P paginador, --pager=paginador
Especifica el paginador de salida que se va a utilizar. Por defecto, man utiliza pager,
retrotrayéndose a cat si pager no se encuentra o no es ejecutable. Esta opción anula la variable
de entorno $MANPAGER, la cual, a su vez, anula la variable de entorno $PAGER. No se emplea a la
vez que -f o -k.

El valor puede ser un nombre de orden simple o una orden con argumentos y puede utilizar
entrecomillado de shell (barra inclinada hacia atrás, comillas sencillas o comillas dobles). No
pueden utilizar tuberías para conectar varias órdenes; si hicera falta, utilice un script que coja
el archivo que hay que mostrar de un argumento o de la entrada estándar.

-r prompt, --prompt=prompt
Si se emplea como paginador una versión reciente de less, man tratará de establecer su indicador y
algunas opciones razonables. El indicador predeterminado se parece a

Página de manual nombre(sec) línea x

donde nombre denota el nombre de la página de manual, sec denota la sección en la que se ha
encontrado y x el número de línea actual. Esto se consigue utilizando la variable de entorno
$LESS.

Suministrar -r con una cadena anula esta configuración predefinida. La cadena puede contener el
texto $MAN_PN que será expandido al nombre de la página actual de manual y su nombre de sección
entre "(" y ")". La cadena utilizada para generar la configuración predefinida puede expresarse
como

\ Página\ del\ Manual\ \$MAN_PN\ ?ltline\ %lt?L/%L.:
byte\ %bB?s/%s..?\ (FINAL):?pB\ %pB\\%..
(pulse h para ayuda o q para salir)

Está partido en tres líneas aquí solo para facilitar la lectura. Para su significado véase la
página de manual de less(1). La cadena del indicador primero la evalúa la shell. Todas las
comillas dobles, comillas traseras y barras inclinadas hacia atrás en el indicador deben ser
escapadas anteponiendo una barra inclinada hacia atrás. La cadena del indicador puede terminar en
un $ escapado que puede ir seguido por más opciones para less. Por omisión, man establece las
opciones -ix8.

La variable de entorno $MANLESS descrita abajo puede utilizarse para establecer una cadena del
indicador predeterminada si no se suministra ninguna en la línea de órdenes.

-7, --ascii
Cuando se vea una página de manual en ascii(7) puro en un terminal de 7 bits o en un emulador de
terminal, algunos caracteres podrían no mostrarse correctamente cuando se utiliza la descripción
de dispositivo latin1(7) con GNU nroff. Esta opción permite mostrar en ascii páginas puras en
ascii con el dispositivo latin1. No traduce ningún texto latin1. La tabla siguiente muestra las
traducciones realizadas: algunas de sus partes podrían no mostrarse apropiadamente cuando se
utiliza un dispositivo latin1(7) de GNU nroff.

Descripción Octal latin1 ascii
───────────────────────────────────────────────
guión de continuación 255 ‐ -
viñeta (punto medio) 267 • o
tilde 264 ´ '
signo de multiplicar 327 × x

Si la columna latin1 se muestra correctamente, su terminal podría estar configurado para
caracteres latin1 y esta opción no es necesaria. Si las columnas latin1 y ascii son idénticas,
está leyendo esta página utilizando esta opción o man no formateó esta página utilizando la
descripción de dispositivo latin1. Si la columna latin1 falta o está corrupta, podría ser que
necesitase ver las páginas de manual con esta opción.

Se hace caso omiso de esta opción cuando se utilizan las opciones -t, -H, -T o -Z y podría ser
inservible con un nroff que no sea el de GNU.

-E codificación, --encoding=codificación
Genera salida para una codificación de caracteres distinta de la predeterminada. Por
compatibilidad hacia atrás, la codificación puede ser un dispositivo nroff tal como ascii, latin1
o utf8 así como una codificación de caracteres verdadera como UTF-8.

--no-hyphenation, --nh
Normalmente, nroff parte el texto con guiones automáticamente en los saltos de línea incluso en
palabras que no contienen guiones, si es necesario hacerlo para disponer las palabras en una línea
sin espaciado excesivo. Esta opción desactiva los guiones automáticos, por lo que las palabras
solo serán partidas con guiones si ya tienen guiones.

Si está escribiendo una página de manual y simplemente quiere impedir que nroff parta palabras por
medio de guiones en un punto inapropiado, no debe utilizar esta opción, sino consultar la
documentación de nroff; por ejemplo, puede poner "\%" dentro de una palabra para indicar que puede
entregionarse en ese punto, o "\%" al principio de una palabra para impedirlo.

--no-justification, --nj
Normalmente, nroff justifica automáticamente el texto en ambos márgenes. Esta opción desactiva la
justificación completa, dejando justificado solo al margen izquierdo, algunas veces llamado texto
«irregular por la derecha».

Si está escribiendo una página de manual y simplemente quiere impedir que nroff justifique cierto
párrafo, no utilice esta opción; es mejor que consulte la documentación de nroff; por ejemplo,
puede utilizar las peticiones de ".na", ".nf", ".fi" y ".ad" para desactivar temporalmente los
ajustes y rellenos.

-p cadena, --preprocessor=cadena
Especifica la secuencia de preprocesadores para ejecutar antes que nroff o troff/groff. No todas
las instalaciones tendrán un conjunto completo de preprocesadores. Algunos de los preprocesadores
y las letras utilizadas para designarlos son: eqn (e), grap (g), pic (p), tbl (t), vgrind (v),
refer (r). Esta opción anula la variable de entorno $MANROFFSEQ. zsoelim siempre se ejecuta como
el primer preprocesador.

-t, --troff
Utilice groff -mandoc para dar formato a la página de manual hacia la salida estándar. Esta
opción no se requiere en conjucnión con -H, -T o -Z.

-T[dispositivo], --troff-device[=dispositivo]
This option is used to change groff (or possibly troff's) output to be suitable for a device
other than the default. It implies -t. Examples (as of groff 1.23.0) include dvi, latin1, pdf,
ps, utf8, X75 and X100.

-H[navegador], --html[=navegador]
Esta opción hace que groff produzca salida HTML y muestre esa salida en un navegador web. La
elección del navegador está determinada por el argumento opcional navegador si se proporciona, por
la variable de entorno $BROWSER o por uno predefinido en tiempo de compilación si aquella se ha
anulado (habitualmente lynx). Esta opción implica -t y solo funciona con GNU troff.

-X[ppp], --gxditview[=ppp]
La opción muestra la salida de groff en una ventana gráfica utilizando el programa gxditvew. El
ppp (puntos por pulgada) puede ser 75, 75-12, 100, o 100-12, siendo 75 el predefinido; las
variantes -12 utilizan una tipografía base de 12 puntos. Esta opción implica -T con los
respectivos dispositivos X75, X75-12, X100 o X11-12.

-Z, --ditroff
groff ejecuta troff y después utiliza un post-procesador adecuado para generar la salida adecuada
para el dispositivo elegido. Si groff -mandoc es groff, esta opción se le pasa a groff y suprime
el uso de un post-procesador. Implica -t.

Obtener ayuda
-?, --help
Escribe un mensaje de ayuda y termina.

--usage
Escribe mensaje breve sobre uso del programa y termina.

-V, --version
Muestra información sobre la versión.

ESTADO DE SALIDA

       0      Ejecución del programa correcta.

       1      Error de uso, de sintaxis o del archivo de configuración.

       2      Error operacional.

       3      Un subproceso devolvió un estado de salida distinta de cero.

       16     Al menos una de las páginas/archivos/palabras_clave no existe o no coincide.

ENTORNO

MANPATH
Si $MANPATH está establecida, su valor se emplea como ruta para buscar páginas de manual.

Vea la sección RUTA DE BÚSQUEDA de manpagh(5) para conocer el comportamiento predeterminado y los
detalles acerca de cómo se utiliza esta variable de entorno.

MANROFFOPT
Cada vez que man invoca al formateador (nroff, troff or groff), añade el contenido de $MANROFFOPT
a la línea de órdenes del formateador.

For example, MANROFFOPT=-P-i tells the formatter to use italic text (which is only supported by
some terminals) rather than underlined text.

MANROFFSEQ
Si $MANROFFSEQ está establecida, su valor se emplea para determinar el conjunto de preprocesadores
a través de los cuales se pasa cada página de manual. La lista de preprocesadores predeterminados
depende del sistema.

MANSECT
Si $MANSECT está establecida, su valor es una lista de secciones delimitadas por dos puntos y se
emplea para determinar en qué secciones de manual buscar y en qué orden. Lo predeterminado es "1
n l 8 3 0 2 3type 3posix 3pm 3perl 3am 5 4 9 6 7", salvo que esté anulado por la directiva SECCIÓN
en /etc/manpath.config.

MANPAGER, PAGER
Si $MANPAGER o $PAGER está establecida ($MANPAGER tiene preferencia), su valor se emplea como
nombre del programa utilizado para mostrar la página de manual. A falta de otra indicación, se
utiliza pager, o se recurre a cat si pager no se encuentra o no es ejecutable.

MANLESS
Si $MANLESS está establecida, su valor se emplea como indicador predefinido para el paginador
less, como si se hubiera pasado utilizando la opción -r (así, siempre que aparezca el texto
$MAN_PN se expande de la misma manera). Por ejemplo, si desea establecer el texto del indicador
incondicionalmente a “my texto indicador”, establezca $MANLESS a ‘-Psmy texto indicador’. Si se
utiliza la opción -r, se anula esta variable de entorno.

BROWSER
Si $BROWSER está establecida, su valor es una lista de órdenes delimitadas por dos puntos, cada
una de las cuales se emplea, a su vez, para intentar arrancar un navegador web para man --html.
En cada orden, %s se sustituye por un nombre de archivo que contiene la salida HTML de groff, %%
se sustituye por un único signo de porcentaje (%), y %c se sustituye por dos puntos (:).

SYSTEM Si $SYSTEM está establecida, tendrá el mismo efecto que si se hubiera especificado como el
argumento de la opción -m.

MANOPT Si $MANOPT está establecida, se analiza antes que la línea de órdenes de man y se espera que esté
en un formato similar. Como todas las demás variables de entorno específicas de man pueden
expresarse como opciones de la línea de órdenes y, por tanto, son candidatas para ser incluídas en
$MANOPT, se supone que acabarán quedando obsoletas. N.B. Todos los espacios que deberían ser
interpretados como parte del argumento de una opción deben escaparse.

MANWIDTH
Si $MANWITH está establecida, su valor se usa como la longitud de línea con la que dar formato a
las páginas de manual. Si no está establecida, las páginas del manual se formatean con una
longitud de línea adecuada al terminal actual (utilizando el valor de $COLUMNS y ioctl(2) si
están disponibles, o con 80 caracteres si no está disponible ninguna). Las páginas cat solo se
guardan cuando el formato predeterminado puede utilizarse, que es cuando el ancho de la línea del
terminal está entre 66 y 80 caracteres.

MAN_KEEP_FORMATTING
Normalmente, cuando la salida no está siendo dirigida a un terminal (como a un archivo o a una
tubería), se descartan los caracteres de formato para hacer más legible el resultado sin necesidad
de herramientas especiales. Sin embargo, si $MAN_KEEP_FORMATTING está establecida a cualquier
valor no vacío, estos caracteres de formato se retienen, lo cual puede ser útil para que programas
que utilizan man puedan interpretar los caracteres de formato.

MAN_KEEP_STDERR
Normalmente, cuando la salida está dirigida a un terminal (habitualmente un paginador), se
descarta toda la salida de error procedente de la orden utilizada para generar versiones
formateadas de páginas de manual, a fin de evitar interfencias con la salida del paginador. Los
programas como groff a menudo producen mensajes de errores relativamente menores acerca de
problemas tipográficos como alineamiento pobre, poco vistosos y generalmente confusos cuando se
muestran junto con la página del manual. Sin embargo, algunos usuarios quieren verlos de todas
formas, por lo que, si se establece $MAN_KEEP_STDERR a un valor no vacío, la salida de error se
mostrará como siempre.

MAN_DISABLE_SECCOMP
En Linux, man normalmente aísla subprocesos que manejan información no confiable usando un entorno
aislado seccomp. Esto hace más seguro ejecutar código de análisis complejo sobre páginas de
manual. Si esto sale mal por alguna razón que no esté relacionada con el contenido de la página
mostrada, puede usted asignar a $MAN_DISABLE_SECCOMP cualquier valor no vacío para deshabilitar el
aislamiento.

PIPELINE_DEBUG
Si la variable de entorno $PIPELINE_DEBUG se establece en "1", entonces man enviará mensajes de
depuración al flujo de error estándar describiendo cada subproceso que ejecute.

LANG, LC_MESSAGES
Según el sistema y la implementación, se examinará una de las variables de entorno $LANG o
$LC_MESSAGES, o ambas, para determinar la localización de mensajes actual. man muestra sus
mensajes para esa localización (si está disponible). Véase setlocale(3) para detalles
específicos.

ARCHIVOS

       /etc/manpath.config
              archivo de configuración de man-db.

       /usr/share/man
              Una jerarquía global de páginas de manual.

STANDARDS

       POSIX.1-2001, POSIX.1-2008, POSIX.1-2017.

VÉASE TAMBIÉN

       apropos(1), groff(1), less(1), manpath(1), nroff(1), troff(1), whatis(1), zsoelim(1), manpath(5), man(7),
       catman(8), mandb(8)

       La documentación de algunos paquetes puede estar disponible en otros  formatos,  tales  como  info(1)   o
       HTML.

HISTORIAL

       1990, 1991 – Originalmente escrito por John W. Eaton (jwe@che.utexas.edu).

       23  de  diciembre  de  1992:  Rik Faith (faith@cs.unc.edu) aplicó unos arreglos proporcionados por Willem
       Kasdorp (wkasdo@nikhefk.nikef.nl).

       El 30 de abril de 1994 – 23 de febrero de 2000: Wilf. (G.Wilford@ee.surrey.ac.uk)  ha estado desarrollado
       y manteniendo este paquete con ayuda de unas cuantas personas expresamente dedicadas.

       El 30 de octubre de 1996 – 30 de marzo de 2001: Fabrizio Polacco <fpolacco@debian.org> mantuvo  y  mejoró
       este paquete para el proyecto Debian, con la ayuda de toda la comunidad.

       El  31  de  marzo  de  2001 – día presente: Colin Watson <cjwatson@debian.org> ahora está desarrollando y
       manteniendo man-db.

DEFECTOS

       https://gitlab.com/man-db/man-db/-/issues
       https://savannah.nongnu.org/bugs/?group=man-db

2.13.1                                             2025-05-02                                             MAN(1)