openmicroscopy/openmicroscopy — pull request #2599 by rleigh-dundee (2014-06-10 13:34:37+00:00)
Title: Generate Python API reference with Sphinx (5.0)

- Adds docs/sphinx-api; contains html/pdf/clean ant targets and html/latexpdf/clean make targets
- Adds top-level release-sphinx-api target

This is intended to replace the release-epydoc target and all use of epydoc once we are satisfied that it is good enough to replace it. This PR adds the initial support to generate the API reference, but does not mark up the python sources with sphinx markup; this will need doing separately.

Testing:
- run `build.py clean build-default release-sphinx-api`; check the output in `dist/docs/api/python` or `docs/sphinx-api/_build`
- in `docs/sphinx-api`, run `ant clean html pdf` and `make clean html latexpdf`
- compare the epydoc docs to the sphinx docs; is anything missing (not including the actual docstring content)?

--rebased-from #2357