CODEWITHSUNDEEP
javascriptdocumentationstandardsdocumentation-generationjsdoc
dln385
dln385

Reputation: 12090

How to document functions with JSDoc

JSDoc doesn't seem to pick up on most of my functions. Here's an example:

/**
 * Function one.
 */
(function one() {
    /**
     * Function two.
     */
    function two() {
        /**
         * Function three.
         */
        function three() {
        }
    }
})();

var four = {
    /**
     * Function five/six.
     */
    five: function six() {
    },
    /**
     * Function seven/eight.
     */
    seven: function eight() {
    },
};

nine.ten = {
    /**
     * Function eleven/twelve.
     */
    eleven: function twelve() {
        /**
         * Function thirteen/fourteen.
         */
        var thirteen = function fourteen() {
        };
    },
    /**
     * Function fifteen/sixteen.
     */
    fifteen: function sixteen() {
    },
};

/**
 * Function eighteen
 */
seventeen(function eighteen() {
});

/**
 * Function twenty.
 */
nineteen(function twenty() {
    /**
     * Function twentyTwo.
     */
    twentyOne(function twentyTwo() {
    });
});

/**
 * Function twentyThree.
 */
function twentyThree() {
}

JSDoc only picks up on function twentyThree. The rest are completely missed.

What am I doing wrong?

Upvotes: 1

Views: 1858

Answers (1)

Johan Pettersson
Johan Pettersson

Reputation: 169

This is one example that will give you more output from JSDoc(3):

/**
 * Function one.
 * @namespace one
 */
(function one() {
    /**
     * Function two.
     * @namespace two
     * @memberof one
     */
    function two() {
        /**
         * Function three.
         * @memberof one.two
         */
        function three() {
        }
    }
})();

Upvotes: 5

Related Questions