Fix up generic docblocks.

[dereuromark]

The original (legacy syntax) was:

@param \Traversable|\Cake\Datasource\EntityInterface[]

which is meaning wise identical to

@param \Traversable<\Cake\Datasource\EntityInterface>

at least in the given context, since there was no other way of stating an object collection.

Now, given the legacy syntax there was always not clear which one was meant, as it could also mean

@param \Traversable|array<\Cake\Datasource\EntityInterface

which is the current documentation - and also reflects reality (partially).

However, that is a different meaning, as other code examples show, where it is either an object, or an array.
Not a collection of either object or array with the same type inside.

Those are both collection types here (object + array with each the same key).
As such, shoudnt those be fixed up to

@param \Traversable<\Cake\Datasource\EntityInterface>|array<\Cake\Datasource\EntityInterface>

then? As both are the collection we want to iterate over in the end.

There could in the future also be more normalized versions of this, e.g.

@param (\Traversable|array)<\Cake\Datasource\EntityInterface

But for now the verbose syntax is only supported by tooling.

PS: This does need small docblock updates on the actual interface, to make it "generic", afaik.

[dereuromark]

TooManyTemplateParams
=> isnt that easily solved by adding annotations on the interface?
see https://github.com/propelorm/Propel2/pull/1859/files#diff-b77fcf24b104df82969824d2662b771bfe9a87cc4186caa1ce2c9cc5740d84dcR22

[ADmad]

The simplest solution might probably be using iterable<\Cake\Datasource\EntityInterface>. The methods related to save/delete many simply loop over the argument anyway and don't use any resultset specific feature.