Javascript-форум (https://javascript.ru/forum/)
-   Оффтопик (https://javascript.ru/forum/offtopic/)
-   -   jsdoc (документирование protected свойств) (https://javascript.ru/forum/offtopic/28255-jsdoc-dokumentirovanie-protected-svojjstv.html)

Tim 13.05.2012 00:54
jsdoc (документирование protected свойств)
 
кто в курсе как заставить jsdoc генерировать документацию для свойств объекта завёрнутых в замыкание?

Tim 13.05.2012 01:04
Т.е. я имею ввиду:
obj = (function () {

	function protected() {}
	
	return {

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

B~Vladi 13.05.2012 14:53
Посмотри в сторону lends.

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

B~Vladi 13.05.2012 22:45
Цитата:
Сообщение от Tim
похоже jsdoc такую возможность просто не предусматривает
Да он вообще много чего не предусматривает. Например, JQ-виджет нормально не задокументировать.

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

Gvozd 14.05.2012 01:56
Цитата:
Сообщение от Tim
похоже jsdoc такую возможность просто не предусматривает.
По-моему вполне логично
Вы же не можете использовать эти переменные извне, в том числе перегрузить.

B~Vladi 14.05.2012 08:44
Цитата:
Сообщение от Tim
YUI Doc
И почему я раньше об этом не слышал.

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

Tim 15.05.2012 22:15
Цитата:
По-моему вполне логично
согласен. тоже хотел об этом сказать.

Цитата:
JSDoc юзаешь или JSDocToolkit
JSDocToolkit. даже не знал что это разные вещи =)

FINoM 17.05.2012 06:01
Цитата:
Сообщение от Tim (Сообщение 174093)
Т.е. я имею ввиду:
obj = (function () {

	function protected() {}
	
	return {

		public: function () {}
	}
}());
Могу ошибаться, но мне кажется, что это, всё-таки, приватная функция.

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

B~Vladi 25.05.2012 20:24
Это не то? http://code.google.com/p/jsdoc-toolkit/wiki/TagInner

Tim 26.05.2012 00:19
нет. не помогло :(

B~Vladi 26.05.2012 00:31
Цитата:
Сообщение от Tim
не помогло
А чего ты ожидаешь?

Tim 26.05.2012 01:05
Уже ни чего:
Цитата:
Сообщение от Gvozd (Сообщение 174332)
По-моему вполне логично
Вы же не можете использовать эти переменные извне, в том числе перегрузить.
Это действительно вполне логично.

Теперь просто ради интереса - возможно или нет.

B~Vladi 26.05.2012 01:22
Цитата:
Сообщение от Gvozd
перегрузить
Нет такого понятия в JS :-E
Цитата:
Сообщение от Tim
возможно или нет
Что?!
Цитата:
Сообщение от Tim
не помогло
Чему?!

Tim 26.05.2012 02:23
Цитата:
Что?!
var obj = (function(){

function f1() {}
})();
сгенерировать документацию для f1

Цитата:
Чему?!
генерации собственно

B~Vladi 26.05.2012 10:08
Цитата:
Сообщение от Tim
var obj = (function(){

function f1() {}
})();
сгенерировать документацию для f1
У меня получилось:
/**
 * @constructor
 */
function Constructor () {
	/**
	 * Inner
	 * @inner
	 * @param {object} data
	 */
	function inner (data) {

	}
}

Нужно запускать с параметром --private.

Tim 30.05.2012 22:11
B~Vladi,
сенкс, попробую. + не ставится =(

Раед 04.06.2012 00:20
Цитата:
Сообщение от Maxmaxmахimus (Сообщение 178574)
Нормальные пасоны сделали бы так
/**
 * @constructor
 */
function Cat (){

}

Cat.prototype.public = function (){

};

/**
 * @private
 */
Cat.prototype._private = function (){
};
Чем это лучше замыкания?


Часовой пояс GMT +3, время: 09:50.