]> Sergey Matveev's repositories - public-inbox.git/blob - Documentation/public-inbox-purge.pod
doc: add technical/whyperl
[public-inbox.git] / 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)>