Use autofocus for all module documentation/docstrings

[alexwlchan]

Picking up Hynek’s comment from #734:

Nobody wanted to spend their time to move everything to docstrings yet.

I had half an hour to spare at the station. Voila.

Not only is this neater for devs working on the code, it fixes a bunch of inaccuracies – methods whose signature had changed, added/removed methods, and makes a few docstrings consistent with the published docs.

[codecov]

Codecov Report

Merging #737 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master     #737   +/-   ##
=======================================
  Coverage   97.05%   97.05%           
=======================================
  Files          18       18           
  Lines        5711     5711           
  Branches      395      395           
=======================================
  Hits         5543     5543           
  Misses        112      112           
  Partials       56       56

Impacted Files	Coverage Δ
src/OpenSSL/crypto.py	96.86% <ø> (ø)	⬆️
src/OpenSSL/SSL.py	94.95% <ø> (ø)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 3d231f0...68acb78. Read the comment docs.

[jlaine]

Wow, that's very cool! Does it solve #730 in the process by any chance?

[alexwlchan]

@jlaine There were a bunch of places where the docstring didn't match the docs (or places where the docs explained a method that didn't exist!) – whether #730 is fixed will depend on whether those docstrings are correct, and I haven't checked.

[hynek]

Thanks, this was very much overdue!