public-inbox-index creates and updates the search, overview and
NNTP article number database used by the read-only public-inbox
HTTP and NNTP interfaces. Currently, this requires
-L<DBD::SQlite> and L<DBI> Perl modules. L<Search::Xapian>
+L<DBD::SQLite> and L<DBI> Perl modules. L<Search::Xapian>
is optional, only to support the PSGI search interface.
Once the initial indices are created by public-inbox-index,
=item --reindex
-Forces a search engine re-index of all messages in the
-repository. This can be used for in-place upgrades while
+Forces a re-index of all messages in the inbox.
+This can be used for in-place upgrades and bugfixes while
NNTP/HTTP server processes are utilizing the index. Keep in
mind this roughly doubles the size of the already-large
-Xapian database.
+Xapian database. Running L<public-inbox-compact(1)>
+afterwards is recommended to release free space.
This does not touch the NNTP article number database.
+=item --prune
+
+Run L<git-gc(1)> to prune and expire reflogs if discontiguous history
+is detected. This is intended to be used in mirrors after running
+L<public-inbox-edit(1)> or L<public-inbox-purge(1)> to ensure data
+is expunged from mirrors.
+
=back
=head1 FILES
All public-inbox-specific files are contained within the
C<$GIT_DIR/public-inbox/> directory.
-v2 repositories are described in L<public-inbox-v2-format>.
-
-=back
+v2 inboxes are described in L<public-inbox-v2-format>.
=head1 ENVIRONMENT
=head1 COPYRIGHT
-Copyright 2016-2019 all contributors L<mailto:meta@public-inbox.org>
+Copyright 2016-2020 all contributors L<mailto:meta@public-inbox.org>
License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt>