diff --git a/tools/cldr/cldr-to-icu/build-icu-data.xml b/tools/cldr/cldr-to-icu/build-icu-data.xml
index 2e1e3ceb32..82b00f331a 100644
--- a/tools/cldr/cldr-to-icu/build-icu-data.xml
+++ b/tools/cldr/cldr-to-icu/build-icu-data.xml
@@ -196,104 +196,116 @@
+ languages, this isn't a big deal).
+
+ As well as allowing some data directories to have a subset of available data (via
+ the element) there are also mechanisms for controlling aliasing and
+ the locale parent relation which allows the sharing of some ICU data in cases
+ where it would otherwise need to be copied. The two mechanisms are:
+
+ 1: inheritLanguageSubtag: Used to rewrite the parent of a locale ID from "root" to
+ its language subtag (e.g. "zh_Hant" has a natural parent of "root", but to allow
+ some base language data to be shared it can be made to have a parent of "zh").
+
+ 2: forcedAlias: Used to add aliases for specific directories in order to affect the
+ ICU behaviour in special cases.
+
+ Between them these mechanisms are known as "tailorings" of the affected locales. -->
-
- root,
+
+
+
+
+
+
+
- // A-B
- af, am, ars, ar, as, az, be, bg, bn, bo, bs_Cyrl, bs,
+
+ root,
- // C-F
- ca, ceb, chr, cs, cy, da, de_AT, de, dsb, dz, ee, el, en,
- en_US_POSIX, en_US, eo, es, et, fa_AF, fa, fil, fi, fo, fr_CA, fr,
+ // A-B
+ af, am, ars, ar, as, az, be, bg, bn, bo, bs_Cyrl, bs,
- // G-J
- ga, gl, gu, ha, haw, he, hi, hr, hsb, hu, hy,
- id_ID, id, ig, in, in_ID, is, it, iw_IL, iw, ja,
+ // C-F
+ ca, ceb, chr, cs, cy, da, de_AT, de, dsb, dz, ee, el, en,
+ en_US_POSIX, en_US, eo, es, et, fa_AF, fa, fil, fi, fo, fr_CA, fr,
- // K-P
- ka, kk, kl, km, kn, kok, ko, ku, ky, lb, lkt, ln, lo, lt, lv,
- mk, ml, mn, mo, mr, ms, mt, my, nb, ne, nl, nn, no_NO, no,
- om, or, pa_IN, pa, pa_Guru, pl, ps, pt,
+ // G-J
+ ga, gl, gu, ha, haw, he, hi, hr, hsb, hu, hy,
+ id_ID, id, ig, in, in_ID, is, it, iw_IL, iw, ja,
- // R-T
- ro, ru, se, sh_BA, sh_CS, sh, sh_YU, si, sk, sl, smn, sq,
- sr_BA, sr_Cyrl_ME, sr_Latn, sr_ME, sr_RS, sr, sv, sw,
- ta, te, th, tk, to, tr,
+ // K-P
+ ka, kk, kl, km, kn, kok, ko, ku, ky, lb, lkt, ln, lo, lt, lv,
+ mk, ml, mn, mo, mr, ms, mt, my, nb, ne, nl, nn, no_NO, no,
+ om, or, pa_IN, pa, pa_Guru, pl, ps, pt,
- // U-Z
- ug, uk, ur, uz, vi, wae, wo, xh, yi, yo, yue_CN, yue_Hans,
- yue, zh_CN, zh_Hant, zh_HK, zh_MO, zh_SG, zh_TW, zh, zu
-
+ // R-T
+ ro, ru, se, sh_BA, sh_CS, sh, sh_YU, si, sk, sl, smn, sq,
+ sr_BA, sr_Cyrl_ME, sr_Latn, sr_ME, sr_RS, sr, sv, sw,
+ ta, te, th, tk, to, tr,
-
- root,
+ // U-Z
+ ug, uk, ur, uz, vi, wae, wo, xh, yi, yo, yue_CN, yue_Hans,
+ yue, zh_CN, zh_Hant, zh_HK, zh_MO, zh_SG, zh_TW, zh, zu
+
+
- // A-E
- af, ak, am, ars, ar, az, be, bg, bs, ca, ccp, chr, cs, cy,
- da, de_CH, de, ee, el, en_001, en_IN, en, eo, es_419, es_DO,
- es_GT, es_HN, es_MX, es_NI, es_PA, es_PR, es_SV, es, es_US, et,
+
+
+
+
- // F-P
- fa_AF, fa, ff, fil, fi, fo, fr_BE, fr_CH, fr, ga, he, hi, hr,
- hu, hy, id, in, is, it, iw, ja, ka, kl, km, ko, ky, lb,
- lo, lrc, lt, lv, mk, ms, mt, my, nb, nl, nn, no, pl, pt_PT, pt,
+
+ root,
- // Q-Z
- qu, ro, ru, se, sh, sk, sl, sq, sr_Latn, sr, sv, sw, ta, th, tr,
- uk, vi, yue_Hans, yue, zh_Hant_HK, zh_Hant, zh_HK, zh_MO, zh_TW, zh
-
+ // A-E
+ af, ak, am, ars, ar, az, be, bg, bs, ca, ccp, chr, cs, cy,
+ da, de_CH, de, ee, el, en_001, en_IN, en, eo, es_419, es_DO,
+ es_GT, es_HN, es_MX, es_NI, es_PA, es_PR, es_SV, es, es_US, et,
-
- root,
- de, el, en, en_US_POSIX, en_US, es, fr, it, ja, pt, ru, zh_Hant, zh
-
+ // F-P
+ fa_AF, fa, ff, fil, fi, fo, fr_BE, fr_CH, fr, ga, he, hi, hr,
+ hu, hy, id, in, is, it, iw, ja, ka, kl, km, ko, ky, lb,
+ lo, lrc, lt, lv, mk, ms, mt, my, nb, nl, nn, no, pl, pt_PT, pt,
-
+ // Q-Z
+ qu, ro, ru, se, sh, sk, sl, sq, sr_Latn, sr, sv, sw, ta, th, tr,
+ uk, vi, yue_Hans, yue, zh_Hant_HK, zh_Hant, zh_HK, zh_MO, zh_TW, zh
+
+
+
+
+
+ root,
+ de, el, en, en_US_POSIX, en_US, es, fr, it, ja, pt, ru, zh_Hant, zh
+
+
+ generate an alias in order to affect "sideways inheritance" for spoken languages,
+ and at some stage it should probably be supported properly in the CLDR data. -->
-
-
-
-
-
-
-
-
-
-
-
-
-
+