\\{foo-mode-map}

[Lars Ingebrigtsen]

`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.

I think it might be a good idea to change `C-h m' so that it always
outputs the major mode map.  That is, if the doc string already does so,
it shouldn't output it again, but if the doc string doesn't, then output
the major mode map after the doc string.

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

Any opinions?

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