Improve std os documentation #2

Improving documentation, consistency, removes evils empty lines etc...

There's no reason to say this: it is in the type signature. Maybe this whole paragraph could become:

> Split a string or vector into paths based on the platform's convention for the `PATH` environment variable.
>
> Any empty paths are ignored.