diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
index 1ee8d6fb056..62de07cfd40 100644
--- a/components/phpunit_bridge.rst
+++ b/components/phpunit_bridge.rst
@@ -35,6 +35,24 @@ You can install the component in 2 different ways:
.. include:: /components/require_autoload.rst.inc
+If you plan to :ref:`write-assertions-about-deprecations` and use the regular
+PHPUnit script (not the modified PHPUnit script provided by Symfony), you have
+to register a new `test listener`_ called ``SymfonyTestsListener``:
+
+.. code-block:: xml
+
+
+
+
+
+
+
+
+
+
+
Usage
-----
@@ -94,9 +112,9 @@ message, enclosed with ``/``. For example, with:
.. code-block:: xml
-
+
@@ -151,6 +169,8 @@ completely disable the deprecation helper. This is useful to make use of the
rest of features provided by this component without getting errors or messages
related to deprecations.
+.. _write-assertions-about-deprecations:
+
Write Assertions about Deprecations
-----------------------------------
@@ -419,3 +439,4 @@ If you have installed the bridge through Composer, you can run it by calling e.g
.. _`@-silencing operator`: http://php.net/manual/en/language.operators.errorcontrol.php
.. _`@-silenced`: http://php.net/manual/en/language.operators.errorcontrol.php
.. _`Travis CI`: https://travis-ci.org/
+.. _`test listener`: https://phpunit.de/manual/current/en/appendixes.configuration.html#appendixes.configuration.test-listeners