From 7fa33d833bb0c0ef6fc614cd2a739b0b1a0d0443 Mon Sep 17 00:00:00 2001 From: "Shane F. Carr" Date: Mon, 23 Sep 2024 12:05:27 -0700 Subject: [PATCH] Add references to LocaleCanonicalizer (#5306) --- components/locale_core/src/langid.rs | 6 ++++-- components/locale_core/src/locale.rs | 5 +++-- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/components/locale_core/src/langid.rs b/components/locale_core/src/langid.rs index 47ac9a392fb..13a18153cf2 100644 --- a/components/locale_core/src/langid.rs +++ b/components/locale_core/src/langid.rs @@ -26,8 +26,10 @@ use writeable::Writeable; /// At the moment parsing normalizes a well-formed language identifier converting /// `_` separators to `-` and adjusting casing to conform to the Unicode standard. /// -/// Any bogus subtags will cause the parsing to fail with an error. -/// No subtag validation is performed. +/// Any syntactically invalid subtags will cause the parsing to fail with an error. +/// +/// This operation normalizes syntax to be well-formed. No legacy subtag replacements is performed. +/// For validation and canonicalization, see `LocaleCanonicalizer`. /// /// # Ordering /// diff --git a/components/locale_core/src/locale.rs b/components/locale_core/src/locale.rs index a14d578df27..e70bf1a19c3 100644 --- a/components/locale_core/src/locale.rs +++ b/components/locale_core/src/locale.rs @@ -33,9 +33,10 @@ use writeable::Writeable; /// At the moment parsing normalizes a well-formed locale identifier converting /// `_` separators to `-` and adjusting casing to conform to the Unicode standard. /// -/// Any bogus subtags will cause the parsing to fail with an error. +/// Any syntactically invalid subtags will cause the parsing to fail with an error. /// -/// No subtag validation or alias resolution is performed. +/// This operation normalizes syntax to be well-formed. No legacy subtag replacements is performed. +/// For validation and canonicalization, see `LocaleCanonicalizer`. /// /// # Ordering ///