add readme files for everything

README.org

@@ -12,33 +12,33 @@ Have your cake and eat it too!
 
 ** Completions
 
-| Name | Completes              |
-|------+------------------------|
-| git | add, fetch... |
-| gopass | audit, config... |
-| man | man pages |
-| rc | OpenBSD rc scripts and rc commands |
-| ssh | ssh known hosts |
-| vmd | vmctl commands and VM names |
+| Name   | Completes                          |
+|--------+------------------------------------|
+| [[completions/git.org][git]]    | add, fetch...                      |
+| [[completions/gopass.org][gopass]] | audit, config...                   |
+| [[completions/man.org][man]] | man pages                          |
+| [[completions/rc.org][rc]] | OpenBSD rc scripts and rc commands |
+| [[completions/ssh.org][ssh]] | ssh known hosts                    |
+| [[completions/vmd.org][vmd]] | vmctl commands and VM names        |
 
 ** Extensions
 
 | Name       | Description                                               |
 |------------+-----------------------------------------------------------|
-| fonts      | Load fonts from common locations.                         |
-| fzf        | -                                                         |
-| git-prompt | A port of git-prompt for KSH.                             |
-| k          | A tool to quickly change directories.                     |
-| nocolor    | Disable terminal color options for many tools.            |
-| openbsd    | A set of tools for working with the OpenBSD source trees. |
+| [[extensions/fonts.org][fonts]]      | Load fonts from common locations.                         |
+| [[extensions/fzf.org][fzf]]        | -                                                         |
+| [[extensions/git-prompt.org][git-prompt]] | A port of git-prompt for KSH.                             |
+| [[extensions/k.org][k]]          | A tool to quickly change directories.                     |
+| [[extensions/nocolor.org][nocolor]]    | Disable terminal color options for many tools.            |
+| [[extensions/openbsd.org][openbsd]]    | A set of tools for working with the OpenBSD source trees. |
 
 
 ** Prompts
 
-| Name       | Example                   |
-|------------+---------------------------|
-| q          | ~qbit@litr[0]:~$~         |
-| og-openbsd | ~$~                       |
+| Name       | Example           |
+|------------+-------------------|
+| [[prompts/q.org][q]]          | ~qbit@litr[0]:~$~ |
+| [[prompts/og-openbsd.org][og-openbsd]] | ~$~               |
 
 ** Example usage
 

completions/git.org

@@ -0,0 +1,22 @@
+* git completions
+
+The ~git~ completion currently supports the following arguments:
+
+** Level 1
+#+begin_src ksh
+	add am archive \
+	bisect branch bundle \
+	checkout cherry-pick citool clean clone commit config \
+	describe diff \
+	fetch format-patch \
+	gc grep gui \
+	init \
+	log \
+	merge mv \
+	notes \
+	pull push \
+	range-diff rebase reset restore revert rm \
+	shortlog show sparse-checkout stash status submodule switch \
+	tag \
+	worktree
+#+end_src

extensions/git-prompt.org

@@ -0,0 +1,6 @@
+* git-prompt extension
+
+This extension is a port of the [[https://github.com/git/git/blob/master/contrib/completion/git-prompt.sh][packaged git-prompt]] script to OpenBSD's ksh.
+
+It allows one to include git information in your PS1 or other scripts.
+