@description

  • constructor
documentjs.tags.description  

Markdown content placed before all signature and API content.

@description

Content after the @description tag appears after the title, but before signature and API content.

@description tag content is treated as markdown and set as the docObject's description property.

Use

The description of a docObject is displayed at the top of an html page generated with the default html generator.

In the following example, @description stops content from being added to @param, and instead makes content be added to the description property.

/**
 * @param {String} name The name of the
 * component.
 * 
 * @description
 * A component for lib.
 */
lib.Component = function(name){}

By default the first paragraph of content that is not after a multi-line tag like @signature, @param, etc, is set as the @description. All content after the first paragraph is set as the body content.

You can see what is treated as description and body by default in the following example:

/**
 * @function 
 * 
 * DESCRIPTION DESCRIPTION
 * DESCRIPTION DESCRIPTION
 * 
 * BODY BODY
 * BODY BODY
 * 
 * BODY BODY
 * 
 * @signature `.cols(cols)` SIGNATURE_DESCRIPTION
 * SIGNATURE_DESCRIPTION SIGNATURE_DESCRIPTION
 *
 * @body
 * BODY BODY
 */
Graph.prototype.cols = function(cols){ ... }