updated documentation

small updates in the documentation, added \see references for
some2another functions