[symfony#2729] Tweaks to the new synthetic service documentation by @wouterj

weaverryan · weaverryan · commit 0015c9d35326 · 2013-06-30T17:18:13.000-05:00
diff --git a/components/dependency_injection/advanced.rst b/components/dependency_injection/advanced.rst
@@ -65,8 +65,10 @@ Synthetic Services
 Synthetic services are services that are injected into the container instead
 of being created by the container.
 
-For instance, the ``request`` service which is injected in the
-:method:`HttpKernel::handle() <Symfony\\Component\\HttpKernel\\HttpKernel::handle>`
+For example, if you're using the :doc:`HttpKernel</components/http_kernel/introduction>`
+component with the DependencyInjection component, then the the ``request``
+service is injected in the
+:method:`ContainerAwareHttpKernel::handle() <Symfony\\Component\\HttpKernel\\DependencyInjection\\ContainerAwareHttpKernel::handle>`
 method when entering the request :doc:`scope </cookbook/service_container/scopes>`.
 The class does not exist when there is no request, so it can't be included in
 the container configuration. Also, the service should be different for every
@@ -96,11 +98,11 @@ To create a synthetic service, set ``synthetic`` to ``true``:
             ->setSynthetic(true);
 
 As you see, only the ``synthetic`` option is set. All other options are only used
-to configure the container how a service is created by the container. As the
-service isn't created by the container, these options are omitted.
+to configure how a service is created by the container. As the service isn't
+created by the container, these options are omitted.
 
 Now, you can inject the class by using
-:method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::set`::
+:method:`Container::set<Symfony\\Component\\DependencyInjection\\Container::set>`::
 
     // ...
     $container->set('request', new MyRequest(...));
