Improve std os documentation #2

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

Tidy: Need to be fixed:
```
/home/travis/build/mozilla/rust/src/libstd/os.rs:671: line longer than 100 chars
/home/travis/build/mozilla/rust/src/libstd/os.rs:672: line longer than 100 chars
```