mirror of https://github.com/CrimsonTome/tldr.git
37 lines
1.3 KiB
Markdown
37 lines
1.3 KiB
Markdown
# What is this?
|
|
|
|
New to the command-line world? Or just a little rusty?
|
|
Or, like me, you can't always remember the arguments to `lsof` or `tar`?
|
|
|
|
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.
|
|
```
|
|
|
|
I'm sure people could benefit from simplified "show me the common usages" man pages. What about:
|
|
|
|
![tldr screenshot](http://raw.github.com/rprieto/tldr/master/screenshot.png)
|
|
|
|
This repository is just that: an ever-growing collection of examples for the most common UNIX / Linux / OSX / SunOS commands.
|
|
|
|
## Clients
|
|
|
|
You can access these pages on your computer using one of the following clients:
|
|
|
|
- [Node.js client](https://github.com/rprieto/tldr-node-client)
|
|
|
|
[![NPM](https://nodei.co/npm/tldr.png)](https://www.npmjs.org/package/tldr)
|
|
|
|
There are other clients in the works... let us know if you built one and we can add it to this list!
|
|
|
|
## Contributing
|
|
|
|
- Your favourite command isn't covered?
|
|
- You can think of more examples?
|
|
|
|
Contribution are most welcome! Have a look [over here](https://github.com/rprieto/tldr/blob/master/CONTRIBUTING.md) for some rough guidelines.
|