NAME
    public-inbox-learn - spam trainer and remover for public-inbox

SYNOPSIS
    public-inbox-learn <spam|ham|rm> <MESSAGE

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 public-inbox-mda(1) or
    public-inbox-watch(1), but not users relying on git-fetch(1) to mirror
    inboxes.

    It reads one message from standard input and operates on it depending on
    the command given:

COMMANDS
    public-inbox-learn takes one of the following commands as its first and
    only argument:

    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 spamc(1) for training purposes unless
            "publicinboxmda.spamcheck" is "none" in public-inbox-config(5).

    ham     Treat standard input as ham. This is useful for manually
            injecting messages into the archives which failed the spam check
            run by public-inbox-mda(1) or public-inbox-watch(1).

            It relies on the "To:", "Cc:", and "List-ID:" headers to match
            configured inbox addresses and "listid" directives.

            It will also be fed to spamc(1) for training purposes unless
            "publicinboxmda.spamcheck" is "none" in public-inbox-config(5).

    rm      This is identical to the "spam" command above, but does not feed
            the message to spamc(1)

ENVIRONMENT
    PI_CONFIG
            Per-user config file parseable by git-config(1). See
            public-inbox-config(5).

            Default: ~/.public-inbox/config

CONTACT
    Feedback welcome via plain-text mail to <mailto:meta@public-inbox.org>

    The mail archives are hosted at <https://public-inbox.org/meta/> and
    <http://hjrcffqmbrq6wope.onion/meta/>

COPYRIGHT
    Copyright 2019 all contributors <mailto:meta@public-inbox.org>

    License: AGPL-3.0+ <https://www.gnu.org/licenses/agpl-3.0.txt>

SEE ALSO
    spamc(1), public-inbox-mda(1), public-inbox-watch(1)