]> git.ipfire.org Git - thirdparty/git.git/commit
fast-import: improve documentation for path quoting
authorThalia Archibald <thalia@archibald.dev>
Sun, 14 Apr 2024 01:12:04 +0000 (01:12 +0000)
committerJunio C Hamano <gitster@pobox.com>
Mon, 15 Apr 2024 17:06:18 +0000 (10:06 -0700)
commit22915955caaff8b49671426aba31cbcee19ed0ac
tree4ea2ecd3d1682d261e0cde168802f1a1eaea85e7
parent212ab23e98546b24a183dce86b90595e1e4b92dd
fast-import: improve documentation for path quoting

It describes what characters cannot be in an unquoted path, but not
their semantics. Reframe it as a definition of unquoted paths. From the
perspective of the parser, whether it starts with `"` is what defines
whether it will parse it as quoted or unquoted.

The restrictions on characters in unquoted paths (with starting-", LF,
and spaces) are explained in the quoted paragraph. Move it to the
unquoted paragraph and reword.

The restriction that the source paths of filecopy and filerename cannot
contain SP is only stated in their respective sections. Restate it in
the <path> section.

Signed-off-by: Thalia Archibald <thalia@archibald.dev>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-fast-import.txt