From 7d3cd978b83e8c3bbb0b0924b8aa9eea7c09f0a8 Mon Sep 17 00:00:00 2001
From: Don Siders <dsiders@lazarus-ide.org>
Date: Tue, 24 Jun 2025 19:14:40 -0400
Subject: [PATCH] Merge branch 'LCL/FindChildControl/Docs' into 'main'

Docs: LCL/controls. Updating FindChildControl function content

See merge request freepascal.org/lazarus/lazarus!504
---
 docs/xml/lcl/controls.xml | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/docs/xml/lcl/controls.xml b/docs/xml/lcl/controls.xml
index c43bab2831..93a9b82dac 100644
--- a/docs/xml/lcl/controls.xml
+++ b/docs/xml/lcl/controls.xml
@@ -26168,14 +26168,18 @@ TabOrder, <b>False</b> for the preceding control.
 
 <element name="TWinControl.FindChildControl">
 <short>Finds a child control with the specified name.</short>
-<descr/>
-<seealso/>
+<descr>
+<p>Only finds direct children, no recursion. The name is case insensitive.</p>
+<p>Note that unique names are not guaranteed for components created in code
+(if they have different owners). Therefore, only the first matching control
+will be returned.</p>
+</descr>
 </element>
 <element name="TWinControl.FindChildControl.Result">
-<short><b>True</b> when the control has been found.</short>
+<short>Control with the given name or <b>nil</b>.</short>
 </element>
 <element name="TWinControl.FindChildControl.ControlName">
-<short>The Name of the control to find.</short>
+<short>The name of the control to find (case insensitive).</short>
 </element>
 
 <element name="TWinControl.SelectNext">