bug#30491: 26.0; (elisp) `Profiling'

[Drew Adams]

> I was confused here by reading the help for `C-h k'
> for the `mouse-1' click.  At the end of that help I
> read this:
> 
>   For documentation of the corresponding mouse down
>   event <down-mouse-1>, click and hold the mouse button
>   longer than 0.5 second(s).
> 
> I was misreading that as applying to the command whose
> doc I was reading: `profiler-report-toggle-entry'.
> 
> Instead, that sentence is about the key action I used
> at the prompt of `C-h k'.
> 
> I think this help text is unclear.  99% of the text
> is about a COMMAND - the command bound to the mouse
> up event.  And then, with no separation at all, we
> read a sentence that is suddenly about the second
> event you caused in response to the `C-h k' prompt'.
> 
> This is awful (IMHO).  At the very least, that
> sentence should be set off with a clear separator
> (e.g. horizontal line or C-l char), and it should
> be in parentheses.
> 
> Some better help design is needed for this, in any
> case.  I'm sure I won't be the last user to fall
> prey to this design gotcha.

I've submitted bug #30516 for this.