Как документировать функции с помощью JSDoc

Question

JSDoc, похоже, не подходит для большинства моих функций. Вот пример:

/** 
* Function one. 
*/ 
(function one() { 
    /** 
    * Function two. 
    */ 
    function two() { 
     /** 
     * Function three. 
     */ 
     function three() { 
     } 
    } 
})(); 

var four = { 
    /** 
    * Function five/six. 
    */ 
    five: function six() { 
    }, 
    /** 
    * Function seven/eight. 
    */ 
    seven: function eight() { 
    }, 
}; 

nine.ten = { 
    /** 
    * Function eleven/twelve. 
    */ 
    eleven: function twelve() { 
     /** 
     * Function thirteen/fourteen. 
     */ 
     var thirteen = function fourteen() { 
     }; 
    }, 
    /** 
    * Function fifteen/sixteen. 
    */ 
    fifteen: function sixteen() { 
    }, 
}; 

/** 
* Function eighteen 
*/ 
seventeen(function eighteen() { 
}); 

/** 
* Function twenty. 
*/ 
nineteen(function twenty() { 
    /** 
    * Function twentyTwo. 
    */ 
    twentyOne(function twentyTwo() { 
    }); 
}); 

/** 
* Function twentyThree. 
*/ 
function twentyThree() { 
} 

JSDoc только подбирает функцию двадцать три. Остальные полностью упущены.

Что я делаю неправильно?

Answer 1

Это один пример, который даст вам больше выход из JSDoc (3):

/** 
* Function one. 
* @namespace one 
*/ 
(function one() { 
    /** 
    * Function two. 
    * @namespace two 
    * @memberof one 
    */ 
    function two() { 
     /** 
     * Function three. 
     * @memberof one.two 
     */ 
     function three() { 
     } 
    } 
})();