
Copyright (C) 2011 Institute for System Programming, RAS
Copyright (C) 2011-2015 Andrey Ponomarenko's ABI Laboratory

All rights reserved.


RELEASE INFORMATION

Project:           Java API Compliance Checker (Java ACC)
Version:           1.4.3
Date:              2015-11-20


This file explains how to install and setup environment
for the tool in your computer.


Content:

   1. Requirements for Linux, FreeBSD and Mac OS X
   2. Requirements for MS Windows
   3. Configuring and Installing
   4. Running the Tool
   5. Advanced Usage


1. REQUIREMENTS FOR LINUX, FREEBSD and MAC OS X
===============================================

   1. JDK - development files (javap, javac)
   2. Perl 5 (5.8 or newer)



2. REQUIREMENTS FOR MS WINDOWS
==============================

   1. JDK (javap, javac)
   2. Active Perl 5 (5.8 or newer)



3. CONFIGURING AND INSTALLING
=============================

   This command will install an japi-compliance-checker program in the
   PREFIX/bin system directory:

     sudo make install prefix=PREFIX [/usr, /usr/local, ...]

3.1 Remove

     sudo make uninstall prefix=PREFIX



4. RUNNING THE TOOL
===================

   1. japi-compliance-checker OLD.jar NEW.jar



5. ADVANCED USAGE
===================
   1. Create XML-descriptors for two versions
      of a library (OLD.xml and NEW.xml):
            <version>
                1.0
            </version>
    
            <archives>
                /path1/to/JAR(s)/
                /path2/to/JAR(s)/
                ...
            </archives>

   2. japi-compliance-checker -lib NAME -old OLD.xml -new NEW.xml
   3. For advanced usage, see output of -help option.



Enjoy!
