archive: document --prefix handling of absolute and parent paths
Clarify that --prefix is used as given and is not normalized, and may include leading slashes or parent directory components. Signed-off-by: Pushkar Singh <pushkarkumarsingh1970@gmail.com> Acked-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Pushkar Singh committed
Apr 8, 2026 at 16:00 UTC
1dcfd677cea65ad65517d57e0659a23f25b53717
1 file changed
+5
Documentation/git-archive.adoc
+5
@@ -54,6 +54,11 @@ OPTIONS
54
Prepend <prefix>/ to paths in the archive. Can be repeated; its
55
rightmost value is used for all tracked files. See below which
56
value gets used by `--add-file`.
57
++
58
+The <prefix> is used as given and is not normalized. It may
59
+include leading slashes or parent directory components (e.g.,
60
+`../`). Some archive consumers may treat such paths as
61
+potentially unsafe and adjust or warn during extraction.
62
63
-o <file>::
64
--output=<file>::