Fix obsolete documentation

https://github.com/dart-lang/intl/issues/202

PiperOrigin-RevId: 280266302
diff --git a/lib/src/intl/number_format.dart b/lib/src/intl/number_format.dart
index c92560b..25d4454 100644
--- a/lib/src/intl/number_format.dart
+++ b/lib/src/intl/number_format.dart
@@ -10,8 +10,9 @@
 /// the appropriate pattern (e.g. currency)
 typedef _PatternGetter = String Function(NumberSymbols);
 
-/// Provides the ability to format a number in a locale-specific way. The
-/// format is specified as a pattern using a subset of the ICU formatting
+/// Provides the ability to format a number in a locale-specific way.
+///
+/// The format is specified as a pattern using a subset of the ICU formatting
 /// patterns.
 ///
 /// - `0` A single digit
@@ -28,23 +29,25 @@
 /// - `;` Used to separate the positive and negative patterns (if both present)
 ///
 /// For example,
+///
 ///       var f = new NumberFormat("###.0#", "en_US");
 ///       print(f.format(12.345));
-///       ==> 12.34
+///           ==> 12.34
+///
 /// If the locale is not specified, it will default to the current locale. If
 /// the format is not specified it will print in a basic format with at least
 /// one integer digit and three fraction digits.
 ///
 /// There are also standard patterns available via the special constructors.
 /// e.g.
-///       var percent = new NumberFormat.percentFormat("ar");
-///       var eurosInUSFormat = new NumberFormat.currency(locale: "en_US",
+///
+///       var percent = new NumberFormat.percentPattern("ar"); var
+///       eurosInUSFormat = new NumberFormat.currency(locale: "en_US",
 ///           symbol: "€");
-/// There are four such constructors: decimalFormat, percentFormat,
-/// scientificFormat and currencyFormat. However, at the moment,
-/// scientificFormat prints only as equivalent to "#E0" and does not take
-/// into account significant digits. The currencyFormat will default to the
-/// three-letter name of the currency if no explicit name/symbol is provided.
+///
+/// There are several such constructors available, though some of them are
+/// limited. For example, at the moment, scientificPattern prints only as
+/// equivalent to "#E0" and does not take into account significant digits.
 class NumberFormat {
   /// Variables to determine how number printing behaves.
   // TODO(alanknight): If these remain as variables and are set based on the