1
0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-12-11 09:20:51 +00:00

Improve documentation on what callers of `x-begin-drag' should do

* doc/lispref/frames.texi (Drag and Drop):
* src/xfns.c (Fx_begin_drag): Improve documentation of how the
chosen action should be performed.
This commit is contained in:
Po Lu 2022-05-28 10:30:45 +08:00
parent b52f36a33d
commit 79ae40c8e4
2 changed files with 11 additions and 2 deletions

View File

@ -4106,6 +4106,10 @@ is also a valid return value in addition to @code{XdndActionCopy} and
@code{XdndActionMove}; it means that the drop target chose to perform
an unspecified action, and no further processing is required by the
caller.
The caller must cooperate with the target to fully perform the action
chosen by the target. For example, callers should delete the buffer
text that was dragged if this function returns @code{XdndActionMove}.
@end defun
@node Color Names

View File

@ -6792,8 +6792,9 @@ buttons are released, then return the action chosen by the target, or
starts when the mouse is pressed on FRAME, and the contents of the
selection `XdndSelection' will be sent to the X window underneath the
mouse pointer (the drop target) when the mouse button is released.
ACTION is a symbol which tells the target what the source will do, and
can be one of the following:
ACTION is a symbol which tells the target what it should do, and can
be one of the following:
- `XdndActionCopy', which means to copy the contents from the drag
source (FRAME) to the drop target.
@ -6805,6 +6806,10 @@ can be one of the following:
`XdndActionPrivate' is also a valid return value, and means that the
drop target chose to perform an unspecified or unknown action.
The source is also expected to cooperate with the target to perform
the action chosen by the target. For example, callers should delete
the buffer text that was dragged if `XdndActionMove' is returned.
There are also some other valid values of ACTION that depend on
details of both the drop target's implementation details and that of
Emacs. For that reason, they are not mentioned here. Consult