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