diff --git a/src/Symfony/Component/HttpFoundation/Session/Flash/FlashBag.php b/src/Symfony/Component/HttpFoundation/Session/Flash/FlashBag.php
index 7d7e307f9ecfc..2bd7786d7a918 100644
--- a/src/Symfony/Component/HttpFoundation/Session/Flash/FlashBag.php
+++ b/src/Symfony/Component/HttpFoundation/Session/Flash/FlashBag.php
@@ -14,6 +14,8 @@
 /**
  * FlashBag flash message container.
  *
+ * \IteratorAggregate implementation is deprecated and will be removed in 3.0.
+ *
  * @author Drak <drak@zikula.org>
  */
 class FlashBag implements FlashBagInterface, \IteratorAggregate
@@ -167,6 +169,8 @@ public function clear()
     /**
      * Returns an iterator for flashes.
      *
+     * @deprecated Will be removed in 3.0.
+     *
      * @return \ArrayIterator An \ArrayIterator instance
      */
     public function getIterator()