[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
master f1ae3c944a6: ; Minor copyedits in the drag-and-drop docs
From: |
Stefan Kangas |
Subject: |
master f1ae3c944a6: ; Minor copyedits in the drag-and-drop docs |
Date: |
Tue, 24 Oct 2023 06:22:07 -0400 (EDT) |
branch: master
commit f1ae3c944a6cb6e268c6e95fc20988322ed1dc11
Author: Stefan Kangas <stefankangas@gmail.com>
Commit: Stefan Kangas <stefankangas@gmail.com>
; Minor copyedits in the drag-and-drop docs
* doc/lispref/frames.texi (Drag and Drop): Copyedits, mostly to use
simpler and more direct language.
---
doc/lispref/frames.texi | 20 ++++++++++----------
1 file changed, 10 insertions(+), 10 deletions(-)
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index 56e4fe419e3..fb19317cedf 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -4886,30 +4886,30 @@ default directory.)
@cindex initiating drag-and-drop
It is also possible to drag content from Emacs to other programs
-whenever this is supported for the current window-system. The
-functions which provide for this are as follows:
+when this is supported by the current window-system. The functions
+which provide for this are as follows:
@cindex drop target, in drag-and-drop operations
@defun dnd-begin-text-drag text &optional frame action allow-same-frame
-This function commences a drag-and-drop operation from @var{frame} to
+This function starts a drag-and-drop operation from @var{frame} to
another program (dubbed the @dfn{drop target}), and returns when
@var{text} is dropped or the operation is canceled.
@var{action} must be one of the symbols @code{copy} or @code{move},
where @code{copy} means that @var{text} should be inserted by the drop
-target, and @code{move} means the same as @code{copy}, but furthermore
-enjoins the caller to delete @var{text} from its source as explained
-in the list below.
+target, and @code{move} means the same as @code{copy}, but the caller
+must also delete @var{text} from its source as explained in the list
+below.
@var{frame} is the frame where the mouse is currently held down, or
@code{nil}, which means to use the selected frame. Since this
-function is liable to return promptly if no mouse buttons are held
-down, it should be only called in response to a @code{down-mouse-1} or
+function might return promptly if no mouse buttons are held down, it
+should be only called in response to a @code{down-mouse-1} or
analogous event (@pxref{Mouse Events}), with @var{frame} set to the
frame where that event was generated (@pxref{Click Events}).
If @var{allow-same-frame} is @code{nil}, drops on top of @var{frame}
-will be disregarded.
+will be ignored.
The return value reflects the action that the drop target actually
performed, and thus also what action, if any, the caller should in
@@ -4934,7 +4934,7 @@ The drag-and-drop operation was canceled.
@end defun
@defun dnd-begin-file-drag file &optional frame action allow-same-frame
-This function commences a drag-and-drop operation from @var{frame} to
+This function starts a drag-and-drop operation from @var{frame} to
another program (dubbed the @dfn{drop target}), and returns when
@var{file} is dropped or the operation is canceled.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- master f1ae3c944a6: ; Minor copyedits in the drag-and-drop docs,
Stefan Kangas <=