Man pages sections > man1 > git-release

git-release - Commit, tag and push changes to the repository

GIT-RELEASE(1) Git Extras GIT-RELEASE(1)

NAME

git-release - Commit, tag and push changes to the repository

SYNOPSIS

git-release <tagname> [-r <remote>] [-m <commit info>] [-c] [[--] <hook arguments...>]

DESCRIPTION

Commits changes with message "Release <tagname>" or custom commit information, tags with the given <tagname> and pushes the branch / tags.
Optionally it generates a changelog (see git-changelog) and a remote can be defined. The order of first -c or -r does not matter.
If .git/hook/pre-release or .git/hook/post-release exist, they will be triggered with tagname and extra hook arguments before/after the release.

OPTIONS

<tagname>
The name of the newly created tag. Also used in tag comment.
-r <remote>
The "remote" repository that is destination of a push operation: it is passed to git push.
-m <commit info>
use the custom commit information instead of the default message "Release <tagname>" .
-c
Generates or populates the changelog with all commit message since the last tag. For more info see git-changelog..
[--] hook arguments...
The arguments listed after "--" separator will be passed to pre/post-release hook following the tagname.

EXAMPLES

Release commit with the given <tagname>.
$ git release 0.1.0
Release commit with the given <tagname> and custom commit message.
$ git release 0.1.0 -m "+ powerful feature added."
Release commit with the given <tagname> and push to specific remote.
$ git release 0.1.0 -r github
Release commit with the given <tagname> and populate changelog.
$ git release 0.1.0 -c
Release commit with the given <tagname>, populate changelog, and push to specific remote.
$ git release 0.1.0 -r github -c
Release commit with the given <tagname>, pass <tagname> and extra argument to release hook, populate changelog, and push to specific remote.
$ git release 0.1.0 -r github -c -- --signature-required

AUTHOR

Written by Tj Holowaychuk < tj@vision-media.ca> Extended by David Hartmann < dh@tsl.io>

REPORTING BUGS

< https://github.com/tj/git-extras/issues>

SEE ALSO

< https://github.com/tj/git-extras>
October 2017