Subject: Re: bug#49587: Where are links in describe-symbol minor-mode?

From: Lars Ingebrigtsen <[email-masked]>
Date: Sat, 16 Jul 2022 14:59:59 +0200

Juri Linkov <[email-masked]> writes:

> Try to use 'C-h o' on the symbol of a minor mode defined by 'define-minor-mode'.
>
> There are many such symbols, for example:
>
>   C-h o dired-hide-details-mode
>
> displays the Help buffer where text:
>
>   See options: ‘dired-hide-details-hide-symlink-targets’ and
>   ‘dired-hide-details-hide-information-lines’.
>
> has no links in the first part of the buffer that describes the function,
> but there are links only in the second part that describes the variable.

I've now fixed this in Emacs 29.

> Also such text in the output of 'C-h o' looks clumsy:
>
>   This is a minor mode.  If called interactively, toggle the
>   ‘Dired-Hide-Details mode’ mode.

Well, it looks pretty clumsy `C-h f', too.

> Another problem is that with 'C-h o' the same Help buffer is displayed twice
> that breaks some window-displaying commands.

I'm not sure what can be done about that -- the `C-h o' function
basically just calls `C-h f' and `C-h v'.  But what setups do they break
in practice?

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no