DOC: Fixed up the expanding_* function docstrings. Reordered last two docstring
parameters and tried to standardise multi-line keyword arg docstring spacing.