Merge branch '3.4' into 4.0

* 3.4:
  Fix the explanation about registering commands
  Add a 2nd argument to create()
  Update http_kernel_httpkernelinterface.rst
  Fix FQCN in PHP example for expression language
  Fix FQCN in XML example for expression language

Author: javiereguiluz

create_framework/http_kernel_httpkernelinterface.rst

@@ -54,7 +54,10 @@ PHP; it implements ``HttpKernelInterface`` and wraps another
 ``HttpKernelInterface`` instance::
 
     // example.com/web/front.php
-    $framework = new Simplex\Framework($dispatcher, $matcher, $resolver);
+    
+    // ..
+
+    $framework = new Simplex\Framework($dispatcher, $matcher, $controllerResolver, $argumentResolver);
     $framework = new HttpKernel\HttpCache\HttpCache(
         $framework,
         new HttpKernel\HttpCache\Store(__DIR__.'/../cache')

form/unit_testing.rst

@@ -47,16 +47,19 @@ The simplest ``TypeTestCase`` implementation looks like the following::
                 'test2' => 'test2',
             );
 
-            $form = $this->factory->create(TestedType::class);
+            $objectToCompare = new TestObject();
+            // $objectToCompare will retrieve data from the form submission; pass it as the second argument
+            $form = $this->factory->create(TestedType::class, $objectToCompare);
 
             $object = new TestObject();
             // ...populate $object properties with the data stored in $formData
 
             // submit the data to the form directly
             $form->submit($formData);
 
+            $objectToCompare = $form->getData();
             $this->assertTrue($form->isSynchronized());
-            $this->assertEquals($object, $form->getData());
+            $this->assertEquals($object, $objectToCompare);
 
             $view = $form->createView();
             $children = $view->children;
@@ -73,7 +76,7 @@ First you verify if the ``FormType`` compiles. This includes basic class
 inheritance, the ``buildForm()`` function and options resolution. This should
 be the first test you write::
 
-    $form = $this->factory->create(TestedType::class);
+    $form = $this->factory->create(TestedType::class, $objectToCompare);
 
 This test checks that none of your data transformers used by the form
 failed. The :method:`Symfony\\Component\\Form\\FormInterface::isSynchronized`
@@ -91,7 +94,7 @@ method is only set to ``false`` if a data transformer throws an exception::
 Next, verify the submission and mapping of the form. The test below
 checks if all the fields are correctly specified::
 
-    $this->assertEquals($object, $form->getData());
+    $this->assertEquals($object, $objectToCompare);
 
 Finally, check the creation of the ``FormView``. You should check if all
 widgets you want to display are available in the children property::

service_container/expression_language.rst

@@ -45,7 +45,7 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
                 <service id="App\Mail\MailerConfiguration"></service>
 
                 <service id="App\Mailer">
-                    <argument type="expression">service('App\Mail\MailerConfiguration').getMailerMethod()</argument>
+                    <argument type="expression">service('App\\Mail\\MailerConfiguration').getMailerMethod()</argument>
                 </service>
             </services>
         </container>
@@ -60,7 +60,7 @@ to another service: ``App\Mailer``. One way to do this is with an expression:
         $container->autowire(MailerConfiguration::class);
 
         $container->autowire(Mailer::class)
-            ->addArgument(new Expression('service("App\Mail\MailerConfiguration").getMailerMethod()'));
+            ->addArgument(new Expression('service("App\\\\Mail\\\\MailerConfiguration").getMailerMethod()'));
 
 To learn more about the expression language syntax, see :doc:`/components/expression_language/syntax`.