Blame README.XML.STUFF

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