From 927ddcaac577f69256ceae8e1de97c4d65ebd8b9 Mon Sep 17 00:00:00 2001 From: Mark Davis Date: Thu, 12 Sep 2024 18:25:57 -0700 Subject: [PATCH 1/3] CLDR-17505 Fix blocking items --- docs/ldml/tr35.md | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/docs/ldml/tr35.md b/docs/ldml/tr35.md index c68f106d62c..89332340b7f 100644 --- a/docs/ldml/tr35.md +++ b/docs/ldml/tr35.md @@ -1932,7 +1932,21 @@ The following describes in more detail how to determine the exact inheritance of #### Definitions -_Blocking_ elements are those whose subelements do not inherit from parent locales. For example, a `` element is a blocking element: everything in a `` element is treated as a single lump of data, as far as inheritance is concerned. For more information, see [Valid Attribute Values](#Valid_Attribute_Values). +_Ordered_ elements are those whose sequence in the XML file is important; that is, reversing the order of those elements makes a difference in the interpretation of the data. These are marked with the `@ORDRED` annotation in the dtd file. For example, consider the following in `ldmlSupplemental.dtd`: +``` + + +``` +In the file languageInfo.xml, we find the following. +``` + +… + + +``` +The ordering among the languageMatch items is important, because the *_* must only be matched after all the explicit scripts have been. + +The ordered elements also _block_ inheritance in files governed by ldml.dtd. That is, because the elements are ordered, there is no way to tell where an inherited element from a parent locale would be in that sequence. Attributes that serve to distinguish multiple elements at the same level are called _distinguishing_ attributes. For example, the `type` attribute distinguishes different elements in lists of translations, such as: From 5e0df5cbd5d7a0f10183df3821d1a4338e31cf9f Mon Sep 17 00:00:00 2001 From: Mark Davis Date: Thu, 12 Sep 2024 18:29:13 -0700 Subject: [PATCH 2/3] CLDR-17505 Tweak text --- docs/ldml/tr35.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/ldml/tr35.md b/docs/ldml/tr35.md index 89332340b7f..65e2cf5ed71 100644 --- a/docs/ldml/tr35.md +++ b/docs/ldml/tr35.md @@ -1937,14 +1937,14 @@ _Ordered_ elements are those whose sequence in the XML file is important; that i ``` -In the file languageInfo.xml, we find the following. +In the file `languageInfo.xml`, we find the following. ``` ``` -The ordering among the languageMatch items is important, because the *_* must only be matched after all the explicit scripts have been. +The ordering among the languageMatch items is important, because the `*_*` must only be matched _after_ all the explicit scripts have been. The ordered elements also _block_ inheritance in files governed by ldml.dtd. That is, because the elements are ordered, there is no way to tell where an inherited element from a parent locale would be in that sequence. From 4508db95d4878775e0e101f5f696e25f4165de1c Mon Sep 17 00:00:00 2001 From: Mark Davis Date: Thu, 12 Sep 2024 18:32:05 -0700 Subject: [PATCH 3/3] CLDR-17505 Further tweaks --- docs/ldml/tr35.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/ldml/tr35.md b/docs/ldml/tr35.md index 65e2cf5ed71..f88712df4d5 100644 --- a/docs/ldml/tr35.md +++ b/docs/ldml/tr35.md @@ -1932,7 +1932,7 @@ The following describes in more detail how to determine the exact inheritance of #### Definitions -_Ordered_ elements are those whose sequence in the XML file is important; that is, reversing the order of those elements makes a difference in the interpretation of the data. These are marked with the `@ORDRED` annotation in the dtd file. For example, consider the following in `ldmlSupplemental.dtd`: +_Ordered_ elements are those whose sequence in the XML file is important; that is, changing the order of those elements can make a difference in the interpretation of the data. These are marked with the `@ORDRED` annotation in the dtd file. For example, consider the following in `ldmlSupplemental.dtd`: ``` @@ -1944,9 +1944,9 @@ In the file `languageInfo.xml`, we find the following. ``` -The ordering among the languageMatch items is important, because the `*_*` must only be matched _after_ all the explicit scripts have been. +The ordering among the `languageMatch` items is important, because the `*_*` must only be matched _after_ all the explicit scripts have been. -The ordered elements also _block_ inheritance in files governed by ldml.dtd. That is, because the elements are ordered, there is no way to tell where an inherited element from a parent locale would be in that sequence. +The ordered elements also _block_ inheritance in files governed by `ldml.dtd`. That is, because the elements are ordered, there is no way to tell where an inherited element from a parent locale would be in that sequence. Attributes that serve to distinguish multiple elements at the same level are called _distinguishing_ attributes. For example, the `type` attribute distinguishes different elements in lists of translations, such as: