about summary refs log tree commit homepage
path: root/Documentation
diff options
context:
space:
mode:
authorEric Wong <e@yhbt.net>2020-08-20 20:24:35 +0000
committerEric Wong <e@yhbt.net>2020-08-20 21:08:25 +0000
commit11b8815b47b334a1726e517e0a443182f835af74 (patch)
tree24e637c96fa6633ea9b1de0467a8d0c00d849745 /Documentation
parent3086aafb32481fa06f3adca9229d5b5733acff1e (diff)
downloadpublic-inbox-11b8815b47b334a1726e517e0a443182f835af74.tar.gz
Slowly improving the learning curve...
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/public-inbox-compact.pod5
-rw-r--r--Documentation/public-inbox-xcpdb.pod3
2 files changed, 8 insertions, 0 deletions
diff --git a/Documentation/public-inbox-compact.pod b/Documentation/public-inbox-compact.pod
index 8e463ab1..4e9b6d9f 100644
--- a/Documentation/public-inbox-compact.pod
+++ b/Documentation/public-inbox-compact.pod
@@ -19,6 +19,11 @@ It enforces the use of the C<--no-renumber> option of
 L<xapian-compact(1)> which is required to work with the
 rest of the public-inbox search code.
 
+This command is rarely needed for active inboxes.
+
+Using the C<--compact> option of L<public-inbox-index(1)>
+is recommended, instead, and only when doing a C<--reindex>.
+
 =head1 OPTIONS
 
 =over
diff --git a/Documentation/public-inbox-xcpdb.pod b/Documentation/public-inbox-xcpdb.pod
index 2b38f1da..52939894 100644
--- a/Documentation/public-inbox-xcpdb.pod
+++ b/Documentation/public-inbox-xcpdb.pod
@@ -17,6 +17,9 @@ accept parallel Xapian database modifications from
 L<public-inbox-watch(1)>, L<public-inbox-mda(1)>,
 L<public-inbox-learn(1)>, and L<public-inbox-index(1)>.
 
+This command is rarely used, as Xapian DB formats rarely
+change.
+
 =head1 OPTIONS
 
 =over