NAME
    Perl::Critic::Policy::logicLAB::ProhibitUseLib - simple policy
    prohibiting the use of 'use lib'

AFFILIATION
    This policy is a policy in the Perl::Critic::logicLAB distribution.

VERSION
    This documentation describes version 0.01

DESCRIPTION
    The 'use lib' statement, hardcodes the include path to be used. This can
    give issues when moving modules and scripts between diverse
    environments.

        use lib '/some/path';                                       #not ok
        use lib qw(/you/do/not/want/to/go/down/this/path /or/this); #not ok

    Instead use the environment variable PERL5LIB

        #bash
        export PERL5LIB='/some/path/some/where'
    
        #tcsh and csh
        setenv PERL5LIB '/some/path/some/where'

CONFIGURATION AND ENVIRONMENT
    This Policy is not configurable except for the standard options.

DEPENDENCIES AND REQUIREMENTS
    * Perl::Critic
    * Perl::Critic::Utils
    * Readonly
    * Test::More
    * Test::Perl::Critic

INCOMPATIBILITIES
    This distribution has no known incompatibilities.

BUGS AND LIMITATIONS
    Currently the policy has no special opinion on FindBin. It only aims to
    address messy, misleading, buggy and obscuring use of 'use lib'.

BUG REPORTING
    Please use Requets Tracker for bug reporting:

        http://rt.cpan.org/NoAuth/Bugs.html?Dist=Perl-Critic-logicLAB-Prohibit-UseLib

TEST AND QUALITY
    The following policies have been disabled for this distribution

    * Perl::Crititc::Policy::ValuesAndExpressions::ProhibitConstantPragma
    * Perl::Crititc::Policy::NamingConventions::Capitalization

    See also t/perlcriticrc

  TEST COVERAGE
        ---------------------------- ------ ------ ------ ------ ------ ------ ------
        File                           stmt   bran   cond    sub    pod   time  total
        ---------------------------- ------ ------ ------ ------ ------ ------ ------
        ...ogicLAB/ProhibitUseLib.pm  100.0   50.0    n/a  100.0  100.0  100.0   95.3
        Total                         100.0   50.0    n/a  100.0  100.0  100.0   95.3
        ---------------------------- ------ ------ ------ ------ ------ ------ ------
    
SEE ALSO
    * http://perldoc.perl.org/perlrun.html#ENVIRONMENT
    *
    http://logiclab.jira.com/wiki/display/OPEN/Development#Development-Makey
    ourComponentsEnvironmentAgnostic

AUTHOR
    * Jonas B. Nielsen, jonasbn `<jonasbn@cpan.org>'

LICENSE AND COPYRIGHT
    Copyright (c) 2009-2010 Jonas B. Nielsen. All rights reserved.

    This program is free software; you can redistribute it and/or modify it
    under the same terms as Perl itself.

