<<<<<<< HEAD

A collection of simplified and community-driven man pages.

Install it with sudo npm install -g tldr or try the web client.

New to the command-line world? Or just a little rusty? Or perhaps you can't always remember the arguments to lsof, or tar?

upstream/master Maybe it doesn't help that the first option explained in man tar is:

-b blocksize
   Specify the block size, in 512-byte records, for tape drive I/O.
   As a rule, this argument is only needed when reading from or writing to tape drives,
   and usually not even then as the default block size of 20 records (10240 bytes) is very common.

<<<<<<< HEAD I'm sure people could benefit from simplified "show me the common usages" man pages. What about:

$ npm install -g tldr

Your favourite command isn't covered? You can think of more examples? New features?

tldr is under MIT license. You're free to modify or redistribute the source and content, but why not contribute over here? :)

Just open an issue or send a pull request, it's all Markdown stored right here on Github.

The rough guidelines are:

• each command's description should be short and sweet
• give around 5 examples of the most common usages
• when in doubt, keep new command-line users in mind

• To run the tests:

npm test

• To try out new fetching/rendering logic locally

npm start
npm run example

======= Surely people could benefit from simplified man pages focused on practical examples. How about:

This repository is just that: an ever-growing collection of examples for the most common UNIX / Linux / OSX / SunOS commands.

You can access these pages on your computer using one of the following clients:

• Alfred Workflow
• Android clients:
  • tldr-viewer, available on Google Play
  • tldroid, available on Google Play
• Bash clients:
  • tldr
  • tldr-bash-client
• C++ client: brew install tldr
• Crystal client: brew install porras/tap/tlcr
• Dart client: pub global activate tldr
• Elixir client (binaries not yet available)
• Emacs client, available on MELPA
• Go client: go get github.com/pranavraja/tldr (or platform binaries)
• iOS clients:
  • tldr-man-page, available on App Store
  • tldr-pages, available on App Store
• Node.js client : npm install -g tldr
• Perl5 client: cpanm App::tldr
• Python clients:
  • tldr-python-client : pip install tldr
  • tldr.py: pip install tldr.py
• R client: devtools::install_github('kirillseva/tldrrr')
• Ruby client: gem install tldrb
• Rust clients:
  • rust-tldr (online lookup): cargo install tldr
  • tealdeer (fully featured client with offline cache): cargo install tealdeer
• Web client: http://tldr.ostera.io/

There is also a comprehensive list of clients in our Wiki.

• Your favourite command isn't covered?
• You can think of more examples for an existing command?

Contributions are most welcome! Have a look at the contributing guidelines and go ahead!

• Cheat allows you to create and view interactive cheatsheets on the command-line. It was designed to help remind *nix system administrators of options for commands that they use frequently, but not frequently enough to remember.

• Bro pages are a highly readable supplement to man pages. Bro pages show concise, common-case examples for Unix commands. The examples are submitted by the user base, and can be voted up or down; the best entries are what people see first when they look up a command.

TL;DR stands for "Too Long; Didn't Read". It originates in Internet slang, where it is used to indicate parts of the text skipped as too lengthy. Read more in the TLDR article on Wikipedia.

upstream/master