diff --git a/docs/xml/lcl/comctrls.xml b/docs/xml/lcl/comctrls.xml
index 4f01693d31..4c91e61f81 100644
--- a/docs/xml/lcl/comctrls.xml
+++ b/docs/xml/lcl/comctrls.xml
@@ -7441,14 +7441,35 @@ including border space.
+SetImages is an overridden method in TTabControl used as
+the write access specifier for the Images property. It calls the inherited
+method to store AValue in the Images member, and ensures that the value in
+Images is then propagated to the Images member in the Tabs property.
+
+No actions are performed in the method if AValue is the image list already
+assigned to the Images property.
+
+Images is a published TCustomImageList property in
+TTabControl. It contains the images displayed on the Tabs for the
+control.
+
+Assigning a new image list to the property causes the widgetset class instance
+to be updated; the image list, the tab position, and properties for the page
+objects are sent to the widget. The new value in Images is also copied to the
+Images member in Tabs (TTabControlStrings). No actions are performed when the
+an image list already assigned to the property is assigned to Images again.
+
+The Invalidate method is called to cause the control to be redrawn after the
+property value is changed.
+
+Use ImagesWidth to set the default width and height for the images in the list.
+
+Use the indexed Page property to access each TCustomPage object on the tabbed
+control to read or write its ImageIndex property. Or, Use OnGetImageIndex to
+determine the position in Images for a given page/tab index.
+
Changing the value for the property causes the control to be redrawn. It may also affect adjacent buttons on the tool bar with their Grouped properties