diff options
Diffstat (limited to 'README.XML.STUFF')
-rw-r--r-- | README.XML.STUFF | 31 |
1 files changed, 31 insertions, 0 deletions
diff --git a/README.XML.STUFF b/README.XML.STUFF new file mode 100644 index 0000000..0ff209f --- /dev/null +++ b/README.XML.STUFF | |||
@@ -0,0 +1,31 @@ | |||
1 | The script xmlproc.sh takes an xml file as input, | ||
2 | and processes it to create .pdf, .html or .ps output. | ||
3 | It uses format.pl, a perl script to format <pre> blocks nicely, | ||
4 | and add CDATA tags so writers do not have to use eg. < | ||
5 | |||
6 | The file "entities.xml" must be edited to reflect current | ||
7 | version, year, etc. | ||
8 | |||
9 | |||
10 | Usage: | ||
11 | |||
12 | xmlproc.sh -v manual.xml | ||
13 | Validates an xml file to ensure no dtd-compliance errors | ||
14 | |||
15 | xmlproc.sh -html manual.xml | ||
16 | Output: manual.html | ||
17 | |||
18 | xmlproc.sh -pdf manual.xml | ||
19 | Output: manual.pdf | ||
20 | |||
21 | xmlproc.sh -ps manual.xml | ||
22 | Output: manual.ps | ||
23 | |||
24 | |||
25 | Notum bene: | ||
26 | - pdfxmltex barfs if given a filename with an underscore in it | ||
27 | |||
28 | - xmltex won't work yet - there's a bug in passivetex | ||
29 | which we are all waiting for Sebastian to fix. | ||
30 | So we are going the xml -> pdf -> ps route for the time being, | ||
31 | using pdfxmltex. | ||