From 8c45e1279eb742fbf6205af58108f6daf0517883 Mon Sep 17 00:00:00 2001
From: Ronald Brill <rbri@rbri.de>
Date: Fri, 20 Oct 2023 08:49:06 +0200
Subject: [PATCH] a bit more documentation for WebWindowListener

---
 src/site/xdoc/window-frame.xml | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

diff --git a/src/site/xdoc/window-frame.xml b/src/site/xdoc/window-frame.xml
index ad960821d10..f2a539a55c8 100644
--- a/src/site/xdoc/window-frame.xml
+++ b/src/site/xdoc/window-frame.xml
@@ -27,6 +27,8 @@
                 You could think of this as being the first window displayed by a web browser.  Calling
                 WebClient.getPage(WebWindow, WebRequest)
                 will load the new page into this window.
+                <br/>
+                Closing the last (TopLevel)Window of an WebClient will automatically open a new (empty) window. 
             </p>
             <p>
                 The JavaScript open() function can be used to load pages into other windows.  New WebWindow
@@ -37,21 +39,24 @@
         <section name="WebWindowEvents">
             <p>
                 If you wish to be notified when windows are created or pages are loaded, you need to register a
-                WebWindowListener with the WebClient via the
+                <a href="apidocs/org/htmlunit/WebWindowListener.html">WebWindowListener</a> with the WebClient via the
                 method WebClient.addWebWindowListener(WebWindowListener)
             </p>
             <p>
-                When a window is opened either by JavaScript or through the WebClient, a WebWindowEvent will be
+                When a window was opened either by JavaScript or through the WebClient, a WebWindowEvent will be
                 fired and passed into the
                 WebWindowListener.webWindowOpened(WebWindowEvent)
-                method.  Note that both the new and old pages in the event will be null as the window does not
-                have any content loaded at this point.  If a URL was specified during creation of the window then the page
+                method. Note that both the new and old pages in the event will be null as the window does not
+                have any content loaded at this point. If a URL was specified during creation of the window then the page
                 will be loaded and another event will be fired as described below.
             </p>
             <p>
-                When a new page is loaded into a specific window, a WebWindowEvent will be fired and passed into the
+                When a new page was loaded into a specific window, a WebWindowEvent will be fired and passed into the
                 WebWindowListener.webWindowContentChanged(WebWindowEvent) method.
             </p>
+            <p>
+                When an existing window was close, the WebWindowListener.webWindowClosed(WebWindowEvent) is fired.
+            </p>
         </section>
 
         <section name="Frame Example I">