dry: Add descriptions

doc/git-a/description.md

@@ -0,0 +1,7 @@
+Short for `git add`.
+
+Example:
+
+```shell
+git a file.txt
+```

doc/git-aa/description.md

@@ -0,0 +1,8 @@
+Short for "git add --all" (add all paths).
+
+Example:
+
+```shell
+git aa
+```
+

doc/git-add-alias/description.md

@@ -0,0 +1,8 @@
+Create a new Git alias.
+
+Example:
+
+```shell
+git add-alias --local myalias mycommand
+git add-alias --global myalias mycommand
+```

doc/git-add-cached/description.md

@@ -0,0 +1,29 @@
+Add cached files.
+
+Example:
+
+```shell
+git add-cached
+```
+
+Compare:
+
+* [git add-cached](../git-add-cached) (this alias)
+* [git add-deleted](../git-add-deleted)
+* [git add-others](../git-add-others)
+* [git add-ignored](../git-add-ignored)
+* [git add-killed](../git-add-killed)
+* [git add-modified](../git-add-modified)
+* [git add-stage](../git-add-stage)
+* [git add-unmerged](../git-add-unmerged)
+
+Compare corresponding aliases for `edit-*`:
+
+* [git edit-cached](../git-edit-cached)
+* [git edit-deleted](../git-edit-deleted)
+* [git edit-others](../git-edit-others)
+* [git edit-ignored](../git-edit-ignored)
+* [git edit-killed](../git-edit-killed)
+* [git edit-modified](../git-edit-modified)
+* [git edit-stage](../git-edit-stage)
+* [git edit-unmerged](../git-edit-unmerged)

doc/git-add-deleted/description.md

@@ -0,0 +1,29 @@
+Add deleted files.
+
+Example:
+
+```shell
+git add-deleted
+```
+
+Compare:
+
+* [git add-cached](../git-add-cached)
+* [git add-deleted](../git-add-deleted) (this alias)
+* [git add-others](../git-add-others)
+* [git add-ignored](../git-add-ignored)
+* [git add-killed](../git-add-killed)
+* [git add-modified](../git-add-modified)
+* [git add-stage](../git-add-stage)
+* [git add-unmerged](../git-add-unmerged)
+
+Compare corresponding aliases for `edit-*`:
+
+* [git edit-cached](../git-edit-cached)
+* [git edit-deleted](../git-edit-deleted)
+* [git edit-others](../git-edit-others)
+* [git edit-ignored](../git-edit-ignored)
+* [git edit-killed](../git-edit-killed)
+* [git edit-modified](../git-edit-modified)
+* [git edit-stage](../git-edit-stage)
+* [git edit-unmerged](../git-edit-unmerged)

doc/git-add-ignored/description.md

@@ -0,0 +1,29 @@
+Add ignored files.
+
+Example:
+
+```shell
+git add-ignored
+```
+
+Compare aliases for `add-*`:
+
+* [git add-cached](../git-add-cached)
+* [git add-deleted](../git-add-deleted)
+* [git add-others](../git-add-others)
+* [git add-ignored](../git-add-ignored) (this alias)
+* [git add-killed](../git-add-killed)
+* [git add-modified](../git-add-modified)
+* [git add-stage](../git-add-stage)
+* [git add-unmerged](../git-add-unmerged)
+
+Compare aliases for `edit-*`:
+
+* [git edit-cached](../git-edit-cached)
+* [git edit-deleted](../git-edit-deleted)
+* [git edit-others](../git-edit-others)
+* [git edit-ignored](../git-edit-ignored)
+* [git edit-killed](../git-edit-killed)
+* [git edit-modified](../git-edit-modified)
+* [git edit-stage](../git-edit-stage)
+* [git edit-unmerged](../git-edit-unmerged)

doc/git-add-killed/description.md

@@ -0,0 +1,29 @@
+Add killed files.
+
+Example:
+
+```shell
+git add-killed
+```
+
+Compare:
+
+* [git add-cached](../git-add-cached)
+* [git add-deleted](../git-add-deleted)
+* [git add-others](../git-add-others)
+* [git add-ignored](../git-add-ignored)
+* [git add-killed](../git-add-killed) (this alias)
+* [git add-modified](../git-add-modified)
+* [git add-stage](../git-add-stage)
+* [git add-unmerged](../git-add-unmerged)
+
+Compare corresponding aliases for `edit-*`:
+
+* [git edit-cached](../git-edit-cached)
+* [git edit-deleted](../git-edit-deleted)
+* [git edit-others](../git-edit-others)
+* [git edit-ignored](../git-edit-ignored)
+* [git edit-killed](../git-edit-killed)
+* [git edit-modified](../git-edit-modified)
+* [git edit-stage](../git-edit-stage)
+* [git edit-unmerged](../git-edit-unmerged)

doc/git-add-modified/description.md

@@ -0,0 +1,29 @@
+Add modified files.
+
+Example:
+
+```shell
+git add-modified
+```
+
+Compare:
+
+* [git add-cached](../git-add-cached)
+* [git add-deleted](../git-add-deleted)
+* [git add-others](../git-add-others)
+* [git add-ignored](../git-add-ignored)
+* [git add-killed](../git-add-killed)
+* [git add-modified](../git-add-modified) (this alias)
+* [git add-stage](../git-add-stage)
+* [git add-unmerged](../git-add-unmerged)
+
+Compare corresponding aliases for `edit-*`:
+
+* [git edit-cached](../git-edit-cached)
+* [git edit-deleted](../git-edit-deleted)
+* [git edit-others](../git-edit-others)
+* [git edit-ignored](../git-edit-ignored)
+* [git edit-killed](../git-edit-killed)
+* [git edit-modified](../git-edit-modified)
+* [git edit-stage](../git-edit-stage)
+* [git edit-unmerged](../git-edit-unmerged)

doc/git-add-others/description.md

@@ -0,0 +1,29 @@
+Add other files.
+
+Example:
+
+```shell
+git add-others
+```
+
+Compare:
+
+* [git add-cached](../git-add-cached)
+* [git add-deleted](../git-add-deleted)
+* [git add-others](../git-add-others) (this alias)
+* [git add-ignored](../git-add-ignored)
+* [git add-killed](../git-add-killed)
+* [git add-modified](../git-add-modified)
+* [git add-stage](../git-add-stage)
+* [git add-unmerged](../git-add-unmerged)
+
+Compare corresponding aliases for `edit-*`:
+
+* [git edit-cached](../git-edit-cached)
+* [git edit-deleted](../git-edit-deleted)
+* [git edit-others](../git-edit-others)
+* [git edit-ignored](../git-edit-ignored)
+* [git edit-killed](../git-edit-killed)
+* [git edit-modified](../git-edit-modified)
+* [git edit-stage](../git-edit-stage)
+* [git edit-unmerged](../git-edit-unmerged)

doc/git-add-stage/description.md

@@ -0,0 +1,29 @@
+Add stage files.
+
+Example:
+
+```shell
+git add-stage
+```
+
+Compare:
+
+* [git add-cached](../git-add-cached)
+* [git add-deleted](../git-add-deleted)
+* [git add-others](../git-add-others)
+* [git add-ignored](../git-add-ignored)
+* [git add-killed](../git-add-killed)
+* [git add-modified](../git-add-modified)
+* [git add-stage](../git-add-stage) (this alias)
+* [git add-unmerged](../git-add-unmerged)
+
+Compare corresponding aliases for `edit-*`:
+
+* [git edit-cached](../git-edit-cached)
+* [git edit-deleted](../git-edit-deleted)
+* [git edit-others](../git-edit-others)
+* [git edit-ignored](../git-edit-ignored)
+* [git edit-killed](../git-edit-killed)
+* [git edit-modified](../git-edit-modified)
+* [git edit-stage](../git-edit-stage)
+* [git edit-unmerged](../git-edit-unmerged)

doc/git-add-unmerged/description.md

@@ -0,0 +1,29 @@
+Add unmerged files.
+
+Example:
+
+```shell
+git add-unmerged
+```
+
+Compare:
+
+* [git add-cached](../git-add-cached)
+* [git add-deleted](../git-add-deleted)
+* [git add-others](../git-add-others)
+* [git add-ignored](../git-add-ignored)
+* [git add-killed](../git-add-killed)
+* [git add-modified](../git-add-modified)
+* [git add-stage](../git-add-stage) (this alias)
+* [git add-unmerged](../git-add-unmerged)
+
+Compare corresponding aliases for `edit-*`:
+
+* [git edit-cached](../git-edit-cached)
+* [git edit-deleted](../git-edit-deleted)
+* [git edit-others](../git-edit-others)
+* [git edit-ignored](../git-edit-ignored)
+* [git edit-killed](../git-edit-killed)
+* [git edit-modified](../git-edit-modified)
+* [git edit-stage](../git-edit-stage)
+* [git edit-unmerged](../git-edit-unmerged)

doc/git-add/description.md

@@ -0,0 +1,42 @@
+# git add
+
+## Aliases to add files
+
+
+### Shortcuts
+
+* [git a](../git-a) = add
+* [git aa](../git-aa) = add --all
+* [git ap](../git-ap) = add --patch
+* [git au](../git-au) = add --update
+
+
+### Add all paths of the given type
+
+Git alias:
+
+```git
+add-cached = !"f() { git ls-files --cached | sort -u ; }; git add `f`"
+add-deleted = !"f() { git ls-files --deleted | sort -u ; }; git add `f`"
+add-others = !"f() { git ls-files --others | sort -u ; }; git add `f`"
+add-ignored = !"f() { git ls-files --ignored | sort -u ; }; git add `f`"
+add-killed = !"f() { git ls-files --killed | sort -u ; }; git add `f`"
+add-modified = !"f() { git ls-files --modified | sort -u ; }; git add `f`"
+add-stage = !"f() { git ls-files --stage | cut -f2 | sort -u ; }; git add `f`"
+add-unmerged = !"f() { git ls-files --unmerged | cut -f2 | sort -u ; }; git add `f`"
+```
+
+Example:
+
+```shell
+git add-cached
+git add-deleted
+git add-others
+git add-ignored
+git add-killed
+git add-modified
+git add-stage
+git add-unmerged
+```
+
+These aliases intentionally match the aliases [git edit-*](../git-edit).

doc/git-alias/description.md

@@ -0,0 +1,7 @@
+Git alias help.
+
+Example:
+
+```shell
+git alias
+```

doc/git-aliases/description.md

@@ -0,0 +1,21 @@
+List Git aliases.
+
+Example:
+
+```shell
+git aliases
+```
+
+This alias is because friendly wording is easier to remember.
+
+Our friendly wording for plurals:
+
+* [git aliases](../git-aliases)
+
+* [git branches](../git-branches)
+
+* [git stashes](../git-stashes)
+
+* [git tags](../git-tags)
+
+Thanks to <http:https://gggritso.com/human-git-aliases>.

doc/git-ap/description.md

@@ -0,0 +1,9 @@
+Short for "git add --patch" (add by patch).
+
+Example:
+
+```shell
+git ap
+```
+
+Show each change, and ask if we want to stage it.

doc/git-archive/description.md

@@ -0,0 +1,10 @@
+Create an archive file of everything in the repo.
+
+Example:
+
+```shell
+git archive
+```
+
+This archive can be useful for backups, disaster recovery,
+legal auditing, or sending the repo as a file to someone.

doc/git-assume-all/description.md

@@ -0,0 +1,9 @@
+Assume all files are unchanged.
+
+Example:
+
+```shell
+git assume-all
+```
+
+To see how this works, see [`git assume-*` and `git unassume-`](../git-assume-and-git-unassume).