1Requirements
2------------
3You will need a C++11 compiler. (gcc 3.3.6 or newer is recommended).
4I use gcc 6.1.0 and 4.1.2, but the code should compile with any standards
5compliant compiler.
6Gcc is available at http://gcc.gnu.org.
7
8POSIX compliant versions of diff and grep are required for zdiff and zgrep.
9
10(Option -L of zgrep fails (prints wrong results, returns wrong status, and
11even hangs) when using GNU grep versions 3.2 to 3.4 inclusive because of a
12wrong change in the exit status of grep, which was reverted in GNU grep 3.5).
13
14Compressors for bzip2, gzip and lzip formats are required to run the tests.
15
16If you are installing zutils along with GNU gzip and want to keep the
17gzip scripts, the recommended method is to configure gzip as follows:
18
19   ./configure --program-transform-name='s/^z/gz/'
20
21This renames, at installation time, the gzip scripts and man pages to
22'gzcat', 'gzcat.1', etc, avoiding the name clashing with the programs
23and man pages from zutils.
24
25
26Procedure
27---------
281. Unpack the archive if you have not done so already:
29
30	tar -xf zutils[version].tar.lz
31or
32	lzip -cd zutils[version].tar.lz | tar -xf -
33
34This creates the directory ./zutils[version] containing the source from
35the main archive.
36
372. Change to zutils directory and run configure.
38   (Try 'configure --help' for usage instructions).
39
40	cd zutils[version]
41	./configure
42
433. Run make.
44
45	make
46
474. Optionally, type 'make check' to run the tests that come with zutils.
48
495. Type 'make install' to install the programs and any data files and
50   documentation.
51
52   Or type 'make install-compress', which additionally compresses the
53   info manual and the man pages after installation.
54   (Installing compressed docs may become the default in the future).
55
56   You can install only the programs, the info manual, or the man pages by
57   typing 'make install-bin', 'make install-info', or 'make install-man'
58   respectively.
59
60
61Another way
62-----------
63You can also compile zutils into a separate directory.
64To do this, you must use a version of 'make' that supports the variable
65'VPATH', such as GNU 'make'. 'cd' to the directory where you want the
66object files and executables to go and run the 'configure' script.
67'configure' automatically checks for the source code in '.', in '..', and
68in the directory that 'configure' is in.
69
70'configure' recognizes the option '--srcdir=DIR' to control where to
71look for the sources. Usually 'configure' can determine that directory
72automatically.
73
74After running 'configure', you can run 'make' and 'make install' as
75explained above.
76
77
78Copyright (C) 2009-2021 Antonio Diaz Diaz.
79
80This file is free documentation: you have unlimited permission to copy,
81distribute, and modify it.
82