From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-Status: No, score=-4.0 required=3.0 tests=ALL_TRUSTED,AWL,BAYES_00 shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id 386121F66F for ; Thu, 20 Aug 2020 20:24:58 +0000 (UTC) From: Eric Wong To: meta@public-inbox.org Subject: [PATCH 01/23] doc: note -compact and -xcpdb are rarely used Date: Thu, 20 Aug 2020 20:24:35 +0000 Message-Id: <20200820202457.21042-2-e@yhbt.net> In-Reply-To: <20200820202457.21042-1-e@yhbt.net> References: <20200820202457.21042-1-e@yhbt.net> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit List-Id: Slowly improving the learning curve... --- Documentation/public-inbox-compact.pod | 5 +++++ Documentation/public-inbox-xcpdb.pod | 3 +++ 2 files changed, 8 insertions(+) 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 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 +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, L, L, and L. +This command is rarely used, as Xapian DB formats rarely +change. + =head1 OPTIONS =over