Spackle Man Page

SourceForge

Last updated: Thursday, 1 January 1970 00:00 00000


Generated-and-frobbed Man Page

Below is the HTMLised version of the spackle-mailmap man page which accompanies the package. It was generated from the actual man page source, then heavily modified by hand to make it into valid and usable HTML. No content was changed during the modification.


Content-type: text/html Manpage of spackle-mailmap

spackle-mailmap

Section: Utilities (5)
Updated: March 2002
Index Return to Main Contents
 

NAME

spackle-mailmap - CVS Commit Mail Addresses  

SYNOPSIS

module-pattern:[flag,...]:eddress...  

DESCRIPTION

The CVSROOT/mailmap file is used by the Spackle(5) package to direct CVS commit messages to the appropriate addresses. The email addresses to which the commit reports are sent are entirely customisable, and may be different for different modules -- or even different files -- in the repository. The mailmap file provides this customisation ability.

Each line in the mailmap file consists of three colon (':') delimited fields:

module-pattern
A Perl regular expression which is applied to the names of the modules being committed.
flags
Zero or more flag keywords, separated by commas or spaces.
eddress
One or more email addresses, separated by commas or spaces.

When something is committed to the repository, the list of the modules affected is used to locate one or more entries in the mailmap file. An example module list would be:

spackle spackle-mailmap.5 MANIFEST Makefile.in

The first entry in the list is the name of the top-level module under which the other files are found.

The patterns of all entries in the mailmap file are scanned; if an entry's pattern doesn't match, the process proceeds to the next entry. If one is found to match, what happens next is determined by the value of the flag field. If it contains:

nothing
the contents of the eddress field is added to the mail destination list, and scanning continues.
fallback
the contents of the eddress is added to a fallback list, and scanning continues.
last
the contents of the eddress field is added to the mail destination list, and reading of the mailmap file stops immediately.

If the email destination list is empty when scanning has been completed, the value of the fallback list is used as the destination list. This permits an entry such as


 .:fallback:Jon.Doe@Example.Com

to appear anywhere in the file and act as a catch-all entry. If no better entry is found, Jon.Doe will receive the email.

If the destination list is empty, and there are no fallback eddresses, the log_accum.pl script will default to sending the mail to the MAINTAINER_EMAIL address specified at configure time or in the CVSROOT/spackle.conf file.  

NOTES

Invalid or incorrect entries in the mailmap file may cause commit messages to be misdirected in strange ways and to odd coordinates. After updating and committing your mailmap file, check subsequent commits to ensure no 'unable to send' or 'dead.letter' messages were displayed as part of the commit output.

Since the mailmap logging occurs after the commit has taken place, errors in sending the mail or in the mailmap file do not have any negative effect on the repository.  

AUTHOR

Rodent of Unusual Size <Ken.Coar@Golux.Com>  

SEE ALSO

spackle(5).

For more information, see the Spackle project Web site at <URL: http://Spackle.SourceForge.Net/ >.


 

Index

NAME
SYNOPSIS
DESCRIPTION
NOTES
AUTHOR
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 18:04:24 GMT, August 17, 2002
coar