blob: c29455ca1c655a11d0981e6a387fb503b7a7f169 [file] [log] [blame]
# Copyright (C) 2016 and later: Unicode, Inc. and others.
# License & terms of use:
# Copyright (C) 2009-2013 IBM and Others. All Rights Reserved
API Change Report:
A tool to generate a report of API status changes between two ICU4C releases.
(ICU4J has a builtin change report generator)
- Everything needed to build ICU4C from a command line (UNIX) environment
- Doxygen (for generating docs).
Doxygen 1.8.13 or newer is recommended for ICU API docs,
but an older Doxygen may work for the API Change Report.
- Java JDK 1.8+
- Apache Ant
- Maven
To use the utility:
1. Put both old and new ICU source trees on your system
2. Run "configure" in both old and new (you can use any mixture of in-source and out-of-source builds). Doxygen must be found during the configure phase, but you do not need to build the standard API docs.
3. create a Makefile.local in this readme's directory (tools/trunk/release/java/)
with just these two lines, for example:
Set these paths to the location of parent directory of the
ICU4C sources in the previous version (OLD) and the
source of the current release (NEW)
If your ICU is an out-of-source-build, add these two lines
indicating the build location:
4. from this directory, (tools/release/java/) run Make to build docs: (the tool will be built automatically)
make APIChangeReport.html
5. This will create 'APIChangeReport.html' and '" files in
this directory. Look them over, and then check them into ${NEW_ICU}/APIChangeReport.* (parent of icu4c's source).
Note: the ant build and makefile do not attempt to rebuild the jar. Run 'mvn package' separately if developing on the Java tool.