Overview
The @ignore tag indicates that a symbol in your code should never appear in the documentation.
This tag takes precedence over all others.
For most JSDoc templates, including the default template, the @ignore tag has the following
effects:
- If you use the
@ignoretag with the@classor@moduletag, the entire class or module will be omitted from the documentation. - If you use the
@ignoretag with the@namespacetag, you must also add the@ignoretag to any child classes and namespaces. Otherwise, your documentation will show the child classes and namespaces, but with incomplete names.
Examples
In the following example, Jacket and Jacket#color will not appear in the documentation.
/**
* @class
* @ignore
*/
function Jacket() {
/** The jacket's color. */
this.color = null;
}
In the following example, the Clothes namespace contains a Jacket class. The @ignore tag must
be added to both Clothes and Clothes.Jacket. Clothes, Clothes.Jacket, and
Clothes.Jacket#color will not appear in the documentation.
/**
* @namespace
* @ignore
*/
var Clothes = {
/**
* @class
* @ignore
*/
Jacket: function() {
/** The jacket's color. */
this.color = null;
}
};