Revert "Fix Lint (DOCtor-RST) remarks (including versionadded to deprecated changes in mailer.rst)"

quilius · quilius · commit 0cda6674a044 · 2025-01-18T10:55:25.000+01:00
diff --git a/components/config/definition.rst b/components/config/definition.rst
@@ -834,7 +834,7 @@ A validation rule also requires a "then" part:
 Usually, "then" is a closure. Its return value will be used as a new value
 for the node, instead of the node's original value.
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``ifFalse()`` method was introduced in Symfony 7.3.
 
diff --git a/components/console/helpers/formatterhelper.rst b/components/console/helpers/formatterhelper.rst
@@ -136,7 +136,7 @@ precision (default ``1``) of the result::
     Helper::formatTime(172799, 4);     // 1 d, 23 h, 59 min, 59 s
     Helper::formatTime(172799.056, 5); // 1 d, 23 h, 59 min, 59 s, 56 ms
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     Support for formatting up to milliseconds was introduced in Symfony 7.3.
 
diff --git a/components/http_foundation.rst b/components/http_foundation.rst
@@ -721,7 +721,7 @@ a PHP callable::
         // disables FastCGI buffering in nginx only for this response
         $response->headers->set('X-Accel-Buffering', 'no');
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     Support for using string iterables was introduced in Symfony 7.3.
 
diff --git a/components/options_resolver.rst b/components/options_resolver.rst
@@ -316,7 +316,7 @@ correctly. To validate the types of the options, call
         }
     }
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     Defining type unions with the ``|`` syntax was introduced in Symfony 7.3.
 
diff --git a/components/property_info.rst b/components/property_info.rst
@@ -476,7 +476,7 @@ information from annotations of properties and methods, such as ``@var``,
     $phpStanExtractor->getShortDescription($class, 'bar');
     $phpStanExtractor->getLongDescription($class, 'bar');
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The :method:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpStanExtractor::getShortDescription`
     and :method:`Symfony\\Component\\PropertyInfo\\Extractor\\PhpStanExtractor::getLongDescription`
diff --git a/components/type_info.rst b/components/type_info.rst
@@ -153,7 +153,7 @@ Checking if a type **accepts a value**::
     $type->accepts(123); // true
     $type->accepts('z'); // true
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The :method:`Symfony\\Component\\TypeInfo\\Type::accepts`
     method was introduced in Symfony 7.3.
diff --git a/components/yaml.rst b/components/yaml.rst
@@ -434,7 +434,7 @@ use the ``DUMP_NULL_AS_EMPTY`` flag to dump null values as empty strings::
     $dumped = Yaml::dump(['foo' => null], 2, 4, Yaml::DUMP_NULL_AS_EMPTY);
     // foo:
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``DUMP_NULL_AS_EMPTY`` flag was introduced in Symfony 7.3.
 
diff --git a/controller.rst b/controller.rst
@@ -459,7 +459,7 @@ set the ``key`` option in the ``#[MapQueryString]`` attribute::
         // ...
     }
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``key`` option of ``#[MapQueryString]`` was introduced in Symfony 7.3.
 
diff --git a/mailer.rst b/mailer.rst
@@ -128,7 +128,7 @@ Service               Install with                                    Webhook su
 
     The Mailomat, Mailtrap, Postal and Sweego integrations were introduced in Symfony 7.2.
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The AhaSend integration was introduced in Symfony 7.3.
 
@@ -347,7 +347,7 @@ the retry period by setting the ``retry_period`` option in the DSN:
 
     MAILER_DSN="failover(postmark+api://ID@default sendgrid+smtp://KEY@default)?retry_period=15"
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``retry_period`` option was introduced in Symfony 7.3.
 
@@ -378,7 +378,7 @@ the retry period by setting the ``retry_period`` option in the DSN:
 
     MAILER_DSN="roundrobin(postmark+api://ID@default sendgrid+smtp://KEY@default)?retry_period=15"
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``retry_period`` option was introduced in Symfony 7.3.
 
@@ -429,7 +429,7 @@ setting the ``auto_tls`` option to ``false`` in the DSN::
 Binding to IPv4 or IPv6
 ~~~~~~~~~~~~~~~~~~~~~~~
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The option to bind to IPv4 or IPv6 or a specific IP address was introduced in Symfony 7.3.
 
diff --git a/notifier.rst b/notifier.rst
@@ -236,7 +236,7 @@ Service
 
     The ``Primotexto``, ``Sipgate`` and ``Sweego`` integrations were introduced in Symfony 7.2.
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     Webhook support for the ``Brevo`` integration was introduced in Symfony 7.3.
 
diff --git a/reference/constraints/DateTime.rst b/reference/constraints/DateTime.rst
@@ -107,7 +107,7 @@ Parameter         Description
 ``{{ format }}``  The date format defined in ``format``
 ================  ==============================================================
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``{{ format }}`` parameter was introduced in Symfony 7.3.
 
diff --git a/reference/constraints/Image.rst b/reference/constraints/Image.rst
@@ -210,7 +210,7 @@ add several other options.
 
 If this option is false, the image cannot be landscape oriented.
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``allowLandscape`` option support for SVG files was introduced in Symfony 7.3.
 
@@ -238,7 +238,7 @@ Parameter         Description
 
 If this option is false, the image cannot be portrait oriented.
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``allowPortrait`` option support for SVG files was introduced in Symfony 7.3.
 
@@ -268,7 +268,7 @@ If this option is false, the image cannot be a square. If you want to force
 a square image, then leave this option as its default ``true`` value
 and set `allowLandscape`_ and `allowPortrait`_ both to ``false``.
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``allowSquare`` option support for SVG files was introduced in Symfony 7.3.
 
@@ -370,7 +370,7 @@ Parameter             Description
 If set, the aspect ratio (``width / height``) of the image file must be less
 than or equal to this value.
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``maxRatio`` option support for SVG files was introduced in Symfony 7.3.
 
@@ -493,7 +493,7 @@ Parameter             Description
 If set, the aspect ratio (``width / height``) of the image file must be greater
 than or equal to this value.
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``minRatio`` option support for SVG files was introduced in Symfony 7.3.
 
diff --git a/reference/constraints/Slug.rst b/reference/constraints/Slug.rst
@@ -1,7 +1,7 @@
 Slug
 ====
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``Slug`` constraint was introduced in Symfony 7.3.
 
diff --git a/reference/twig_reference.rst b/reference/twig_reference.rst
@@ -175,7 +175,7 @@ can be found in :ref:`security-template`.
 is_granted_for_user
 ~~~~~~~~~~~~~~~~~~~
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``is_granted_for_user()`` function was introduced in Symfony 7.3.
 
diff --git a/routing.rst b/routing.rst
@@ -2802,7 +2802,7 @@ argument of :method:`Symfony\\Component\\HttpFoundation\\UriSigner::sign`::
 
     The feature to add an expiration date for a signed URI was introduced in Symfony 7.1.
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     Starting with Symfony 7.3, signed URI hashes no longer include the ``/`` or
     ``+`` characters, as these may cause issues with certain clients.
diff --git a/security.rst b/security.rst
@@ -2604,7 +2604,7 @@ want to include extra details only for users that have a ``ROLE_SALES_ADMIN`` ro
     is unavailable (e.g., in a CLI context such as a message queue or cron job), you
     can use the ``isGrantedForUser()`` method to explicitly set the target user.
 
-    .. deprecated:: 7.3
+    .. versionadded:: 7.3
 
         The :method:`Symfony\\Bundle\\SecurityBundle\\Security::isGrantedForUser`
         method was introduced in Symfony 7.3.
diff --git a/service_container/service_closures.rst b/service_container/service_closures.rst
@@ -97,7 +97,7 @@ argument of type ``service_closure``:
             //     ->args([service_closure('mailer')->ignoreOnInvalid()]);
         };
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``@>`` shortcut syntax for YAML was introduced in Symfony 7.3.
 
diff --git a/service_container/tags.rst b/service_container/tags.rst
@@ -1291,7 +1291,7 @@ same service under different indexes:
         // ...
     }
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The feature to apply the ``#[AsTaggedItem]`` attribute multiple times was
     introduced in Symfony 7.3.
diff --git a/string.rst b/string.rst
@@ -248,7 +248,7 @@ Methods to Change Case
 
     The ``kebab()`` method was introduced in Symfony 7.2.
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``pascal()`` method was introduced in Symfony 7.3.
 
diff --git a/webhook.rst b/webhook.rst
@@ -46,7 +46,7 @@ Sweego         ``mailer.webhook.request_parser.sweego``
     The ``Mandrill``, ``Mailomat``, ``Mailtrap``, and ``Sweego`` integrations were introduced in
     Symfony 7.2.
 
-.. deprecated:: 7.3
+.. versionadded:: 7.3
 
     The ``AhaSend`` integration was introduced in Symfony 7.3.
 

Original file line number	Diff line number	Diff line change
`@@ -316,7 +316,7 @@ correctly. To validate the types of the options, call`
`316`	`316`	`}`
`317`	`317`	`}`
`318`	`318`
`319`		`-.. deprecated:: 7.3`
	`319`	`+.. versionadded:: 7.3`
`320`	`320`
`321`	`321`	Defining type unions with the ``\|`` syntax was introduced in Symfony 7.3.
`322`	`322`
Original file line number	Diff line number	Diff line change
@@ -459,7 +459,7 @@ set the ``key`` option in the ``#[MapQueryString]`` attribute::
`459`	`459`	`// ...`
`460`	`460`	`}`
`461`	`461`
`462`		`-.. deprecated:: 7.3`
	`462`	`+.. versionadded:: 7.3`
`463`	`463`
`464`	`464`	The ``key`` option of ``#[MapQueryString]`` was introduced in Symfony 7.3.
`465`	`465`