JSDoc. Как объявить разные типы аргументов для одной функции?

Question

[Finom]

Здравствуйте.
Как сказать парсеру о том, что метод принимает совершенно разные аргументы, например:
строка, строка, строка, строка
строка, строка, объект
объект, строка, строка
объект, объект
массив

Объявлять только лишь один набор аргументов нет смысла, так как метод, хотя и делает одно и то же, но принимает разные аргументы совершенно равносильно, приводя их в начале к общему виду (например, к массиву).

Answer 1

[Finom]

Отвечаю сам. Нужно смотреть тег @variation. Он добавляет методы с одинаковыми именами в документацию. Для того, чтоб избежать дублирования заголовка, надо ковырять шаблон, чем и займусь на досуге (судя по логике шаблона, это не так и сложно).

Answer 2

[Sayonji]

Вот тут показывается два решения. Второе вроде бы приятное:

/**
    @name init
    @function
    @param {string} key
    @param {mixed} value
 */
 /**
    @name init^2
    @function
    @param {object} keyValues
 */
var init = function() {
 ...

Но я не проверял.

Comments

[Finom]

Он просто создал раздел с методом init^2.

Answer 3

[Николай Васильчук]

/**
  @param {String|Object|Array} v1
  @param {String|Object} [v2]
  @param {String} [v3]
  @param {String} [v4]
 */

Но, мне кажется, вам нужно не это.

Comments

[Finom]

Не это. Такая запись будет путать. В идеале хотелось бы сделать так:
Заголовок
Общее описание

Описание
Таблица с аргументами
Пример

Описание
Таблица с аргументами
Пример

Описание
Таблица с аргументами
Пример