File README of Package java-monasca-common

This package provides the Java based implementation of the monasca-common
libary (<https://github.com/openstack/monasca-common>) as a partial Maven
repository ready for inclusion in a local Maven repository.

At the time of this writing java-monasca-common is mainly useful as a build
dependency for openstack-monasca-thresh and openstack-monasca-persister-java.
Both are built using Tetra (<https://github.com/moio/tetra>) and depend on
java-monasca-common. You will need to use java-monasca-common on two occasions
to build/udate them:

1) During the tetra dry-run for openstack-monasca-thresh and
   openstack-monasca-persister-java: 
   
   Just copy /usr/share/java/monasca-common to the dry-run's local Maven
   directory (kit/m2), run a `mvn dependency:resolve` to download the
   dependencies pulled in by the jars in java-monasca-common and run the build
   normally after that. After the build is finished (but before you end the dry
   run) remove the monasca-common directory from the Maven directory so the
   actual build can use the jars from its java-monasca-common BuildRequire rather
   than the kit.

2) During the actual package's build: add java-monasca-common as a build require
   and copy /usr/share/java/monasca-common to the real build's kit directory as
   you did in the previous step.