Fix some docblocks and incompatible methods

[fadrian06]

I fix some docblock with the correct markdown syntax. Also fix some incompatible methods between Collection and Iterator class