cosmetic issues:
- reST headlines' underline length needs to match the headline length
(looks like somebody is / was using a proportional font)
- Cython code lines do not need to be terminated with a semicolon
- always use triple-double-quotes for docstrings