Re: "What's This?" in Describe submenu

[Stefan Monnier]

> Now, I agree that what we say sounds not very clear (to say the least)
> to a newbie, but I think we do mean to target newbies as well, and
> that therefore we should work on making the doc string more
> newbie-friendly.  But I'm repeating myself...

I've several times hesitated when writing a docstring: should it document
the function or the command.
The more typical problem is whether to refer to ARG, BEG, END or to
\\[universal-argument], and the region.
Maybe we should make i possible to provide two separate docstrings, one for
the function and one for the command.


        Stefan