diff --git a/docs/xml/lcl/comctrls.xml b/docs/xml/lcl/comctrls.xml
index 4967523dfe..eb4d9c736c 100644
--- a/docs/xml/lcl/comctrls.xml
+++ b/docs/xml/lcl/comctrls.xml
@@ -3644,15 +3644,16 @@ Performs actions to show or hide pages when the current page is changed.
 pages in the tabbed control.
 </p>
 <p>
-Change causes the TCustomPage instance in Page stored at the position in 
-PageIndex to become visible, and hides the previously visible page on the 
-tabbed control. If a control was focused on the previous page, the new page is 
-focused prior to hiding the previous page.
+Change causes the TCustomPage instance in Page at the position in PageIndex to 
+become visible, and hides the previously visible page on the tabbed control. If 
+a control was focused on the previous page, the new page is focused prior to 
+hiding the previous page.
 </p>
 <p>
-At run-time, MaybeSelectFirstControlOnPage is called when a page instance is 
-active for the control; it selects the focused control for the ActivePage. 
-DoChange is called to signal the OnChange event handler (when assigned).
+At run-time, MaybeSelectFirstControlOnPage is called when the active page 
+component is visible, enabled, and has child controls. It selects the focused 
+control for the ActivePage. DoChange is called to signal the OnChange event 
+handler (when assigned).
 </p>
 <p>
 Change is called from the MoveTab method, and when selection change messages 
@@ -3803,8 +3804,7 @@ Handles an accelerator key for the active page in the tabbed control.
 
 <element name="TCustomTabControl.InternalSetPageIndex">
 <short>
-Updates the internal page index (when assigned) without triggering an OnChange 
-event.
+Updates the internal page index without triggering an OnChange event.
 </short>
 <descr/>
 <seealso/>
@@ -4203,14 +4203,10 @@ active.
 <p>
 <var>MaybeSelectFirstControlOnPage</var> is a method used to ensure that the 
 active control on a form is properly updated when the page on the tab control 
-is changed. It prevents the tabbed control from stealing focus if the active 
-control on the parent form is not the tabbed control or one of its child 
-controls.
-</p>
-<p>
-<var>APage</var> is used to find the next control in the tab order for the 
-page. If a control is found, it is assigned as the ActiveControl on the parent 
-form.
+is changed. It prevents the tabbed control from stealing focus if there is an 
+enabled child control on the page specified in <var>APage</var>. It sets the 
+ActiveControl property on the parent form to the first child control in APage 
+(when available).
 </p>
 <p>
 No actions are performed in the method if any of the following conditions are 
@@ -4234,16 +4230,12 @@ APage does not have any child controls.
 </li>
 </ul>
 <p>
-MaybeSelectFirstControlOnPage is called from the Change method, and occurs 
-when a new value is assigned to the TabIndex property. It occurs after the 
-current Page on the tab control has been made visible and given focus. It is 
-called before the OnChange event handler is signalled.
+MaybeSelectFirstControlOnPage is called from the Change method, and when a new 
+value is assigned to the TabIndex property. It occurs after the current Page on 
+the tab control has been made visible and given focus. It is called before the 
+OnChange event handler is signalled.
 </p>
 </descr>
-<errors>
-Raises an EAssertionFailed exception if a value has not been assigned to the 
-APage argument.
-</errors>
 <version>
 Added in LCL version 4.0.
 </version>