Re: \\{foo-mode-map}

[Stefan Monnier]

> `C-h m' displays the doc string of the current major mode.  It does not
> output the mode map -- unless the programmer has put \\{foo-mode-map}
> into the doc string.  Many modes do not, which means that the user has
> to rely on `C-h b' to try to find out what the available commands are.
> Which isn't optimal.

IIRC `define-derived-mode` adds that `\\{foo-mode-map}` thingy unless
there are already some `\\[...]` in the docstring.

> And then we could stop encouraging that these doc strings include
> \\{foo-mode-map}.

We definitely don't need to do that (better encourage the use of
`define-derived-mode` instead).


        Stefan