Re: [RFR] templates://crm114/{crm114.templates}
Christian Perrier wrote:
> Your review should be sent as an answer to this mail.
> Template: crm114/cssupgrade
> Type: boolean
> Default: false
> +_Description: Proceed with CRM114 upgrade?
> + The version of the crm114 package that is about to be installed is
> + not able to use .css files created by the currently installed version. This means
> + that any crm114 command is likely to fail with an error code, possibly rejecting
> incoming e-mail.
Is it worth expanding ".css files"? It's not "Cascading
StyleSheet", it's "CRM114 Sparse Spectra". Oh, except that
technically they aren't sparse spectra, so maybe we should just
leave it.
> - If you use crm114 during your e-mail delivery, it is highly recommended that
> - you stop your e-mail delivery or disable crm114 processing before permitting
> - the package upgrade.
> + If crm114 is an important piece for e-mail delivery on this machine,
> + it is highly recommended that
> + you delay the upgrade until you have analyzed the situation.
s/piece for/element in/.
This changes the recommendation from "the trick is to avoid routing
mail through CRM114 while you're upgrading it" to "don't upgrade it
until you've guessed what the trick is".
If the mail system on this machine depends on crm114, it is highly
recommended that delivery (or just crm114 processing) should be temporarily
disabled before the package is upgraded.
I think the possibility of delaying it is inherent in the question
(and the following paragraph's "If you proceed with the upgrade").
In the control file:
> -Description: The Controllable Regex Mutilator and Spam Filter
> +Description: versatile filtering system for email and other data
e-
Elsewhere we've got hyphenated e-mail.
> - CRM114 is a system to examine incoming e-mail, system log streams, data
> + CRM114 stands for "The Controllable Regex Mutilator and Spam Filter".
If it stood for that it would be TCRMSF. As a matter of fact the
name is a reference to Dr Strangelove, where an oversensitive CRM114
Discriminator causes the nuclear apocalypse! But let's just use our
old friend the appositive noun phrase construction:
CRM114, the Controllable Regex Mutilator, [is a...]
> + It is a system to examine incoming e-mail, system log streams, data
> files or other data streams, and to sort, filter, or alter the incoming
^, Harvard comma - for consistency with: ^
> files or data streams according to whatever the user desires. Criteria for
^^^^^^^^^^^^^^^^^^^^^
This doesn't quite work; just say "however".
> categorization of data can be by satisfaction of regexes, by sparse binary
^^^^^^^
We should probably expand this to "regular expressions" here, in
case anybody needs an explanation of the explanation of "CRM".
> polynomial matching with a Bayesian Chain Rule evaluator, or by other means.
> - Accuracy of the SBPH/BCR classifier has been seen in excess of 99 per cent,
> - for 1/4 megabyte of learning text. In other words, CRM114 learns, and it
> - learns fast.
>
> The last sentences are a little bit too close to "advertisement" as
> discouraged by the DevRef. Neutral language is the key, here.
Besides, in a field like this, anything that was described as "fast"
when this was first written would presumably be uselessly slow
against modern spammers.
> CRM114 is compatible with SpamAssassin or other spam-flagging software; it
> can also be pipelined in front of or behind procmail. CRM114 is also useful
> - as a syslog or firewall log filter, to alert you to important events but
> + as a syslog or firewall log filter, to alert about important events but
> ignore the ones that aren't meaningful.
>
> Not only "you"..:-)
Sorry, I think the verb "alert" needs an object. You could replace
it with "to flag up important events", though.
> - For mailfiltering you need to install metamail or mew-bin package to have
> - some tool to decode mime attachments.
> + For mail filtering, installing metamail or mew-bin packages is
> + recommended in order to have
> + tools to decode MIME attachments.
>
> Avoid using one-word contructions (we had a recent debate in dle about
> this but I think that, here, the contraction is less common than
> "filesystem").
Agreed; even the upstream FAQ has "mail filtering" (though the noun
is "mailfilter"). Oddly, one-word "spamfiltering" is much commoner,
but that's a bit different - I'm filtering _out_ the spam!
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
--- crm114-20090423.pristine/debian/crm114.templates 2009-09-05 16:04:26.000000000 +0100
+++ crm114-20090423/debian/crm114.templates 2009-09-09 19:32:45.000000000 +0100
@@ -1,17 +1,17 @@
Template: crm114/cssupgrade
Type: boolean
Default: false
-_Description: Is it safe to upgrade crm114 now?
- crm114 package is going to get upgraded to a new version that cannot read .css
- files created by the currently installed crm114 version. This means any
- crm114 command is likely to fail with an error code, possibly rejecting
+_Description: Proceed with CRM114 upgrade?
+ The version of the crm114 package that is about to be installed is
+ not able to use .css files created by the currently installed version. This means
+ that any crm114 command is likely to fail with an error code, possibly rejecting
incoming e-mail.
.
- If you use crm114 during your e-mail delivery, it is highly recommended that
- you stop your e-mail delivery or disable crm114 processing before permitting
- the package upgrade.
+ If the mail system on this machine depends on crm114, it is highly
+ recommended that delivery (or just crm114 processing) should be temporarily
+ disabled before the package is upgraded.
.
- After the upgrade is finished, please check carefully whether crm114 still
- works with your current .css files. If it does not, use your mailreaver cache
- to rebuild the .css files or create new .css files from scratch. Then you
- can enable your e-mail delivery again.
+ If you proceed with the upgrade, you should carefully check whether crm114
+ is still properly operating with existing .css files. If it does not, these
+ files should be rebuilt by using the mailreaver cache, or recreated from
+ scratch.
--- crm114-20090423.pristine/debian/control 2009-09-05 16:04:26.000000000 +0100
+++ crm114-20090423/debian/control 2009-09-09 19:43:37.000000000 +0100
@@ -11,20 +11,18 @@
Pre-Depends: debconf
Depends: ${shlibs:Depends}, ${misc:Depends}
Recommends: metamail | mew-bin
-Description: The Controllable Regex Mutilator and Spam Filter
- CRM114 is a system to examine incoming e-mail, system log streams, data
- files or other data streams, and to sort, filter, or alter the incoming
- files or data streams according to whatever the user desires. Criteria for
- categorization of data can be by satisfaction of regexes, by sparse binary
- polynomial matching with a Bayesian Chain Rule evaluator, or by other means.
- Accuracy of the SBPH/BCR classifier has been seen in excess of 99 per cent,
- for 1/4 megabyte of learning text. In other words, CRM114 learns, and it
- learns fast.
+Description: versatile filtering system for e-mail and other data
+ CRM114, the Controllable Regex Mutilator, is a system to examine incoming
+ e-mail, system log streams, data files, or other data streams, and to sort,
+ filter, or alter the incoming files or data streams however the user
+ desires. Criteria for categorization of data can be by satisfaction of
+ regular expressions, by sparse binary polynomial matching with a Bayesian
+ Chain Rule evaluator, or by other means.
.
CRM114 is compatible with SpamAssassin or other spam-flagging software; it
can also be pipelined in front of or behind procmail. CRM114 is also useful
- as a syslog or firewall log filter, to alert you to important events but
- ignore the ones that aren't meaningful.
+ as a syslog or firewall log filter, to flag up important events but ignore
+ the ones that aren't meaningful.
.
- For mailfiltering you need to install metamail or mew-bin package to have
- some tool to decode mime attachments.
+ For mail filtering, installing metamail or mew-bin packages is
+ recommended in order to have tools to decode MIME attachments.
Template: crm114/cssupgrade
Type: boolean
Default: false
_Description: Proceed with CRM114 upgrade?
The version of the crm114 package that is about to be installed is
not able to use .css files created by the currently installed version. This means
that any crm114 command is likely to fail with an error code, possibly rejecting
incoming e-mail.
.
If the mail system on this machine depends on crm114, it is highly
recommended that delivery (or just crm114 processing) should be temporarily
disabled before the package is upgraded.
.
If you proceed with the upgrade, you should carefully check whether crm114
is still properly operating with existing .css files. If it does not, these
files should be rebuilt by using the mailreaver cache, or recreated from
scratch.
Source: crm114
Section: mail
Priority: optional
Maintainer: Milan Zamazal <pdm@debian.org>
Build-Depends: debhelper (>= 7), dpatch, libtre-dev (>= 0.6.8), po-debconf
Standards-Version: 3.8.3
Homepage: http://crm114.sourceforge.net
Package: crm114
Architecture: any
Pre-Depends: debconf
Depends: ${shlibs:Depends}, ${misc:Depends}
Recommends: metamail | mew-bin
Description: versatile filtering system for e-mail and other data
CRM114, the Controllable Regex Mutilator, is a system to examine incoming
e-mail, system log streams, data files, or other data streams, and to sort,
filter, or alter the incoming files or data streams however the user
desires. Criteria for categorization of data can be by satisfaction of
regular expressions, by sparse binary polynomial matching with a Bayesian
Chain Rule evaluator, or by other means.
.
CRM114 is compatible with SpamAssassin or other spam-flagging software; it
can also be pipelined in front of or behind procmail. CRM114 is also useful
as a syslog or firewall log filter, to flag up important events but ignore
the ones that aren't meaningful.
.
For mail filtering, installing metamail or mew-bin packages is
recommended in order to have tools to decode MIME attachments.
Reply to: