updated function documentation