Una de las habilidades más importantes que puede aprender como usuario de Linux es cómo usar una página de manual o «página man».
Este artículo le presentará esos documentos simples. Aprenderá cómo abrir páginas de manual e identificar el contenido dentro, que incluirá marcas especiales como audaz y subrayada texto junto a indicadores como puntos suspensivos (…) y corchetes ([ ]).
Las páginas de manual son bastante fáciles de abordar y su tiempo es valioso, así que no perdamos ni un minuto más.
Apertura de páginas man
En cualquier terminal que tengas a mano, escribe
para abrir una página de manual. Si desea abrir la página para xterm, una terminal probablemente en su sistema, escriba man xterm.
Las páginas del manual se ordenan en secciones. A veces los encontrará listados con su número de sección, como “tty(4)”. los numero de sección aquí se refiere al terminal de control de tty en la sección «Archivos especiales (dispositivos)», que forma parte de las secciones estándar de las páginas del manual enumeradas en el enlace de este párrafo.
Cada vez que vea una lista como «tty(4)», puede llegar a esa sección escribiendo
man <section number> <page name>
la sintaxis man 4 tty llegará a la página de referencia aquí.
Encontrar una página específica
Si alguna vez quiere ver si existe una página man, intente
me gusta whatis xterm.
Suponga que no sabe qué página necesita, pero sabe que quiere leer sobre terminales. Puede buscar una palabra clave actualizando primero la memoria caché de la página del manual con el comando
Luego busca con
la sintaxis man -k terminal es apropiado en esta situación.
Puede canalizar menos la salida larga al lector de texto usando
Eso hará que sea más fácil desplazarse y buscar elementos.
Sintaxis de la página del manual
Hablando de lectores de texto, probablemente encontrará lessel primo menor de , conocido como more, en su sistema. Abrir su página de manual con
Debería verse como la siguiente imagen.
La razón moreLa página del manual de funciona bien como ejemplo debido a la sintaxis que se muestra en su sección Sinopsis. Se lee «más [options] expediente…”
Si bien eso puede no parecer complejo, las variaciones en el estilo y la forma del texto son importantes para esa línea.
Texto en negrita
Cualquier texto en negrita significa que debe escribirlo exactamente como se muestra. Cuando utilice la utilidad more, deberá 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 más podría verse como
o
Dado que esos parámetros son opcionales, puede omitirlos por completo.
Texto subrayado o en cursiva
Dependiendo de las capacidades de su terminal, es probable que vea texto subrayado y en cursiva en ciertos lugares. A veces, dicho texto también puede ser de un color diferente. En cualquier caso, este tipo de texto significa que debe reemplazarlo con un argumento apropiado.
En este ejemplo con más, debe reemplazar “expediente” con un nombre de archivo. more -c file.txt tiene sentido aquí.
elipses
Se muestran puntos suspensivos después de cualquier argumento: file... – o expresión – [options]... – significa que el argumento o la expresión es repetible.
Lo que obtienes con más en file... significa que algo como
more -f text.txt anothertext.txt
esta permitido. En este caso, más leerá «texto.txt», lo imprimirá en la pantalla, le permitirá desplazarse si es necesario y luego tomará medidas en «otrotexto.txt».
O
Otro tipo de indicador que verá en las páginas man es el “|.” Este símbolo significa «o» y en una página de manual le muestra que, por ejemplo, no se permiten dos opciones juntas a la vez.
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 lee un puñado de otras páginas del manual, se encontrará con algo como -a|-by eso significa que solo puedes usar -a o -b en un comando.
Secciones de una página de manual
También verá varias secciones en las páginas man que se repiten una y otra vez. Por lo general, verá las secciones «NOMBRE», «SÍNOPSIS», «DESCRIPCIÓN», «EJEMPLOS» y «VER TAMBIÉN», todas enumeradas en letras mayúsculas para mayor claridad. Las secciones «OPCIONES» y «COMANDOS» a menudo también estarán presentes.
La mayoría de las secciones se explican por sí mismas. Por lo general, puede comenzar desde la parte superior de cualquier página man y obtener una breve descripción general de su contenido con las secciones Nombre, Sinopsis y Descripción. Luego, puede examinar sus opciones y ejemplos para ver el uso común.
Las terminales a menudo usan la utilidad less para leer las páginas de manual, por lo que debería poder buscar cualquier frase con /.
Conclusión
Si bien las páginas de manual pueden no ser elegantes, contienen una gran cantidad de información. Ahora que está familiarizado con la sintaxis básica que se encuentra en la mayoría de las páginas del manual, puede usar una fácilmente la próxima vez que se quede atascado al usar una utilidad.
Además, no olvides que man man es su amigo y cubrirá todos los detalles no discutidos aquí.