README-codespecs.txt

This is a version of Apache BCEL that contains fixes to the released version of
Apache BCEL.  It is used as an upstream master for a version of BCEL with type
annotations in https://github.com/typetools/commons-bcel.  It is this latter
version that is released as part of Daikon via bcel-util-<version>-all.jar.

If there are no local fixes needed, this repository is not needed/used for a Daikon release;
https://github/typetools/commons-bcel can pull directly from https://github.com/apache/commons-bcel.


To build this project
---------------------

```
mvn -B clean verify
```

(You may need to add -Drat.skip=true if you have local untracked files.)

The `.jar` file will be found in the target subdirectory at, for example, `target/bcel-6.8.1.jar`.


To update to a newer version of the upstream library
----------------------------------------------------

At https://github.com/apache/commons-bcel/releases ,
find the commit corresponding to a public release.

Pull in that commit:
git pull https://github.com/apache/commons-bcel <commitid>

Resolve any conflicts with our local changes and rebuild.
If there is a merge conflict related to version numbers,
use the upstream version number.