1 This is the Perl distribution Sub-Name.
3 Installing Sub-Name is straightforward.
5 ## Installation with cpanm
7 If you have cpanm, you only need one line:
11 If it does not have permission to install modules to the current perl, cpanm
12 will automatically set up and install to a local::lib in your home directory.
13 See the local::lib documentation (https://metacpan.org/pod/local::lib) for
14 details on enabling it in your environment.
16 ## Installing with the CPAN shell
18 Alternatively, if your CPAN shell is set up, you should just be able to do:
22 ## Manual installation
24 As a last resort, you can manually install it. Download the tarball, untar it,
25 install configure prerequisites (see below), then build it:
34 On Windows platforms, you should use `dmake` or `nmake`, instead of `make`.
36 If your perl is system-managed, you can create a local::lib in your home
37 directory to install modules to. For details, see the local::lib documentation:
38 https://metacpan.org/pod/local::lib
40 The prerequisites of this distribution will also have to be installed manually. The
41 prerequisites are listed in one of the files: `MYMETA.yml` or `MYMETA.json` generated
42 by running the manual build process described above.
44 ## Configure Prerequisites
46 This distribution requires other modules to be installed before this
47 distribution's installer can be run. They can be found under the
48 "configure_requires" key of META.yml or the
49 "{prereqs}{configure}{requires}" key of META.json.
51 ## Other Prerequisites
53 This distribution may require additional modules to be installed after running
55 Look for prerequisites in the following phases:
57 * to run make, PHASE = build
58 * to use the module code itself, PHASE = runtime
59 * to run tests, PHASE = test
61 They can all be found in the "PHASE_requires" key of MYMETA.yml or the
62 "{prereqs}{PHASE}{requires}" key of MYMETA.json.
66 Sub-Name documentation is available as POD.
67 You can run `perldoc` from a shell to read the documentation:
71 For more information on installing Perl modules via CPAN, please see:
72 https://www.cpan.org/modules/INSTALL.html