As of this commit the existing python docs is now formally converted to numpydoc format. Notes:
- The documentation has a number of holes. The general description and usage information are missing and existing docstrings can be improved, too.
- The python package supports both Python 2 and 3. However, imports from builtin caused sphinx build crashes as it followed these symbol names (imports from __future__ seems to cause no problem). sphinx_build.log sphinx_error_traceback.log
- Added __all__ to hide these in the affected source file.
- EllipseCore is a typedef alias in the cc code of lsst::afw::geom::ellipses::Quadrupole. I don't think it appears anywhere in the Python namespace, removed this alias import as it also causes sphinx problems.
As discussed, I'll now remove the Python 2 compatibility stuff to complete this ticket.