From 4feac3a6f1dfdd2a626d0dfaefaacb432a657a69 Mon Sep 17 00:00:00 2001
From: dsiders <dsiders@lazarus-ide.org>
Date: Thu, 30 Jan 2025 19:52:24 -0500
Subject: [PATCH] Docs: LCL/forms. Updates TCustomForm.Monitor to reflect use
 of the Owner form instead of the application main form when Position is
 poOwnerFormCenter. Changes in bc857823. Issue #41377.

---
 docs/xml/lcl/forms.xml | 13 +++++++++----
 1 file changed, 9 insertions(+), 4 deletions(-)

diff --git a/docs/xml/lcl/forms.xml b/docs/xml/lcl/forms.xml
index 8bf7795eb6..87f0c6aa43 100644
--- a/docs/xml/lcl/forms.xml
+++ b/docs/xml/lcl/forms.xml
@@ -8370,7 +8370,9 @@ the enumeration values and their meanings.
 </element>
 
 <element name="TCustomForm.Monitor">
-<short>Contains the Monitor where the form is shown.</short>
+<short>
+Returns the Monitor where the form is shown.
+</short>
 <descr>
 <p>
 <var>Monitor</var> is a read-only <var>TMonitor</var> property which contains 
@@ -8408,8 +8410,9 @@ used as the monitor where the form is located.
 </dd>
 <dt>poOwnerFormCenter</dt>
 <dd>
-When Owner is a different TCustomForm instance than the current class, the 
-monitor in TApplication.MainForm is used.
+When Owner is both assigned and a different TCustomForm instance than the 
+current class, the Monitor property in Owner is used. Otherwise, the value 
+from GetDefaultMonitor is used as the Monitor for the form instance.
 </dd>
 </dl>
 <p>
@@ -8435,10 +8438,12 @@ poDefaultPosOnly.
 <link id="TCustomForm.DefaultMonitor"/>
 <link id="Screen"/>
 <link id="TScreen"/>
-<link id="Application"/>
+<link id="TApplication.MainForm"/>
 <link id="TApplication"/>
+<link id="Application"/>
 <link id="TMonitor"/>
 <link id="GetParentForm"/>
+<link id="#rtl.classes.TComponent.Owner">TComponent.Owner</link>
 </seealso>
 </element>