Merge branch 'main' into issue-86298

python · miss-islington · Oct 7, 2022 · Oct 3, 2022 · Oct 3, 2022 · Oct 4, 2022
commit 460236660c802c5597632a367ecdc31087e91164
@@ -555,6 +555,9 @@ listed below.
    for introspection, but can be used for additional loader-specific
    functionality, for example getting data associated with a loader.
 
+   It is **strongly** recommended that you rely on :attr:`__spec__`
+   instead instead of this attribute.
+
    .. versionchanged:: 3.12
       The value of ``__loader__`` is expected to be the same as
       ``__spec__.loader``.  If they are not, an :exc:`ImportWarning` will be
@@ -573,6 +576,9 @@ listed below.
    This attribute is used instead of ``__name__`` to calculate explicit
    relative imports for main modules, as defined in :pep:`366`.
 
+   It is **strongly** recommended that you rely on :attr:`__spec__`
+   instead instead of this attribute.
+
    .. versionchanged:: 3.6
       The value of ``__package__`` is expected to be the same as
       ``__spec__.parent``.