From c14cdcd83c907254549d2247d218fdb87085fb67 Mon Sep 17 00:00:00 2001 From: "Dr. Matthias St. Pierre" Date: Thu, 1 Aug 2019 13:26:14 +0200 Subject: [PATCH] QueryApp: enhance documentation of local installation via local::lib Reviewed-by: Richard Levitte (Merged from https://github.com/openssl/tools/pull/39) --- README.md | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index fe9c47f..c0018f6 100644 --- a/README.md +++ b/README.md @@ -55,11 +55,24 @@ is slightly different: Other than that, follow the instructions in "Installation" above. -To get the paths right permanently, you might want to consider adding -this in your `.bash_profile`, `.bashrc` och corresponding shell init -script: +The local installation method works best if the `PERL5LIB` environment variable +(among others) is set correctly in the shell profile. A comprehensive guide how +to do it correctly can be found in the manual page (`perldoc local::lib`, +or online at [local::lib](https://metacpan.org/pod/local::lib)). - eval "`perl -I$HOME/perl5/lib/perl5 -Mlocal::lib`" +Essentially, it boils down to adding the following line to your shell profile +(e.g. `.bash_profile`, `.bashrc` for bash): + + eval "$(perl -I$HOME/perl5/lib/perl5 -Mlocal::lib)" + +The inner perl command will print roughly the following output, which then gets +evaluated by the shell to update the environment accordingly. + + PATH="/home//perl5/bin${PATH:+:${PATH}}"; export PATH; + PERL5LIB="/home//perl5/lib/perl5${PERL5LIB:+:${PERL5LIB}}"; export PERL5LIB; + PERL_LOCAL_LIB_ROOT="/home//perl5${PERL_LOCAL_LIB_ROOT:+:${PERL_LOCAL_LIB_ROOT}}"; export PERL_LOCAL_LIB_ROOT; + PERL_MB_OPT="--install_base \"/home//perl5\""; export PERL_MB_OPT; + PERL_MM_OPT="INSTALL_BASE=/home//perl5"; export PERL_MM_OPT; Testing ------- -- 2.34.1