Schedule (Tentative)

Date Phase
02.10 v21.0 Released
02.29 v22 Data Submission Starts
06.22 v22 Release
For details, see Release Schedule.
See also Notification Services.

Generating Charts

Generate

Set version in ShowLanguages.CHART_DISPLAY_VERSION to the current version (eg 1.7, or 1.8draft).

You run a number of different programs. The results for each will be in ...cldr-tmp/diff/by_type/names.currency.html and so on. The parameters you need are listed below.

After running each program:
  1. Spot-Sanity check (diffing with existing).
  2. Check into SVN.
  3. This will automatically cause them to show up on the web at: http://unicode.org/repos/cldr-tmp/trunk/diff/
If some files are not rebuilt, delete them: except for *.css, and index.html
  1. Supplemental Data Charts
    1. Run ShowLanguages -DSHOW_FILES to regenerate the supplemental.html charts 
    2. Then do the bcp47 charts with GenerateBcp47Text for Draft BCP47 Extension Data (IANA Registry Style): bcp47-t.txtbcp47-u.txt.
    3. These will generate charts in {cldrdata}\diff\supplemental\...
    4. Sample: ...diff/supplemental/language_territory_information.html
  2. By-Type Charts using tool/GenerateSidewaysView
    1. Sample: ...diff/by_type/names.currency.html
  3. Summary Charts with tool/ShowData
    1. Sample: ...diff/summary/de.html
    2. If it goes too slowly, use the flag -m[a-m]*, then run again with -m[n-z]*
  4. Transform Charts with tool/GenerateTransformCharts
    1. Sample: ...diff/transforms/index.html
    2. If there is a failure, it is often because of a missing dependency. Goto CLDRTransforms.DependencyOrder, and add an item there. Example: 
      1. addDependency("Latin-Bopomofo", "Latin-NumericPinyin");

Old Charts

These are old, don't build

  1. diff/main
  2. diff/collation
  3. Error Reports with test/ConsoleCheckCLDR -g
  4. Change Charts with tool/GenerateComparison

Parameters

[changing /Users/markdavis/Documents/workspace/... to whatever is appropriate on the machine]

-Dfile.encoding=UTF-8
-Xmx1000M
-DSHOW_FILES
-DSHOW
-DCLDR_DIR=/Users/markdavis/Documents/workspace/cldr/src/
-DCLDR_MAIN=/Users/markdavis/Documents/workspace/cldr-archive/cldr-2.0.0/common/main/

Note the last line: use a specific directory like that if you are not generating from trunk.

GenerateComparison has additional parameters:
  • The oldDirectory is where the sources are for the last major release (eg it would be 1.7 for 1.8.0 or 1.8.1). If they are not present on the machine, you can get from the right zip file, like http://unicode.org/Public/cldr/1.6.1/core.zip
  • The newDirectory is where the proposed/main files are.
  • The changesDirectory (where the output is to go).
Sample:

-DoldDirectory=/Users/markdavis/Documents/workspace/common-cldr1.6/main
-DnewDirectory=/Users/markdavis/Documents/workspace/cldr/src/incoming/vetted/main
-DchangesDirectory=/Users/markdavis/Documents/workspace/cldr/src/diff/changes


Modifying the chart programs

The chart programs have grown over time, and need some cleanup. For example, the supplemental charts duplicate code that is now in SupplementalDataInfo. 

ShowLanguages. The messages that they use are in a file util/data/chart_messages.html. The right cell contains the key, which is extracted by lines like:

      PrintWriter pw = new PrintWriter(new FormattedFileWriter(index, "Zone \u2192 Tzid", null));

The key will be zone_tzid, in this case.