Skip to content

Commit 31c2437

Browse files
improve phrasing in overview.md
1 parent b8d9257 commit 31c2437

File tree

1 file changed

+9
-6
lines changed

1 file changed

+9
-6
lines changed

doc/overview.md

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,9 @@
11
# BZip3 Format Documentation
22

33
BZip3 is a modern compression format designed for high compression ratios while maintaining
4-
reasonable decompression speeds. It targets the same category/weight as LZMA and BZip2; as opposed
5-
to the speedy LZ based formats like ZStandard
4+
reasonable decompression speeds. It is intended to provide similar compression ratio and
5+
performance to LZMA and BZip2; as opposed to faster Lempel-Ziv codecs that usually offer worse
6+
compression ratio like ZStandard or LZ4.
67

78
This documentation covers the technical specifications of the BZip3 format.
89

@@ -13,15 +14,17 @@ This documentation covers the technical specifications of the BZip3 format.
1314
- Memory usage of ~(6 x block size), both compression and decompression
1415
- Little-endian encoding for integers
1516
- Embedded CRC32 checksums for data integrity
16-
- Combines LZP, RLE followed by Burrows-Wheeler transform and arithmetic coding.
17+
- Combines LZP, RLE followed by Burrows-Wheeler transform and arithmetic coding coupled with
18+
a statistical predictor.
1719

1820
## Format Overview
1921

20-
BZip3 uses two main formats:
22+
BZip3 uses two main top-level formats:
2123

2224
1. **File Format**: The standard format used by the command-line tool
2325
2. **Frame Format**: Used by the high-level API functions `bz3_compress` and `bz3_decompress`.
2426

25-
These formats are the same, except the fact that the file format also contains a block count field.
27+
These formats are very similar: the file format is a superset of the frame format and thus also
28+
contains a block count field.
2629

27-
See [bzip3_format.md](./bzip3_format.md) for the exact specification.
30+
See [bzip3_format.md](./bzip3_format.md) for more details.

0 commit comments

Comments
 (0)