Merge branch '4.4' into 5.0

* 4.4:
  [#12400] Added tip about ranges in the new ICU message format
  Revert "[Transalation] Document range translation using the ICU MessageFormat"
  [Transalation] Document range translation using the ICU MessageFormat
  fix typo

Author: wouterj

setup/upgrade_major.rst

@@ -144,7 +144,7 @@ mentions of ``4.*`` to ``5.0.*``:
     }
 
 At the bottom of your ``composer.json`` file, in the ``extra`` block you can
-find a data setting for the symfony version. Make sure to also upgrade
+find a data setting for the Symfony version. Make sure to also upgrade
 this one. For instance, update it to ``5.0.*`` to upgrade to Symfony 5.0:
 
 .. code-block:: json

translation/message_format.rst

@@ -263,6 +263,27 @@ Usage of this string is the same as with variables and select::
             }
         }
 
+.. sidebar:: Using Ranges in Messages
+
+    The pluralization in the legacy Symfony syntax could be used with custom
+    ranges (e.g. have a different messages for 0-12, 12-40 and 40+). The ICU
+    message format does not have this feature. Instead, this logic should be
+    moved to PHP code::
+
+        // Instead of
+        $message = $translator->trans('balance_message', $balance);
+        // with a message like:
+        // ]-Inf,0]Oops! I'm down|]0,1000]I still have money|]1000,Inf]I have lots of money
+
+        // use three different messages for each range:
+        if ($balance < 0) {
+            $message = $translator->trans('no_money_message');
+        } elseif ($balance < 1000) {
+            $message = $translator->trans('some_money_message');
+        } else {
+            $message = $translator->trans('lots_of_money_message');
+        }
+
 Additional Placeholder Functions
 --------------------------------