Improve std os documentation #2

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

Thanks for the compilation trick you saved my time!

Also it compile actually because of https://github.com/mozilla/rust/blob/master/src/libstd/os.rs#L40