procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Improve DND documentation

Browse source 
* doc/lispref/frames.texi (Drag and Drop):
* src/xfns.c (Fx_begin_drag): Document that x-begin-drag may
return immediately if no mouse buttons are held down.
This commit is contained in:
Po Lu 2022-05-28 09:03:29 +08:00
parent 5c07aed894
commit 3c5fbfe4ac
2 changed files with 9 additions and 2 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

4
doc/lispref/frames.texi
View file

@ -4067,7 +4067,9 @@ drag-and-drop operation ends, either because the drop was successful,
or because the drop was rejected. The drop occurs when all mouse
buttons are released on top of an X window other than @var{frame} (the
@dfn{drop target}), or any X window if @var{allow-current-frame} is
non-@code{nil}.
non-@code{nil}. If no mouse buttons are held down when the
drag-and-drop operation begins, this function may immediately return
@code{nil}.
@var{targets} is a list of strings describing selection targets, much
like the @var{data-type} argument to @code{gui-get-selection}, that

7
src/xfns.c
View file

@ -6827,7 +6827,12 @@ instead.
If ALLOW-CURRENT-FRAME is not specified or nil, then the drop target
is allowed to be FRAME. Otherwise, no action will be taken if the
mouse buttons are released on top of FRAME. */)
mouse buttons are released on top of FRAME.
This function will sometimes return immediately if no mouse buttons
are currently held down, and should only be called in situations where
it is known that some are being held down down, such as immediately
after a `down-mouse-1' event. */)
(Lisp_Object targets, Lisp_Object action, Lisp_Object frame,
Lisp_Object return_frame, Lisp_Object allow_current_frame)
{