The format of the 'CVSROOT/users' file is simply.

	<username>:<email-address>

CruiseControl simply reads this file like a Java properties file.

Now what you have to set your CVSROOT to your local or remote repository as normal. Change to a spare directory or the top level directory for your workspace

% cd /workspace

then issue the following to checkout the administration files for your repository

% cvs checkout CVSROOT 

(If you are not the CVS Administrator this may break.
Instead get him/her to do this task instead)

Now change to the CVSROOT directory and create a mapping
file like this.

# CruiseControl login mapping email configuration 
# $Id$
mjjackson:michael.jackson@wonderland.acme.com
eddie:eddie.van-halen@van-halen.acme.com
jimmy:jimmy.hendrix@hendrix.com
diazc:cameron.diaz@openwideforeveryone.com

Save the file as "users", all lowercase characters. Register and check this file in CVS as normal.

% cvs add users
% cvs commit -m "Register in CVS" users

The next time Cruise Control runs it will be grab the file 'CVSROOT/users' and use it to send out electronic
mail. You can then delete the redundant <map> aliases
from the CruiseControl config file.

Job done! Afterwards, you can delete the CVSRoot administration module from your local workspace unless you actually need it, say, to add more users later on.

Hope this helps.

Peter Pilgrim
I can be reached at "peterp at xenonsoft dot demon dot co dot uk"

Please note that this is a standard CVS trick, used by other tools besides CruiseControl. We're leveraging this behaviour, not creating it.