From dfe73d8ebc42737d9e8109fc51c59d82c86f0939 Mon Sep 17 00:00:00 2001
From: ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>
Date: Sun, 3 Aug 2025 09:47:58 +0200
Subject: Document that the Wayland platform doesn't send FL_HIDE to minimized
 windows.

---
 FL/Enumerations.H            |  4 +++-
 documentation/src/events.dox | 10 +---------
 2 files changed, 4 insertions(+), 10 deletions(-)

diff --git a/FL/Enumerations.H b/FL/Enumerations.H
index 6674e7463..032717f1b 100644
--- a/FL/Enumerations.H
+++ b/FL/Enumerations.H
@@ -256,7 +256,9 @@ enum Fl_Event { // events
 
   /** This widget is no longer visible, due to Fl_Widget::hide() being
       called on it or one of its parents, or due to a parent window being
-      minimized.  Fl_Widget::visible() may still be true after this, but the
+      minimized (under Wayland, minimized toplevel windows don't receive
+      the FL_HIDE event).
+      Fl_Widget::visible() may still be true after this, but the
       widget is visible only if visible() is true for it and all its
       parents (use Fl_Widget::visible_r() to check this).
    */
diff --git a/documentation/src/events.dox b/documentation/src/events.dox
index 765e0720d..af0b381dc 100644
--- a/documentation/src/events.dox
+++ b/documentation/src/events.dox
@@ -301,15 +301,7 @@ This widget is no longer visible, due to
 \ref Fl_Widget::hide() "hide()"
 being called on it or one of its parents, or due to a parent window
 being minimized.
-Please note that although
-\ref Fl_Widget::visible() "visible()"
-may still return true for this widget after receiving this event,
-it is only truly visible if
-\ref Fl_Widget::visible() "visible()"
-is true for both it and all of its parents.
-(You can use
-\ref Fl_Widget::visible_r() "visible_r()"
-to check this).
+\see FL_HIDE
 
 \subsection events_fl_show FL_SHOW
 
-- 
cgit v1.2.3