sphinx-automodapi icon indicating copy to clipboard operation
sphinx-automodapi copied to clipboard

Can this package be replaced by something else already in Sphinx?

Open pllim opened this issue 3 years ago • 1 comments

When this package was written, Sphinx was pretty young. Perhaps it has a built-in feature that can replace this package now; maybe https://www.sphinx-doc.org/en/master/usage/extensions/autosummary.html#sphinx-autogen-generate-autodoc-stub-pages ? Or is this not possible because what Sphinx has is not completely automated?

Simon, "... they have https://www.sphinx-doc.org/en/master/man/sphinx-autogen.html and https://www.sphinx-doc.org/en/master/man/sphinx-apidoc.html, but it's not clear to me what it covers and what is missing."

This would supersede #146

pllim avatar Apr 07 '22 19:04 pllim

Personally, after dealing with #73 I tried to revert to using native sphinx extensions like autodoc, autosummary, and the 2 CLIs mentioned here, but it's really not the same thing...they do what they say but the overhead is a lot, and the amount of code to maintain increases.

Apart from the great annoyance of #73 this package never let me down, really.

HealthyPear avatar Mar 13 '23 23:03 HealthyPear