readme.txt
1CLDR Tools ReadMe
2-----------------
3
4The tools folder will contain tools, tests, and utilities for dealing with CLDR data.
5The code is very preliminary, so don't expect stability from the APIs (or documentation!),
6since we still have to work out how we want to do the architecture.
7
8See: http://cldr.unicode.org/development/new-cldr-developers
9
10The directory structure is:
11[./org/unicode/cldr..]
12icu Tools for generating ICU-format data from CLDR
13posix Tools for generating POSIX-format data from CLDR
14test Test tools for CLDR
15json Tools for creating JSON data from CLDR
16tool Tools for manipulating CLDR files
17util Utilities for handling CLDR files
18ooo OpenOffice.org tools for :
19 - Converting OpenOffice.org format to LDML
20 - CLDR data to OpenOffice.org format
21 - Comparing OpenOffice.org data
22-----------------
23
24The tools may use ICU4J code for testing, but should use none of the data in ICU4J.
25We'll be using the ICU4J test framework also (we looked at JUnit, but it would be
26really clumsy for the ways in which we'd have to test).
27
28
29TO BUILD AND RUN THE TOOLS:
30
31 See http://cldr.unicode.org/tools
32
33ADVANCED USAGE:
34
351. Build the tools with the following command:
36
37 ant clean all jar
38
392. For a list of build targets use the following command:
40
41 ant -projecthelp
42
433. For running automated and console tests, you will want to create a 'build.properties' file.
44
45 If you checked out CLDR as one directory (i.e. there is a ../../common relative to this readme),
46 then create build.properties containing:
47
48 CLDR_DIR=../..
49
50 Otherwise, if inside of an eclipse workspace (i.e. there is a ../common relative to this readme),
51 this may work for you:
52
53 CLDR_DIR=..
54
55CLDR TOOL DEVELOPMENT ON ECLIPSE IDE
56
57 Eclipse project files are available for CLDR Tools development.
58 To set up the environment on Eclipse IDE, see the link:
59
60 http://cldr.unicode.org/development/new-cldr-developers
61