[Octane]

Приходилось использовать такой способ комментирования (документирования) JavaScript-кода в коммерческом проекте. На вопрос: "Как описать метод, возвращающий или принимающий разные значения?", ведущий программист отвечал: "Так делать не нужно, получится не поддерживаемый код". Приходилось так не делать, проблем с JSDoc не возникало
Но все же, как быть если нужно описать метод, возвращающий и принимающий разные значения?

Например, такой метод:

F.prototype = {
	/**
	 *
	 */
	css: function(arg, val) {
		if(typeof arg == "string") {
			if(typeof val == "undefined") {
				return this.getCompudetStyle(arg);
			}
			this.setStyle(arg, val);
		} else {
			for(var prop in arg) {
				this.setStyle(prop, arg[prop]);
			}
		}
		return this;
	}
};

Или вообще забить на этот JSDoc и писать просто комментарии?