Skip to content

Commit 3744ffc

Browse files
rscharfegitster
authored andcommitted
ls-tree: fix documentation of %x format placeholder
ls-tree --format expands %x followed by two hexadecimal digits to the character indicated by that hexadecimal number, e.g.: $ git ls-tree --format=%x41 HEAD | head -1 A It rejects % followed by a hexadecimal digit, e.g.: $ git ls-tree --format=%41 HEAD | head -1 fatal: bad ls-tree format: element '41' does not start with '(' This functionality is provided by strbuf_expand_literal_cb(), which has not been changed since it was factored out by fd2015b (strbuf: separate callback for strbuf_expand:ing literals, 2019-01-28). Adjust the documentation accordingly. Signed-off-by: René Scharfe <[email protected]> Signed-off-by: Junio C Hamano <[email protected]>
1 parent fe86abd commit 3744ffc

File tree

1 file changed

+3
-3
lines changed

1 file changed

+3
-3
lines changed

Documentation/git-ls-tree.txt

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -86,9 +86,9 @@ OPTIONS
8686
--format=<format>::
8787
A string that interpolates `%(fieldname)` from the result
8888
being shown. It also interpolates `%%` to `%`, and
89-
`%xx` where `xx` are hex digits interpolates to character
90-
with hex code `xx`; for example `%00` interpolates to
91-
`\0` (NUL), `%09` to `\t` (TAB) and `%0a` to `\n` (LF).
89+
`%xNN` where `NN` are hex digits interpolates to character
90+
with hex code `NN`; for example `%x00` interpolates to
91+
`\0` (NUL), `%x09` to `\t` (TAB) and `%x0a` to `\n` (LF).
9292
When specified, `--format` cannot be combined with other
9393
format-altering options, including `--long`, `--name-only`
9494
and `--object-only`.

0 commit comments

Comments
 (0)