bug#30516: 26.0; `C-h k' for mouse click is now confusing and less useful

[Lars Ingebrigtsen]

Drew Adams <drew.adams@oracle.com> writes:

> A change for the worse seems to have been made to the help displayed
> by `C-h k' for a mouse click.
>
> Instead of clearly showing two separate help sections, one for the up
> event and one for the down event, what you see now is help for the up
> event followed immediately - with no separation, by this sentence:
>
>   For documentation of the corresponding mouse down
>   event <down-mouse-1>, click and hold the mouse button
>   longer than 0.5 second(s).

If I `C-h k mouse-1', I get the contents below, so I'm unable to
reproduce this.  Are you still seeing this on the trunk, or do you have
a different recipe for how to reproduce it?

---

There were several key-sequences:

  <down-mouse-1> at that spot runs the command mouse-drag-region
  <mouse-1> at that spot runs the command mouse-set-point

They're all described below.



<down-mouse-1> at that spot runs the command mouse-drag-region (found
in global-map), which is an interactive compiled Lisp function in
‘mouse.el’.

It is bound to <down-mouse-1>.

(mouse-drag-region START-EVENT)

Set the region to the text that the mouse is dragged over.
Highlight the drag area as you move the mouse.
This must be bound to a button-down mouse event.
In Transient Mark mode, the highlighting remains as long as the mark
remains active.  Otherwise, it remains until the next input event.

When the region already exists and ‘mouse-drag-and-drop-region’
is non-nil, this moves the entire region of text to where mouse
is dragged over to.



<mouse-1> at that spot runs the command mouse-set-point (found in
global-map), which is an interactive compiled Lisp function in
‘mouse.el’.

It is bound to <mouse-1>.

(mouse-set-point EVENT &optional PROMOTE-TO-REGION)

  Probably introduced at or before Emacs version 22.1.

Move point to the position clicked on with the mouse.
This should be bound to a mouse click event type.
If PROMOTE-TO-REGION is non-nil and event is a multiple-click, select
the corresponding element around point, with the resulting position of
point determined by ‘mouse-select-region-move-to-beginning’.

[back]


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