NAME
    public-inbox-purge - erase messages from a public inbox and its history

SYNOPSIS
            # requires ~/.public-inbox/config
            public-inbox-purge --all </path/to/message-to-purge

            # for testing with unconfigured inboxes:
            public-inbox-purge $INBOX_DIR </path/to/message-to-purge

DESCRIPTION
    public-inbox-purge allows removing entire messages in a given inbox from
    history. It is only intended as a last resort, as it will cause
    discontiguous git history and draw more attention to the sensitive data
    in mirrors.

    For removing spam, public-inbox-learn(1) is preferable as it preserves
    contiguous git history.

    For editing sensitive information out of messages, consider
    public-inbox-edit(1), instead, but keep in mind it still leads to
    discontiguous git history.

OPTIONS
    --all
        Purge the message in all inboxes configured in
        ~/.public-inbox/config. This is an alternative to specifying
        individual inboxes directories on the command-line.

ENVIRONMENT
    PI_CONFIG
            The default config file, normally "~/.public-inbox/config". See
            public-inbox-config(5)

LIMITATIONS
    Only public-inbox-v2-format(5) inboxes are supported.

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
    public-inbox-edit(1), public-inbox-learn(1)