updated function docs