I'm not sure. It's all around the docs. Howto lists "object" as allowed type and doesn't say anything about IteratorAggregate :-). My opinion is that there should be "object" in methodsynopsis and what kind of object is it should be explained in the description.
What's the Goba's and others' opinion?
Well, it is hard to decide now that PHP 5 has type hinting, which means that these class names actually become types. It is probably fine now to treat them as types, and use their names instead of the generic "object".
+1
didou
