]> git.ipfire.org Git - thirdparty/git.git/commit
ls-tree: fix documentation of %x format placeholder
authorRené Scharfe <l.s.r@web.de>
Thu, 15 Jun 2023 17:33:39 +0000 (19:33 +0200)
committerJunio C Hamano <gitster@pobox.com>
Thu, 15 Jun 2023 18:19:02 +0000 (11:19 -0700)
commit3744ffcbcdcd5a619b7522671e6137b33d84626b
tree465e83c330f35c4aeea89761c728defaef12a4a5
parentfe86abd7511a9a6862d5706c6fa1d9b57a63ba09
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 fd2015b323 (strbuf:
separate callback for strbuf_expand:ing literals, 2019-01-28).

Adjust the documentation accordingly.

Signed-off-by: René Scharfe <l.s.r@web.de>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-ls-tree.txt