diff options
| author | Julian Seward <jseward@acm.org> | 2005-02-15 22:13:13 +0100 |
|---|---|---|
| committer | Julian Seward <jseward@acm.org> | 2005-02-15 22:13:13 +0100 |
| commit | 4d540bfc95a4b0eefc1d1f388ec33534aaeb3a2f (patch) | |
| tree | 3b7e9c650b4c61d114e1716c4698e40d5c8d7ef7 /README.XML.STUFF | |
| parent | 099d844292f60f9d58914da29e5773204dc55e7a (diff) | |
| download | bzip2-1.0.3.tar.gz bzip2-1.0.3.tar.bz2 bzip2-1.0.3.zip | |
bzip2-1.0.3bzip2-1.0.3
Diffstat (limited to '')
| -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. | ||