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：何らかの理由でI "警告：文書化しようとしましたsomeMethod未登録のシンボルキューブのメンバーとして。私はそのラッピング関数を残している場合。私はそれをコメントアウトすると、それは動作します。

問題＃2：私は私のクラスで少し奇妙な何かをやっていると私はCubeなくcubeFrameに次のオブジェクトを適用するという点で@lends Cube.prototypeを言うときの注意を払うようにJSDocのを取得する方法を把握することはできません。 ＃1とほぼ同じエラーが表示されます： "警告：文書化されていないシンボルのメンバーとしてgetVoxelを文書化しようとしていますcubeFrame"。私はcubeFrameを文書化したくないので、そのプロトタイプをCubeのドキュメントに入れて欲しい。

私はこれらの2行を書き換えて、生成する文書を取得することができます（無効なコードです）。しかし、変更するたびにドキュメントを生成するコードを書き直したくありません。

Answer 1

@nameタグを使用すると、jsdocにオブジェクト名、クラス名、および@lendsタグをオブジェクトリテラルの直前に置き換えることができます。 Like：

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