correct function documentation