Re: master 11f44ec6dda: Enable DND handlers to receive more than one URI at a time

[Visuwesh <visuweshm@gmail.com>]

[வியாழன் அக்டோபர் 26, 2023] Po Lu via Mailing list for Emacs changes wrote:

Thank you for working on this.

> @@ -4740,9 +4740,14 @@ This variable is an alist between regexps against which URLs are
>  matched and DND handler functions called on the dropping of matching
>  URLs.
>  
> -Each handler function is called with the URL that matched it and one
> -of the symbols @code{copy}, @code{move}, @code{link}, @code{private}
> -or @code{ask} identifying the action to be taken.
> +@cindex dnd-multiple-handler, a symbol property
> +If a handler function is a symbol whose @code{dnd-multiple-handler}
> +property (@pxref{Symbol Properties}) is set, then upon a drop it is
> +given a list of every URL that matches its regexp; absent this
> +property, it is called once for each of those URLs.  Following this
> +first argument is one of the symbols @code{copy}, @code{move},
> +@code{link}, @code{private} or @code{ask} identifying the action to be
> +taken.

I find the new text is quite hard to understand, how about saying

    Each handler function is called with the URL that matched it and one
    of the symbols @code{copy}, @code{move}, @code{link}, @code{private}
    or @code{ask} identifying the action to be taken.

    @cindex dnd-multiple-handler, a symbol property
    If the handler function is a symbol whose property
    @code{dnd-multiple-handler} is non-@code{nil} (@pxref{Symbol
    Properties}), then it is given a list of every URL that matches its
    regexp as the first argument instead.

?