summaryrefslogtreecommitdiff
path: root/etc-init.d/README
diff options
context:
space:
mode:
Diffstat (limited to 'etc-init.d/README')
-rw-r--r--etc-init.d/README12
1 files changed, 12 insertions, 0 deletions
diff --git a/etc-init.d/README b/etc-init.d/README
new file mode 100644
index 0000000..8fe4cd1
--- /dev/null
+++ b/etc-init.d/README
@@ -0,0 +1,12 @@
+Executable files in this directory are run to initialise the working directory
+for use by etckeeper. If the working directory is not already in version
+control, that includes setting up the version control, but not actually
+committing anything. If the working directory is in version control,
+it includes applying stored metadata to the checked out files in the
+working directory.
+
+Please be careful to *never* overwrite existing files/directories
+in the working directory. If a file you need to write already exists, check
+if its contents are sane, and if not, emit a warning on stderr.
+
+If initialisation fails, exit nonzero and no later files will be run.