On Thu, 2019-08-01 at 08:16 -0500, Kenneth Pronovici wrote: > > 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.
I am inclined to do the same, to drop the documentation package. But Christophe did all the work in the past, so his opinion mattered. I will make an upload for this package dropping the -doc package. Thanks, Ritesh -- Ritesh Raj Sarraf | http://people.debian.org/~rrs Debian - The Universal Operating System
signature.asc
Description: This is a digitally signed message part