Man pages were my go-to resource when I started exploring Linux. Certainly,
man is the most frequently used command when a beginner starts getting familiar with the world of the command line. But man pages, with their extensive lists of options and arguments, can be hard to decipher, which makes it difficult to understand whatever you wanted to know. If you want an easier solution with example-based output, I think tldr is the best option.
Tealdeer is a wonderful implementation of tldr in Rust. It's a community-driven man page that gives very simple examples of how commands work. The best part about Tealdeer is that it has virtually every command you would normally use.
On Linux, you can install Tealdeer from your software repository. For example, on Fedora:
$ sudo dnf install tealdeer
On macOS, use MacPorts or Homebrew.
Alternately, you can build and install the tool with Rust's Cargo package manager:
$ cargo install tealdeer
tldr --list returns the list of man pages tldr supports, like
zgrep, and so on:
$ tldr --list 2to3 7z 7za 7zr [ a2disconf a2dismod a2dissite a2enconf a2enmod a2ensite a2query [...]
tldr with a specific command (like
tar) shows example-based man pages that describe all the options that you can do with that command:
$ tldr tar Archiving utility. Often combined with a compression method, such as gzip or bzip2. More information: <https://www.gnu.org/software/tar>. [c]reate an archive and write it to a [f]ile: tar cf target.tar file1 file2 file3 [c]reate a g[z]ipped archive and write it to a [f]ile: tar czf target.tar.gz file1 file2 file3 [c]reate a g[z]ipped archive from a directory using relative paths: tar czf target.tar.gz --directory=path/to/directory . E[x]tract a (compressed) archive [f]ile into the current directory [v]erbosely: tar xvf source.tar[.gz|.bz2|.xz] E[x]tract a (compressed) archive [f]ile into the target directory: tar xf source.tar[.gz|.bz2|.xz] --directory=directory [c]reate a compressed archive and write it to a [f]ile, using [a]rchive suffix to determine the compression program: tar caf target.tar.xz file1 file2 file3
To control the cache:
$ tldr --update $ tldr --clear-cache
You can give Tealdeer output some color with the
--color option, setting it to
never. The default is
auto, but I like the added context color provides, so I make mine permanent with this addition to my
alias tldr='tldr --color always'
The beauty of Tealdeer is you don't need a network connection to use it, except when you're updating the cache. So, even if you are offline, you can still search for and learn about your new favorite command. For more information, consult the tool's documentation.
Would you use Tealdeer? Or are you already using it? Let us know what you think in the comments below.