File: INSTALL

package info (click to toggle)
makepp 2.0.98.5-2
  • links: PTS
  • area: main
  • in suites: buster, stretch
  • size: 2,744 kB
  • ctags: 708
  • sloc: perl: 15,893; makefile: 38; sh: 1
file content (124 lines) | stat: -rw-r--r-- 5,259 bytes parent folder | download | duplicates (3)
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
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
Where to download?
  Makepp is hosted on SourceForge and can be downloaded as a source code
  tarball or as installation package for Debian .deb based Linuxes or .rpm
  based Linuxes from http://sourceforge.net/projects/makepp/files/

  Like tons of Perl software, makepp can also be downloaded from CPAN by
  clicking the Download link on http://search.cpan.org/dist/makepp/

  Makepp is part of Debian GNU/Linux unstable and testing. This means you
  can install it directly via "apt-get install makepp" or by choosing it
  from your preferred package tool like synaptic.

  Makepp is part of Gentoo Linux. Note that their 2.0-r1 is not the
  release candidate 1, but the final released version 2.0.

Can I try it without installing?
  Yes, if you want to try makepp on your own makefiles, either put the
  directory where you unpacked it into your path, or else run it
  explicitly like this, with an absolute or relative path to makepp:

      perl /where/you/unpacked/it/makepp

How to choose perl version?
  You must have Perl 5.8 or newer somewhere on your system. By default all
  uninstalled scripts will use the "perl" in your path. But you can run
  them with an explicit instance of perl. The test runner and installation
  will run everything with this same instance.

      /path/to/perl /where/you/unpacked/it/makepp

  In case some script doesn't properly recognize which "perl" it is being
  run with, you can help it by telling it the path to the same instance of
  perl via the "PERL" variable:

      PERL=/path/to/perl /path/to/perl /where/you/unpacked/it/makepp

  This can also be an instance to be searched in your path:

      PERL=perl5.16.2 perl5.16.2 /where/you/unpacked/it/makepp

How to install?
  There are two ways to install, which lead to the same result:

  configure (alias config.pl)
      This allows for traditional style installation:

          ./configure && make test && make install

      The only difference between these two is that "configure" is not a
      Perl script, so you can't say "perl configure", whereas you can use
      all the above variants like "perl config.pl". Valid options are:

      -b, --bindir=/path/to/installation/bin
          Where the binaries go (default: *prefix*/bin). Makepp's binaries
          are just Perl scripts so they are architecture independent.

      -d, --datadir=/path/to/installation/share/makepp
          Where to install makepp's library files (default:
          *prefix*/share/makepp).

      -f, --findbin=relative/path/to/datadir/from/bindir
          Where to find libraries relative to executables, or 'none' (the
          default) to find them in *datadir*.

      -h, --htmldir=/path/to/installation/share/html
          Where the HTML documentation goes (default: *datadir*/html), or
          'none' if you do not want it installed.

      -m, --mandir=/path/to/man
          Where the manual pages should reside (default: *prefix*/man), or
          'none' if you do not want them installed.

      --makefile=/path/to/Makefile
          Specify location where you can write the Makefile (default: .).
          Unlike the other options, which are remembered for the following
          install step, this file is created immediately.

      -p, --prefix=/path/to/installation
          Specify location where you want to install everything (default:
          /usr/local). All other paths are by default relative to this
          one.

      -V
      --version
          Print out the version number.

      If you want to do a mockup installation to some destdir for
      packaging your own distribution, you can give an extra parameter to
      the last command:

          make DESTDIR=/temporary/destdir install

  install.pl
      This is the backend that performs the actual installation. You can
      call it directly:

          ./install.pl bindir datadir mandir htmldir findbin destdir

      The parameters are optional and correspond to the options from the
      previous section. You are prompted for those you don't supply,
      except for the last one, which is not normally needed.

  *Makefile.PL*
      The customary file Makefile.PL is only present for technical
      reasons. It will not help you to install.

  On some systems whichever "perl" you end up calling may be a symbolic
  link to some precise version "perl5.m.n". In this case perl sees only
  that one, and will thus use it to install against. If you don't want
  that, use the "PERL" variable as described above. If you install with
  the second variant, i.e. just the name of the executable without
  slashes, the installed scripts will always search for that one via
  "/usr/bin/env". This makes them a tiny bit slower to start, for a
  greater flexibility.

Why does installation say permission denied?
  If you want to install to a system directory like /usr, /usr/local or
  /opt, you can only do that if you run the installation as user root. On
  many Unices you can run a command as root, by prepending "sudo" to it,
  and depending on the system entering the either the root password, or
  yours, as prompted for.

  This is not necessary for the preparatory "configure" or "config.pl"
  step which only writes a Makefile in the current directory.