master e98b7d6ba2: Improve documentation for t value for reusable-frames

[Lars Ingebrigtsen]

branch: master
commit e98b7d6ba2c8634c82f49ee18fd8b91b1b83a187
Author: Lars Ingebrigtsen <larsi@gnus.org>
Commit: Lars Ingebrigtsen <larsi@gnus.org>

    Improve documentation for t value for reusable-frames
    
    * doc/lispref/windows.texi (Buffer Display Action Alists): Note
    that the t value is rarely a good one (bug#55103).
---
 doc/lispref/windows.texi | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index abc8adae83..0b3fa0c8b5 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -2966,13 +2966,14 @@ follows:
 @code{nil} means consider only windows on the selected frame.
 (Actually, the last frame used that is not a minibuffer-only frame.)
 @item
-@code{t} means consider windows on all frames.
-@item
 @code{visible} means consider windows on all visible frames.
 @item
 0 means consider windows on all visible or iconified frames.
 @item
 A frame means consider windows on that frame only.
+@item
+@code{t} means consider windows on all frames.  (Note that this value
+is rarely the right thing to use---it might also return a tooltip frame.)
 @end itemize
 
 Note that the meaning of @code{nil} differs slightly from that of the