3 public-inbox-learn - spam trainer and remover for public-inbox
7 public-inbox-learn <spam|ham|rm> </path/to/RFC2822_message
11 public-inbox-learn can remove spam or inject ham messages into
12 an inbox while training a SpamAssassin instance.
14 It is intended for users of L<public-inbox-mda(1)> or
15 L<public-inbox-watch(1)>, but not users relying on
16 L<git-fetch(1)> to mirror inboxes.
18 It reads one message from standard input and operates on it
19 depending on the command given:
23 public-inbox-learn takes one of the following commands as its
24 first and only argument:
30 Treat the message as spam. This will mark the message as
31 removed so it becomes inaccessible via NNTP or WWW endpoints
32 for all configured inboxes.
34 The message remains accessible in git history.
36 It will also be fed to L<spamc(1)> for training purposes unless
37 C<publicinboxmda.spamcheck> is C<none> in L<public-inbox-config(5)>.
41 Treat standard input as ham. This is useful for manually injecting
42 messages into the archives which failed the spam check run by
43 L<public-inbox-mda(1)> or L<public-inbox-watch(1)>.
45 It relies on the C<To:>, C<Cc:>, and C<List-ID:> headers
46 to match configured inbox addresses and C<listid> directives.
48 It will also be fed to L<spamc(1)> for training purposes unless
49 C<publicinboxmda.spamcheck> is C<none> in L<public-inbox-config(5)>.
53 This is similar to the C<spam> command above, but does
54 not feed the message to L<spamc(1)> and only removes messages
55 which match on any of the C<To:>, C<Cc:>, and C<List-ID:> headers.
57 The C<--all> option may be used match C<spam> semantics in removing
58 the message from all configured inboxes. C<--all> will be
59 available in public-inbox 1.6.0 (PENDING).
69 Per-user config file parseable by L<git-config(1)>.
70 See L<public-inbox-config(5)>.
72 Default: ~/.public-inbox/config
78 Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>
80 The mail archives are hosted at L<https://public-inbox.org/meta/>
81 and L<http://hjrcffqmbrq6wope.onion/meta/>
85 Copyright 2019-2020 all contributors L<mailto:meta@public-inbox.org>
87 License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>
91 L<spamc(1)>, L<public-inbox-mda(1)>, L<public-inbox-watch(1)>