TMDA Bugs & Patches

Reporting bugs and contributing code are both encouraged, but to make things easier on the developers, please adhere to the following guidelines.

Bug reports and patch submissions should be sent to the tmda-workers mailing list. You do not need to be subscribed to post a message there.

Reporting Bugs:

In your report, please include at least the following information:

Your TMDA version, your Python version, and your operating system.
Your type of TMDA installation (tarball, Linux RPM, FreeBSD port, etc.).
Which MTA you are running (qmail, Postfix, etc.)
If you are running TMDA from procmail or maildrop.
Any other information you think might be relevant.

Submitting Patches:

Emailed patches should preferably be sent in MIME format, with the actual patch included as an attachment.
When making patches with diff, please use the -u option, or if your diff doesn't support it, -c. Also, it is helpful if you create the patch from the top level of the TMDA source directory:
Diffs should be made against the current development source from CVS rather than the particular TMDA release you happen to be using.

Here is an example illustrating the above concepts:

Checkout the latest developement sources from TMDA's CVS repository. This will create a `tmda' subdirectory in your current working directory containing the source:

% cd /var/tmp
% cvs -d:pserver:anonymous@cvs.tmda.sf.net:/cvsroot/tmda login
[press return at the password prompt]

% cvs -z3 -d:pserver:anonymous@cvs.tmda.sf.net:/cvsroot/tmda co tmda

Make the necessary changes:

% cd /var/tmp/tmda
(hack, hack, hack....)

Create your patch called "tmda.diff":

% cd /var/tmp/tmda
% cvs diff -u > tmda.diff

If you wish, accompany your patch with an update to the apropriate ChangeLog file. If you use Emacs, you can use the M-x add-change-log-entry command to do this automatically. Guidelines for writing ChangeLog entries are governed by the GNU coding standards. See the Change Logs section for details.