TLDR: Un resumen de las páginas de Man en GNU/Linux
Si te gusta ir “al grano” y no te gustan los rodeos, la herramienta TLDR es para ti. Sin duda la herramienta man es una de las más utilizadas, ya que con ella podemos obtener información detallada y extensa de la mayoría de los comandos disponibles en GNU/Linux (con permiso de otras herramientas como info)
Uno de los problemas precisamente de man, es la información tan extensa que nos ofrece. Para solventarlo tenemos TLDR. En estos tiempos que corren prima lo inmediato y lo breve. Las páginas de TLDR, acrónimo en inglés de “Too Long; Didn’t Read”, esto es, “Demasiado largo; no leí”, se resumen en ejemplos prácticos de uso de comandos, en diferentes sistemas operativos, incluido, como no, GNU/Linux. Simplifican las páginas del manual ofreciendo ejemplos prácticos.
La herramienta está disponible utilizando una licencia MIT
Instalación de las páginas TLDR en GNU/Linux
Vamos a ver como instalarlo en GNU/Linux, utilizando para ello un ejemplo de instalación en Centos 7, como ejemplo de un sistema con paquetería RPM; además de su instalación en un sistema Ubuntu 18.04, con paquetería DEB
Instalación de TLDR utilizando Node.js y npm
En ambos casos podemos utilizar dos vías de instalación. La primera es utilizar la herramienta ‘npm’, ya que el producto utilizada Node.js
Si la quieres utilizar en Centos 7, recuerda que explicamos hace poco como instalar Node.js y npm en este sistema operativo:
Instalar Node.js y npm en Centos 7
En este caso la instalación de TLDR sería:
sudo npm install -g tldr
Si utilizamos un sistema Ubuntu 18.04, realizaríamos estos pasos:
sudo apt install npm
sudo npm install -g tldr
Instalación de TLDR utilizando un paquete Snap
Tal y como indica el título de este apartado, también podemos utilizar el paquete Snap para la instalación, como sigue:
sudo snap install tldr
Con el resultado:
Instalación de TLDR vía el gestor Snap en Ubuntu 18.04
Para instalar paquetes Snap en Centos 7, puedes consultar la siguiente entrada que escribí recientemente:
Instalar paquetes Snap en Centos 7
En Ubuntu, como no podía ser de otra manera, ya viene preinstalado este sistema de paquetes.
Tras realizar la instalación, ya podemos ver los resúmenes de las páginas de man de cualquier comando, por ejemplo, el comando ‘cat’
TLDR mostrando información de cat
Además, utilizando el parámetro «-l«, listamos todos los comandos de lo que TLDR tiene información:
Utilizando «-a«, listamos los programas que están almacenados en su caché.
Con «-u» actualizamos su caché y con «-c» lo vaciamos.
Con el parámetro «-s» podemos realizar búsquedas.
Para que nos muestre un comando de manera aleatoria «-r»
Información de sudo vía TLDR en Ubuntu 18.04
Si deseamos ver todas las opciones disponibles usaremos «-h»
Por último, podemos consultar los clientes soportados por el producto en: TLDR Clients
Fuentes consultadas:
