> While epydoc can parse Javadoc comments, it seems that Sphinx does not > support them. So I don't know how the documentation package for > configshell-fb could be generated without epydoc. Maybe we can simply > drop this package...
It is possible to do this conversion in a semi-automated way. Back in the original bug report back in 2017, I provided [1], which is a hack-ish script to convert common Epydoc markup to Google-style docstrings that can be parsed by Sphinx. It's not perfect, but it would get you much of the way toward working code. However, unless you have time to take on that effort, I think it's probably going to be simplest to just drop the documentation package - especially if you think that the API documentation in Debian is not heavily-used. [1] https://bitbucket.org/cedarsolutions/cedar-backup3/src/73037a2/util/sphinx-convert
