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>
maint
Pushkar Singh 2026-04-08 16:00:06 +00:00 committed by Junio C Hamano
parent 9a2fb147f2
commit 1dcfd677ce
1 changed files with 5 additions and 0 deletions

View File

@ -54,6 +54,11 @@ OPTIONS
Prepend <prefix>/ to paths in the archive. Can be repeated; its
rightmost value is used for all tracked files. See below which
value gets used by `--add-file`.
+
The <prefix> is used as given and is not normalized. It may
include leading slashes or parent directory components (e.g.,
`../`). Some archive consumers may treat such paths as
potentially unsafe and adjust or warn during extraction.

-o <file>::
--output=<file>::