diff options
author | Junio C Hamano <gitster@pobox.com> | 2023-08-02 09:37:24 -0700 |
---|---|---|
committer | Junio C Hamano <gitster@pobox.com> | 2023-08-02 09:37:24 -0700 |
commit | 70e5c5ddddadc7f15f64f812ae511eab83ca0040 (patch) | |
tree | 7da7c89132f10d8c574d1cb190d8cef8e609096c /Documentation/git-for-each-ref.txt | |
parent | 8bfb359844cf51aedaf0d28486d4ce9867ccb46c (diff) | |
parent | f5d18f8c0ef9cc3e62420268c2e72d1fd46b940c (diff) | |
download | git-70e5c5ddddadc7f15f64f812ae511eab83ca0040.tar.gz |
Merge branch 'ks/ref-filter-describe'
"git branch --list --format=<format>" and friends are taught
a new "%(describe)" placeholder.
* ks/ref-filter-describe:
ref-filter: add new "describe" atom
ref-filter: add multiple-option parsing functions
Diffstat (limited to 'Documentation/git-for-each-ref.txt')
-rw-r--r-- | Documentation/git-for-each-ref.txt | 23 |
1 files changed, 23 insertions, 0 deletions
diff --git a/Documentation/git-for-each-ref.txt b/Documentation/git-for-each-ref.txt index d9588767a9..11b2bc3121 100644 --- a/Documentation/git-for-each-ref.txt +++ b/Documentation/git-for-each-ref.txt @@ -264,6 +264,29 @@ ahead-behind:<committish>:: commits ahead and behind, respectively, when comparing the output ref to the `<committish>` specified in the format. +describe[:options]:: + A human-readable name, like linkgit:git-describe[1]; + empty string for undescribable commits. The `describe` string may + be followed by a colon and one or more comma-separated options. ++ +-- +tags=<bool-value>;; + Instead of only considering annotated tags, consider + lightweight tags as well; see the corresponding option in + linkgit:git-describe[1] for details. +abbrev=<number>;; + Use at least <number> hexadecimal digits; see the corresponding + option in linkgit:git-describe[1] for details. +match=<pattern>;; + Only consider tags matching the given `glob(7)` pattern, + excluding the "refs/tags/" prefix; see the corresponding option + in linkgit:git-describe[1] for details. +exclude=<pattern>;; + Do not consider tags matching the given `glob(7)` pattern, + excluding the "refs/tags/" prefix; see the corresponding option + in linkgit:git-describe[1] for details. +-- + In addition to the above, for commit and tag objects, the header field names (`tree`, `parent`, `object`, `type`, and `tag`) can be used to specify the value in the header field. |