diff options
author | Johannes Schindelin <johannes.schindelin@gmx.de> | 2022-05-28 16:11:13 -0700 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2022-05-30 23:07:31 -0700 |
commit | de1f68a968e64b3e1e2979222238fec1f045bbf3 (patch) | |
tree | f73cd5decd04211e3b4f855e43c6cc9d0929d45d /Documentation/git-archive.txt | |
parent | 237a1d138c4322a7e934f129dee02e2ea6a214cd (diff) | |
download | git-de1f68a968e64b3e1e2979222238fec1f045bbf3.tar.gz |
archive --add-virtual-file: allow paths containing colons
By allowing the path to be enclosed in double-quotes, we can avoid
the limitation that paths cannot contain colons.
Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-archive.txt')
-rw-r--r-- | Documentation/git-archive.txt | 14 |
1 files changed, 10 insertions, 4 deletions
diff --git a/Documentation/git-archive.txt b/Documentation/git-archive.txt index b41cc5bc2e..56989a2f34 100644 --- a/Documentation/git-archive.txt +++ b/Documentation/git-archive.txt @@ -69,10 +69,16 @@ OPTIONS by concatenating the value of the last `--prefix` option (if any) before this `--add-virtual-file` and `<path>`. + -The `<path>` cannot contain any colon, the file mode is limited to -a regular file, and the option may be subject to platform-dependent -command-line limits. For non-trivial cases, write an untracked file -and use `--add-file` instead. +The `<path>` argument can start and end with a literal double-quote +character; the contained file name is interpreted as a C-style string, +i.e. the backslash is interpreted as escape character. The path must +be quoted if it contains a colon, to avoid the colon from being +misinterpreted as the separator between the path and the contents, or +if the path begins or ends with a double-quote character. ++ +The file mode is limited to a regular file, and the option may be +subject to platform-dependent command-line limits. For non-trivial +cases, write an untracked file and use `--add-file` instead. --worktree-attributes:: Look for attributes in .gitattributes files in the working tree |