Нашёл, они расписывают объект как я показал выше. В самом конце страницы пример:

/**
  * @param userInfo Information about the user.
  * @param userInfo.name The name of the user.
  * @param userInfo.email The email of the user.
  */
 function logIn(userInfo) {
        doLogIn(userInfo.name, userInfo.email);
 }

Только тип не указали {Object}, поэтому раньше не заметил.

Подскажите плагин для удобного документирования кода в notepad++. В гугле искал, не нашел, надежда на то, что гугл — лох.

Или может есть отдельная прога для написания документации, а то эти ваши ИДЕ не перевариваю из-за психологической травмы, вызванной Вижуал Сдудией.

наверное, http://code.google.com/p/jsdoc-toolkit/

На работе приучили, недавно стал и для себя использовать.

Как бы в этой штуке расписать ситуацию, когда массив берется из arguments?

var elems = [].slice.call(arguments, 1);

вероятно так:

@param {object} Arguments Object ...

хотя нет.. ;)

А реально расписать вот такое безобразие:

var nameSpace = {};

(function () {

	/**
	 * @constructor
	 * @param {Object} arg
	 */
	function Constructor1(arg) {}
	nameSpace.Constructor1 = Constructor1;

	(function () {
		function method1() {}
		Constructor1.prototype.method1 = method1;
	}());

}());

(function () {

	/**
	 * @constructor
	 */
	function Constructor2() {}
	nameSpace.Constructor2 = Constructor2;

	(function () {
		function method2() {}
		Constructor2.prototype.method2 = method2;
	}());

}());

/**
 * @constructor
 * @param {Object} arg
 */
nameSpace.Constructor3 = function (arg) {};
nameSpace.Constructor3.prototype.method3 = function () {};

чтобы WebStorm нормально структуру отображал?


Такие заморочки, чтобы name у функций был заполнен. И вообще стоит ли с этим заморачиваться? :)