doc enhancements to scipy.stats.mstats.winsorize

DOC: clarify `limits` parameter in `winsorize` docstring.
STY: PEP8 the `scipy.stats.mstats.winsorize` function.
DOC: add short explanation to `scipy.stats.mstats.winsorize` doctring.

fixes #2971