X-Git-Url: http://www.git.stargrave.org/?a=blobdiff_plain;f=Documentation%2Fpublic-inbox-v1-format.pod;fp=Documentation%2Fpublic-inbox-v1-format.pod;h=3b0e70e1fc5f68039a114062af4b3b7282c4cc87;hb=d2de7f85982da35d2e8a6fda48784946f6443f65;hp=2a6b8d3c6f1c07b4073b827323c3a2a47022de90;hpb=96a27a0a073b61c465240bbbbb05a4c16f67c8d4;p=public-inbox.git

diff --git a/Documentation/public-inbox-v1-format.pod b/Documentation/public-inbox-v1-format.pod
index 2a6b8d3c..3b0e70e1 100644
--- a/Documentation/public-inbox-v1-format.pod
+++ b/Documentation/public-inbox-v1-format.pod
@@ -134,6 +134,10 @@ Since SCHEMA_VERSION 15 and the development of the v2 format,
 the "overview" DB also exists in the xapian directory for v1
 repositories.  See L<public-inbox-v2-format(5)/OVERVIEW DB>
 
+Our use of the L</OVERVIEW DB> requires Xapian document IDs to
+remain stable.  Thus, use of L<xapian-compact(1)> and
+L<copydatabase(8)> require the use of C<--no-renumber> switch.
+
 =item $GIT_DIR/ssoma.index
 
 This file is no longer used or created by public-inbox, but it is