You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Is your feature request related to a problem? Please describe.
So far, :py:exc: role automatically searches exception classes under exceptions module. But, since python3, exception classes has been moved into builtins module. So this fallback works fine only for python2 docs.
.. py:exception:: exceptions.Exception
:py:exc:`Exception` can refer `exceptions.Exception` automatically even if no ``py:module::`` given.
In addition, this fallback is a part of python domain, not intersphinx. So it only works for a document contains descriptions for standard exceptions. It does not work for a document only refers python standard exceptions.
Side note: python domain also has another special support for :py:func: and :py:meth:. It also automatically searches functions and methods under object.
.. py:method:: object.__str__()
:py:func:`__str__` and `:py:meth:`__str__` can refer `object.__str__()` automatically even if no ``py:class:`` given.
I don't know why python domain searches them on object.* namespace. I can understand if it searches under builtins module. Anyway, this is also meaningless.
Describe the solution you'd like
Drop these special treatment from python domain.
Describe alternatives you've considered
Nothing.
Additional context
Nothing.
The text was updated successfully, but these errors were encountered:
Is your feature request related to a problem? Please describe.
So far,
:py:exc:
role automatically searches exception classes underexceptions
module. But, since python3, exception classes has been moved intobuiltins
module. So this fallback works fine only for python2 docs.In addition, this fallback is a part of python domain, not intersphinx. So it only works for a document contains descriptions for standard exceptions. It does not work for a document only refers python standard exceptions.
Side note: python domain also has another special support for
:py:func:
and:py:meth:
. It also automatically searches functions and methods underobject
.I don't know why python domain searches them on
object.*
namespace. I can understand if it searches underbuiltins
module. Anyway, this is also meaningless.Describe the solution you'd like
Drop these special treatment from python domain.
Describe alternatives you've considered
Nothing.
Additional context
Nothing.
The text was updated successfully, but these errors were encountered: