user/dev discussion of public-inbox itself
 help / color / mirror / Atom feed
498c5092cfd397fd2166c00618d3da31bbc87c1e blob 2392 bytes (raw)

 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
 
=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 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 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://hjrcffqmbrq6wope.onion/meta/>

=head1 COPYRIGHT

Copyright 2019-2020 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)>
debug log:

solving 498c5092 ...
found 498c5092 in https://80x24.org/public-inbox.git

user/dev discussion of public-inbox itself

This inbox may be cloned and mirrored by anyone:

	git clone --mirror http://public-inbox.org/meta
	git clone --mirror http://czquwvybam4bgbro.onion/meta
	git clone --mirror http://hjrcffqmbrq6wope.onion/meta
	git clone --mirror http://ou63pmih66umazou.onion/meta

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V1 meta meta/ http://public-inbox.org/meta \
		meta@public-inbox.org
	public-inbox-index meta

Example config snippet for mirrors.
Newsgroups are available over NNTP:
	nntp://news.public-inbox.org/inbox.comp.mail.public-inbox.meta
	nntp://ou63pmih66umazou.onion/inbox.comp.mail.public-inbox.meta
	nntp://czquwvybam4bgbro.onion/inbox.comp.mail.public-inbox.meta
	nntp://hjrcffqmbrq6wope.onion/inbox.comp.mail.public-inbox.meta
	nntp://news.gmane.io/gmane.mail.public-inbox.general
 note: .onion URLs require Tor: https://www.torproject.org/

code repositories for the project(s) associated with this inbox:

	https://80x24.org/public-inbox.git

AGPL code for this site: git clone https://public-inbox.org/public-inbox.git