NAME

dot-commitmail.pl - Subversion hook to send commit email to recipients listed in .commitmail files


SYNOPSYS

dot-commitmail.pl REPOS REVNUM [options]


DESCRIPTION

Look for .commitmail files in the repository, and send commit-email to recipients listed therein, one per line, but only for commits in the same directory or in subdirectories. We invoke commit-email.pl with the appropriate -m argument and email addresses, passing on all other options.


INSTALLATION

You will find, in your subversion repository, a ``hooks'' directory. In it, there is a template post-commit.tmpl. It will tell you that you can put something like: /path/to/dot-commitmail.pl ``$REPOS'' ``$REV'' -s ``[SVN Your_Repos]'' in a post-hook script or batch file to invoke this script.

Then, to start adding people, simply create .commitmail files in your sandbox and check them in. They should contain one email address per line. If a commit affects a directory with a .commitmail file, or any of its subdirectories, then the recipients listed in that .commitmail file will get the change message.

This script does not actually generate the change message sent, but relies instead on the commit-email.pl program that was supplied with Subversion. There are other programs that do this, some make pretty html with colors for example, and as long as their command line syntax is the same, you can use this program with one of those. To do so, add that program to the @possible_commit_email_progs variable here.


NOTES

commit-email.pl is expected to live either in /usr/lib/subversion/hook-scripts or in REPOS/hooks/


SEE ALSO

/usr/lib/subversion/hook-scripts/commit-email.pl REPOS/hooks/post-commit.tmpl


BUGS

Specifying the -m option will potentially send email to the wrong recipients without warning.


AUTHOR

Copyright (c) 2006 Gregory Marton http://csail.mit.edu/~gremio/

This program may be modified and distributed under the same terms as Subversion itself.


DOWNLOAD

http://csail.mit.edu/~gremio/code/dot-commitmail.pl