"Session ends"?

"Session ends"?

[Eli Zaretskii]

> 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?

Re: "Session ends"?

[Po Lu]

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.

Re: "Session ends"?

[Eli Zaretskii]

> 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"?

Re: "Session ends"?

[Po Lu]

Eli Zaretskii <eliz@gnu.org> writes:

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

Yes, that does sound much better.  Thanks.