Merge branch '5.4' into 6.3

OskarStark · OskarStark · commit 6b824664b4e2 · 2023-11-07T08:37:06.000+01:00
* 5.4:
  -
  [Options Resolver] Using placeholder to use dynamic parameter
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
@@ -790,11 +790,14 @@ method::
         ->setDeprecated('hostname', 'acme/package', '1.2')
 
         // you can also pass a custom deprecation message (%name% placeholder is available)
+        // %name% placeholder will be replaced by the deprecated option.
+        // This outputs the following deprecation message:
+        // Since acme/package 1.2: The option "hostname" is deprecated, use "host" instead.
         ->setDeprecated(
             'hostname',
             'acme/package',
             '1.2',
-            'The option "hostname" is deprecated, use "host" instead.'
+            'The option "%name%" is deprecated, use "host" instead.'
         )
     ;
 
@@ -811,6 +814,10 @@ method::
     :method:`Symfony\\Component\\OptionsResolver\\Options::offsetGet` method
     to not trigger the deprecation warning.
 
+.. note::
+
+    All deprecation messages are displayed in the profiler logs in the "Deprecations" tab.
+
 Instead of passing the message, you may also pass a closure which returns
 a string (the deprecation message) or an empty string to ignore the deprecation.
 This closure is useful to only deprecate some of the allowed types or values of
