README
1
2XZ for Java
3===========
4
5Introduction
6
7 This aims to be a complete implementation of XZ data compression
8 in pure Java. Features:
9 - Full support for the .xz file format specification version 1.0.4
10 - Single-threaded streamed compression and decompression
11 - Single-threaded decompression with limited random access support
12 - Raw streams (no .xz headers) for advanced users, including LZMA2
13 with preset dictionary
14
15 Threading is planned but it is unknown when it will be implemented.
16
17 For the latest source code, see the project home page:
18
19 https://tukaani.org/xz/java.html
20
21 The source code is compatible with Java 5 and later.
22
23Building
24
25 It is recommended to use Apache Ant. Type "ant" to compile the
26 classes and create the .jar files. Type "ant doc" to build the
27 javadoc HTML documentation. Note that building the documentation
28 will download a small file named "package-list" from Oracle to
29 enable linking to the documentation of the standard Java classes.
30
31 If you are using OpenJDK 9 or later, you will need to edit the
32 "sourcever = 1.5" line in the file "build.properties" before
33 running "ant". Set it to 1.6 or higher. The default value 1.5
34 isn't supported by OpenJDK 9 or later.
35
36 If you cannot or don't want to use Ant, just compile all .java
37 files under the "src" directory.
38
39Demo programs
40
41 You can test compression with XZEncDemo, which compresses from
42 standard input to standard output:
43
44 java -jar build/jar/XZEncDemo.jar < foo.txt > foo.txt.xz
45
46 You can test decompression with XZDecDemo, which decompresses to
47 standard output:
48
49 java -jar build/jar/XZDecDemo.jar foo.txt.xz
50
51Reporting bugs
52
53 Report bugs to <lasse.collin@tukaani.org> or visit the IRC channel
54 #tukaani on Freenode and talk to Larhzu.
55
56