javascript - YuiDoc でオーバーロードされたメソッドを文書化する方法は?

Question

クラス foo に、すべてのオプション パラメータを受け入れるメソッド bar を持つメソッドがあるとしますが、パラメータと順序が変更されると、メソッドの戻り値が大幅に変更されます。

var foo = {

    bar: function (param1, param2) {
        if (typeof param1 === 'object' && param2) {
           //do something and return something
        }
        if (typeof param1 === 'boolean') {
           //do something a little different
        }
    }

}

yuidoc でこのメソッドを呼び出すさまざまな方法をどのように表すことができますか?

オプションのパラメーターは問題ありませんが、メソッドの説明は、すべてをそこに入れると少し長くなります。