tldr : Résumez les pages de manuel en exemples concis sous Linux et macOS

Quand tout le reste échoue, lisez le manuel. Les utilisateurs de la ligne de commande sous Linux et macOS savent qu'ils peuvent taper man suivi d'une commande pour accéder à une explication détaillée. Ces pages de manuel sont riches en informations, mais parfois verbeuses. Une aide-mémoire concise suffit souvent à rafraîchir la mémoire.

Découvrez tldr (pour "Too Long; Didn't Read"), un outil en ligne de commande qui fournit des résumés pratiques et exemples d'usage courants pour les commandes shell. Cet utilitaire open-source transforme les manuels exhaustifs en guides rapides et actionnables.

Installer tldr sur Ubuntu

tldr n'est pas disponible dans les dépôts Ubuntu standards, mais son installation via Node.js est simple et rapide.

Installez d'abord Node.js et npm :

sudo apt install nodejs npm

Puis installez tldr globalement :

sudo npm install -g tldr

Si une erreur "Aucun fichier ou répertoire de ce type" apparaît, créez un lien symbolique :

sudo ln -s /usr/bin/nodejs /usr/bin/node

Installer tldr sur macOS

Utilisez Homebrew, le gestionnaire de paquets incontournable pour macOS. Il simplifie l'installation d'utilitaires CLI et d'apps comme Firefox ou GIMP.

Si Homebrew n'est pas installé, visitez brew.sh pour copier la commande d'installation. Exécutez-la dans le Terminal (Applications > Utilitaires).

Une fois Homebrew prêt, installez tldr :

brew install tldr

Vous êtes opérationnel !

Utilisez tldr pour maîtriser rapidement une commande

Comparez avec ls (exemples sous Linux, identiques sur macOS).

man ls affiche une page exhaustive :

man ls

tldr ls offre des exemples directs :

tldr ls

Version web de tldr

Sans installation ? Rendez-vous sur tldr.ostera.io. Recherchez une commande comme "ls" pour des résumés instantanés, plus lisibles encore.

Contribuez via GitHub ou téléchargez des PDF hors ligne. Apps mobiles disponibles (Android/iOS).

Les pages man restent indispensables

tldr excelle pour les bases, mais consultez man pour les options avancées. Exemples pour ls :

• -R : Liste récursive des sous-répertoires.
• -X : Tri par extension.
• -d : Répertoires seulement.

Pour rm (attention : destructeur !) :

• -I : Confirmation pour >3 fichiers ou récursif.
• -d : Répertoires vides.

Note : rm nécessite -r/-R pour les répertoires non vides.

Gagnez du temps avec tldr

tldr fournit exemples bash précis, même pour builtins comme cd (voir man bash-builtins). Essayez Fish shell pour autosuggestions et scripting moderne.

Préférez-vous les résumés tldr ou les man complets ? Partagez en commentaires !