Doc inconsistency in Collection constructor

[jfschwarz]

The docs (http://backbonejs.org/#Collection-constructor) indicate that the models array is an optional parameter for the Backbone.Collection constructor method:

new Backbone.Collection([models], [options])

In fact, it can only be omitted when no options are passed in. Sketch for a simple test case, demonstrating the deviation from the docs:

test("new empty collection with options", function() {
    var col = new Backbone.Collection({model: Backbone.Model});
    equal(col.length, 0);
});

[jashkenas]

That's not an inconsistency. JavaScript uses positional arguments — you're trying to pass in the options as the models. Sans type sniffing, almost any function that accepts more than one argument will work the same.