Compiled constructor docs

components/calendar/src/any_calendar.rs

@@ -413,7 +413,7 @@ impl Calendar for AnyCalendar {
 }
 
 impl AnyCalendar {
-    /// Constructs an AnyCalendar for a given calendar kind.
+    /// Constructs an AnyCalendar for a given calendar kind from compiled data.
     ///
     /// As this requires a valid [`AnyCalendarKind`] to work, it does not do any kind of locale-based
     /// fallbacking. If this is desired, use [`Self::new_for_locale()`].
@@ -545,7 +545,7 @@ impl AnyCalendar {
         })
     }
 
-    /// Constructs an AnyCalendar for a given calendar kind.
+    /// Constructs an AnyCalendar for a given calendar kind from compiled data.
     ///
     /// In case the locale's calendar is unknown or unspecified, it will attempt to load the default
     /// calendar for the locale, falling back to gregorian.

components/calendar/src/japanese.rs

@@ -110,7 +110,7 @@ pub struct JapaneseDateInner {
 }
 
 impl Japanese {
-    /// Creates a new [`Japanese`] using only modern eras (post-meiji).
+    /// Creates a new [`Japanese`] using only modern eras (post-meiji) from compiled data.
     ///
     /// ✨ *Enabled with the `compiled_data` Cargo feature.*
     ///
@@ -136,10 +136,10 @@ impl Japanese {
 
     #[doc = icu_provider::gen_any_buffer_unstable_docs!(UNSTABLE, Self::new)]
     pub fn try_new_unstable<D: DataProvider<JapaneseErasV1Marker> + ?Sized>(
-        data_provider: &D,
+        provider: &D,
     ) -> Result<Self, CalendarError> {
         Ok(Self {
-            eras: data_provider.load(Default::default())?.take_payload()?,
+            eras: provider.load(Default::default())?.take_payload()?,
         })
     }
 
@@ -167,7 +167,7 @@ impl Japanese {
 }
 
 impl JapaneseExtended {
-    /// Creates a new [`Japanese`] from using all eras (including pre-meiji).
+    /// Creates a new [`Japanese`] from using all eras (including pre-meiji) from compiled data.
     ///
     /// ✨ *Enabled with the `compiled_data` Cargo feature.*
     ///
@@ -193,13 +193,10 @@ impl JapaneseExtended {
 
     #[doc = icu_provider::gen_any_buffer_unstable_docs!(UNSTABLE, Self::new)]
     pub fn try_new_unstable<D: DataProvider<JapaneseExtendedErasV1Marker> + ?Sized>(
-        data_provider: &D,
+        provider: &D,
     ) -> Result<Self, CalendarError> {
         Ok(Self(Japanese {
-            eras: data_provider
-                .load(Default::default())?
-                .take_payload()?
-                .cast(),
+            eras: provider.load(Default::default())?.take_payload()?.cast(),
         }))
     }
 }

components/calendar/src/week_of.rs

@@ -46,7 +46,7 @@ impl WeekCalculator {
         locale: include,
         options: skip,
         error: CalendarError,
-        /// Creates a new [`WeekCalculator`] from locale data.
+        /// Creates a new [`WeekCalculator`] from compiled locale data.
     );
 
     #[doc = icu_provider::gen_any_buffer_unstable_docs!(UNSTABLE, Self::try_new)]

components/collator/src/comparison.rs

@@ -68,7 +68,7 @@ pub struct Collator {
 }
 
 impl Collator {
-    /// Instantiates a collator for a given locale with the given options
+    /// Creates a collator for the given locale and options from compiled data.
     #[cfg(feature = "compiled_data")]
     pub fn try_new(locale: &DataLocale, options: CollatorOptions) -> Result<Self, CollatorError> {
         Self::try_new_unstable_internal(
@@ -99,7 +99,7 @@ impl Collator {
 
     #[doc = icu_provider::gen_any_buffer_unstable_docs!(UNSTABLE, Self::try_new)]
     pub fn try_new_unstable<D>(
-        data_provider: &D,
+        provider: &D,
         locale: &DataLocale,
         options: CollatorOptions,
     ) -> Result<Self, CollatorError>
@@ -115,18 +115,18 @@ impl Collator {
             + ?Sized,
     {
         Self::try_new_unstable_internal(
-            data_provider,
-            data_provider.load(Default::default())?.take_payload()?,
-            data_provider.load(Default::default())?.take_payload()?,
-            data_provider.load(Default::default())?.take_payload()?,
-            || data_provider.load(Default::default())?.take_payload(),
+            provider,
+            provider.load(Default::default())?.take_payload()?,
+            provider.load(Default::default())?.take_payload()?,
+            provider.load(Default::default())?.take_payload()?,
+            || provider.load(Default::default())?.take_payload(),
             locale,
             options,
         )
     }
 
     fn try_new_unstable_internal<D>(
-        data_provider: &D,
+        provider: &D,
         decompositions: DataPayload<CanonicalDecompositionDataV1Marker>,
         tables: DataPayload<CanonicalDecompositionTablesV1Marker>,
         jamo: DataPayload<CollationJamoV1Marker>,
@@ -150,20 +150,20 @@ impl Collator {
         };
 
         let metadata_payload: DataPayload<crate::provider::CollationMetadataV1Marker> =
-            data_provider.load(req)?.take_payload()?;
+            provider.load(req)?.take_payload()?;
 
         let metadata = metadata_payload.get();
 
         let tailoring: Option<DataPayload<crate::provider::CollationDataV1Marker>> =
             if metadata.tailored() {
-                Some(data_provider.load(req)?.take_payload()?)
+                Some(provider.load(req)?.take_payload()?)
             } else {
                 None
             };
 
         let reordering: Option<DataPayload<crate::provider::CollationReorderingV1Marker>> =
             if metadata.reordering() {
-                Some(data_provider.load(req)?.take_payload()?)
+                Some(provider.load(req)?.take_payload()?)
             } else {
                 None
             };
@@ -175,10 +175,10 @@ impl Collator {
         }
 
         let root: DataPayload<CollationDataV1Marker> =
-            data_provider.load(Default::default())?.take_payload()?;
+            provider.load(Default::default())?.take_payload()?;
 
         let tailored_diacritics = metadata.tailored_diacritics();
-        let diacritics: DataPayload<CollationDiacriticsV1Marker> = data_provider
+        let diacritics: DataPayload<CollationDiacriticsV1Marker> = provider
             .load(if tailored_diacritics {
                 req
             } else {

components/datetime/src/any/date.rs

@@ -68,6 +68,10 @@ impl DateFormatter {
     /// This method will pick the calendar off of the locale; and if unspecified or unknown will fall back to the default
     /// calendar for the locale. See [`AnyCalendarKind`] for a list of supported calendars.
     ///
+    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
+    ///
+    /// [📚 Help choosing a constructor](icu_provider::constructors)
+    ///
     /// # Examples
     ///
     /// ```
@@ -96,10 +100,6 @@ impl DateFormatter {
     ///     "Sep 1, 2020"
     /// );
     /// ```
-    ///
-    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
-    ///
-    /// [📚 Help choosing a constructor](icu_provider::constructors)
     #[inline(never)]
     #[cfg(feature = "compiled_data")]
     pub fn try_new_with_length(

components/datetime/src/any/datetime.rs

@@ -118,6 +118,10 @@ impl DateTimeFormatter {
     /// This method will pick the calendar off of the locale; and if unspecified or unknown will fall back to the default
     /// calendar for the locale. See [`AnyCalendarKind`] for a list of supported calendars.
     ///
+    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
+    ///
+    /// [📚 Help choosing a constructor](icu_provider::constructors)
+    ///
     /// # Examples
     ///
     /// ```
@@ -268,6 +272,10 @@ impl DateTimeFormatter {
 
     /// Constructor that supports experimental options with compiled data.
     ///
+    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
+    ///
+    /// [📚 Help choosing a constructor](icu_provider::constructors)
+    ///
     /// <div class="stab unstable">
     /// 🚧 This code is experimental; it may change at any time, in breaking or non-breaking ways,
     /// including in SemVer minor releases. It can be enabled with the "experimental" Cargo feature

components/datetime/src/any/zoned_datetime.rs

@@ -127,6 +127,10 @@ impl ZonedDateTimeFormatter {
     /// This method will pick the calendar off of the locale; and if unspecified or unknown will fall back to the default
     /// calendar for the locale. See [`AnyCalendarKind`] for a list of supported calendars.
     ///
+    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
+    ///
+    /// [📚 Help choosing a constructor](icu_provider::constructors)
+    ///
     /// # Examples
     ///
     /// ```
@@ -163,10 +167,6 @@ impl ZonedDateTimeFormatter {
     ///     "April 2021, 16:12 GMT-07:00"
     /// );
     /// ```
-    ///
-    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
-    ///
-    /// [📚 Help choosing a constructor](icu_provider::constructors)
     #[cfg(feature = "experimental")]
     #[cfg(feature = "compiled_data")]
     pub fn try_new_experimental(
@@ -276,6 +276,10 @@ impl ZonedDateTimeFormatter {
     /// This method will pick the calendar off of the locale; and if unspecified or unknown will fall back to the default
     /// calendar for the locale. See [`AnyCalendarKind`] for a list of supported calendars.
     ///
+    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
+    ///
+    /// [📚 Help choosing a constructor](icu_provider::constructors)
+    ///
     /// # Examples
     ///
     /// ```
@@ -311,10 +315,6 @@ impl ZonedDateTimeFormatter {
     ///     "Apr 8, 2021, 4:12:37 PM GMT-07:00"
     /// );
     /// ```
-    ///
-    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
-    ///
-    /// [📚 Help choosing a constructor](icu_provider::constructors)
     #[cfg(feature = "compiled_data")]
     pub fn try_new(
         locale: &DataLocale,