INSTALL

   1 This is the Perl distribution Sub-Name.
   2
   3 Installing Sub-Name is straightforward.
   4
   5 ## Installation with cpanm
   6
   7 If you have cpanm, you only need one line:
   8
   9     % cpanm Sub::Name
  10
  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.
  15
  16 ## Installing with the CPAN shell
  17
  18 Alternatively, if your CPAN shell is set up, you should just be able to do:
  19
  20     % cpan Sub::Name
  21
  22 ## Manual installation
  23
  24 As a last resort, you can manually install it. Download the tarball, untar it,
  25 then build it:
  26
  27     % perl Makefile.PL
  28     % make && make test
  29
  30 Then install it:
  31
  32     % make install
  33
  34 On Windows platforms, you should use `dmake` or `nmake`, instead of `make`.
  35
  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
  39
  40
  41 The prerequisites of this distribution will also have to be installed manually. The
  42 prerequisites are listed in one of the files: `MYMETA.yml` or `MYMETA.json` generated
  43 by running the manual build process described above.
  44
  45 ## Documentation
  46
  47 Sub-Name documentation is available as POD.
  48 You can run `perldoc` from a shell to read the documentation:
  49
  50     % perldoc Sub::Name
  51 For more information on installing Perl modules via CPAN, please see:
  52 https://www.cpan.org/modules/INSTALL.html