Add explanatory comment. Fixes #2531252 (in case 4f366cb comment didn't trigger the status change in the commit hook)

removed comment

changed to use Y.mix

Fix for ticket #2531252

addMethod should assign return value by index Fixes #2530409 The iteration taking place in the function returned by ArrayList.addMethod was assembling return values with array.push(val), rather than array[i] = val; For (sloppy) methods with multiple return types-- one of which must be undefined--this would cause the returned values array to have values at different indexes than the item for which they correspond. Also improved the API docs to note the return behavior of the added function.

pull request - toJSON -- [fixes #2529322].

copy/paste error in @method some API docs.

Separating out filter method from ArrayList. It returned a new instance of the augmenting class, but I can't assume that it is appropriate for the augmented class to support filtration , let alone returning a new instance. The issue is not fully resolved, since the extracted module augments the ArrayList proto.

Moving ArrayList into collection module. collection is now a rollup of new submodules array-extras, arraylist, arraylist-add, and array-invoke. Added API docs for all submodules.