summaryrefslogtreecommitdiff
path: root/man/rcdn.1
diff options
context:
space:
mode:
authorGravatar Mike Burns <mike@mike-burns.com>2013-08-16 15:42:56 +0200
committerGravatar Mike Burns <mike@mike-burns.com>2013-08-16 16:11:36 +0200
commit975b347b7206a0e9caeeea8349e4765b4db654f9 (patch)
tree7e993414fce578e351b38d0a761670ee551f22b0 /man/rcdn.1
parent526fb25aff2b27b46aaa4754f5b613ca1c97f8c3 (diff)
Pre-up, post-up, pre-down, and post-down hooks
These are programs that, if they exist, will run before or after the syncronization/removal is run. Three use cases caused this: 1. The thoughtbot dotfiles will run a vundle installation set of commands after intitial synchronization. 2. I changed the location of `.bash_history` to `.bash/history` and wanted to move `.bash_history` to `.bash/history` after up to preserve existing history. 3. Moving from an existing old-style custom install script to `rcup` might require some cleanup; this happened in practice, and required a simple script.
Diffstat (limited to 'man/rcdn.1')
-rw-r--r--man/rcdn.111
1 files changed, 11 insertions, 0 deletions
diff --git a/man/rcdn.1 b/man/rcdn.1
index 6c641c9..24ca1a2 100644
--- a/man/rcdn.1
+++ b/man/rcdn.1
@@ -30,6 +30,17 @@ is, that directory is removed. If a rc file is not a symlink but is
listed in
.Va COPY_ALWAYS
the file is removed.
+.Pp
+The
+.Nm
+program will run hooks before and after removing files, if these hooks
+exist. Hooks are executable programs inside the dotfiles directory, with
+the following names:
+.Pa hooks/pre-down and
+.Pa hooks/post-down .
+These hooks are run each time
+.Nm
+is run and therefore must be idempotent.
.
.Bl -tag
.It Fl d Ar DIR