stubber: Docstubs tweak no-clean-rst actions.

Signed-off-by: Jos Verlinde <[email protected]>

src/stubber/rst/lookup.py

@@ -74,8 +74,6 @@ class Fix:
 # also applies correction for some classes are documented as functions
 
 RST_DOC_FIXES: List[Tuple[str, str]] = [
-    # remove rst highlights from docstrings
-    (":class: attention\n", ""),
     # ------------------------------------------------------------------------------------------------
     # re.rst - function and class with the same name
     # done: issue https://github.com/micropython/micropython/issues/8273

src/stubber/rst/reader.py

@@ -324,7 +324,8 @@ def clean_docstr(self, block: List[str]):
         return block
 
     def add_link_to_docstr(self, block: List[str]):
-        """Add clickable hyperlinks to CPython docpages"""
+        """Add clickable hyperlinks to CPython docpages,
+        and clean the docstring from rst constructs"""
         if not self.clean_rst:
             return block
 
@@ -348,6 +349,9 @@ def add_link_to_docstr(self, block: List[str]):
             _l = _l.replace(".. note:: ", "``Note:`` ")
             _l = _l.replace(".. data:: ", "")
             _l = _l.replace(".. admonition:: ", "Admonition:")
+            # remove rst highlights from docstrings
+            _l = _l.replace(":class: attention\n", "")
+            # Sphinx directive to link to CPython documentation
             _l = _l.replace("|see_cpython_module|", "CPython module:")
             # clean up unsupported escape sequences in rst
             _l = _l.replace(r"\ ", " ")