updated the function docs