change documentation of parse functions a little bit to make their functionality more clear