bug symfony#12600 [Doctrine] Don't mention invokable listeners in 4.3 (javiereguiluz)

This PR was merged into the 4.3 branch.

Discussion
----------

[Doctrine] Don't mention invokable listeners in 4.3

This feature was added in 4.4. See https://symfony.com/blog/new-in-symfony-4-4-simpler-event-listeners#invokable-doctrine-entity-listeners

Beware mergers: this must be reverted in 4.4 while merging ... and a `.. versionadded:: 4.4` directive must be added ... and removed later in master.

Commits
-------

fae64fc [Doctrine] Don't mention invokable listeners in 4.3

Author: wouterj

doctrine/events.rst

@@ -272,8 +272,7 @@ with the ``doctrine.orm.entity_listener`` tag:
                         entity_manager: 'custom'
 
                         # by default, Symfony looks for a method called after the event (e.g. postUpdate())
-                        # if it doesn't exist, it tries to execute the '__invoke()' method, but you can
-                        # configure a custom method name with the 'method' option
+                        # but you can configure a custom method name with the 'method' option
                         method: 'checkUserChanges'
 
     .. code-block:: xml
@@ -292,8 +291,7 @@ with the ``doctrine.orm.entity_listener`` tag:
                         * 'entity_manager': define it if the listener is not associated to the
                         *                   default entity manager
                         * 'method': by default, Symfony looks for a method called after the event (e.g. postUpdate())
-                        *           if it doesn't exist, it tries to execute the '__invoke()' method, but
-                        *           you can configure a custom method name with the 'method' option
+                        *           but you can configure a custom method name with the 'method' option
                     -->
                     <tag name="doctrine.orm.entity_listener"
                         event="postUpdate"
@@ -323,9 +321,8 @@ with the ``doctrine.orm.entity_listener`` tag:
                 // you can also associate an entity listener to a specific entity manager
                 'entity_manager' => 'custom',
 
-                // by default, Symfony looks for a method called after the event (e.g. postUpdate())
-                // if it doesn't exist, it tries to execute the '__invoke()' method, but you can
-                // configure a custom method name with the 'method' option
+                // by default, Symfony looks for a method called after the event (e.g. postUpdate()),
+                // but you can configure a custom method name with the 'method' option
                 'method' => 'checkUserChanges',
             ])
         ;