Merge branch '4.1' into 4.2

* 4.1:
  Update micro_kernel_trait.rst
  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
 ------------------------------
 

configuration/micro_kernel_trait.rst

@@ -55,7 +55,7 @@ Next, create an ``index.php`` file that defines the kernel class and executes it
         {
             // kernel is a service that points to this class
             // optional 3rd argument is the route name
-            $routes->add('/random/{limit}', 'Kernel::randomNumber');
+            $routes->add('/random/{limit}', 'kernel::randomNumber');
         }
 
         public function randomNumber($limit)

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
 -----------------------------
@@ -204,9 +204,6 @@ whenever possible.
     Starting from Symfony 4.2, Doctrine entity listeners are always lazy. In
     previous Symfony versions this behavior was configurable.
 
-.. _`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
 ------------------------------
 
@@ -261,3 +258,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">