NAME

  Pollute, Pollute::Persistent - build include files that use modules indirectly

SYNOPSIS

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

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

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

DESCRIPTION

  On use, all the symbols in the caller's symbol table are listed into
  %Pollute::Before, and the Pollute subroutine is exported (through direct
  symbol table manipulation, not through "Exporter.")

  After importing various things, run Pollute to export everything
  you imported since the C<use Pollute> line into the calling package.

  Pollute::Persistent does the same thing, but using lexicals instead
  of package variables.  Instead of requiring an explicit call to "Pollute"
  Pollute::Persistent clobbers the import subroutine, meaning that you can
  create "include file files" by using Pollute::Persistent

EXPORT

the Pollute function, which pollutes its caller with the symbols which appear in the symbol table but do not appear in %Before.

Pollute::Persistent clobbers the calling package's import function, and is suitable for recursive use.

AUTHOR

David Nicol, <lt>pollute_author@davidnicol.com

The name was suggested by Garrett Goebel. I was going to call it ``ImportExport.''

LICENSE