Merge pull request #5714 from alexischr/update_bockbuild

[mono.git] / tools / locale-builder / README

diff --git a/tools/locale-builder/README b/tools/locale-builder/README
index 7c5d00cb02623a1b4e4ab9e31757995aa548807b..700ddbb26a11322a305ff0555132a8c437e90ef1 100644 (file)
--- a/tools/locale-builder/README
+++ b/tools/locale-builder/README
@@ -5,14 +5,16 @@
 
 * input resources
 
-       There is only an external resource: unicode CLDR. I used version 1.7, the latest one as of
-       May, 2009:
-       http://unicode.org/Public/cldr/1.7.0/core.zip
+       There is only an external resource: unicode CLDR. It can be downloaded from
+       http://www.unicode.org/Public/cldr/
 
-       There is a couple of extra mono resources included in this directory:
-       - lcids.xml for LCIDs.
-       - textinfos.xml for TextInfo.
-       - supplementalData.xml and supp/*.xml for .NET(Windows)-ism fixup.
+       CLDR specificatin can be found at http://www.unicode.org/reports/tr35/
+
+       All content has to me extracted into CLDR folder. The latest version used is 30.0.2.
+
+       There is an extra mono resource included in this directory called lcids.xml for LCIDs. It's
+       extracted from National Language Support (NLS) API Reference.
+       http://msdn.microsoft.com/en-us/goglobal/bb896001.aspx
 
 * generated file
 
@@ -36,4 +38,16 @@
        In each entry, strings are extracted to locale_strings table, and in each structure they are
        represented as an index to the string.
 
+* updating the data
+
+       Update Makefile.am to get the latest CLDR data. However, CLDR is not complete and
+       it's missing data for many rarely used cultures. In such cases we provide empty value
+       but when someone has the knowleadge what the values should be it's recommended to
+       use online CLDR tool to fill the data gap.
+
+       To create the files used by the runtime after an update, run:
+               make culture-table
+               make install-culture-table
+
+       At the start of Makefile.am there are additional instructions for specific builds.