Description
Describe the idea (required)
Properties commit.message.full
and commit.message.short
are useful to get information about the last commit.
But it is often quite technical.
If you want a more general, semantic description, it is in the messages from annotated tags, for example, created with git tag -a <tagname> -m "Message for tag <tagname>..."
.
I would suggest to get the closest tag annotation and put it into new properties, for example, with names closest.tag.message.full
and closest.tag.message.short
.
Tell us about the expected behaviour (required)
You can get these messages with command git tag
and option -n
.
More specifically, when the user requests:
closest.tag.message.full
: get the output ofgit tag -n99 <tagname>
(full message, maximum 99 lines)closest.tag.message.short
: get the output ofgit tag -n1 <tagname>
(only 1 line)
If the closest tag is not annotated, the git
commands automatically get the message from the last git commit instead, therefore, this would be equivalent to git.commit.message.*
.
Context (optional)
A tag usually represents a new release or a new version of the code.
Well used, an annotated tag message provides a practical way to convey a high-level summary over the content of this release.