aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorJulian Seward <jseward@acm.org>1999-09-04 22:13:13 +0200
committerJulian Seward <jseward@acm.org>1999-09-04 22:13:13 +0200
commitf93cd82a9a7094ad90fd19bbc6ccf6f4627f8060 (patch)
treec95407df5665f5a7395683f07552f2b13f2e501f /README
parent977101ad5f833f5c0a574bfeea408e5301a6b052 (diff)
downloadbzip2-f93cd82a9a7094ad90fd19bbc6ccf6f4627f8060.tar.gz
bzip2-f93cd82a9a7094ad90fd19bbc6ccf6f4627f8060.tar.bz2
bzip2-f93cd82a9a7094ad90fd19bbc6ccf6f4627f8060.zip
bzip2-0.9.5dbzip2-0.9.5d
Diffstat (limited to 'README')
-rw-r--r--README78
1 files changed, 40 insertions, 38 deletions
diff --git a/README b/README
index 2f59ef7..ee70649 100644
--- a/README
+++ b/README
@@ -1,48 +1,44 @@
1 1
2
3This is the README for bzip2, a block-sorting file compressor, version 2This is the README for bzip2, a block-sorting file compressor, version
40.9.0. This version is fully compatible with the previous public 30.9.5d. This version is fully compatible with the previous public
5release, bzip2-0.1pl2. 4releases, bzip2-0.1pl2 and bzip2-0.9.0.
6 5
7bzip2-0.9.0 is distributed under a BSD-style license. For details, 6bzip2-0.9.5 is distributed under a BSD-style license. For details,
8see the file LICENSE. 7see the file LICENSE.
9 8
10Complete documentation is available in Postscript form (manual.ps) 9Complete documentation is available in Postscript form (manual.ps) or
11or html (manual_toc.html). A plain-text version of the manual page is 10html (manual_toc.html). A plain-text version of the manual page is
12available as bzip2.txt. 11available as bzip2.txt. A statement about Y2K issues is now included
12in the file Y2K_INFO.
13 13
14 14
15HOW TO BUILD -- UNIX 15HOW TO BUILD -- UNIX
16 16
17Type `make'. 17Type `make'. This builds the library libbz2.a and then the
18 18programs bzip2 and bzip2recover. Six self-tests are run.
19This creates binaries "bzip2" and "bzip2recover". 19If the self-tests complete ok, carry on to installation:
20
21It also runs four compress-decompress tests to make sure things are
22working properly. If all goes well, you should be up & running.
23Please be sure to read the output from `make' just to be sure that the
24tests went ok.
25
26To install bzip2 properly:
27
28* Copy the binaries "bzip2" and "bzip2recover" to a publically visible
29 place, possibly /usr/bin or /usr/local/bin.
30 20
31* In that directory, make "bunzip2" and "bzcat" be symbolic links 21To install in /usr/bin, /usr/lib, /usr/man and /usr/include, type
32 to "bzip2". 22 make install
23To install somewhere else, eg, /xxx/yyy/{bin,lib,man,include}, type
24 make install PREFIX=/xxx/yyy
25If you are (justifiably) paranoid and want to see what 'make install'
26is going to do, you can first do
27 make -n install or
28 make -n install PREFIX=/xxx/yyy respectively.
29The -n instructs make to show the commands it would execute, but
30not actually execute them.
33 31
34* Copy the manual page, bzip2.1, to the relevant place.
35 Probably the right place is /usr/man/man1/.
36
37If you want to program with the library, you'll need to copy libbz2.a
38and bzlib.h to /usr/lib and /usr/include respectively.
39
40 32
41HOW TO BUILD -- Windows 95, NT, DOS, Mac, etc. 33HOW TO BUILD -- Windows 95, NT, DOS, Mac, etc.
42 34
43It's difficult for me to support compilation on all these platforms. 35It's difficult for me to support compilation on all these platforms.
44My approach is to collect binaries for these platforms, and put them 36My approach is to collect binaries for these platforms, and put them
45on my web page (http://www.muraroa.demon.co.uk). Look there. 37on my web page (http://www.muraroa.demon.co.uk). Look there. However
38(FWIW), bzip2-0.9.5 is very standard ANSI C and should compile
39unmodified with MS Visual C. For Win32, there is one important
40caveat: in bzip2.c, you must set BZ_UNIX to 0 and BZ_LCCWIN32 to 1
41before building.
46 42
47 43
48VALIDATION 44VALIDATION
@@ -112,26 +108,32 @@ WHAT'S NEW IN 0.9.0 (as compared to 0.1pl2) ?
112 * Much more documentation, i.e., a proper user manual 108 * Much more documentation, i.e., a proper user manual
113 * Hopefully, improved portability (at least of the library) 109 * Hopefully, improved portability (at least of the library)
114 110
111WHAT'S NEW IN 0.9.5 ?
112
113 * Compression speed is much less sensitive to the input
114 data than in previous versions. Specifically, the very
115 slow performance caused by repetitive data is fixed.
116 * Many small improvements in file and flag handling.
117 * A Y2K statement.
115 118
116I hope you find bzip2 useful. Feel free to contact me at 119I hope you find bzip2 useful. Feel free to contact me at
117 jseward@acm.org 120 jseward@acm.org
118if you have any suggestions or queries. Many people mailed me with 121if you have any suggestions or queries. Many people mailed me with
119comments, suggestions and patches after the releases of bzip-0.15, 122comments, suggestions and patches after the releases of bzip-0.15,
120bzip-0.21 and bzip2-0.1pl2, and the changes in bzip2 are largely a 123bzip-0.21, bzip2-0.1pl2 and bzip2-0.9.0, and the changes in bzip2 are
121result of this feedback. I thank you for your comments. 124largely a result of this feedback. I thank you for your comments.
122 125
123At least for the time being, bzip2's "home" is 126At least for the time being, bzip2's "home" is (or can be reached via)
124http://www.muraroa.demon.co.uk. 127http://www.muraroa.demon.co.uk.
125 128
126Julian Seward 129Julian Seward
127jseward@acm.org 130jseward@acm.org
128 131
129Manchester, UK 132Cambridge, UK
13018 July 1996 (version 0.15) 13318 July 1996 (version 0.15)
13125 August 1996 (version 0.21) 13425 August 1996 (version 0.21)
132 135 7 August 1997 (bzip2, version 0.1)
133Guildford, Surrey, UK
1347 August 1997 (bzip2, version 0.1)
13529 August 1997 (bzip2, version 0.1pl2) 13629 August 1997 (bzip2, version 0.1pl2)
13623 August 1998 (bzip2, version 0.9.0) 13723 August 1998 (bzip2, version 0.9.0)
137 138 8 June 1999 (bzip2, version 0.9.5)
139 4 Sept 1999 (bzip2, version 0.9.5d)