Improve std os documentation #2

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

You should do it for any functions which have significant doc-blocks, it's not necessary to do it for other functions which have no documentation or small doc blocks.