> How about writing doc strings and sending us a patch.

Attached is a patch. Amend as needed.

I transferred existing comments to doc strings, rewording a bit in some
cases. 

I tried only to understand the existing comments; I did not try to
understand uncommented code to guess what the doc strings should be. So some
functions still have no doc strings.