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. 

Furthermore, similar changes have to be applied to XSLT include and import 
statements. For example
 <xsl:include href="tkl-file:some.xsl"/>
has to be changed to 
 <xsl:include href="tkl-file:/some.xsl"/>.

It is safe to apply these changes to portals running versions < 1.5.3 of 
Keystone, as the sablotron packages version 0.90 and 0.95 do not touch the 
argument list of handlers in case there is one single or a double slash 
present. 

 
