From 348507638576563528b6a9ab5091ca906490dd51 Mon Sep 17 00:00:00 2001
From: "Henry J. Webster" <hwebs@hwebs.info>
Date: Thu, 30 Jul 2026 12:04:12 -0500
Subject: Convert dotfiles to GNU Stow package layout

Restructure into per-app stow packages (bash, emacs, mako) whose trees
mirror $HOME. Preserve emacs runtime data under the new package path and
update .gitignore accordingly. Add README documenting stow usage.

Assisted-by: Claude:claude-opus-4-8
---
 README.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..6d9ff1e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,26 @@
+# dotfiles
+
+Managed with [GNU Stow](https://www.gnu.org/software/stow/). 
+Each top-level directory is a stow *package* whose contents mirror the layout under `$HOME`.
+
+## Install
+
+This repo lives outside `$HOME`, so pass the target explicitly:
+
+```sh
+cd ~/git/dotfiles
+stow -t "$HOME" bash emacs mako
+```
+
+## Remove
+
+```sh
+cd ~/git/dotfiles
+stow -D -t "$HOME" bash emacs mako
+```
+
+## Restow (after moving/renaming files)
+
+```sh
+stow -R -t "$HOME" bash emacs mako
+```
-- 
cgit v1.3