Don't use "cp -a"

[bup.git] / Documentation / bup-drecurse.md

diff --git a/Documentation/bup-drecurse.md b/Documentation/bup-drecurse.md
index ffa5caff72be771a8fad567ae5bfbfa708995d8e..ab97ea29af118dd2d146ff60c5d8901e81da0d55 100644 (file)
--- a/Documentation/bup-drecurse.md
+++ b/Documentation/bup-drecurse.md
@@ -8,8 +8,9 @@ bup-drecurse - recursively list files in your filesystem
 
 # SYNOPSIS
 
-bup drecurse [-x] [-q] [--exclude *path*]
-[--exclude-from *filename*] [--profile] \<path\>
+bup drecurse [-x] [-q] [\--exclude *path*]
+\ [\--exclude-from *filename*] [\--exclude-rx *pattern*]
+\ [\--exclude-rx-from *filename*] [\--profile] \<path\>
 
 # DESCRIPTION
 
@@ -29,27 +30,36 @@ come after its children, making this easy.
 
 # OPTIONS
 
--x, --xdev, --one-file-system
-:   don't cross filesystem boundaries.
+-x, \--xdev, \--one-file-system
+:   don't cross filesystem boundaries -- though as with tar and rsync,
+    the mount points themselves will still be reported.
 
--q, --quiet
+-q, \--quiet
 :   don't print filenames as they are encountered.  Useful
     when testing performance of the traversal algorithms.
 
---exclude=*path*
-:   a path to exclude from the backup (can be used more
-    than once)
+\--exclude=*path*
+:   exclude *path* from the backup (may be repeated).
 
---exclude-from=*filename*
-:   a file that contains exclude paths (can be used more
-    than once)
+\--exclude-from=*filename*
+:   read --exclude paths from *filename*, one path per-line (may be
+    repeated).  Ignore completely empty lines.
     
---profile
+\--exclude-rx=*pattern*
+:   exclude any path matching *pattern*.  See `bup-index`(1) for
+    details, but note that unlike index, drecurse will produce
+    relative paths if the drecurse target is a relative path. (may be
+    repeated).
+
+\--exclude-rx-from=*filename*
+:   read --exclude-rx patterns from *filename*, one pattern per-line
+    (may be repeated).  Ignore completely empty lines.
+
+\--profile
 :   print profiling information upon completion.  Useful
     when testing performance of the traversal algorithms.
     
-# EXAMPLE
-
+# EXAMPLES
     bup drecurse -x /
 
 # SEE ALSO