冒頭に示したコメントを確認してみましょう。

/**
 * Repeat <tt>str</tt> several times.
 * @param {string} str The string to repeat.
 * @param {number} [times=1] How many times to repeat the string.
 * @returns {string}
 */

これは、JSDoc構文の一部を示しています。JSDoc構文は、次の要素で構成されています。

エンティティの型は、プリミティブ型またはクラスのいずれかです。前者の名前は常に小文字で始まり、後者の名前は常に大文字で始まります。言い換えれば、プリミティブの型名は、typeof演算子によって返される結果と同様に、boolean、number、stringです。こうすることで、文字列(プリミティブ)とコンストラクタStringのインスタンス(オブジェクト)を混同することがなくなります。

コンストラクタ関数を使用してクラスを定義するには、コンストラクタ関数をマークする必要があります。そうしないと、クラスとしてドキュメント化されません。大文字化だけでは、関数がコンストラクタとしてマークされません。

/**
 * A class for managing persons.
 * @constructor
 */
function Person(name) {
}

オブジェクトリテラルを使用してクラスを定義するには、2つのマーカーが必要です。まず、JSDocに、特定の変数がクラスを保持していることを伝える必要があります。次に、オブジェクトリテラルをクラスを定義するものとしてマークする必要があります。@lendsタグを使用して後者を実行します。

/**
 * A class for managing persons.
 * @class
 */
var Person = makeClass(
    /** @lends Person# */
    {
        say: function(message) {
            return 'This person says: ' + message;
        }
    }
);

オブジェクトリテラルに@constructsメソッドがある場合、JSDocにそのことを知らせる必要があります。そうすることで、インスタンスプロパティのドキュメントを見つけることができます。クラスのドキュメントはそのメソッドに移動します。

var Person = makeClass(
    /** @lends Person# */
    {
        /**
         * A class for managing persons.
         * @constructs
         */
        initialize: function(name) {
            this.name = name;
        },
        say: function(message) {
            return this.name + ' says: ' + message;
        }
    }
);

@lendsを省略した場合、メソッドが属するクラスを指定する必要があります。

var Person = makeClass({
        /**
         * A class for managing persons.
         * @constructs Person
         */
        initialize: function(name) {
            this.name = name;
        },
        /** @memberof Person# */
        say: function(message) {
            return this.name + ' says: ' + message;
        }
    }
);

JavaScriptには、サブクラス化の組み込みサポートがありません。コードでサブクラス化する場合(手動で行うか、ライブラリを介して行うかにかかわらず)、JSDocに何が起こっているかを伝える必要があります。