Closes #xxxx Tests added Fully documented, including whats-new.rst for all changes and api.rst for new API