2015-12-05 01:54:20 +01:00
|
|
|
# tldr
|
|
|
|
|
|
|
|
[![Build Status][travis-image]][travis-url]
|
|
|
|
[![Gitter chat][gitter-image]][gitter-url]
|
2016-05-15 12:43:42 +02:00
|
|
|
[![Issue Stats][issuestats-image]][issuestats-url]
|
2016-09-25 11:38:15 +02:00
|
|
|
[![CLA assistant][cla-assistant-image]][cla-assistant-url]
|
2016-02-10 00:24:03 +01:00
|
|
|
|
2015-12-05 01:54:20 +01:00
|
|
|
[travis-url]: https://travis-ci.org/tldr-pages/tldr
|
2016-02-13 00:35:09 +01:00
|
|
|
[travis-image]: https://travis-ci.org/tldr-pages/tldr.svg?branch=master
|
2015-12-05 01:54:20 +01:00
|
|
|
[gitter-url]: https://gitter.im/tldr-pages/tldr
|
2016-02-10 00:24:03 +01:00
|
|
|
[gitter-image]: https://badges.gitter.im/tldr-pages/tldr.svg
|
2016-05-15 12:43:42 +02:00
|
|
|
[issuestats-url]: http://issuestats.com/github/tldr-pages/tldr
|
|
|
|
[issuestats-image]: http://issuestats.com/github/tldr-pages/tldr/badge/pr?style=flat
|
2016-09-25 11:38:15 +02:00
|
|
|
[cla-assistant-url]: https://cla-assistant.io/tldr-pages/tldr
|
|
|
|
[cla-assistant-image]: https://cla-assistant.io/readme/badge/tldr-pages/tldr
|
2015-12-05 01:54:20 +01:00
|
|
|
|
2016-02-06 12:23:19 +01:00
|
|
|
A collection of simplified and community-driven man pages.
|
2015-12-05 01:54:20 +01:00
|
|
|
|
2016-07-03 14:19:56 +02:00
|
|
|
Install it with `npm install -g tldr` or [try the web client](http://tldr.ostera.io).
|
2015-12-25 11:30:40 +01:00
|
|
|
|
2015-12-27 09:21:04 +01:00
|
|
|
## What is tldr?
|
2014-03-04 13:39:34 +01:00
|
|
|
|
|
|
|
New to the command-line world? Or just a little rusty?
|
2015-12-28 00:40:21 +01:00
|
|
|
Or perhaps you can't always remember the arguments to `lsof`, or `tar`?
|
2014-03-04 13:39:34 +01:00
|
|
|
|
|
|
|
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.
|
|
|
|
```
|
|
|
|
|
2016-05-10 15:38:11 +02:00
|
|
|
Surely people could benefit from simplified man pages focused on practical examples. How about:
|
2014-03-04 13:39:34 +01:00
|
|
|
|
2016-07-16 10:12:59 +02:00
|
|
|
![tldr screenshot](screenshot.png)
|
2014-03-04 13:39:34 +01:00
|
|
|
|
2016-05-10 15:38:11 +02:00
|
|
|
This repository is just that: an ever-growing collection of examples
|
2015-12-28 00:40:21 +01:00
|
|
|
for the most common UNIX / Linux / OSX / SunOS commands.
|
2014-03-04 13:39:34 +01:00
|
|
|
|
|
|
|
## Clients
|
|
|
|
|
|
|
|
You can access these pages on your computer using one of the following clients:
|
|
|
|
|
2016-07-03 14:19:56 +02:00
|
|
|
- [Alfred Workflow](https://github.com/cs1707/tldr-alfred)
|
2016-01-01 21:05:46 +01:00
|
|
|
- Android clients:
|
2015-12-29 13:43:20 +01:00
|
|
|
- [tldr-viewer](https://github.com/gianasista/tldr-viewer), available on
|
2015-12-30 00:34:26 +01:00
|
|
|
[Google Play](https://play.google.com/store/apps/details?id=de.gianasista.tldr_viewer)
|
|
|
|
- [tldroid](https://github.com/hidroh/tldroid), available on
|
|
|
|
[Google Play](https://play.google.com/store/apps/details?id=io.github.hidroh.tldroid)
|
2016-02-06 12:24:17 +01:00
|
|
|
- [Bash client](https://github.com/raylee/tldr)
|
|
|
|
- [C++ client](https://github.com/tldr-pages/tldr-cpp-client): `brew install tldr-pages/tldr/tldr`
|
|
|
|
- [Crystal client](https://github.com/porras/tlcr): `brew install porras/tap/tlcr`
|
|
|
|
- [Dart client](https://github.com/hterkelsen/tldr): `pub global activate tldr`
|
|
|
|
- [Elixir client](https://github.com/tldr-pages/tldr_elixir_client) (binaries not yet available)
|
2016-06-21 00:59:06 +02:00
|
|
|
- [Emacs client](https://github.com/kuanyui/tldr.el), available on [MELPA](https://github.com/melpa/melpa)
|
2016-02-06 12:26:18 +01:00
|
|
|
- [Go client](https://github.com/pranavraja/tldr): `go get github.com/pranavraja/tldr` (or [platform binaries](https://github.com/pranavraja/tldr/releases))
|
2016-01-31 00:59:57 +01:00
|
|
|
- iOS clients:
|
2016-02-06 12:24:17 +01:00
|
|
|
- [tldr-man-page](https://github.com/freesuraj/TLDR), available on [App Store](https://appsto.re/sg/IQ0-_.i)
|
|
|
|
- [tldr-pages](https://github.com/mflint/ios-tldr-viewer), available on [App Store](https://itunes.apple.com/us/app/tldt-pages/id1071725095?ls=1&mt=8)
|
|
|
|
- [Node.js client](https://github.com/tldr-pages/tldr-node-client) : `npm install -g tldr`
|
|
|
|
- [Perl5 client](https://github.com/shoichikaji/perl-tldr): `cpanm App::tldr`
|
|
|
|
- Python clients:
|
|
|
|
- [tldr-python-client](https://github.com/tldr-pages/tldr-python-client) : `pip install tldr`
|
|
|
|
- [tldr.py](https://github.com/lord63/tldr.py): `pip install tldr.py`
|
|
|
|
- [R client](https://github.com/kirillseva/tldrrr): `devtools::install_github('kirillseva/tldrrr')`
|
2015-08-08 04:18:44 +02:00
|
|
|
- [Ruby client](https://github.com/YellowApple/tldrb): `gem install tldrb`
|
2016-01-03 23:53:15 +01:00
|
|
|
- Rust clients:
|
|
|
|
- [rust-tldr](https://github.com/rilut/rust-tldr) (online lookup): `cargo install tldr`
|
2016-04-17 02:22:17 +02:00
|
|
|
- [tealdeer](https://github.com/dbrgn/tealdeer) (fully featured client with offline cache): `cargo install tealdeer`
|
2016-07-03 14:19:56 +02:00
|
|
|
- [Web client](https://github.com/ostera/tldr.jsx): http://tldr.ostera.io/
|
2014-03-05 10:10:32 +01:00
|
|
|
|
2016-02-06 12:26:18 +01:00
|
|
|
There is also a comprehensive [list of clients in our Wiki](https://github.com/tldr-pages/tldr/wiki/TLDR-clients).
|
2014-03-04 13:39:34 +01:00
|
|
|
|
|
|
|
## Contributing
|
|
|
|
|
|
|
|
- Your favourite command isn't covered?
|
2015-12-28 00:40:21 +01:00
|
|
|
- You can think of more examples for an existing command?
|
2014-03-04 13:39:34 +01:00
|
|
|
|
2015-12-28 00:40:21 +01:00
|
|
|
Contributions are most welcome!
|
|
|
|
Have a look at the [contributing guidelines](https://github.com/tldr-pages/tldr/blob/master/CONTRIBUTING.md)
|
|
|
|
and go ahead!
|
2016-01-03 14:34:57 +01:00
|
|
|
|
|
|
|
## Similar projects
|
|
|
|
|
2016-05-10 15:38:11 +02:00
|
|
|
- [Cheat](https://github.com/chrisallenlane/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.
|
2016-01-03 14:34:57 +01:00
|
|
|
|
2016-05-10 15:38:11 +02:00
|
|
|
- [Bro pages](http://bropages.org/) are a highly readable supplement to man pages.
|
|
|
|
Bro pages show concise, common-case examples for Unix commands.
|
2016-05-15 12:56:59 +02:00
|
|
|
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.
|
2016-02-06 12:23:19 +01:00
|
|
|
|
2016-05-10 15:38:11 +02:00
|
|
|
## What does "tldr" mean?
|
2016-02-06 12:23:19 +01:00
|
|
|
|
|
|
|
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](https://en.wikipedia.org/wiki/TL;DR).
|