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

Adicionar comentário

* Campos obrigatórios
5000
Powered by Commentics

Comentários (3)

Avatar
Novo

Era tão bom pra ser verdade, infelizmente a saida do tldr tem umm esquema de cores muito escuro que não dá pra mudar, com meus 70 anos fica praticamente impossivel de ler. Na net só encontrei diversas reclamações sobre as cores mas nenhuma resposta (ainda)

Avatar
Novo

Olá Edson, tem a opção --no-color, ex: $ tldr --no-color ls

A ironia é que achei essa opção no MAN do TLDR! KKKKK

(Editado)
Avatar
Novo

Depois de 30 anos usando linux, finalmente aparece um comando que fala a lingua humana. Parabéns por divulgar esta preciosidade



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