Merge remote-tracking branch 'upstream/4.3' into 4.3

* upstream/4.3:
  add missing blank line
  missing blank line
  Add caution about combining excluded_http_codes with passthru_level
  fix wrong class import
  Useless code in an example
  Update Doc : Symfony 4.3 - Swift Mailer
  Fixed the link to the ErrorRenderer component page
  Fix the chain adapter exemple on object creation
  [Translation] Mention that you don't have to clear the cache for translation files
  Add caution about combining excluded_404s with passthru_level

Author: javiereguiluz

components/cache/adapters/chain_adapter.rst

@@ -15,16 +15,15 @@ given adapters. This exposes a simple and efficient method for creating a layere
 The ChainAdapter must be provided an array of adapters and optionally a maximum cache
 lifetime as its constructor arguments::
 
-    use Symfony\Component\Cache\Adapter\ApcuAdapter;
-
-    $cache = new ChainAdapter([
+    use Symfony\Component\Cache\Adapter\ChainAdapter;
 
+    $cache = new ChainAdapter(
         // The ordered list of adapters used to fetch cached items
         array $adapters,
 
         // The max lifetime of items propagated from lower adapters to upper ones
         $maxLifetime = 0
-    ]);
+    );
 
 .. note::
 

components/yaml.rst

@@ -289,8 +289,6 @@ Similarly you can use ``DUMP_EXCEPTION_ON_INVALID_TYPE`` when dumping::
     $data = new \stdClass(); // by default objects are invalid.
     Yaml::dump($data, 2, 4, Yaml::DUMP_EXCEPTION_ON_INVALID_TYPE); // throws an exception
 
-    echo $yaml; // { foo: bar }
-
 Date Handling
 ~~~~~~~~~~~~~
 

logging/monolog_exclude_http_codes.rst

@@ -59,3 +59,11 @@ logging these HTTP codes based on the MonologBundle configuration:
                 ],
             ],
         ]);
+
+.. caution::
+
+    Combining ``excluded_http_codes`` with a ``passthru_level`` lower than
+    ``error`` (i.e. ``debug``, ``info``, ``notice`` or ``warning``) will not
+    actually exclude log messages for those HTTP codes because they are logged
+    with level of ``error`` or higher and ``passthru_level`` takes precedence
+    over the HTTP codes being listed in ``excluded_http_codes``.

logging/monolog_regex_based_excludes.rst

@@ -66,3 +66,13 @@ configuration:
                 ],
             ],
         ]);
+
+
+.. caution::
+
+    Combining ``excluded_404s`` with a ``passthru_level`` lower than
+    ``error`` (i.e. ``debug``, ``info``, ``notice`` or ``warning``) will not
+    actually exclude log messages for the URL(s) listed in ``excluded_404s``
+    because they are logged with level of ``error`` or higher and
+    ``passthru_level`` takes precedence over the URLs being listed in
+    ``excluded_404s``.

translation.rst

@@ -366,15 +366,12 @@ For more options, see :ref:`component-translator-message-catalogs`.
     :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface` interface.
     See the :ref:`dic-tags-translation-loader` tag for more information.
 
-.. caution::
-
-    Each time you create a *new* translation resource (or install a bundle
-    that includes a translation resource), be sure to clear your cache so
-    that Symfony can discover the new translation resources:
-
-    .. code-block:: terminal
+.. versionadded:: 4.3
 
-        $ php bin/console cache:clear
+    Starting from Symfony 4.3, when you create a new translation file (or
+    install a bundle that includes translation files), you don't have to clear
+    the cache with the command ``php bin/console cache:clear`` as you had to do
+    in previous Symfony versions.
 
 Handling the User's Locale
 --------------------------