Make deprecation messages more concise

Author: javiereguiluz

components/dependency_injection.rst

@@ -303,15 +303,11 @@ config files:
             ;
 
             $services->set('newsletter_manager', 'NewsletterManager')
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->call('setMailer', [service('mailer')])
             ;
         };
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 Learn More
 ----------
 

security/custom_authentication_provider.rst

@@ -438,17 +438,13 @@ to service ids that may not exist yet: ``App\Security\Authentication\Provider\Ws
 
             $services->set(WsseListener::class)
                 ->args([
+                    // In versions earlier to Symfony 5.1 the service() function was called ref()
                     service('security.token_storage'),
                     service('security.authentication.manager'),
                 ])
             ;
         };
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 Now that your services are defined, tell your security context about your
 factory in the kernel::
 

service_container.rst

@@ -526,15 +526,11 @@ parameter and in PHP config use the ``Reference`` class:
             $services = $configurator->services();
 
             $services->set(MessageGenerator::class)
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->args([service('logger')])
             ;
         };
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 Working with container parameters is straightforward using the container's
 accessor methods for parameters::
 

service_container/alias_private.rst

@@ -267,14 +267,10 @@ The following example shows how to inject an anonymous service into another serv
             $services = $configurator->services();
 
             $services->set(Foo::class)
+                // In versions earlier to Symfony 5.1 the inline_service() function was called service()
                 ->args([inline_service(AnonymousBar::class)])
         };
 
-.. versionadded:: 5.1
-
-    The ``inline_service()`` function was introduced in Symfony 5.1. In previous
-    versions it was called ``inline()``.
-
 .. note::
 
     Anonymous services do *NOT* inherit the definitions provided from the

service_container/autowiring.rst

@@ -511,11 +511,6 @@ the injection::
                 // ...
         };
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 Thanks to the ``App\Util\TransformerInterface`` alias, any argument type-hinted
 with this interface will be passed the ``App\Util\Rot13Transformer`` service.
 If the argument is named ``$shoutyTransformer``,

service_container/calls.rst

@@ -72,14 +72,10 @@ To configure the container to call the ``setLogger`` method, use the ``calls`` k
             // ...
 
             $services->set(MessageGenerator::class)
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->call('setLogger', [service('logger')]);
         };
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 To provide immutable services, some classes implement immutable setters.
 Such setters return a new instance of the configured class
 instead of mutating the object they were called on::

service_container/configurators.rst

@@ -179,18 +179,14 @@ all the classes are already loaded as services. All you need to do is specify th
             $services->load('App\\', '../src/*');
 
             // override the services to set the configurator
+            // In versions earlier to Symfony 5.1 the service() function was called ref()
             $services->set(NewsletterManager::class)
                 ->configurator(service(EmailConfigurator::class), 'configure');
 
             $services->set(GreetingCardManager::class)
                 ->configurator(service(EmailConfigurator::class), 'configure');
         };
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 .. _configurators-invokable:
 
 Services can be configured via invokable configurators (replacing the

service_container/factories.rst

@@ -158,14 +158,10 @@ Configuration of the service container then looks like this:
             // second, use the factory service as the first argument of the 'factory'
             // method and the factory method as the second argument
             $services->set(NewsletterManager::class)
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->factory([service(NewsletterManagerFactory::class), 'createNewsletterManager']);
         };
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 .. _factories-invokable:
 
 Invokable Factories

service_container/injection_types.rst

@@ -77,14 +77,10 @@ service container configuration:
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->args(service('mailer'));
         };
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 .. tip::
 
     Type hinting the injected object means that you can be sure that a suitable

service_container/optional_dependencies.rst

@@ -42,14 +42,10 @@ if the service does not exist:
             $services = $configurator->services();
 
             $services->set(NewsletterManager::class)
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->args([service('logger')->nullOnInvalid()]);
         };
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 .. note::
 
     The "null" strategy is not currently supported by the YAML driver.

service_container/parent_services.rst

@@ -129,6 +129,7 @@ duplicated service definitions:
             $services->set(BaseDoctrineRepository::class)
                 ->abstract()
                 ->args([service('doctrine.orm.entity_manager')])
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->call('setLogger', [service('logger')])
             ;
 
@@ -142,11 +143,6 @@ duplicated service definitions:
             ;
         };
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 In this context, having a ``parent`` service implies that the arguments
 and method calls of the parent service should be used for the child services.
 Specifically, the ``EntityManager`` will be injected and ``setLogger()`` will

service_container/service_decoration.rst

@@ -172,6 +172,7 @@ automatically changed to ``'.inner'``):
             $services->set(DecoratingMailer::class)
                 ->decorate(Mailer::class)
                 // pass the old service as an argument
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->args([service('.inner')]);
         };
 
@@ -180,11 +181,6 @@ automatically changed to ``'.inner'``):
     The special ``.inner`` value was introduced in Symfony 5.1. In previous
     versions you needed to use: ``decorating_service_id + '.inner'``.
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 .. tip::
 
     The visibility of the decorated ``App\Mailer`` service (which is an alias

service_container/service_subscribers_locators.rst

@@ -311,6 +311,7 @@ service definition to pass a collection of services to the service locator:
             $services = $configurator->services();
 
             $services->set('app.command_handler_locator', ServiceLocator::class)
+                // In versions earlier to Symfony 5.1 the service() function was called ref()
                 ->args([[
                     'App\FooCommand' => service('app.command_handler.foo'),
                     'App\BarCommand' => service('app.command_handler.bar'),
@@ -328,11 +329,6 @@ service definition to pass a collection of services to the service locator:
             ;
         };
 
-.. deprecated:: 5.1
-
-    In Symfony 5.1, the ``ref()`` function used in the PHP service configuration
-    was deprecated in favor of the ``service()`` function.
-
 .. note::
 
     The services defined in the service locator argument must include keys,