From ff575148bb59de0c2d43fa8b79cd7bc57d818926 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?H=C3=A9lio=20Guilherme?= <helioxentric@gmail.com>
Date: Thu, 26 Oct 2023 21:44:39 +0100
Subject: [PATCH] Ensures that on Text Editor, the keyword doc appears near the
 Mouse Pointer (#2666)

---
 src/robotide/application/releasenotes.py | 18 +++++++++---------
 src/robotide/editor/texteditor.py        | 11 ++++++-----
 src/robotide/version.py                  |  2 +-
 3 files changed, 16 insertions(+), 15 deletions(-)

diff --git a/src/robotide/application/releasenotes.py b/src/robotide/application/releasenotes.py
index aa2c0c113..7ac01cb0c 100644
--- a/src/robotide/application/releasenotes.py
+++ b/src/robotide/application/releasenotes.py
@@ -152,14 +152,14 @@ def set_content(self, html_win, content):
 <ul class="simple">
 <li>This version supports Python 3.6 up to 3.11.</li>
 <li>There are some changes, or known issues:<ul>
-<li>RIDE tray icon now shows a context menu with options Show, Hide and Close</li>
-<li>Highlighting and navigation of selected Project Explorer items, in Text Editor</li>
+<li>On Text Editor, pressing <b>Ctrl</b> when the caret/cursor is near a Keyword will show a detachable window with the documentation, at Mouse Pointer position.</li> 
+<li>RIDE tray icon now shows a context menu with options Show, Hide and Close.</li>
+<li>Highlighting and navigation of selected Project Explorer items, in Text Editor.</li>
 <li>When editing in Grid Editor with content assistance, the selected content can be edited by escaping the list of suggestions with keys ARROW_LEFT or ARROW_RIGHT.</li>
-<li>Newlines in Grid Editor can be made visible with the `filter newlines` set to False.</li>
+<li>Newlines in Grid Editor can be made visible with the <b>filter newlines</b> set to False.</li>
 <li>On Text Editor when Saving the selection of tests in Test Suites (Tree) is cleared.</li>
 <li>Test Suite with <em>*** Comments ***</em> can be edited but newlines are introduced.</li>
-<li>When editing resource files in Text Editor, item may disappear from Project Explorer and content may be lost if clicking Apply.
- Better to use the Save action, so changed content is not lost.</li>
+<li>Problems with COPY/PASTE in Text Editor have been reported when using wxPython 4.2.0, but not with version 4.2.1, which we now <em>recommend</em>.</li>
 <li>Some argument types detection (and colorization) is not correct in Grid Editor.</li>
 <li>RIDE <strong>DOES NOT KEEP</strong> Test Suites formatting or structure, causing differences in files when used
  on other IDE or Editors.</li>
@@ -177,7 +177,7 @@ def set_content(self, html_win, content):
 <li>Improved <b>RIDE Log</b> and <b>Parser Log</b> windows to allow Zoom In/Out with <b>Ctrl-Mouse Wheel</b></li>
 <li>Hide continuation markers in Project Tree</li>
 <li>Improved content assistance in Text Editor by allowing to filter list as we type</li>
-<li>Fixed resource files dissapearing from Project tree on Windows</li>
+<li>Fixed resource files disappearing from Project tree on Windows</li>
 <li>Fixed missing indication of link for User Keyword, when pressing <b>Ctrl</b> in Grid Editor</li>
 <li>Added content help pop-up on Text Editor by pressing <b>Ctrl</b> for text at cursor position or selected autocomplete list item</li>
 <li>Added Exclude option in context nenu for Test files, previously was only possible for Test Suites folders</li>
@@ -187,12 +187,12 @@ def set_content(self, html_win, content):
 <li>Colorization of Grid Editor cells after the continuation marker <b>...</b> and correct parsing of those lines</li> 
 <li>Colorization of Grid Editor cells when contents is list or dictionary variables</li>
 <li>Added indication of matching brackets, <b>()</b>, <b>"""'''{}'''f"""</b>, <b>[]</b>, in Text Editor</li>
-<li>Fixed non syncronized expanding/collapse of Settings panel in Grid Editor, on Linux</li>
+<li>Fixed non synchronized expanding/collapse of Settings panel in Grid Editor, on Linux</li>
 <li>Fixed not working the deletion of cells commented with <b># </b> in Grid Editor with <b>Ctrl-Shift-D</b></li> 
 <li>Fixed empty line being always added to the Variables section in Text Editor</li>
 <li>Improved project file system changes and reloading</li>
 <li>Added context menu to RIDE tray icon. Options Show, Hide and Close</li>
-<li>Added sincronization with Project Explorer to navigate to selected item, Test Case, Keyword, Variable, in Text
+<li>Added synchronization with Project Explorer to navigate to selected item, Test Case, Keyword, Variable, in Text
  Editor</li>
 <li>Control commands (<b>FOR</b>, <b>IF</b>, <b>TRY</b>, etc) will only be colorized as valid keywords when typed in all caps in Grid Editor</li>
 <li>Newlines in Grid Editor can be made visible with the <b>filter newlines</b> set to False, by editing <em>settings.cfg</em></li>
@@ -248,6 +248,6 @@ def set_content(self, html_win, content):
 <pre class="literal-block">
 python -m robotide.postinstall -install
 </pre>
-<p>RIDE {VERSION} was released on 25/Oct/2023.</p>
+<p>RIDE {VERSION} was released on 26/Oct/2023.</p>
 </div>
 """
diff --git a/src/robotide/editor/texteditor.py b/src/robotide/editor/texteditor.py
index 2fd441416..9b5183d68 100644
--- a/src/robotide/editor/texteditor.py
+++ b/src/robotide/editor/texteditor.py
@@ -2022,14 +2022,15 @@ def on_update_ui(self, evt):
             self.BraceHighlight(brace_at_caret, brace_opposite)
 
     def _show_keyword_details(self, value, coords=None):
+        """
+        Shows the keyword documentation in value at coordinates, coords.
+        :param value: The content to show in detacheable window
+        :param coords: If None they will be mouse pointer coordinates
+        """
         details = self._plugin.get_keyword_details(value)
         if details and details != self._old_details:  # This is because on Windows keys are sent in repeat
             if not coords:
-                wpos = self.parent.source_editor_parent.GetPosition()
-                npos = self.parent.GetPosition()
-                position = self.GetCurrentPos()
-                position = self.PointFromPosition(position)
-                position = position + wpos + npos
+                position = wx.GetMousePosition()
             else:
                 position = coords
             self._information_popup = HtmlPopupWindow(self.parent, (450, 300))
diff --git a/src/robotide/version.py b/src/robotide/version.py
index f9a09da6c..92faca02a 100644
--- a/src/robotide/version.py
+++ b/src/robotide/version.py
@@ -14,4 +14,4 @@
 #  limitations under the License.
 #
 # Automatically generated by `tasks.py`.
-VERSION = 'v2.0.8dev27'
+VERSION = 'v2.0.8dev28'