Minor tweaks

Author: javiereguiluz

components/intl.rst

@@ -311,18 +311,22 @@ to catching the exception, you can also check if a given currency code is valid:
 
     $isValidCurrency = Currencies::exists($currencyCode);
 
-If the currencies need to be filtered, there are also helpers to query and
-validate currencies in relation to countries. These methods use ICU metadata
-(``tender``, ``from`` and ``to`` dates) to determine whether a currency is
-`legal tender`_ and/or active at a given point in time::
+By default, the previous currency methods return all currencies, including
+those that are no longer in use. Symfony provides several methods to filter
+currencies so you can work only with those that are actually valid and in use
+for a given country.
+
+These methods use ICU metadata (``tender``, ``from`` and ``to`` dates) to
+determine whether a currency is `legal tender`_ and/or active at a specific
+point in time::
 
     use Symfony\Component\Intl\Currencies;
 
-    // Get the list of legal and active currencies for a country (defaults to "today")
+    // get the list of today's legal and active currencies for a country
     $codes = Currencies::forCountry('FR');
     // ['EUR']
 
-    // Include non-legal currencies too, and check them at a given date
+    // include non-legal currencies too, and check them at a given date
     $codesAll = Currencies::forCountry(
         'ES',
         legalTender: null,
@@ -331,11 +335,11 @@ validate currencies in relation to countries. These methods use ICU metadata
     );
     // ['ESP', 'ESB']
 
-    // Validate a currency for a given country
+    // check if a currency is valid today for a country
     $isOk = Currencies::isValidInCountry('CH', 'CHF');
     // true
 
-    // Check if a currency is valid in *any* country on a specific date
+    // check if a currency is valid in any country on a specific date
     $isGlobal = Currencies::isValidInAnyCountry(
         'USD',
         legalTender: true,
@@ -344,9 +348,14 @@ validate currencies in relation to countries. These methods use ICU metadata
     );
     // true
 
-Note that some currencies (especially non-legal-tender ones) do not have validity ranges defined.
-In such cases, a ``RuntimeException`` will be thrown.
-In addition, an ``InvalidArgumentException`` will be thrown if the specified currency is invalid.
+Note that some currencies (especially non-legal-tender ones) do not have validity
+ranges defined. In such cases, a ``RuntimeException`` will be thrown. In addition,
+an ``InvalidArgumentException`` will be thrown if the specified currency is invalid.
+
+.. versionadded:: 7.4
+
+    The ``forCountry()``, ``isValidInCountry()`` and ``isValidInAnyCountry()``
+    methods were introduced in Symfony 7.4.
 
 .. _component-intl-timezones: