1a196e50eSopenharmony_ci  ----------------------------------------------------------------
2a196e50eSopenharmony_ci  This file is part of bzip2/libbzip2, a program and library for
3a196e50eSopenharmony_ci  lossless, block-sorting data compression.
4a196e50eSopenharmony_ci
5a196e50eSopenharmony_ci  bzip2/libbzip2 version 1.0.8 of 13 July 2019
6a196e50eSopenharmony_ci  Copyright (C) 1996-2019 Julian Seward <jseward@acm.org>
7a196e50eSopenharmony_ci
8a196e50eSopenharmony_ci  Please read the WARNING, DISCLAIMER and PATENTS sections in the 
9a196e50eSopenharmony_ci  README file.
10a196e50eSopenharmony_ci
11a196e50eSopenharmony_ci  This program is released under the terms of the license contained
12a196e50eSopenharmony_ci  in the file LICENSE.
13a196e50eSopenharmony_ci  ----------------------------------------------------------------
14a196e50eSopenharmony_ci
15a196e50eSopenharmony_ciThe script xmlproc.sh takes an xml file as input,
16a196e50eSopenharmony_ciand processes it to create .pdf, .html or .ps output.
17a196e50eSopenharmony_ciIt uses format.pl, a perl script to format <pre> blocks nicely,
18a196e50eSopenharmony_ci and add CDATA tags so writers do not have to use eg. &lt; 
19a196e50eSopenharmony_ci
20a196e50eSopenharmony_ciThe file "entities.xml" must be edited to reflect current
21a196e50eSopenharmony_civersion, year, etc.
22a196e50eSopenharmony_ci
23a196e50eSopenharmony_ci
24a196e50eSopenharmony_ciUsage:
25a196e50eSopenharmony_ci
26a196e50eSopenharmony_ci  ./xmlproc.sh -v manual.xml
27a196e50eSopenharmony_ci  Validates an xml file to ensure no dtd-compliance errors
28a196e50eSopenharmony_ci
29a196e50eSopenharmony_ci  ./xmlproc.sh -html manual.xml
30a196e50eSopenharmony_ci  Output: manual.html
31a196e50eSopenharmony_ci
32a196e50eSopenharmony_ci  ./xmlproc.sh -pdf manual.xml
33a196e50eSopenharmony_ci  Output: manual.pdf
34a196e50eSopenharmony_ci
35a196e50eSopenharmony_ci  ./xmlproc.sh -ps manual.xml
36a196e50eSopenharmony_ci  Output: manual.ps
37a196e50eSopenharmony_ci
38a196e50eSopenharmony_ci
39a196e50eSopenharmony_ciNotum bene: 
40a196e50eSopenharmony_ci- pdfxmltex barfs if given a filename with an underscore in it
41a196e50eSopenharmony_ci
42a196e50eSopenharmony_ci- xmltex won't work yet - there's a bug in passivetex
43a196e50eSopenharmony_ci    which we are all waiting for Sebastian to fix.
44a196e50eSopenharmony_ci  So we are going the xml -> pdf -> ps route for the time being,
45a196e50eSopenharmony_ci    using pdfxmltex.
46