- Simplified 'init' command, using the defaults
- Provide synonym 'unlock' to explain the 'unsealing' process
- Use 'key shares' instead of 'key-shares' or 'keyshares'
- Briefly explain what 'sealing' means
Vault uses different back-ends (secret, auth, audit, ..), which are
modeled as a kind of file system:
- Remove 'secret' from the token
- Include the 'secret' back-end to the 'vault write' description
- add a torrent url example
- add the --list and --subtitles options
- make the magnet link example more realistic:
BitTorrent info hashes (BTIH) are hex-encoded SHA-1 hash sums of the "info" sections of BitTorrent metafiles;
SHA-1 hash values are typically rendered as a hexadecimal number, 40 digits long.
- replace "your favorite player" with "a media player" in the main description
- clarify which files from the torrent will be streamed in each case
- fix string example, and improve its description
- move xpath information to the main description
- add "tags" synonym for "nodes"
- add a html example
- simplify description of doctype example
- capitalize "xml" consistently
- expand description of local and global options
- adjust example descriptions for clarity
- change the descriptions of the get/set/remove examples to be more generic
- change the alias example to a more useful one
- use "configuration entries" instead of "configuration options" to match both preset options and aliases
* valgrind: add page
* valgrind: tweak Memcheck example
Provide alternate, clearer syntax that functions the same and update
description accordingly.
* valgrind: correct program description
* valgrind: add list of common tools
* valgrind: remove general form example and add no-option example
* valgrind: replace period with colon in example 1
* Include gist page
* Fix linting errors
* Quote "hello world" in the echo commnad
* Change wording to make explanation clearer
* Further simplify descriptions of gist command
* Simplify description of the update gist command
- hugo -> Hugo
- lowercase the description
- plain URL
- remove the extension token
- do not use relative references
- modify the buildDraft example to standalone and change the wording slightly
- modify the "watch for changes" wording slightly
- Add in `hugo` commands essential to getting a site up and running.
- This is defined as:
- A site existing
- A theme existing
- A page existing
- The site being built in some manner (optionally being served through the webserver)
First pass on verbage.
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.
* 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
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
- 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`
- 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
- 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
* 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
- 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
* find path while excluding certain directory
* delete the `find {{root_path}} -empty` command to meet the demand of 8 commands at most
* tokenize the demo parameter
Usually `bc` isn't very useful if it doesn't return have floating point number where appropriate. e.g., 3/4 returns 0 when started with `-i` but for most users they would expect 0.75 to be returned so the argument `-l`does what the user would generally want.
"upstream" is often used as a synonym for "remote", but we probably should avoid promoting that equivalence, since the terms "upstream" and "downstream" have specific meanings in the context of software dependency, which don't necessarily map with the meanings of "local" and "remote" in the context of computer networks in general (and distributed networks of git repositories in particular).