Come documentare una funzione restituita da una funzione utilizzando JSDoc

Question

Sto utilizzando JSDoc per la documentazione dei parametri.

È chiaro come documentare i tipi di parametri per many_prompts, ma qual è il modo corretto per documentare la funzione restituita?

/** 
* @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'); 

Answer 1

È possibile documentare la funzione interna e quindi fare riferimento in questa maniera

/** 
* @param {Number} - number of times to prompt 
* @return {many_prompts~inner} - the returned function 
*/ 
function many_prompts(count){ 
    /** 
    * My inner function 
    * 
    * @param {object} prompt Some parameter 
    */ 
    var inner = function(prompt){ 
    for(var i=0;i<count;i++) alert(prompt} 
    }; 
    return inner; 
}