jsdoc (документирование protected свойств)
 

кто в курсе как заставить jsdoc генерировать документацию для свойств объекта завёрнутых в замыкание?

Т.е. я имею ввиду:

obj = (function () {

	function protected() {}
	
	return {

		public: function () {}
	}
}());

Посмотри в сторону lends.

не это немного не то. похоже jsdoc такую возможность просто не предусматривает.

Да он вообще много чего не предусматривает. Например, JQ-виджет нормально не задокументировать.

нужно ещё YUI Doc попробовать, может он лучше

По-моему вполне логично
Вы же не можете использовать эти переменные извне, в том числе перегрузить.

И почему я раньше об этом не слышал.

Tim, а ты JSDoc юзаешь или JSDocToolkit?

согласен. тоже хотел об этом сказать.

JSDocToolkit. даже не знал что это разные вещи =)

Могу ошибаться, но мне кажется, что это, всё-таки, приватная функция.