From 1b0097ebc6dfcf868cef6810f3980a33a93a3d65 Mon Sep 17 00:00:00 2001
From: Donovan Glover <donovan@dglover.co>
Date: Tue, 23 Oct 2018 16:22:20 -0400
Subject: [PATCH] docs: Add READMEs for code, gpg, and systemd

Note that systemd usage information needs to be revised since systemd
user units appear to be enabled by default, and may be started by
default when placed in the default.target.wants directory.
---
 code/README.md    | 25 +++++++++++++++++++++++++
 gpg/README.md     | 23 +++++++++++++++++++++++
 systemd/README.md | 29 +++++++++++++++++++++++++++++
 3 files changed, 77 insertions(+)
 create mode 100644 code/README.md
 create mode 100644 gpg/README.md
 create mode 100644 systemd/README.md

diff --git a/code/README.md b/code/README.md
new file mode 100644
index 00000000..eae287c0
--- /dev/null
+++ b/code/README.md
@@ -0,0 +1,25 @@
+# Code
+
+Code is a GUI text editor.
+
+## Dependencies
+
+- [code][code] - The open source build of a popular non-free text editor
+
+## Installation
+
+```sh
+make package=code
+```
+
+## Usage
+
+Install the extensions I use with:
+
+```sh
+make code-extensions
+```
+
+Then, start Code as you normally would.
+
+[code]: https://www.archlinux.org/packages/community/x86_64/code/
diff --git a/gpg/README.md b/gpg/README.md
new file mode 100644
index 00000000..4db1309a
--- /dev/null
+++ b/gpg/README.md
@@ -0,0 +1,23 @@
+# GPG
+
+GPG is used to sign and encrypt things.
+
+## Dependencies
+
+- [`gnupg`][gnupg] - The GNU Privacy Guard
+
+## Installation
+
+```sh
+make package=gpg
+```
+
+## Usage
+
+Use gpg as you normally would. Make sure that you export `GPG_TTY` in your shell's init script. This is how you would do it in [fish](/fish):
+
+```fish
+export GPG_TTY=(tty)
+```
+
+[gnupg]: https://www.archlinux.org/packages/core/x86_64/gnupg/
diff --git a/systemd/README.md b/systemd/README.md
new file mode 100644
index 00000000..ae11bc6e
--- /dev/null
+++ b/systemd/README.md
@@ -0,0 +1,29 @@
+# systemd
+
+*systemd* is described as "a suite of basic building blocks for a Linux system". One of the functions it can be used for is starting daemons at login.
+
+## Dependencies
+
+- [openssh][openssh] - `ssh-agent.service` support
+- [rxvt-unicode-patched][rxvt-unicode-patched] - `urxvtd.service` support
+- [mpd][mpd] - `mpd.service` support
+
+## Installation
+
+```sh
+make package=systemd
+```
+
+## Usage
+
+To start all the user services I use, run:
+
+```sh
+make systemd-enable-now
+```
+
+If you only want to start certain services instead, start them like you normally would with systemd.
+
+[openssh]: https://www.archlinux.org/packages/core/x86_64/openssh/
+[rxvt-unicode-patched]: https://aur.archlinux.org/packages/rxvt-unicode-patched/
+[mpd]: https://www.archlinux.org/packages/extra/x86_64/mpd/