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

[PATCH] doc: fix hex code escapes in git-ls-files

From
JRJayson Rhynas <jayrhynas@gmail.com>
Date
Jul 26, 2024, 15:41 UTC
Message-ID
<CACStHN-Gs2Sxej+md6zWr3V1dFo+pp=B4yEPm9=uPambDR2NaQ@mail.gmail.com>

The --format option on the git-ls-files man page states that `%xx` interpolates to the character with hex code `xx`. This mirrors the documentation and behavior of `git for-each-ref --format=...`. However, in reality it requires the character with code `XX` to be specified as `%xXX`, mirroring the behaviour of `git log --format`.

Signed-off-by: Jayson Rhynas <jayrhynas@gmail.com>
---
 Documentation/git-ls-files.txt | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/Documentation/git-ls-files.txt b/Documentation/git-ls-files.txt
index d08c7da8f4..58c529afbe 100644
--- a/Documentation/git-ls-files.txt
+++ b/Documentation/git-ls-files.txt
@@ -219,9 +219,9 @@ followed by the  ("attr/<eolattr>").

 --format=<format>::
  A string that interpolates `%(fieldname)` from the result being shown.
- It also interpolates `%%` to `%`, and `%xx` where `xx` are hex digits
- interpolates to character with hex code `xx`; for example `%00`
- interpolates to `\0` (NUL), `%09` to `\t` (TAB) and %0a to `\n` (LF).
+ It also interpolates `%%` to `%`, and `%xXX` where `XX` are hex digits
+ interpolates to character with hex code `XX`; for example `%x00`
+ interpolates to `\0` (NUL), `%x09` to `\t` (TAB) and %x0a to `\n` (LF).
  --format cannot be combined with `-s`, `-o`, `-k`, `-t`, `--resolve-undo`
  and `--eol`.
 \--::

base-commit: c2b3f2b3cdbf5ad9feb978dd367d77561a1271f7
-- 
2.44.0
Next: Junio C Hamano
Message 1 of 3 in “doc: fix hex code escapes in git-ls-files”
  1. doc: fix hex code escapes in git-ls-filesJayson Rhynas, Jul 26, 2024
  2. Junio C HamanoJul 26, 2024
  3. Junio C HamanoJul 26, 2024

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.