jsdoc-toolkit 不喜欢我的语法？

Question

我是第一次使用 jsdoc，它似乎不太喜欢我的语法，而且我找不到它喜欢的任何内容：

(function(){  // issue #1
    /**
     * Creates an instance of a Cube animation
     * @class
     */
    function Cube(x, y, z){
       ...
    }

    /** @lends Cube.prototype */
    cubeFrame.prototype = { // Issue #2
       ...
    }
})();

问题 #1：出于某种原因，我收到错误“警告：尝试将 someMethod 记录为未记录符号 Cube 的成员。”如果我保留该包装函数。如果我将其注释掉，它就会起作用。

问题#2：我在类中做了一些奇怪的事情，并且当我在应用以下内容时说 @lends Cube.prototype 时，无法找到让 jsDoc 注意到的方法对象为 Cube 而不是 cubeFrame。我收到与 #1 几乎相同的错误：“警告：尝试将 getVoxel 记录为未记录符号 cubeFrame 的成员。”。我不希望 cubeFrame 被记录下来，我希望它的原型进入 Cube 文档。

我可以重写这两行并获取要生成的文档（然后它是无效代码），但我不想每次进行更改时都必须重新编写代码来生成文档！

Answer 1

使用 @name 标签让 jsdoc 知道对象的名称，然后是类的名称，并将 @lends 标签替换到对象字面量之前。喜欢：

(function(){
    /**
     * Creates an instance of a Cube animation
     * @class
     * @name Cube
     */
    function Cube(){
       //...
    }
    cubeFrame.prototype = /** @lends Cube.prototype */{ // Issue #2
       //...
       /**
       */
       someMethod: function(){}
    };
})()