Una de las habilidades más importantes que puedes aprender como usuario de Linux es cómo usar una página man, o “página de manual”.
Este artículo te presentará esos documentos simples. Aprenderás a abrir páginas man e identificar los contenidos que contiene, que incluirán marcas especiales como texto en negrita y subrayado junto con indicadores como elipses (…) y corchetes ([]).
Las páginas man son bastante fáciles de abordar, y tu tiempo es valioso, así que no lo perdamos.
En cualquier terminal que tengas a mano, escribe:
man <nombre de página>
Si deseas abrir la página para xterm, escribe man xterm.
Las páginas man están ordenadas en secciones. A veces las encontrará listadas con su número de sección, como “tty (4)”. El número de sección aquí se refiere al terminal de control tty en la sección “Archivos especiales (dispositivos)”, que es parte de las secciones estándar de las páginas man enumerados en el enlace en este párrafo.
Cada vez que veas una lista como “tty (4)”, puedes acceder a esa sección escribiendo:
man <número de sección> <nombre de página>
La sintaxis man 4 tty alcanzará la referencia de página aquí.
Encontrar una página específica
Si quieres ver si existe una página man, prueba:
whatis <palabra>
como whatis xterm.
Supongamos que no sabes qué página necesitas, pero sabes que quieres leer sobre terminales. Puedes buscar una palabra clave al actualizar primero la memoria caché de su página manual con el comando:
mandb
La búsqueda con:
man -k <palabra>
La sintaxis man -k terminal es apropiada para esta suposición.
Puedes canalizar la salida larga en el lector de texto utilizando less:
man -k terminal | less
Eso hará que sea más fácil desplazarse y buscar elementos.
Sintaxis de la página man
Hablando de lectores de texto, probablemente encontrarás un primo más pequeño de less, conocido como more, en tu sistema. Abre tu página de man con:
man more
Será como la imagen:
La razón por la que la página man de more funciona bien como ejemplo es debido a la sintaxis que se muestra en su sección Sinopsis. Se lee “more [opciones] archivo …”
Si bien eso puede no parecer complejo, las variaciones en el estilo y la forma del texto son todas importantes para esa línea.
Texto en negrita
Cualquier texto en negrita significa que debes escribirlo exactamente como se muestra. Al usar la utilidad more, tendrás que escribir la palabra “more” al comienzo de cada comando.
Soportes
El texto que se muestra entre paréntesis es opcional. En el caso de more, puedes usar opciones como -f para contar líneas lógicas o -c para pintar líneas en lugar de desplazarlas. El comienzo de un comando more podría verse así:
more -f
o bien,
more -f -c
Dado que esos parámetros son opcionales, puedes omitirlos por completo.
Texto subrayado o en cursiva
Dependiendo de las capacidades de tu terminal, es probable que veas texto subrayado y en cursiva en ciertos lugares. A veces, ese texto también puede ser de un color diferente. En cualquier caso, este tipo de texto significa que debes reemplazarlo con un argumento apropiado.
En este ejemplo con more, debes reemplazar “archivo” por un nombre de archivo, more -c archivo.txt tiene sentido aquí.
Elipses
Una elipsis que se muestra después de cualquier argumento – archivo … – o expresión – [opciones] … – significa que el argumento o la expresión es repetible.
Lo que obtienes con more en el archivo … significa algo así como:
more -f text.txt anothertext.txt
En este caso, more leerá “text.txt”, lo imprimirá en la pantalla, permitirá desplazarte si es necesario y luego tomará medidas en “anothertext.txt”.
Otro tipo de indicador que verás en las páginas man es “|”. Este símbolo significa “o”, y en una página man muestra que, por ejemplo, no se permiten dos opciones al mismo tiempo.
El ejemplo más utilizado anteriormente no enumera ningún parámetro como exclusivo, por lo que no hay un ejemplo relevante para mostrar para esa utilidad. Sin embargo, si lees un puñado de otras páginas man, encontrará algo parecido a -a | -b, y eso significa que solo puede usar -a o -b en un comando.
Secciones de una página man
También verás varias secciones en páginas man que se repiten una y otra vez. Por lo general, verás las secciones “NOMBRE”, “SINOPSIS”, “DESCRIPCIÓN”, “EJEMPLOS” y “VÉASE TAMBIÉN”, todas en mayúsculas para mayor claridad. Las secciones “OPCIONES” y “COMANDOS” a menudo estarán presentes también.
La mayoría de las secciones son de naturaleza autoexplicativa. Normalmente puedes comenzar desde la parte superior de cualquier página man y obtener una breve descripción de su contenido con las secciones Nombre, Sinopsis y Descripción. Después, puedes examinar sus opciones y ejemplos para ver el uso común.
