Commit notification e-mail
--------------------------

To configure commit notification e-mails for the first time, do the following:

- the following should be done regardless commit notification:
  = install git;
  = run git config --global user.name "<Your Name>"
  = run git config --global user.email "<your email>"
- clone/pull this tree (further it's location is <this tree>);
- create a folder <git templates>;
- symlink <this tree>/git_template/hooks to <git templates path>/hooks;
- configure git templates location globally:
  = for git versions >= 1.7.1, run 
    git config --global init.templatedir <git templates path>
  = for older git versions, set the environmemnt variable 
    GIT_TEMPLATE_DIR=<git templates path> 
    and make sure it is always set whenever you work with git;
- run git config --global hooks.postcommitrecipients "<comma-separated list of addresses to send emails to>;
- run git config --global hooks.postcommitbranches "<space-separated list of branches> (* wildcard is allowed)
- optionally:
  = run git config --global hooks.postcommitsender <e-mail to send notifications from> 
  = run git config --global hooks.postcommitmailer <path to mailer> 
    if anything other than /usr/sbin/sendmail is to be used
- make sure <this tree>/git_template/hooks/post-commit-email is executable;

Example (most common set of commands):

bzr branch lp:mariadb-tools 
mkdir $HOME/.git_template/
ln -s `pwd`/mariadb-tools/git_template/hooks $HOME/.git_template/hooks
git config --global init.templatedir $HOME/.git_template
git config --global hooks.postcommitrecipients "commits@mariadb.org"
git config --global hooks.postcommitbranches "*"

From now on, for all new clones of branches listed in hooks/postcommitbranches, 
commit notifications should be sent. 

If you had already cloned some trees before enabling commit notifications, 
you will need to amend those trees:

cd <cloned folder>
rm -rf .git/hooks
ln -s <this tree>/git_template/hooks .git/hooks


To disable commit notification(s), set SKIP_COMMIT_EMAIL environment variable 
to a non-empty value or set hooks.postcommitbranches to an empty value.


Notes:

- hooks/postcommitrecipients is a *comma-separated* list of e-mails. Normally, 
  it is expected to contain the commit mailing list, but you can add some other
  address(es) or change it if you wish;
- hooks/postcommitbranches is a *space-separated* list of branches affected 
  by the post-commit hook. Asterisk wildcard is allowed. 
  Please note that these are *real* git branches, as opposed to branch nicknames. 

Examples:

Assuming you did the following
  git clone https://github.com/MariaDB/server 10.1-mdev1234
  ...
  git branch
  # * 10.1
  git commit -a

 Example 1:
  postcommitbranches = 10.0 10.1 10.2
  # The commit e-mail will be sent because the current branch is 10.1, 
  # it's on the list

  Example 2:
  postcommitbranches = 10.0-* 10.1-* 10.2-*
  # The commit e-mail won't be sent because the current branch is 10.1, 
  # it does not match the pattern 10.1-*

  Example 3:
  postcommitbranches = 10*
  # The commit e-mail will be sent