		TclXSLT Version 2.3rc2

	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.3rc2.

3. Install TclDOM v2.3rc2 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.3
package require xslt 2.3

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

set source [dom::libxml2::parse $sourcexml]

# NB. Specifying -baseuri is a good idea
set styledoc [dom::libxml2::parse $stylexml]

# Now create the stylesheet

set stylesheet [xslt::compile $styledoc]

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

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

# Use TclDOM to serialize the result document.

set resultxml [dom::libxml2::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.3 2002/09/08 21:19:23 balls Exp $
