#1147 some more docstring formatting