|Subject:||Makefile.PL fails when no '.' in @INC ( Can't locate inc/Module/Install.pm in @INC)|
Perl 5.25.11 removes '.' from the default @INC, and this breaks `use inc::Module::Install` due to not being able to assume ./inc/Module/Install.pm is in the @INC load path.
This is not a complete end-of-the-world problem, as Perl provides a temporary workaround variable (PERL_USE_UNSAFE_INC=1) affected users can set that restores '.' in @INC temporarily to "just work", and for end users convenience, CPAN.pm, cpanm, prove and TAP::Harness ( called in `make test` ) set this variable, creating an illusion during installation that this problem is not there
However, this should still be considered a serious issue, as many types of end users don't get the luxury afforded by the CPAN-and-friends hacks ( vendors, hand installers, people running `perl t/foo.t` ), and this workaround is scheduled to be removed in the future.
And due to aforementioned temporary conveniences and hacks, you should intentionally defeat said hacks when testing you've fixed this, by explicitly setting PERL_USE_UNSAFE_INC=0 in your environment prior to running Makefile.PL and tests, and ensuring to perform said tests on Perl 5.25.11 or newer
Recommended solution for Makefile.PL is simply injecting a `use lib '.'` statement in Makefile.PL before the `use inc::Module::Install;` statement.
Raw Error Observed:
* perl Makefile.PL PREFIX=/usr INSTALLDIRS=vendor INSTALLMAN3DIR=none DESTDIR=/var/tmp/portage/dev-perl/HTML-RewriteAttributes-0.50.0-r1/image/
Can't locate inc/Module/Install.pm in @INC (you may need to install the inc::Module::Install module) (@INC contains: /etc/perl /usr/local/lib64/perl5/5.25.12/x86_64-linux /usr/local/lib64/perl5/5.25.12 /usr/lib64/perl5/vendor_perl/5.25.12/x86_64-linux /usr/lib64/perl5/vendor_perl/5.25.12 /usr/local/lib64/perl5 /usr/lib64/perl5/vendor_perl/5.25.11 /usr/lib64/perl5/vendor_perl/5.22.3 /usr/lib64/perl5/vendor_perl /usr/lib64/perl5/5.25.12/x86_64-linux /usr/lib64/perl5/5.25.12) at Makefile.PL line 1.
BEGIN failed--compilation aborted at Makefile.PL line 1.
- CPAN firstname.lastname@example.org
- Gentoo Perl Maintainer email@example.com ( firstname.lastname@example.org )