<summary> (JavaScript)

Specifies the description for a function or method.

<summary locid="descriptionID">description
</summary>

Parameters

  • locid
    Optional. The identifier for localization information about the function or method. The identifier is either a member ID or it corresponds to the name attribute value in a message bundle defined by OpenAjax metadata. The identifier type depends on the format specified in the <loc> (JavaScript) element.

  • description
    Optional. A description of the function or method.

Remarks

The elements used to annotate functions, which include <summary> (JavaScript), <param> (JavaScript), and <returns> (JavaScript), must be placed in the function body before any statements.

Example

The following code shows how to use the <summary> element.

  function areaFunction(radiusParam)
  {
      /// <summary>Determines the area of a circle when supplied a radius parameter.</summary>
      /// <param name="radiusParam" type="Number">The radius of the circle.</param>
      /// <returns type="Number">The area.</returns>
      var areaVal;
      areaVal = Math.PI * radiusParam * radiusParam;
      return areaVal;
  }

See Also

Concepts

XML Documentation Comments (JavaScript)