Merge branch '3.4' into 4.2

* 3.4:
  Fixed typo in reference
  Update dotenv.rst
  [Form] Add example for createNamed Form
  Update Traverse.rst

Author: wouterj

components/dotenv.rst

@@ -6,7 +6,7 @@ The Dotenv Component
 ====================
 
     The Dotenv Component parses ``.env`` files to make environment variables
-    stored in them accessible via ``getenv()``, ``$_ENV`` or ``$_SERVER``.
+    stored in them accessible via ``$_ENV`` or ``$_SERVER``.
 
 Installation
 ------------
@@ -51,10 +51,10 @@ Given the following ``.env`` file content:
     DB_USER=root
     DB_PASS=pass
 
-Access the value with ``getenv()`` in your code::
+Access the value with ``$_ENV`` in your code::
 
-    $dbUser = getenv('DB_USER');
-    // you can also use ``$_ENV`` or ``$_SERVER``
+    $dbUser = $_ENV['DB_USER'];
+    // you can also use ``$_SERVER``
 
 The ``load()`` method never overwrites existing environment variables. Use the
 ``overload()`` method if you need to overwrite them::

forms.rst

@@ -691,7 +691,23 @@ the choice is ultimately up to you.
 .. note::
 
     The form name is automatically generated from the type class name. If you want
-    to modify it, use the :method:`Symfony\\Component\\Form\\FormFactoryInterface::createNamed` method.
+    to modify it, use the :method:`Symfony\\Component\\Form\\FormFactoryInterface::createNamed` method::
+
+        // src/AppBundle/Controller/DefaultController.php
+        use AppBundle\Form\TaskType;
+        use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+
+        class DefaultController extends AbstractController 
+        {
+            public function newAction()
+            {
+                $task = ...;
+                $form = $this->get('form.factory')->createNamed('name', TaskType::class, $task);
+
+                // ...
+            }
+        }
+
     You can even suppress the name completely by setting it to an empty string.
 
 Final Thoughts

reference/constraints/Traverse.rst

@@ -4,14 +4,14 @@ Traverse
 Objects do not validate nested objects by default unless explicitly using
 this constraint.
 If only specific nested objects should be validated by cascade, consider
-using the :doc:`references/constraints/Valid` instead.
+using the :doc:`reference/constraints/Valid` instead.
 
 +----------------+-------------------------------------------------------------------------------------+
 | Applies to     | :ref:`class <validation-class-target>`                                              |
 +----------------+-------------------------------------------------------------------------------------+
 | Options        | - `payload`_                                                                        |
 +----------------+-------------------------------------------------------------------------------------+
-| Class          | :class:`Symfony\\Bridge\\Doctrine\\Validator\\Constraints\\Traverse`                |
+| Class          | :class:`Symfony\Component\Validator\Constraints\Traverse`                           |
 +----------------+-------------------------------------------------------------------------------------+
 
 Basic Usage