1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
| | =head1 NAME
public-inbox-learn - spam trainer and remover for public-inbox
=head1 SYNOPSIS
public-inbox-learn <spam|ham|rm> </path/to/RFC2822_message
=head1 DESCRIPTION
public-inbox-learn can remove spam or inject ham messages into
an inbox while training a SpamAssassin instance.
It is intended for users of L<public-inbox-mda(1)> or
L<public-inbox-watch(1)>, but not users relying on
L<git-fetch(1)> to mirror inboxes.
It reads one message from standard input and operates on it
depending on the command given:
=head1 COMMANDS
public-inbox-learn takes one of the following commands as its
first and only argument:
=over 8
=item spam
Treat the message as spam. This will mark the message as
removed so it becomes inaccessible via NNTP or WWW endpoints
for all configured inboxes.
The message remains accessible in git history.
It will also be fed to L<spamc(1)> for training purposes unless
C<publicinboxmda.spamcheck> is C<none> in L<public-inbox-config(5)>.
=item ham
Treat standard input as ham. This is useful for manually injecting
messages into the archives which failed the spam check run by
L<public-inbox-mda(1)> or L<public-inbox-watch(1)>.
It relies on the C<To:>, C<Cc:>, and C<List-ID:> headers
to match configured inbox addresses and C<listid> directives.
It will also be fed to L<spamc(1)> for training purposes unless
C<publicinboxmda.spamcheck> is C<none> in L<public-inbox-config(5)>.
=item rm
This is similar to the C<spam> command above, but does
not feed the message to L<spamc(1)> and only removes messages
which match on any of the C<To:>, C<Cc:>, and C<List-ID:> headers.
The C<--all> option may be used to match C<spam> semantics in removing
the message from all configured inboxes. C<--all> is only
available in public-inbox 1.6.0+.
=back
=head1 ENVIRONMENT
=over 8
=item PI_CONFIG
Per-user config file parseable by L<git-config(1)>.
See L<public-inbox-config(5)>.
Default: ~/.public-inbox/config
=back
=head1 CONFIGURATION
These configuration knobs should be used in the
L<public-inbox-config(5)> file.
=over 8
=item publicinboxImport.dropUniqueUnsubscribe
=item publicinbox.<name>.address
=item publicinbox.<name>.listid
=item publicinboxmda.spamcheck
See L<public-inbox-config(5)> for descriptions of these options
=back
=head1 CONTACT
Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>
The mail archives are hosted at L<https://public-inbox.org/meta/> and
L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/>
=head1 COPYRIGHT
Copyright all contributors L<mailto:meta@public-inbox.org>
License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>
=head1 SEE ALSO
L<spamc(1)>, L<public-inbox-mda(1)>, L<public-inbox-watch(1)>
|