File: INSTALL

package info (click to toggle)
pristine-tar 1.46
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 1,076 kB
  • sloc: ansic: 9,417; perl: 1,924; sh: 352; makefile: 211; python: 109
file content (43 lines) | stat: -rw-r--r-- 1,443 bytes parent folder | download | duplicates (4)
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
Run `perl Makefile.PL` to generate a Makefile, then run `make` and
`make install`.

To configure pristine-tar for your local environment, you may specify
the following additional parameters to Makefile.PL for the creation
of the Makefile

PERL_SHEBANG=<shell-shebang-to-launch-perl-script>
TAR_PROGRAM=<name-or-path-to-gnu-tar>
XDELTA_PROGRAM=<name-or-path-to-xdelta1>
ZCAT_PROGRAM=<name-or-path-to-zcat>

The PERL_SHEBANG needs only to be adapted in rare cases, as it is usually
correctly set by MakeMaker. However, the TAR_PROGRAM should refer to the GNU
version of Tar, which may be called, e.g., "tar" (default), "gtar", or
"gnutar" depending on the system. The XDELTA_PROGRAM needs to refer to the
Xdelta program in version 1.x (http://xdelta.org), which may be called, e.g.,
"xdelta" (default) or "xdelta1". Xdelta3 won't work, as it has a different
command line syntax. ZCAT_PROGRAM should refer to a "zcat" that handles
.gz files (like in GNU gzip), not .Z (like in BSD). In BSD-derived systems
one has to explicitly ask for gzcat.

The installation destination (default: /usr/local) can be specified either
via the ./Makefile.PL parameter:

PREFIX=<installation-prefix>

or

INSTALL_BASE=<installation-prefix>

See the manpage (or perldoc) of ExtUtils::MakeMaker for more details.


EXAMPLE:

$ perl Makefile.PL \
    TAR_PROGRAM=gnutar \
    XDELTA_PROGRAM=xdelta \
    ZCAT_PROGRAM=gzcat
    PREFIX=/usr/local
$ make
$ make install