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

Attachment: signature.asc
Description: This is a digitally signed message part

Reply via email to