documentation: complete function argument description.