updated function documentations.