1inc::Module::Install(3)User Contributed Perl Documentatioinnc::Module::Install(3)
2
3
4

NAME

6       inc::Module::Install - Module::Install loader
7

SYNOPSIS

9           use inc::Module::Install;
10

DESCRIPTION

12       This module first checks whether the inc/.author directory exists, and
13       removes the whole inc/ directory if it does, so the module author
14       always get a fresh inc every time they run Makefile.PL.  Next, it
15       unshifts "inc" into @INC, then loads Module::Install from there.
16
17       Below is an explanation of the reason for using a loader module:
18
19       The original implementation of CPAN::MakeMaker introduces subtle prob‐
20       lems for distributions ending with "CPAN" (e.g. CPAN.pm, WAIT::For‐
21       mat::CPAN), because its placement in ./CPAN/ duplicates the real
22       libraries that will get installed; also, the directory name ./CPAN/ may
23       confuse users.
24
25       On the other hand, putting included, for-build-time-only libraries in
26       ./inc/ is a normal practice, and there is little chance that a CPAN
27       distribution will be called "Something::inc", so it's much safer to
28       use.
29
30       Also, it allows for other helper modules like Module::AutoInstall to
31       reside also in inc/, and to make use of them.
32

AUTHORS

34       Audrey Tang <autrijus@autrijus.org>
35

37       Copyright 2003, 2004 by Audrey Tang <autrijus@autrijus.org>.
38
39       This program is free software; you can redistribute it and/or modify it
40       under the same terms as Perl itself.
41
42       See <http://www.perl.com/perl/misc/Artistic.html>
43
44
45
46perl v5.8.8                       2007-03-05           inc::Module::Install(3)
Impressum