Welcome to BioJava.

BioJava is an open-source initiative with the aim of providing the
biological community with objects for representing and manipulating
biological information. We hope that it becomes the one-stop solution for
every-day biological programming.

This distribution contains the biojava classes and resources, along with
scripts for building the .class files and the documentation tree. The CVS
directories are arranged as follows:

biojava-live
 |
 |- src : java source files and package documentation
 |
 |- resources : resource files - images, xml documents
 |
 |- build : scripts for managing your copy of the repository
 |
 |- demos : demo programs that test usefull functionality

In addition, the scripts will generate the non-cvs directories docs and
class, which will contain the javadoc documentation and the class files.

The XML portions of this source tree rely on XML.jar, which can be
downloaded from Sun at:

http://developer.java.sun.com/developer/products/xml

To build the project, change to biojava-live and type:

> javac build/Builder.java
> java build.Builder all
> java build.Builder docs

to build a list of packages type:

> java build.Builder package package1 package2 ... packageN

to check for edits type:

> cvs update
and then for each directory under src with at least one modified file, build
the package.

To use biojava, put biojava.jar and xml.jar into your classpath.

To build and run the demos:

make sure that biojava.jar and xml.jar are in your classpath.
change into the demos directory, and make sure that it is also in your
classpath. type:

> javac demoDir/demoName.java
> java demoDir.demoName

e.g.

> javac dp/Dice.java
> java dp.Dice

on unix systems, you may be able to build all of the demos at once by typing:

> find . -name "*.java" | xargs javac

Most demos have either a comment explaining their purpose, or will print out a
usage message when run without arguments.

Contact Matthew Pocock (mrp@sanger.ac.uk) for more details, or mail the
biojava mailing list (biojava-l@biojava.org).
