NAME
    vendorlib - Use Only Core and Vendor Libraries in @INC

SYNOPSIS
        #!/usr/bin/perl

        use vendorlib;
        use strict;
        use warnings;
        use SomeModule; # will only search in core and vendor paths
        ...

DESCRIPTION
    In a system distribution such as Debian, it may be advisable for Perl
    programs to ignore the user's CPAN-installed modules and only use the
    distribution-provided modules to avoid possible breakage with newer and
    unpackaged versions of modules.

    To that end, this pragma will replace your @INC with only the core and
    vendor @INC paths, ignoring site_perl and $ENV{PERL5LIB} entirely.

    It is recommended that you put "use vendorlib;" as the first statement
    in your program, before even "use strict;" and "use warnings;".

BUGS
    Please report any bugs or feature requests to "bug-vendorlib at
    rt.cpan.org", or through the web interface at
    <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=vendorlib>. I will be
    notified, and then you'll automatically be notified of progress on your
    bug as I make changes.

SUPPORT
    You can find documentation for this module with the perldoc command.

        perldoc vendorlib

    You can also look for information at:

    *   RT: CPAN's request tracker

        <http://rt.cpan.org/NoAuth/Bugs.html?Dist=vendorlib>

    *   AnnoCPAN: Annotated CPAN documentation

        <http://annocpan.org/dist/vendorlib>

    *   CPAN Ratings

        <http://cpanratings.perl.org/d/vendorlib>

    *   Search CPAN

        <http://search.cpan.org/dist/vendorlib/>

ACKNOWLEDGEMENTS
    mxey and jawnsy on oftc #debian-perl helped to hash out the design for
    this.

    ribasushi reviewed the initial version and pointed out that @INC order
    matters.

AUTHOR
    Rafael Kitover, "<rkitover at cpan.org>"

LICENSE AND COPYRIGHT
    Copyright 2011 Rafael Kitover.

    This program is free software; you can redistribute it and/or modify it
    under the terms of either: the GNU General Public License as published
    by the Free Software Foundation; or the Artistic License.

    See http://dev.perl.org/licenses/ for more information.