From 5d4dda75d36d4bdaff9fc4a38a234383aef4b733 Mon Sep 17 00:00:00 2001 From: Thomas Waldmann Date: Mon, 31 Jan 2022 20:55:08 +0100 Subject: [PATCH] docs: --pattern* not experimental any more, fixes #6134 --- src/borg/archiver.py | 17 +++++++---------- 1 file changed, 7 insertions(+), 10 deletions(-) diff --git a/src/borg/archiver.py b/src/borg/archiver.py index dcacd9e75..22bcc0542 100644 --- a/src/borg/archiver.py +++ b/src/borg/archiver.py @@ -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',