Subject: Re: bug#54967: 28.1; outline-minor-mode-cycle-filter docstring is awkward

From: Eli Zaretskii <[email-masked]>
Date: Sat, 16 Apr 2022 10:57:41 +0300

> From: Howard Melman <[email-masked]>
> Date: Fri, 15 Apr 2022 20:04:40 -0400
> 
> The docstring of outline-minor-mode-cycle-filter says it
> filters out positions available for cycling.  But the
> options the user has (via customize) describe the places on
> the heading that will remain for cycling.
> 
> (defcustom outline-minor-mode-cycle-filter nil
>   "Filter out positions on the heading available for cycling."
>   :type '(choice (const :tag "Everywhere" nil)
>                  (const :tag "At line beginning" bolp)
>                  (const :tag "Not at line beginning"
>                         (lambda () (not (bolp))))
>                  (const :tag "At line end" eolp)
>                  (function :tag "Custom filter"))
>   :version "28.1")
> 
> E.g., if I choose "At line beginning" then cycling works if
> point is at the beginning of line.  But the doc sounds to
> me like it shouldn't work at that location.

Thanks, I fixed the doc string of this option (and some other related
ones) for Emacs 28.2.