deprecated the token parser broker sub-system

diff --git a/doc/deprecated.rst b/doc/deprecated.rst
new file mode 100644 (file)
index 0000000..88c08d3
--- /dev/null
+++ b/doc/deprecated.rst
@@ -0,0 +1,14 @@
+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.
+
+Token Parsers
+-------------
+
+* The token parser broker sub-system is deprecated; the following class and
+  interface will be removed in 2.0:
+
+  * ``Twig_TokenParserBrokerInterface``
+  * ``Twig_TokenParserBroker``

diff --git a/doc/index.rst b/doc/index.rst
index 56012f7..3e5166c 100644 (file)
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -15,3 +15,4 @@ Twig
     filters/index
     functions/index
     tests/index
+    deprecated

diff --git a/lib/Twig/TokenParserBroker.php b/lib/Twig/TokenParserBroker.php
index f2c27ee..71b2436 100644 (file)
--- a/lib/Twig/TokenParserBroker.php
+++ b/lib/Twig/TokenParserBroker.php
@@ -15,6 +15,8 @@
  *
  * @package twig
  * @author  Arnaud Le Blanc <arnaud.lb@gmail.com>
+ *
+ * @deprecated
  */
 class Twig_TokenParserBroker implements Twig_TokenParserBrokerInterface
 {

diff --git a/lib/Twig/TokenParserBrokerInterface.php b/lib/Twig/TokenParserBrokerInterface.php
index b8e3c23..c33c50b 100644 (file)
--- a/lib/Twig/TokenParserBrokerInterface.php
+++ b/lib/Twig/TokenParserBrokerInterface.php
@@ -17,6 +17,8 @@
  *
  * @package twig
  * @author  Arnaud Le Blanc <arnaud.lb@gmail.com>
+ *
+ * @deprecated
  */
 interface Twig_TokenParserBrokerInterface
 {