Creating the Archive

A number of the tools in CLDR depend on access to older versions. These tools include:

• Generating Charts

• Update Validity XML

• Updating English/Root

  • [Note: add others when we find them]

  • Some tests (when run under exhaustive mode)

    • TestCompatibility.java

    • TestTransforms.java

    • TestValidity.java

  • Some other tools (typically when given a version argument on the command line)

    • FindPluralDifferences

    • ...

Here's how to do that.

1. Create an archive directory. Simplest is if it on the same level as your local CLDR repository, eg …/workspace/cldr-archive

2. Open up ToolConstants.java and look at ToolConstants.CLDR_VERSIONS. You'll see something like:

• • 1. public static final List<String> CLDR_VERSIONS = ImmutableList.of(

    2. "1.1.1",

    3. "1.2",

    4. "1.3",

    5. "1.4.1",

    6. "1.5.1",

    7. "1.6.1",

    8. "1.7.2",

    9. "1.8.1",

    10. ...

    11. "38.1"

    12. // add to this once the release is final!

    13. );

• • 1. NOTE: this should also match CldrVersion.java (those two need to be merged together)

1. For some tools, you will need a directory that matches everyone one of these constants. For others, you will just need the latest released version. The documentation of the tool should let you know what you need. The list is updated with each new release, so the first time you run the tool in question after a release you'll get an error message if you need to add a directory.

2. To add a directory, such as "27"

   1. Go to the public release, eg http://unicode.org/Public/cldr/27/

   2. The files you need are in core.zip (possibly split into cldr-common-*.zip and cldr-keyboards*.zip), so unzip it.

   3. Create a folder cldr-archive/27.0

   4. Copy the common and keyboards directories from the unzipped directory into the that new directory.

   5. Create an ARCHIVE environment variable for use with the tools, and set it to the name you use, eg …/workspace/cldr-archive

The end result (where you need all of the releases) looks something like the following: