Add references to LocaleCanonicalizer (unicode-org#5306)

sffc · Sep 23, 2024 · 7fa33d8 · 7fa33d8
1 parent 6356389
commit 7fa33d8
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 4 deletions.
diff --git 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
@@ -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
 ///