From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: =?UTF-8?Q?Bj=C3=B6rn?= Bidar via "Bug reports for GNU Emacs, the Swiss army knife of text editors" Newsgroups: gmane.emacs.bugs Subject: bug#59121: 29.0.50; Gnus: Nnir is deprecated but not mention in the manual Date: Wed, 09 Nov 2022 07:42:40 +0200 Message-ID: <87wn84vg33.fsf@thaodan.de> References: <874jv9wuve.fsf@thaodan.de> <87y1sljgas.fsf@ericabrahamsen.net> <87tu39jfjo.fsf@ericabrahamsen.net> Reply-To: =?UTF-8?Q?Bj=C3=B6rn?= Bidar Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="29949"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 59121@debbugs.gnu.org To: Eric Abrahamsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Wed Nov 09 06:43:36 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 1osds6-0007bs-PI for geb-bug-gnu-emacs@m.gmane-mx.org; Wed, 09 Nov 2022 06:43:34 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1osdrd-0000Rm-Qs; Wed, 09 Nov 2022 00:43:07 -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 1osdrc-0000R9-7B for bug-gnu-emacs@gnu.org; Wed, 09 Nov 2022 00:43:04 -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 1osdrb-0001Kb-Ug for bug-gnu-emacs@gnu.org; Wed, 09 Nov 2022 00:43:03 -0500 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1osdra-0007KL-Em; Wed, 09 Nov 2022 00:43:02 -0500 X-Loop: help-debbugs@gnu.org Resent-From: =?UTF-8?Q?Bj=C3=B6rn?= Bidar Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org, bugs@gnus.org Resent-Date: Wed, 09 Nov 2022 05:43:02 +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.166797256528143 (code B ref 59121); Wed, 09 Nov 2022 05:43:02 +0000 Original-Received: (at 59121) by debbugs.gnu.org; 9 Nov 2022 05:42:45 +0000 Original-Received: from localhost ([127.0.0.1]:38739 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1osdrI-0007Jq-Gm for submit@debbugs.gnu.org; Wed, 09 Nov 2022 00:42:44 -0500 Original-Received: from thaodan.de ([185.216.177.71]:51070) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1osdrG-0007Jh-33 for 59121@debbugs.gnu.org; Wed, 09 Nov 2022 00:42:43 -0500 Original-Received: from odin (dsl-trebng12-b04885-76.dhcp.inet.fi [176.72.133.76]) by thaodan.de (Postfix) with ESMTPSA id F02BED08A97; Wed, 9 Nov 2022 07:42:40 +0200 (EET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=thaodan.de; s=mail; t=1667972561; bh=3Ti5ly/7xjAw4P4xZm6CkUNlAy29XFx9xz2yBD5Csl8=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=cN89vxqQi2B3fEMKHSB64BiELWftVLjjKOHRRuVVV7+pNcRvyMrVPixVGU8Dof5g2 wVMxhZr1TWIwVjle8EHC5FXo1SISRJgmKY4L07/okrCIkQ6UzgcciFhal2qnCw/7g0 DYWjU/SyO2DSzuu6/qtb/xmyCLcKN5LqtC/L/hR8Tu3bKIxvZ5E5BAiRRFPBa1GgJR XVFoYUMYl+vQCwE85lnKCMx3lRdDzGU2CfFTa7v90XyIic0CFz5udlvd6Yox2Td7hj aTcUmv1qkKcMv8NvZft6ASK+JlJJP+wXIwb726EKgssQSn5I4zShhAJcAYVEWair2x 2jc3wgQ66qlTrfRyaTnidDQXSb16FfcrxVwgjx+uDMzfHXgFdMv8z3va2gSsxujpi+ aGs+YMC0kWuPSOun/mTnc15x/UHlR8lE5DTglInpd0BxOlREvvKrW8UnENbb68Qf6J x56dOrmbY4vLCjhhpzryAEkgS1d30COyxVMRGX/PWW8PoYiRgFFwb6gRipv1EXWlko cG9Xg73rcz6W67xuzP0nvwKLW3xh8GYPTPt9EpoE/s6x8Hohf59uw9IAhvUbx45pJP 0NGF0M7QEFvINib7Kj/f4AWjk4Py3WdSo6kF5zqXnYw9EptXSIjJC5x4ElErayLU3g +gaavP6wk4vWFs9vEd5KDZQY= In-Reply-To: <87tu39jfjo.fsf@ericabrahamsen.net> (Eric Abrahamsen's message of "Tue, 08 Nov 2022 13:35:07 -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:247381 Archived-At: Eric Abrahamsen writes: > Eric Abrahamsen writes: >>> 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. > 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} >=20=20 > 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 >=20=20 What about remote searches such as IMAP? In any case since the search isn't asynchronous there's the caveat of Gnus locking up Emacs until it is done. This kinda goes out of the original topic but the manual doesn't mention much what can used to reduce the download when IMAP is used (caching etc.). > +@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}. The section should mention the exact version it was deprecated, instead of now it should be "and is deprecated since ". Something like a separate section about deprecated items could also be very useful. Some guide around the internet set variables which are no longer valid, if there is a section for each item deprecated with an explanation it could help greatly. Br, Bj=C3=B6rn