diff --git a/docs/xml/lcl/controls.xml b/docs/xml/lcl/controls.xml
index d56a7a65f9..1ac6809dc7 100644
--- a/docs/xml/lcl/controls.xml
+++ b/docs/xml/lcl/controls.xml
@@ -796,7 +796,8 @@ mrLast=mrYesToAll=10
-
+ As long as Name=Text, changing the Name will set the Caption
+ When for example a button's Name and Caption have the value 'Button1' and the Name is changed to 'Button2' then the Caption is changed as well. When Name and Caption differs this flag has no effect. This flag has no effect during loading.