diff options
author | Julian Seward <jseward@acm.org> | 1999-09-04 22:13:13 +0200 |
---|---|---|
committer | Julian Seward <jseward@acm.org> | 1999-09-04 22:13:13 +0200 |
commit | f93cd82a9a7094ad90fd19bbc6ccf6f4627f8060 (patch) | |
tree | c95407df5665f5a7395683f07552f2b13f2e501f /README | |
parent | 977101ad5f833f5c0a574bfeea408e5301a6b052 (diff) | |
download | bzip2-f93cd82a9a7094ad90fd19bbc6ccf6f4627f8060.tar.gz bzip2-f93cd82a9a7094ad90fd19bbc6ccf6f4627f8060.tar.bz2 bzip2-f93cd82a9a7094ad90fd19bbc6ccf6f4627f8060.zip |
bzip2-0.9.5dbzip2-0.9.5d
Diffstat (limited to 'README')
-rw-r--r-- | README | 78 |
1 files changed, 40 insertions, 38 deletions
@@ -1,48 +1,44 @@ | |||
1 | 1 | ||
2 | |||
3 | This is the README for bzip2, a block-sorting file compressor, version | 2 | This is the README for bzip2, a block-sorting file compressor, version |
4 | 0.9.0. This version is fully compatible with the previous public | 3 | 0.9.5d. This version is fully compatible with the previous public |
5 | release, bzip2-0.1pl2. | 4 | releases, bzip2-0.1pl2 and bzip2-0.9.0. |
6 | 5 | ||
7 | bzip2-0.9.0 is distributed under a BSD-style license. For details, | 6 | bzip2-0.9.5 is distributed under a BSD-style license. For details, |
8 | see the file LICENSE. | 7 | see the file LICENSE. |
9 | 8 | ||
10 | Complete documentation is available in Postscript form (manual.ps) | 9 | Complete documentation is available in Postscript form (manual.ps) or |
11 | or html (manual_toc.html). A plain-text version of the manual page is | 10 | html (manual_toc.html). A plain-text version of the manual page is |
12 | available as bzip2.txt. | 11 | available as bzip2.txt. A statement about Y2K issues is now included |
12 | in the file Y2K_INFO. | ||
13 | 13 | ||
14 | 14 | ||
15 | HOW TO BUILD -- UNIX | 15 | HOW TO BUILD -- UNIX |
16 | 16 | ||
17 | Type `make'. | 17 | Type `make'. This builds the library libbz2.a and then the |
18 | 18 | programs bzip2 and bzip2recover. Six self-tests are run. | |
19 | This creates binaries "bzip2" and "bzip2recover". | 19 | If the self-tests complete ok, carry on to installation: |
20 | |||
21 | It also runs four compress-decompress tests to make sure things are | ||
22 | working properly. If all goes well, you should be up & running. | ||
23 | Please be sure to read the output from `make' just to be sure that the | ||
24 | tests went ok. | ||
25 | |||
26 | To 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 | 21 | To install in /usr/bin, /usr/lib, /usr/man and /usr/include, type |
32 | to "bzip2". | 22 | make install |
23 | To install somewhere else, eg, /xxx/yyy/{bin,lib,man,include}, type | ||
24 | make install PREFIX=/xxx/yyy | ||
25 | If you are (justifiably) paranoid and want to see what 'make install' | ||
26 | is going to do, you can first do | ||
27 | make -n install or | ||
28 | make -n install PREFIX=/xxx/yyy respectively. | ||
29 | The -n instructs make to show the commands it would execute, but | ||
30 | not 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 | |||
37 | If you want to program with the library, you'll need to copy libbz2.a | ||
38 | and bzlib.h to /usr/lib and /usr/include respectively. | ||
39 | |||
40 | 32 | ||
41 | HOW TO BUILD -- Windows 95, NT, DOS, Mac, etc. | 33 | HOW TO BUILD -- Windows 95, NT, DOS, Mac, etc. |
42 | 34 | ||
43 | It's difficult for me to support compilation on all these platforms. | 35 | It's difficult for me to support compilation on all these platforms. |
44 | My approach is to collect binaries for these platforms, and put them | 36 | My approach is to collect binaries for these platforms, and put them |
45 | on my web page (http://www.muraroa.demon.co.uk). Look there. | 37 | on 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 | ||
39 | unmodified with MS Visual C. For Win32, there is one important | ||
40 | caveat: in bzip2.c, you must set BZ_UNIX to 0 and BZ_LCCWIN32 to 1 | ||
41 | before building. | ||
46 | 42 | ||
47 | 43 | ||
48 | VALIDATION | 44 | VALIDATION |
@@ -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 | ||
111 | WHAT'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 | ||
116 | I hope you find bzip2 useful. Feel free to contact me at | 119 | I hope you find bzip2 useful. Feel free to contact me at |
117 | jseward@acm.org | 120 | jseward@acm.org |
118 | if you have any suggestions or queries. Many people mailed me with | 121 | if you have any suggestions or queries. Many people mailed me with |
119 | comments, suggestions and patches after the releases of bzip-0.15, | 122 | comments, suggestions and patches after the releases of bzip-0.15, |
120 | bzip-0.21 and bzip2-0.1pl2, and the changes in bzip2 are largely a | 123 | bzip-0.21, bzip2-0.1pl2 and bzip2-0.9.0, and the changes in bzip2 are |
121 | result of this feedback. I thank you for your comments. | 124 | largely a result of this feedback. I thank you for your comments. |
122 | 125 | ||
123 | At least for the time being, bzip2's "home" is | 126 | At least for the time being, bzip2's "home" is (or can be reached via) |
124 | http://www.muraroa.demon.co.uk. | 127 | http://www.muraroa.demon.co.uk. |
125 | 128 | ||
126 | Julian Seward | 129 | Julian Seward |
127 | jseward@acm.org | 130 | jseward@acm.org |
128 | 131 | ||
129 | Manchester, UK | 132 | Cambridge, UK |
130 | 18 July 1996 (version 0.15) | 133 | 18 July 1996 (version 0.15) |
131 | 25 August 1996 (version 0.21) | 134 | 25 August 1996 (version 0.21) |
132 | 135 | 7 August 1997 (bzip2, version 0.1) | |
133 | Guildford, Surrey, UK | ||
134 | 7 August 1997 (bzip2, version 0.1) | ||
135 | 29 August 1997 (bzip2, version 0.1pl2) | 136 | 29 August 1997 (bzip2, version 0.1pl2) |
136 | 23 August 1998 (bzip2, version 0.9.0) | 137 | 23 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) | ||