YUIDOC - Параметры документа возвращенного обратного вызова

Question

Как правильно документировать возвращенный обратный вызов, который возвращает несколько параметров. Exe:

return callback(error, success);

Answer 1

Я бы задокументировать это возвращаемое значение следующим образом:

/** 
* @return {Function} Returns the callback in the form of `callback(error, success)` 
*/ 

То есть - использовать фактическое строковое описание оператора возврата. (YUIDoc действительно не имеет возможности документировать то, что вы хотите явно, без описания в тексте.)