Merge branch '3.4' into 4.1

* 3.4:
  Minor tweaks
  Recommend registering the error handler in prod
  validator: comparison constraints value
  Minor fixes in the Doctrine listeners article

Author: javiereguiluz

components/debug.rst

@@ -37,8 +37,8 @@ tools.
 
 .. caution::
 
-    You should never enable the debug tools in a production environment as
-    they might disclose sensitive information to the user.
+    You should never enable the debug tools, except for the error handler, in a
+    production environment as they might disclose sensitive information to the user.
 
 Enabling the Error Handler
 --------------------------
@@ -52,6 +52,9 @@ fatal errors)::
 
     ErrorHandler::register();
 
+This error handler is enabled by default in the production environment when the
+application uses the FrameworkBundle because it generates better error logs.
+
 Enabling the Exception Handler
 ------------------------------
 

doctrine/event_listeners_subscribers.rst

@@ -129,7 +129,7 @@ entity), you should check for the entity's class type in your method
 
     In Doctrine 2.4, a feature called Entity Listeners was introduced.
     It is a lifecycle listener class used for an entity. You can read
-    about it in `the Doctrine Documentation`_.
+    about it in `the DoctrineBundle documentation`_.
 
 Creating the Subscriber Class
 -----------------------------
@@ -240,9 +240,6 @@ to the tag like so:
     Marking an event listener as ``lazy`` has nothing to do with lazy service
     definitions which are described :doc:`in their own article </service_container/lazy_services>`
 
-.. _`The Event System`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html
-.. _`the Doctrine Documentation`: https://symfony.com/doc/current/bundles/DoctrineBundle/entity-listeners.html
-
 Priorities for Event Listeners
 ------------------------------
 
@@ -297,3 +294,6 @@ numbers mean that listeners are invoked earlier.
             ->autowire(MyLowPriorityListener::class)
             ->addTag('doctrine.event_listener', ['event' => 'postPersist', 'priority' => 1])
         ;
+
+.. _`The Event System`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html
+.. _`the DoctrineBundle documentation`: https://symfony.com/doc/current/bundles/DoctrineBundle/entity-listeners.html

reference/constraints/EqualTo.rst

@@ -75,7 +75,7 @@ and that the ``age`` is ``20``, you could do the following:
             <class name="App\Entity\Person">
                 <property name="firstName">
                     <constraint name="EqualTo">
-                        <value>Mary</value>
+                        Mary
                     </constraint>
                 </property>
                 <property name="age">

reference/constraints/GreaterThan.rst

@@ -74,7 +74,7 @@ The following constraints ensure that:
             <class name="App\Entity\Person">
                 <property name="siblings">
                     <constraint name="GreaterThan">
-                        <value>5</value>
+                        5
                     </constraint>
                 </property>
                 <property name="age">

reference/constraints/GreaterThanOrEqual.rst

@@ -72,7 +72,7 @@ The following constraints ensure that:
             <class name="App\Entity\Person">
                 <property name="siblings">
                     <constraint name="GreaterThanOrEqual">
-                        <value>5</value>
+                        5
                     </constraint>
                 </property>
                 <property name="age">

reference/constraints/IdenticalTo.rst

@@ -78,7 +78,7 @@ The following constraints ensure that:
             <class name="App\Entity\Person">
                 <property name="firstName">
                     <constraint name="IdenticalTo">
-                        <value>Mary</value>
+                        Mary
                     </constraint>
                 </property>
                 <property name="age">

reference/constraints/LessThan.rst

@@ -74,7 +74,7 @@ The following constraints ensure that:
             <class name="App\Entity\Person">
                 <property name="siblings">
                     <constraint name="LessThan">
-                        <value>5</value>
+                        5
                     </constraint>
                 </property>
                 <property name="age">

reference/constraints/LessThanOrEqual.rst

@@ -72,7 +72,7 @@ The following constraints ensure that:
             <class name="App\Entity\Person">
                 <property name="siblings">
                     <constraint name="LessThanOrEqual">
-                        <value>5</value>
+                        5
                     </constraint>
                 </property>
                 <property name="age">

reference/constraints/NotEqualTo.rst

@@ -77,7 +77,7 @@ the following:
             <class name="App\Entity\Person">
                 <property name="firstName">
                     <constraint name="NotEqualTo">
-                        <value>Mary</value>
+                        Mary
                     </constraint>
                 </property>
                 <property name="age">

reference/constraints/NotIdenticalTo.rst

@@ -78,7 +78,7 @@ The following constraints ensure that:
             <class name="App\Entity\Person">
             <property name="firstName">
                     <constraint name="NotIdenticalTo">
-                        <value>Mary</value>
+                        Mary
                     </constraint>
                 </property>
                 <property name="age">