From 1260a2e94cb7cde80085e70ad9855faee945719b Mon Sep 17 00:00:00 2001
From: dsiders <dsiders@lazarus-ide.org>
Date: Fri, 21 Mar 2025 15:08:10 -0400
Subject: [PATCH] Revert "Docs: LCL/forms. Updates the
 TApplication.ShowHintWindow topic for changes in 6a6db7e8. Issue #41535."

This reverts commit 4cda63582d7790802347f81614e4c8ef8daf9489.
Changed to milestone 5.0.
---
 docs/xml/lcl/forms.xml | 26 ++++++++++----------------
 1 file changed, 10 insertions(+), 16 deletions(-)

diff --git a/docs/xml/lcl/forms.xml b/docs/xml/lcl/forms.xml
index 2c63698f1b..77213cf4d4 100644
--- a/docs/xml/lcl/forms.xml
+++ b/docs/xml/lcl/forms.xml
@@ -15521,24 +15521,18 @@ are signalled next.
 </p>
 <p>
 If the hint text or hint data was not assigned in the event handlers, the hint 
-text for the hovered control is used. Only the first "|"-delimited line of 
-text in TControl.Hint is used for the hint.
+text for the hovered control is used. Only the first "|"-delimited line of text 
+in TControl.Hint is used for the hint.
 </p>
 <p>
 The hint window for the application is created (or re-created) and configured 
-as needed. This includes setting the BiDiMode in the hint window to match the 
-hint control, as well as the position and color for the hint window.
+as needed, and the show hint command is performed for the hint control. The 
+ActivateHintData method in the hint window is called to display (or hide) the 
+hint window and activate (or reset) the auto-hide timer.
 </p>
 <p>
-ActivateHintData is called to display the hint window when hint data is used 
-in the hint information. ActivateHint is called to display the hint window 
-when the hint information contains only hint text. The timer used to auto-hide 
-the hint window is started using the hide or reshow timeout values found in 
-the hint information.
-</p>
-<p>
-If the hint control is not assigned (no longer hovered) or the hint text is 
-empty, the HideHint method is called to hide an existing hint window.
+If the hint control is no longer valid or the hint text is empty, the HideHint 
+method is called to hide an existing hint window.
 </p>
 </descr>
 <seealso>
@@ -15554,13 +15548,13 @@ empty, the HideHint method is called to hide an existing hint window.
 </seealso>
 </element>
 <version>
-Modified in LCL version 4.0 to call either ActivateHint or ActivateHintData 
-for the hint window based on the hint information derived in the method.
+Modified in LCL version 4.0 to call ActivateHintData for the hint window 
+(instead of ActivateHint).
 </version>
 <element name="TApplication.ShowHintWindow.Info">
 <short>
 Contains information about the hint control, its mouse coordinates, and the 
-hint text or data used in the method.
+hint text used in the method.
 </short>
 </element>