Transmorpher @VERS@
@DATE@

Copyright (C) 2001-2002 Fluxmedia and INRIA Rhône-Alpes.
Copyright (C) 2003, 2007 INRIA Rhône-Alpes.

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

Read the LICENSE.TXT file for the terms of the GPL license.

WHAT IS TRANSMORPHER?
---------------------

Transmorpher is a software environment for defining and processing 
complex transformations of XML documents.
The processing can be carried out either by Transmorpher itself or by 
translation to other formalisms (partially XSLT and partially a command 
script).

Transmorpher is partly based on the transformation language XSLT 
recommended by the "World-wide web consortium" (W3C).
XSLT is overly complex for simple transformations (such as renaming tags) 
and too simple for composing transformations (such as applying a 
transformation until it does not apply anymore). It enables the 
description of individual transformations but does not support 
transformation combination and complex data flows.
Transformer takes as input a complex transformation described in XML. It 
is portable, open to other transformation engines and yet sufficient for 
expressing complex systems of transformations.

Transmorpher is based on XSLT to which it adds the 
opportunity to combine transformations. More precisely it allows to route 
XML streams through transformation processes running in parallel, sequence,
iteration. These processes can have several input and output streams that 
can be dispatched and merged through special connectors.
Moreover, it enhance XSLT with simple transformation templates 
(suppression, renaming), regular expression substitutions and query 
facilities. Of course, these combinations are also processes that can, 
in turn, be combined.

USING TRANSMORPHER
------------------

The instructions for using this software can be found at either:

	./refman/install.html (this version)

or

	http://transmorpher.gforge.inria.fr/refman/install.html (latest version)

LAST RELEASE
------------

The last release is available from:

	http://transmorpher.gforge.inrialpes.fr

A last nightly build may be obtained from the gforge web server.

DOCUMENTATION
-------------

The reference manual is available in the refman/ directory
The javadoc API documentation is avalable in the api/ directory
All in HTML format.

They can also be consulted from the web site above.

FILES
-----

README.TXT	this file
FILES.TXT	the list of all the files in the archive
LICENSE.TXT	the terms under which the software is licensed to you.
api/		javadoc API documentation in HTML
classes/	empty directory for compiling the sources
distrib/	directory required for compiling a release
docs/		developer documentation
dtd/		contains the Transmorpher DTDs (and schemas)
lib/		contains transmo.jar
refman/		reference manual in HTML
resources/	.property files that sets default values for Transmorpher variables
samples/	two example applications
scripts/	Ant script for testing, compiling, etc.
src/		Java sources of Transmorpher
tests/		Junit unit test hierarchy