From 30434073ca0805ea8b0be94c46cf10b35aaf0d94 Mon Sep 17 00:00:00 2001
From: Case Duckworth
Date: Sun, 2 Jan 2022 10:23:06 -0600
Subject: Add README.org

---
 README.org | 44 ++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 44 insertions(+)
 create mode 100644 README.org

(limited to 'README.org')

diff --git a/README.org b/README.org
new file mode 100644
index 0000000..dd80eff
--- /dev/null
+++ b/README.org
@@ -0,0 +1,44 @@
+#+TITLE: My configurations
+#+AUTHOR: Case Duckworth
+
+Here are my system configurations.  There are many like them but these are mine.
+
+* Installation
+
+Clone this repo to ~$XDG_CONFIG_HOME~, which in [[https://github.com/duckwork/etc/blob/main/profile/profile][profile/profile]] I've set to
+~$HOME/etc~.  See that file for other XDG directories I've set to non-standard
+places.  (Just in case something hard-codes ~$XDG_CONFIG_HOME~, I also symlink
+them in =bootstrap.sh=, which see below.)
+
+Instead of GNU Stow or a Makefile, I use a short =bootstrap.sh= script that reads
+=bootstrap.manifest=, a tab-separated file mapping repo paths to paths in ~$HOME~.
+It only contains files for programs that [[https://wiki.archlinux.org/title/XDG_Base_Directory#Support][aren't XDG-compliant]], so it should stay
+short.
+
+Anyway, run =bootstrap.sh= in this directory and you should be set.
+
+* Programs to install
+
+** Required
+
+- bash + readline :: I prefer this shell over others, since I don't do anything
+  super wild in the terminal nowadays anyway
+- git :: Kind of required to do anything with this repo
+- keychain :: Manages =ssh-agent=
+
+** Extra
+
+- mbsync :: For mail.
+
+* Notes
+
+- My [[https://tildegit.org/acdw/emacs][emacs configuration is elsewhere]], but it goes in ~$XDG_CONFIG_HOME~ as well.
+
+* License
+
+Everyone is permitted to do whatever with this software, without limitation.
+This software comes without any warranty whatsoever, but with two pieces of
+advice:
+
+- Don't hurt yourself.
+- Make good choices.
-- 
cgit 1.4.1-21-gabe81