feature #17360 [Validator] Email - new allow-no-tld mode (guillemfondin)

This PR was squashed before being merged into the 6.2 branch.

Discussion
----------

[Validator] Email -  new `allow-no-tld` mode

See [Related feature PR](symfony/symfony#47872)

As suggested [here](symfony/symfony#47712 (comment)) ; the actual description of `html5` mode isn't consistent with the one provided by browsers. Browsers allow no tld, `html5` mode not.

I proprose to move the actual description of `html5` mode to the new `allow-no-tld` mode description, and clarify the subtlety (force .tld) of the actual `html5` mode.

Commits
-------

485d57e [Validator] Email -  new `allow-no-tld` mode

Author: wouterj

reference/constraints/Email.rst

@@ -109,19 +109,24 @@ This option defines the pattern used to validate the email address. Valid values
 * ``loose`` uses a simple regular expression (just checks that at least one ``@``
   character is present, etc.). This validation is too simple and it's recommended
   to use one of the other modes instead;
-* ``html5`` uses the same regular expression as the `HTML5 email input element`_,
-  making the backend validation consistent with the one provided by browsers;
+* ``html5`` uses the regular expression of the `HTML5 email input element`_,
+  except it enforces a tld to be present.
+* ``html5-allow-no-tld`` uses exactly the same regular expression as the `HTML5 email input element`_,
+  making the backend validation consistent with the one provided by browsers.
 * ``strict`` validates the address according to `RFC 5322`_ using the
   `egulias/email-validator`_ library (which is already installed when using
   :doc:`Symfony Mailer </mailer>`; otherwise, you must install it separately).
 
+.. versionadded:: 6.2
+
+   The ``html5-allow-no-tld`` mode was introduced in 6.2.
+
 .. tip::
 
     The possible values of this option are also defined as PHP constants of
     :class:`Symfony\\Component\\Validator\\Constraints\\Email`
     (e.g. ``Email::VALIDATION_MODE_STRICT``).
 
-
 The default value used by this option is set in the
 :ref:`framework.validation.email_validation_mode <reference-validation-email_validation_mode>`
 configuration option.