		TclXSLT Version 1.1

	A Tcl wrapper for the Gnome libxslt library.

		Steve Ball, Zveno Pty Ltd.

This package provides a Tcl interface to the Gnome libxslt library.
The libxslt library is loaded into the Tcl interpeter process.
XSL stylesheets are compiled and managed by a Tcl object,
so reusing a stylesheet is very fast.

TclXSLT also allows XSLT extensions elements and functions to be
implemented as a callback into the application's Tcl code.

See <URL:http://xmlsoft.org/XSLT> for more information on
the Gnome libxslt library.

See <URL:http://tclxml.sourceforge.net/> for more information
on XML support for Tcl.

Contact Steve Ball <Steve.Ball@zveno.com> for information about 
this release.

INSTALLATION
============

Follow these steps:

1. Install libxml2 and libxslt.

2. Install TclXML v2.0.

3. Install TclDOM v2.1 with libxml2 support.

4. Use configure/make/make install to install TclXSLT. eg.

	./configure
	make
	make install

You may use the usual options for configure, like --prefix.
./configure --help displays all of the options.

USAGE
=====

Reference documentation has not been written yet :-(

Here's a quick start:

package require dom 2.1
package require xslt

# First use the TclDOM package to parse the
# source and stylesheet documents.

set source [dom::DOMImplementation parse $sourcexml]
set stylesheet [dom::DOMImplementation parse $stylexml]

# Now apply the transformation.
# The return result is a TclDOM document.
# Parameters may be supplied as additional arguments.

set result [xslt::transform $stylesheet $source name 'value']

# Use TclDOM to serialize the result document.

set resultxml [dom::DOMImplementation serialize $result]

EXTENSIONS
==========

See test/extension.test for a demonstration of how to implement
an extension function as a Tcl callback.

===

$Id: README,v 1.1 2002/03/01 03:33:21 balls Exp $
