Merge API documentation in Sphinx with docstrings

Major improvements to the docstrings (mostly by merging the information that was only in Sphinx, but also grammar fixes).

This isn't entirely complete: sign, verify, PKCS7... still have their own API docs in Sphinx. But hey, this PR is already more than big enough (thanks @alex for nudging me to send it in quicker).

This fixes #125, too.