Newer
Older
Name: icu
URL: http://site.icu-project.org/
License: MIT
Security Critical: yes
WARNING: The head of third_party/icu is in the middle of upgrading to ICU 54.1
and it's NOT usable for Chromium/Blink/v8.
- DO NOT deps-roll ICU to the head.
- If there is a critical change to make (e.g. security), a branch can be cut
for that. Contact <jshin@chromium.org>.
- README.chromium (this file) is NOT up to date and will be changed as the
upgrade to ICU 54.1 moves forward.
This directory contains the source code of ICU 54.1 for C/C++.
1. It was obtained with the following:
$ svn export --native-eol LF http://source.icu-project.org/repos/icu/icu/tags/release-54-1 icu
The following directories we don't use are removed:
- as_is
- packaging
- source/layout
- source/layoutex
patches/configure.patch is applied to get runConfigureICU work in the
icudata generation step without layout and layoutex directory by removing the
corresponding Makefile's from ac_config variable.
2. Apply the following patch for platform.h for NaCl.
- patches/platform_nacl.patch to add U_PF_NATIVE_CLIENT
upstream bug : http://bugs.icu-project.org/trac/ticket/11033
- Apply patches/brkitr.patch
* word.txt
a. Move full stops (U+002E, U+FF0E) from MidNumLet to MidNum so that
FQDN labels can be split at '.'
b. Move fullwidth digits (U+FF10 - U+FF19) from Ideographic to Numeric.
See http://unicode.org/cldr/trac/ticket/6555
* line.txt
a. Use Japanese rules for all locales because Japanese tailoring only
affects Japanese specific characters.
See http://unicode.org/cldr/trac/ticket/3974
b. Minor changes in CL, OP and IS definitions to handle 'comma-variants'
more consistenly.
See http://unicode.org/cldr/trac/ticket/6557
c. Fix line breaking for Chinese characters and quotation marks
See http://unicode.org/cldr/trac/ticket/4200 and
- Add a new file brklocal.mk (copied from brkfiles.mk) with line_ja.txt
and word_POSIX.txt dropped from the build list.
- Apply patches/khmer-dictbe.patch and put in a smaller Khmer dictionary
(source/data/brkitr/khmerdict.txt) obtained from
http://bugs.icu-project.org/trac/ticket/9451
jshin@chromium.org
committed
- Add several common Chinese words that were dropped previously to
source/data/cjdict/brkitr/cjdict.txt
patch: patches/cjdict.patch
upstream bug: http://bugs.icu-project.org/trac/ticket/10888
- android/brkitr.patch (to be applied for Android build only) :
Do not use the C+J dictionary for Chinese/Japanese segmentation
to reduce the data size. Adjust word.txt and a few other files.
- source/data/brkitr/word_ja.txt (used only on Android)
Added for Japanese-specific word-breaking without the C+J dictionary.
- convrtrs.txt : Replaced the original by our own that only lists encodings
and aliases required by the WHATWG Encoding spec plus a few extra (see
the file as to why).
- Add source/data/mappings/ucmlocal.txt : to list only converters we need.
- Add new tables per the WHATWG encoding standards for EUC-JP,
Shift_JIS and all the single byte encodings.
They're generated with scripts : scripts/{eucjp, sjis, single_byte}_gen.sh
a. ISO-2022-JP-[1-4] is dropped.
b. SCSU, BOCU, ISCII, UTF-7, LMB, ibm42*, ISO-2022-{KR,CN*} and HZ-GB :
converters and detectors are dropped leading to the ~100kB reduction
in the code size.
a. Exemplar character set changes for zh*, ja + 9 Indian locales
b. Minor fixes for Korean, a few Indic (AmPmMarkers) and
- Locale build configuration files: To include the full locale data
for Chrome's UI languages and the minimum locale data for other locales,
add reslocal.mk or {trns,sprep,rbnf,coll}local.mk files to
source/data/{coll,curr,lang.locale,curr,region,translit,zone,rbnf,sprep}.
This along with #8 (data.build.patch), #3 (brkiter) and #4 (converter)
cuts down the data size by ~ 11MB.
- Run scripts/trim_data.sh : About 2.1MB data size reduction.
a. Trim the locale data for Chrome's UI langauges :
locales, lang, region, currency
b. Trim the locale data for non-UI languages to the bare minimum :
ExemplarCharacters, LocaleScript, layout, and the name of the
language for a locale in its native language.
c. Remove the legacy Chinese character set-based collation
(big5han/gb2312han) that don't make any sense and nobdoy uses.
- android/patch_locale.sh (to be run for Android build only):
a. Makes changes to source/data/{curr,region,lang} to exclude these data
except the language and script names of zh_Hans and zh_Hant.
b. Remove exemplar cities in timezone data (data/zone)
c. Keep only the minimal calendar data in data/locales
- Add tg.txt to source/data/locale source/data/lang to add the minimal locale
data necessary for the spellchecker. In both directories, add tg.txt to
reslocal.mk
- Grab the latest version of the following timezone data files and
put them in source/data/misc.
metaZones.txt
timezoneTypes.txt
windowsZones.txt
zoneinfo64.txt
As of August 2014, the latest version is 2014f and the above files
http://source.icu-project.org/repos/icu/data/trunk/tzdata/icunew/2014f/44/
7. Transliterator customization
- Also add css3transform.txt to source/data/trnslit.
- Put the following line in trnslocal.mk
TRANSLIT_SOURCE=css3transform.txt
upstream bugs : http://bugs.icu-project.org/trac/ticket/8043
http://bugs.icu-project.org/trac/ticket/5701
- patches/vscomp.patch for building with Visual Studio on Windows.
a. do not use WINDOWS_LOCALE_API in locmap.c
b. do not redefine stringpiece::npos
Remove unnecessary resources : invuca, unames, collator source, stringprep
9. Pre-built data files are checked in with the following steps on Linux:
a. Make a icu data build directory outside the Chromium source tree
and cd to that directory.
${CHROME_ICU_TREE_TOP}/source/runConfigureICU Linux --disable-layout
d. 'make' will fail in the 1st pass. Copy
${CHROME_ICU_TREE_TOP}/source/data/in/coll/invuca.icu
to {BUILD_DIR_ROOT}/data/out/build/icudt52l/coll and re-run 'make'
in {BUILD_DIR_ROOT}/data.
e. 'make' will fail again when pkgdata looks for css3transform.res. Edit
data/out/tmp/icudata.lst to replace 'css3transform.res' with 'root.res'.
(see http://bugs.icu-project.org/trac/ticket/10570 ) and run 'make' again.
- source/data/in/icudtl.dat : Built on Linux with all the patches
above applied. icudt52l.dat is generated in
{BUILD_DIR_ROOT}/data/out/tmp and copied to the above location with a
- {mac,linux}/icudtl_dat.S : Built on Linux with all the
patches above (except android/brkitr.patch) applied and checked in.
This file will be generated in {BUILD_DIR_ROOT}/data/out/tmp as
icudt52l_dat.S, but '52' is dropped while copying.
mac/icudtl_dat.S is identical to linux/icudtl_dat.S except for
the header portion. With "linux/icudtl_dat.S" in its place,
run scripts/make_mac_assembly.sh to generate it.
- android/icudtl_dat.S : Built on Linux with all the patches above and
android/brkitr.patch applied and android/patch_locale.sh executed.
'52' is dropped from the name generated in the build tree.
- android/icudtl.dat : Generated as icudt52l.dat in
{BUILD_DIR_ROOT}/data/out/tmp along with icudt52l_dat.S and
copied to the above location with '52' dropped in its name.
- windows/icudt.dll (by default, we set icu_use_icu_data_flag to 1
a. check out a clean copy of icu52 from the upstream on Windows
outside the Chrome tree.
$ svn export --native-eol LF http://source.icu-project.org/repos/icu/icu/tags/release-52-1 ${SEPARATE_ICU_ROOT}/icu52
b. copy ${CHROME_ICU_ROOT}/source/data/in/icudtl.dat to
${SEPARATE_ICU_ROOT}/source/data/in/icudt52l.dat
c. copy ${CHROME_ICU_ROOT}/source/data/makedata.mak to
${SEPARATE_ICU_ROOT}/source/data/makedata.mak
c. In Visual Studio, open source/allinone/allinone.sln solution
in ${SEPARATE_ICU_ROOT}
e. icudt52.dll will be generated in ${SEPARATE_ICU_ROOT}/bin
f. Copy that icudt52.dll to ${CHROME_ICU_ROOT}/windows/icudt.dll
10. Apply the following patches for regex
- patches/regex.patch (a combined patch of 3 revisions below)
- upstream bugs (fixed in the upstream ToT) :
http://bugs.icu-project.org/trac/ticket/11370 (r36723:36724)
http://bugs.icu-project.org/trac/ticket/11369 (r36726:36727)
http://bugs.icu-project.org/trac/ticket/11371 (r36800:36801)
11. Fix a bug in locid (getBaseName is wrong).
- patches/locid.patch
- upstream bug: http://bugs.icu-project.org/trac/ticket/11421