GNU bug report logs - #30491
26.0; (elisp) `Profiling'

Previous Next

Full log

Message #32 received at 30491 <at> debbugs.gnu.org (full text, mbox):

From: Drew Adams <drew.adams <at> oracle.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 30491 <at> debbugs.gnu.org
Subject: RE: bug#30491: 26.0; (elisp) `Profiling'
Date: Sun, 18 Feb 2018 09:21:04 -0800 (PST)

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

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.