annotate src/bzip2-1.0.6/README.XML.STUFF @ 83:ae30d91d2ffe

Replace these with versions built using an older toolset (so as to avoid ABI compatibilities when linking on Ubuntu 14.04 for packaging purposes)
author Chris Cannam
date Fri, 07 Feb 2020 11:51:13 +0000
parents e13257ea84a4
children
rev   line source
Chris@4 1 ----------------------------------------------------------------
Chris@4 2 This file is part of bzip2/libbzip2, a program and library for
Chris@4 3 lossless, block-sorting data compression.
Chris@4 4
Chris@4 5 bzip2/libbzip2 version 1.0.6 of 6 September 2010
Chris@4 6 Copyright (C) 1996-2010 Julian Seward <jseward@bzip.org>
Chris@4 7
Chris@4 8 Please read the WARNING, DISCLAIMER and PATENTS sections in the
Chris@4 9 README file.
Chris@4 10
Chris@4 11 This program is released under the terms of the license contained
Chris@4 12 in the file LICENSE.
Chris@4 13 ----------------------------------------------------------------
Chris@4 14
Chris@4 15 The script xmlproc.sh takes an xml file as input,
Chris@4 16 and processes it to create .pdf, .html or .ps output.
Chris@4 17 It uses format.pl, a perl script to format <pre> blocks nicely,
Chris@4 18 and add CDATA tags so writers do not have to use eg. &lt;
Chris@4 19
Chris@4 20 The file "entities.xml" must be edited to reflect current
Chris@4 21 version, year, etc.
Chris@4 22
Chris@4 23
Chris@4 24 Usage:
Chris@4 25
Chris@4 26 ./xmlproc.sh -v manual.xml
Chris@4 27 Validates an xml file to ensure no dtd-compliance errors
Chris@4 28
Chris@4 29 ./xmlproc.sh -html manual.xml
Chris@4 30 Output: manual.html
Chris@4 31
Chris@4 32 ./xmlproc.sh -pdf manual.xml
Chris@4 33 Output: manual.pdf
Chris@4 34
Chris@4 35 ./xmlproc.sh -ps manual.xml
Chris@4 36 Output: manual.ps
Chris@4 37
Chris@4 38
Chris@4 39 Notum bene:
Chris@4 40 - pdfxmltex barfs if given a filename with an underscore in it
Chris@4 41
Chris@4 42 - xmltex won't work yet - there's a bug in passivetex
Chris@4 43 which we are all waiting for Sebastian to fix.
Chris@4 44 So we are going the xml -> pdf -> ps route for the time being,
Chris@4 45 using pdfxmltex.