Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

autodoc: documenting aliases #14094

Open
Open
Labels
@LecrisUT

Description

@LecrisUT

Describe the bug

With the recent support for PEP695, the documentation of module level aliases does not have the docstrings inherited, unlike non-type members, i.e. if we have a structure like

# Top-level packagefrom .utilsimportLattice__all__= ["Lattice"]
# Actual implementation (under `.utils`)typeLattice=Sequence[Sequence[float]]__all__= ["Lattice"]

The documentation is different in the top-level
Image
compared to the actual implementation
Image


There is a greater question here though, should the top-level re-implement the documentation, or have a different type and completely link itself to the real implementation (would prefer the latter personally). Whether or not we would want the aliases to be documented could also be configurable, but we would want to at least be able to document them in one form or another particularly if they are explicitly listed in the__all__

How to Reproduce

See snippet above

Environment Information

sphinx master branch after PEP 695 support.

Sphinx extensions

Additional context

Split from#11561 (comment)

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions


      [8]ページ先頭

      ©2009-2025 Movatter.jp