[tsigel]

Здравствуйте!

Привык писать код с доками, но никогда не писал доки на Callback.
Стал искать и что-то не понял как их писать правильно чтобы ide не ругалась.

Разрабатываю в idea 13 или phpstorm 7.1.

Вот простой пример функции с callback, подскажите как правильно написать доки:

var SomeObj = {

           /**
             * Перебор объекта
             * @method itarObj
             * @param {Object} obj
             * @param {SomeObj~requestCallback} func
             */
            itarObj: function (obj, func) {
                for (var key in obj)
                    if (obj.hasOwnProperty(key))
                        func(obj[key], key);
            }
/**
 * @callback SomeObj~requestCallback func
 * @param {*} 
 * @param {string} 
 */
}

Образец взял тут.

Подскажите пожалуйста.