Commit Email Configuration

Each project can choose to configure their commit email subject lines. The configuration comes in the form of a Python format string that can be used with a number of predefined variables. A couple examples of email subject lines are as follows:

git commit: %(subject)s
git commit: %(short_commit)s - %(files)s
git commit: updated %(branch)s to %(branch_newsha)s

The first format is the default format for projects that uses the first line of the commit message as the subject. The second example is what infra uses to match its SVN format. The third is what we've recently tried using at CouchDB and has the advantage of turning commit messages into threads for email clients that use the GMail popularized "conversatin view".

Available Variables

repo
The name of the repository being updated
branch
The name of the updated ref this commit is part of
branch_oldsha
The short hash of the previous version of the updated ref
branch_newsha
The short hash of the new version of the updated ref
commit
The full commit sha
short_commit
The short commit sha
parents
The parent commit shas
author
The author of the commit
authored
The authored date of the commit
committer
The committer of the commit
committed
The committed date of the commit
subject
The first line of the commit message
files
The list of affected files