Merge branch '4.2'

* 4.2:
  Fixed typo in reference
  [#11108] Add inline code for the filename
  Update form_login_setup.rst
  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

security/form_login_setup.rst

@@ -74,6 +74,51 @@ class that processes the login submit and 4) updates the main security config fi
         }
     }
 
+Edit the ``security.yml`` file in order to allow access for anyone to the
+``/login`` route:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/security.yaml
+        security:
+            # ...
+
+            access_control:
+                - { path: ^/login$, roles: IS_AUTHENTICATED_ANONYMOUSLY }
+                # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/security.xml -->
+        <?xml version="1.0" charset="UTF-8" ?>
+        <srv:container xmlns="http://symfony.com/schema/dic/security"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:srv="http://symfony.com/schema/dic/services"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                http://symfony.com/schema/dic/services/services-1.0.xsd">
+
+            <config>
+                <rule path="^/login$" role="IS_AUTHENTICATED_ANONYMOUSLY" />
+                <!-- ... -->
+            </config>
+        </srv:container>
+
+    .. code-block:: php
+
+        // config/packages/security.php
+        $container->loadFromExtension('security', [
+            // ...
+            'access_control' => [
+                [
+                    'path' => '^/login',
+                    'roles' => 'IS_AUTHENTICATED_ANONYMOUSLY',
+                ],
+                // ...
+            ],
+        ]);
+
 **Step 2.** The template has very little to do with security: it just generates
 a traditional HTML form that submits to ``/login``: