Reformat and edit docstrings to follow modern conventions. Single

line summary followed by blank line and description.