man page (Español)

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.

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

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 ).

Están disponibles las siguientes traducciones:

  • man-pages-cs para el checo
  • man-pages-da para el denés
  • para el alemán
  • para el griego
  • para el español
  • para el finés
  • man-pages-fr para el francés
  • man-pages-hu para el húngaro
  • para el indonesio
  • para el italiano
  • para el japonés
  • para el macedonio
  • para el holandés
  • para el polaco
  • para el portugués de brasil
  • para el rumano
  • para el ruso
  • man-pages-sr para el serbio
  • para el sueco
  • man-pages-trAUR para el turco
  • para el ucraniano
  • para el vietnamita
  • para el chino simplificado
  • 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:

  • 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), , etc. Para obtener una lista completa, véase .

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 y . 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 , en vez de la que trata la orden .

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 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.

Puede ver una descripcion de una línea de las páginas del manual usando el comando . Por ejemplo, para una breve descripción de las páginas del manual de 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 .

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 puede hacerlo de la siguiente manera:

Leyendo páginas del manual locales

En vez de usar la interfaz estándar, usar navegadores como 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:

mandoc

Instale el paquete mandoc. Para convertir una página, por ejemplo , ejecute:

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

Ahora abra el fichero llamado 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 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 para determinar que navegador usa por defecto. Sino, puede pasar como argumento el binario a la opción -H.

roffit

Primero instale 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 , 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 en o 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:

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

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

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).

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:

Véase también

This article is issued from Archlinux. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.