Subject: Where are links in describe-symbol minor-mode?

From: Juri Linkov <[email-masked]>
Date: Fri, 16 Jul 2021 01:17:57 +0300

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.

There is no such problem when a function and a variable are described separately:

  C-h f dired-hide-details-mode
  C-h v dired-hide-details-mode

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.

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