NAME
    Symbol::Move - Move or rename symbols at compile time.

DESCRIPTION
    This package allows you to make move symbols in the current package,
    between the current package and other packages, or between any arbitrary
    packages.

SYNOPSYS
        use Symbol::Move(
            'foo'        => 'bar',    # Move the sub foo in the current package to the name bar.
            '%A::B::foo' => 'bar',    # Move the %A::B::foo hash to the %bar symbol in the current package.
            '@foo' => 'A::B::bar',    # Move the @foo array in the current package to the @A::B::bar symbol.
        );

USAGE
        use Symbol::Move $SYMBOL => $NEW_NAME, ...;

    $SYMBOL must be a string identifying the symbol. The symbol string must
    include the sigil unless it is a subroutine. You can provide a fully
    qualified symbol name, or it will be assumed the symbol is in $PACKAGE.

    $NEW_NAME must be a string identifying the symbol. The string may
    include a symbol, or the sigil from the $SYMBOL string will be used. The
    string can be a fully qualified symbol name, or it will be assumed that
    the new name is in $PACKAGE.

USEFUL FOR RENAMING IMPORTS
        package Foo;

        {
            package Foo::Scratch;
            use Some::Exporter qw/xyz/;
        }
        use Symbol::Move '&Foo::Scratch::xyz' => 'my_xyz';

        my_xyz(' => 'my_xyz';

        my_xyz(...);

SEE ALSO
    Symbol::Alias
        Symbol::Alias Allows you to set up aliases within a package at
        compile-time.

    Symbol::Delete
        Symbol::Delete Allows you to remove symbols from a package at
        compile time.

    Symbol::Extract
        Symbol::Extract Allows you to extract symbols from packages and into
        variables at compile time.

    Symbol::Methods
        Symbol::Methods introduces several package methods for managing
        symbols.

SOURCE
    The source code repository for symbol can be found at
    http://github.com/exodist/Symbol-Move.

MAINTAINERS
    Chad Granum <exodist@cpan.org>

AUTHORS
    Chad Granum <exodist@cpan.org>

COPYRIGHT
    Copyright 2015 Chad Granum <exodist7@gmail.com>.

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

    See http://dev.perl.org/licenses/