unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
* "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

* Re: "Session ends"?
  2022-03-16 13:41   ` Eli Zaretskii
@ 2022-03-16 13:46     ` Po Lu
  0 siblings, 0 replies; 4+ messages in thread
From: Po Lu @ 2022-03-16 13:46 UTC (permalink / raw)
  To: Eli Zaretskii; +Cc: emacs-devel

Eli Zaretskii <eliz@gnu.org> writes:

> How about "when the drag-and-drop operation ends"?

Yes, that does sound much better.  Thanks.



^ 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).