first line of docstring should be a short 1-line summary, followed by a blank line an optional longer description.