sample.js

/**
 * @file A sample file demo about JSDoc
 * @author dungdm93
 * @since 2016-05-26
 */

/**
 * Person entity class
 * @class
 */
var Person = (function () {
	/**
	 * @param {string} name			person name
	 * @param {number} [age]		person age
	 * @param {string} [address=""]	person address
	 * @constructor
	 */
	function Person(name, age, address) {
		this.name = name;
		this.age = age;
		this.address = address || "";
	}

	/**
	 * @param {string} name				Single type
	 * @param {string|number} idCode	Multiple types
	 * @param {Person[]} friends		Arrays of a type
	 * @exception {InvalidArgumentException} if idCode dose not exists
	 * @returns {string}
	 * @since ASM####
	 */
	Person.prototype.foo = function (name, idCode, friends) {
		// do some staff
		return "Hello, I'm " + this.name;
	};

	return Person;
}());

/**
 * Enum gender
 * @readonly
 * @enum {number}
 */
var Gender = {
	MALE: 0,
	FEMALE: 1
};