[sphinx-dev] autodoc for Java source?

2010-02-22 Thread Chris Collins
Does autodoc only work for Python source code? According to the docs (http://sphinx.pocoo.org/ext/autodoc.html), *For Sphinx (actually, the Python interpreter that executes Sphinx) to find your module, it must be importable. That means that the module or the package must be in one of the

Re: [sphinx-dev] Re: autodoc for Java source?

2010-02-24 Thread Chris Collins
Collins xop...@gmail.com wrote: No one uses Sphinx for Java projects? I guess I'm blazing a trail. On Mon, Feb 22, 2010 at 3:14 PM, Chris Collins xop...@gmail.com wrote: Does autodoc only work for Python source code? According to the docs (http://sphinx.pocoo.org/ext/autodoc.html

Re: [sphinx-dev] Re: autodoc for Java source?

2010-02-24 Thread Chris Collins
...@gmail.com wrote: Ouf! That defeats the idea of keeping code and doc comments in the same place. You'll need to be vigilant to be sure the docs are kept up to date. --Janet On Wed, Feb 24, 2010 at 11:40 AM, Chris Collins xop...@gmail.com wrote: That confirms my suspicion that I just need

Re: [sphinx-dev] Re: autodoc for Java source?

2010-02-26 Thread Chris Collins
Binns rog...@rogerbinns.com wrote: -BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Chris Collins wrote: Yes. Separating the Javadocs from the source code is definitely not the way I wanted to go. I generate a whole bunch of my docs by parsing C source files - the docs are actually about