xref: /netbsd-src/external/bsd/bzip2/dist/README.XML.STUFF (revision c12ab3f1404d3e6320413d6099c78880423d6a49)
14f9a1459Swiz  ----------------------------------------------------------------
24f9a1459Swiz  This file is part of bzip2/libbzip2, a program and library for
34f9a1459Swiz  lossless, block-sorting data compression.
44f9a1459Swiz
5*c12ab3f1Smaya  bzip2/libbzip2 version 1.0.8 of 13 July 2019
6*c12ab3f1Smaya  Copyright (C) 1996-2019 Julian Seward <jseward@acm.org>
74f9a1459Swiz
84f9a1459Swiz  Please read the WARNING, DISCLAIMER and PATENTS sections in the
94f9a1459Swiz  README file.
104f9a1459Swiz
114f9a1459Swiz  This program is released under the terms of the license contained
124f9a1459Swiz  in the file LICENSE.
134f9a1459Swiz  ----------------------------------------------------------------
144f9a1459Swiz
154f9a1459SwizThe script xmlproc.sh takes an xml file as input,
164f9a1459Swizand processes it to create .pdf, .html or .ps output.
174f9a1459SwizIt uses format.pl, a perl script to format <pre> blocks nicely,
184f9a1459Swiz and add CDATA tags so writers do not have to use eg. &lt;
194f9a1459Swiz
204f9a1459SwizThe file "entities.xml" must be edited to reflect current
214f9a1459Swizversion, year, etc.
224f9a1459Swiz
234f9a1459Swiz
244f9a1459SwizUsage:
254f9a1459Swiz
264f9a1459Swiz  ./xmlproc.sh -v manual.xml
274f9a1459Swiz  Validates an xml file to ensure no dtd-compliance errors
284f9a1459Swiz
294f9a1459Swiz  ./xmlproc.sh -html manual.xml
304f9a1459Swiz  Output: manual.html
314f9a1459Swiz
324f9a1459Swiz  ./xmlproc.sh -pdf manual.xml
334f9a1459Swiz  Output: manual.pdf
344f9a1459Swiz
354f9a1459Swiz  ./xmlproc.sh -ps manual.xml
364f9a1459Swiz  Output: manual.ps
374f9a1459Swiz
384f9a1459Swiz
394f9a1459SwizNotum bene:
404f9a1459Swiz- pdfxmltex barfs if given a filename with an underscore in it
414f9a1459Swiz
424f9a1459Swiz- xmltex won't work yet - there's a bug in passivetex
434f9a1459Swiz    which we are all waiting for Sebastian to fix.
444f9a1459Swiz  So we are going the xml -> pdf -> ps route for the time being,
454f9a1459Swiz    using pdfxmltex.
46