
			Graph-ReadWrite
			      2.00

This is a collection of perl classes for reading and writing
directed graphs in a variety of file formats. The graphs are
represented in Perl using Jarkko Hietaniemi's Graph classes.
Version 2.0 of this distribution works with version 0.5 and
later of the Graph distribution.

There are two base classes:

	Graph::Reader
	Base class for classes which read a graph
	file and create an instance of the Graph class.

	Graph::Writer
	Base class for classes which take an instance of the
	Graph class and write it out in a specific file format.

This distribution also defines a simple XML format for storing
directed graphs, defined to meet the needs of the Graph class.
A reader and writer are provided for this:

	Graph::Reader::XML
	Graph::Writer::XML

Writers are also included for Dot, VCG, and daVinci,
two packages for displaying / rendering graphs.
Dot and VCG are freely available; daVinci is freely available
at the moment, but that is going to change soon.

	Graph::Writer::Dot
	Graph::Writer::VCG
	Graph::Writer::daVinci

A reader for Dot files has been contributed by Mark Hillebrand:

	Graph::Reader::Dot

A reader and writer for HTK lattices are also included:

	Graph::Reader::HTK
	Graph::Writer::HTK

These last two will probably only be of interest to people working
with HTK, or tools which use the same format.

Dependencies:
	Graph		Jarkko's Graph classes
	XML::Parser	used by Graph::Reader::XML
	XML::Writer	used by Graph::Writer::XML
	IO::File

To install these modules, you should just have to run the following:

	% perl Makefile.PL
	% make
	% make test
	% make install

This distribution contains an early version of a test-suite;
you may get a warning about an undefined value from one of the tests.

Bugs, suggestions, and new readers and writers will be gratefully received.

Neil Bowers <neil@bowers.com>
$Id: README,v 1.2 2005/01/02 19:00:08 neilb Exp $
