комментирование функций обратного вызова

Просто любопытно, как можно прокомментировать, какие параметры будут переданы функции обратного вызова.

Предположим, у нас есть следующий код и неполные комментарии

/**
 * an utterly useless function
 *
 * @param {String} an useless string
 * @param {Boolean} an useless boolean
 * @param {Function} ???
 */

function Useless (str, bool, callback) {
  callback(str, bool);
}

Как правильно сказать, что обратный вызов будет вызываться с параметрами str и bool?

6
задан Bergi 3 August 2012 в 00:58
поделиться