Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / cldr / refs/heads/odm/dev/target/13/fp5 / . / readme.html
blob: eacdf814e3ed0bd3b27c1d3d57e71491c6b8cf97 [file] [log] [blame]
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
2"http://www.w3.org/TR/html4/loose.dtd">
3<html>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]4 <head>
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]5 <meta http-equiv="Content-Type" content= "text/html; charset=utf-8">
6 <meta http-equiv="Content-Language" content="en-us">
Nikita Iashchenko9aa50ca2020-03-12 16:25:56 +0000[diff] [blame]7 <meta name="COPYRIGHT" content= "Copyright (c) 1991-2019 Unicode, Inc. All rights reserved.">
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]8 <meta name="DESCRIPTION" content= "Readme for Unicode CLDR with version number and other information.">
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]9 <title>ReadMe for Unicode CLDR</title>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]10 </head>
11
12 <body>
13 <h2>Unicode Common Locale Data Repository (CLDR)</h2>
Nikita Iashchenko008b6802020-01-06 13:03:48 +0000[diff] [blame]14 <h3>ReadMe for Unicode <abbr title="Common Locale Data Repository">CLDR</abbr> version 36.1</h3>
Nikita Iashchenko9aa50ca2020-03-12 16:25:56 +0000[diff] [blame]15 <p>Last updated: 2020-Mar-04</p>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]16
Nikita Iashchenko008b6802020-01-06 13:03:48 +0000[diff] [blame]17 <!--<p><b>Note:</b> CLDR 36.1 is in development and not recommended for use at this stage.</p>-->
18 <!--<p><b>Note:</b> This is the milestone 1 version of CLDR 36.1, intended for those wishing to do pre-release testing.
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]19 It is not recommended for production use.</p>-->
Nikita Iashchenko008b6802020-01-06 13:03:48 +0000[diff] [blame]20 <!--<p><b>Note:</b> This is a preliminary version of CLDR 36.1, intended for those wishing to do pre-release testing.
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]21 It is not recommended for production use.</p>-->
Nikita Iashchenko9aa50ca2020-03-12 16:25:56 +0000[diff] [blame]22 <!--<p><b>Note:</b> This is a pre-release candidate version of CLDR 36.1, intended for testing.
23 It is not recommended for production use.</p>-->
24 <p>This is the final release version of CLDR 36.1.</p>
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]25
26 <p><strong>Important notes for CLDR 36 and later:</strong></p>
27 <ul>
28 <li>The CLDR repository has switched from subversion to git.</li>
29 <li>Data in the main CLDR repository now includes some elements with the value “↑↑↑” indicating
30 that translators have explicitly determined that the inherited value should always be used.</li>
31 <li>To generate data in the form that was used for CLDR 35.1 and earlier, in which “↑↑↑” is
32 resolved appropriately (either removed or replaced with an apropriate value) and other minimization
33 is performed, a new tool GenerateProductionData is provided (command-line options provide the
34 ability to specify source and destination directory, among other things).</li>
35 <li>CLDR data that has been processed by GenerateProductionData is available in the parallel
36 “cldr-staging” repository.</li>
37 </ul>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]38
39 <p>For further information:</p>
40 <ul>
41 <li>Information about <a href="http://cldr.unicode.org/index/downloads">CLDR releases and downloads</a>,
42 including the data files and LDML specification associated with each release.</li>
43 <li>Information about <a href="http://cldr.unicode.org/tools">Building and running CLDR Tools</a></li>
44 </ul>
45 <p>Tools Quickstart:</p>
46 <ol>
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]47 <li>Build <code>cldr.jar</code>:<br>
Fredrik Roubert69a16642018-05-11 16:34:25 +0200[diff] [blame]48 <code><b>ant -f tools/java/build.xml jar</b></code>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]49 </li>
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]50 <li>List available tools:<br>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]51 <code><b>java -jar tools/java/cldr.jar</b></code>
52 </li>
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]53 <li>List less-than-documented tools:<br>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]54 <code><b>java -jar tools/java/cldr.jar -l</b></code>
55 </li>
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]56 <li>Run the XML Validator against some <code>file.xml</code>:<br>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]57 <code><b>java -jar tools/java/cldr.jar validate <i>../path/to/your/file.xml</i></b></code>
58 </li>
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]59 <li>Run some other tool that doesn't have a nice short alias like 'validate':<br>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]60 <code><b>java -jar tools/java/cldr.jar <i>org.unicode.cldr.draft.NormalizedIdentifierParser</i></b></code>
61 </li>
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]62 <li>Convert LDML to JSON data:<br>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]63 <code><b>java -DCLDR_DIR=<i>/path/to/cldr/data</i> -jar tools/java/cldr.jar ldml2json -r true</b></code>
64 </li>
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]65 <li>More info:<br>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]66 <a href="http://cldr.unicode.org/tools">CLDR Tools Website</a>
67 </li>
68 </ol>
69
70 <p>Licenses:</p>
71 <ul>
72 <li>Usage of CLDR data and software is governed by the <a href="http://www.unicode.org/copyright.html">Unicode Terms of Use</a>,
73 a copy of which is included as unicode-license.txt.</li>
74 <li>Some CLDR tools depend on libraries in tools/java/libs/; use of these libraries is governed by separate license agreements.
75 <ul>
76 <li>Use of the ICU libraries is subject to the
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]77 <a href="https://github.com/unicode-org/icu/blob/master/icu4j/main/shared/licenses/LICENSE">ICU License</a>,
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]78 included as ICU-LICENSE.</li>
Nikita Iashchenko85c40522019-06-13 16:15:05 +0100[diff] [blame]79 <li>Use of the Guava, Xerces, and Myanmar Tools libraries is subject to the
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]80 <a href="http://www.apache.org/licenses/LICENSE-2.0.html">Apache License</a>,
81 included as apache-license.txt.</li>
82 </ul>
83 </li>
84 </ul>
85
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]86 <hr>
Nikita Iashchenkod81a4c32020-03-05 18:12:27 +0000[diff] [blame]87 <p>Copyright &copy; 1991-2020 Unicode, Inc.<br>
Nikita Iashchenkob87fde42019-11-05 16:17:36 +0000[diff] [blame]88 All rights reserved.<br>
Fredrik Roubert333a3d82018-05-07 13:50:38 +0200[diff] [blame]89 <a href="http://www.unicode.org/copyright.html">Terms of use</a></p>
90 </body>
91</html>