javascript - 如何使用 jsdoc-toolkit 记录匿名函数(闭包)

Question

我正在尝试使用 JSDoc-toolkit 记录我的代码。我的代码首先被包裹在一个自执行的匿名函数中。我到底如何记录这个？我几乎一整天都在这上面度过。 JS Docs 不会识别匿名函数闭包内部的任何内容，因为它不知道如何处理它。它坏了，我的评论都没有通过。

我的代码看起来像这样。

/** 
 * @fileoverview BLA BLA BLA
 */

/**
 * This is where I don't know what to put.
 */
 (function () {
     "use strict";

     /** or here */
     var stlib = function (param, param, param) {
         /** or here */
         var share = {
             /** or here */
             config: {
                 button: DOM Element,
                 property: blablabla
             },

             init: function () { ...some init code here}
         };

         share.init();
     };

     widgets.add("share", stlib);
 }());

谢谢!

Answer 1

您可以像这样将@namespace 与@name 和@lends 一起使用:

/**
* @name MyNamespace
* @namespace Hold all functionality
*/
(function () {
    "use strict";
    /** @lends MyNamespace*/
    var stlib = function (param, param, param) { ...All of my code...};
}());