Specify $ENV{PATH} consistency with @INC

[dolmen]

This is a general CPAN client spec issue, not specific to Build.PL.

In the environment variable section something must be said about $ENV{PATH}: it must be consistent with @INC.

I'm writing this because some packages fail to install because the CPAN client has modified $ENV{PERL5LIB} to add some temporary lib paths, but did not modify PATH to add the bin or script dirs. This cause problems for distributions that rely on Perl scripts instead of modules, as we can get trouble if there is a mismatch between the script and its supporting modules (example: running an older script with the newer modules, or finding the module but not the newer script).

Here is an example issue: https://rt.cpan.org/Ticket/Display.html?id=75376

[dagolden]

2012/3/24 Olivier Mengué reply@reply.github.com:

In the environment variable section something must be said about $ENV{PATH}: it must be consistent with @INC.

That's a good point. I'll bring it up in Paris at the QA hackathon.

David

[Leont]

Yeah, I had realized this before, but had never seen actual problems because of it. The same goes for manpaths, though that's unlikely to cause any issues.

[dolmen]

@dagolden I will be at the hackathon.

[dagolden]

Awesome. Could you please put this issue on the wiki projects page?

David

[dolmen]

Already done, in the "Build.PL" and "Misc CPAN client stuff" section. You are invited to edit the wiki page (you have to login with your Act credentials).