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: [_[.[,]]] 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 '\" 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 <>). 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 <> 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 <> 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 <> 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 255 - - continuacion vineta (punto 267 o o medio) tilde 264 ' ' signo de 327 x x multiplicar 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 <>. 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 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 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.12.1 2024-04-05 MAN(1)