* "Session ends"?
@ 2022-03-16 12:47 Eli Zaretskii
2022-03-16 13:27 ` Po Lu
0 siblings, 1 reply; 4+ messages in thread
From: Eli Zaretskii @ 2022-03-16 12:47 UTC (permalink / raw)
To: Po Lu; +Cc: emacs-devel
> diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
> index bae8eb3..38897d6 100644
> --- a/doc/lispref/frames.texi
> +++ b/doc/lispref/frames.texi
> @@ -4038,6 +4038,35 @@ Drag and Drop
> still no match has been found, the text for the URL is inserted. If
> you want to alter Emacs behavior, you can customize these variables.
>
> +@cindex initiating drag-and-drop
> + On some window systems, Emacs also supports dragging contents from
> +itself to other frames.
> +
> +@defun x-begin-drag targets action &optional frame
> +This function begins a drag from @var{frame}, and returns when the
> +session ends, either because the drop was successful, or because the
^^^^^^^^^^^^
"When the session ends"? You mean, this function will not return
until I kill Emacs? Or what "session" is alluded to here?
^ permalink raw reply [flat|nested] 4+ messages in thread* Re: "Session ends"?
2022-03-16 12:47 "Session ends"? Eli Zaretskii
@ 2022-03-16 13:27 ` Po Lu
2022-03-16 13:41 ` Eli Zaretskii
0 siblings, 1 reply; 4+ messages in thread
From: Po Lu @ 2022-03-16 13:27 UTC (permalink / raw)
To: Eli Zaretskii; +Cc: emacs-devel
Eli Zaretskii <eliz@gnu.org> writes:
>> diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
>> index bae8eb3..38897d6 100644
>> --- a/doc/lispref/frames.texi
>> +++ b/doc/lispref/frames.texi
>> @@ -4038,6 +4038,35 @@ Drag and Drop
>> still no match has been found, the text for the URL is inserted. If
>> you want to alter Emacs behavior, you can customize these variables.
>>
>> +@cindex initiating drag-and-drop
>> + On some window systems, Emacs also supports dragging contents from
>> +itself to other frames.
>> +
>> +@defun x-begin-drag targets action &optional frame
>> +This function begins a drag from @var{frame}, and returns when the
>> +session ends, either because the drop was successful, or because the
> ^^^^^^^^^^^^
>
> "When the session ends"? You mean, this function will not return
> until I kill Emacs? Or what "session" is alluded to here?
It's supposed to explain what a "drag session" is: something that starts
when a drag starts, and ends when when the drop is successful or when it
was rejected by the drop target.
Is there any way to word that better?
Thanks.
^ permalink raw reply [flat|nested] 4+ messages in thread* Re: "Session ends"?
2022-03-16 13:27 ` Po Lu
@ 2022-03-16 13:41 ` Eli Zaretskii
2022-03-16 13:46 ` Po Lu
0 siblings, 1 reply; 4+ messages in thread
From: Eli Zaretskii @ 2022-03-16 13:41 UTC (permalink / raw)
To: Po Lu; +Cc: emacs-devel
> From: Po Lu <luangruo@yahoo.com>
> Cc: emacs-devel@gnu.org
> Date: Wed, 16 Mar 2022 21:27:29 +0800
>
> >> +@defun x-begin-drag targets action &optional frame
> >> +This function begins a drag from @var{frame}, and returns when the
> >> +session ends, either because the drop was successful, or because the
> > ^^^^^^^^^^^^
> >
> > "When the session ends"? You mean, this function will not return
> > until I kill Emacs? Or what "session" is alluded to here?
>
> It's supposed to explain what a "drag session" is: something that starts
> when a drag starts, and ends when when the drop is successful or when it
> was rejected by the drop target.
>
> Is there any way to word that better?
How about "when the drag-and-drop operation ends"?
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2022-03-16 13:46 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2022-03-16 12:47 "Session ends"? Eli Zaretskii
2022-03-16 13:27 ` Po Lu
2022-03-16 13:41 ` Eli Zaretskii
2022-03-16 13:46 ` Po Lu
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).