Documentation/public-inbox-purge.pod

   1 =head1 NAME
   2
   3 public-inbox-purge - erase messages from a public inbox and its history
   4
   5 =head1 SYNOPSIS
   6
   7         # requires ~/.public-inbox/config
   8         public-inbox-purge --all </path/to/message-to-purge
   9
  10         # for testing with unconfigured inboxes:
  11         public-inbox-purge $INBOX_DIR </path/to/message-to-purge
  12
  13 =head1 DESCRIPTION
  14
  15 public-inbox-purge allows removing entire messages in a given
  16 inbox from history.  It is only intended as a last resort, as it
  17 will cause discontiguous git history and draw more attention to
  18 the sensitive data in mirrors.
  19
  20 For removing spam, L<public-inbox-learn(1)> is preferable as it
  21 preserves contiguous git history.
  22
  23 For editing sensitive information out of messages, consider
  24 L<public-inbox-edit(1)>, instead, but keep in mind it still
  25 leads to discontiguous git history.
  26
  27 =head1 OPTIONS
  28
  29 =over
  30
  31 =item --all
  32
  33 Purge the message in all inboxes configured in ~/.public-inbox/config.
  34 This is an alternative to specifying individual inboxes directories
  35 on the command-line.
  36
  37 =back
  38
  39 =head1 ENVIRONMENT
  40
  41 =over 8
  42
  43 =item PI_CONFIG
  44
  45 The default config file, normally "~/.public-inbox/config".
  46 See L<public-inbox-config(5)>
  47
  48 =back
  49
  50 =head1 LIMITATIONS
  51
  52 Only L<public-inbox-v2-format(5)> inboxes are supported.
  53
  54 =head1 CONTACT
  55
  56 Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org>
  57
  58 The mail archives are hosted at L<https://public-inbox.org/meta/>
  59 and L<http://hjrcffqmbrq6wope.onion/meta/>
  60
  61 =head1 COPYRIGHT
  62
  63 Copyright 2019-2020 all contributors L<mailto:meta@public-inbox.org>
  64
  65 License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>
  66
  67 =head1 SEE ALSO
  68
  69 L<public-inbox-edit(1)>, L<public-inbox-learn(1)>