Инструментарий JsDoc и пространство имен - Предупреждение о попытке .. без

Я использую jsdoc-toolkit с библиотека пространств имен Майка Косса. Код выглядит так

namespace.module('a.b', // this is the namespace

// @param {Object} exports visible classes within this namespace
// @param {function} required other namespaces
function (exports, require) {

var entityBase = require("a.base");
var util = require("a.util");

// @class BlaBla
// @constructor
// @property {String} ..
// @property {String} ..
// @property {String} ..
// @property {..} ....
// @param {Array} ...
// @param {X} [optionalParam]
exports.MyClass = function (...) {

Создание документации Я получаю следующее сообщение и документация для этого класса вообще не создается.

>> WARNING: Trying to document exports.MyClass without first documenting exports.

Я пытался решить проблему с помощью строк параметров - безуспешно.

// @param {Object} exports visible classes within this namespace
// @param {function} required other namespaces
function (exports, require) {

Любая идея, как преодолеть проблему?


person Horst Walter    schedule 11.09.2011    source источник


Ответы (1)


Я перешел на JsDoc 3 (https://github.com/micmath/jsdoc#readme) . Это модули поддержки и, следовательно, указанная выше библиотека пространств имен.

person Horst Walter    schedule 14.09.2011