Commit Graph

1743 Commits (338f4be207bca21d80e02a6734b0a66830ee04c9)

Author SHA1 Message Date
Starbeamrainbowlabs a50427e89f mktemp.md: add page (#1393) 2017-05-26 10:28:13 +01:00
Waldir Pimenta 57a982446a brew: expand example descriptions (#1387) 2017-05-24 21:31:16 +01:00
kalebo 4e544c1230 logwatch: add page (#1311)
Logwatch is a useful command to summarize log files. It can be configured to use settings from it's config file and run by cron, but it can also be useful to run ad-hoc from the command line.
2017-05-24 09:43:38 +01:00
Starbeamrainbowlabs 497a561ae1 Update quota.md 2017-05-24 09:32:16 +01:00
kalebo d0ebfa44a5 Tweaked quota example 2017-05-24 09:32:16 +01:00
Vivek Krishnakumar db766044de mosh: add page (#1384) 2017-05-24 12:03:32 +05:30
Waldir Pimenta 6b1e4f24ab cmake: add mkdir to the out-of-source build ex. 2017-05-22 20:41:16 +01:00
Waldir Pimenta 08da564f80 mutt: add reference to draft format
as discussed in PR #1258
2017-05-22 16:43:10 +01:00
Waldir Pimenta efbf0cc51e perl: tweak the -0 example 2017-05-22 19:47:03 +05:30
Waldir Pimenta dc9547925f perl: swap -M example with -0, for multiline regex
For completeness: the -0 option is actually used to specify the input record separator (as an octal number).
Without it, the record separator is the newline character, i.e. the files are processed line by line
(which doesn't allow find-replace expressions that include newlines to work).

According to the [documentation](http://perldoc.perl.org/perlrun.html#Command-Switches),
using plain `-0` is not guaranteed to have the effect of parsing the entire file,
because if the file does contain characters with octal value equal to the parameter passed to (or implied by) the -0 option,
these characters will be treated as line breaks.
However, if the value exceeds 377<sub>8</sub> (i.e. 255), it won't be matched to characters on the file.
777 is the preferred convention within that exceptional range, as the highest value that keeps to 3 octal digits.

Here we're forgoing such details and using -0 anyway, since for most cases this will be enough.
2017-05-22 19:47:03 +05:30
Waldir Pimenta 1de00d2f11 brew cask: add page (#1376) 2017-05-22 14:49:40 +01:00
bigspennyj 04ecf81efc mutt: add page (#1258) 2017-05-22 11:52:55 +05:30
Starbeamrainbowlabs ca3ee12c17 prosodyctl: add page (#1382) 2017-05-19 13:33:25 +05:30
Starbeamrainbowlabs 93348478a1 lua: add page (#1381) 2017-05-19 08:47:18 +01:00
Starbeamrainbowlabs 1ff585c6fd New command: calc (#1380) 2017-05-18 23:34:36 +05:30
Waldir Pimenta 595c4eb234 git-reset: add simpler --hard example 2017-05-18 17:25:09 +01:00
Waldir Pimenta 05780d6183 git-checkout: "modifications" --> "changes" 2017-05-18 17:24:52 +01:00
Waldir Pimenta 6f9dbe9fce git-checkout: mention reset, add single-file ex. 2017-05-18 17:24:52 +01:00
Waldir Pimenta 88eea86117 cmake: directory --> folder; fix typo 2017-05-16 11:37:47 +01:00
Damian Peterson 9fbc74e1de lxc: add page (#1371) 2017-05-16 10:42:11 +05:30
Damian Peterson 1ceb440ea4 vimdiff: add page (#1373) 2017-05-14 21:27:16 +01:00
Wolfgang Lutz 550ede5cfb fix typos using misspell (#1374) 2017-05-12 10:29:18 +01:00
Starbeamrainbowlabs c0616697ed jpegoptim: add page (#1370)
* New command: jpegoptim

* Update jpegoptim.md
2017-05-10 20:46:18 +01:00
Starbeamrainbowlabs 8125f34ee7 New command: hostnamectl 2017-05-07 17:11:41 +05:30
Waldir Pimenta c9063d15b9 telnet: improve descriptions (#1353)
* telnet: improve descriptions

also format "x" as a token in the last example.

* telnet: update per code review
2017-05-04 20:50:30 +01:00
Waldir Pimenta 7ca686634d jq: clarify descriptions (#1361) 2017-05-04 09:35:38 +01:00
Waldir Pimenta 776fdcf77a cmake: fix syntax and adjust per code review 2017-05-04 08:46:54 +01:00
PFCKrutonium d3fed3b31f cmake: add page (closes #1172) 2017-05-04 08:46:54 +01:00
Starbeamrainbowlabs e8d141b6c4 whatis: add glob example (#1365) 2017-05-04 08:38:06 +01:00
Waldir Pimenta 7a9c755e4e pygmentize: various tweaks (#1355)
* pygmentize: various tweaks

- adjust punctuation in main description and first example's description
- mention "list" (rather than "show") in the -L examples, to improve memorability
- explain what lexers are
- clarify which of the parameters are input and output filenames
- simplify last example

* make -O example more didactic

References:
- http://pygments.org/docs/cmdline/#options-and-filters
- http://pygments.org/docs/formatters/#HtmlFormatter

* pygmentize: changes per code review

* pygentize: fix typos
2017-05-03 20:54:49 +01:00
Waldir Pimenta f7b60eb9c6 pvcreate: tweaks to descriptions (#1336) 2017-05-02 13:48:58 +01:00
Waldir Pimenta b3654135a8 cal: adjust osx version to make it more useful, and add linux version along the same lines 2017-05-02 08:10:49 +01:00
Waldir Pimenta 97265cba29 cal: move from pages/common/ to pages/osx/, so the content corresponds to the command version 2017-05-02 08:10:49 +01:00
Waldir Pimenta d6e709fd3d imgcat: slight rephrase of main desc 2017-05-02 12:38:18 +05:30
Waldir Pimenta b893232f48 yesod: tweak main description (#1362) 2017-05-01 20:11:23 +01:00
Waldir Pimenta 85212343a0 timew: tweaks to descriptions 2017-05-01 15:00:12 +01:00
Waldir Pimenta 3b0cf23bac pm2: add article in last two examples 2017-05-01 11:16:05 +01:00
Moti Korets 2f03bc1362 at: add page, atq: add page, atrm: add page, and batch: add page (#1344)
commands to queue commands execution at specified time
or when system load allows
2017-05-01 11:06:06 +01:00
Waldir Pimenta 2a4379ceea git-checkout: correct checkout of remote branch (#1359)
As described in http://stackoverflow.com/a/9537923 (paraphrased below):

> You need to create a local branch that tracks a remote branch.
> The following command will create a local branch
> tracking the remote branch of the same name.
> When you push your changes the remote branch will be updated.
>
> `git checkout --track [remotename]/[branch]`
>
> This is a shorthand for `git checkout -b [branch] [remotename]/[branch]`.
>
> For git 1.7.2.3 and higher this is enough: `git checkout daves_branch`
>
> Note that with recent git versions,
> **this will command not create a local branch and will put you in a 'detached HEAD' state.**
> If you want a local branch, use the --track option.
> Full details here: http://git-scm.com/book/en/v2/Git-Branching-Remote-Branches#Tracking-Branches
2017-04-30 11:17:03 +01:00
Waldir Pimenta 433370e2ad change all keyboard shortcuts to have spaces around the + sign (#1356) 2017-04-28 23:34:51 +01:00
Waldir Pimenta 7e1f06ade4 standardize format of keyboard shortcuts (#1354)
* fix capitalization of keyboard shortcuts (elinks, tmux, screen)
* adjust formatting of keyboard shortcuts (tail, xsel)
2017-04-28 08:44:50 +01:00
Waldir Pimenta 81c7f52e9f wordgrinder: minor tweaks to descriptions 2017-04-28 08:33:05 +01:00
Agniva De Sarker 9af9eee235 minor update
adding a space after comma
2017-04-28 08:28:19 +01:00
Rudinski Zvonimir 4a0662a95e minor changes 2017-04-28 08:28:19 +01:00
Agniva De Sarker e9a443b189 simplify wordgrinder
- Removing the word terminal because its implicit
- Mentioning that it loads a blank document by default
- Removing 'press' to maintain uniformity with other pages like `rtv`
2017-04-28 08:28:19 +01:00
Agniva De Sarker d49b95fc53 Simplify pygmentize
- Simplify main description
- Mentioning that language is inferred from file extension
- Giving a concrete example for another lexer.
2017-04-28 08:28:19 +01:00
Agniva De Sarker 5c278bdf69 Update mc.md
- Usually, we do not use another command in the example of one command's description.
- Using the second line of the heading to explain further.
2017-04-28 08:28:19 +01:00
Zvonimir Rudinski 053d8dbeb0 linter fixes 2017-04-28 08:28:19 +01:00
Rudinski Zvonimir 7d360fface add pygmentize 2017-04-28 08:28:19 +01:00
Rudinski Zvonimir 6ae8e8761a Added pages for mc, tpp and wordgrinder 2017-04-28 08:28:19 +01:00
Waldir Pimenta 2a359234ba elinks: minor tweaks to command descriptions 2017-04-28 00:01:06 +01:00
Waldir Pimenta 13539295a4 elinks: fix typo (confusion of ANSI vs. ASCII) 2017-04-27 23:59:42 +01:00
Waldir Pimenta 45d9ef5b6a docker: minor tweak to first description
change "List" from a noun to a verb, to match the project's guidelines.
2017-04-27 23:55:32 +01:00
Waldir Pimenta 724ec3d5de wrap 100 in token format; mention password prompt 2017-04-27 11:04:54 +05:30
Waldir Pimenta 8241783af1 tomb: fix syntax to match guidelines 2017-04-27 11:04:54 +05:30
Waldir Pimenta 0c602a263f tomb: edit page to conform to tldr guidelines
also improve example descriptions to better match the documentation in https://www.dyne.org/software/tomb and http://tomb.dyne.org/tomb_manpage.pdf
2017-04-27 11:04:54 +05:30
Michishige Kaito c0d16b2f7e Fix lint issues. 2017-04-27 11:04:54 +05:30
Michishige Kaito 972e5889e1 tomb: add page 2017-04-27 11:04:54 +05:30
Waldir Pimenta fb7e3969fe wuzz: add primary command; de-capitalize descs 2017-04-26 13:06:27 +01:00
Agniva De Sarker 331c97b209 wrapping some items in tokens 2017-04-26 13:06:01 +01:00
Waldir Pimenta 4da1c1c3df git-rebase: improve desc of second -i example 2017-04-26 13:06:01 +01:00
Waldir Pimenta e8dd7e0b57 rephrase --onto example; add in-place rebase 2017-04-26 13:06:01 +01:00
Waldir Pimenta 8f18647c82 git-rebase: hopefully clarify some points 2017-04-26 13:06:01 +01:00
Waldir Pimenta c3146ede2a perl: improve descriptions of -pie examples 2017-04-26 10:32:58 +01:00
morrme 8b85207f35 perl: add pie example per issue #1239 2017-04-26 10:32:58 +01:00
Waldir Pimenta cd38a006d8 find: slightly reword the -not -path example 2017-04-25 22:50:51 +01:00
Waldir Pimenta d236ec5007 xeyes: minor rewording for clarity 2017-04-24 12:29:26 +05:30
Vanesssa a3a2206b6d n: add page (#1319) 2017-04-24 10:07:58 +05:30
Angelos Orfanakos 80bb512491 apt: add missing sudo to examples 2017-04-23 21:55:19 +01:00
Angelos Orfanakos 1516784640 apt: remove full-upgrade example
It's rarely used and beyond the scope of tldr
2017-04-23 21:55:19 +01:00
Angelos Orfanakos 73d3ddabc1 apt: add show example 2017-04-23 21:55:19 +01:00
Angelos Orfanakos fd6104b290 apt: remove invalid autoremove example
There is no autoremove command
2017-04-23 21:55:19 +01:00
Waldir Pimenta 6fc1a2234b carthage: description tweaks 2017-04-23 19:55:45 +05:30
abactel 1e15c9cad3 timew: add page (#1343)
timew: add page
2017-04-23 10:22:15 +01:00
Waldir Pimenta 69c12013b3 lsof: shorten main desc, expand PID acronym (#1346) 2017-04-22 19:44:03 +01:00
Waldir Pimenta 777073fcb8 id3tag: minor tweaks (#1347) 2017-04-22 14:37:16 +01:00
Waldir Pimenta df46736db7 git-imerge: add "abort" example (#1339) 2017-04-21 10:45:54 +01:00
Waldir Pimenta 9475cd3589 git-clean: fix verb tense 2017-04-21 00:33:36 +05:30
Eliot Sykes 4d80ebdc16 Typo fix. Simplify git exclude path. 2017-04-21 00:33:36 +05:30
Eliot Sykes 100320e3a6 Add git clean -f, -x options 2017-04-21 00:33:36 +05:30
Eliot Sykes 18b9f11a29 git-clean: add page 2017-04-21 00:33:36 +05:30
Starbeamrainbowlabs 3f53e3282f composer: add page (#1329) 2017-04-20 16:57:57 +05:30
Waldir Pimenta 5cb62ebbff git-show: various tweaks (#1341)
- adjust punctuation & spacing in main description
- adjust descriptions ("changes" --> "information", and explicitly list which info is returned in the first example)
- use a concrete example for the tilde notation
- add abbreviated example
2017-04-19 21:25:28 +01:00
Waldir Pimenta 01a9717bc9 curl: tweak desc of last example, per code review 2017-04-19 19:30:33 +01:00
Waldir Pimenta e6a54d891a curl: remove secure/insecure ambiguity 2017-04-19 19:30:33 +01:00
Waldir Pimenta b051c298d0 curl: spell out the --insecure option 2017-04-19 19:30:33 +01:00
Waldir Pimenta 3acc0d64b8 curl: simplify last example (#1246) 2017-04-19 19:30:33 +01:00
Waldir Pimenta 7329c7275f adduser: change token from "name" to "username" 2017-04-19 15:16:08 +05:30
Agniva De Sarker 9fd6e9cf11 cp: fix travis error 2017-04-19 10:20:18 +01:00
Waldir Pimenta c3d4b4ac55 cp: phrase -i option the same way as the -v option 2017-04-19 10:20:18 +01:00
Waldir Pimenta faed93cbae cp: remove leading / from paths; add -i example 2017-04-19 10:20:18 +01:00
Waldir Pimenta 00656cd8c4 cp: remove shell expansion examples, add -r 2017-04-19 10:20:18 +01:00
Waldir Pimenta da10202a3d cp.md: major overhaul
- change "directory" to "folder" (more beginner-friendly)
- use an extension to distinguish file paths from folder paths
- reword some of the descriptions for clarity
- include examples to clarify when the target argument defines the actual copy, and when it defines the folder where to put the copy
- add an example to copy contents of a folder into another (existing) folder
2017-04-19 10:20:18 +01:00
Waldir Pimenta b865b392c4 vgcreate: improvements to descriptions (#1335) 2017-04-19 10:11:57 +01:00
Waldir Pimenta e59d19a00d cowsay: minor adjustment to main desc. 2017-04-18 22:20:43 +01:00
alefir b71c9cdcf3 git-show: add page (#1331) 2017-04-18 22:39:07 +05:30
Matt Terwilliger 11e745572e Recursive scp arguments reversed (#1321)
* Recursive scp arguments reversed

The command to "copy [...] on a remote host to a local
directory" in the current scp tldr page was backwards.

scp arguments take the form `scp from to`.

* add the word from for clarity
2017-04-18 09:07:46 -04:00
Waldir Pimenta 8493ee06ba cowsay: remove overly complex example, reword desc (#1323) 2017-04-18 09:06:20 -04:00
Waldir Pimenta c644c19a8c x11vnc: wording tweaks (#1324)
* x11vnc: wording tweaks

* x11vnc: clarify monitor vs. display vs. screen

See http://stackoverflow.com/a/1210332 and https://en.wikipedia.org/wiki/X_Window_System#Nomenclature
2017-04-18 09:04:53 -04:00
Waldir Pimenta aa22af277a od: overall copyedit
- reworded command description
- reworded example descriptions for clarity and explicitness
- changed order and content of examples, to introduce options gradually
- formatted all user-selectable parts (option values and arguments) in the token markup
2017-04-18 10:24:50 +05:30