MAN(1)                Utilidades de paginador del manual                MAN(1)

NOMBRE
       man - interfaz de los manuales de referencia del sistema

SINOPSIS
       man [opciones de man] [[seccion] pagina ...] ...
       man -k [opciones de apropos] regexp ...
       man -K [opciones de man] [seccion] term ...
       man -f [whatis opciones] pagina ...
       man -l [opciones de man] archivo ...
       man -w|-W [opciones de man] pagina ...

DESCRIPCION
       man es el paginador de manuales del sistema.  Cada argumento de pagina
       dado a man normalmente es el nombre de un programa, utilidad o funcion.
       La pagina de manual asociada con cada uno de estos argumentos es, pues,
       encontrada y mostrada.  Si se proporciona una seccion, man mirara solo
       en esa seccion del manual.  La accion predeterminada es buscar en todas
       las secciones disponibles siguiendo un orden predefinido (vease
       DEFAULTS), y mostrar solo la primera pagina encontrada, incluso si la
       pagina existe en varias secciones.

       La tabla de abajo muestra los numeros de seccion del manual seguidos
       por los tipos de pagina que contienen.


       1   Programas ejecutables u ordenes de la shell
       2   Llamadas al sistema (funciones proporcionadas por el nucleo)
       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   Miscelanea (incluidos paquetes de macros y convenios), p.e. man(7),
           groff(7), man-pages(7)
       8   Ordenes de administracion del sistema (normalmente solo para root)
       9   Rutinas del nucleo [No estandar]

       Una pagina 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 seccion SINOPSIS y pueden
       utilizarase como guia 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.
       [expresion] ...       la expresion entera entre [] es repetible.

       La representacion exacta puede variar con el dispositivo de salida.
       Por ejemplo, normalmente man no sabe representar letra cursiva cuando
       se ejecuta en un terminal, y tipicamente utilizara subrayado o texto
       coloreado en su lugar.

       La orden o funcion de ilustracion es un patron que deberia coincidir
       con todas las posibles invocaciones.  En algunos casos es aconsejable
       ilustrar varias invocaciones exclusivas como se muestra en la seccion
       SINOPSIS de esta pagina de manual.

EJEMPLOS
       man ls
           Ensena la pagina de manual para el item (programa)  ls.

       man man.7
           Muestra la pagina de manual del paquete de macros man desde la
           seccion 7.  (Esta es una ortografia alternativa de "man 7 man".)

       man 'man(7)'
           Muestra la pagina de manual del paquete de macros man desde la
           seccion 7.  (Esta es otra ortografia alternativa de "man 7 man".
           Puede ser mas comodo cuando se copian y pegan referencias cruzadas
           en las paginas del manual.  Notese que los parentesis normalmente
           deben entrecomillarse para protegerlos de la shell.)

       man -a intro
           Muestra, sucesivamente, todas las paginas de introduccion del
           manual disponibles contenidas en el manual.  Se puede salir durante
           la visualizacion de las paginas sucesivas o saltarse cualquiera de
           ellas.

       man -t bash | lpr -Pps
           Da formato a la pagina 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 deberia informar de que procesador esta
           ligado a la opcion -t.

       man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
           Esta orden descomprimira y formateara la pagina ./foo.1x.gz de
           manual fuente nroff, con destino a un archivo independiente de
           dispositivo (dvi).  La redireccion es necesaria porque la opcion -T
           provoca que la salida se dirija a stdout sin ningun 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 pagina de
           manual la palabra clave printf como expresion regular.  Imprime
           cualquier coincidencia.  Equivalente a apropos printf.

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

VISION GENERAL
       man dispone de multiples opciones para que el usuario disfrute de la
       maxima flexibilidad posible.  Se pueden hacer cambios en la ruta de
       busqueda, el orden de las secciones, el procesador de salida y otros
       mecanismos y operaciones que se detallan mas abajo.

       Hay varias variables de entorno que, si estan asignadas, se consultan
       para determinar el comportamiento de man.  A la variable "atrapalo
       todo" $MANOPT se le puede asignar una cadena cualquiera en formato de
       linea de ordenes, con la excepcion de que cualquier espacio utilizado
       como parte del argumento de una opcion debe estar escapado (precedido
       de diagonal hacia atras).  man analiza $MANOPT antes de analizar su
       propia linea de ordenes. Las opciones que requieren argumento se anulan
       en favor de las mismas opciones halladas en la linea de ordenes.  Para
       restablecer todas las opciones establecidas en $MANOPT, se puede
       especificar -D como primera opcion en la linea de ordenes.  Esto
       permite a man "olvidar" las opciones especificadas en $MANOPT, aunque
       aun asi deben ser validas.

       Las paginas de manual normalmente se almacenan con el formato de
       nroff(1) en un directorio tal como /usr/share/man.  En algunas
       instalaciones tambien puede haber paginas cat preformateadas para
       obtener un mejor rendimiento.  Vease manpath(5)  para los detalles
       acerca de donde se almacenan estos archivos.

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

       <idioma>[_<territorio>[.<conjunto de caracteres>[,<version>]]]

       Si la pagina deseada esta disponible en su localizacion, se mostrara
       esta en lugar de la pagina estandar (normalmenete ingles americano).

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

       Las paginas de manual individuales normalmente las escriben y mantienen
       los encargados del mantenimiento del programa, funcion o tema que
       documentan, y no forman parte de este paquete.  Si nota que falta
       alguna pagina de manual o que no es adecuada, informe, por favor, a los
       encargados del paquete en cuestion.

       Para informacion relacionada con otras caracteristicas 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/man_db.conf.  Esta predefinida asi:

              1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7

       La pagina de manual formateada se visualiza utilizando un paginador, el
       cual puede especificarse de diversas maneras o, en ultimo caso, se hara
       de un modo predefinido (vease la opcion -P para mas detalles).

       Los filtros se descifran de diversos modos.  En primer lugar, se
       consulta la opcion de linea de ordenes -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 linea del archivo nroff en busca de
       una cadena de preprocesador.  Para contener una cadena de preprocesador
       valida, la primera linea debe parecerse a

       '\" <cadena>

       donde cadena puede ser cualquier combinacion de letras descrita por la
       opcion -p mas abajo.

       Si ninguno de los metodos anteriores proporiciona informacion sobre
       filtros, se utiliza una configuracion 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 raiz del arbol 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 esten duplicadas en la linea de ordenes,
       en $MANOPT o en ambas son inocuas.  Para opciones que requieran
       argumento, cada duplicado anulara 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 informacion de depuracion.

       -D, --default
              Esta opcion, 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 opcion que siga a -D producira 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 operacion
       -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 paginas de manual.  Esta es una
              busqueda de fuerza bruta, y es probable que tarde un poco; si
              puede, deberia especificar una seccion para reducir el numero de
              paginas en las cuales buscar.  Los terminos buscados pueden ser
              cadenas simples (lo predeterminado) o expresiones regulares si
              se utiliza la opcion --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 pagina de manual, sino que imprime la
              ubicacion del archivo fuente nroff que se formatearia.  Si
              tambien se utiliza la opcion -a, entonces imprime las
              ubicaciones de todos los archivos fuente que coinciden con los
              criterios de busqueda.

       -W, --where-cat, --location-cat
              No muestra realmente la pagina de manual, sino que imprime la
              ubicacion del archivo cat preformateado que se mostraria.  Si
              tambien se utiliza la opcion -a, entonces imprime las
              ubicaciones de todos los archivos cat preformateados que
              coinciden con los criterios de busqueda.

              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 opcion no es para utilizacion general y solo deberia
              utilizarla el programa catman.

       -R codificacion, --recode=codificacion
              En vez de formatear la pagina de manual del modo habitual, saca
              su fuente convertida a la codificacion especificada.  Si ya sabe
              la codificacion del archivo fuente, tambien puede utilizar
              manconv(1)  directamente.  Sin embargo, esta opcion permite
              convertir varias paginas de manual a una codificacion unica sin
              necesidad de explicitar la codificacion de cada una, siempre que
              estuvieran ya instaladas en una estructura similar a la
              jerarquia de pagina del manual.

              Valore la alternativa de utilizar man-recode(1)  para convertir
              varias paginas de manual, ya que dispone de una interfaz para
              conversion en masa que puede ser mucho mas rapida.

   Encontrando paginas de manual
       -L local, --locale=local
              man normalmente determinara su localizacion actual mediante una
              llamada a la funcion C setlocale(3), la cual examina varias
              variables de entorno, posiblemente incluyendo $LC_MESSAGES y
              $LANG.  Para anular temporalmente el valor determinado, utilice
              esta opcion para suministrar una cadena local directamente a
              man.  Notese que no tendra efecto hasta que la busqueda de
              paginas realmente comience.  Mensajes de salida como el de ayuda
              siempre se mostraran en la localizacion determinada
              inicialmente.

       -m sistema[,...], --systems=sistema[,...]
              Si este sistema tiene acceso a las paginas de manual de otro
              sistema operativo, pueden consultarse utilizando esta opcion.
              Para buscar una pagina de manual desde la coleccion de paginas
              de manual del SOnuevo, utilice la opcion -m SOnuevo.

              El sistema especificado puede ser una combinacion de nombres de
              sistemas operativos delimitados por comas.  Para incluir una
              busqueda de las paginas de manual del sistema operativo nativo,
              incluya el nombre del sistema man en la cadena de argumentos.
              Esta opcion anulara la variable de entorno $SYSTEM.

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

              Una ruta especificada como un manpath debe ser la raiz de una
              jerarquia de pagina man estructurada en secciones como se
              describe en el manual de man-db (en <<El sistema de paginas de
              manual>>).  Para ver paginas del manual fuera de tales
              jerarquias, vease la opcion -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 que secciones del
              manual buscar y en que orden.  Esta opcion anula la variable de
              entorno $MANSECT.  (La ortografia -s esta para compatibilidad
              con System V.)

       -e sub-extension, --extension=sub-extension
              Algunos sistemas incorporan paquetes grandes de paginas de
              manual, como aquellas que acompanan al paquete Tcl, dentro de la
              jerarquia de paginas del manual principal.  Para solucionar el
              problema de tener dos paginas del manual con el mismo nombre,
              como exit(3), las paginas de Tcl habitualmente se asignaban a la
              seccion I.  Como esa era una idea poco afortunada, ahora pueden
              ponerse las paginas en la seccion correcta y asignarles una
              <<extension>> propia, en este caso, exit(3tcl).  Normalmente,
              man mostrara exit(3)  preferentemente, no exit(3tcl).  Para
              negociar esta situacion y evitar tener que saber en que seccion
              reside la pagina requerida, ahora se le puede dar a man una
              cadena de sub-extension que indique a que paquete debe
              pertenecer la pagina.  Utilizando el ejemplo anterior,
              suministrar la opcion -e tcl a man restringira la busqueda a
              paginas que tengan una extension *tcl.

       -i, --ignore-case
              No distingue mayusculas y minusculas cuando busque paginas de
              manual.  Esto es lo predeterminado.

       -I, --match-case
              Busca paginas de manual distinguiendo mayusculas y minusculas.

       --regex
              Muestra todas las paginas en las que alguna parte de los nombres
              o las descripciones coincida con cada argumento de pagina como
              expresion regular, tal como apropos(1).  Como no suele haber
              ninguna forma razonable de tomar la <<mejor>> pagina cuando se
              busca una expresion regular, esta opcion implica -a.

       --wildcard
              Muestra todas las paginas en las que alguna parte de los nombres
              o las descripciones coincida con cada argumento de pagina con
              comodines como los de la shell, tal como apropos(1)  --wildcard.
              El argumento de pagina debe coincidir con el nombre o la
              descripcion en su totalidad o coincidir con los limites de
              palabra en la descripcion.  Como no suele haber ninguna forma
              razonable de tomar la <<mejor>> pagina cuando se busca un
              comodin, esta opcion implica -a.

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

       -a, --all
              El comportamiento predeterminado es que man termine tras mostrar
              la pagina de manual mas adecuada que encuentra.  Esta opcion
              provoca que man muestre todas las paginas del manual con nombres
              que coincidan con los criterios de busqueda.

       -u, --update
              Esta opcion provoca que man actualice sus caches de base de
              datos de las paginas de manual instaladas.  Rara vez es
              necesario hacer eso, por lo que normalmente es preferible
              ejecutar mandb(8).

       --no-subpages
              Por omision, man intenta interpretar los pares de nombres de
              paginas de manual dados en la linea de ordenes como equivalentes
              a una pagina de manual simple que contenga un guion o un
              subrayado.  Se admiten los patrones habituales de programas que
              implementan varias subordenes, permitiendoles proporcionar
              paginas de manual para cada una a la que se pueda acceder
              utilizando una sintaxis similar a la que se utilizaria para
              invocar a las propias subordenes.  Por ejemplo:

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

              Para desactivar este comportamiento, utilice la opcion
              --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 less, retrotrayendose a cat si less no se
              encuentra o no es ejecutable.  Esta opcion 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 atras, comillas sencillas o comillas dobles).
              No pueden utilizar tuberias para conectar varias ordenes; si
              hicera falta, utilice un script que coja el archivo que hay que
              mostrar de un argumento o de la entrada estandar.

       -r prompt, --prompt=prompt
              Si se emplea como paginador una version reciente de less, man
              tratara de establecer su indicador y algunas opciones
              razonables.  El indicador predeterminado se parece a

               Pagina de manual nombre(sec) linea x

              donde nombre denota el nombre de la pagina de manual, sec denota
              la seccion en la que se ha encontrado y x el numero de linea
              actual.  Esto se consigue utilizando la variable de entorno
              $LESS.

              Suministrar -r con una cadena anula esta configuracion
              predefinida.  La cadena puede contener el texto $MAN_PN que sera
              expandido al nombre de la pagina actual de manual y su nombre de
              seccion entre "(" y ")".  La cadena utilizada para generar la
              configuracion predefinida puede expresarse como

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

              Esta partido en tres lineas aqui solo para facilitar la lectura.
              Para su significado vease la pagina de manual de less(1).  La
              cadena del indicador primero la evalua la shell.  Todas las
              comillas dobles, comillas traseras y barras inclinadas hacia
              atras en el indicador deben ser escapadas anteponiendo una barra
              inclinada hacia atras.  La cadena del indicador puede terminar
              en un $ escapado que puede ir seguido por mas opciones para
              less.  Por omision, 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 linea de ordenes.

       -7, --ascii
              Cuando se vea una pagina de manual en ascii(7) puro en un
              terminal de 7 bits o en un emulador de terminal, algunos
              caracteres podrian no mostrarse correctamente cuando se utiliza
              la descripcion de dispositivo latin1(7) con GNU nroff.  Esta
              opcion permite mostrar en ascii paginas puras en ascii con el
              dispositivo latin1.  No traduce ningun texto latin1.  La tabla
              siguiente muestra las traducciones realizadas: algunas de sus
              partes podrian no mostrarse apropiadamente cuando se utiliza un
              dispositivo latin1(7) de GNU nroff.


              Descripcion                 Octal   latin1   ascii
              ---------------------------------------------------
              guion de continuacion        255      -        -
              vineta (punto medio)         267     o         o
              tilde                        264      '        '
              signo de multiplicar         327      x        x

              Si la columna latin1 se muestra correctamente, su terminal
              podria estar configurado para caracteres latin1 y esta opcion no
              es necesaria.  Si las columnas latin1 y ascii son identicas,
              esta leyendo esta pagina utilizando esta opcion o man no
              formateo esta pagina utilizando la descripcion de dispositivo
              latin1.  Si la columna latin1 falta o esta corrupta, podria ser
              que necesitase ver las paginas de manual con esta opcion.

              Se hace caso omiso de esta opcion cuando se utilizan las
              opciones -t, -H, -T o -Z y podria ser inservible con un nroff
              que no sea el de GNU.

       -E codificacion, --encoding=codificacion
              Genera salida para una codificacion de caracteres distinta de la
              predeterminada.  Por compatibilidad hacia atras, la codificacion
              puede ser un dispositivo nroff tal como ascii, latin1 o utf8 asi
              como una codificacion de caracteres verdadera como UTF-8.

       --no-hyphenation, --nh
              Normalmente, nroff parte el texto con guiones automaticamente en
              los saltos de linea incluso en palabras que no contienen
              guiones, si es necesario hacerlo para disponer las palabras en
              una linea sin espaciado excesivo.  Esta opcion desactiva los
              guiones automaticos, por lo que las palabras solo seran partidas
              con guiones si ya tienen guiones.

              Si esta escribiendo una pagina de manual y simplemente quiere
              impedir que nroff parta palabras por medio de guiones en un
              punto inapropiado, no debe utilizar esta opcion, sino consultar
              la documentacion 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 automaticamente el texto en ambos
              margenes.  Esta opcion desactiva la justificacion completa,
              dejando justificado solo al margen izquierdo, algunas veces
              llamado texto <<irregular por la derecha>>.

              Si esta escribiendo una pagina de manual y simplemente quiere
              impedir que nroff justifique cierto parrafo, no utilice esta
              opcion; es mejor que consulte la documentacion 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 tendran 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 opcion anula la variable de entorno $MANROFFSEQ.  zsoelim
              siempre se ejecuta como el primer preprocesador.

       -t, --troff
              Utilice groff -mandoc para dar formato a la pagina de manual
              hacia la salida estandar.  Esta opcion no se requiere en
              conjucnion 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 opcion hace que groff produzca salida HTML y muestre esa
              salida en un navegador web.  La eleccion del navegador esta
              determinada por el argumento opcional navegador si se
              proporciona, por la variable de entorno $BROWSER o por uno
              predefinido en tiempo de compilacion si aquella se ha anulado
              (habitualmente lynx).  Esta opcion implica -t y solo funciona
              con GNU troff.

       -X[ppp], --gxditview[=ppp]
              La opcion muestra la salida de groff en una ventana grafica
              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 tipografia base de 12 puntos.
              Esta opcion implica -T con los respectivos dispositivos X75,
              X75-12, X100 o X11-12.

       -Z, --ditroff
              groff ejecuta troff y despues utiliza un post-procesador
              adecuado para generar la salida adecuada para el dispositivo
              elegido.  Si groff -mandoc es groff, esta opcion 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 informacion sobre la version.

ESTADO DE SALIDA
       0      Ejecucion del programa correcta.

       1      Error de uso, de sintaxis o del archivo de configuracion.

       2      Error operacional.

       3      Un subproceso devolvio un estado de salida distinta de cero.

       16     Al menos una de las paginas/archivos/palabras_clave no existe o
              no coincide.

ENTORNO
       MANPATH
              Si $MANPATH esta establecida, su valor se emplea como ruta para
              buscar paginas de manual.

              Vea la seccion RUTA DE BUSQUEDA de manpagh(5) para conocer el
              comportamiento predeterminado y los detalles acerca de como se
              utiliza esta variable de entorno.

       MANROFFOPT
              Cada vez que man invoca al formateador (nroff, troff or groff),
              anade el contenido de $MANROFFOPT a la linea de ordenes 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 esta establecida, su valor se emplea para
              determinar el conjunto de preprocesadores a traves de los cuales
              se pasa cada pagina de manual.  La lista de preprocesadores
              predeterminados depende del sistema.

       MANSECT
              Si $MANSECT esta establecida, su valor es una lista de secciones
              delimitadas por dos puntos y se emplea para determinar en que
              secciones de manual buscar y en que orden.  Lo predeterminado es
              "1 1p n l 8 3 3p 0 0p 2 3type 5 4 9 6 7", salvo que este anulado
              por la directiva SECCION en /etc/man_db.conf.

       MANPAGER, PAGER
              Si $MANPAGER o $PAGER esta establecida ($MANPAGER tiene
              preferencia), su valor se emplea como nombre del programa
              utilizado para mostrar la pagina de manual.  A falta de otra
              indicacion, se utiliza less, o se recurre a cat si less no se
              encuentra o no es ejecutable.

              El valor puede ser un nombre de orden simple o una orden con
              argumentos y puede utilizar entrecomillado de shell (barra
              inclinada hacia atras, comillas sencillas o comillas dobles).
              No pueden utilizar tuberias para conectar varias ordenes; si
              hicera falta, utilice un script que coja el archivo que hay que
              mostrar de un argumento o de la entrada estandar.

       MANLESS
              Si $MANLESS esta establecida, su valor se emplea como indicador
              predefinido para el paginador less, como si se hubiera pasado
              utilizando la opcion -r (asi, 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 opcion -r, se anula esta variable de entorno.

       BROWSER
              Si $BROWSER esta establecida, su valor es una lista de ordenes
              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 unico
              signo de porcentaje (%), y %c se sustituye por dos puntos (:).

       SYSTEM Si $SYSTEM esta establecida, tendra el mismo efecto que si se
              hubiera especificado como el argumento de la opcion -m.

       MANOPT Si $MANOPT esta establecida, se analiza antes que la linea de
              ordenes de man y se espera que este en un formato similar.  Como
              todas las demas variables de entorno especificas de man pueden
              expresarse como opciones de la linea de ordenes y, por tanto,
              son candidatas para ser incluidas en $MANOPT, se supone que
              acabaran quedando obsoletas.  N.B.  Todos los espacios que
              deberian ser interpretados como parte del argumento de una
              opcion deben escaparse.

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

       MAN_KEEP_FORMATTING
              Normalmente, cuando la salida no esta siendo dirigida a un
              terminal (como a un archivo o a una tuberia), se descartan los
              caracteres de formato para hacer mas legible el resultado sin
              necesidad de herramientas especiales. Sin embargo, si
              $MAN_KEEP_FORMATTING esta establecida a cualquier valor no
              vacio, estos caracteres de formato se retienen, lo cual puede
              ser util para que programas que utilizan man puedan interpretar
              los caracteres de formato.

       MAN_KEEP_STDERR
              Normalmente, cuando la salida esta dirigida a un terminal
              (habitualmente un paginador), se descarta toda la salida de
              error procedente de la orden utilizada para generar versiones
              formateadas de paginas 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 tipograficos como alineamiento pobre, poco vistosos y
              generalmente confusos cuando se muestran junto con la pagina del
              manual.  Sin embargo, algunos usuarios quieren verlos de todas
              formas, por lo que, si se establece $MAN_KEEP_STDERR a un valor
              no vacio, la salida de error se mostrara como siempre.

       MAN_DISABLE_SECCOMP
              En Linux, man normalmente aisla subprocesos que manejan
              informacion no confiable usando un entorno aislado seccomp. Esto
              hace mas seguro ejecutar codigo de analisis complejo sobre
              paginas de manual. Si esto sale mal por alguna razon que no este
              relacionada con el contenido de la pagina mostrada, puede usted
              asignar a $MAN_DISABLE_SECCOMP cualquier valor no vacio para
              deshabilitar el aislamiento.

       PIPELINE_DEBUG
              Si la variable de entorno $PIPELINE_DEBUG se establece en "1",
              entonces man enviara mensajes de depuracion al flujo de error
              estandar describiendo cada subproceso que ejecute.

       LANG, LC_MESSAGES
              Segun el sistema y la implementacion, se examinara una de las
              variables de entorno $LANG o $LC_MESSAGES, o ambas, para
              determinar la localizacion de mensajes actual.  man muestra sus
              mensajes para esa localizacion (si esta disponible).  Vease
              setlocale(3)  para detalles especificos.

ARCHIVOS
       /etc/man_db.conf
              archivo de configuracion de man-db.

       /usr/share/man
              Una jerarquia global de paginas de manual.

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

VEASE TAMBIEN
       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 documentacion 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) aplico 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 mejoro este paquete para el proyecto
       Debian, con la ayuda de toda la comunidad.

       El 31 de marzo de 2001 - dia presente: Colin Watson
       <cjwatson@debian.org> ahora esta 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)