DOC: Updating str_pad docstring
- [x ] tests added / passed
- [ x] passes `git diff upstream/master -u -- "*.py" | flake8 --diff`

Pad documentation was describing a different behaviour, so I fixed it and added examples.
