aboutsummaryrefslogtreecommitdiff
path: root/README.XML.STUFF
diff options
context:
space:
mode:
Diffstat (limited to 'README.XML.STUFF')
-rw-r--r--README.XML.STUFF31
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 @@
1The script xmlproc.sh takes an xml file as input,
2and processes it to create .pdf, .html or .ps output.
3It uses format.pl, a perl script to format <pre> blocks nicely,
4 and add CDATA tags so writers do not have to use eg. &lt;
5
6The file "entities.xml" must be edited to reflect current
7version, year, etc.
8
9
10Usage:
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
25Notum 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.