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 ///