Clean up some docstrings. Some docstrings didn't show their return

value; others were inconsistent in what to name the argument or return
value; a few module-global functions had "socket." in front of their
name, against convention.