zutils/INSTALL

Requirements
------------
You will need a C++ compiler.
I use gcc 5.3.0 and 4.1.2, but the code should compile with any standards
compliant compiler.
Gcc is available at http://gcc.gnu.org.

Compressors for bzip2, gzip and lzip formats are required to run the tests.

If you are installing zutils along with GNU gzip and want to keep the
gzip scripts, the recommended method is to configure gzip as follows:

   ./configure --program-transform-name='s/^z/gz/'

This renames, at installation time, the gzip scripts and man pages to
'gzcat', 'gzcat.1', etc, avoiding the name clashing with the programs
and man pages from zutils.


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

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

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

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

	cd zutils[version]
	./configure

3. Run make.

	make

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

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

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

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


Another way
-----------
You can also compile zutils into a separate directory.
To do this, you must use a version of 'make' that supports the 'VPATH'
variable, 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) 2009-2019 Antonio Diaz Diaz.

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