diff options
author | Eric Wong <e@80x24.org> | 2019-10-28 10:45:28 +0000 |
---|---|---|
committer | Eric Wong <e@80x24.org> | 2019-10-30 09:13:41 +0000 |
commit | 4da1c13914d958807fe9ef347d3a6abf7b129b62 (patch) | |
tree | 31da0af21a03097244883776e1f800f6680b06ca | |
parent | 74a3206babe0572a1494500d21267a31873af7b0 (diff) | |
download | public-inbox-4da1c13914d958807fe9ef347d3a6abf7b129b62.tar.gz |
Tools intended for end users need manpages.
-rw-r--r-- | Documentation/include.mk | 1 | ||||
-rw-r--r-- | Documentation/public-inbox-learn.pod | 86 | ||||
-rw-r--r-- | MANIFEST | 1 |
3 files changed, 88 insertions, 0 deletions
diff --git a/Documentation/include.mk b/Documentation/include.mk index d2357ffc..bb622c1a 100644 --- a/Documentation/include.mk +++ b/Documentation/include.mk @@ -41,6 +41,7 @@ m1 += public-inbox-edit m1 += public-inbox-httpd m1 += public-inbox-index m1 += public-inbox-init +m1 += public-inbox-learn m1 += public-inbox-mda m1 += public-inbox-nntpd m1 += public-inbox-watch diff --git a/Documentation/public-inbox-learn.pod b/Documentation/public-inbox-learn.pod new file mode 100644 index 00000000..b8190b59 --- /dev/null +++ b/Documentation/public-inbox-learn.pod @@ -0,0 +1,86 @@ +=head1 NAME + +public-inbox-learn - spam trainer and remover for public-inbox + +=head1 SYNOPSIS + +B<public-inbox-learn> <spam|ham|rm> E<lt>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 identical to the C<spam> command above, but does +not feed the message to L<spamc(1)> + +=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 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)> @@ -22,6 +22,7 @@ Documentation/public-inbox-edit.pod Documentation/public-inbox-httpd.pod Documentation/public-inbox-index.pod Documentation/public-inbox-init.pod +Documentation/public-inbox-learn.pod Documentation/public-inbox-mda.pod Documentation/public-inbox-nntpd.pod Documentation/public-inbox-overview.pod |