Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork2.3k
Open
Labels
Description
Describe the bug
I have a method with a doc string:
defwalkpaths(self)->Generator[list[AST],None,None]:"""..."""yield ...
I have other classes namedlist in the package, but they are not in scope in this module.
Translating the documentation gives me this warning:
/Users/walter/checkouts/LivingLogic.Python.xist/src/ll/vsql.py:docstring of ll.vsql.AST.walkpaths:1: WARNING: more than one target found for cross-reference 'list': ll.xist.ns.doc.list, ll.xist.ns.rng.list [ref.python]And when I test the documentation the type hint indead links to the documentation forll.xist.ns.doc.list.
However the typehint clearly reference the builtin classlist:
>>> from ll import vsql>>> a = vsql.AST.walkpaths.__annotations__['return'].__args__[0].__origin__>>> print(a)<class 'list'>>>> print(a.__module__)builtins>>> a is listTrueHow to Reproduce
Unfortunately I was not able to reproduce the problem with a simple example.
Environment Information
Platform: darwin; (macOS-26.1-arm64-arm-64bit-Mach-O)Python version: 3.14.0 (main, Oct 7 2025, 09:34:52) [Clang 17.0.0 (clang-1700.3.19.1)])Python implementation: CPythonSphinx version: 8.2.3Docutils version: 0.21.2Jinja2 version: 3.1.6Pygments version: 2.19.2Sphinx extensions
Additional context
No response