Skip to content

[Feat] Explore using sphinx.ext.apidoc extension instead of a cli tool #7752

Description

@echoix

Is your feature request related to a problem? Please describe.

Describe the solution you'd like
It would simplify Makefiles (and now CMake) scripts if we could avoid using apidoc as a command-line tool and use instead a static configuration.

Describe alternatives you've considered
I've tried to make this work by starting the sphinx config from scratch in June 2025, but at that time, it wasn't 100% possible to do, and I even filed a PR to the sphinx repo after an extensive analysis. sphinx-doc/sphinx#13668

Now that #7740 simplified the mappings needed, it might be possible to try again.

Additional context
See branch(es) containing echoix@6cf4806, like https://github.com/echoix/grass/tree/docs-sphinx-apidoc-ext

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions