bug#34749: 26.1; `delete-windows-on': (1) doc, (2) bug, (3) bug, (4) candidates

[martin rudalics]

>>   > It seems like the interactive behavior is not correct, as well as being
>>   > poorly documented.  It's hard to know just what behavior was intended,
>>   > or what behavior would be best if (as it seems) we still need to design
>>   > this.
>>
>> If anyone has any ideas, we should implement that.  Suggestions highly
>> welcome.
>
> I don't understand what you are asking about.

About "what behavior would be best if (as it seems) we still need to
design this".  I don't use this function so I don't have any ideas
about what behavior would be best.

> It sounds like Drew has
> pointed out some inconsistencies between the doc string and the actual
> behavior, and we should first fix those inconsistencies for the
> release branch, probably by fixing the doc string.
>
> Why is Emacs behaving unlike the doc string says?

I think because this function has to work in some ad hoc manner, for
example, when a window is not dedicated and alone on its frame.  The
initial claim "Delete all windows showing BUFFER-OR-NAME." is simply
wrong in this regard.  Maybe we should say "Try to delete all windows
showing BUFFER-OR-NAME." instead.

But I'm not keen rewriting this doc-string because I never documented
the behavior of the prefix argument as Drew requested.  I simply don't
understand how that works.

martin