I looked into this (autodoc for non-Python domains) a while back, and IIRC
a domain can have something called a "Documentor" which is expected to do
this.  I don't think there is any documentation for this, I'm pretty sure
you'd have to look into the autodoc code to figure out how to do this.

However, depending on what code you are trying to generate API docs for,
there may be other solutions.  For example, if the language in question is
supported by Doxygen, you can generate Sphinx API docs from Doxygen XML
output by using the Breathe Sphinx extension.  We've done this in a recent
project with good results.

On Wed, Mar 18, 2015 at 2:53 PM, Luc Saffre <[email protected]> wrote:

> On 18/03/15 17:25, Eric Holscher wrote:
> > The main problem with this is that it is using Python explicitly. I'm
> > hoping to have something that will work with the Sphinx representation
> > of a domain, so that it would work across all the languages that Sphinx
> > supports.
> >
> > I'm hoping to be able to build Sphinx support for other languages that
> > are first class, but so much of the existing tooling is Python-specific,
> > and requires importing Python code, that it makes it not reusable.
> >
> > I'll look at bit more into the autosummary tooling, but I know autodoc
> > in general is very Python specific, and doesn't actually use Sphinx's
> > domain abstractions in a real way.
>
> Oh yes, indeed. AFAICS autodoc and autosummary are designed to work only
> for Python code. I didn't even realize that you actually meant to
> analyze other code.
>
> Your idea of writing an "autodoc for other languages" sounds
> interesting. (though i am probably not going to need it because i am in
> the (un)fortunate situation of writing almost only in Python ;-)
>
> Luc
>
> --
> You received this message because you are subscribed to the Google Groups
> "sphinx-users" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to [email protected].
> To post to this group, send email to [email protected].
> Visit this group at http://groups.google.com/group/sphinx-users.
> For more options, visit https://groups.google.com/d/optout.
>



-- 
--
Kevin Horn

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.

Reply via email to