Skip to content
This repository has been archived by the owner on Aug 3, 2022. It is now read-only.
/ tldr Public archive

A tldr client in Go focusing on speed.

License

Notifications You must be signed in to change notification settings

eprovst/tldr

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

52 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Warning
This client is, currently, unmaintained. Another fast implementation you could try is tealdeer written in Rust.
For other options, see the tldr wiki.

tldr

A tldr client in Go, focusing on speed by storing pages in a database.

tldr is a collection of simplified, community-driven man pages. This application provides a fast and convenient access to these pages from the command line.

Here you see this client displaying the tldr page for Go: screenshot

As already mentioned is this client written in Go, we also uses etcd's bbolt database which makes this client super fast.

Apart from being fast, the choice of Go also allows us to support all platforms which Go compiles to.

Installation

You can use Go's tooling

go get github.com/elecprog/tldr
go install github.com/elecprog/tldr

or download a binary for Linux or Windows from the release page.

Bash completion

On platforms that support it you can add bash completion by running:

sudo env "PATH=$PATH" sh -c "tldr --bash-completion > /etc/bash_completion.d/tldr"
sudo chmod 644 /etc/bash_completion.d/tldr

Usage

  • You can print the tldr page for a command by using:
    tldr command
    
  • This client downloads all tldr pages on the first run (resulting in a database of about 800 KB) which should only take a couple of seconds. To redownload the pages and rebuild the database you can use:
    tldr -u
    
    The database is then stored in the cache directory of your platform.
  • If you want all the commands matching a grep style regex, let's say g[ie]t$, use:
    tldr -s 'g[ie]t$'