This is a fork of the MARC4J project. It will diverge from the upstream project, but will also attempt to continue to support the public APIs.

For more detailed information about this fork, read its documentation.

The project page has more detail, but if you'd like to jump right in (and already have Maven installed), clone this project from its GitHub page:

git clone http://github.com/ksclarke/freelib-marc4j

change into its project directory:

cd freelib-marc4j

and type:

mvn install

This will compile the project and run its tests. It will install a jar file into your local Maven repository and also leave a copy in the project's target directory (in case you don't care about Maven and just want the jar file artifact). If you want to recompile, you can run the above command again. If you want a completely clean build, you can run:

mvn clean install

This will delete the whole 'target' folder (the product of running a Maven build) and will create a new one.

If you want to create the Javadocs for the project, you can type:

mvn javadoc:javadoc

and they will be created in freelib-marc4j/target/site/apidocs

If you just want to include MARC4J as a dependency in your own Maven-managed project, you can by adding the following to your project's dependencies:

<dependency>
    <groupId>info.freelibrary</groupId>
    <artifactId>freelib-marc4j</artifactId>
    <version>2.6.12</version>
</dependency>

If you have a question about the FreeLib-MARC4J project, feel free to ask it on the FreeLibrary Projects mailing list. If you've found a bug in the code (or have a suggestion for how it could be improved), please open a new issue in the project's GitHub issues queue. Lastly, feel free to contact me directly.