From 4666eceed62cc37d02cd7d35d8ab327ef3833636 Mon Sep 17 00:00:00 2001
From: Eric Wong <e@80x24.org>
Date: Tue, 31 Aug 2021 22:23:00 +0000
Subject: [PATCH] extindex: document --all and indexlevel=basic interaction

Cache is expensive, so help users save on storage by documenting
this behavior.
---
 Documentation/public-inbox-extindex.pod | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Documentation/public-inbox-extindex.pod b/Documentation/public-inbox-extindex.pod
index fed5017b..2e2e6383 100644
--- a/Documentation/public-inbox-extindex.pod
+++ b/Documentation/public-inbox-extindex.pod
@@ -29,6 +29,17 @@ along with L<DBD::SQLite> and L<DBI> Perl modules.
 
 ... TODO, see L<public-inbox-index(5)>
 
+=item --all
+
+Index all C<publicinbox> entries in C<PI_CONFIG>.
+
+C<publicinbox> entries indexed by C<public-inbox-extindex> can
+have full Xapian searching abilities with the per-C<publicinbox>
+C<indexlevel> set to C<basic> and their respective Xapian
+(C<xap15> or C<xapian15>) directories removed.  For multiple
+public-inboxes where cross-posting is common, this allows
+significant space savings on Xapian indices.
+
 =back
 
 =head1 FILES
-- 
2.44.0