De acordo com as Leis 12.965/2014 e 13.709/2018, que regulam o uso da Internet e o tratamento de dados pessoais no Brasil, ao me inscrever na newsletter do portal DICAS-L, autorizo o envio de notificações por e-mail ou outros meios e declaro estar ciente e concordar com seus Termos de Uso e Política de Privacidade.

O Comando tldr

Colaboração: Rubens Queiroz de Almeida

Data de Publicação: 22 de agost de 2024

Ler man pages em sistemas *nix, é uma empreitada de folego. A documentação do comando ls consiste de 4 páginas, cheias de opções que você nunca vai usar. Não tem como negar que as man pages são bastante detalhadas e certamente, em algumas situações, podem ser muito úteis.

Mas na correria do dia a dia, certamente vale a pena ter um comando que gere uma documentação mais objetiva, o que nos traz ao comando tldr.

O comando tldr foi criado como uma solução para a complexidade e verbosidade dos manuais tradicionais do Linux. A inspiração para o tldr (Too Long; Didn't Read) surgiu da necessidade de fornecer resumos rápidos e práticos de comandos, especialmente para novos usuários ou para aqueles que buscam uma referência rápida. O projeto foi iniciado por um desenvolvedor chamado Romain Prieto e é mantido por uma comunidade ativa no GitHub.

O tldr oferece resumos concisos e práticos dos comandos mais comuns, destacando os usos mais frequentes e exemplos claros. Isso facilita a compreensão e a aplicação imediata dos comandos, economizando tempo e esforço.

A instalação do tldr pode ser feita de várias maneiras, dependendo da sua distribuição Linux e do gerenciador de pacotes que você utiliza. Para sistemas Debian GNU/Linux e derivados, digite:

$ sudo apt install tldr

Após a instalação, o primeiro passo a ser feito é a criação da base de dados para consulta do comando tldr:

$ tldr --update

Veja só como são exibidas as opções do comando ls:

$ tldr ls
List directory contents.More information: https://www.gnu.org/software/coreutils/ls.

 - List files one per line:
   ls -1

 - List all files, including hidden files:
   ls -a

 - List all files, with trailing / added to directory names:
   ls -F

 - Long format list (permissions, ownership, size, and modification date) of all files:
   ls -la

 - Long format list with size displayed using human-readable units (KiB, MiB, GiB):
   ls -lh

 - Long format list sorted by size (descending) recursively:
   ls -lSR

 - Long format list of all files, sorted by modification date (oldest first):
   ls -ltr

 - Only list directories:
   ls -d */

Bem mais objetivo, não?

A tabela abaixo lista as opções disponíveis do comando tldr:

Comando Explicação
tldr ls Consultar um comando específico
tldr --update Atualizar o cache local do tldr
tldr --version Verificar a versão do tldr
tldr --help Obter ajuda sobre o uso do tldr
tldr -a Informações sobre o programa


Veja a relação completa dos artigos de Rubens Queiroz de Almeida