Я использую JSDoc для документации параметров.
Понятно, как документировать типы параметров для many_prompts
, но каков правильный способ документировать возвращаемую им функцию?
/**
* @param {Number} - number of times to prompt
* @return {Function(prompt{Number})} - the returned function
*/
function many_prompts(count) {
return function(prompt) {
for(var i=0; i < count; i++) alert(prompt);
}
}
//Example of use:
var y =many_prompts(3);
y('Hello World');