xref: /aosp_15_r20/external/bzip2/README.XML.STUFF (revision 0ac9a9daea5cce2e775d5da949508593e2ee9206)
1*0ac9a9daSXin Li  ----------------------------------------------------------------
2*0ac9a9daSXin Li  This file is part of bzip2/libbzip2, a program and library for
3*0ac9a9daSXin Li  lossless, block-sorting data compression.
4*0ac9a9daSXin Li
5*0ac9a9daSXin Li  bzip2/libbzip2 version 1.0.8 of 13 July 2019
6*0ac9a9daSXin Li  Copyright (C) 1996-2019 Julian Seward <[email protected]>
7*0ac9a9daSXin Li
8*0ac9a9daSXin Li  Please read the WARNING, DISCLAIMER and PATENTS sections in the
9*0ac9a9daSXin Li  README file.
10*0ac9a9daSXin Li
11*0ac9a9daSXin Li  This program is released under the terms of the license contained
12*0ac9a9daSXin Li  in the file LICENSE.
13*0ac9a9daSXin Li  ----------------------------------------------------------------
14*0ac9a9daSXin Li
15*0ac9a9daSXin LiThe script xmlproc.sh takes an xml file as input,
16*0ac9a9daSXin Liand processes it to create .pdf, .html or .ps output.
17*0ac9a9daSXin LiIt uses format.pl, a perl script to format <pre> blocks nicely,
18*0ac9a9daSXin Li and add CDATA tags so writers do not have to use eg. &lt;
19*0ac9a9daSXin Li
20*0ac9a9daSXin LiThe file "entities.xml" must be edited to reflect current
21*0ac9a9daSXin Liversion, year, etc.
22*0ac9a9daSXin Li
23*0ac9a9daSXin Li
24*0ac9a9daSXin LiUsage:
25*0ac9a9daSXin Li
26*0ac9a9daSXin Li  ./xmlproc.sh -v manual.xml
27*0ac9a9daSXin Li  Validates an xml file to ensure no dtd-compliance errors
28*0ac9a9daSXin Li
29*0ac9a9daSXin Li  ./xmlproc.sh -html manual.xml
30*0ac9a9daSXin Li  Output: manual.html
31*0ac9a9daSXin Li
32*0ac9a9daSXin Li  ./xmlproc.sh -pdf manual.xml
33*0ac9a9daSXin Li  Output: manual.pdf
34*0ac9a9daSXin Li
35*0ac9a9daSXin Li  ./xmlproc.sh -ps manual.xml
36*0ac9a9daSXin Li  Output: manual.ps
37*0ac9a9daSXin Li
38*0ac9a9daSXin Li
39*0ac9a9daSXin LiNotum bene:
40*0ac9a9daSXin Li- pdfxmltex barfs if given a filename with an underscore in it
41*0ac9a9daSXin Li
42*0ac9a9daSXin Li- xmltex won't work yet - there's a bug in passivetex
43*0ac9a9daSXin Li    which we are all waiting for Sebastian to fix.
44*0ac9a9daSXin Li  So we are going the xml -> pdf -> ps route for the time being,
45*0ac9a9daSXin Li    using pdfxmltex.
46