summaryrefslogtreecommitdiffstats
path: root/INSTALL
blob: 9cc0519a48bfb489f1dbb08d20d00f9e6e10ac4a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
Requirements
------------
You will need a C++11 compiler and the compression library lzlib installed.
(gcc 3.3.6 or newer is recommended).
I use gcc 6.1.0 and 4.1.2, but the code should compile with any standards
compliant compiler.
Lzlib must be version 1.8 or newer, but --keep-damaged requires lzlib 1.11
or newer to recover as much data as possible from each damaged member.
Gcc is available at http://gcc.gnu.org.
Lzlib is available at http://www.nongnu.org/lzip/lzlib.html.


Procedure
---------
1. Unpack the archive if you have not done so already:

	tar -xf tarlz[version].tar.lz
or
	lzip -cd tarlz[version].tar.lz | tar -xf -

This creates the directory ./tarlz[version] containing the source from
the main archive.

2. Change to tarlz directory and run configure.
   (Try 'configure --help' for usage instructions).

	cd tarlz[version]
	./configure

   To link against a lzlib not installed in a standard place, use:

	./configure CPPFLAGS='-I <includedir>' LDFLAGS='-L <libdir>'

   (Replace <includedir> with the directory containing the file lzlib.h,
            and <libdir> with the directory containing the file liblz.a).

3. Run make.

	make

4. Optionally, type 'make check' to run the tests that come with tarlz.

5. Type 'make install' to install the program and any data files and
   documentation.

   Or type 'make install-compress', which additionally compresses the
   info manual and the man page after installation.
   (Installing compressed docs may become the default in the future).

   You can install only the program, the info manual, or the man page by
   typing 'make install-bin', 'make install-info', or 'make install-man'
   respectively.


Another way
-----------
You can also compile tarlz into a separate directory.
To do this, you must use a version of 'make' that supports the variable
'VPATH', such as GNU 'make'. 'cd' to the directory where you want the
object files and executables to go and run the 'configure' script.
'configure' automatically checks for the source code in '.', in '..', and
in the directory that 'configure' is in.

'configure' recognizes the option '--srcdir=DIR' to control where to
look for the sources. Usually 'configure' can determine that directory
automatically.

After running 'configure', you can run 'make' and 'make install' as
explained above.


Copyright (C) 2013-2020 Antonio Diaz Diaz.

This file is free documentation: you have unlimited permission to copy,
distribute, and modify it.