crm114 for Debian
-----------------

crm114 is a case of "the source is the documentation"; please see
/usr/share/crm114 for additional examples and documentation.  Many files
are well-commented.

 -- John Goerzen <jgoerzen@complete.org>, Tue, 21 Jan 2003 15:49:23 -0600

crm114 provides scripts ready for immediate use in /usr/share/crm114/.  Other
example scripts are available in /usr/share/doc/crm114/examples/.

WARNING: Although the scripts in /usr/share/crm114/ can be used directly, I
don't recommend to do so if you use crm114 for mail filtering.  You risk that
something breaks in your setup when crm114 gets upgraded.  I recommend copying
the *.crm scripts you use to your private location and working with the copies.
Then you can upgrade the scripts only when you know what you are doing,
avoiding surprises on apt-get update.  And of course, your mail delivery system
should always be set up in such a way that it doesn't stop working when crm114
breaks.

 -- Milan Zamazal <pdm@debian.org>  2006-07-14

If you experience broken threading caused by Message-Id modifications performed
by crm114, this may happen because one of the following reasons:

1. Your MUA is not RFC-compliant and should be fixed.

2. crm114 scripts are not RFC-compliant and should be fixed.

We expect 1. is the case, but if you think otherwise, please let me know.
Don't forget to attach detailed explanation so that crm114 developers know what
exactly is broken and how it should be fixed.  See also bug #406207.

 -- Milan Zamazal <pdm@debian.org>  2007-01-28

New crm114 upstream versions break compatibility of .css files from time to
time.  The result is that crm114 may stop working after upgrade.  crm114 Debian
package tries to prevent the breakage by asking an unavoidable question on
upgrades between incompatible versions.  If this disturbs your preseeded
upgrades, you can set debconf boolean option crm114/forceupgrade to true.  Then
crm114 will proceed with the upgrade without any warning questions.  Note that
in such a case it is your full responsibility to prevent breaks in advance.
 
 -- Milan Zamazal <pdm@debian.org>  2010-02-07
