[DependencyInjection] Add documentation for service locator changes

codedmonkey · javiereguiluz · commit bc5ef854319a · 2019-09-23T17:29:28.000+02:00
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
@@ -243,8 +243,9 @@ Defining a Service Locator
 --------------------------
 
 To manually define a service locator, create a new service definition and add
-the ``container.service_locator`` tag to it. Use its ``arguments`` option to
-include as many services as needed in it.
+the ``container.service_locator`` tag to it. Use the first argument of the
+service definition to pass a collection of services to the service locator. If
+there is no id specified for the service it will inherit its external id.
 
 .. configuration-block::
 
@@ -306,6 +307,16 @@ include as many services as needed in it.
             // ->addTag('container.service_locator')
         ;
 
+.. versionadded:: 4.1
+    The service locator autoconfiguration was introduced in Symfony 4.1. In
+    previous Symfony versions you always needed to add the
+    ``container.service_locator`` tag explicitly.
+
+.. versionadded:: 4.2
+
+    The ability to add services without specifying an id was introduced in
+    Symfony 4.2.
+
 .. note::
 
     The services defined in the service locator argument must include keys,
