Tell about ServiceLocatorTagPass::register()

Author: nicolas-grekas

service_container/service_subscribers_locators.rst

@@ -349,9 +349,25 @@ Now you can use the service locator by injecting it in any other service:
             ->setArguments(array(new Reference('app.command_handler_locator')))
         ;
 
-.. tip::
+When inside :doc:`/service_container/compiler_passes`, using the
+:method:`Symfony\\Component\\DependencyInjection\\Compiler\\ServiceLocatorTagPass::register`
+method is the recommended way to create locators for your services. This will save
+you some boilerplate and will automatically share identical locators amongst all the
+services referencing them::
+
+    use Symfony\Component\DependencyInjection\Compiler\ServiceLocatorTagPass;
+    use Symfony\Component\DependencyInjection\ContainerBuilder;
+
+    public function process(ContainerBuilder $container)
+    {
+        //...
+
+        $locateableServices = array(
+            //...
+            'logger' => new Reference('logger'),
+        );
 
-    If the service locator is not intended to be used by multiple services, it's
-    better to create and inject it as an anonymous service.
+        $myService->addArgument(ServiceLocatorTagPass::register($locateableServices));
+    }
 
 .. _`Command pattern`: https://en.wikipedia.org/wiki/Command_pattern