NAME

Package::Rename - Rename or copy package

VERSION

Version 0.02

SYNOPSIS

This module allows you to rename, copy or even remove packages from the perl namespace.

FUNCTIONS

This module defines the following functions. They are all optionally exported.

rename_package($old_name, $new_name)

Give a package a different name. This is the equivalent of first linking a package, and then removing its original name.

link_package($old_name, $new_name)

Make a 'hard link' of a package, thus giving it a second name.

remove_package($name)

Remove a package from the namespace. You probably don't want to use this yourself unless you really know what you're doing.

copy_package($old_name, $new_name)

Copy the complete contents of a package.

AUTHOR

Leon Timmermans, <leont at cpan.org>

BUGS

This code can cause serious mayham. Use it with care.

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

PITFALLS

Perl looks up functions during compile time but methods run time. This fact can be useful (see namespace::clean for an example of that), but also to confusing.

SUPPORT

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

    perldoc Package::Rename

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=Package-Rename

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/Package-Rename

• CPAN Ratings

  http://cpanratings.perl.org/d/Package-Rename

• Search CPAN

  http://search.cpan.org/dist/Package-Rename

ACKNOWLEDGEMENTS

COPYRIGHT & LICENSE

Copyright 2009 Leon Timmermans, all rights reserved.

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