2
0
Эх сурвалжийг харах

Clarify usage of patternfile roots (#6242)

bobthebadguy 3 жил өмнө
parent
commit
2cdf0df14d
1 өөрчлөгдсөн 22 нэмэгдсэн , 1 устгасан
  1. 22 1
      src/borg/archiver.py

+ 22 - 1
src/borg/archiver.py

@@ -2429,10 +2429,31 @@ class Archiver:
                 # susan is a nice person
                 # include susans home
                 + /home/susan
+                # also back up this exact file
+                + pf:/home/bobby/specialfile.txt
                 # don't backup the other home directories
                 - /home/*
                 # don't even look in /proc
-                ! /proc\n\n''')
+                ! /proc
+
+            You can specify recursion roots either on the command line or in a patternfile::
+
+                # these two commands do the same thing
+                borg create --exclude /home/bobby/junk repo::arch /home/bobby /home/susan
+                borg create --patterns-from patternfile.lst repo::arch
+
+            The patternfile::
+
+                # note that excludes use fm: by default and patternfiles use sh: by default.
+                # therefore, we need to specify fm: to have the same exact behavior.
+                P fm
+                R /home/bobby
+                R /home/susan
+
+                - /home/bobby/junk
+
+            This allows you to share the same patterns between multiple repositories
+            without needing to specify them on the command line.\n\n''')
     helptext['placeholders'] = textwrap.dedent('''
         Repository (or Archive) URLs, ``--prefix``, ``--glob-archives``, ``--comment``
         and ``--remote-path`` values support these placeholders: