Reworded the entire explanation

javiereguiluz · javiereguiluz · commit 54155145c339 · 2021-04-14T15:37:26.000+02:00
diff --git a/components/intl.rst b/components/intl.rst
@@ -262,33 +262,40 @@ as some of their information (symbol, fraction digits, etc.)::
     $symbol = Currencies::getSymbol('INR');
     // => '₹'
 
-    // number of digits to display when formatting numbers with this currency;
-    // see getCashFractionDigits() to format values used in cash transactions
-    $fractionDigits = Currencies::getFractionDigits('INR');
-    // => 2
-
-    // numbers formatted in this currency should be rounded to the nearest
-    // increment of this value (e.g. some countries round values to 5 cents);
-    // see getCashRoundingIncrement() for the rounding rules of cash transactions
-    $roundingIncrement = Currencies::getRoundingIncrement('INR');
-    // => 0
-
-    // number of digits to display when numbers are used to indicate cash transactions;
-    // see getFractionDigits() to format numbers for other use cases (e.g. accounting)
-    $cashFractionDigits = Currencies::getCashFractionDigits('INR');
-    // => 2
-
-    // cash transactions in this currency must be rounded to the nearest increment
-    // of this value (e.g. some countries round to 5 cents because they have
-    // eliminated 1-cent and 2-cent coins);
-    // see getRoundingIncrement() for the rounding rules of other use cases (e.g. accounting)
-    $cashRoundingIncrement = Currencies::getCashRoundingIncrement('INR');
-    // => 0
+The fraction digits methods return the number of digits to display when
+formatting numbers with this currency. Depending on the currency, this value
+can change if the number is used in cash transactions or in other scenarios
+(e.g. accounting)::
+
+    // Indian rupee defines the same value for both
+    $fractionDigits = Currencies::getFractionDigits('INR');         // returns: 2
+    $cashFractionDigits = Currencies::getCashFractionDigits('INR'); // returns: 2
+
+    // Swedish krona defines different values
+    $fractionDigits = Currencies::getFractionDigits('SEK');         // returns: 2
+    $cashFractionDigits = Currencies::getCashFractionDigits('SEK'); // returns: 0
+
+.. versionadded:: 5.3
+
+    The ``getCashFractionDigits()`` method was introduced in Symfony 5.3.
+
+Depending on the currency, numbers must be formatted to the nearest increment
+of some value (e.g. 5 cents). This increment might be different if numbers are
+formatted for cash transactions or other scenarios (e.g. accounting)::
+
+    // Indian ruppee defines the same value for both
+    $roundingIncrement = Currencies::getRoundingIncrement('INR');         // returns: 0
+    $cashRoundingIncrement = Currencies::getCashRoundingIncrement('INR'); // returns: 0
+
+    // Canadian dollar defines different values because they have eliminated
+    // the smaller coins (1-cent and 2-cent) and prices in cash must be rounded to
+    // 5 cents (e.g. if price is 7,42 you pay 7,40; if price is 7,48 you pay 7,50)
+    $roundingIncrement = Currencies::getRoundingIncrement('CAD');         // returns: 0
+    $cashRoundingIncrement = Currencies::getCashRoundingIncrement('CAD'); // returns: 5
 
 .. versionadded:: 5.3
 
-    The ``getCashFractionDigits()`` and ``getCashRoundingIncrement()`` methods
-    were introduced in Symfony 5.3.
+    The ``getCashRoundingIncrement()`` method was introduced in Symfony 5.3.
 
 All methods (except for ``getFractionDigits()``, ``getCashFractionDigits()``,
 ``getRoundingIncrement()`` and ``getCashRoundingIncrement()``) accept the
