aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorHenry J. Webster <hwebs@hwebs.info>2026-07-30 12:04:12 -0500
committerHenry J. Webster <hwebs@hwebs.info>2026-07-30 12:04:12 -0500
commit348507638576563528b6a9ab5091ca906490dd51 (patch)
tree2269e9b7fe8111bf8b0088837639d4ffcacf6628 /README.md
parentdc1b0050762fc115814119ea06518de5363fe038 (diff)
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
Diffstat (limited to 'README.md')
-rw-r--r--README.md26
1 files changed, 26 insertions, 0 deletions
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
+```