Getting Notified -- CVS---Concurrent Versions System



Next: Editing files Prev: Setting a watch Up: Watches Top: Top

6.6.2. Telling CVS to notify you

You can tell cvs that you want to receive notifications about various actions taken on a file. You can do this without using cvs watch on for the file, but generally you will want to use cvs watch on, so that developers use the cvs edit command.

cvs watch add [-a action] [-l] files ... -- Command
Add the current user to the list of people to receive notification of work done on files.

The -a option specifies what kinds of events CVS should notify the user about. action is one of the following:

edit
Another user has applied the cvs edit command (described below) to a file.

unedit
Another user has applied the cvs unedit command (described below) or the cvs release command to a file, or has deleted the file and allowed cvs update to recreate it.

commit
Another user has committed changes to a file.

all
All of the above.

none
None of the above. (This is useful with cvs edit, described below.)

The -a option may appear more than once, or not at all. If omitted, the action defaults to all.

The files and -l option are processed as for the cvs watch commands.

cvs watch remove [-a action] [-l] files ... -- Command
Remove a notification request established using cvs watch add; the arguments are the same. If the -a option is present, only watches for the specified actions are removed.

When the conditions exist for notification, cvs calls the notify administrative file, passing it the user to receive the notification and the user who is taking the action which results in notification. Normally notify will just send an email message.

Note that if you set this up in the straightforward way, users receive notifications on the server machine. One could of course write a notify script which directed notifications elsewhere, but to make this easy, cvs allows you to associate a notification address for each user. To do so create a file users in CVSROOT with a line for each user in the format user:value. Then instead of passing the name of the user to be notified to notify, cvs will pass the value (normally an email address on some other machine).



Next: Editing files Prev: Setting a watch Up: Watches Top: Top