From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: X-Spam-Status: No, score=-4.2 required=3.0 tests=ALL_TRUSTED,AWL,BAYES_00, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF shortcircuit=no autolearn=ham autolearn_force=no version=3.4.6 Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id AB8A91F406 for ; Wed, 16 Aug 2023 02:28:04 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=80x24.org; s=selector1; t=1692152884; bh=Mm7l3zea1ftu71aR2FkU0htRNWcv93h6zXwk4YJtvIg=; h=From:To:Subject:Date:From; b=b1ttpCoXr4No9gdgPazGSucyK7AzxzJb0ySSmVL4Db8PeeB1D+SIRSaqkFUawmQHr MKpwqVJoPITpdJ9TShDgAPNxElXjLJOmOMDUAw4dsxcWu8uQR2TtYyXCvtv2Xrc89p Iz2QfUZJVncwypHpb3nWB9/eZHrlsl1EDOzcn+d8= From: Eric Wong To: meta@public-inbox.org Subject: [PATCH] doc: extindex: note the use of `newsgroup' entries Date: Wed, 16 Aug 2023 02:26:57 +0000 Message-ID: <20230816022657.74064-1-e@80x24.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit List-Id: We'll also be using this for -cindex for associating inboxes to coderepos. --- coderepo <=> inbox association is proving tricky and slow :< and xapian-delve + quest CLI tools aren't enough... Documentation/public-inbox-extindex.pod | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/Documentation/public-inbox-extindex.pod b/Documentation/public-inbox-extindex.pod index 66e04060..a5f699c5 100644 --- a/Documentation/public-inbox-extindex.pod +++ b/Documentation/public-inbox-extindex.pod @@ -93,6 +93,12 @@ Putting an C entry in the config allows L. You can have any number of C sections where C<$NAME> is something other than C to display a union of several inboxes. +It is strongly recommended any public inboxes indexed by this command +have a stable C entry (regardless of +the presence of an NNTP or IMAP server). Otherwise, public-inbox-extindex +will use C as an internal key which can +cause needless reindexing and require L<--gc> if inboxes are relocated. + See L for more details. =head1 ENVIRONMENT