Next: , Up: Miscellaneous   [Contents][Index]

8.1 Tagging

Also see the git-tag(1) manpage.

t     (magit-tag)

This transient prefix command binds the following suffix commands along with the appropriate infix arguments and displays them in a temporary buffer until a suffix is invoked.

t t     (magit-tag-create)

This command creates a new tag with the given NAME at REV. With a prefix argument it creates an annotate tag.

t r     (magit-tag-release)

This commands creates an annotated release tag. It assumes that release tags match magit-release-tag-regexp.

First it prompts for the name of the new tag using the highest existing tag as initial input and leaving it to the user to increment the desired part of the version string.

Then it prompts for the message of the new tag. The proposed tag message is based on the message of the highest tag, provided that that contains the corresponding version string and substituting the new version string for that. Otherwise it proposes something like "Foo-Bar 1.2.3", given, for example, a TAG "v1.2.3" and a repository located at something like "/path/to/foo-bar".

Then it calls "git tag –annotate –sign -m MSG TAG" to create the tag, regardless of whether these arguments are enabled in the transient. Finally it shows the refs buffer to let the user quickly review the result.

t k     (magit-tag-delete)

This command deletes one or more tags. If the region marks multiple tags (and nothing else), then it offers to delete those. Otherwise, it prompts for a single tag to be deleted, defaulting to the tag at point.

t p     (magit-tag-prune)

This command offers to delete tags missing locally from REMOTE, and vice versa.

Next: , Up: Miscellaneous   [Contents][Index]