$Id: README,v 1.5 2005/06/20 12:18:45 marc Exp $

This CVS module ("tkl") contains additional code to be used in
conjunction with the Keystone (formerly TKL) system itself, which is in
the "tklite" CVS module.

--

Read the documentation at

http://www.indexdata.dk/keystone/


IMPORTANT INSTALL NOTICE:
 
This release has sablotron dependencies changed to Index Data's own 
bug fixed version 1:1.0-2, which is conflicting with original Gingerall 
version 1.0.1/1.0.2 and debian version 1.0.2-2. A bug fixed sablotron 
version is available from our web site as tarball and as debian packages.  

The original 1.0.1 and 1.0.2 release has a bug which cripples XSLT handler 
arguments by applying unnecessary and unwanted mangeling of handler arguments, 
and another which segfaults sablotron most unpleasently.

The full description of the bug is found on Sablotrons maillist
  http://archive.gingerall.cz/archives/public/sablot2004/msg00000.html

and the Gingerall bug report with patch is found at 
  http://bugzilla.gingerall.cz/show_bug.cgi?id=2811
  http://bugzilla.gingerall.cz/attachment.cgi?id=713&action=view

See also the following debian bug reports:
  http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311609
  http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=311611

Unfortunately, the supplied patch which prevents unwanted mangeling of 
Args/URI for user-defined scheme XSLT handler calls has not yet been 
accepted upstream. This forces any Keystone installation to use the patched
sablotron version 1:1.0.1-2 found at our web site.
  http://ftp.indexdata.dk/pub/sablotron/sablotron-1.0-ID-patched-1.tar.gz 

The pached version will also shortly be available as debian package.

Furthermore, this Keystone release 1.5.3 has changed the admin XSLT handler 
calling code to work with our sablotron patch. All XSLT handler args are
modified from document('a-handler:xyz') to  document('a-handler:/xyz') 
(notice the slash) to avoid breaking by non-mangeling.

Notice please that your own XSLT portal code needs to be changed the same 
way to be compliant with Keystone 1.5.3 and the patched Sablotron 1:1.0.1-2. 
 
