scuffed-code

History

Steven R. Loomis d768d1b23c ICU-9001 update docs for APIChangeReport X-SVN-Rev: 31104		2011-12-12 23:45:14 +00:00
..
src/com/ibm/icu/dev/tools/docs	ICU-8869 updates for 49m1	2011-10-04 01:50:08 +00:00
.classpath	ICU-6685 rewrite api gen to not use JDK 1.4	2009-01-17 08:21:00 +00:00
.project	ICU-6685 rewrite api gen to not use JDK 1.4	2009-01-17 08:21:00 +00:00
build.xml	ICU-8869 add empty lib directory, and fix a build issue on some systems	2011-10-04 20:16:17 +00:00
icu4c.css	ICU-7339 sync CSS. more updates to reduce false positives.	2010-02-04 21:51:58 +00:00
Makefile	ICU-8525 fix for nested inner classes that are private, and support out of source build	2011-05-05 02:19:44 +00:00
readme.txt	ICU-9001 update docs for APIChangeReport	2011-12-12 23:45:14 +00:00

readme.txt

# Copyright (C) 2009-2011 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)

Requirements:
  - Everything needed to build ICU4C from a command line (UNIX) environment
  - Doxygen (for generating docs).
     Doxygen 1.7.5.1 is recommended for ICU API docs, 
     but an older Doxygen may work for the API Change Report.
  - Java JDK 1.5+
  - Apache Ant

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/release/java/) 
            with just these two lines:
			OLD_ICU=/xsrl/E/icu-1.0
			NEW_ICU=/xsrl/E/icu-6.8
	   ( where these are the paths to the parent of 'source', etc)     
           If your ICU is an out-of-source-build, add these two lines
           indicating the build location:
                        OLD_ICU_BUILD=/xsrl/E/icu-build-m48
                        NEW_ICU_BUILD=/xsrl/E/icu-build
 4. from this directory, (tools/release/java/) run Make to build docs:
            make
 5. This will create an 'APIChangeReport.html' file in this directory. Look it over, and then check it in to ${NEW_ICU}/APIChangeReport.html (parent of icu/source).