From c83117c32eca8be830bdec57acf548b274791043 Mon Sep 17 00:00:00 2001
From: Atemu <git@atemu.net>
Date: Fri, 20 Dec 2024 09:48:45 +0100
Subject: [PATCH] doc: document lack of wildcard support in default extract
 pattern

Fixes https://github.com/borgbackup/borg/issues/8589
---
 docs/usage/extract.rst.inc | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/usage/extract.rst.inc b/docs/usage/extract.rst.inc
index 46c321ec1d2..827d01d6a8f 100644
--- a/docs/usage/extract.rst.inc
+++ b/docs/usage/extract.rst.inc
@@ -119,4 +119,8 @@ pass over the archive metadata.
 
     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.
\ No newline at end of file
+    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.