Deleted Added
full compact
README (90067) README (146293)
1
2This is the README for bzip2, a block-sorting file compressor, version
1
2This is the README for bzip2, a block-sorting file compressor, version
31.0.2. This version is fully compatible with the previous public
4releases, versions 0.1pl2, 0.9.0, 0.9.5, 1.0.0 and 1.0.1.
31.0.3. This version is fully compatible with the previous public
4releases, versions 0.1pl2, 0.9.0, 0.9.5, 1.0.0, 1.0.1 and 1.0.2.
5
5
6bzip2-1.0.2 is distributed under a BSD-style license. For details,
6bzip2-1.0.3 is distributed under a BSD-style license. For details,
7see the file LICENSE.
8
9Complete documentation is available in Postscript form (manual.ps),
7see the file LICENSE.
8
9Complete documentation is available in Postscript form (manual.ps),
10PDF (manual.pdf, amazingly enough) or html (manual_toc.html). A
11plain-text version of the manual page is available as bzip2.txt.
12A statement about Y2K issues is now included in the file Y2K_INFO.
10PDF (manual.pdf) or html (manual.html). A plain-text version of the
11manual page is available as bzip2.txt. A statement about Y2K issues
12is now included in the file Y2K_INFO.
13
14
15HOW TO BUILD -- UNIX
16
17Type `make'. This builds the library libbz2.a and then the
18programs bzip2 and bzip2recover. Six self-tests are run.
19If the self-tests complete ok, carry on to installation:
20

--- 52 unchanged lines hidden (view full) ---

73VALIDATION
74
75Correct operation, in the sense that a compressed file can always be
76decompressed to reproduce the original, is obviously of paramount
77importance. To validate bzip2, I used a modified version of Mark
78Nelson's churn program. Churn is an automated test driver which
79recursively traverses a directory structure, using bzip2 to compress
80and then decompress each file it encounters, and checking that the
13
14
15HOW TO BUILD -- UNIX
16
17Type `make'. This builds the library libbz2.a and then the
18programs bzip2 and bzip2recover. Six self-tests are run.
19If the self-tests complete ok, carry on to installation:
20

--- 52 unchanged lines hidden (view full) ---

73VALIDATION
74
75Correct operation, in the sense that a compressed file can always be
76decompressed to reproduce the original, is obviously of paramount
77importance. To validate bzip2, I used a modified version of Mark
78Nelson's churn program. Churn is an automated test driver which
79recursively traverses a directory structure, using bzip2 to compress
80and then decompress each file it encounters, and checking that the
81decompressed data is the same as the original. There are more details
82in Section 4 of the user guide.
81decompressed data is the same as the original.
83
84
85
86Please read and be aware of the following:
87
88WARNING:
89
90 This program (attempts to) compress data by performing several

--- 23 unchanged lines hidden (view full) ---

114 That is not to say this program is inherently unreliable. Indeed,
115 I very much hope the opposite is true. bzip2 has been carefully
116 constructed and extensively tested.
117
118
119PATENTS:
120
121 To the best of my knowledge, bzip2 does not use any patented
82
83
84
85Please read and be aware of the following:
86
87WARNING:
88
89 This program (attempts to) compress data by performing several

--- 23 unchanged lines hidden (view full) ---

113 That is not to say this program is inherently unreliable. Indeed,
114 I very much hope the opposite is true. bzip2 has been carefully
115 constructed and extensively tested.
116
117
118PATENTS:
119
120 To the best of my knowledge, bzip2 does not use any patented
122 algorithms. However, I do not have the resources available to
123 carry out a full patent search. Therefore I cannot give any
124 guarantee of the above statement.
121 algorithms. However, I do not have the resources to carry out
122 a patent search. Therefore I cannot give any guarantee of the
123 above statement.
125
126End of legalities.
127
128
129WHAT'S NEW IN 0.9.0 (as compared to 0.1pl2) ?
130
131 * Approx 10% faster compression, 30% faster decompression
132 * -t (test mode) is a lot quicker

--- 15 unchanged lines hidden (view full) ---

148WHAT'S NEW IN 1.0.0 ?
149
150 See the CHANGES file.
151
152WHAT'S NEW IN 1.0.2 ?
153
154 See the CHANGES file.
155
124
125End of legalities.
126
127
128WHAT'S NEW IN 0.9.0 (as compared to 0.1pl2) ?
129
130 * Approx 10% faster compression, 30% faster decompression
131 * -t (test mode) is a lot quicker

--- 15 unchanged lines hidden (view full) ---

147WHAT'S NEW IN 1.0.0 ?
148
149 See the CHANGES file.
150
151WHAT'S NEW IN 1.0.2 ?
152
153 See the CHANGES file.
154
155WHAT'S NEW IN 1.0.3 ?
156
156
157 See the CHANGES file.
158
159
157I hope you find bzip2 useful. Feel free to contact me at
160I hope you find bzip2 useful. Feel free to contact me at
158 jseward@acm.org
161 jseward@bzip.org
159if you have any suggestions or queries. Many people mailed me with
160comments, suggestions and patches after the releases of bzip-0.15,
162if you have any suggestions or queries. Many people mailed me with
163comments, suggestions and patches after the releases of bzip-0.15,
161bzip-0.21, and bzip2 versions 0.1pl2, 0.9.0, 0.9.5, 1.0.0 and 1.0.1,
162and the changes in bzip2 are largely a result of this feedback.
164bzip-0.21, and bzip2 versions 0.1pl2, 0.9.0, 0.9.5, 1.0.0, 1.0.1 and
1651.0.2, and the changes in bzip2 are largely a result of this feedback.
163I thank you for your comments.
164
165At least for the time being, bzip2's "home" is (or can be reached via)
166I thank you for your comments.
167
168At least for the time being, bzip2's "home" is (or can be reached via)
166http://sources.redhat.com/bzip2.
169http://www.bzip.org
167
168Julian Seward
170
171Julian Seward
169jseward@acm.org
172jseward@bzip.org
170
173
171Cambridge, UK (and what a great town this is!)
174Cambridge, UK.
172
17318 July 1996 (version 0.15)
17425 August 1996 (version 0.21)
175 7 August 1997 (bzip2, version 0.1)
17629 August 1997 (bzip2, version 0.1pl2)
17723 August 1998 (bzip2, version 0.9.0)
178 8 June 1999 (bzip2, version 0.9.5)
179 4 Sept 1999 (bzip2, version 0.9.5d)
180 5 May 2000 (bzip2, version 1.0pre8)
18130 December 2001 (bzip2, version 1.0.2pre1)
175
17618 July 1996 (version 0.15)
17725 August 1996 (version 0.21)
178 7 August 1997 (bzip2, version 0.1)
17929 August 1997 (bzip2, version 0.1pl2)
18023 August 1998 (bzip2, version 0.9.0)
181 8 June 1999 (bzip2, version 0.9.5)
182 4 Sept 1999 (bzip2, version 0.9.5d)
183 5 May 2000 (bzip2, version 1.0pre8)
18430 December 2001 (bzip2, version 1.0.2pre1)
18515 February 2005 (bzip2, version 1.0.3)