NAME
    lib::byversion - add paths to @INC depending on which version of perl is
    running.

VERSION
    version 0.001000

SYNOPSIS
        PERL5OPT="-Mlib::byversion='$HOME/Foo/Bar/%V/lib/...'"

    or alternatively

        use lib::byversion "/some/path/%V/lib/...";

DESCRIPTION
    So you have >1 Perl Installs. You have >1 Perl installs right? And you
    switch between running them how?

    Let me guess, somewhere you have code that sets a different value for
    PERL5LIB depending on what Perl you're using. Oh you use perlbrew?
    <http://grep.cpan.me/?q=PERL5LIB+dist=App-perlbrew>

    This is a slightly different approach:

    1. Set up your user-land PERL5LIB dirs in a regular pattern differing
    only by perl version
            $HOME/Foo/Bar/5.16.0/lib/...
            $HOME/Foo/Bar/5.16.1/lib/...
            $HOME/Foo/Bar/5.16.2/lib/...

    2. Set the following in your %ENV
            PERL5OPT="-Mlib::byversion='$HOME/Foo/Bar/%V/lib/...'"

    3. Bam!
        The right PERL5LIB gets loaded based on which perl you use.

    Yes, yes, catch 22, "lib::byversion" and its dependencies need to be in
    your lib to start with.

    Ok. That is a problem, slightly. But assuming you can get that in each
    perl install somehow, you can load each perls user library dirs
    magically with this module once its loaded.

    And "assuming you can get that in each perl install somehow" =~ with a
    bit of luck, this feature or something like it might just be added to
    Perl itself, as this is just a prototype idea to prove it works ( or as
    the case may be, not ).

    And even if that never happens, and you like this module, you can still
    install this module into all your perls and keep a seperate
    user-PERL5LIB-per-perl without having to use lots of scripts to hold it
    together, and for System Perls, you may even be fortunate enough to get
    this module shipped by your "OS" of choice. Wouldn't that be dandy.

IMPORT
        use lib::byversion $param
        lib::byversion->import($param)
        perl -Mlib::byversion=$param

    etc.

    "lib::byversion" expects one parameter, a string path containing
    templated variables for versions.

    Current defined parameters include:

    %V  This is an analogue of $^V except :

        it should work on even perls that didn't have $^V, as it converts it
        from $] with version.pm
        it lacks the preceeding "v", because this is more usually what you
        want and its easier to template it in than take it out.

        Example:

            %V = 5.16.9

    %v  This is the same as $] on your Perl.

        Example:

            %v = 5.016009

    More may be slated at some future time, ie: to allow support for
    components based on git sha1's, but I figured to upload something that
    works before I bloat it out with features nobody will ever use.

AUTHOR
    Kent Fredric <kentfredric@gmail.com>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2013 by Kent Fredric
    <kentfredric@gmail.com>.

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

