]> git.saurik.com Git - apple/icu.git/blame - icuSources/tools/genren/README
ICU-64232.0.1.tar.gz
[apple/icu.git] / icuSources / tools / genren / README
CommitLineData
f3c0d7a5 1Copyright (C) 2016 and later: Unicode, Inc. and others. License & terms of use: http://www.unicode.org/copyright.html
4388f060 2Copyright (c) 2002-2011, International Business Machines Corporation and others. All Rights Reserved.
3d1f044b 3
b75a7d8f
A
4The genren.pl script is used to generate source/common/unicode/urename.h header file, which is needed for renaming the ICU exported names.
5
6This script is intended to be used on Linux, although it should work on any platform that has Perl and nm command. Makefile may need to be updated, it's not 100% portable.
7
4388f060
A
8It also does not currently work well in an out-of-source situation.
9
b75a7d8f
A
10The following instructions are for Linux version.
11- urename.h file should be generated after implementation is complete for a release.
729e4ab9 12- the version number for a release should be set according to the list in source/common/unicode/uvernum.h
3d1f044b
A
13- Note: If you are running the script in a clean checkout, you must run the runConfigureICU at least once before
14 running the make install-header command below.
b75a7d8f 15
0f5d89e8
A
16Before generating urename.h, the layout engine header files must be installed from the harfbuzz project.
17This is prerequisite for the icu layoutex (Paragraph Layout) project, which is subject to renaming.
18(Using the svn command is the simplest way of getting just the files from one subdirectory of the git project.)
19
20 cd icu4c/source
21 svn export https://github.com/behdad/icu-le-hb/trunk/src layout
22
23- Regenerate urename.h
24
25 cd icu4c/source/tools/genren
26 make install-header
b75a7d8f
A
27
28- urename.h will be updated in icu/source/common/unicode/urename.h **in your original source directory**
0f5d89e8 29- Warnings concerning bad namespace (not 'icu') on UCaseMap can be ignored.
3d1f044b 30- The defines for "__bss_start", "_edata", and "_end" should be ignored/removed (See ICU-20176).
4388f060 31- Eyeball the new file for errors
b75a7d8f 32
0f5d89e8 33 cd icu4c/source
3d1f044b 34 git diff common/unicode/urename.h
0f5d89e8 35
b75a7d8f
A
36- Other make targets here
37
38 clean - cleans out intermediate files
39 urename.h -just builds ./urename.h