README
1The stylesheets in this directory are used to generate C source and
2header files for xmlroff from the XML for the XSL 1.0 Recommendation
3(http://www.w3.org/TR/2001/REC-xsl-20011015/xslspec.xml, included as
4'xslspec.xml').
5
6This is part of the xmlroff XSL Formatter project.
7
8-----------------------------------------------------------------------
9xmlroff is a fast, free, high-quality, multi-platform XSL formatter
10that aims to excel at DocBook formatting and that integrates easily
11with other programs and with scripting languages.
12
13The xmlroff XSL Formatter is a library -- libfo -- and a command-line
14program -- xmlroff -- for formatting XML according to the XSL 1.0
15Recommendation.
16
17See http://xmlroff.org/.
18-----------------------------------------------------------------------
19
20The version numbers of 'codegen' releases are the same as the
21version of xmlroff that is current at the time of the 'codegen'
22release.
23
24The generated files are not guaranteed to be drop-in replacements for
25the existing xmlroff source code and header files, since many of the
26xmlroff source code and header files have had manual modifications.
27
28You should use Emacs's ediff or some other diff/merge utility to
29compare the generated file and the existing version and only change
30what should be changed.
31
32The exception are the .c and .h files created for a property that has
33just been added to codegen-info.xml: since the property's files didn't
34exist before, you can just copy the generated files to the xmlroff
35source code.
36
37
38Files
39=====
40
41The significant files are:
42
43 ChangeLog Change log for the stylesheets, etc.
44 README This file
45 conversion-lib.xsl Stylesheet with common templates
46 codegen-info.dtd DTD for codegen-info.xml
47 codegen-info.xml XML file controlling output
48 fo-all-property-h-dump.xsl Stylesheet for generating fo-all-property.h
49 fo-context-dump.xsl Stylesheet for generating fo-context.[ch]
50 fo-object-dump.xsl Stylesheet for generating fo-*.c and
51 fo-*{-private}?.h
52 fo-property-eval-dump.xsl Stylesheet for generating
53 fo-property-eval.c
54 fo-property-object-dump.xsl Stylesheet for generating fo-property-*.[ch]
55 xmlroff-property-decl-dump.xsl
56 Stylesheet for generating entity
57 declarations for property documentation
58 files
59 xmlroff-property-ref-dump.xsl
60 Stylesheet for generating entity references
61 for property documentation files
62 xslspec.xml XML for XSL 1.0 Recommendation
63
64License
65=======
66
67The stylesheets and other content are licensed under a BSD license.
68See the file COPYING for details.
69
70
71Tony Graham
7212 March 2009
73