inc::Module::Install(3)                    User Contributed Perl Documentation


NAME
       inc::Module::Install - Module::Install configuration system

SYNOPSIS
         use inc::Module::Install;

DESCRIPTION
       This module first checks whether the inc/.author directory exists, and
       removes the whole inc/ directory if it does, so the module author
       always get a fresh inc every time they run Makefile.PL.  Next, it
       unshifts "inc" into @INC, then loads Module::Install from there.

       Below is an explanation of the reason for using a loader module:

       The original implementation of CPAN::MakeMaker introduces subtle
       problems for distributions ending with "CPAN" (e.g. CPAN.pm,
       WAIT::Format::CPAN), because its placement in ./CPAN/ duplicates the
       real libraries that will get installed; also, the directory name
       ./CPAN/ may confuse users.

       On the other hand, putting included, for-build-time-only libraries in
       ./inc/ is a normal practice, and there is little chance that a CPAN
       distribution will be called "Something::inc", so it's much safer to
       use.

       Also, it allows for other helper modules like Module::AutoInstall to
       reside also in inc/, and to make use of them.

AUTHORS
       Audrey Tang <autrijus@autrijus.org>

COPYRIGHT
       Copyright 2003, 2004 Audrey Tang <autrijus@autrijus.org>.

       This program is free software; you can redistribute it and/or modify it
       under the same terms as Perl itself.

       See <http://www.perl.com/perl/misc/Artistic.html>

perl v5.40.0                      2024-09-01           inc::Module::Install(3)