added a note about deprecated interfaces

diff --git a/doc/deprecated.rst b/doc/deprecated.rst
index d905487..e7d0d37 100644 (file)
--- a/doc/deprecated.rst
+++ b/doc/deprecated.rst
@@ -1,14 +1,15 @@
 Deprecated Features
 ===================
 
-This document lists all deprecated features in Twig 1.x. They are kept for
-backward compatibility but they will be removed in Twig 2.0.
+This document lists all deprecated features in Twig. Deprecated features are
+kept for backward compatibility and removed in the next major release (a
+feature that was deprecated in Twig 1.x is removed in Twig 2.0).
 
 Token Parsers
 -------------
 
-* The token parser broker sub-system is deprecated; the following class and
-  interface will be removed in 2.0:
+* As of Twig 1.x, the token parser broker sub-system is deprecated. The
+  following class and interface will be removed in 2.0:
 
   * ``Twig_TokenParserBrokerInterface``
   * ``Twig_TokenParserBroker``
@@ -16,7 +17,7 @@ Token Parsers
 Extensions
 ----------
 
-* The ability to remove an extension is deprecated and the
+* As of Twig 1.x, the ability to remove an extension is deprecated and the
   ``Twig_Environment::removeExtension()`` method will be removed in 2.0.
 
 PEAR
@@ -24,3 +25,16 @@ PEAR
 
 PEAR support will be discontinued in Twig 2.0, and no PEAR packages will be
 provided. Use Composer instead.
+
+Interfaces
+----------
+
+* As of Twig 2.x, the following interfaces are deprecated and empty (they will
+  be removed in Twig 3.0):
+
+* ``Twig_CompilerInterface``
+* ``Twig_LexerInterface``
+* ``Twig_NodeInterface``
+* ``Twig_ParserInterface``
+* ``Twig_TokenParserInterface``
+* ``Twig_ExistsLoaderInterface`` (merged with ``Twig_LoaderInterface``)