Subject: | Hint to possible problem with outdated local::lib in documentation |
I know this is not a bug in Module::Build::Tiny but it would help people to troubleshoot a problem with the installation of Module::Build::Tiny that is otherwise quite obscure.
This is a suggestion for an addition to the POD of Module::Build::Tiny.
It seems that there is problem installing Module::Build::Tiny under a local::lib environment when using an outdated version of local::lib.
The symptom is an error message in the install log containing
ERROR: Can't create '/usr/local/man/man3'
Do not have write permissions on '/usr/local/man/man3'
If this occurs while using local::lib, ensure that local::lib is up to date.
In particular, if
$ perl -Mlocal::lib
shows values for the following environment variables
MODULEBUILDRC
PERL_MM_OPT
PERL5LIB
PATH
instead of
PERL_MB_OPT
PERL_MM_OPT
PERL5LIB
PATH
PERL_LOCAL_LIB_ROOT
you are using an outdated version of local::lib and need to update before installing Module::Build::Tiny.
I think the real problem is with ExtUtils::Install and a conflict between environment variables set by old versions of local::lib but I haven't investigated this properly. In any case, updating local::lib solved the problem for me.
Thanks!