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

8.1 Tagging

Also see the git-tag(1) manpage.

t     (magit-tag-popup)

This prefix command shows the following suffix commands along with the appropriate infix arguments in a popup buffer.

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 popup. 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]