diff options
| author | René Scharfe <l.s.r@web.de> | 2021-02-14 10:04:34 (GMT) |
|---|---|---|
| committer | Junio C Hamano <gitster@pobox.com> | 2021-02-17 17:54:31 (GMT) |
| commit | 15ae82d5d6ccdcad00aeb456ff512d3031f03039 (patch) | |
| tree | fd4e6fd30a2f5f956d18ce6ab11954a4f82afb63 /Documentation/pretty-formats.txt | |
| parent | 328c10930387d301560f7cbcd3351cc485a13381 (diff) | |
| download | git-15ae82d5d6ccdcad00aeb456ff512d3031f03039.zip git-15ae82d5d6ccdcad00aeb456ff512d3031f03039.tar.gz git-15ae82d5d6ccdcad00aeb456ff512d3031f03039.tar.bz2 | |
pretty: add %(describe)
Add a format placeholder for describe output. Implement it by actually
calling git describe, which is simple and guarantees correctness. It's
intended to be used with $Format:...$ in files with the attribute
export-subst and git archive. It can also be used with git log etc.,
even though that's going to be slow due to the fork for each commit.
Suggested-by: Eli Schwartz <eschwartz@archlinux.org>
Signed-off-by: René Scharfe <l.s.r@web.de>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/pretty-formats.txt')
| -rw-r--r-- | Documentation/pretty-formats.txt | 2 |
1 files changed, 2 insertions, 0 deletions
diff --git a/Documentation/pretty-formats.txt b/Documentation/pretty-formats.txt index 6b59e28..bb8c05b 100644 --- a/Documentation/pretty-formats.txt +++ b/Documentation/pretty-formats.txt @@ -208,6 +208,8 @@ The placeholders are: '%cs':: committer date, short format (`YYYY-MM-DD`) '%d':: ref names, like the --decorate option of linkgit:git-log[1] '%D':: ref names without the " (", ")" wrapping. +'%(describe)':: human-readable name, like linkgit:git-describe[1]; + empty string for undescribable commits '%S':: ref name given on the command line by which the commit was reached (like `git log --source`), only works with `git log` '%e':: encoding |