changes to documentation of function