|
@@ -2228,10 +2228,9 @@ class Archiver:
|
|
|
|
|
|
File patterns support these styles: fnmatch, shell, regular expressions,
|
|
|
path prefixes and path full-matches. By default, fnmatch is used for
|
|
|
- ``--exclude`` patterns and shell-style is used for the experimental
|
|
|
- ``--pattern`` option. For commands that support patterns in their
|
|
|
- ``PATH`` argument like (``borg list``), the default pattern is path
|
|
|
- prefix.
|
|
|
+ ``--exclude`` patterns and shell-style is used for the ``--pattern``
|
|
|
+ option. For commands that support patterns in their ``PATH`` argument
|
|
|
+ like (``borg list``), the default pattern is path prefix.
|
|
|
|
|
|
Starting with Borg 1.2, for all but regular expression pattern matching
|
|
|
styles, all paths are treated as relative, meaning that a leading path
|
|
@@ -2351,11 +2350,9 @@ class Archiver:
|
|
|
EOF
|
|
|
$ borg create --exclude-from exclude.txt backup /
|
|
|
|
|
|
- .. container:: experimental
|
|
|
-
|
|
|
A more general and easier to use way to define filename matching patterns exists
|
|
|
- with the experimental ``--pattern`` and ``--patterns-from`` options. Using these, you
|
|
|
- may specify the backup roots (starting points) and patterns for inclusion/exclusion.
|
|
|
+ with the ``--pattern`` and ``--patterns-from`` options. Using these, you 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
|
|
|
file pattern). An include rule starts with the prefix +, an exclude rule starts
|
|
|
with the prefix -, an exclude-norecurse rule starts with !, all followed by a pattern.
|
|
@@ -2813,9 +2810,9 @@ class Archiver:
|
|
|
add_option('--exclude-from', metavar='EXCLUDEFILE', action=ArgparseExcludeFileAction,
|
|
|
help='read exclude patterns from EXCLUDEFILE, one per line')
|
|
|
add_option('--pattern', metavar='PATTERN', action=ArgparsePatternAction,
|
|
|
- help='experimental: include/exclude paths matching PATTERN')
|
|
|
+ help='include/exclude paths matching PATTERN')
|
|
|
add_option('--patterns-from', metavar='PATTERNFILE', action=ArgparsePatternFileAction,
|
|
|
- help='experimental: read include/exclude patterns from PATTERNFILE, one per line')
|
|
|
+ help='read include/exclude patterns from PATTERNFILE, one per line')
|
|
|
|
|
|
if tag_files:
|
|
|
add_option('--exclude-caches', dest='exclude_caches', action='store_true',
|