Doc updated. Again.
Comments for some functions