diff --git a/docs/schema_description/README b/docs/schema_description/README new file mode 100644 index 0000000000000000000000000000000000000000..c7b99a25ba15f46055f3806472f6aa4690c42b48 --- /dev/null +++ b/docs/schema_description/README @@ -0,0 +1,23 @@ +Generating the Schema Descriptions + +The tables.txt and tables.html files are generated automatically from +the tables.xml. This requires an XML processor called Saxon which can +be downloaded from http://saxon.sourceforge.net/ + +When Saxon has been downloaded and installed, edit process-saxon.sh +and make sure that the -jar argument in each of the two Java calls +points to the location of your saxon7.jar file. + +Then run the process-saxon.sh shell script and the .txt and .html +files will be created. + + +Editing the Schema Description + +If you need to edit the schema description, edit tables.xml (according +to the rules in schema_description.dtd) and re-run the processing +stage as above to regenerate the .html and .txt files. + +The XML stylesheets for creating the HTML and text (Wiki format) from +the XML are in xml2html.xsl and xml2wiki.xsl - you shouldn't need to +edit these unless you are adding a new feature to the processing step. diff --git a/docs/schema_description/process.sh b/docs/schema_description/process.sh deleted file mode 100755 index 4262a721bb231b67a9981bbbbcc28a0010cdb4d9..0000000000000000000000000000000000000000 --- a/docs/schema_description/process.sh +++ /dev/null @@ -1,4 +0,0 @@ -#!/bin/sh - -java org.apache.xalan.xslt.Process -in tables.xml -xsl schema-description.xsl -out tables.html -