git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH 1/2 v3] git-fast-import.txt: improve documentation for quoted paths

From
Junio C Hamano <gitster@pobox.com>
Date
Nov 29, 2012, 19:33 UTC
Message-ID
<7vr4ncp5kw.fsf@alter.siamese.dyndns.org>
In-Reply-To
<1354216293-21921-1-git-send-email-Matthieu.Moy@imag.fr>
Matthieu Moy <Matthieu.Moy@imag.fr> writes:
Show 26 quoted lines
> The documentation mentionned only newlines and double quotes as
> characters needing escaping, but the backslash also needs it. Also, the
> documentation was not clearly saying that double quotes around the file
> name were required (double quotes in the examples could be interpreted as
> part of the sentence, not part of the actual string).
>
> Signed-off-by: Matthieu Moy <Matthieu.Moy@imag.fr>
> ---
> cut-and-paste of Peff's version, adapted from mine.
>
>  Documentation/git-fast-import.txt | 8 ++++++--
>  1 file changed, 6 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/git-fast-import.txt b/Documentation/git-fast-import.txt
> index 959e4d3..d1844ea 100644
> --- a/Documentation/git-fast-import.txt
> +++ b/Documentation/git-fast-import.txt
> @@ -562,8 +562,12 @@ A `<path>` string must use UNIX-style directory separators (forward
>  slash `/`), may contain any byte other than `LF`, and must not
>  start with double quote (`"`).
>  
> -If an `LF` or double quote must be encoded into `<path>` shell-style
> -quoting should be used, e.g. `"path/with\n and \" in it"`.
> +A path can use C-style string quoting; this is accepted in all cases
> +and mandatory if the filename starts with double quote or contains
> +`LF`.
... or backslash?
Show 6 quoted lines
> +In C-style quoting, the complete name should be surrounded with
> +double quotes, and any `LF`, backslash, or double quote characters
> +must be escaped by preceding them with a backslash (e.g.,
> +`"path/with\n, \\ and \" in it"`).
>  
>  The value of `<path>` must be in canonical form. That is it must not:
Previous: Matthieu MoyNext: Jeff King
Message 11 of 16 in “git-remote-mediawiki: escape double quotes and LF in file names”
  1. git-remote-mediawiki: escape double quotes and LF in file namesMatthieu Moy, Nov 29, 2012
  2. Junio C HamanoNov 29, 2012
  3. Matthieu MoyNov 29, 2012
  4. 1/2 git-fast-import.txt: improve documentation for quoted pathsMatthieu Moy, Nov 29, 2012
  5. 2/2 git-remote-mediawiki: escape ", \, and LF in file namesMatthieu Moy, Nov 29, 2012
  6. Jeff KingNov 29, 2012
  7. Matthieu MoyNov 29, 2012
  8. Jeff KingNov 29, 2012
  9. 1/2 git-fast-import.txt: improve documentation for quoted pathsMatthieu Moy, Nov 29, 2012
  10. 2/2 git-remote-mediawiki: escape ", \, and LF in file namesMatthieu Moy, Nov 29, 2012
  11. Junio C HamanoNov 29, 2012
  12. Jeff KingNov 29, 2012
  13. Junio C HamanoNov 29, 2012
  14. Jeff KingNov 29, 2012
  15. Matthieu MoyNov 30, 2012
  16. Junio C HamanoDec 2, 2012

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.