man page (Español)

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-ja
AUR
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-tr
AUR
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
roffit
AUR
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)