gh-103373: `__mro_entries__` docs: improve cross references (GH-103398)

(cherry picked from commit e071f00aaefae9eccf787d5c50396c26c8616483)

Co-authored-by: Alex Waygood <Alex.Waygood@Gmail.com>
Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>

diff --git a/Doc/library/types.rst b/Doc/library/types.rst
index 3416871c0c1f150d0a06ed8a7718cac79160ac92..daca0ea4318bc5bf2b5a401e25e1de30ea8f2eac 100644 (file)
--- a/Doc/library/types.rst
+++ b/Doc/library/types.rst
@@ -75,9 +75,9 @@ Dynamic Type Creation
 
    This function looks for items in *bases* that are not instances of
    :class:`type`, and returns a tuple where each such object that has
-   an ``__mro_entries__`` method is replaced with an unpacked result of
+   an :meth:`~object.__mro_entries__` method is replaced with an unpacked result of
    calling this method.  If a *bases* item is an instance of :class:`type`,
-   or it doesn't have an ``__mro_entries__`` method, then it is included in
+   or it doesn't have an :meth:`!__mro_entries__` method, then it is included in
    the return tuple unchanged.
 
    .. versionadded:: 3.7

diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index b086be26999ce173bf6c435296b0b36e73884aaa..3f0c99cd09eb40490d270a1d7c35ab5b7ff99db8 100644 (file)
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -2088,16 +2088,21 @@ Resolving MRO entries
 .. method:: object.__mro_entries__(self, bases)
 
    If a base that appears in a class definition is not an instance of
-   :class:`type`, then an ``__mro_entries__`` method is searched on the base.
-   If an ``__mro_entries__`` method is found, the base is substituted with the
-   result of a call to ``__mro_entries__`` when creating the class.
-   The method is called with the original bases tuple, and must return a tuple
+   :class:`type`, then an :meth:`!__mro_entries__` method is searched on the base.
+   If an :meth:`!__mro_entries__` method is found, the base is substituted with the
+   result of a call to :meth:`!__mro_entries__` when creating the class.
+   The method is called with the original bases tuple
+   passed to the *bases* parameter, and must return a tuple
    of classes that will be used instead of the base. The returned tuple may be
    empty: in these cases, the original base is ignored.
 
 .. seealso::
 
-   :pep:`560` - Core support for typing module and generic types
+   :func:`types.resolve_bases`
+      Dynamically resolve bases that are not instances of :class:`type`.
+
+   :pep:`560`
+      Core support for typing module and generic types.
 
 
 Determining the appropriate metaclass