unofficial mirror of bug-gnu-emacs@gnu.org 
 help / color / mirror / code / Atom feed
* bug#50415: 27.2; gnus-group-default-list-level documentation wrong
@ 2021-09-05 23:34 Allen Li
  2021-09-06  9:12 ` bug#50415: bug#50414: " Lars Ingebrigtsen
  0 siblings, 1 reply; 2+ messages in thread
From: Allen Li @ 2021-09-05 23:34 UTC (permalink / raw)
  To: 50415

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





^ permalink raw reply	[flat|nested] 2+ messages in thread

* bug#50415: bug#50414: 27.2; gnus-group-default-list-level documentation wrong
  2021-09-05 23:34 bug#50415: 27.2; gnus-group-default-list-level documentation wrong Allen Li
@ 2021-09-06  9:12 ` Lars Ingebrigtsen
  0 siblings, 0 replies; 2+ messages in thread
From: Lars Ingebrigtsen @ 2021-09-06  9:12 UTC (permalink / raw)
  To: Allen Li; +Cc: 50415, 50414

Allen Li <darkfeline@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





^ permalink raw reply	[flat|nested] 2+ messages in thread

end of thread, other threads:[~2021-09-06  9:12 UTC | newest]

Thread overview: 2+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-09-05 23:34 bug#50415: 27.2; gnus-group-default-list-level documentation wrong Allen Li
2021-09-06  9:12 ` bug#50415: bug#50414: " Lars Ingebrigtsen

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).