Mercurial > hg > sv-dependency-builds

annotate src/bzip2-1.0.6/README.XML.STUFF @ 130:1c067f014d80

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
64-bit MSVC builds
author Chris Cannam <cannam@all-day-breakfast.com>
date Tue, 18 Oct 2016 15:59:23 +0100
parents 8a15ff55d9af
children
rev   line source
cannam@89 1 ----------------------------------------------------------------
cannam@89 2 This file is part of bzip2/libbzip2, a program and library for
cannam@89 3 lossless, block-sorting data compression.
cannam@89 4
cannam@89 5 bzip2/libbzip2 version 1.0.6 of 6 September 2010
cannam@89 6 Copyright (C) 1996-2010 Julian Seward <jseward@bzip.org>
cannam@89 7
cannam@89 8 Please read the WARNING, DISCLAIMER and PATENTS sections in the
cannam@89 9 README file.
cannam@89 10
cannam@89 11 This program is released under the terms of the license contained
cannam@89 12 in the file LICENSE.
cannam@89 13 ----------------------------------------------------------------
cannam@89 14
cannam@89 15 The script xmlproc.sh takes an xml file as input,
cannam@89 16 and processes it to create .pdf, .html or .ps output.
cannam@89 17 It uses format.pl, a perl script to format <pre> blocks nicely,
cannam@89 18 and add CDATA tags so writers do not have to use eg. &lt;
cannam@89 19
cannam@89 20 The file "entities.xml" must be edited to reflect current
cannam@89 21 version, year, etc.
cannam@89 22
cannam@89 23
cannam@89 24 Usage:
cannam@89 25
cannam@89 26 ./xmlproc.sh -v manual.xml
cannam@89 27 Validates an xml file to ensure no dtd-compliance errors
cannam@89 28
cannam@89 29 ./xmlproc.sh -html manual.xml
cannam@89 30 Output: manual.html
cannam@89 31
cannam@89 32 ./xmlproc.sh -pdf manual.xml
cannam@89 33 Output: manual.pdf
cannam@89 34
cannam@89 35 ./xmlproc.sh -ps manual.xml
cannam@89 36 Output: manual.ps
cannam@89 37
cannam@89 38
cannam@89 39 Notum bene:
cannam@89 40 - pdfxmltex barfs if given a filename with an underscore in it
cannam@89 41
cannam@89 42 - xmltex won't work yet - there's a bug in passivetex
cannam@89 43 which we are all waiting for Sebastian to fix.
cannam@89 44 So we are going the xml -> pdf -> ps route for the time being,
cannam@89 45 using pdfxmltex.