Subject: bug#59600: 28.1.90; Docstrings generated by `define-globalized-minor-mode' and `define-minor-mode' :global t are not same

From: Eli Zaretskii <[email-masked]>
Date: Sat, 26 Nov 2022 19:46:34 +0200

> From: Stefan Monnier <[email-masked]>
> Cc: Ihor Radchenko <[email-masked]>,  [email-masked]
> Date: Sat, 26 Nov 2022 12:38:33 -0500
> 
> [ Nitpick: "define-minor-mode :global t" does not (usually) define
>   a "globalized mode" but rather it defines a "global mode".  ]
> 
> >> For example, `auto-save-visited-mode' is a global minor mode, but no
> >> clear indication of this fact is given. It did cause confusion for some
> >> users.
> >> 
> >> Expected: :global t clearly indicates that the mode is global.
> >
> > Adding Stefan to the discussion.
> 
> Not much to say, but I agree it makes sense for the docstring to state
> the scope of the mode (global, buffer-local, younameit).

Patches to the macro that defines the modes are welcome.