Item9641: Enhance LocalLib.cfg to remove @INC paths e.g. in case of non-root installations.

Based on a IRC discussion mainly with Babar, I propose to change related sections in LocalLib.cfg according to the following example. If there are no objections I can change it in SVN trunk accordingly.

# -------------- Extra path components to include in @INC
# OPTIONAL
# If you need to use perl modules that are not installed in the standard
# directories (e.g. you have downloaded extra modules for use with plugins)
# then you can add the absolute paths to those modules below. You can list
# as many directories as you want, each directory within quotes, and
# directories separated by commas.

# @localPerlLibPath = ( '/path/to/dir', '/path/to/another/dir' );

# If you prefer to have each path on a single line then use instead of
# the above:

# @localPerlLibPath = (
#       '/path/to/dir',
#       '/path/to/another/dir'
#       );


# OPTIONAL
# If you want to remove some paths from Foswiki @INC, e.g. in case you
# whish to ensure that no other system wide perl installation will
# interferre with your local perl version, then add absolute paths to
# be removed below. You can list as many directories as you want, each
# directory within quotes, and directories separated by commas.

# no lib ( '/path/to/dir', '/path/to/another/dir' );

# If you prefer to have each path on a single line then use instead of
# the above:

# no lib (
#       '/path/to/dir',
#       '/path/to/another/dir'
#       );


# http://www.perl.com/pub/a/2002/04/10/mod_perl.html?page=3 has good advice
# on installing CPAN modules without superuser privileges.
# http://sial.org/howto/perl/life-with-cpan/non-root/ also provides a good
# overview and especially mentions additional modules interesting for
# non-root installations. E.g.: App::perlbrew, local::lib, App::FatPacker,
# App::cpanminus and other tools.


1; # Required for successful module loading

-- IngoKappler - 08 Sep 2010

Maybe fix the spelling mistakes, and PBP says to put everything on one line, and always end the line with a comma, so it's easier to comment out / add new stuff.

Apart from these minor comments, I'm all for it.

-- OlivierRaginel - 08 Sep 2010

Ok, this would then lead to (although I am not sure to be the right one for fixing spelling that I may have introduced myself ). I am probably going to commit it soon.

# -------------- Extra path components to include in @INC
# OPTIONAL
# If you need to use perl modules that are not installed in the standard
# directories (e.g. you have downloaded extra modules for use with plugins)
# then you can add the absolute paths to those modules below. You can list
# as many directories as you want, each directory within quotes, and
# directories separated by commas.

# @localPerlLibPath = ( '/path/to/dir', '/path/to/another/dir', );


# OPTIONAL
# If you want to remove some paths from Foswiki @INC (e.g. you whish to
# ensure no other system wide perl installation will interfere with
# your local perl version) then add absolute paths to be removed below.
# You can list as many directories as you want, each directory within
# quotes, and directories separated by commas.

# no lib ( '/path/to/dir', '/path/to/another/dir', );


# HINTS
# If you prefer to have each path on a single line then you could add a
# linebreak instead of the spaces between the parentheses e.g.:
# <above OPTIONAL setting> (
#       '/path/to/dir',
#       '/path/to/another/dir',
#       );


# http://www.perl.com/pub/a/2002/04/10/mod_perl.html?page=3 has good advice
# on installing CPAN modules without superuser privileges.
# http://sial.org/howto/perl/life-with-cpan/non-root/ also provides a good
# overview and especially mentions additional modules interesting for
# non-root installations (e.g. App::perlbrew, local::lib, App::FatPacker,
# App::cpanminus and other tools).


1; # Required for successful module loading

Commenting is disabled while not logged in