NAME

Module::Install::CustomInstallationPath - A Module::Install extension that allows the user to interactively specify custom installation directories

SYNOPSIS

  In Makefile.PL:
    use inc::Module::Install;
    ...
    check_custom_installation();

DESCRIPTION

This is a Module::Install extension that helps users who do not have root access to install modules. It first prompts the user for a normal installation into the default Perl paths, or a custom installation. If the user selects a custom installation, it prompts the user for the value for PREFIX. This value is then used to add PREFIX=value to @ARGV.

If the user specifies PREFIX or INSTALLDIRS as arguments to Makefile.PL, then the prompts are skipped and a normal installation is done.

COMPATIBILITY NOTE

Consider carefully whether you want to use this module. In my experience, many people don't want an interactive installation. For example, CPAN users have likely already thought about custom installation paths. Debian package maintainers also want non-interactive installs.

METHODS

check_custom_installation()

Imported into Makefile.PL by Module::Install when invoked. This causes the prompts to be displayed and @ARGV to be updated (if necessary).

LICENSE

This code is distributed under the GNU General Public License (GPL) Version 2. See the file LICENSE in the distribution for details.

AUTHOR

David Coppit <david@coppit.org>

SEE ALSO

Module::Install