bug#70949: display-buffer-choose-some-window

[martin rudalics]

> +    `display-buffer-use-some-window' should choose.  The possible choices
> +    are `lru' or nil (the default) to select the least recently used window,
> +    and `mru' to select the most recently used window .  When a function, it

I'd say "It can also be a function that takes two arguments ..."

> +    takes two arguments: a buffer and an alist, and should return the window
> +    where to display the buffer.  When the value is `lru', it avoids
> +    selecting windows that are not full-width and windows on another frame.
> +    When the value is `mru', it avoids selecting an already selected window
> +    and windows on another frame.

I'd say "..., it does not consider the selected window and windows on
any frame but the selected one."

But the more important thing is to tell users how this can help to fix
problems like the one that triggered this thread.  A short description
in the doc-string and a more elaborated one with an example in the Elisp
manual in the description of 'display-buffer-use-some-window' and in the
"Action Alists for Buffer Display" section.

martin