SF.net SVN: safekeep: [412] safekeep/trunk

[<di...@us...>]

Revision: 412
          http://safekeep.svn.sourceforge.net/safekeep/?rev=412&view=rev
Author:   dimi
Date:     2007-02-10 17:17:04 -0800 (Sat, 10 Feb 2007)

Log Message:
-----------
More on include/exclude directives

Modified Paths:
--------------
    safekeep/trunk/TODO
    safekeep/trunk/doc/safekeep.txt

Modified: safekeep/trunk/TODO
===================================================================
--- safekeep/trunk/TODO	2007-02-11 01:07:56 UTC (rev 411)
+++ safekeep/trunk/TODO	2007-02-11 01:17:04 UTC (rev 412)
@@ -3,7 +3,6 @@
   * Add an ANNOUNCE file
   * Add an INSTALL file
   * Add reference to SF
-  * Add note on include/excludes
   * Support more of rdiff-backup special file selectors
   * Add tests db dumps
 

Modified: safekeep/trunk/doc/safekeep.txt
===================================================================
--- safekeep/trunk/doc/safekeep.txt	2007-02-11 01:07:56 UTC (rev 411)
+++ safekeep/trunk/doc/safekeep.txt	2007-02-11 01:17:04 UTC (rev 412)
@@ -218,6 +218,32 @@
 You will be able to find more information on the restore procedure in
 the `rdiff-backup(1)` man page.
 
+FILE SELECTION
+--------------
+It is important to note that the `include`/`exclude` directives that
+control file selection are matched in the order they appear in the
+configuration file, and the first one that matches dictates whether
+the file will be included or excluded. As a result, you have to
+add the more specific ones first, or the more generic specifications
+will always win. For example:
+------------------------------------------------------------------------
+...
+    <include path="/home"/>
+    <exclude path="/home/joe"/>
+...
+------------------------------------------------------------------------
+will NOT do what you expect, because the `/home` will match before 
+`/home/joe`, and thus all files under `/home` will be included.
+The correct way is to flip the two around
+------------------------------------------------------------------------
+...
+    <exclude path="/home/joe"/>
+    <include path="/home"/>
+...
+------------------------------------------------------------------------
+
+Please see safekeep.conf(5) for more information on file selection.
+
 SEE ALSO
 --------
 rdiff-backup(1), safekeep.conf(5)


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.