Przeglądaj źródła

mention "!" (exclude-norecurse) type in patterns help

(cherry picked from commit 36f2a4e1dcac69f58e5cfc8141a65b5006f32cf3)
Thomas Waldmann 7 lat temu
rodzic
commit
0943f2235e
1 zmienionych plików z 4 dodań i 2 usunięć
  1. 4 2
      src/borg/archiver.py

+ 4 - 2
src/borg/archiver.py

@@ -2026,10 +2026,12 @@ class Archiver:
             may specify the backup roots (starting points) and patterns for inclusion/exclusion.
             may specify the backup roots (starting points) and patterns for inclusion/exclusion.
             A root path starts with the prefix `R`, followed by a path (a plain path, not a
             A root path starts with the prefix `R`, followed by a path (a plain path, not a
             file pattern). An include rule starts with the prefix +, an exclude rule starts
             file pattern). An include rule starts with the prefix +, an exclude rule starts
-            with the prefix -, both followed by a pattern.
+            with the prefix -, an exclude-norecurse rule starts with !, all followed by a pattern.
             Inclusion patterns are useful to include paths that are contained in an excluded
             Inclusion patterns are useful to include paths that are contained in an excluded
             path. The first matching pattern is used so if an include pattern matches before
             path. The first matching pattern is used so if an include pattern matches before
-            an exclude pattern, the file is backed up.
+            an exclude pattern, the file is backed up. If an exclude-norecurse pattern matches
+            a directory, it won't recurse into it and won't discover any potential matches for
+            include rules below that directory.
 
 
             Note that the default pattern style for ``--pattern`` and ``--patterns-from`` is
             Note that the default pattern style for ``--pattern`` and ``--patterns-from`` is
             shell style (`sh:`), so those patterns behave similar to rsync include/exclude
             shell style (`sh:`), so those patterns behave similar to rsync include/exclude