doc: Add a second example config file.

This commit provides another example for the INSTALL file. It
illustrates the use of some more sophisticated config options of dss.

Many thanks to Ivo Welch who suggested this change.

diff --git a/INSTALL b/INSTALL
index ff4274b26b3560f404aaaf73591deb6efa998c61..a99abead6bc3ef9a5bdbafb64c82c42b21a6d1e0 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -23,8 +23,8 @@ NetBSD. However, it is run-tested only on Linux.
 Also make sure that http://rsync.samba.org/ (rsync) is installed on
 your system. Version 2.6.1 or newer is required.
 
 Also make sure that http://rsync.samba.org/ (rsync) is installed on
 your system. Version 2.6.1 or newer is required.
 

-Example:
---------
+Examples:
+---------

 
 Suppose you'd like to create snapshots of the existing directory
 
 
 Suppose you'd like to create snapshots of the existing directory
 


@@ -53,10 +53,33 @@ In order to print the list of all snapshots created so far, use
 
        dss --ls
 
 
        dss --ls
 

-Yes, it's really that easy. Of course, dss supports many more
-features and config options such as taking snapshots from remote
-hosts and several hooks that are executed on certain events, for
-example whenever a snapshot was created successfully.  Try
+Yes, it's really that easy.
+
+The second example involves a slightly more sophisticated config file.
+It instructs dss to exclude everything which matches at least one
+pattern of the given exclude file, prevents rsync from crossing file
+system boundaries and increases the number of snapshots.
+
+       source-dir "/foo/bar"
+       dest-dir "/baz/qux"
+       # exclude files matching patterns in /etc/dss.exclude
+       rsync-option "--exclude-from=/etc/dss.exclude"
+       # don't cross filesystem boundaries
+       rsync-option "--one-file-system"
+       # maintain 2^6 - 1 = 63 snaphots
+       num-intervals "6"
+
+The /etc/dss.exclude file could look like this (see rsync(1) for
+more examples)
+
+ 
+        - /proc
+        - /**/tmp/
+
+Note that dss supports many more features and config options such
+as taking snapshots from remote hosts and several hooks that are
+executed on certain events, for example whenever a snapshot was
+created successfully. Try

 
        dss -h
 
 
        dss -h