From 92f1ae6de8b607c31a012dbd6be528ff0b3b12e7 Mon Sep 17 00:00:00 2001 From: Atemu Date: Fri, 20 Dec 2024 09:55:21 +0100 Subject: [PATCH] extract: document lack of wildcard support in default pattern style Fixes https://github.com/borgbackup/borg/issues/8589 --- src/borg/archiver/extract_cmd.py | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/src/borg/archiver/extract_cmd.py b/src/borg/archiver/extract_cmd.py index af22fc568..ea030d598 100644 --- a/src/borg/archiver/extract_cmd.py +++ b/src/borg/archiver/extract_cmd.py @@ -130,6 +130,10 @@ def build_parser_extract(self, subparsers, common_parser, mid_common_parser): When parent directories are not extracted (because of using file/directory selection or any other reason), borg can not restore parent directories' metadata, e.g. owner, group, permission, etc. + + The default interpretation for the paths to extract is `pp:` which is a literal + path-prefix match. If you want to use e.g. a wildcard, you must select a different + pattern style such as `sh:` or `fm:`. See :ref:`borg_patterns` for more information. """ ) subparser = subparsers.add_parser(