Introduction
============

This file summarizes the results of running the eight sample XSL files
from the XML 2003 "XSL FO Chef's Tools Exhibition" using xmlroff
0.2.4.

The transcript of running the sample files is in
xmlroff-0.2.4-transcript.txt.

The sequence of the commands shown in the transcript is:

1. The original samples were run.  None of the original files produced
   results, either because of errors in the files or because xmlroff
   couldn't handle the files, most often because the files contained
   tables that use the 'automatic' layout-method that xmlroff does not
   yet support.

2. An XSLT stylesheet, fixup.xsl, was run on the sample files.  The
   stylesheet corrects errors in the samples and, where necessary,
   rewrites the samples so that xmlroff can process them.

   A stylesheet was used both so the transformation from the original
   files is repeatable and documented and because, as xmlroff improves
   and fewer fixes are required, the superseded fixes can simply be
   removed from the stylesheet and the transformation re-run.

   The stylesheet most commonly rewrites shorthand border and padding
   properties into multiple separate properties (xmlroff supports only
   the border and padding properties required for 'Basic' conformance)
   and rewrites (with limited success) tables using the 'automatic'
   layout method to use the 'fixed' layout method.

   The same stylesheet is applied to all the samples.  This does have
   it's drawbacks; e.g., as the specified 'height' property values in
   one of the samples caused problems, the 'height' properties are now
   removed from all samples.  The preferred solution is to fix xmlroff
   rather than fine-tune either the transformation process or the
   fixed files themselves.

3. The fixed XSL files were run.  The samples that still failed mostly
   failed because the stylesheet did not completely rewrite tables
   with the 'automatic' layout method.


Summary
=======

The results of running the original and 'fixed' sample files are:

Sample1.fo 	   Fails because text (actually a property attribute
		   name and value) appears where only %block; FOs are
		   allowed by the XSL Recommendation.

Sample1.fix.fo	   Runs, but won't yet match original intent.


Large.fo	   Errors reported because the content of a
		   fo:simple-page-master does not match the content
		   model in the XSL Recommendation.

		   Fails because automatic table layout is used.

Large.fix.fo	   Fails because rewriting the table is not
		   successful.


Sample3.fo	   Fails because text appears where only %block; FOs
		   are allowed by the XSL Recommendation.

Sample3.fix.fo	   Runs, but fo:static-content were removed by
		   fixup.xsl.


Sample4.fo	   Fails because automatic table-layout is used.

Sample4.fix.fo	   Runs, but won't match original, not least because
		   graphics with unsupported format were removed by
		   fixup.xsl.


Sample5.fo	   Fails because automatic table-layout is used.

Sample5.fix.fo	   Runs, but won't yet match original intent.


Sample6.fo	   Fails because automatic table-layout is used.

Sample6.fix.fo	   Runs, but won't yet match original intent.


Sample7.fo	   Fails due to an xmlroff bug.

Sample7.fix.fo	   Runs, but won't yet match original intent.


Walsh/sample8.fo   Fails because automatic table-layout is used.

Walsh/sample8.fix.fo
		   Fails, probably due to an xmlroff bug.