From 648f486c3417f67d468d0039a1dd04e4a7d98411 Mon Sep 17 00:00:00 2001 From: Richard Gibson Date: Fri, 16 Jun 2023 20:36:49 -0400 Subject: [PATCH] Editorial: Improve the [[LocaleData]] explanation MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Use a locale for which the default calendar does not sort first alphabetically. * Use a locale that is more than just a language identifier. * Replace vague "would therefore at least include…" language with a complete Record example. --- spec/negotiation.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/spec/negotiation.html b/spec/negotiation.html index 5293bf79..be513d55 100644 --- a/spec/negotiation.html +++ b/spec/negotiation.html @@ -19,9 +19,9 @@

Internal slots of Service Constructors

- For example, an implementation of DateTimeFormat might include the language tag *"th"* in its [[AvailableLocales]] internal slot, and must (according to ) include the key *"ca"* in its [[RelevantExtensionKeys]] internal slot. - For Thai, the *"buddhist"* calendar is usually the default, but an implementation might also support the calendars *"gregory"*, *"chinese"*, and *"islamicc"* for the locale *"th"*. - The [[LocaleData]] internal slot would therefore at least include {[[th]]: {[[ca]]: « *"buddhist"*, *"gregory"*, *"chinese"*, *"islamicc"* »}}. + For example, an implementation of DateTimeFormat might include the language tag *"fa-IR"* in its [[AvailableLocales]] internal slot, and must (according to ) include the keys *"ca"*, *"hc"*, and *"nu"* in its [[RelevantExtensionKeys]] internal slot. + The default calendar for that locale is usually *"persian"*, but an implementation might also support *"gregory"*, *"islamic"*, and *"islamic-civil"*. + The Record in the DateTimeFormat [[LocaleData]] internal slot would therefore include a [[fa-IR]] field whose value is a Record like { [[ca]]: « *"persian"*, *"gregory"*, *"islamic"*, *"islamic-civil"* », [[hc]]: « … », [[nu]]: « … » }, along with other locale-named fields having the same value shape but different elements in their Lists.