		TclXSLT Version 2.5

	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.

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

Follow these steps:

1. Install libxml2 and libxslt.

2. Install TclXML v2.5.

3. Install TclDOM v2.5 with libxml2 support.

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

	./configure --prefix=... --exec_prefix=...  [x]
	make
	make install

[x] If libxslt has been installed in a non-standard location,
    use --with-libxslt-include and --with-libxslt-lib to
    specify the where the include and library files respectively
    are installed.

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

USAGE
=====

Here's a quick start:

package require dom 2.5
package require xslt 2.5

# 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.txt,v 1.1 2002/12/10 06:17:04 balls Exp $
