[#5856] Applied final comments

Author: wouterj

cookbook/email/gmail.rst

@@ -50,55 +50,57 @@ In the development configuration file, change the ``transport`` setting to
             'password'  => 'your_gmail_password',
         ));
 
-If you are using the Symfony Standard Edition, it's more convenient to configure
-these options in the ``parameters.yml.dist`` file:
+.. tip::
 
-.. code-block:: yaml
-
-    # app/config/parameters.yml.dist
-    parameters:
-        # ...
-        mailer_user:      your_gmail_username
-        mailer_password:  your_gmail_password
-
-.. configuration-block::
+    It's more convenient to configure these options in the ``parameters.yml``
+    file:
 
     .. code-block:: yaml
 
-        # app/config/config_dev.yml
-        swiftmailer:
-            transport: gmail
-            username:  '%mailer_user%'
-            password:  '%mailer_password%'
-
-    .. code-block:: xml
-
-        <!-- app/config/config_dev.xml -->
-        <?xml version="1.0" encoding="UTF-8" ?>
-        <container xmlns="http://symfony.com/schema/dic/services"
-            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-            xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-            xsi:schemaLocation="http://symfony.com/schema/dic/services
-                http://symfony.com/schema/dic/services/services-1.0.xsd
-                http://symfony.com/schema/dic/swiftmailer
-                http://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
-
-            <!-- ... -->
-            <swiftmailer:config
-                transport="gmail"
-                username="%mailer_user%"
-                password="%mailer_password%"
-            />
-        </container>
-
-    .. code-block:: php
-
-        // app/config/config_dev.php
-        $container->loadFromExtension('swiftmailer', array(
-            'transport' => 'gmail',
-            'username'  => '%mailer_user%',
-            'password'  => '%mailer_password%',
-        ));
+        # app/config/parameters.yml
+        parameters:
+            # ...
+            mailer_user:     your_gmail_username
+            mailer_password: your_gmail_password
+
+    .. configuration-block::
+
+        .. code-block:: yaml
+
+            # app/config/config_dev.yml
+            swiftmailer:
+                transport: gmail
+                username:  '%mailer_user%'
+                password:  '%mailer_password%'
+
+        .. code-block:: xml
+
+            <!-- app/config/config_dev.xml -->
+            <?xml version="1.0" encoding="UTF-8" ?>
+            <container xmlns="http://symfony.com/schema/dic/services"
+                xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+                xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
+                xsi:schemaLocation="http://symfony.com/schema/dic/services
+                    http://symfony.com/schema/dic/services/services-1.0.xsd
+                    http://symfony.com/schema/dic/swiftmailer
+                    http://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd">
+
+                <!-- ... -->
+                <swiftmailer:config
+                    transport="gmail"
+                    username="%mailer_user%"
+                    password="%mailer_password%"
+                />
+            </container>
+
+        .. code-block:: php
+
+            // app/config/config_dev.php
+            $container->loadFromExtension('swiftmailer', array(
+                'transport' => 'gmail',
+                'username'  => '%mailer_user%',
+                'password'  => '%mailer_password%',
+            ));
 
 Redefining the Default Configuration Parameters
 -----------------------------------------------
@@ -127,7 +129,8 @@ that you `allow less secure apps to access your Gmail account`_.
 
 .. seealso::
 
-    :doc:`Swiftmailer configuration reference </reference/configuration/swiftmailer>`
+    see the :doc:`Swiftmailer configuration reference </reference/configuration/swiftmailer>`
+    for more details.
 
 .. _`generate an App password`: https://support.google.com/accounts/answer/185833
 .. _`allow less secure apps to access your Gmail account`: https://support.google.com/accounts/answer/6010255