GNU bug report logs - #50415
27.2; gnus-group-default-list-level documentation wrong

Previous Next

Packages: gnus, emacs;

Reported by: Allen Li <darkfeline <at> felesatra.moe>

Date: Sun, 5 Sep 2021 23:35:02 UTC

Severity: normal

Merged with 50414

Found in version 27.2

Fixed in version 28.1

Done: Lars Ingebrigtsen <larsi <at> gnus.org>

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 50415 in the body.
You can then email your comments to 50415 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org, bugs <at> gnus.org:
bug#50415; Package emacs,gnus. (Sun, 05 Sep 2021 23:35:02 GMT) Full text and rfc822 format available.
Acknowledgement sent to Allen Li <darkfeline <at> felesatra.moe>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org, bugs <at> gnus.org. (Sun, 05 Sep 2021 23:35:02 GMT) Full text and rfc822 format available.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: Allen Li <darkfeline <at> felesatra.moe>
To: bug-gnu-emacs <at> gnu.org
Subject: 27.2; gnus-group-default-list-level documentation wrong
Date: Sun, 05 Sep 2021 16:34:50 -0700

The documentation for gnus-group-default-list-level states:

  Default listing level.
  Ignored if ‘gnus-group-use-permanent-levels’ is non-nil.

This does not appear to be entirely true:

  (defun gnus-group-default-level (&optional level number-or-nil)
    (cond
     (gnus-group-use-permanent-levels
      (or (setq gnus-group-use-permanent-levels
                (or level (if (numberp gnus-group-use-permanent-levels)
                              gnus-group-use-permanent-levels
                            (or (gnus-group-default-list-level)
                                gnus-level-subscribed))))
          (gnus-group-default-list-level) gnus-level-subscribed))
     (number-or-nil
      level)
     (t
      (or level (gnus-group-default-list-level) gnus-level-subscribed))))

When gnus-group-use-permanent-levels is first set (to t via customize), the default
level still depends on gnus-group-default-list-level.  After that
however, the level will indeed be based off of
gnus-group-use-permanent-levels which will be set to a number.

Might I suggest:

  Default listing level.
  When ‘gnus-group-use-permanent-levels’ is non-nil, this level is
  used as the starting level until the user sets a different level.

In GNU Emacs 27.2 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.27, cairo version 1.17.4)
 of 2021-03-26 built on juergen
Windowing system distributor 'The X.Org Foundation', version 11.0.12013000
System Description: Arch Linux
Merged 50414 50415. Request was from Allen Li <darkfeline <at> felesatra.moe> to control <at> debbugs.gnu.org. (Mon, 06 Sep 2021 00:25:01 GMT) Full text and rfc822 format available.
Information forwarded to bug-gnu-emacs <at> gnu.org, bugs <at> gnus.org:
bug#50415; Package emacs,gnus. (Mon, 06 Sep 2021 09:13:02 GMT) Full text and rfc822 format available.

Message #10 received at 50415 <at> debbugs.gnu.org (full text, mbox):

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Allen Li <darkfeline <at> felesatra.moe>
Cc: 50415 <at> debbugs.gnu.org, 50414 <at> debbugs.gnu.org
Subject: Re: bug#50414: 27.2; gnus-group-default-list-level documentation wrong
Date: Mon, 06 Sep 2021 11:12:23 +0200

Allen Li <darkfeline <at> felesatra.moe> writes:

> Might I suggest:
>
>   Default listing level.
>   When ‘gnus-group-use-permanent-levels’ is non-nil, this level is
>   used as the starting level until the user sets a different level.

I've now changed it to something along these lines in Emacs 28.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no
bug marked as fixed in version 28.1, send any further explanations to 50414 <at> debbugs.gnu.org and Allen Li <darkfeline <at> felesatra.moe> Request was from Lars Ingebrigtsen <larsi <at> gnus.org> to control <at> debbugs.gnu.org. (Mon, 06 Sep 2021 09:13:02 GMT) Full text and rfc822 format available.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Mon, 04 Oct 2021 11:24:06 GMT) Full text and rfc822 format available.
This bug report was last modified 2 years and 197 days ago.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.