cannam@89:   ----------------------------------------------------------------
cannam@89:   This file is part of bzip2/libbzip2, a program and library for
cannam@89:   lossless, block-sorting data compression.
cannam@89: 
cannam@89:   bzip2/libbzip2 version 1.0.6 of 6 September 2010
cannam@89:   Copyright (C) 1996-2010 Julian Seward <jseward@bzip.org>
cannam@89: 
cannam@89:   Please read the WARNING, DISCLAIMER and PATENTS sections in the 
cannam@89:   README file.
cannam@89: 
cannam@89:   This program is released under the terms of the license contained
cannam@89:   in the file LICENSE.
cannam@89:   ----------------------------------------------------------------
cannam@89: 
cannam@89: The script xmlproc.sh takes an xml file as input,
cannam@89: and processes it to create .pdf, .html or .ps output.
cannam@89: It uses format.pl, a perl script to format <pre> blocks nicely,
cannam@89:  and add CDATA tags so writers do not have to use eg. &lt; 
cannam@89: 
cannam@89: The file "entities.xml" must be edited to reflect current
cannam@89: version, year, etc.
cannam@89: 
cannam@89: 
cannam@89: Usage:
cannam@89: 
cannam@89:   ./xmlproc.sh -v manual.xml
cannam@89:   Validates an xml file to ensure no dtd-compliance errors
cannam@89: 
cannam@89:   ./xmlproc.sh -html manual.xml
cannam@89:   Output: manual.html
cannam@89: 
cannam@89:   ./xmlproc.sh -pdf manual.xml
cannam@89:   Output: manual.pdf
cannam@89: 
cannam@89:   ./xmlproc.sh -ps manual.xml
cannam@89:   Output: manual.ps
cannam@89: 
cannam@89: 
cannam@89: Notum bene: 
cannam@89: - pdfxmltex barfs if given a filename with an underscore in it
cannam@89: 
cannam@89: - xmltex won't work yet - there's a bug in passivetex
cannam@89:     which we are all waiting for Sebastian to fix.
cannam@89:   So we are going the xml -> pdf -> ps route for the time being,
cannam@89:     using pdfxmltex.