Improve std os documentation #2

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

Note that this is exactly stating the return type again, it isn't offering any more information that provided by the function signature (most other instances with "returns ... " say something like "returns None if the variable isn't set" which *is* providing more information).