Improve std os documentation #2

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

@alexcrichton If I change this like to
```rust
aux_homedir("USERPROFILE").or(aux_homedir("HOME"))
```
That will make the job?