man page (Español) - ArchWiki

Jump to content

# man page (Español)

7 languages

- Deutsch
- English
- Bahasa Indonesia
- 日本語
- Português
- Русский
- 中文（简体）

From ArchWiki

Esta traducción de man page fue revisada el 2022-11-01. Si existen cambios puede actualizarla o avisar al equipo de traducción.

Artículos relacionados

- Color output in console#man

Las man pages (abreviatura de «manual pages» o páginas de manual) es una forma de documentación que está disponible en casi todos los sistemas operativos derivados de UNIX, incluyendo Arch Linux. Para acceder a estas, use el comando `man`.

A pesar de la amplia cantidad de temas que estas pueden abordar, están diseñadas para ser independientes entre si; limitándose a simplemente hacer mención a otras páginas de manual cuando sea necesario. Esta es una diferencia notable con el uso de enlaces en el intento de GNU por reemplazar este tradicional formato: los documentos de información.

## Instalación

El paquete man-db es la implementación de man en Arch Linux, y less es el paginador que se usa por defecto. También puede utilizar mandoc.

man-pages provee tanto las páginas de manual del sistema operativo Linux como de POSIX.1 (véase [1][enlace roto 2023-05-06]).

Están disponibles las siguientes traducciones:

- man-pages-cs para el checo
- man-pages-da para el denés
- man-pages-de para el alemán
- man-pages-el para el griego
- man-pages-es para el español
- man-pages-fi para el finés
- man-pages-fr para el francés
- man-pages-hu para el húngaro
- man-pages-id para el indonesio
- man-pages-it para el italiano
- man-pages-jaAUR para el japonés
- man-pages-mk para el macedonio
- man-pages-nl para el holandés
- man-pages-pl para el polaco
- man-pages-pt_br para el portugués de brasil
- man-pages-ro para el rumano
- man-pages-ru para el ruso
- man-pages-sr para el serbio
- man-pages-sv para el sueco
- man-pages-trAUR para el turco
- man-pages-uk para el ucraniano
- man-pages-vi para el vietnamita
- man-pages-zh_cn para el chino simplificado
- man-pages-zh_tw para el chino tradicional

También puede buscar todas las páginas man localizadas disponibles en los repositorios oficiales y ?K=man-pages- en AUR.

También puede usar otras aplicaciones para ver las páginas de manual:

- GNOME Help — Visor para la documentación de GNOME. Puede mostrar páginas de manual con `yelp man:<name>` o el atajo de teclado (no documentado) `Ctrl+L` desde una ventana ya abierta.

  https://wiki.gnome.org/Apps/Yelp || yelp

- KHelpCenter — Aplicación para visualizar la documentación de las aplicaciones de KDE. Las páginas de manual están en «Páginas de manual de UNIX» o puede acceder a estas ejecutando `khelpcenter man:<nombre>`.

  https://userbase.kde.org/KHelpCenter/es || khelpcenter

- Konqueror — Gestor de archivos y navegador de KDE. Puede mostrar páginas de manual con `man:<nombre>`.

  https://apps.kde.org/es/konqueror/ || konqueror

- xman — Provee una visualización organizada de las páginas de manual.

  https://xorg.freedesktop.org/ || xorg-xman

## Acceder a las páginas del manual

Para leer una página del manual, introduzca:

    $ man nombre_de_página

Los manuales se clasifican en varias secciones. Cada sección tiene una introducción, como intro(1), intro(2), etc. Para obtener una lista completa, véase man-pages(7) § Secciones de las páginas del manual.

Para referirse a las páginas, utilice su nombre y el numero de sección en paréntesis. Pueden haber distintas páginas con el mismo nombre, como man(1) y man(7). En estos casos, para acceder a una o la otra, ingrese el numero de la sección y el nombre de la página del manual; por ejemplo use:

    $ man 5 passwd

Para leer la página acerca del archivo `/etc/passwd`, en vez de la que trata la orden `passwd`.

De igual manera, puede escribir el nombre y el numero de sección separados por un punto:

    $ man passwd.5

## Búsqueda de manuales

Para buscar una página del manual sin saber su nombre exacto, puede usar cualquiera de los siguientes comandos:

    $ man -k expresión
    $ man --apropos expresión
    $ apropos expresión

Note que `expresión` es interpretado como una expresión regular por defecto.

Para buscar palabras clave dentro del texto completo de las páginas, ocupe la opción `-K`.

Nota: Para realizar las búsquedas se ocupa un caché dedicado a este propósito. Por defecto, el mantenimiento de dicho caché es realizado por `man-db.service`, el cual es accionado periódicamente por `man-db.timer`. Si cada vez que realiza una búsqueda obtiene un «nada apropiado», intente volver a generar este caché manualmente ejecutando `mandb` como superusuario.

Puede ver una descripcion de una línea de las páginas del manual usando el comando `whatis`. Por ejemplo, para una breve descripción de las páginas del manual de `ls` en distintas secciones, escriba:

    $ whatis ls

    ls (1)               - lista el contenido de un directorio
    ls (1p)              - list directory contents

## Ancho de página

El ancho de la página es controlado por la variable de entorno `MANWIDTH`.

Si el numero de columnas en la terminal es muy pequeño (p.ej cuando se usa una ventana estrecha), los saltos de línea van a quedar mal ubicados, lo cual puede resultar en un texto desagradable de leer. Puede arreglar esto estableciendo MANWIDTH al invocar `man`. En `Bash` puede hacerlo de la siguiente manera:

    ~/.bashrc

    man() {
        local width=$(tput cols)
        [ $width -gt $MANWIDTH ] && width=$MANWIDTH
        env MANWIDTH=$width \
        man "$@"
    }

## Leyendo páginas del manual locales

En vez de usar la interfaz estándar, usar navegadores como lynx y Firefox para ver las páginas del manual permite a los usuarios sacarle partido al principal beneficio de las páginas info: el texto con hipervínculos. Para hacerlo, tiene varias formas:

### Convertir a HTML

#### mandoc

Instale el paquete mandoc. Para convertir una página, por ejemplo `free(1)`, ejecute:

    $ mandoc -Thtml -Ostyle=style.css /usr/share/man/man1/free.1.gz > free.html

Ahora abra el fichero llamado `free.html` en su navegador favorito.

#### man2html

Primero, instale man2html desde los repositorios oficiales.

Ahora, convierta de esta forma una página del manual:

    $ man free | man2html -compress -cgiurl man$section/$title.$section$subsection.html > ~/man/free.html

Otro uso para `man2html` es exportar texto con formato mínimo y listo para imprimir:

    $ man free | man2html -bare > ~/free.txt

#### man -H

La implementación de man-db de Arch Linux también puede hacer esto sin necesidad de otros paquetes:

    $ man -H free

Esto buscará la variable de entorno `BROWSER` para determinar que navegador usa por defecto. Sino, puede pasar como argumento el binario a la opción `-H`.

#### roffit

Primero instale roffitAUR desde el AUR.

Para convertir una página del manual:

    $ gunzip -c /usr/share/man/man1/free.1.gz | roffit > free.html

### Conversión a PDF

Las páginas del manual siempre han sido imprimibles: están escritas en troff(1), que esencialmente es un lenguaje de composición tipográfica. Por esto, usted puede convertir las páginas del manual a cualquier formato según los dispositivos de salida que groff (usado por man-db) soporte. Para ver una lista de estos dispositivos, vea la opción `-T` en groff(1) o mandoc(1) si ocupa mandoc.

Use el siguiente comando para convertir en PDF:

    $ man -Tpdf pagina_del_manual > nombre_de_archivo

Limitaciones: Las fuentes están generalmente limitadas a Times a tamaños prefijados. Algunas páginas del manual están específicamente diseñadas para verlas en terminal, y por ello no se visualizarán correctamente en PS o en PDF.

## Páginas del manual en línea

Existen numerosas bases de datos de páginas de manual en línea, incluyendo:

- Arch manual pages—Aloja las páginas de manual de los paquetes de Arch Linux. Se usa para los enlaces a páginas de manual en esta wiki. También puede acceder a las páginas directamente con con el bang de DuckDuckGo `!archman`.
- man7.org—«The Linux man-pages project». Fuente de las páginas del paquete man-pages.
- manned.org—Colección de páginas del manual de distintas distribuciones Linux, BSD, etc. y las correspondientes para varias versiones de los programas.
- linux.die.net
- man.cx
- Páginas del manual de Debian
- Páginas del manual de Ubuntu
- Páginas del manual de DragonFlyBSD
- Páginas del manual de FreeBSD
- Páginas del manual de NetBSD
- Páginas del manual de OpenBSD
- Plan 9 Manual — Volume 1
- Inferno Manual — Volume 1
- Repositorio de páginas de manual en los foros de UNIX y Linux

Tenga en cuenta que aunque man-pages proporciona páginas de manual para POSIX.1 (véase [2][enlace roto 2023-05-06]), también existe una referencia oficial en línea:

- POSIX.1-2017

También está disponible una tabla de comparación entre estas de las bases de datos en línea.

Advertencia: Algunas distribuciones proporcionan páginas de manual parcheadas u obsoletas que difieren de aquellas proporcionadas por Arch. Sea cauto al usar páginas de manual en línea.
Sugerencia: Las páginas en línea del manual de Arch se pueden representar en el terminal utilizando esta orden: `curl -sL 'https://man.archlinux.org/man/clang.raw' | man -l -`

## Páginas del manual de especial interés

A continuación se muestra una lista no exhaustiva de páginas de especial interés que podrían ayudarle a comprender muchas cosas en mayor profundidad. Algunas de ellas podrían servir como buena referencia (como la tabla ASCII).

- ascii(7)
- boot(7)
- charsets(7)
- chmod(1)
- credentials(7)
- fstab(5)
- file-hierarchy(7)
- systemd(1)
- locale(1p), locale(5), locale(7)
- printf(3)
- proc(5)
- regex(7)
- signal(7)
- term(5), term(7)
- termcap(5)
- terminfo(5)
- utf-8(7)

De formas más general, eche un vistazo a las páginas de la categoría 7 (misceláneos):

    $ man -s 7 -k ".*"

Páginas específicas de Arch Linux:

- alpm-hooks(5)
- libalpm(3)
- makepkg(8)
- makepkg.conf(5)
- makepkg-template(1)
- mkinitcpio(8)
- pacman(8)
- pacman.conf(5)
- pacman-conf(8)
- pacman-key(8)

## Véase también

- Gentoo:man page
- Write The Fine Manual with pod2man (guía para escribir páginas del manual en inglés)
- History of UNIX Manpages (Historia de las páginas del manual de UNIX; en inglés)

Category:

- Command-line (Español)

Hidden category:

- Pages with dead links