bug#52007: 26.3; Doc of `define-globalized-minor-mode' and global(ized) minor modes

[Drew Adams]

It's even worse than I thought.

The first line of the doc string of the globalized
version of minor mode `foo-mode' (`global-foo-mode')
says that it toggles `foo-mode' everywhere:

  Toggle Foo mode in all buffers.

It doesn't do that at all.  Instead, it toggles
`global-foo-mode'.  BIG difference.  If `foo-mode'
is ON in buffer B1 and OFF in buffer B2, then
toggling `foo-mode' everywhere would result in
`foo-mode' being OFF in B1 and ON in B2.

What instead happens is that if the global mode was
OFF then `global-foo-mode' is turned ON, which turns
ON `foo-mode' in all buffers.  And if the global
mode was ON then it is turned OFF, which turns OFF
`foo-mode' in all buffers.

We don't seem to have a command that toggles a minor
mode in all buffers, that is, flips its state ON/OFF.