From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eric Abrahamsen Newsgroups: gmane.emacs.bugs Subject: bug#59121: 29.0.50; Gnus: Nnir is deprecated but not mention in the manual Date: Tue, 08 Nov 2022 13:35:07 -0800 Message-ID: <87tu39jfjo.fsf@ericabrahamsen.net> References: <874jv9wuve.fsf@thaodan.de> <87y1sljgas.fsf@ericabrahamsen.net> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="40122"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: bjorn.bidar@thaodan.de To: 59121@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Tue Nov 08 22:36:23 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1osWGd-000ADG-Kn for geb-bug-gnu-emacs@m.gmane-mx.org; Tue, 08 Nov 2022 22:36:23 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1osWGK-0006Vm-Fj; Tue, 08 Nov 2022 16:36:04 -0500 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1osWGI-0006VU-FA for bug-gnu-emacs@gnu.org; Tue, 08 Nov 2022 16:36:02 -0500 Original-Received: from debbugs.gnu.org ([209.51.188.43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1osWGI-0004uV-72 for bug-gnu-emacs@gnu.org; Tue, 08 Nov 2022 16:36:02 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1osWGH-00044S-Ro; Tue, 08 Nov 2022 16:36:01 -0500 X-Loop: help-debbugs@gnu.org Resent-From: Eric Abrahamsen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org, bugs@gnus.org Resent-Date: Tue, 08 Nov 2022 21:36:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 59121 X-GNU-PR-Package: emacs,gnus Original-Received: via spool by 59121-submit@debbugs.gnu.org id=B59121.166794331815602 (code B ref 59121); Tue, 08 Nov 2022 21:36:01 +0000 Original-Received: (at 59121) by debbugs.gnu.org; 8 Nov 2022 21:35:18 +0000 Original-Received: from localhost ([127.0.0.1]:38322 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1osWFa-00043a-De for submit@debbugs.gnu.org; Tue, 08 Nov 2022 16:35:18 -0500 Original-Received: from mail.ericabrahamsen.net ([52.70.2.18]:53354) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1osWFX-00043H-Iv for 59121@debbugs.gnu.org; Tue, 08 Nov 2022 16:35:16 -0500 Original-Received: from localhost (unknown [76.135.104.211]) (Authenticated sender: eric@ericabrahamsen.net) by mail.ericabrahamsen.net (Postfix) with ESMTPSA id AE4B2FA08F; Tue, 8 Nov 2022 21:35:08 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=ericabrahamsen.net; s=mail; t=1667943308; bh=faQP//Q933OSHJKmARQRgva5KHw57H6Uxezt6sc3VUw=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From; b=FFArQGGV5L+BQ51dx/1LnjiBNBKrc6nEemyM68zRG63AAorFE9sHDtxN2bC14CJUM Y3X0p4EIMc57HLY1v2Vi6xCllmS9Ga5WbTfLnAGDoQCa00bxoHWpywyDJDwB3pHE8E 0oq2X4vt/Y4uUoIgUltI238lE+c5JZ7dBtkYG98Q= In-Reply-To: <87y1sljgas.fsf@ericabrahamsen.net> (Eric Abrahamsen's message of "Tue, 08 Nov 2022 13:18:51 -0800") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.bugs:247364 Archived-At: --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Eric Abrahamsen writes: > Bj=C3=B6rn Bidar via "Bug reports for GNU Emacs, the Swiss army knife of = text > editors" writes: > >> Hey, >> >> While trying out how to search for emails in Gnus, I noticed that >> nnir.el is deprecated but the manual (gnu.org/software/emacs/manual) >> doesn't mention any of that. >> I think the manual should mention that. I think such changes should be >> documented right a way in general. > > Do you mean that you recently upgraded Emacs, and got a deprecation > warning for a nnir-* variable, but there's no information in the Gnus > manual about migrating away from nnir? > > That does seem like an oversight... Here's a potential documentation patch. Eric --=-=-= Content-Type: text/x-patch Content-Disposition: attachment; filename=gnusmanualnnir.diff diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 7bcf334297..578273aede 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi @@ -21900,14 +21900,13 @@ About mairix @uref{http://www.rpcurnow.force9.co.uk/mairix/index.html} Though mairix might not be as flexible as other search tools like -swish++ or namazu, which you can use via the @code{nnir} back end, it -has the prime advantage of being incredibly fast. On current systems, it -can easily search through headers and message bodies of thousands and -thousands of mails in well under a second. Building the database -necessary for searching might take a minute or two, but only has to be -done once fully. Afterwards, the updates are done incrementally and -therefore are really fast, too. Additionally, mairix is very easy to set -up. +swish++ or namazu, it has the prime advantage of being incredibly +fast. On current systems, it can easily search through headers and +message bodies of thousands and thousands of mails in well under a +second. Building the database necessary for searching might take a +minute or two, but only has to be done once fully. Afterwards, the +updates are done incrementally and therefore are really fast, too. +Additionally, mairix is very easy to set up. For maximum speed though, mairix should be used with mails stored in @code{Maildir} or @code{MH} format (this includes the @code{nnml} back @@ -22545,6 +22544,20 @@ nnmairix caveats @end itemize +@node nnir +@section Migrating from nnir + +@cindex nnir + +Gnus' previous search engine was called nnir, and is now obsolete. If +you've upgraded Emacs and are now getting obsolete-variable warnings +about @code{nnir-*} variables, migration is fairly straightforward. +In addition to the variables raised by the warnings, all previous +engine-specific variables can be updated by simply replacing the +@code{nnir-} prefix with @code{gnus-search-}. For instance, +@code{nnir-notmuch-program} is now @code{gnus-search-notmuch-program}. + + @iftex @iflatex @chapter Message --=-=-=--