From: Po Lu <luangruo@yahoo.com>
Date: Thu, 7 Apr 2022 00:57:25 +0000 (+0800)
Subject: Improve doc of x-begin-drag
X-Git-Tag: emacs-29.0.90~1931^2~732
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=33055c26088ee72bcca0497d1f931fabda28289a;p=emacs.git

Improve doc of x-begin-drag

* doc/lispref/frames.texi (Drag and Drop): Fix typos and clarify
meaning of XdndActionPrivate.
---

diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 85f92d4f629..05c6e4b719b 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -4079,19 +4079,20 @@ If @var{return-frame} is non-@code{nil} and the mouse moves over an
 Emacs frame after first moving out of @var{frame}, then the frame to
 which the mouse moves will be returned immediately.  If
 @var{return-frame} is the symbol @code{now}, then any frame underneath
-the mouse pointer will be returned and no further work will be done.
-@var{return-frame} useful when you want to treat dragging content from
-one frame to another specially, while also being able to drag content
-to other programs, but it is not guaranteed to work on all systems and
-window managers.
+the mouse pointer will be returned without waiting for the mouse to
+first move out of @var{frame}.  @var{return-frame} is useful when you
+want to treat dragging content from one frame to another specially,
+while also being able to drag content to other programs, but it is not
+guaranteed to work on all systems and with all window managers.
 
 If the drop was rejected or no drop target was found, this function
 returns @code{nil}.  Otherwise, it returns a symbol describing the
 action the target chose to perform, which can differ from @var{action}
 if that isn't supported by the drop target.  @code{XdndActionPrivate}
 is also a valid return value in addition to @code{XdndActionCopy} and
-@code{XdndActionMove}, and means that the drop target chose to perform
-an unspecified action.
+@code{XdndActionMove}; it means that the drop target chose to perform
+an unspecified action, and no further processing is required by the
+caller.
 @end defun
 
 @node Color Names