NAME

Pollute::Persistent - Perl extension to re-export imported symbols

SYNOPSIS

use Pollute::Persistent;
use This;
use That;
use TheOther;
	# exports anything imported from This, That or TheOther

DESCRIPTION

Pollute::Persistent's C<import> function creates a lexical varible
C<my %before> and puts in it one entry for every entry in the 
calling package's symbol table.  Then it (over)writes the calling
package's C<import> function to compare the symbol table as it is
now to what it was when Pollute::Persistent was initially used and
makes a list of new items.  Then it rewrites the C<import> function
again to export the new items, and calls the new, concise import function
which exports all new items.

Subsequent uses of the Persistently Polluting module will get the short
import funtion.

Pollute::Persistent rewrites its caller's import routine.
for later use.  Example:

In one file, called MyFavoriteModules.pm:
package MyFavoriteModules;
use Pollute::Persistent;
use fred;
use jim;
use shiela;

In another file:
use MyFavoriteModules;	# imports all symbols exported by fred, jim and shiela

In yet another file:
use MyFavoriteModules;	# uses newly-defined import function.

EXPORT

Pollute::Persistent clobbers its caller's import routine.

AUTHOR

David Nicol, <lt>pollute_author@davidnicol.com<gt>

LICENSE

GPL/Artistic. Enjoy.

SEE ALSO

perl.